From 040df802b2ac6a4c263eaca528da547678cda6ea Mon Sep 17 00:00:00 2001 From: Leonard Lyubich Date: Wed, 28 Jan 2026 13:53:21 +0300 Subject: [PATCH] container: Update structure and ID docs for changeable attributes Omission of 146097b6c8dbf4c3a7b4c32a3a451f46f614493d. Refs #360. Signed-off-by: Leonard Lyubich --- container/types.proto | 3 +-- proto-docs/container.md | 3 +-- proto-docs/refs.md | 8 ++++---- refs/types.proto | 8 ++++---- 4 files changed, 10 insertions(+), 12 deletions(-) diff --git a/container/types.proto b/container/types.proto index 21cd4cd1..86e3b0ab 100644 --- a/container/types.proto +++ b/container/types.proto @@ -28,8 +28,7 @@ message Container { uint32 basic_acl = 4 [json_name = "basicACL"]; // `Attribute` is a user-defined Key-Value metadata pair attached to the - // container. Container attributes are immutable. They are set at the moment of - // container creation and can never be added or updated. + // container. // // Key name must be a container-unique valid UTF-8 string. Value can't be // empty. Containers with duplicated attribute names or attributes with empty diff --git a/proto-docs/container.md b/proto-docs/container.md index 9638dd63..112e9aa1 100644 --- a/proto-docs/container.md +++ b/proto-docs/container.md @@ -780,8 +780,7 @@ of stable-marshalled container message. ### Message Container.Attribute `Attribute` is a user-defined Key-Value metadata pair attached to the -container. Container attributes are immutable. They are set at the moment of -container creation and can never be added or updated. +container. Key name must be a container-unique valid UTF-8 string. Value can't be empty. Containers with duplicated attribute names or attributes with empty diff --git a/proto-docs/refs.md b/proto-docs/refs.md index f1f25ac8..129ba70c 100644 --- a/proto-docs/refs.md +++ b/proto-docs/refs.md @@ -66,13 +66,13 @@ Depending on checksum algorithm type, the string presentation may vary: ### Message ContainerID -NeoFS container identifier. Container structures are immutable and -content-addressed. +NeoFS container identifier. `ContainerID` is a 32 byte long [SHA256](https://csrc.nist.gov/publications/detail/fips/180/4/final) hash of -stable-marshalled container message. ID consisting of all zero bytes is -reserved for undefined value and must not be specified as a field. +stable-marshalled container message used for creation. ID consisting of all +zero bytes is reserved for undefined value and must not be specified as a +field. String presentation is a [base58](https://tools.ietf.org/html/draft-msporny-base58-02) encoded string. diff --git a/refs/types.proto b/refs/types.proto index c5bb99d4..0b78024c 100644 --- a/refs/types.proto +++ b/refs/types.proto @@ -38,13 +38,13 @@ message ObjectID { bytes value = 1 [json_name = "value"]; } -// NeoFS container identifier. Container structures are immutable and -// content-addressed. +// NeoFS container identifier. // // `ContainerID` is a 32 byte long // [SHA256](https://csrc.nist.gov/publications/detail/fips/180/4/final) hash of -// stable-marshalled container message. ID consisting of all zero bytes is -// reserved for undefined value and must not be specified as a field. +// stable-marshalled container message used for creation. ID consisting of all +// zero bytes is reserved for undefined value and must not be specified as a +// field. // // String presentation is a // [base58](https://tools.ietf.org/html/draft-msporny-base58-02) encoded string.