Sift | Docs

metadata

Protocol buffer definition for metadata

sift/metadata/v1/metadata.proto

ArchiveMetadataKeysRequest

FieldTypeLabelDescription
metadata_keysMetadataKeyrepeated

ArchiveMetadataKeysResponse

ArchiveMetadataValuesRequest

FieldTypeLabelDescription
metadata_valuesMetadataValuerepeated

ArchiveMetadataValuesResponse

CreateMetadataKeyRequest

The request of a call to MetadataService_CreateMetadataKey to create a metadata key.

FieldTypeLabelDescription
metadata_keyMetadataKey

CreateMetadataKeyResponse

The response of a call to MetadataService_CreateMetadataKey to create a metadata key.

FieldTypeLabelDescription
metadata_keyMetadataKey

CreateMetadataValueRequest

The request of a call to MetadataService_CreateMetadataValue to create a metadata value.

FieldTypeLabelDescription
metadata_valueMetadataValue

CreateMetadataValueResponse

The response of a call to MetadataService_CreateMetadataValue to create a metadata value.

FieldTypeLabelDescription
metadata_valueMetadataValue

DeleteMetadataKeysRequest

FieldTypeLabelDescription
metadata_keysMetadataKeyrepeated

DeleteMetadataKeysResponse

DeleteMetadataValuesRequest

FieldTypeLabelDescription
metadata_valuesMetadataValuerepeated

DeleteMetadataValuesResponse

ListMetadataKeysRequest

The request for a call to MetadataService_ListMetadataKeys to retrieve metadata keys.

FieldTypeLabelDescription
page_sizeuint32The maximum number of metadata keys to return. The service may return fewer than this value. If unspecified, at most 50 metadata keys will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000. Optional.
page_tokenstringA page token, received from a previous ListMetadataKeys call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to ListMetadataKeys must match the call that provided the page token. Optional.
filterstringA Common Expression Language (CEL) filter string. Available fields to filter by are: name. For further information about how to use CELs, please refer to this guide. For more information about the fields used for filtering, please refer to this definition. Optional.
order_bystringHow to order the retrieved metadata keys. Formatted as a comma-separated string i.e. "FIELD_NAME[ desc],...". Available fields to order_by are created_date and name. If left empty, items are ordered by created_date in ascending order (oldest-first). For more information about the format of this field, read this Example: "created_date desc,modified_date"

ListMetadataKeysResponse

The response of a call to MetadataService_ListMetadataKeysResponse.

FieldTypeLabelDescription
metadata_keysMetadataKeyrepeated
next_page_tokenstring

ListMetadataUsageRequest

FieldTypeLabelDescription
page_sizeuint32The maximum number of metadata key usages to return. The service may return fewer than this value. If unspecified, at most 50 metadata key usages will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000. Optional.
page_tokenstringA page token, received from a previous ListMetadataUsage call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to ListMetadataUsage must match the call that provided the page token. Optional.
filterstringA Common Expression Language (CEL) filter string. Available fields to filter by are: entity_name, entity_type, key_name,value_string, value_number, and value_boolean. For further information about how to use CELs, please refer to this guide. For more information about the fields used for filtering, please refer to this definition. Optional.
order_bystringHow to order the retrieved metadata key usages. Formatted as a comma-separated string i.e. "FIELD_NAME[ desc],...". Available fields to order_by are created_date, entity_id and entity_type. If left empty, items are ordered by created_date in ascending order (oldest-first). For more information about the format of this field, read this Example: "created_date desc"

ListMetadataUsageResponse

FieldTypeLabelDescription
metadata_usagesMetadataUsagerepeated
next_page_tokenstring

ListMetadataValuesRequest

FieldTypeLabelDescription
page_sizeuint32The maximum number of metadata values to return. The service may return fewer than this value. If unspecified, at most 50 metadata values will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000. Optional.
page_tokenstringA page token, received from a previous ListMetadataValues call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to ListMetadataValues must match the call that provided the page token. Optional.
filterstringA Common Expression Language (CEL) filter string. Available fields to filter by are: value_string, value_number, and value_boolean. For further information about how to use CELs, please refer to this guide. For more information about the fields used for filtering, please refer to this definition. Optional.
order_bystringHow to order the retrieved metadata keys. Formatted as a comma-separated string i.e. "FIELD_NAME[ desc],...". Available fields to order_by are created_date and name. If left empty, items are ordered by created_date in ascending order (oldest-first). For more information about the format of this field, read this Example: "created_date desc,modified_date"
metadata_key_namestringThe name of the metadata key to list values for.

ListMetadataValuesResponse

FieldTypeLabelDescription
metadata_valuesMetadataValuerepeated
next_page_tokenstring

MetadataKey

FieldTypeLabelDescription
namestring
typeMetadataKeyType
archived_dategoogle.protobuf.Timestamp

MetadataUsage

FieldTypeLabelDescription
entity_idstringThe ID of the entity. For example assetId, runId, reportId, etc.
entity_typestringThe type of the entity. For example asset, run, report, etc.
valueMetadataValueThe value of the metadata key on this entity.

MetadataValue

FieldTypeLabelDescription
keyMetadataKey
oneof value.string_valuestring
oneof value.number_valuedouble
oneof value.boolean_valuebool
archived_dategoogle.protobuf.Timestamp

UnarchiveMetadataKeysRequest

FieldTypeLabelDescription
metadata_keysMetadataKeyrepeated
unarchive_valuesbool

UnarchiveMetadataKeysResponse

UnarchiveMetadataValuesRequest

FieldTypeLabelDescription
metadata_valuesMetadataValuerepeated

UnarchiveMetadataValuesResponse

MetadataKeyType

Metadata key type.

NameNumberDescription
METADATA_KEY_TYPE_UNSPECIFIED0
METADATA_KEY_TYPE_STRING1string
METADATA_KEY_TYPE_NUMBER2number
METADATA_KEY_TYPE_BOOLEAN3boolean

MetadataService

Method NameRequest TypeResponse TypeDescription
CreateMetadataKeyCreateMetadataKeyRequestCreateMetadataKeyResponseCreate a metadata key.
CreateMetadataValueCreateMetadataValueRequestCreateMetadataValueResponseCreate a metadata value.
ListMetadataKeysListMetadataKeysRequestListMetadataKeysResponseList metadata keys.
ListMetadataValuesListMetadataValuesRequestListMetadataValuesResponseList metadata values.
ArchiveMetadataKeysArchiveMetadataKeysRequestArchiveMetadataKeysResponseArchive metadata keys.
ArchiveMetadataValuesArchiveMetadataValuesRequestArchiveMetadataValuesResponseArchive metadata values.
UnarchiveMetadataKeysUnarchiveMetadataKeysRequestUnarchiveMetadataKeysResponseUnarchive metadata keys.
UnarchiveMetadataValuesUnarchiveMetadataValuesRequestUnarchiveMetadataValuesResponseUnarchive metadata values.
DeleteMetadataKeysDeleteMetadataKeysRequestDeleteMetadataKeysResponseDelete metadata keys.
DeleteMetadataValuesDeleteMetadataValuesRequestDeleteMetadataValuesResponseDelete metadata values.
ListMetadataUsageListMetadataUsageRequestListMetadataUsageResponseList metadata key usage.