调用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 | 当前扫描类型。取值范围如下:
父节点:MetaQuery |
State | 字符串 | Running | 元数据索引库的状态。取值范围如下:
父节点: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 qn6q**************:77Dv****************
返回示例
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名称。 |