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

 

功能介紹

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

接口約束

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

  • 此接口為冪等接口。

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

調(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

表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: 對(duì)等連接(Peering)連接

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

  • attachments: 所有連接類型

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

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

參數(shù)

是否必選

參數(shù)類型

描述

tag

Tag object

資源標(biāo)簽

表3 Tag

參數(shù)

是否必選

參數(shù)類型

描述

key

String

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

最小長(zhǎng)度:0

最大長(zhǎng)度:128

value

String

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

最小長(zhǎng)度:0

最大長(zhǎng)度:128

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

無(wú)

請(qǐng)求示例

為企業(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)示例

無(wú)

狀態(tài)碼

狀態(tài)碼

描述

204

Created

錯(cuò)誤碼

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