All Products
Search
Document Center

Object Storage Service:Appendix: List of fields and operators for scalar retrieval

Last Updated:Jun 16, 2026

OSS scalar retrieval supports specific fields and operators for simple queries, aggregate operations, and sorting.

Notes

  • Simple queries support the following operators: eq (equal to), gt (greater than), gte (greater than or equal to), lt (less than), lte (less than or equal to), match (fuzzy query), and prefix (prefix query). Aggregate operations support the following operators: min (minimum), max (maximum), average (average), sum (sum), count (count), distinct (deduplicated count), and group (grouped count).

  • To search for files using the OSSUserMeta.* field, replace the asterisk (*) with the key of the user-defined metadata. Files are matched by the key-value pair. The key is case-insensitive, and the value is case-sensitive.

    For example, you can search for files with the user-defined metadata x-oss-meta-location=hangzhou by setting the query condition to {"Field": "OSSUserMeta.x-oss-meta-location", "Value": "hangzhou", "Operation": "eq"}.

  • To search for files using the OSSTagging.* field, replace the asterisk (*) with the key of the object tag. Files are matched by the key-value pair. Both the key and the value are case-sensitive.

    For example, to search for files that have the tag owner=John, set the query condition to {"Field": "OSSTagging.owner", "Value": "John", "Operation": "eq"}.

Support list

The following table lists the fields and their supported operators for simple queries, aggregate operations, and sorting.

In the table, ✓ indicates that the field supports the operator, and × indicates that it does not.

Field

Description

Operators (in simple query conditions)

Operators (in aggregate operations)

Sort

eq, gt,

gte, lt, lte

match

prefix

min, max,

sum, average

count,

distinct, group

ETag

Identifies the content of the object.

×

×

FileModifiedTime

The last modified time of the object.

×

×

×

Filename

The name of the object, including the full path and filename.

×

ObjectACL

The access control list (ACL) of the object.

×

×

OSSCRC64

The 64-bit CRC-64 value of the object.

×

×

OSSObjectType

The type of the object.

×

×

OSSStorageClass

The storage class of the object.

×

×

OSSTagging.*

The object tag.

×

×

×

×

OSSTaggingCount

The number of object tags.

×

×

Size

The size of the object.

×

×