功能介绍

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

该接口支持企业项目细粒度权限的校验，具体细粒度请参见 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	云硬盘大小，单位GB。
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"
    }
}

返回值

请参考通用请求返回值。

错误码

请参考错误码。

父主题： 磁盘管理

内容没看懂？ 不太想学习？想快速解决？ 有偿解决： 联系专家