From 3d445aeb0b2e1fc71e06e66f22b67bd4fa918970 Mon Sep 17 00:00:00 2001 From: Evgeniy Kulikov Date: Thu, 21 Nov 2019 10:32:07 +0300 Subject: [PATCH] docs: add deprecation notice for epoch and ttl fields --- accounting/service.proto | 1 + accounting/withdraw.proto | 4 ++++ bootstrap/service.proto | 1 + container/service.proto | 4 ++++ object/service.proto | 14 ++++++++++++++ 5 files changed, 24 insertions(+) diff --git a/accounting/service.proto b/accounting/service.proto index f975c232..9cfdb0f6 100644 --- a/accounting/service.proto +++ b/accounting/service.proto @@ -19,6 +19,7 @@ message BalanceRequest { // OwnerID is a wallet address bytes OwnerID = 1 [(gogoproto.customtype) = "OwnerID", (gogoproto.nullable) = false]; // TTL must be larger than zero, it decreased in every neofs-node + // Deprecated: will be replaced with RequestMetaHeader (see develop branch) uint32 TTL = 2; } diff --git a/accounting/withdraw.proto b/accounting/withdraw.proto index 8e10ef99..eb58d080 100644 --- a/accounting/withdraw.proto +++ b/accounting/withdraw.proto @@ -38,6 +38,7 @@ message GetRequest { // OwnerID is a wallet address bytes OwnerID = 2 [(gogoproto.customtype) = "OwnerID", (gogoproto.nullable) = false]; // TTL must be larger than zero, it decreased in every neofs-node + // Deprecated: will be replaced with RequestMetaHeader (see develop branch) uint32 TTL = 3; } @@ -58,6 +59,7 @@ message PutRequest { // Signature is a signature of the sent request bytes Signature = 5; // TTL must be larger than zero, it decreased in every neofs-node + // Deprecated: will be replaced with RequestMetaHeader (see develop branch) uint32 TTL = 6; } message PutResponse { @@ -69,6 +71,7 @@ message ListRequest { // OwnerID is a wallet address bytes OwnerID = 1 [(gogoproto.customtype) = "OwnerID", (gogoproto.nullable) = false]; // TTL must be larger than zero, it decreased in every neofs-node + // Deprecated: will be replaced with RequestMetaHeader (see develop branch) uint32 TTL = 2; } @@ -87,6 +90,7 @@ message DeleteRequest { // Signature is a signature of the sent request bytes Signature = 4; // TTL must be larger than zero, it decreased in every neofs-node + // Deprecated: will be replaced with RequestMetaHeader (see develop branch) uint32 TTL = 5; } diff --git a/bootstrap/service.proto b/bootstrap/service.proto index a0f82dca..cde94dcd 100644 --- a/bootstrap/service.proto +++ b/bootstrap/service.proto @@ -21,5 +21,6 @@ message Request { // Info contains information about node bootstrap.NodeInfo info = 2 [(gogoproto.nullable) = false]; // TTL must be larger than zero, it decreased in every neofs-node + // Deprecated: will be replaced with RequestMetaHeader (see develop branch) uint32 TTL = 3; } diff --git a/container/service.proto b/container/service.proto index 72c08993..1cf8227c 100644 --- a/container/service.proto +++ b/container/service.proto @@ -43,6 +43,7 @@ message PutRequest { bytes Signature = 5; // TTL must be larger than zero, it decreased in every neofs-node + // Deprecated: will be replaced with RequestMetaHeader (see develop branch) uint32 TTL = 6; } @@ -56,6 +57,7 @@ message DeleteRequest { bytes CID = 1 [(gogoproto.customtype) = "CID", (gogoproto.nullable) = false]; // TTL must be larger than zero, it decreased in every neofs-node + // Deprecated: will be replaced with RequestMetaHeader (see develop branch) uint32 TTL = 2; // Signature of the container owner @@ -72,6 +74,7 @@ message GetRequest { bytes CID = 1 [(gogoproto.customtype) = "CID", (gogoproto.nullable) = false]; // TTL must be larger than zero, it decreased in every neofs-node + // Deprecated: will be replaced with RequestMetaHeader (see develop branch) uint32 TTL = 2; } @@ -85,6 +88,7 @@ message ListRequest { bytes OwnerID = 1 [(gogoproto.customtype) = "OwnerID", (gogoproto.nullable) = false]; // TTL must be larger than zero, it decreased in every neofs-node + // Deprecated: will be replaced with RequestMetaHeader (see develop branch) uint32 TTL = 2; } diff --git a/object/service.proto b/object/service.proto index 5edf9355..7a971db0 100644 --- a/object/service.proto +++ b/object/service.proto @@ -53,10 +53,12 @@ service Service { message GetRequest { // Epoch is set by user to 0, node set epoch to the actual value + // Deprecated: will be replaced with RequestMetaHeader (see develop branch) uint64 Epoch = 1; // Address of object (container id + object id) refs.Address Address = 2 [(gogoproto.nullable) = false]; // TTL must be larger than zero, it decreased in every neofs-node + // Deprecated: will be replaced with RequestMetaHeader (see develop branch) uint32 TTL = 3; } @@ -72,10 +74,12 @@ message GetResponse { message PutRequest { message PutHeader { // Epoch is set by user to 0, node set epoch to the actual value + // Deprecated: will be replaced with RequestMetaHeader (see develop branch) uint64 Epoch = 1; // Object with at least container id and owner id fields Object Object = 2; // TTL must be larger than zero, it decreased in every neofs-node + // Deprecated: will be replaced with RequestMetaHeader (see develop branch) uint32 TTL = 3; // Token with session public key and user's signature session.Token Token = 4; @@ -95,12 +99,14 @@ message PutResponse { } message DeleteRequest { // Epoch is set by user to 0, node set epoch to the actual value + // Deprecated: will be replaced with RequestMetaHeader (see develop branch) uint64 Epoch = 1; // Address of object (container id + object id) refs.Address Address = 2 [(gogoproto.nullable) = false]; // OwnerID is a wallet address bytes OwnerID = 3 [(gogoproto.nullable) = false, (gogoproto.customtype) = "OwnerID"]; // TTL must be larger than zero, it decreased in every neofs-node + // Deprecated: will be replaced with RequestMetaHeader (see develop branch) uint32 TTL = 4; // Token with session public key and user's signature session.Token Token = 5; @@ -112,12 +118,14 @@ message DeleteResponse {} message HeadRequest { // Epoch should be empty on user side, node sets epoch to the actual value + // Deprecated: will be replaced with RequestMetaHeader (see develop branch) uint64 Epoch = 1; // Address of object (container id + object id) refs.Address Address = 2 [(gogoproto.nullable) = false, (gogoproto.customtype) = "Address"]; // FullHeaders can be set true for extended headers in the object bool FullHeaders = 3; // TTL must be larger than zero, it decreased in every neofs-node + // Deprecated: will be replaced with RequestMetaHeader (see develop branch) uint32 TTL = 4; } message HeadResponse { @@ -127,6 +135,7 @@ message HeadResponse { message SearchRequest { // Epoch is set by user to 0, node set epoch to the actual value + // Deprecated: will be replaced with RequestMetaHeader (see develop branch) uint64 Epoch = 1; // Version of search query format uint32 Version = 2; @@ -135,6 +144,7 @@ message SearchRequest { // Query in the binary serialized format bytes Query = 4; // TTL must be larger than zero, it decreased in every neofs-node + // Deprecated: will be replaced with RequestMetaHeader (see develop branch) uint32 TTL = 5; } @@ -145,12 +155,14 @@ message SearchResponse { message GetRangeRequest { // Epoch is set by user to 0, node set epoch to the actual value + // Deprecated: will be replaced with RequestMetaHeader (see develop branch) uint64 Epoch = 1; // Address of object (container id + object id) refs.Address Address = 2 [(gogoproto.nullable) = false]; // Ranges of object's payload to return repeated Range Ranges = 3 [(gogoproto.nullable) = false]; // TTL must be larger than zero, it decreased in every neofs-node + // Deprecated: will be replaced with RequestMetaHeader (see develop branch) uint32 TTL = 4; } @@ -161,6 +173,7 @@ message GetRangeResponse { message GetRangeHashRequest { // Epoch is set by user to 0, node set epoch to the actual value + // Deprecated: will be replaced with RequestMetaHeader (see develop branch) uint64 Epoch = 1; // Address of object (container id + object id) refs.Address Address = 2 [(gogoproto.nullable) = false]; @@ -169,6 +182,7 @@ message GetRangeHashRequest { // Salt is used to XOR object's payload ranges before hashing, it can be nil bytes Salt = 4; // TTL must be larger than zero, it decreased in every neofs-node + // Deprecated: will be replaced with RequestMetaHeader (see develop branch) uint32 TTL = 5; }