forked from TrueCloudLab/frostfs-api
[nspcc-dev/neofs-node#151] Clarify $Object:ROOT filter description
* It's expected by app developers that ROOT filter will return the list of objects created by user, without supplementary objects like split object parts, tombstones and storage groups. * Rename LEAF to PHY as it's purpose it to return physically existing objects. Signed-off-by: Stanislav Bogatyrev <stanislav@nspcc.ru>
This commit is contained in:
parent
9a319905be
commit
2613670553
1 changed files with 11 additions and 5 deletions
|
@ -327,11 +327,17 @@ message SearchRequest {
|
||||||
// properties:
|
// properties:
|
||||||
//
|
//
|
||||||
// * $Object:ROOT \
|
// * $Object:ROOT \
|
||||||
// With the `value` set to `true` checks if an object is a top object in a
|
// Returns only `REGULAR` type objects that are not split or are the top
|
||||||
// split hierarchy. With other values returns non-root objects.
|
// level root objects in a split hierarchy. This includes objects not
|
||||||
// * $Object:LEAF \
|
// present physically, like large objects split into smaller objects
|
||||||
// With the `value` set to `true` checks if an object is a leaf in a split
|
// without separate top-level root object. Other type objects like
|
||||||
// hierarchy. With other values returns non-leaf objects.
|
// StorageGroups and Tombstones will not be shown. This filter may be
|
||||||
|
// useful for listing objects like `ls` command of some virtual file
|
||||||
|
// system. This filter is activated if the `key` exists, disregarding the
|
||||||
|
// value and matcher type.
|
||||||
|
// * $Object:PHY \
|
||||||
|
// Returns only objects physically stored in the system. This filter is
|
||||||
|
// activated if the `key` exists, disregarding the value and matcher type.
|
||||||
// * $Object:CHILDFREE \
|
// * $Object:CHILDFREE \
|
||||||
// With the `value` set to `true` checks if an object has empty
|
// With the `value` set to `true` checks if an object has empty
|
||||||
// children list in `Split` header. With other values returns
|
// children list in `Split` header. With other values returns
|
||||||
|
|
Loading…
Reference in a new issue