批量删除标签
功能介绍
批量删除标签。
调试
您可以在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 |
错误码
请参见错误码。
