# 增加或修改标签 - CreateOrUpdateTags
#### 功能介绍
该接口主要用于为某个镜像增加或修改一个自定义标签。通过自定义标签，用户可以将镜像进行分类。
#### 调试
您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?locale=zh-cn&consoleCurrentProductId=ims&consoleCurrentProductshort=&product=IMS&api=CreateOrUpdateTags)中调试该接口。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-ims/ims_03_appendix_03.html)。
#### URI
PUT /v1/cloudimages/tags
#### 请求消息
- 请求参数
  
  | 参数        | 是否必选 | 参数类型                                                   | 描述                                                                                                                                                       |
  |:---|:---|:---|:---|
  | image_id  | 是    | String                                                 | 镜像ID。 如何获取镜像ID，请参见[查询镜像列表 - ListImages](https://support.huaweicloud.com/api-ims/ims_03_0602.html)。                         |
  | tag       | 否    | String                                                 | 标签数据。 tag和image_tag只能使用一个。tag参数说明请参考[镜像标签数据格式](https://support.huaweicloud.com/api-ims/ims_03_0902.html)。                  |
  | image_tag | 否    | [ResourceTag] object | 新规范的镜像标签列表。image_tag参数说明请参考[镜像标签数据格式](https://support.huaweicloud.com/api-ims/ims_03_0902.html)。默认为空。 tag和image_tag只能使用一个。 |
     
   表1image_tag数据结构说明 
  | 参数    | 是否必选 | 参数类型   | 描述    |
  |:---|:---|:---|:---|
  | key   | 是    | String | 标签的键。 |
  | value | 是    | String | 标签的值。 |
     
  
 
#### 请求示例
- 使用tags标签数据格式，增加或修改标签。
  ```
  PUT https://{Endpoint}/v1/cloudimages/tags
  {
    "image_id": "62a15f6c-9197-44d2-89c7-708981c1bec1",
    "tag": "aaaa.1111"
  }
  ```
  
- 使用image_tag标签数据格式，增加或修改标签。
  ```
  PUT https://{Endpoint}/v1/cloudimages/tags
  {
    "image_id": "67437ebd-2563-46e0-887e-ad1923977fa1",
    "image_tag": {"key":"key1","value":"value1"}
  }
  ```
  
 
#### 响应消息
- 响应参数 无
  
- 响应样例
  ```
  STATUS CODE 204
  ```
  
 
#### 返回值
- 正常 204
  
- 异常
  
  | 返回值                       | 说明      |
  |:---|:---|
  | 400 Bad Request           | 请求错误。   |
  | 401 Unauthorized          | 鉴权失败。   |
  | 403 Forbidden             | 没有操作权限。 |
  | 404 Not Found             | 找不到资源。  |
  | 500 Internal Server Error | 服务内部错误。 |
  | 503 Service Unavailable   | 服务不可用。  |