功能介紹
該接口主要用于為某個 鏡像 增加或修改一個自定義標(biāo)簽。通過自定義標(biāo)簽,用戶可以將鏡像進行分類。
調(diào)試
您可以在API Explorer中調(diào)試該接口。
URI
PUT /v1/cloudimages/tags
請求消息
- 請求參數(shù)
參數(shù)
是否必選
參數(shù)類型
描述
image_id
是
String
鏡像ID。
如何獲取鏡像ID,請參見查詢鏡像列表。
tag
否
String
標(biāo)簽數(shù)據(jù)。
tag和image_tag只能使用一個。
image_tag
否
Object
新規(guī)范的鏡像標(biāo)簽列表。image_tag參數(shù)說明請參考鏡像標(biāo)簽數(shù)據(jù)格式。默認(rèn)為空。
tag和image_tag只能使用一個。
表1 image_tag數(shù)據(jù)結(jié)構(gòu)說明 參數(shù)
是否必選
參數(shù)類型
描述
key
是
String
標(biāo)簽的鍵。
value
是
String
標(biāo)簽的值。
請求示例
- 使用tags標(biāo)簽數(shù)據(jù)格式,增加或修改標(biāo)簽。
PUT https://{Endpoint}/v1/cloudimages/tags { "image_id": "62a15f6c-9197-44d2-89c7-708981c1bec1", "tag": "aaaa.1111" }
- 使用image_tag標(biāo)簽數(shù)據(jù)格式,增加或修改標(biāo)簽。
PUT https://{Endpoint}/v1/cloudimages/tags { "image_id": "67437ebd-2563-46e0-887e-ad1923977fa1", "image_tag": {"key":"key1","value":"value1"} }
