tencent cloud

数据万象

文档数据万象API 文档智能检索 MetaInsight元数据管理更新元数据索引

更新元数据索引

下载
聚焦模式
字号
最后更新时间： 2026-09-08 16:24:28

功能描述

更新数据集内已索引的文件的部分元数据。
并非所有的元数据都允许您自定义更新，在您发起更新请求时需要填写数据集，会根据该数据集的检索模板重新提取元数据并更新已存在的元数据索引，此外您也可以更新部分自定义的元数据索引，如 CustomLabels、CustomId 等字段，具体请参考 请求参数说明。

授权说明

通过子账号使用时，需要在 授权策略 的 action 中添加 ci:UpdateFileMetaIndex 权限。数据万象支持的所有操作接口请参见 CI action。

使用限制

使用该接口时，请先确认相关限制条件。详情请参见 使用限制。

请求

请求示例

PUT /filemeta HTTP/1.1
Host: <AppId>.ci.ap-jakarta.myqcloud.com
Authorization: Auth String
Content-Length: xxx
Content-Type: application/json
Accept: application/json
说明：
Authorization：携带鉴权信息，用于验证请求合法性的请求头，详情请参见 请求签名 文档。

请求头

此接口仅使用公共请求头部，详情请参见 公共请求头部 文档。

请求体

{
    "DatasetName": "test001",
    "File": {
        "URI": "cos://examplebucket-1250000000/test1/img.jpg",
        "CustomId": "001",
        "CustomLabels": {
            "age": "18",
            "level": "18"
        },
        "MediaType": "image",
        "ContentType": "image/jpeg"
    }
}
具体的参数如下：
参数名称
描述
类型
是否必选
DatasetName
数据集名称，同一个账户下唯一。可通过 控制台 或 接口 查询
String
是
File
用于建立索引的文件信息
Container
是
File 节点内容：
参数名称
描述
类型
是否必选
URI
资源标识字段，表示需要建立索引的文件地址，当前仅支持 COS 上的文件，字段规则：cos://<BucketName>/<ObjectKey>，其中 BucketName 表示 COS 存储桶名称，ObjectKey 表示文件完整路径，例如：cos://examplebucket-1250000000/test1/img.jpg
注意：
仅支持本账号内的 COS 文件
不支持 HTTP 开头的地址
String
是
CustomId
自定义 ID。该文件索引到数据集后，作为该行元数据的属性存储，用于和您的业务系统进行关联、对应。您可以根据业务需求传入该值，例如将某个 URI 关联到您系统内的某个 ID。推荐传入全局唯一的值。在查询时，该字段支持前缀查询和排序，详情请见 标量检索表达式语法
String
否
CustomLabels
自定义标签。您可以根据业务需要自定义添加标签键值对信息，用于在查询时可以据此为筛选项进行检索，详情请见 标量检索表达式语法
Object
否
Key
自定义标签键。详情请见 标量检索表达式语法
String
否
Value
自定义标签值。详情请见 标量检索表达式语法
String
否
MediaType
可选项，文件媒体类型，枚举值：
image：图片
document：文档
archive：压缩包
video：视频
audio：音频
other：其他
String
否
ContentType
可选项，文件内容类型（MIME Type），如image/jpeg
String
否

响应

响应头

此接口仅返回公共响应头部，详情请参见 公共响应头部 文档。

响应体

{
    "EventId": "wie3580c6ca88dd83382cf52540067****",
    "RequestId": "NWFjMzQ0MDZfOTBmYTUwXzZkZV8z****"
}
响应包体具体数据内容如下：
参数名称
类型
描述
EventId
String
创建元数据索引的任务 ID
RequestId
String
请求 ID

上一篇: 创建元数据索引下一篇: 查询元数据索引

帮助和支持

本页内容是否解决了您的问题？

填写满意度调查问卷，共创更好文档体验。

文档反馈

搜索
    请输入关键词搜索文档