華為云計算 云知識 批量添加刪除存儲庫資源標(biāo)簽BatchCreateAndDeleteVaultTags
批量添加刪除存儲庫資源標(biāo)簽BatchCreateAndDeleteVaultTags

 

功能介紹

為指定實例批量添加或刪除標(biāo)簽 標(biāo)簽管理服務(wù)需要使用該接口批量管理實例的標(biāo)簽。 一個資源上最多有10個標(biāo)簽。 此接口為冪等接口: 創(chuàng)建時如果請求體中存在重復(fù)key則報錯。 創(chuàng)建時,不允許重復(fù)key,如果 數(shù)據(jù)庫 存在就覆蓋。 刪除時,允許重復(fù)key。 刪除時,如果刪除的標(biāo)簽不存在,默認處理成功,刪除時不對標(biāo)簽字符集范圍做校驗。key長度127個字符,value為255個字符。刪除時tags結(jié)構(gòu)體不能缺失,key不能為空,或者空字符串。

調(diào)試

您可以在API Explorer中調(diào)試該接口,支持自動認證鑒權(quán)。API Explorer可以自動生成SDK代碼示例,并提供SDK代碼示例調(diào)試功能。

URI

POST /v3/{project_id}/vault/{vault_id}/tags/action

表1 路徑參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

project_id

String

項目id

vault_id

String

資源id

請求參數(shù)

表2 請求Body參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

tags

Array of Tag objects

標(biāo)簽列表。

tags不允許為空列表。

tags中最多包含10個key。

tags中key不允許重復(fù)。

sys_tags

Array of SysTag objects

系統(tǒng)標(biāo)簽列表。

op_service權(quán)限可以訪問,和tags二選一。

目前TMS調(diào)用時只包含一個resource_tag結(jié)構(gòu)體 ,key固定為:_sys_enterprise_project_id。

value是UUID或0,value為0表示默認企業(yè)項目。

現(xiàn)在僅支持create操作。

action

String

操作標(biāo)識:僅限于create(創(chuàng)建)、delete(刪除)

枚舉值:

  • create

  • delete

表3 Tag

參數(shù)

是否必選

參數(shù)類型

描述

key

String

鍵。

key最大長度為36個字符。

key不能為空字符串。

key前后空格會被丟棄。

key不能包含非打印字符ASCII(0-31),“=”,“*”,“<”,“>”,“\”,“,”,“|”,“/”。

key只能由中文,字母,數(shù)字,“-”,“_”組成。

value

String

值。

添加標(biāo)簽時value值必選,刪除標(biāo)簽時value值可選。

value最大長度為43個字符。

value可以為空字符串。

value前后的空格會被丟棄。

value不能包含非打印字符ASCII(0-31),“=”,“*”,“<”,“>”,“\”,“,”,“|”,“/”。

value只能由中文,字母,數(shù)字,“-”,“_”,“.”組成。

表4 SysTag

參數(shù)

是否必選

參數(shù)類型

描述

key

String

鍵。 系統(tǒng)標(biāo)簽的key,從白名單中取,不能隨意定義。 目前僅支持 _sys_enterprise_project_id字段,對應(yīng) 的value為企業(yè)項目ID。

value

String

值。 目前僅會用到企業(yè)項目ID,其中默認的企業(yè)項目ID為“0”。

響應(yīng)參數(shù)

狀態(tài)碼: 400

表5 響應(yīng)Body參數(shù)

參數(shù)

參數(shù)類型

描述

error_code

String

請參見錯誤碼

error_msg

String

錯誤信息

請求示例

批量創(chuàng)建tag

POST  https://{endpoint}/v3/{project_id}/vault/{vault_id}/tags/action

{
  "tags" : [ {
    "key" : "string",
    "value" : "string"
  }, {
    "key" : "string1",
    "value" : "string2"
  } ],
  "action" : "create"
}

響應(yīng)示例

狀態(tài)碼

狀態(tài)碼

描述

204

No Content

400

Bad Request

錯誤碼

請參見錯誤碼。