# 按标签名称更新单个标签
#### 功能介绍
按标签名称更新单个标签。
#### 调试
您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/ModelArts/doc?api=UpdateLabel)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### URI
PUT /v2/{project_id}/datasets/{dataset_id}/data-annotations/labels/{label_name}
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述                                                                                               |
|:---|:---|:---|:---|
| dataset_id | 是    | String | 数据集ID。                                                                                           |
| label_name | 是    | String | 标签名称。                                                                                            |
| project_id | 是    | String | 用户项目ID。获取方法请参见[获取项目ID和名称](https://support.huaweicloud.com/api-modelarts/modelarts_03_0147.html)。 |
表2Query参数 
| 参数         | 是否必选 | 参数类型    | 描述                                                                                                                                        |
|:---|:---|:---|:---|
| label_type | 否    | Integer | 标签类型。可选值如下： - 0：图像分类 - 1：物体检测 - 3: 图像分割 - 100：文本分类 - 101：命名实体 - 102：文本三元组关系标签 - 103：文本三元组实体标签 - 200：语音分类 - 201：语音内容 - 202：语音分割 - 600：视频标注 |
#### 请求参数
表3请求Body参数 
| 参数                       | 是否必选 | 参数类型   | 描述                                                                                                                                  |
|:---|:---|:---|:---|
| @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 | 内置属性：三元组关系标签的指向实体类型，创建关系标签时必须指定，该参数仅文本三元组数据集使用。                                                                                     |
   
#### 响应参数
**状态码： 204**
表4响应Body参数 
| 参数         | 参数类型    | 描述                                       |
|:---|:---|:---|
| error_code | String  | 操作失败的错误码。                                |
| error_msg  | String  | 操作失败的错误信息。                               |
| success    | Boolean | 操作是否执行成功。可选值如下： - true：执行成功 - false：执行失败 |
   
#### 请求示例
按标签名称更新单个标签
```
{
  "@modelarts:color" : "#93c47d"
}
```
#### 响应示例
**状态码： 204**
No Content
```
{ }
```
#### 状态码
| 状态码 | 描述           |
|:---|:---|
| 204 | No Content   |
| 401 | Unauthorized |
| 403 | Forbidden    |
| 404 | Not Found    |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-modelarts/modelarts_03_0095.html)。