赛尔校园公共服务平台 Logo
平台使用
阿里云
百度云
移动云
智算服务
教育生态
登录 →
赛尔校园公共服务平台 Logo
平台使用 阿里云 百度云 移动云 智算服务 教育生态
登录
  1. 首页
  2. 阿里云
  3. 对象存储
  4. 开发参考
  5. API参考
  6. 关于Bucket操作
  7. 数据索引(Data Indexing)
  8. GetMetaQueryStatus

GetMetaQueryStatus

  • 数据索引(Data Indexing)
  • 发布于 2025-04-21
  • 0 次阅读
文档编辑
文档编辑

调用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>

SDK

本接口对应的各语言SDK如下:

  • Java

  • Python

  • Go V2

命令行工具ossutil

GetMetaQueryStatus接口所对应的ossutil命令,请参见get-meta-query-status。

相关文章

OpenMetaQuery 2025-04-21 18:15

调用OpenMetaQuery接口为存储空间(Bucket)开启元数据管理功能并选择检索模式。开启元数据管理功能并选择检索模式后,OSS会为Bucket创建元数据索引库并为Bucket中的所有文件(Object)建立元数据索引。元数据索引库创建完成后,OSS会继续对Bucket中新增文件进行准实时的

GetMetaQueryStatus 2025-04-21 18:15

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

DoMetaQuery 2025-04-21 18:15

调用DoMetaQuery接口查询满足指定条件的文件(Object),并按照指定字段和排序方式列出文件信息。您也可以通过Query的嵌套使用实现复杂查询,以及通过聚合操作实现对不同字段的值进行统计和分析。

CloseMetaQuery 2025-04-21 18:15

调用CloseMetaQuery接口关闭存储空间(Bucket)的元数据管理功能。关闭元数据管理功能后,OSS会自动删除Bucket的元数据索引库,您将无法进行元数据索引。

附录:标量检索的字段和操作符列表 2025-04-21 18:15

本文介绍OSS标量检索的字段和操作符列表。 注意事项

附录:向量检索的字段和操作符列表 2025-04-21 18:15

本文介绍OSS向量检索模式支持检索的字段和操作符。 支持检索的字段 使用

目录
Copyright © 2025 your company All Rights Reserved. Powered by 赛尔网络.
京ICP备14022346号-15
gongan beian 京公网安备11010802041014号