调用GetMetaQueryStatus接口获取指定存储空间Bucket的元数据索引库信息 - 对象存储 OSS

调用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：增量扫描中父节点：MetaQueryStatus
State	字符串	Running	元数据索引库的状态。取值范围如下： Ready：创建后准备中元数据索引库正在准备中，您无法通过元数据索引库查询到数据。 Stop：已暂停 Running：运行中 Retrying：创建失败后重试中 Failed：创建失败 Deleted：已删除父节点：MetaQueryStatus
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表示时区。父节点：MetaQueryStatus
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表示时区。父节点：MetaQueryStatus
MetaQueryMode	字符串	basic	检索模式。 basic（默认值）：标量检索 semantic：向量检索父节点：MetaQueryStatus

示例

请求示例

GET /?metaQuery HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Wed, 11 Sep 2024 13:08:38 GMT
Authorization: OSS qn6q**************:77Dv****************

返回示例

HTTP/1.1 200 OK
x-oss-request-id: 5C1B138A109F4E405B2D****
Date: Wed, 11 Sep 2024 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>2024-09-11T10:49:17.289372919+08:00</CreateTime>
  <UpdateTime>2024-09-11T10:49:17.289372919+08:00</UpdateTime>
  <MetaQueryMode>basic<MetaQueryMode>
</MetaQueryStatus>