更新数据集

最近更新时间:2024-06-12 17:46:51

我的收藏

功能描述

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

授权说明

授权策略中 action 设置为 ci:UpdateDataset 。查看所有 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: Auth String(详情请参见 请求签名 文档)。
通过子账号使用时,需要授予相关的权限,详情请参见 授权粒度详情 文档。

请求头

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

请求体

{
"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
string
请求 ID。
Dataset
Container
数据集的相关信息。
Dataset 节点内容:
参数名称
类型
描述
DatasetName
String
数据集名称。
TemplateId
String
检索模板。
Description
String
数据集描述信息。
CreateTime
String
数据集创建时间的时间戳,格式为 RFC3339Nano。
UpdateTime
String
数据集修改时间的时间戳,格式为 RFC3339Nano。
创建数据集后,如果未更新过数据集,则数据集修改时间的时间戳和数据集创建时间的时间戳相同。
BindCount
Long
数据集当前绑定的 COS Bucket 数量。
FileCount
Long
数据集中已建立元数据索引的文件数量,存在10分钟延迟,如需查看最新数据请使用查询数据集接口。
TotalFileSize
Long
数据集中已建立元数据索引的文件总大小,单位为字节,如需查看最新数据请使用查询数据集接口。