Update storagegroup package docs

Signed-off-by: Stanislav Bogatyrev <stanislav@nspcc.ru>
This commit is contained in:
Stanislav Bogatyrev 2020-10-16 11:05:19 +03:00 committed by Stanislav Bogatyrev
parent b72847006a
commit bfe43818eb

View file

@ -7,24 +7,22 @@ option csharp_namespace = "NeoFS.API.v2.StorageGroup";
import "refs/types.proto"; import "refs/types.proto";
// StorageGroup groups the information about the NeoFS storage group. // StorageGroup keeps verification information for Data Audit sessions. Objects
// The storage group consists of objects from single container. // that require payed storage guaranties are gathered in `StorageGroups` with
// additional information used for proof of storage. `StorageGroup` only
// contains objects from the same container.
message StorageGroup { message StorageGroup {
// validation_data_size carries the total size of the payloads of the storage // Total size of the payloads of objects in the storage group
// group members.
uint64 validation_data_size = 1; uint64 validation_data_size = 1;
// validation_hash carries homomorphic hash from the concatenation of the // Homomorphic hash from the concatenation of the payloads of the storage
// payloads of the storage group members // group members. The order of concatenation is the same as the order of the
// The order of concatenation is the same as the order of the members in the // members in the `members` field.
// Members field.
neo.fs.v2.refs.Checksum validation_hash = 2; neo.fs.v2.refs.Checksum validation_hash = 2;
// expiration_epoch carries last NeoFS epoch number of the storage group // Last NeoFS epoch number of the storage group lifetime
// lifetime.
uint64 expiration_epoch = 3; uint64 expiration_epoch = 3;
// Members carries the list of identifiers of the object storage group members. // Strictly ordered list of storage group member objects
// The list is strictly ordered.
repeated neo.fs.v2.refs.ObjectID members = 4; repeated neo.fs.v2.refs.ObjectID members = 4;
} }