realloc/frostfs-rest-gw
1
0
Fork 0
forked from TrueCloudLab/frostfs-rest-gw
Code Issues Pull requests Projects Releases Packages Wiki Activity

[#36] Add docs

Browse source 
Signed-off-by: Denis Kirillov <denis@nspcc.ru>
This commit is contained in:
Denis Kirillov 2022-08-03 09:53:16 +03:00 • committed by Denis Kirillov
parent 6e8b6f8b51
commit ada830616b
2 changed files with 51 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

20
static/docs/docs.md
View file

@ -75,4 +75,24 @@ Also, you can use this attribute to further object searching.
More about FrostFS status code you can
find [here](https://github.com/nspcc-dev/neofs-spec/blob/master/20-api-v2/status.md).
### Storage groups
The concept of a storage group has been introduced to reduce the dependence of the complexity of
the check on the number of stored objects in the system.
The consistency and availability of multiple objects on the network are achieved by validating the
storage group without saving meta information and performing validation on each object.
`StorageGroup` keeps verification information for Data Audit sessions. Objects that require paid storage
guaranties are gathered in `StorageGroups` with additional information used for proof of storage
checks. A `StorageGroup` can be created only for objects from the same container.
A `StorageGroup` are objects of a special type with the payload containing the serialized protobuf
structure. For the details on the format please refer to the [API specification](https://github.com/nspcc-dev/neofs-spec/blob/master/20-api-v2/storagegroup.md) in the corresponding section.
StorageGroup structure has information about:
* Total size of the payloads of objects in the storage group
* Homomorphic hash from the concatenation of the payloads of the storage group members. The order of concatenation is the same as the order of the members in the members field.
* Last NeoFS epoch number of the storage group lifetime
* Alpha-numerically sorted list of member objects