TrueCloudLab/frostfs-api
28
0
Fork 17
Code Issues 11 Pull requests 1 Releases Activity Actions

[#80] Clarify well-known object filters parent and childfree

Browse source 
Signed-off-by: Alex Vanin <alexey@nspcc.ru>
This commit is contained in:
Alex Vanin 2020-10-23 17:50:04 +03:00 committed by Alex Vanin
parent 63215a6302
commit 5916eb1170
2 changed files with 12 additions and 10 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

11
object/service.proto
View file

@ -318,6 +318,8 @@ message SearchRequest {
// object_type // object_type
// * $Object:homomorphicHash \ // * $Object:homomorphicHash \
// homomorphic_hash // homomorphic_hash
// * $Object:split.parent \
// object_id of parent
// //
// There are some well-known filter aliases to match objects by certain // There are some well-known filter aliases to match objects by certain
// properties: // properties:
@ -328,11 +330,10 @@ message SearchRequest {
// * $Object:LEAF \ // * $Object:LEAF \
// With the `value` set to `true` checks if an object is a leaf in a split // With the `value` set to `true` checks if an object is a leaf in a split
// hierarchy. With other values returns non-leaf objects. // hierarchy. With other values returns non-leaf objects.
// * $Object:PARENT \ // * $Object:CHILDFREE \
// With the `value` set to `true` checks if an object has any child // With the `value` set to `true` checks if an object has empty
// objects is `Split` header or there are objects known to reference this // children list in `Split` header. With other values returns
// object as a parent. If set to `false` returns object without child // non-childfree objects.
// objects in `Split` header or any objects known to reference them.
message Filter { message Filter {
// Match type to use // Match type to use
MatchType match_type = 1; MatchType match_type = 1;

11
proto-docs/object.md
View file

@ -565,6 +565,8 @@ prefix to the name. Here is the list of fields available via this prefix:
object_type object_type
* $Object:homomorphicHash \ * $Object:homomorphicHash \
homomorphic_hash homomorphic_hash
* $Object:split.parent \
object_id of parent
There are some well-known filter aliases to match objects by certain There are some well-known filter aliases to match objects by certain
properties: properties:
@ -575,11 +577,10 @@ properties:
* $Object:LEAF \ * $Object:LEAF \
With the `value` set to `true` checks if an object is a leaf in a split With the `value` set to `true` checks if an object is a leaf in a split
hierarchy. With other values returns non-leaf objects. hierarchy. With other values returns non-leaf objects.
* $Object:PARENT \ * $Object:CHILDFREE \
With the `value` set to `true` checks if an object has any child With the `value` set to `true` checks if an object has empty
objects is `Split` header or there are objects known to reference this children list in `Split` header. With other values returns
object as a parent. If set to `false` returns object without child non-childfree objects.
objects in `Split` header or any objects known to reference them.
| Field | Type | Label | Description | | Field | Type | Label | Description |