華為云計(jì)算 云知識(shí) 批量添加刪除資源標(biāo)簽BatchCreateResourceTags
批量添加刪除資源標(biāo)簽BatchCreateResourceTags

 

功能介紹

  • 為指定實(shí)例批量添加或刪除標(biāo)簽

  • 標(biāo)簽管理服務(wù)需要使用該接口批量管理實(shí)例的標(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 /v3/{project_id}/{resource_type}/{resource_id}/tags/action

表1 路徑參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

project_id

String

租戶項(xiàng)目ID

resource_id

String

資源實(shí)例ID

resource_type

String

  • 專線服務(wù)資源類型,包括dc-directconnect/dc-vgw/dc-vif

  • dc-directconnect: 專線物理連接

  • dc-vgw: 虛擬網(wǎng)關(guān)

  • dc-vif: 虛擬接口

枚舉值:

  • dc-directconnect

  • dc-vgw

  • dc-vif

請(qǐng)求參數(shù)

表2 請(qǐng)求Body參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

action

String

功能說明:操作標(biāo)識(shí)。 取值范圍: create(創(chuàng)建) delete(刪除)

枚舉值:

  • create

  • delete

tags

Array of Tag objects

標(biāo)簽列表。

sys_tags

Array of Tag objects

標(biāo)簽列表。

表3 Tag

參數(shù)

是否必選

參數(shù)類型

描述

key

String

標(biāo)簽鍵,最大長度36個(gè)unicode字符,格式為大小寫字母,數(shù)字,中劃線“-”,下劃線“_”,中文。

最小長度:0

最大長度:36

value

String

標(biāo)簽值,最大長度43個(gè)unicode字符,格式為大小寫字母,數(shù)字,中劃線“-”,下劃線“_”,點(diǎn)“.”,中文。

最小長度:0

最大長度:43

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

請(qǐng)求示例

  • 批量添加資源標(biāo)簽。

    POST https://{endpoint}/v3/cfa563efb77d4b6d9960781d82530fd8/dc-vgw/3320166e-b937-40cc-a35c-02cd3f2b3ee2/
    tags/action { "action" : "create", "tags" : [ { "key" : "key1", "value" : "value1" }, { "key" : "key2", "value" : "value2" } ] }
  • 批量刪除資源標(biāo)簽。

    POST https://{endpoint}/v3/cfa563efb77d4b6d9960781d82530fd8/dc-vgw/3320166e-b937-40cc-a35c-02cd3f2b3ee2/
    tags/action { "action" : "delete", "tags" : [ { "key" : "key1" }, { "key" : "key2", "value" : "value3" } ] }

響應(yīng)示例

狀態(tài)碼

狀態(tài)碼

描述

204

批量添加或刪除操作成功。

錯(cuò)誤碼

請(qǐng)參見錯(cuò)誤碼