功能介紹
- 為指定 云服務(wù)器 批量添加標(biāo)簽。
- 標(biāo)簽管理服務(wù)TMS使用該接口批量管理云服務(wù)器的標(biāo)簽。
接口約束
- 每個(gè)云服務(wù)器最多10個(gè)標(biāo)簽。
- 此接口為冪等接口:
創(chuàng)建時(shí),如果創(chuàng)建的標(biāo)簽已經(jīng)存在(key/value均相同視為重復(fù)),默認(rèn)處理成功。
- key相同,value不同時(shí)會(huì)覆蓋原有標(biāo)簽。
- 該接口支持企業(yè)項(xiàng)目細(xì)粒度權(quán)限的校驗(yàn),具體細(xì)粒度請參見 ecs:cloudServers:batchSetServerTags
調(diào)試
您可以在API Explorer中調(diào)試該接口。
URI
POST /v1/{project_id}/cloudservers/{server_id}/tags/action
參數(shù) |
是否必選 |
描述 |
---|---|---|
project_id |
是 |
項(xiàng)目ID。 獲取方法請參見獲取項(xiàng)目ID。 |
server_id |
是 |
云服務(wù)器ID。 |
請求消息
響應(yīng)消息
無
請求示例
批量添加2組標(biāo)簽到指定云服務(wù)器。
POST https://{endpoint}/v1/{project_id}/cloudservers/{server_id}/tags/action { "action": "create", "tags": [ { "key": "key1", "value": "value1" }, { "key": "key2", "value": "value3" } ] }
響應(yīng)示例
無
返回值
請參考通用請求返回值。
錯(cuò)誤碼
請參考錯(cuò)誤碼。