本文介绍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来搜索文件。对象标签的Key和Value均区分大小写。例如要搜索包含
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 | Object的64位CRC值。 | ✓ | × | ✓ | × | ✓ | ✓ |
OSSObjectType | Object的类型。 | ✓ | × | ✓ | × | ✓ | ✓ |
OSSStorageClass | Object的存储类型。 | ✓ | × | ✓ | × | ✓ | ✓ |
OSSTagging.* | Object标签。 | ✓ | × | ✓ | × | × | × |
OSSTaggingCount | Object标签个数。 | ✓ | × | × | ✓ | ✓ | ✓ |
ServerSideEncryption | Object的服务端加密算法。 | ✓ | × | ✓ | × | ✓ | ✓ |
Size | Object的大小。 | ✓ | × | × | ✓ | ✓ | ✓ |