调用GetMetaQueryStatus接口获取指定存储空间（Bucket）的元数据索引库信息。

注意事项

要获取存储空间的元数据索引库信息，您必须有oss:GetMetaQueryStatus权限。具体操作，请参见为RAM用户授权自定义的权限策略。

请求语法

GET /?metaQuery HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

请求头

此接口仅涉及公共请求头。更多信息，请参见公共请求头（Common Request Headers）。

响应头

此接口仅涉及公共响应头。更多信息，请参见公共响应头（Common Response Headers）。

响应元素

名称 类型 示例值 描述
MetaQueryStatus 容器 不涉及 元数据信息的容器。

子节点：State、Phase、CreateTime、UpdateTime
Phase 字符串 FullScanning 当前扫描类型。取值范围如下：
  • FullScanning：全量扫描中
  • IncrementalScanning：增量扫描中

父节点：MetaQuery
State 字符串 Running 元数据索引库的状态。取值范围如下：
  • Ready：创建后准备中

    元数据索引库正在准备中，您无法通过元数据索引库查询到数据。

  • Stop：已暂停
  • Running：运行中
  • Retrying：创建失败后重试中
  • Failed：创建失败
  • Deleted：已删除

父节点：MetaQuery
CreateTime 字符串 2021-08-02T10:49:17.289372919+08:00 元数据索引库的创建时间，遵循RFC 3339标准格式，格式为YYYY-MM-DDTHH:mm:ss+TIMEZONE。其中YYYY-MM-DD表示年月日，T表示time元素的开头，HH:mm:ss表示时分秒，TIMEZONE表示时区。

父节点：MetaQuery
UpdateTime 字符串 2021-08-02T10:49:17.289372919+08:00 元数据索引库的更新时间，遵循RFC 3339标准格式，格式为YYYY-MM-DDTHH:mm:ss+TIMEZONE。其中YYYY-MM-DD表示年月日，T表示time元素的开头，HH:mm:ss表示时分秒，TIMEZONE表示时区。

父节点：MetaQuery

示例

请求示例
GET /?metaQuery 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: 118
Content-Type: application/xml
Connection: keep-alive
Server: AliyunOSS
<?xml version="1.0" encoding="UTF-8"?>
<MetaQueryStatus>
  <State>Running</State>
  <Phase>FullScanning</Phase>
  <CreateTime>2021-08-02T10:49:17.289372919+08:00</CreateTime>
  <UpdateTime>2021-08-02T10:49:17.289372919+08:00</UpdateTime>
</MetaQueryStatus>

错误码

错误码 HTTP状态码 描述
MetaQueryNotExist 400 Bucket不存在元数据索引库，请确保已为Bucket开启元数据管理功能并等待元数据索引库创建成功后重试。
AccessDenied 403 没有访问该Bucket的权限，请确保已为RAM用户授予访问该Bucket的权限。
NoSuchBucket 404 目标Bucket不存在，请设置正确的Bucket名称。