華為云計(jì)算 云知識 批量添加云服務(wù)器標(biāo)簽BatchCreateServerTags
批量添加云服務(wù)器標(biāo)簽BatchCreateServerTags

 

功能介紹

  • 為指定 云服務(wù)器 批量添加標(biāo)簽。
  • 標(biāo)簽管理服務(wù)TMS使用該接口批量管理云服務(wù)器的標(biāo)簽。

接口約束

  • 每個(gè)云服務(wù)器最多10個(gè)標(biāo)簽。
  • 此接口為冪等接口:

    創(chuàng)建時(shí),如果創(chuàng)建的標(biāo)簽已經(jīng)存在(key/value均相同視為重復(fù)),默認(rèn)處理成功。

  • key相同,value不同時(shí)會(huì)覆蓋原有標(biāo)簽。
  • 該接口支持企業(yè)項(xiàng)目細(xì)粒度權(quán)限的校驗(yàn),具體細(xì)粒度請參見 ecs:cloudServers:batchSetServerTags

調(diào)試

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

URI

POST /v1/{project_id}/cloudservers/{server_id}/tags/action

參數(shù)說明請參見表1。
表1 參數(shù)說明

參數(shù)

是否必選

描述

project_id

項(xiàng)目ID。

獲取方法請參見獲取項(xiàng)目ID。

server_id

云服務(wù)器ID。

請求消息

請求參數(shù)如表2所示。

表2 請求參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

tags

Array of objects

標(biāo)簽列表,詳情參見表3

action

String

操作標(biāo)識(僅支持小寫):create(創(chuàng)建)

表3 tags 字段數(shù)據(jù)結(jié)構(gòu)說明

參數(shù)

是否必選

參數(shù)類型

描述

key

String

鍵。

  • 不能為空。
  • 對于同一資源鍵值唯一。
  • 長度不超過36個(gè)字符。
  • 標(biāo)簽的鍵必須唯一且輸入不能為空。

value

String

值。

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

響應(yīng)消息

請求示例

批量添加2組標(biāo)簽到指定云服務(wù)器。

POST  https://{endpoint}/v1/{project_id}/cloudservers/{server_id}/tags/action

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

響應(yīng)示例

返回值

請參考通用請求返回值

錯(cuò)誤碼

請參考錯(cuò)誤碼。