功能介紹
該接口用于為指定 鏡像 批量添加/更新、刪除標(biāo)簽。
約束與限制
- 每個標(biāo)簽由鍵值對組成，標(biāo)簽的key的長度不超過36個字符，value的長度不超過43個字符。key不能為空或者空白字符串，value不能為空，但可以是空白字符串。
- 單個鏡像最多添加10個標(biāo)簽。
- 請求體中的多個標(biāo)簽的key不允許重復(fù)。
- 此接口為冪等接口：
創(chuàng)建時，如果創(chuàng)建的標(biāo)簽已經(jīng)存在，即key相同而value不同，則更新對應(yīng)標(biāo)簽；如果創(chuàng)建的標(biāo)簽已經(jīng)存在，key/value均相同，則不進行重復(fù)添加，視為添加成功。
刪除時，如果指定的標(biāo)簽不存在，則默認(rèn)視為刪除成功。
調(diào)試
您可以在API Explorer中調(diào)試該接口。
URI
POST /v2/{project_id}/images/{image_id}/tags/action
請求消息
請求示例
- 批量添加鏡像標(biāo)簽，其中，標(biāo)簽鍵為“key1”對應(yīng)的值為“value1”、標(biāo)簽鍵為“key2”對應(yīng)的值為“value2”。
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" }
- 批量刪除鏡像標(biāo)簽，其中，標(biāo)簽鍵為“key1”對應(yīng)的值為“value1”、標(biāo)簽鍵為“key2”對應(yīng)的值為“value2”。
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" }
