OpenMetaQuery
调用OpenMetaQuery接口为存储空间(Bucket)开启元数据管理功能。开启元数据管理功能后,OSS会为Bucket创建元数据索引库并为Bucket中的所有文件(Object)建立元数据索引。元数据索引库创建完成后,OSS会继续对Bucket中新增文件进行准实时的增量追踪扫描并为增量文件建立元数据索引。
注意事项
权限说明
阿里云账号默认拥有开启元数据管理功能的权限。如果您希望通过RAM用户开启元数据管理功能,需确保RAM用户拥有
oss:OpenMetaQuery
权限。具体操作,请参见为RAM用户授权自定义的权限策略。Bucket限制
默认只支持为文件数量在1亿以下的Bucket开启元数据管理功能。
费用说明
开启元数据管理会产生一定的费用,但公测期间暂不收费。关于数据索引计费项的更多信息,请参见数据索引费用。
建立索引所需时间
开启元数据管理功能时,建立索引所需时间与Bucket内存量文件数量成正比。文件数量越多,建立索引的时间越长。
请求语法
POST /?metaQuery&comp=add HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue
请求头
此接口仅涉及公共请求头。更多信息,请参见公共请求头(Common Request Headers)。
响应头
此接口仅涉及公共响应头。更多信息,请参见公共响应头(Common Response Headers)。
示例
请求示例
POST /?metaQuery&comp=add HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Mon, 26 Jul 2021 13:08:38 GMT
Authorization: OSS qn6qrrqxo2oawuk53otf****:ceOEyZavKY4QcjoUWYSpYbJ3****
返回示例
HTTP/1.1 200 OK
x-oss-request-id: 5C1B138A109F4E405B2D****
Date: Mon, 26 Jul 2021 13:08:38 GMT
Content-Length: 0
Connection: keep-alive
Server: AliyunOSS
x-oss-request-id: 5C06A3B67B8B5A3DA422299D
x-oss-server-time: 544
错误码
错误码 | HTTP状态码 | 描述 |
MetaQueryAlreadyExist | 400 | Bucket存在正在构建的元数据索引库,请等待元数据索引库创建完成后重试。 |
AccessDenied | 403 | 没有访问该Bucket的权限,请确保已为RAM用户授予访问该Bucket的权限。 |
NoSuchBucket | 404 | 目标Bucket不存在,请设置正确的Bucket名称。 |