華為云計(jì)算 云知識 創(chuàng)建資源標(biāo)簽CreateResourceTager
創(chuàng)建資源標(biāo)簽CreateResourceTager

 

功能介紹

為特定類型的資源創(chuàng)建標(biāo)簽。

接口約束

  • 一個資源上最多有10個標(biāo)簽。

  • 此接口為冪等接口。

  • 創(chuàng)建時,如果創(chuàng)建的標(biāo)簽已經(jīng)存在(key相同),則覆蓋。

調(diào)試

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

URI

POST /v3/{project_id}/{resource_type}/{resource_id}/tags

表1 路徑參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

project_id

String

項(xiàng)目ID

resource_id

String

資源ID

resource_type

String

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

  • instance: 企業(yè)路由器 實(shí)例

  • route-table: 路由表

  • vpc-attachment: VPC連接

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

  • peering-attachment: 對等連接(Peering)連接

  • vpn -attachment: VPN網(wǎng)關(guān)連接

  • attachments: 所有連接類型

請求參數(shù)

表2 請求Body參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

tag

Tag object

資源標(biāo)簽

表3 Tag

參數(shù)

是否必選

參數(shù)類型

描述

key

String

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

最小長度:0

最大長度:128

value

String

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

最小長度:0

最大長度:128

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

請求示例

為企業(yè)路由器資源添加標(biāo)簽,標(biāo)簽值為key1,標(biāo)簽鍵為value1

POST https://{erouter-endpoint}/v3/cfa563efb77d4b6d9960781d82530fd8/instance/3320166e-b937-40cc-a35c-02cd3f2b3ee2/tags

{
  "tag" : {
    "key" : "key1",
    "value" : "value1"
  }
}

響應(yīng)示例

狀態(tài)碼

狀態(tài)碼

描述

204

Created

錯誤碼

請參見錯誤碼。