更新数据集
功能介绍
修改数据集的基本信息，如数据集名称、描述、当前版本或标签等信息。
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
URI
PUT /v2/{project_id}/datasets/{dataset_id}
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| dataset_id | 是 | String | 数据集ID。 |
| project_id | 是 | String | 用户项目ID。获取方法请参见获取项目ID和名称。 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| add_labels | 否 | Array of Label objects | 新增标签列表。 |
| current_version_id | 否 | String | 数据集的当前版本ID。 |
| dataset_name | 否 | String | 数据集名称，名称只能是中文、字母、数字、下划线或中划线组成的合法字符串，长度为1-100位。 |
| delete_labels | 否 | Array of Label objects | 删除标签列表。 |
| description | 否 | String | 数据集描述，长度为0-256位，不能包含^!<>=&"'特殊字符。 |
| update_labels | 否 | Array of Label objects | 更新标签列表。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| attributes | 否 | Array of LabelAttribute objects | 标签的多维度属性，如标签为“音乐”，可能包含属性“风格”、“歌手”等。 |
| name | 否 | String | 标签名称。 |
| property | 否 | LabelProperty object | 标签基本属性键值对，如颜色、快捷键等。 |
| type | 否 | Integer | 标签类型。可选值如下： |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| default_value | 否 | String | 标签属性默认值。 |
| id | 否 | String | 标签属性ID。可通过调用标签列表查询。 |
| name | 否 | String | 标签属性名称。不能超过64个字符，不能包含字符!<>=&"'。 |
| type | 否 | String | 标签属性类型。可选值如下： |
| values | 否 | Array of LabelAttributeValue objects | 标签属性值列表。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| @modelarts:color | 否 | String | 内置属性：标签展示的颜色，为色彩的16进制代码，默认为空。例如：“#FFFFF0”。 |
| @modelarts:default_shape | 否 | String | 内置属性：物体检测标签的默认形状（物体检测标签专用属性），默认为空。可选值如下： |
| @modelarts:from_type | 否 | String | 内置属性：三元组关系标签的起始实体类型，创建关系标签时必须指定，该参数仅文本三元组数据集使用。 |
| @modelarts:rename_to | 否 | String | 内置属性：重命名后的标签名。 |
| @modelarts:shortcut | 否 | String | 内置属性：标签快捷键，默认为空。例如：“D”。 |
| @modelarts:to_type | 否 | String | 内置属性：三元组关系标签的指向实体类型，创建关系标签时必须指定，该参数仅文本三元组数据集使用。 |
响应参数
状态码： 200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| dataset_id | String | 数据集ID。 |
请求示例
更新数据集
{
"description" : "just a test",
"add_labels" : [ {
"name" : "Ants",
"type" : 0,
"property" : {
"@modelarts:color" : "#3399ff"
}
} ]
} 响应示例
状态码： 200
OK
{
"dataset_id" : "gfghHSokody6AJigS5A"
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | OK |
| 401 | Unauthorized |
| 403 | Forbidden |
| 404 | Not Found |
错误码
请参见错误码。
