功能介紹
為指定保護(hù)實例批量刪除標(biāo)簽。一個資源上最多有10個標(biāo)簽。 此接口為冪等接口： 刪除時，如果刪除的標(biāo)簽不存在，默認(rèn)處理成功,刪除時不對標(biāo)簽字符集范圍做校驗。刪除時tags結(jié)構(gòu)體不能缺失，key不能為空，或者空字符串。
接口約束
無
調(diào)試
您可以在API Explorer中調(diào)試該接口。
URI
POST /v1/{project_id}/protected-instances/{protected_instance_id}/tags/action
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
項目ID。 |
|
protected_instance_id |
是 |
String |
保護(hù)實例的ID。 |
請求參數(shù)
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
用戶Token。通過調(diào)用 IAM 服務(wù)獲取用戶Token接口獲取（響應(yīng)消息頭中X-Subject-Token的值） |
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
tags |
是 |
標(biāo)簽列表。 |
|
|
action |
是 |
String |
操作標(biāo)識，取值僅限于：delete：刪除 枚舉值：
|
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
key |
是 |
String |
鍵。同一資源的key值不能重復(fù)。最大長度為36個UNICODE字符。key不能為空，不允許為空字符串。不能包含以下字符：非打印字符ASCII(0-31)特殊字符“*”,“<”,“>”,“\”,“=”,“,”,“|”,“/”鍵。不能為空。對于同一資源鍵值唯一。 |
|
value |
否 |
String |
值。最大長度為43個UNICODE字符。刪除時如果value有值按照key/value刪除，如果value沒值，則按照key刪除。當(dāng)value存在時，不能為空，可以為空字符串。不能包含以下字符：非打印字符ASCII(0-31)特殊字符“*”,“<”,“>”,“\”,“=”,“,”,“|”,“/”。長度不超過43個字符。 |
響應(yīng)參數(shù)
狀態(tài)碼： 400
狀態(tài)碼： 401
狀態(tài)碼： 403
狀態(tài)碼： 404
狀態(tài)碼： 500
請求示例
刪除標(biāo)簽
POST https://{Endpoint}/v1/{project_id}/protected-instances/67a2cc7e-fb87-41a8-ba28-9c032abcaee1/tags/action
{
"action" : "delete",
"tags" : [ {
"key" : "key1",
"value" : "value1"
}, {
"key" : "key",
"value" : "value3"
} ]
}
響應(yīng)示例
無
狀態(tài)碼
|
狀態(tài)碼 |
描述 |
|---|---|
|
204 |
No Content |
|
400 |
Bad Request |
|
401 |
Unauthorized |
|
403 |
Forbidden |
|
404 |
Not Found |
|
500 |
Internal Server Error |
錯誤碼
請參見錯誤碼。
