全部产品
Search
文档中心

对象存储 OSS:OpenMetaQuery

更新时间:Sep 25, 2024

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

注意事项

  • 阿里云账号默认拥有开启元数据管理功能的权限。如果您希望通过RAM用户开启元数据管理功能,需确保RAM用户拥有oss:OpenMetaQuery权限。具体操作,请参见为RAM用户授权自定义的权限策略

  • 关于数据索引的更多信息,请参见数据索引概述

请求语法

POST /?metaQuery&comp=add&mode=basic HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

请求头

名称

类型

是否必选

示例值

描述

mode

字符串

basic

检索模式。取值如下:

  • basic(默认值):标量检索

  • semantic:向量检索

响应头

此接口仅涉及公共响应头。更多信息,请参见公共响应头(Common Response Headers)

示例

请求示例

POST /?metaQuery&comp=add&mode=basic 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: 0
Connection: keep-alive
Server: AliyunOSS
x-oss-request-id: 5C06A3B67B8B5A3DA422299D
x-oss-server-time: 544