# 批量添加专属主机标签 - BatchCreateDedicatedHostTags
#### 功能介绍
- 为指定专属主机批量添加标签。

- 标签管理服务（TMS）使用该接口批量添加专属主机的标签。
 
#### 约束
- 每个专属主机最多20个标签。
- 此接口为幂等接口： 创建时，如果创建的标签已经存在（key/value均相同视为重复），默认处理成功。
  
- key相同，value不同时会覆盖原有标签。
 
#### 调试
您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=DeH&api=BatchCreateDedicatedHostTags)中调试该接口。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-deh/deh_08_0001.html)。
#### URI
POST /v1.0/{project_id}/dedicated-host-tags/{dedicated_host_id}/tags/action
参数说明请参见[表1]。
 表1参数说明 
| 参数                | 参数类型   | 是否必选 | 描述                                                                                                                                                       |
|:---|:---|:---|:---|
| project_id        | String | 是    | 项目ID。 获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-deh/deh_02_0010.html)。                                            |
| dedicated_host_id | String | 是    | 专属主机ID。 可以从专属主机控制台查询，或者通过调用[查询专属主机列表 - ListDedicatedHosts](https://support.huaweicloud.com/api-deh/deh_02_0020.html)API获取。 |
   
#### 请求消息
表2请求参数 
| 参数     | 参数类型             | 是否必选 | 描述                                                |
|:---|:---|:---|:---|
| tags   | Array of objects | 是    | 标签列表。详情见[表3]。 |
| action | String           | 是    | 操作标识（仅支持小写）：create（创建）。                           |
   
 表3tag字段数据结构说明 
| 参数    | 参数类型   | 是否必选 | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                       |
|:---|:---|:---|:---|
| 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"
        }
    ]
}
```
#### 响应示例
不涉及。
#### 返回值
请参见[状态码](https://support.huaweicloud.com/api-deh/deh_02_0016.html)。