CloseMetaQuery

更新时间:
复制 MD 格式

调用 CloseMetaQuery 接口关闭指定 Bucket 的元数据管理功能。关闭后,系统会异步删除该 Bucket 已建立的元数据索引,相关元数据管理功能均不再可用。

注意事项

  • 阿里云账号默认拥有关闭元数据管理功能的权限。如需通过 RAM 用户关闭,请确保 RAM 用户拥有 oss:MetaQuery 权限。

  • 关闭操作是异步的。接口返回 200 仅表示请求已被接收,实际清理由服务端在后台完成,通常需要几分钟。

  • 接口幂等。对未开启、已关闭或正在清理的 Bucket 调用本接口,均返回 200,不会报错。

  • 关闭会同时清理该 Bucket 下的所有 Dataset 及其已索引的元数据,包括由 RouteRule.AutoCreateDataset=True 自动创建的 Dataset。该操作不可恢复,请谨慎调用。

  • 关闭后如需重新开启,需等待后台数据清理完成,通常需要几分钟。提前调用 OpenMetaQuery 可能会返回 MetaQueryNotReady

请求语法

POST /?metaQuery&action=closeMetaQuery HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

请求头

此接口仅涉及公共请求头。更多信息,请参见公共请求头(Common Request Headers)

请求元素

此接口无请求元素。

响应头

此接口仅涉及公共响应头。更多信息,请参见公共响应头(Common Response Headers)

响应元素

此接口无响应元素。

示例

请求示例

POST /?metaQuery&action=closeMetaQuery HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Wed, 20 May 2026 10:00:00 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20260520/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

返回示例

HTTP/1.1 200 OK
x-oss-request-id: 64C8B6F4E7C5A3A8B9D6E7F2
Date: Wed, 20 May 2026 10:00:01 GMT
Content-Length: 0
Connection: keep-alive
Server: AliyunOSS