華為云計(jì)算 云知識 批量創(chuàng)建彈性公網(wǎng)IP資源標(biāo)簽BatchCreatePublicipTags
批量創(chuàng)建彈性公網(wǎng)IP資源標(biāo)簽BatchCreatePublicipTags

 

功能介紹

為指定的 彈性公網(wǎng)IP 資源實(shí)例批量添加標(biāo)簽,每個(gè)彈性 公網(wǎng)IP 資源實(shí)例最多同時(shí)添加10個(gè)標(biāo)簽。 此接口為冪等接口: 創(chuàng)建時(shí)如果請求體中存在重復(fù)key則報(bào)錯(cuò)。 創(chuàng)建時(shí),不允許設(shè)置重復(fù)key數(shù)據(jù),如果 數(shù)據(jù)庫 已存在該key,就覆蓋value的值。

接口約束

此接口為冪等接口: 創(chuàng)建時(shí)如果請求體中存在重復(fù)key則報(bào)錯(cuò)。 創(chuàng)建時(shí)不允許設(shè)置重復(fù)key數(shù)據(jù),如果數(shù)據(jù)庫已存在該key,就覆蓋value的值。

調(diào)試

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

URI

POST /v2.0/{project_id}/publicips/{publicip_id}/tags/action

表1 路徑參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

project_id

String

項(xiàng)目ID,獲取項(xiàng)目ID請參見獲取項(xiàng)目ID

publicip_id

String

資源ID

請求參數(shù)

表2 請求Body參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

tags

Array of ResourceTagOption objects

  • 功能說明:標(biāo)簽列表

action

String

  • 功能說明:操作標(biāo)識

    • create:創(chuàng)建

    • delete: 刪除

  • 約束:action為create時(shí),tag的value必選

枚舉值:

  • create

  • delete

表3 ResourceTagOption

參數(shù)

是否必選

參數(shù)類型

描述

key

String

  • 功能說明:標(biāo)簽名稱

  • 約束:

    • 不能為空。

    • 長度不超過36個(gè)字符。

    • 由英文字母、數(shù)字、下劃線、中劃線、中文字符組成

    • 同一資源的key值不能重復(fù)。

最大長度:36

value

String

  • 功能說明:標(biāo)簽值

  • 約束:

    • 長度不超過43個(gè)字符。

    • 由英文字母、數(shù)字、下劃線、中劃線、中文字符組成

    • 同一資源的key值不能重復(fù)。

最大長度:43

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

請求示例

批量創(chuàng)建標(biāo)簽。

POST https://{Endpoint}/v2.0/{project_id}/publicips/{publicip_id}/tags/action

{
  "action" : "create",
  "tags" : [ {
    "key" : "key1",
    "value" : "value1"
  }, {
    "key" : "key2",
    "value" : "value2"
  } ]
}

響應(yīng)示例

狀態(tài)碼

狀態(tài)碼

描述

204

No Content

錯(cuò)誤碼

請參見錯(cuò)誤碼。