# 挂载弹性云服务器磁盘（废弃） - NovaAttachVolume
#### 功能介绍
云服务器挂载磁盘。
弹性云服务器挂载磁盘应用示例请参考[弹性云服务器挂载磁盘](https://support.huaweicloud.com/api-ecs/ecs_04_0004.html)。
当前API已废弃，请使用[弹性云服务器挂载磁盘 - AttachServerVolume](https://support.huaweicloud.com/api-ecs/ecs_02_0605.html)。
#### 接口约束
1. 挂载bootable卷必须指定挂载盘符。
2. 由备份创建的磁盘不能挂载为系统盘。
3. 弹性云服务器状态（弹性云服务器的OS-EXT-STS:vm_state属性）处于SUSPENDED和PAUSED状态下不支持挂卷。
4. 待挂载的云硬盘必须是available状态。
5. 待挂载的云硬盘与云服务器属于同一可用区。
6. VBD类型的云硬盘不支持挂载到裸金属服务器上。
 
#### 调试
您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=ECS&api=NovaAttachVolume)中调试该接口。
#### URI
POST /v2.1/{project_id}/servers/{server_id}/os-volume_attachments
参数说明请参见[表1]。
 表1参数说明 
| 参数         | 是否必选 | 描述                                                                                                                      |
|:---|:---|:---|
| project_id | 是    | 项目ID。 获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-ecs/ecs_01_0016.html)。 |
| server_id  | 是    | 云服务器ID。                                                                                                                 |
   
#### 请求消息
请求参数如[表2]所示。
 表2请求参数 
| 参数               | 是否必选 | 参数类型   | 描述                                                                    |
|:---|:---|:---|:---|
| volumeAttachment | 是    | Object | 要挂载的卷相关信息，详情请参见[表3]。 |
   
 表3volumeAttachment数据结构说明 
| 参数       | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                  |
|:---|:---|:---|:---|
| volumeId | 是    | String | 待挂载磁盘的磁盘ID，UUID格式。                                                                                                                                                                                                                                                                                                                  |
| device   | 否    | String | 磁盘挂载点，如/dev/sda，/dev/sdb。 新增加的磁盘挂载点不能和已有的磁盘挂载点相同。 需要根据已有设备名称顺序指定，否则由系统自动生成。 说明： VBD磁盘挂载点只支持从/dev/vdb到/dev/vdx，建议按英文字母顺序进行挂载，否则可能出现云服务器中磁盘盘符错乱的情况。 |
   
#### 响应消息
响应参数如[表 响应参数]所示。
 表4响应参数 
| 参数               | 参数类型   | 描述                                                                 |
|:---|:---|:---|
| volumeAttachment | object | 云服务器挂载信息，详情请参见[表5]。 |
   
 表5volumeAttachment字段数据结构说明 
| 参数       | 参数类型   | 描述                 |
|:---|:---|:---|
| device   | String | 设备名称。              |
| serverId | String | 挂载的云服务器ID，UUID格式。  |
| id       | String | 卷的ID，UUID格式。       |
| volumeId | String | 挂载ID，目前实现与卷UUID相同。 |
   
#### 请求示例
挂载ID为"54667652-3029-4af8-9222-2d53066fd61c"的磁盘到指定云服务器，挂载点为"/dev/sdb"。
```
POST https://{endpoint}/v2.1/{project_id}/servers/{server_id}/os-volume_attachments
{
    "volumeAttachment": {
        "volumeId": "54667652-3029-4af8-9222-2d53066fd61c",
        "device": "/dev/sdb"
    }
}
```
#### 响应示例
```
{
    "volumeAttachment": {
        "device": "/dev/vdb",
        "serverId": "ab258e25-e351-47c7-b6e3-0749c5d9ed6a",
        "id": "54667652-3029-4af8-9222-2d53066fd61c",
        "volumeId": "54667652-3029-4af8-9222-2d53066fd61c"
    }
}
```
#### 返回值
请参考[通用请求返回值](https://support.huaweicloud.com/api-ecs/ecs_07_0001.html)。