附录:标量检索的字段和操作符列表

本文介绍OSS标量检索的字段和操作符列表。

注意事项

  • 简单查询条件中支持使用的操作符包括eq(等于)、gt(大于)、gte(大于等于)、lt(小于)、lte(小于等于)、match(模糊查询)和prefix(前缀查询),聚合操作中支持使用的操作符包括min(最小值)、max(最大值)、average(平均数)、sum(求和)、count(计数)、distinct(去重统计)和group(分组计数)。

  • 使用OSSUserMeta.*字段搜索文件时,请替换星号(*)为用户自定义元数据的Key,系统会按照用户自定义元数据的Key-Value来搜索文件。用户自定义元数据的Key不区分大小写,Value区分大小写。

    例如要搜索包含x-oss-meta-location=hangzhou用户自定义元数据的文件,您需要设置查询条件为{"Field": "OSSUserMeta.x-oss-meta-location", "Value": "hangzhou", "Operation": "eq"}

  • 使用OSSTagging.*字段搜索文件时,请替换星号(*)为对象标签的Key,系统会按照对象标签的Key-Value来搜索文件。对象标签的KeyValue均区分大小写。

    例如要搜索包含owner=John标签的文件,您需要设置查询条件为{"Field": "OSSTagging.owner", "Value": "John", "Operation": "eq"}

支持列表

下表列出了简单查询条件、聚合操作以及排序操作中支持的字段,以及字段对相应操作符的支持情况。

单元格中“✓”表示字段支持相应操作,“×”表示字段不支持相应操作。

Field(字段)

字段说明

操作符(简单查询条件中)

操作符(聚合操作中)

排序(Sort)

eq、gt、

gte、lt、lte

match

prefix

min、max、

sum、average

count、

distinct、group

ETag

标识Object的内容。

×

×

FileModifiedTime

Object的最后一次修改时间。

×

×

×

Filename

Object的名称,包含完整的路径和文件名。

×

ObjectACL

Object的读写权限。

×

×

OSSCRC64

Object64CRC值。

×

×

OSSObjectType

Object的类型。

×

×

OSSStorageClass

Object的存储类型。

×

×

OSSTagging.*

Object标签。

×

×

×

×

OSSTaggingCount

Object标签个数。

×

×

ServerSideEncryption

Object的服务端加密算法。

×

×

Size

Object的大小。

×

×