功能介紹
為指定Endpoint Service或Endpoint批量添加或刪除標(biāo)簽。 ● 一個(gè)資源上最多有10個(gè)標(biāo)簽。
調(diào)試
您可以在API Explorer中調(diào)試該接口,支持自動(dòng)認(rèn)證鑒權(quán)。API Explorer可以自動(dòng)生成SDK代碼示例,并提供SDK代碼示例調(diào)試功能。
URI
POST /v1/{project_id}/{resource_type}/{resource_id}/tags/action
表1 路徑參數(shù)
|
參數(shù)
|
是否必選
|
參數(shù)類型
|
描述
|
|
project_id
|
是
|
String
|
項(xiàng)目ID。
|
|
resource_type
|
是
|
String
|
資源類型,值為:endpoint_service或endpoint。
|
|
resource_id
|
是
|
String
|
資源ID,Endpoint ServiceID或Endpoint ID。
|
請求參數(shù)
表3 請求Body參數(shù)
|
參數(shù)
|
是否必選
|
參數(shù)類型
|
描述
|
|
tags
|
否
|
Array of resource_tag objects
|
標(biāo)簽列表,沒有標(biāo)簽?zāi)J(rèn)為空數(shù)組。
|
|
action
|
是
|
String
|
操作標(biāo)識:僅限于 create(創(chuàng)建) delete(刪除)
|
表4 resource_tag
|
參數(shù)
|
是否必選
|
參數(shù)類型
|
描述
|
|
key
|
是
|
String
|
鍵。最大長度36個(gè)unicode字符。 key需要滿足標(biāo)簽字符集規(guī)范。
|
|
value
|
否
|
String
|
值。action為create時(shí)必選,每個(gè)值最大長度43個(gè)unicode字符, 刪除時(shí)如果value有值按照key/value刪除, 如果value沒值,則按照key刪除。 value需要滿足標(biāo)簽字符集規(guī)范。
|
響應(yīng)參數(shù)
狀態(tài)碼: 400
表5 響應(yīng)Body參數(shù)
|
參數(shù)
|
參數(shù)類型
|
描述
|
|
error
|
Error object
|
提交任務(wù)異常時(shí)返回的異常信息
|
表6 Error
|
參數(shù)
|
參數(shù)類型
|
描述
|
|
message
|
String
|
任務(wù)異常錯(cuò)誤信息描述
|
|
code
|
String
|
任務(wù)異常錯(cuò)誤信息編碼
|
狀態(tài)碼: 401
表7 響應(yīng)Body參數(shù)
|
參數(shù)
|
參數(shù)類型
|
描述
|
|
error
|
Error object
|
提交任務(wù)異常時(shí)返回的異常信息
|
表8 Error
|
參數(shù)
|
參數(shù)類型
|
描述
|
|
message
|
String
|
任務(wù)異常錯(cuò)誤信息描述
|
|
code
|
String
|
任務(wù)異常錯(cuò)誤信息編碼
|
狀態(tài)碼: 403
表9 響應(yīng)Body參數(shù)
|
參數(shù)
|
參數(shù)類型
|
描述
|
|
error
|
Error object
|
提交任務(wù)異常時(shí)返回的異常信息
|
表10 Error
|
參數(shù)
|
參數(shù)類型
|
描述
|
|
message
|
String
|
任務(wù)異常錯(cuò)誤信息描述
|
|
code
|
String
|
任務(wù)異常錯(cuò)誤信息編碼
|
狀態(tài)碼: 404
表11 響應(yīng)Body參數(shù)
|
參數(shù)
|
參數(shù)類型
|
描述
|
|
error
|
Error object
|
提交任務(wù)異常時(shí)返回的異常信息
|
表12 Error
|
參數(shù)
|
參數(shù)類型
|
描述
|
|
message
|
String
|
任務(wù)異常錯(cuò)誤信息描述
|
|
code
|
String
|
任務(wù)異常錯(cuò)誤信息編碼
|
狀態(tài)碼: 405
表13 響應(yīng)Body參數(shù)
|
參數(shù)
|
參數(shù)類型
|
描述
|
|
error
|
Error object
|
提交任務(wù)異常時(shí)返回的異常信息
|
表14 Error
|
參數(shù)
|
參數(shù)類型
|
描述
|
|
message
|
String
|
任務(wù)異常錯(cuò)誤信息描述
|
|
code
|
String
|
任務(wù)異常錯(cuò)誤信息編碼
|
狀態(tài)碼: 406
表15 響應(yīng)Body參數(shù)
|
參數(shù)
|
參數(shù)類型
|
描述
|
|
error
|
Error object
|
提交任務(wù)異常時(shí)返回的異常信息
|
表16 Error
|
參數(shù)
|
參數(shù)類型
|
描述
|
|
message
|
String
|
任務(wù)異常錯(cuò)誤信息描述
|
|
code
|
String
|
任務(wù)異常錯(cuò)誤信息編碼
|
狀態(tài)碼: 407
表17 響應(yīng)Body參數(shù)
|
參數(shù)
|
參數(shù)類型
|
描述
|
|
error
|
Error object
|
提交任務(wù)異常時(shí)返回的異常信息
|
表18 Error
|
參數(shù)
|
參數(shù)類型
|
描述
|
|
message
|
String
|
任務(wù)異常錯(cuò)誤信息描述
|
|
code
|
String
|
任務(wù)異常錯(cuò)誤信息編碼
|
狀態(tài)碼: 408
表19 響應(yīng)Body參數(shù)
|
參數(shù)
|
參數(shù)類型
|
描述
|
|
error
|
Error object
|
提交任務(wù)異常時(shí)返回的異常信息
|
表20 Error
|
參數(shù)
|
參數(shù)類型
|
描述
|
|
message
|
String
|
任務(wù)異常錯(cuò)誤信息描述
|
|
code
|
String
|
任務(wù)異常錯(cuò)誤信息編碼
|
狀態(tài)碼: 409
表21 響應(yīng)Body參數(shù)
|
參數(shù)
|
參數(shù)類型
|
描述
|
|
error
|
Error object
|
提交任務(wù)異常時(shí)返回的異常信息
|
表22 Error
|
參數(shù)
|
參數(shù)類型
|
描述
|
|
message
|
String
|
任務(wù)異常錯(cuò)誤信息描述
|
|
code
|
String
|
任務(wù)異常錯(cuò)誤信息編碼
|
狀態(tài)碼: 500
表23 響應(yīng)Body參數(shù)
|
參數(shù)
|
參數(shù)類型
|
描述
|
|
error
|
Error object
|
提交任務(wù)異常時(shí)返回的異常信息
|
表24 Error
|
參數(shù)
|
參數(shù)類型
|
描述
|
|
message
|
String
|
任務(wù)異常錯(cuò)誤信息描述
|
|
code
|
String
|
任務(wù)異常錯(cuò)誤信息編碼
|
狀態(tài)碼: 501
表25 響應(yīng)Body參數(shù)
|
參數(shù)
|
參數(shù)類型
|
描述
|
|
error
|
Error object
|
提交任務(wù)異常時(shí)返回的異常信息
|
表26 Error
|
參數(shù)
|
參數(shù)類型
|
描述
|
|
message
|
String
|
任務(wù)異常錯(cuò)誤信息描述
|
|
code
|
String
|
任務(wù)異常錯(cuò)誤信息編碼
|
狀態(tài)碼: 502
表27 響應(yīng)Body參數(shù)
|
參數(shù)
|
參數(shù)類型
|
描述
|
|
error
|
Error object
|
提交任務(wù)異常時(shí)返回的異常信息
|
表28 Error
|
參數(shù)
|
參數(shù)類型
|
描述
|
|
message
|
String
|
任務(wù)異常錯(cuò)誤信息描述
|
|
code
|
String
|
任務(wù)異常錯(cuò)誤信息編碼
|
狀態(tài)碼: 503
表29 響應(yīng)Body參數(shù)
|
參數(shù)
|
參數(shù)類型
|
描述
|
|
error
|
Error object
|
提交任務(wù)異常時(shí)返回的異常信息
|
表30 Error
|
參數(shù)
|
參數(shù)類型
|
描述
|
|
message
|
String
|
任務(wù)異常錯(cuò)誤信息描述
|
|
code
|
String
|
任務(wù)異常錯(cuò)誤信息編碼
|
狀態(tài)碼: 504
表31 響應(yīng)Body參數(shù)
|
參數(shù)
|
參數(shù)類型
|
描述
|
|
error
|
Error object
|
提交任務(wù)異常時(shí)返回的異常信息
|
表32 Error
|
參數(shù)
|
參數(shù)類型
|
描述
|
|
message
|
String
|
任務(wù)異常錯(cuò)誤信息描述
|
|
code
|
String
|
任務(wù)異常錯(cuò)誤信息編碼
|
請求示例
-
批量添加資源標(biāo)簽
POST https://{endpoint}/v1/{project_id}/endpoint_service/{resource_id}/tags/action
{
"action" : "create",
"tags" : [ {
"key" : "key1",
"value" : "value1"
}, {
"key" : "key",
"value" : "value3"
} ]
}
-
批量刪除資源標(biāo)簽
POST https://{endpoint}/v1/{project_id}/endpoint/{resource_id}/tags/action
{
"action" : "delete",
"tags" : [ {
"key" : "key1"
}, {
"key" : "key2",
"value" : "value3"
} ]
}
狀態(tài)碼
|
狀態(tài)碼
|
描述
|
|
204
|
服務(wù)器已成功處理了請求
|
|
400
|
服務(wù)器未能處理請求
|
|
401
|
被請求的頁面需要用戶名和密碼
|
|
403
|
對被請求頁面的訪問被禁止
|
|
404
|
服務(wù)器無法找到被請求的頁面
|
|
405
|
請求中指定的方法不被允許
|
|
406
|
服務(wù)器生成的響應(yīng)無法被客戶端所接受
|
|
407
|
用戶必須首先使用代理服務(wù)器進(jìn)行驗(yàn)證,這樣請求才會(huì)被處理
|
|
408
|
請求超出了服務(wù)器的等待時(shí)間
|
|
409
|
由于沖突,請求無法被完成
|
|
500
|
請求未完成。服務(wù)異常
|
|
501
|
請求未完成。服務(wù)器不支持所請求的功能
|
|
502
|
請求未完成。服務(wù)器從上游服務(wù)器收到一個(gè)無效的響應(yīng)
|
|
503
|
請求未完成。系統(tǒng)暫時(shí)異常
|
|
504
|
網(wǎng)關(guān)超時(shí)
|