文档首页/ 镜像服务 IMS/ API参考/ API/ 镜像标签/ 批量添加删除镜像标签
更新时间:2024-11-14 GMT+08:00

批量添加删除镜像标签

功能介绍

该接口用于为指定镜像批量添加/更新、删除标签。

约束与限制

  • 每个标签由键值对组成,标签的key的长度不超过36个字符,value的长度不超过43个字符。key不能为空或者空白字符串,value不能为空,但可以是空白字符串。
  • 单个镜像最多添加10个标签。
  • 请求体中的多个标签的key不允许重复。
  • 此接口为幂等接口:

    创建时,如果创建的标签已经存在,即key相同而value不同,则更新对应标签;如果创建的标签已经存在,key/value均相同,则不进行重复添加,视为添加成功。

    删除时,如果指定的标签不存在,则默认视为删除成功。

  • 批量删除时对key、value的限制:

    删除时,对标签的key、value不做字符集范围校验,key不允许为空或空白字符串;value为可选,且不对value做校验。如果要删除的标签不存在,视为删除成功,不报错。删除时,对标签的key、value做长度校验,标签的key不超过127,value不超过255。

URI

POST /v2/{project_id}/images/{image_id}/tags/action

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

参数

是否必选

参数类型

描述

project_id

String

项目ID

image_id

String

镜像ID

请求消息

  • 请求参数

    参数

    是否必选

    参数类型

    描述

    tags

    Array of objects

    要操作的标签列表。详情请参见表2

    action

    String

    要进行的标签操作,区分大小写。支持create、delete,分别用于批量地创建/更新、删除标签。

    表2 tags数据结构说明

    参数

    是否必选

    参数类型

    描述

    key

    String

    标签的键,键不能为空。

    value

    String

    标签的值。

请求示例

  • 批量添加镜像标签,其中,标签键为“key1”对应的值为“value1”、标签键为“key2”对应的值为“value2”。
     1
     2
     3
     4
     5
     6
     7
     8
     9
    10
    11
    12
    13
    14
    15
    16
    POST https://{Endpoint}/v2/fd73a4a14a4a4dfb9771a8475e5198ea/images/67e17426-359e-49fb-aa12-0bd1756ec240/tags/action
    {
       "tags": [{
          "value": "value1",
          "key": "key1"
       },
       {
          "value": "value2",
          "key": "key2"
       },
       {
          "value": "",
          "key": "key3"
       }],
       "action": "create"
    }
    
  • 批量删除镜像标签,其中,标签键为“key1”对应的值为“value1”、标签键为“key2”对应的值为“value2”。
     1
     2
     3
     4
     5
     6
     7
     8
     9
    10
    11
    12
    13
    14
    15
    16
    POST https://{Endpoint}/v2/fd73a4a14a4a4dfb9771a8475e5198ea/images/67e17426-359e-49fb-aa12-0bd1756ec240/tags/action
    {
       "tags": [{
          "value": "value1",
          "key": "key1"
       },
       {
          "value": "value2",
          "key": "key2"
       },
       {
          "value": "",
          "key": "key3"
       }],
          "action": "delete"
    }
    

响应消息

  • 响应参数

  • 响应样例
    STATUS CODE 204

返回值

  • 正常

    204

  • 异常

    返回值

    说明

    400 Bad Request

    请求错误。

    401 Unauthorized

    鉴权失败。

    403 Forbidden

    没有操作权限。

    404 Not Found

    找不到资源。

    500 Internal Server Error

    服务内部错误。

    503 Service Unavailable

    服务不可用。