文档首页/ 弹性云服务器 ECS/ API参考/ API/ 磁盘管理/ 查询弹性云服务器单个磁盘信息
更新时间：2025-08-15 GMT+08:00
查看PDF
分享

查询弹性云服务器单个磁盘信息

功能介绍

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

该接口支持企业项目细粒度权限的校验，具体细粒度请参见 ecs:cloudServers:showServerBlockDevice

调试

您可以在API Explorer中调试该接口。

URI

GET /v1/{project_id}/cloudservers/{server_id}/block_device/{volume_id}

参数说明请参见表1。
表1 参数说明

参数

是否必选

描述

server_id

是

弹性云服务器ID，UUID格式。

project_id

是

项目ID。

获取方法请参见获取项目ID。

volume_id

是

云硬盘ID，UUID格式。

请求消息

无

响应消息

响应参数如表2所示。
表2 响应参数

参数

参数类型

描述

volumeAttachment

Object

云服务器挂载信息，更多信息请参见表3。
表3 volumeAttachment参数

参数

参数类型

描述

serverId

String

弹性云服务器ID，UUID格式。

volumeId

String

云硬盘ID，UUID格式。

id

String

挂载ID，与云硬盘ID相同。

UUID格式。

size

Integer

云硬盘大小，单位GiB。

device

String

云硬盘挂载盘符，即控制台显示的磁盘挂载点。

如需查询云服务器内部的磁盘挂载点，请参见控制台与弹性云服务器内部之间磁盘挂载点的对应关系。

pciAddress

String

pci地址。

bootIndex

Integer

云硬盘启动顺序。

  • 0为系统盘。
  • 非0为数据盘

bus

String

磁盘总线类型 。

取值范围：virtio、scsi

请求示例

查询云服务器的磁盘信息。

GET https://{endpoint}/v1/{project_id}/cloudservers/{server_id}/block_device/{volume_id}

响应示例

{
    "volumeAttachment": {
        "pciAddress": "0000:02:01.0",
        "volumeId": "a26887c6-c47b-4654-abb5-asdf234r234r",
        "device": "/dev/vda",
        "serverId": "4d8c3732-a248-40ed-bebc-539a6ffd25c0",
        "id": "a26887c6-c47b-4654-abb5-asdf234r234r",
        "size": "40",
        "bootIndex": 0,
        "bus":"virtio"
    }
}

返回值

请参考通用请求返回值。

错误码

请参考错误码。

父主题： 磁盘管理

相关文档