批量删除标签

批量删除标签。

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

POST /v2/{project_id}/datasets/{dataset_id}/data-annotations/labels/delete

表1 路径参数
参数	是否必选	参数类型	描述
dataset_id	是	String	数据集ID。
project_id	是	String	用户项目ID。获取方法请参见获取项目ID和名称。

表2 Query参数
参数	是否必选	参数类型	描述
delete_policy	否	Integer	是否删除标签及包含标签的样本。可选值如下： 0：只删除标签 1：删除标签及包含标签的样本 2：删除标签和包含标签的样本及其源文件

表3 请求Body参数
参数	是否必选	参数类型	描述
labels	否	Array of Label objects	待删除标签列表。

表4 Label
参数	是否必选	参数类型	描述
attributes	否	Array of LabelAttribute objects	标签的多维度属性，如标签为“音乐”，可能包含属性“风格”、“歌手”等。
name	否	String	标签名称。
property	否	LabelProperty object	标签基本属性键值对，如颜色、快捷键等。
type	否	Integer	标签类型。可选值如下： 0：图像分类 1：物体检测 3: 图像分割 100：文本分类 101：命名实体 102：文本三元组关系标签 103：文本三元组实体标签 200：语音分类 201：语音内容 202：语音分割 600：视频标注

表5 LabelAttribute
参数	是否必选	参数类型	描述
default_value	否	String	标签属性默认值。
id	否	String	标签属性ID。可通过调用标签列表查询。
name	否	String	标签属性名称。不能超过64个字符，不能包含字符!<>=&"'。
type	否	String	标签属性类型。可选值如下： text：文本 select：单选下拉列表
values	否	Array of LabelAttributeValue objects	标签属性值列表。

表6 LabelAttributeValue
参数	是否必选	参数类型	描述
id	否	String	标签属性值ID。
value	否	String	标签属性值。

表7 LabelProperty
参数	是否必选	参数类型	描述
@modelarts:color	否	String	内置属性：标签展示的颜色，为色彩的16进制代码，默认为空。例如：“#FFFFF0”。
@modelarts:default_shape	否	String	内置属性：物体检测标签的默认形状（物体检测标签专用属性），默认为空。可选值如下： bndbox：矩形。 polygon：多边形。 circle：圆形。 line：直线。 dashed：虚线。 point：点。 polyline：折线。
@modelarts:from_type	否	String	内置属性：三元组关系标签的起始实体类型，创建关系标签时必须指定，该参数仅文本三元组数据集使用。
@modelarts:rename_to	否	String	内置属性：重命名后的标签名。
@modelarts:shortcut	否	String	内置属性：标签快捷键，默认为空。例如：“D”。
@modelarts:to_type	否	String	内置属性：三元组关系标签的指向实体类型，创建关系标签时必须指定，该参数仅文本三元组数据集使用。

状态码： 200

表8 响应Body参数
参数	参数类型	描述
error_code	String	操作失败的错误码。
error_msg	String	操作失败的错误信息。
results	Array of BatchResponse objects	删除标签响应体。
success	Boolean	操作是否执行成功。可选值如下： true：执行成功 false：执行失败

表9 BatchResponse
参数	参数类型	描述
error_code	String	操作失败的错误码。
error_msg	String	操作失败的错误信息。
success	Boolean	操作是否执行成功。可选值如下： true：执行成功 false：执行失败

删除名称为“strawberry”的标签。

{
  "labels" : [ {
    "name" : "strawberry"
  } ]
}

状态码： 200

{
  "success" : true
}

请参见错误码。

父主题： 数据管理（旧版）