功能介紹
該接口用于為指定 鏡像 添加或更新指定的單個(gè)標(biāo)簽。
約束與限制
- 每個(gè)標(biāo)簽由鍵值對(duì)組成，標(biāo)簽的key的長(zhǎng)度不超過(guò)36個(gè)字符，value的長(zhǎng)度不超過(guò)43個(gè)字符。key不能為空或空白字符串，value不能為空，但可以是空白字符串。
- 單個(gè)鏡像最多添加10個(gè)標(biāo)簽。
- 此接口為冪等接口：如果創(chuàng)建的標(biāo)簽已經(jīng)存在，即key相同而value不同，則更新對(duì)應(yīng)標(biāo)簽；如果創(chuàng)建的標(biāo)簽已經(jīng)存在，key/value均相同，則不重復(fù)添加此標(biāo)簽，視為添加成功。
調(diào)試
您可以在API Explorer中調(diào)試該接口。
URI
POST /v2/{project_id}/images/{image_id}/tags
請(qǐng)求消息
- 請(qǐng)求參數(shù)
請(qǐng)求示例
添加鏡像標(biāo)簽，其中，標(biāo)簽鍵為“key1”對(duì)應(yīng)的值為“value1”。
POST https://{Endpoint}/v2/fd73a4a14a4a4dfb9771a8475e5198ea/images/67e17426-359e-49fb-aa12-0bd1756ec240/tags { "tag": { "value": "value1", "key": "key1" } } |
