華為云計算 云知識 批量刪除云服務(wù)器標簽BatchDeleteServerTags
批量刪除云服務(wù)器標簽BatchDeleteServerTags

 

功能介紹

  • 為指定 云服務(wù)器 批量刪除標簽。
  • 標簽管理服務(wù)TMS使用該接口批量管理云服務(wù)器的標簽。
  • 此接口為冪等接口:刪除時,如果刪除的標簽不存在,默認處理成功。

接口約束

每個云服務(wù)器最多10個標簽。

該接口支持企業(yè)項目細粒度權(quán)限的校驗,具體細粒度請參見 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

項目ID。

獲取方法請參見獲取項目ID

server_id

云服務(wù)器ID。

請求消息

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

表2 請求參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

tags

Array of objects

標簽列表,詳情參見表3

action

String

操作標識(僅支持小寫):delete(刪除)

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

參數(shù)

是否必選

參數(shù)類型

描述

key

String

鍵。

最大長度127個Unicode字符,不能為空。

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

value

String

值。

每個值最大長度255個Unicode字符,可以為空字符串。

響應(yīng)消息

請求示例

批量刪除指定云服務(wù)器的2組標簽。

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

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

響應(yīng)示例

返回值

請參考通用請求返回值。

錯誤碼

請參考錯誤碼。