功能介紹
為指定的VPC資源實(shí)例批量添加或刪除標(biāo)簽。
此接口為冪等接口：
創(chuàng)建時(shí)如果請(qǐng)求體中存在重復(fù)key則報(bào)錯(cuò)。
創(chuàng)建時(shí)，不允許設(shè)置重復(fù)key數(shù)據(jù)，如果 數(shù)據(jù)庫(kù) 已存在該key，就覆蓋value的值。
刪除時(shí)，如果刪除的標(biāo)簽不存在，默認(rèn)處理成功，刪除時(shí)不對(duì)標(biāo)簽字符集范圍做校驗(yàn)。刪除時(shí)tags結(jié)構(gòu)體不能缺失，key不能為空，或者空字符串。
調(diào)試
您可以在API Explorer中調(diào)試該接口。
URI
POST /v2.0/{project_id}/vpcs/{vpc_id}/tags/action
參數(shù)說(shuō)明請(qǐng)參見(jiàn)表1。
|
名稱(chēng) |
是否必選 |
說(shuō)明 |
|---|---|---|
|
project_id |
是 |
項(xiàng)目ID，請(qǐng)參見(jiàn)獲取項(xiàng)目ID。 |
|
vpc_id |
是 |
虛擬私有云 唯一標(biāo)識(shí) |
請(qǐng)求參數(shù)
|
參數(shù)名稱(chēng) |
類(lèi)型 |
是否必選 |
說(shuō)明 |
|---|---|---|---|
|
tags |
是 |
||
|
action |
String |
是 |
操作標(biāo)識(shí)：
|
|
屬性 |
類(lèi)型 |
是否必選 |
說(shuō)明 |
|---|---|---|---|
|
key |
String |
是 |
|
|
value |
String |
是 |
|
請(qǐng)求示例
- 批量創(chuàng)建兩條VPC資源標(biāo)簽，action為create。
POST https://{Endpoint}/v2.0/{project_id}/vpcs/{vpc_id}/tags/action { "action": "create", "tags": [ { "key": "key1", "value": "value1" }, { "key": "key2", "value": "value3" } ] } - 批量刪除兩條VPC資源標(biāo)簽，action為delete。
POST https://{Endpoint}/v2.0/{project_id}/vpcs/{vpc_id}/tags/action { "action": "delete", "tags": [ { "key": "key1", "value": "value1" }, { "key": "key2", "value": "value3" } ] }
響應(yīng)參數(shù)
無(wú)
響應(yīng)示例
無(wú)
狀態(tài)碼
請(qǐng)參見(jiàn)狀態(tài)碼。
錯(cuò)誤碼
請(qǐng)參考錯(cuò)誤碼。
猜你喜歡
