華為云計算 云知識 查詢彈性云服務(wù)器單個磁盤信息ShowServerBlockDevice
查詢彈性云服務(wù)器單個磁盤信息ShowServerBlockDevice

 

功能介紹

查詢彈性 云服務(wù)器 掛載的單個磁盤信息。

該接口支持企業(yè)項目細粒度權(quán)限的校驗,具體細粒度請參見 ecs:cloudServers:showServerBlockDevice

調(diào)試

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

URI

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

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

參數(shù)

是否必選

描述

server_id

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

project_id

項目ID。

獲取方法請參見獲取項目ID。

volume_id

云硬盤 ID,UUID格式。

請求消息

響應(yīng)消息

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

參數(shù)

參數(shù)類型

描述

volumeAttachment

Object

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

表3 volumeAttachment參數(shù)

參數(shù)

參數(shù)類型

描述

serverId

String

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

volumeId

String

云硬盤ID,UUID格式。

id

String

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

UUID格式。

size

Integer

云硬盤大小,單位GB。

device

String

云硬盤掛載盤符,即磁盤掛載點。

pciAddress

String

pci地址。

bootIndex

Integer

云硬盤啟動順序。

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

bus

String

磁盤總線類型 。

取值范圍:virtio、scsi

請求示例

查詢云服務(wù)器的磁盤信息。

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

響應(yīng)示例

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

返回值

請參考通用請求返回值。

錯誤碼

請參考錯誤碼