附录:字段和操作符的支持列表
本文介绍了简单查询条件、聚合操作以及排序操作中支持的字段(Field)和操作符(Operation),以及字段对相应操作符的支持情况。
注意事项
简单查询条件中支持使用的操作符包括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 | |||
AccessControlAllowOrigin | 允许的跨域请求来源。 | ✓ | × | ✓ | × | ✓ | ✓ |
AccessControlRequestMethod | 允许的跨域请求方法。 | ✓ | × | ✓ | × | ✓ | ✓ |
CacheControl | Object的缓存行为。 | ✓ | × | ✓ | × | ✓ | ✓ |
ContentDisposition | Object的展示形式。 | ✓ | × | ✓ | × | ✓ | ✓ |
ContentEncoding | Object的编码方式。 | ✓ | × | ✓ | × | ✓ | ✓ |
ContentLanguage | Object内容使用的语言。 | ✓ | × | ✓ | × | ✓ | ✓ |
ETag | 标识Object的内容。 | ✓ | × | ✓ | × | ✓ | ✓ |
FileAccessTime | Object的最后一次访问时间。 | ✓ | × | × | × | ✓ | ✓ |
FileCreateTime | Object的创建访问时间。 | ✓ | × | × | × | ✓ | ✓ |
FileModifiedTime | Object的最后一次修改时间。 | ✓ | × | × | × | ✓ | ✓ |
Filename | Object名称。 | ✓ | ✓ | ✓ | × | ✓ | ✓ |
ObjectACL | Object的读写权限。 | ✓ | × | ✓ | × | ✓ | ✓ |
OSSCRC64 | Object的64位CRC值。 | ✓ | × | ✓ | × | ✓ | ✓ |
OSSDeleteMarker | Object的删除标记。 | ✓ | × | ✓ | × | ✓ | ✓ |
OSSExpiration | Object的到期时间。 | ✓ | × | × | × | ✓ | ✓ |
OSSObjectType | Object的类型。 | ✓ | × | ✓ | × | ✓ | ✓ |
OSSStorageClass | Object的存储类型。 | ✓ | × | ✓ | × | ✓ | ✓ |
OSSTagging.* | Object标签。 | ✓ | × | ✓ | × | × | × |
OSSTaggingCount | Object标签个数。 | ✓ | × | × | ✓ | ✓ | ✓ |
OSSUserMeta.* | Object的自定义元信息。 | ✓ | × | ✓ | × | × | × |
OSSVersionId | Object的版本ID。 | ✓ | × | ✓ | × | ✓ | ✓ |
ServerSideEncryption | Object的服务端加密算法。 | ✓ | × | ✓ | × | ✓ | ✓ |
ServerSideEncryptionCustomerAlgorithm | 本地客户端加密文件时使用的加密算法。 | ✓ | × | ✓ | × | ✓ | ✓ |
Size | Object的大小。 | ✓ | × | × | ✓ | ✓ | ✓ |