文档首页/弹性云服务器 ECS/API参考/历史API/磁盘管理/查询弹性云服务器磁盘信息（废弃）
更新时间：2025-11-25 GMT+08:00
查看PDF
分享

查询弹性云服务器磁盘信息（废弃）

功能介绍

查询弹性云服务器挂载的磁盘信息。

当前API已废弃，请使用查询弹性云服务器挂载磁盘列表信息 - ListServerVolumeAttachments。

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。

表3 volumeAttachments参数

参数

参数类型

描述

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

表4 attachableQuantity参数

参数

参数类型

描述

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"
        }
    ]
}

返回值

请参考通用请求返回值。

错误码

请参考错误码。

父主题：磁盘管理