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