功能介紹
為指定保護實例批量添加或刪除標(biāo)簽。一個資源上最多有10個標(biāo)簽。 此接口為冪等接口： 創(chuàng)建時如果請求體中存在重復(fù)key則報錯。 創(chuàng)建時，不允許設(shè)置重復(fù)key數(shù)據(jù),如果 數(shù)據(jù)庫 已存在該key，就覆蓋value的值。
接口約束
無
調(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 |
保護實例的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)識，取值僅限于：create：創(chuàng)建 枚舉值：
|
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
key |
是 |
String |
鍵。同一資源的key值不能重復(fù)。最大長度為36個UNICODE字符。key不能為空，不允許為空字符串。不能包含以下字符：非打印字符ASCII(0-31)特殊字符“*”,“<”,“>”,“\”,“=”,“,”,“|”,“/”鍵。不能為空。對于同一資源鍵值唯一。 |
|
value |
是 |
String |
值。最大長度為43個UNICODE字符。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" : "create",
"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 |
錯誤碼
請參見錯誤碼。
