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

 

功能介紹

  • 為指定實(shí)例批量添加或刪除標(biāo)簽
  • 標(biāo)簽管理服務(wù)需要使用該接口批量管理實(shí)例的標(biāo)簽。
  • 一個(gè)資源上最多有10個(gè)標(biāo)簽。
  • 當(dāng)前API支持華北-北京四、西南-貴陽(yáng)一、華南-廣州、中國(guó)-香港、亞太-曼谷、非洲-約翰內(nèi)斯堡、華北-烏蘭察布一、亞太-新加坡、拉美-圣保羅一區(qū)域。

調(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ù)類(lèi)型

描述

project_id

String

項(xiàng)目ID

resource_id

String

資源ID

resource_type

String

標(biāo)簽資源類(lèi)型:

  • instance: 企業(yè)路由器 實(shí)例
  • route-table: 路由表
  • vpc-attachment: VPC連接
  • vgw-attachment: 虛擬網(wǎng)關(guān)連接
  • peering-attachment: 對(duì)等連接(Peering)連接
  • vpn -attachment: VPN網(wǎng)關(guān)連接
  • attachments: 所有連接類(lèi)型

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

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

參數(shù)

是否必選

參數(shù)類(lèi)型

描述

action

String

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

tags

Array of Tag objects

標(biāo)簽列表。

表3 Tag

參數(shù)

是否必選

參數(shù)類(lèi)型

描述

key

String

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

最小長(zhǎng)度:0

最大長(zhǎng)度:128

value

String

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

最小長(zhǎng)度:0

最大長(zhǎng)度:128

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

無(wú)

請(qǐng)求示例

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

響應(yīng)示例

無(wú)

狀態(tài)碼

狀態(tài)碼

描述

204

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

錯(cuò)誤碼

請(qǐng)參見(jiàn)錯(cuò)誤碼。