批量删除标签
功能介绍
批量删除标签。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
POST /v2/{project_id}/datasets/{dataset_id}/data-annotations/labels/delete
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
dataset_id | 是 | String | 数据集ID。 |
project_id | 是 | String | 用户项目ID。获取方法请参见获取项目ID和名称。 |
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
delete_policy | 否 | Integer | 是否删除标签及包含标签的样本。可选值如下:
|
请求参数
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
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
参数 | 参数类型 | 描述 |
|---|---|---|
error_code | String | 操作失败的错误码。 |
error_msg | String | 操作失败的错误信息。 |
results | Array of BatchResponse objects | 删除标签响应体。 |
success | Boolean | 操作是否执行成功。可选值如下:
|
请求示例
删除名称为“strawberry”的标签。
{
"labels" : [ {
"name" : "strawberry"
} ]
} 响应示例
状态码: 200
OK
{
"success" : true
} 状态码
状态码 | 描述 |
|---|---|
200 | OK |
401 | Unauthorized |
403 | Forbidden |
404 | Not Found |
错误码
请参见错误码。

