华为云计算 云知识 批量添加专属主机标签BatchCreateDedicatedHostTags
批量添加专属主机标签BatchCreateDedicatedHostTags

 

功能介绍

  • 标签管理服务(TMS)使用该接口批量添加专属主机的标签。

约束

  • 每个专属主机最多10个标签。
  • 此接口为幂等接口:

    创建时,如果创建的标签已经存在(key/value均相同视为重复),默认处理成功。

  • key相同,value不同时会覆盖原有标签。

调试

您可以在API Explorer中调试该接口。

URI

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

参数说明请参见表1。

表1 参数说明

参数

参数类型

是否必选

描述

project_id

String

项目ID。

获取方式请参见获取项目ID

dedicated_host_id

String

专属主机ID。

可以从专属主机控制台查询,或者通过调用查询专属主机列表API获取。

请求消息

表2 请求参数

参数

参数类型

是否必选

描述

tags

Array of objects

标签列表。详情见表3。

action

String

操作标识(仅支持小写):create(创建)。

表3 tag字段数据结构说明

参数

参数类型

是否必选

描述

key

String

键。

  • 长度不超过36个Unicode字符。
  • 不能为空。
  • 不能包含以下ASCII非打印字符:“=”,“*”,“<”,“>”,“\”,“|”,“/”,“,”。

value

String

值。

  • 长度不超过43个Unicode字符。
  • 不能包含以下ASCII非打印字符:“=”,“*”,“<”,“>”,“\”,“|”,“/”,“,”。

响应消息

不涉及。

请求示例

批量添加专属主机标签,键为key1对应的值为value1,键为key2对应的值为value2。
POST https://{Endpoint}/v1.0/9c53a566cb3443ab910cf0daebca90c4/dedicated-host-tags/74259164-e63a-4ad9-9c77-a1bd2c9aa187/tags/action
{
    "action": "create",
    "tags": [
        {
            "key": "key1",
            "value": "value1"
        },
        {
            "key": "key2",
            "value": "value2"
        }
    ]
}

响应示例

不涉及。

返回值

请参见状态码

上一篇:云日志服务有什么功能 下一篇:查询对等连接ShowVpcPeering

专属主机 DeH

专属主机(Dedicated Host )是指其上创建云服务器的所有资源完全供您专用的物理服务器,满足您对计算的隔离和性能的要求,并支持自带软件许可功能

购买灵活,多种配置可选