更新数据集

最近更新时间:2025-08-22 10:26:11

我的收藏

功能描述

更新一个数据集(Dataset)的配置。

授权说明

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

限制说明

数据集名称无法更改。
更新时未填写的参数表示不更新。

请求

请求示例

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

请求头

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

请求体

{
"DatasetName": "test",
"Description": "test",
"TemplateId": "Official:COSBasicMeta"
}

请求参数

参数名称
描述
类型
是否必选
DatasetName
数据集名称,同一个账户下唯一。可通过 控制台接口 查询
String
Description
数据集描述信息。长度为1~256个英文或中文字符,默认值为空。
String
TemplateId
检索数据集关联的检索模板,在建立元数据索引时,后端将根据检索模板来决定采集文件的哪些元数据。
每个检索模板都包含若干个算子,不同的算子表示不同的处理能力,更多信息请参见 检索模板与算子
默认值为空,即不关联检索模板,不进行任何元数据的采集。
String

响应

响应头

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

响应体

{
"Dataset": {
"BindCount": 0,
"CreateTime": "2023-12-25 15:16:20.692674978 +0800 CST",
"DatasetName": "test",
"Description": "test",
"FileCount": 0,
"TemplateId": "Official:COSBasicMeta",
"TotalFileSize": 0,
"UpdateTime": "2023-12-25 15:16:20.692675128 +0800 CST"
},
"RequestId": "NWFjMzQ0MDZfOTBmYTUwXzZkZV8z****"
}
响应包体具体数据内容如下:
参数名称
描述
类型
RequestId
请求 ID。
string
Dataset
数据集信息。同创建数据集接口中响应体的 Dataset
Container