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

 

功能介紹

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

接口約束

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

調試

您可以在API Explorer中調試該接口,支持自動認證鑒權。API Explorer可以自動生成SDK代碼示例,并提供SDK代碼示例調試功能。

URI

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

表1 路徑參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

project_id

String

項目ID,獲取項目ID請參見獲取項目ID

publicip_id

String

資源ID

請求參數(shù)

表2 請求Body參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

tags

Array of ResourceTagOption objects

  • 功能說明:標簽列表

action

String

  • 功能說明:操作標識

    • create:創(chuàng)建

    • delete: 刪除

  • 約束:action為create時,tag的value必選

枚舉值:

  • create

  • delete

表3 ResourceTagOption

參數(shù)

是否必選

參數(shù)類型

描述

key

String

  • 功能說明:標簽名稱

  • 約束:

    • 不能為空。

    • 長度不超過36個字符。

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

    • 同一資源的key值不能重復。

最大長度:36

value

String

  • 功能說明:標簽值

  • 約束:

    • 長度不超過43個字符。

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

    • 同一資源的key值不能重復。

最大長度:43

響應參數(shù)

請求示例

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

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

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

響應示例

狀態(tài)碼

狀態(tài)碼

描述

204

No Content

錯誤碼

請參見錯誤碼。