# 查询弹性云服务器磁盘信息（废弃）
#### 功能介绍
查询弹性云服务器挂载的磁盘信息。
当前API已废弃，请使用[查询弹性云服务器挂载磁盘列表信息 - ListServerVolumeAttachments](https://support.huaweicloud.com/api-ecs/ecs_02_0603.html)。
#### URI
GET /v2.1/servers/{server_id}/block_device
参数说明请参见[表1]。
 表1参数说明 
| 参数        | 是否必选 | 描述               |
|:---|:---|:---|
| server_id | 是    | 弹性云服务器ID，UUID格式。 |
   
#### 请求消息
无
#### 响应消息
响应参数如[表2]所示。
 表2响应参数 
| 参数                 | 参数类型             | 描述                                                            |
|:---|:---|:---|
| volumeAttachments  | Array of objects | 云服务器挂载信息列表，更多信息请参见[表3]。        |
| attachableQuantity | Object           | 云服务器可挂载磁盘数量，更多信息请参见[表4]。 |
   
 表3volumeAttachments参数 
| 参数         | 参数类型    | 描述                                                                                                                                                                                                                                    |
|:---|:---|:---|
| serverId   | String  | 弹性云服务器ID，格式为UUID。                                                                                                                                                                                                                     |
| volumeId   | String  | 云硬盘ID，格式为UUID。                                                                                                                                                                                                                        |
| id         | String  | 挂载ID，与云硬盘ID相同。 格式为UUID。                                                                                                                                                                                   |
| size       | Integer | 云磁盘大小，单位GiB。                                                                                                                                                                                                                          |
| device     | String  | 云硬盘挂载盘符，即磁盘挂载点。                                                                                                                                                                                                                       |
| pciAddress | String  | pci地址。                                                                                                                                                                                                                                |
| bootIndex  | Boolean | 云硬盘启动顺序。 - 0为系统盘  - 非0为数据盘   |
| bus        | String  | 磁盘总线类型 。 取值范围：virtio、scsi                                                                                                                                                                           |
   
 表4attachableQuantity参数 
| 参数        | 参数类型    | 描述                       |
|:---|:---|:---|
| free_scsi | Integer | 云服务器可挂载scsi类型磁盘数量。       |
| free_blk  | Integer | 云服务器可挂载virtio_blk类型磁盘数量。 |
| free_disk | Integer | 云服务器可挂载磁盘总数。             |
   
#### 请求示例
```
GET https://{endpoint}/v2.1/servers/4d8c3732-a248-40ed-bebc-539a6ffd25c0/block_device
```
#### 响应示例
```
{
    "attachableQuantity": {
            "free_scsi": 23,
            "free_blk": 15,
            "free_disk": 23
     },
    "volumeAttachments": [
        {
            "pciAddress": "0000:02:01.0",
            "volumeId": "a26887c6-c47b-4654-abb5-dfadf7d3f803",
            "device": "/dev/vda",
            "serverId": "4d8c3732-a248-40ed-bebc-539a6ffd25c0",
            "id": "a26887c6-c47b-4654-abb5-dfadf7d3f803",
            "size": "40",
            "bootIndex": 0,
            "bus":"virtio"
        },
        {
            "pciAddress": "0000:02:02.0",
            "volumeId": "a26887c6-c47b-4654-abb5-asdf234r234r",
            "device": "/dev/vdb",
            "serverId": "4d8c3732-a248-40ed-bebc-539a6ffd25c0",
            "id": "a26887c6-c47b-4654-abb5-asdf234r234r",
            "size": "10",
            "bootIndex": 1,
            "bus":"virtio"
        }
    ]
}
```
#### 返回值
请参考[通用请求返回值](https://support.huaweicloud.com/api-ecs/ecs_07_0001.html)。
#### 错误码
请参考[错误码](https://support.huaweicloud.com/api-ecs/ecs_07_0002.html)。