功能介紹
為指定的子網(wǎng)資源實例批量添加或刪除標簽。
此接口為冪等接口：
創(chuàng)建時如果請求體中存在重復key則報錯。
創(chuàng)建時，不允許設置重復key數(shù)據(jù)，如果 數(shù)據(jù)庫 已存在該key，就覆蓋value的值。
刪除時，如果刪除的標簽不存在，默認處理成功，刪除時不對標簽字符集范圍做校驗。刪除時tags結(jié)構(gòu)體不能缺失，key不能為空，或者空字符串。
調(diào)試
您可以在API Explorer中調(diào)試該接口。
URI
POST /v2.0/{project_id}/subnets/{subnet_id}/tags/action
|
名稱 |
是否必選 |
說明 |
|---|---|---|
|
project_id |
是 |
項目ID，請參見獲取項目ID。 |
|
subnet_id |
是 |
子網(wǎng)唯一標識 如果您使用管理控制臺，此值即為子網(wǎng)詳情中的“網(wǎng)絡ID”參數(shù)值。 |
請求參數(shù)
|
參數(shù)名稱 |
類型 |
是否必選 |
說明 |
|---|---|---|---|
|
tags |
是 |
||
|
action |
String |
是 |
操作標識：
|
請求示例
- 批量創(chuàng)建兩條子網(wǎng)資源標簽，action為create。
POST https://{Endpoint}/v2.0/{project_id}/subnets/{subnet_id}/tags/action { "action": "create", "tags": [ { "key": "key1", "value": "value1" }, { "key": "key2", "value": "value3" } ] }
- 批量刪除兩條子網(wǎng)資源標簽，action為delete。
POST https://{Endpoint}/v2.0/{project_id}/subnets/{subnet_id}/tags/action { "action": "delete", "tags": [ { "key": "key1", "value": "value1" }, { "key": "key2", "value": "value3" } ] }
響應參數(shù)
無
響應示例
無
狀態(tài)碼
請參見狀態(tài)碼。
錯誤碼
請參考錯誤碼。
猜你喜歡
