# 删除镜像标签 - DeleteImageTag
#### 功能介绍
该接口用于为镜像删除指定的标签。
#### 约束与限制
- 为兼容遗留数据，不对key进行字符集校验和长度校验。
- 此接口为非幂等接口：如果指定删除的key不存在，则返回404状态码。
 
#### 调试
您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?locale=zh-cn&consoleCurrentProductId=ims&consoleCurrentProductshort=&product=IMS&api=DeleteImageTag)中调试该接口。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-ims/ims_03_appendix_03.html)。
#### URI
DELETE /v2/{project_id}/images/{image_id}/tags/{key}
参数说明请参见[表1]。
 表1参数说明 
| 参数         | 是否必选 | 参数类型   | 描述                                                                                       |
|:---|:---|:---|:---|
| project_id | 是    | String | 项目ID                                                                                     |
| image_id   | 是    | String | 镜像ID                                                                                     |
| key        | 是    | String | 要删除的标签的键。key参数说明请参考[镜像标签数据格式](https://support.huaweicloud.com/api-ims/ims_03_0902.html)。 |
   
#### 请求消息
请求参数
无
#### 请求示例
删除镜像标签。
```
DELETE https://{Endpoint}/v2/fd73a4a14a4a4dfb9771a8475e5198ea/images/67e17426-359e-49fb-aa12-0bd1756ec240/tags/key1
```
#### 响应消息
- 响应参数 无
  
- 响应样例
  ```
  STATUS CODE 204
  ```
  
 
#### 返回值
- 正常 204
  
- 异常
  
  | 返回值                       | 说明      |
  |:---|:---|
  | 400 Bad Request           | 请求错误。   |
  | 401 Unauthorized          | 鉴权失败。   |
  | 403 Forbidden             | 没有操作权限。 |
  | 404 Not Found             | 找不到资源。  |
  | 500 Internal Server Error | 服务内部错误。 |
  | 503 Service Unavailable   | 服务不可用。  |