批量修改标签
功能介绍
批量修改标签。
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
URI
PUT /v2/{project_id}/datasets/{dataset_id}/data-annotations/labels
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
dataset_id |
是 |
String |
数据集ID。 |
|
project_id |
是 |
String |
用户项目ID。获取方法请参见获取项目ID和名称。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
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 |
操作是否执行成功。可选值如下：
|
请求示例
批量修改标签
{
"labels" : [ {
"name" : "Cat",
"property" : {
"@modelarts:color" : "#8a1524",
"@modelarts:rename_to" : "pussycat"
}
} ]
}
响应示例
状态码： 200
OK
{
"success" : true
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
OK |
|
401 |
Unauthorized |
|
403 |
Forbidden |
|
404 |
Not Found |
错误码
请参见错误码。
