文档

GetMetaQueryStatus

更新时间:

调用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名称。

  • 本页导读 (1)
文档反馈