華為云計(jì)算 云知識(shí) 批量刪除專屬主機(jī)標(biāo)簽BatchDeleteDedicatedHostTags
批量刪除專屬主機(jī)標(biāo)簽BatchDeleteDedicatedHostTags

 

功能介紹

  • 標(biāo)簽管理服務(wù)(TMS)使用該接口批量刪除專屬主機(jī)的標(biāo)簽。

約束

每個(gè)專屬主機(jī)最多10個(gè)標(biāo)簽。

調(diào)試

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

URI

POST /v1.0/{project_id}/dedicated-host-tags/{dedicated_host_id}/tags/action

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

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

參數(shù)

參數(shù)類型

是否必選

描述

project_id

String

項(xiàng)目ID。

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

dedicated_host_id

String

專屬主機(jī)ID。

可以從專屬主機(jī)控制臺(tái)查詢,或者通過(guò)調(diào)用查詢專屬主機(jī)列表API獲取。

請(qǐng)求消息

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

參數(shù)

參數(shù)類型

是否必選

描述

tags

Array of objects

標(biāo)簽列表。

詳情見(jiàn)表3。

action

String

操作標(biāo)識(shí)(僅支持小寫):delete(刪除)。

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

參數(shù)

參數(shù)類型

是否必選

描述

key

String

鍵。

  • 長(zhǎng)度不超過(guò)36個(gè)Unicode字符。
  • 不能為空。
  • 不能包含以下ASCII非打印字符:“=”,“*”,“<”,“>”,“\”,“|”,“/”,“,”。

value

String

值。

  • 長(zhǎng)度不超過(guò)43個(gè)Unicode字符。
  • 不能包含以下ASCII非打印字符:“=”,“*”,“<”,“>”,“\”,“|”,“/”,“,”。

響應(yīng)消息

不涉及。

請(qǐng)求示例

批量刪除專屬主機(jī)標(biāo)簽,鍵為key1對(duì)應(yīng)的值為value1,鍵為key2對(duì)應(yīng)的值為value2。
POST https://{Endpoint}/v1.0/9c53a566cb3443ab910cf0daebca90c4/dedicated-host-tags/74259164-e63a-4ad9-9c77-a1bd2c9aa187/tags/action
{
    "action": "delete",
    "tags": [
        {
            "key": "key1",
            "value": "value1"
        },
        {
            "key": "key2",
            "value": "value2"
        }
    ]
}

響應(yīng)示例

不涉及。

返回值

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