更新时间:2024-03-01 GMT+08:00

删除镜像标签

功能介绍

该接口用于为镜像删除指定的标签。

约束与限制

  • 为兼容遗留数据,不对key进行字符集校验和长度校验。
  • 此接口为非幂等接口:如果指定删除的key不存在,则返回404状态码。

URI

DELETE /v2/{project_id}/images/{image_id}/tags/{key}

参数说明请参见表1
表1 参数说明

参数

是否必选

参数类型

描述

project_id

String

项目ID

image_id

String

镜像ID

key

String

要删除的标签的键

请求消息

请求参数

请求示例

删除镜像标签。

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

    服务不可用。