华为云计算 云知识 查询弹性云服务器磁盘信息ListServerBlockDevices
查询弹性云服务器磁盘信息ListServerBlockDevices

 

功能介绍

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

调试

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

URI

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

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

参数

是否必选

描述

project_id

项目ID。

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

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

云磁盘大小,单位GB。

device

String

云硬盘挂载盘符,即磁盘挂载点。

pciAddress

String

pci地址。

bootIndex

Integer

云硬盘启动顺序。

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

bus

String

磁盘总线类型 。

取值范围:virtio、scsi

表4 attachableQuantity参数

参数

参数类型

描述

free_scsi

Integer

云服务器可挂载scsi类型磁盘数量。

free_blk

Integer

云服务器可挂载virtio_blk类型磁盘数量。

free_disk

Integer

云服务器可挂载磁盘总数。

请求示例

查询云服务器挂载的磁盘列表详情。

GET https://{endpoint}/v1/{project_id}/cloudservers/{server_id}/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"
        }
    ]
}

返回值

请参考通用请求返回值

错误码

请参考错误码

上一篇:什么是Sphinx 下一篇:关于优学院学习卡的常见问题

弹性云服务器 ECS

 

弹性云服务器(Elastic Cloud Server)是一种可随时自助获取、可弹性伸缩的云服务器,帮助用户打造可靠、安全、灵活、高效的应用环境,确保服务持久稳定运行,提升运维效率