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

 

功能介紹

給指定子網(wǎng)資源實(shí)例增加標(biāo)簽信息。

調(diào)試

您可以在API Explorer中調(diào)試該接口。

URI

POST /v2.0/{project_id}/subnets/{subnet_id}/tags

參數(shù)說(shuō)明請(qǐng)參見(jiàn)表1。

表1 參數(shù)說(shuō)明

名稱

是否必選

說(shuō)明

project_id

項(xiàng)目ID,請(qǐng)參見(jiàn)獲取項(xiàng)目ID。

subnet_id

子網(wǎng)唯一標(biāo)識(shí)

如果您使用管理控制臺(tái),此值即為子網(wǎng)詳情中的“網(wǎng)絡(luò)ID”參數(shù)值。

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

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

參數(shù)名稱

類型

是否必選

說(shuō)明

tag

tag object

tag對(duì)象,請(qǐng)參見(jiàn)表3。

表3 tag對(duì)象

屬性

類型

是否必選

說(shuō)明

key

String

  • 標(biāo)簽名稱
  • 不能為空。
  • 長(zhǎng)度不超過(guò)128個(gè)字符(當(dāng)前控制臺(tái)操作key長(zhǎng)度不超過(guò)36個(gè)字符)。
  • 由英文字母、數(shù)字、下劃線、中劃線、中文字符組成。
  • 同一資源的key值不能重復(fù)。

value

String

  • 標(biāo)簽值
  • 長(zhǎng)度不超過(guò)255個(gè)字符(當(dāng)前控制臺(tái)操作value長(zhǎng)度不超過(guò)43個(gè)字符)。
  • 由英文字母、數(shù)字、下劃線、點(diǎn)、中劃線、中文字符組成。

請(qǐng)求示例

  • 創(chuàng)建一條子網(wǎng)資源標(biāo)簽,key為key1,value為value1。
POST https://{Endpoint}/v2.0/{project_id}/subnets/{subnet_id}/tags

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

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

無(wú)

響應(yīng)示例

無(wú)

狀態(tài)碼

請(qǐng)參見(jiàn)狀態(tài)碼。

錯(cuò)誤碼

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