# 为裸金属服务器添加标签（废弃）
#### 功能介绍
为裸金属服务器添加标签。
需在客户端通过以下HTTP header指定微版本号：X-OpenStack-Nova-API-Version: 2.26。
当前API已废弃，请使用"[批量添加裸金属服务器标签 - BatchCreateBaremetalServerTags](https://support.huaweicloud.com/api-bms/bms_api_0642.html)"。
#### 约束
标签个数不超过50个。
![](https://support.huaweicloud.com/api-bms/public_sys-resources/note_3.0-zh-cn.png)
- 建议为裸金属服务器添加"__type_baremetal"标签，标识是一台裸金属服务器。否则，裸金属服务器将仅在ECS控制台可见，而不在BMS控制台。
- 新增标签时，会覆盖原有标签。如需保留原有标签，请在添加时，将原有标签加入到新增标签的列表中。建议每次添加标签时，将"__type_baremetal"放在请求新增的tags列表中。
 
#### URI
PUT /v2.1/{project_id}/servers/{server_id}/tags
参数说明请参见[表1]。
 表1参数说明 
| 参数         | 是否必选 | 描述                                                                                                                                                             |
|:---|:---|:---|
| project_id | 是    | 项目ID。 获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-bms/bms_api_appendix_03.html)。                                         |
| server_id  | 是    | 裸金属服务器ID。 可以从裸金属服务器控制台查询，或者通过调用[查询裸金属服务器详情列表 - ListBareMetalServers](https://support.huaweicloud.com/api-bms/bms_api_0609.html)获取。 |
   
#### 请求参数
| 参数         | 是否必选 | 参数类型                   | 描述                                                                                                                                                                                                                                                                                                                                          |
|:---|:---|:---|:---|
| tags | 是    | Array of strings | - 标签列表，每个标签不超过80个字符。  - 标签不能以"."开头。  - 标签个数不超过50个。  - 不支持创建空标签（空串）。   |
   
#### 请求示例
为ID为53206ed0-56de-4d6b-b7ee-ffc62ca26f43的裸金属服务器增加标签baz、foo和qux。
```
PUT https://{ECS Endpoint}/v2.1/bbf1946d374b44a0a2a95533562ba954/servers/53206ed0-56de-4d6b-b7ee-ffc62ca26f43/tags
```
```
{
    "tags": [
        "baz",
        "foo",
        "qux"
    ]
}
```
#### 响应参数
| 参数   | 参数类型            | 描述         |
|:---|:---|:---|
| tags | Array of strings | 用户自定义标签列表。 |
   
#### 响应示例
```
{
    "tags": [
        "baz",
        "foo",
        "qux"
    ]
}
```
#### 返回值
正常返回值：
| 返回值 | 说明              |
|:---|:---|
| 200 | 服务器已成功处理了请求。 |
   
其他返回值请参考[状态码](https://support.huaweicloud.com/api-bms/bms_api_0801.html)。
#### 错误码
请参考[错误码](https://support.huaweicloud.com/api-bms/bms_api_0802.html)。