華為云計(jì)算 云知識(shí) 查詢彈性云服務(wù)器磁盤信息ListServerBlockDevices
查詢彈性云服務(wù)器磁盤信息ListServerBlockDevices

 

功能介紹

查詢彈性 云服務(wù)器 掛載的磁盤列表詳情信息。

調(diào)試

您可以在API Explorer中調(diào)試該接口。

URI

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

參數(shù)說明請(qǐng)參見表1。
表1 參數(shù)說明

參數(shù)

是否必選

描述

project_id

項(xiàng)目ID。

獲取方法請(qǐng)參見獲取項(xiàng)目ID。

server_id

彈性云服務(wù)器ID,格式為UUID。

請(qǐng)求消息

響應(yīng)消息

響應(yīng)參數(shù)如表2所示。
表2 響應(yīng)參數(shù)

參數(shù)

參數(shù)類型

描述

volumeAttachments

Array of objects

云服務(wù)器掛載信息列表,更多信息請(qǐng)參見表3。

attachableQuantity

Object

云服務(wù)器可掛載磁盤數(shù)量,更多信息請(qǐng)參見表4。

表3 volumeAttachments參數(shù)

參數(shù)

參數(shù)類型

描述

serverId

String

彈性云服務(wù)器ID,UUID格式。

volumeId

String

云硬盤 ID,UUID格式。

id

String

掛載ID,與云硬盤ID相同。

UUID格式。

size

Integer

云磁盤大小,單位GB。

device

String

云硬盤掛載盤符,即磁盤掛載點(diǎn)。

pciAddress

String

pci地址。

bootIndex

Integer

云硬盤啟動(dòng)順序。

  • 0為系統(tǒng)盤
  • 非0為數(shù)據(jù)盤

bus

String

磁盤總線類型 。

取值范圍:virtio、scsi

表4 attachableQuantity參數(shù)

參數(shù)

參數(shù)類型

描述

free_scsi

Integer

云服務(wù)器可掛載scsi類型磁盤數(shù)量。

free_blk

Integer

云服務(wù)器可掛載virtio_blk類型磁盤數(shù)量。

free_disk

Integer

云服務(wù)器可掛載磁盤總數(shù)。

請(qǐng)求示例

查詢云服務(wù)器掛載的磁盤列表詳情。

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

響應(yīng)示例

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

返回值

請(qǐng)參考通用請(qǐng)求返回值。

錯(cuò)誤碼

請(qǐng)參考錯(cuò)誤碼。