# 查询裸金属服务器标签 - ShowBaremetalServerTags
#### 功能介绍
- 查询指定裸金属服务器的标签信息。
- TMS使用该接口查询指定裸金属服务器的全部标签数据。
 
#### 调试
您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/BMS/doc?api=ShowBaremetalServerTags)中调试该接口。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-bms/bms_api_0900.html)。
- 如果使用身份策略授权，需具备如下身份策略权限。
  
  | 授权项                                 | 访问级别 | 资源类型（\*为必须） | 条件键                                                                                                                                                                                                           | 别名              | 依赖的授权项 |
  |:---|:---|:---|:---|:---|:---|
  | bms:servers:showBaremetalServerTags | read | instance\*  | - g:EnterpriseProjectId  - g:ResourceTag/\<tag-key\>   | bms:servers:get | -      |
     
  
 
#### URI
GET /v1/{project_id}/baremetalservers/{server_id}/tags
参数说明请参见[表1]。
 表1参数说明 
| 参数         | 参数类型   | 是否必选 | 描述        |
|:---|:---|:---|:---|
| project_id | String | 是    | 项目ID。     |
| server_id  | String | 是    | 裸金属服务器ID。 |
   
#### 请求示例
无
#### 响应参数
| 参数   | 参数类型                 | 描述                                                                                  |
|:---|:---|:---|
| tags | List\<resource_tag\> | 标签列表，详见[表 tags字段数据结构说明]。 |
   
 表2tags字段数据结构说明 
| 参数    | 参数类型   | 描述   |
|:---|:---|:---|
| key   | String | 标签键。 |
| value | String | 标签值。 |
   
#### 响应示例
```
{
    "tags": [
        {
            "key": "key1",
            "value": "value1"
        },
        {
            "key": "key2",
            "value": "value3"
        }
    ]
}
```
#### 返回值
- 正常
  
  | 返回值 | 说明 |
  |:---|:---|
  | 200 | OK |
     
  

- 异常
  
  | 返回值 | 说明      |
  |:---|:---|
  | 400 | 标签等参数非法 |
  | 401 | 鉴权失败    |
  | 403 | 权限不足    |
  | 404 | 资源未找到   |
  | 500 | 系统异常    |