文档首页/ 弹性云服务器 ECS/ API参考/ API/ 磁盘管理/ 查询弹性云服务器挂载磁盘列表详情信息
更新时间:2024-12-13 GMT+08:00

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

功能介绍

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

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

返回值

请参考通用请求返回值

错误码

请参考错误码