Skip to content

container: Update structure and ID docs for changeable attributes #376

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
carpawell merged 1 commit into from
Jan 28, 2026
Merged

container: Update structure and ID docs for changeable attributes #376

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 1 addition & 2 deletions container/types.proto
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
3 changes: 1 addition & 2 deletions proto-docs/container.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
8 changes: 4 additions & 4 deletions proto-docs/refs.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -66,13 +66,13 @@ Depending on checksum algorithm type, the string presentation may vary:
<a name="neo.fs.v2.refs.ContainerID"></a>

### 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.
Expand Down
8 changes: 4 additions & 4 deletions refs/types.proto
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down