更新时间:2025-05-26 GMT+08:00
批量删除镜像标签
功能介绍
该接口用于为指定镜像批量删除标签。
约束与限制
- 此接口为幂等接口,如果指定的标签不存在,则默认视为删除成功。
- 对标签的key、value不做字符集范围校验,key不允许为空或空白字符串;value为可选,且不对value做校验。如果要删除的标签不存在,视为删除成功,不报错。删除时,对标签的key、value做长度校验,标签的key不超过127,value不超过255。
调试
您可以在API Explorer中调试该接口。
请求消息
- 请求参数
参数
是否必选
参数类型
描述
tags
是
Array of objects
要操作的标签列表。详情请参见表2。
请求示例
批量删除镜像标签,其中,标签键为“key1”对应的值为“value1”、标签键为“key2”对应的值为“value2”。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 |
DELETE https://{Endpoint}/v1/fd73a4a14a4a4dfb9771a8475e5198ea/cloudimages/67e17426-359e-49fb-aa12-0bd1756ec240/tags/delete { "tags": [ { "value": "value1", "key": "key1" }, { "value": "value2", "key": "key2" }, { "key": "key3", "value": "" } ] } |
父主题: 镜像标签