# 裸金属服务器挂载云硬盘（废弃）
#### 功能介绍
为裸金属服务器挂载云硬盘。
当前API已废弃，请使用"[裸金属服务器挂载云硬盘 - AttachBaremetalServerVolume](https://support.huaweicloud.com/api-bms/bms_api_0626.html)"。
#### 约束
- 不支持挂载bootable的卷。
- 裸金属服务器状态（OS-EXT-STS:vm_state属性）处于PAUSED状态下不支持挂卷。
- 要挂载的卷必须是available状态的卷或者共享卷。
- 仅支持挂载SCSI类型的卷。
 
#### URI
POST /v2.1/{project_id}/servers/{server_id}/os-volume_attachments
参数说明请参见[表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)获取。 |
   
#### 请求参数
| 参数                     | 是否必选 | 参数类型          | 描述                                                             |
|:---|:---|:---|:---|
| volumeAttachment | 是  | Object | 要挂载的卷相关信息，详情请参见[表2]。 |
   
 表2volumeAttachment数据结构说明 
| 参数     | 是否必选 | 参数类型    | 描述                                                                                                                                           |
|:---|:---|:---|:---|
| volumeId | 是 | String | 要挂卷的卷ID。                                                                                                                                   |
| device  | 否 | String | 磁盘挂载点，如/dev/sda、/dev/sdb。 新增加的磁盘挂载点不能和已有的磁盘挂载点相同。 需要根据已有设备名称顺序指定，否则由系统自动生成。 |
   
#### 请求示例
挂载一块ID为b53f23bd-ee8f-49ec-9420-d1acfeaf91d6的云硬盘到ID为95bf2490-5428-432c-ad9b-5e3406f869dd的裸金属服务器上，挂载点为/dev/sdb。
```
POST https://{ECS Endpoint}/v2.1/c685484a8cc2416b97260938705deb65/servers/95bf2490-5428-432c-ad9b-5e3406f869dd/os-volume_attachments
```
```
{
    "volumeAttachment": {
        "volumeId": "b53f23bd-ee8f-49ec-9420-d1acfeaf91d6",
        "device": "/dev/sdb"
    }
}
```
#### 响应参数
| 参数              | 参数类型    | 描述                                                        |
|:---|:---|:---|
| volumeAttachment | Object | 裸金属服务器挂载信息列表，详情请参见[表3]。 |
   
 表3volumeAttachment字段数据结构说明 
| 参数          | 参数类型      | 描述                  |
|:---|:---|:---|
| device   | String | 设备名称，例如"/dev/vdb"。 |
| serverId | String | 挂载的裸金属服务器，UUID格式。  |
| id        | String | 卷的UUID。            |
| volumeId | String | 挂载ID，目前实现与卷UUID相同。 |
   
#### 响应示例
```
{
    "volumeAttachment": {
        "id": "b53f23bd-ee8f-49ec-9420-d1acfeaf91d6",
        "volumeId": "b53f23bd-ee8f-49ec-9420-d1acfeaf91d6",
        "serverId": "820abbd0-2d8e-4bc5-ae46-69cacfd4fbaa",
        "device": "/dev/vdb"
    }
}
```
#### 返回值
正常返回值：
| 返回值 | 说明              |
|:---|:---|
| 200 | 服务器已成功处理了请求。 |
   
其他返回值请参考[状态码](https://support.huaweicloud.com/api-bms/bms_api_0801.html)。
#### 错误码
请参考[错误码](https://support.huaweicloud.com/api-bms/bms_api_0802.html)。