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:增量扫描中

父节点: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>