查询磁盘列表
更新时间 2026-05-22 16:14:15
最近更新时间: 2026-05-22 16:14:15
接口功能介绍
查询可用磁盘信息，含本地盘、裸盘、云盘
接口约束
nodeCode边缘池id需要正确,可通过查看区域集群编码列表接口获取。
URI
GET /v3/evm/listDisk
路径参数 无
Query参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| nodeCode | 是 | String | 边缘池id，可通过查看区域集群编码列表接口获取。 | cn-guangzhou3 | |
| priceType | 是 | String | 价格类型,目前只支持按需付费和包年包月. 付费信息，取值有ANNUAL_OR_MONTHLY，PAY_FOR_USE | PAY_FOR_USE |
请求参数
请求头header参数 无
请求体body参数 无
响应参数
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| statusCode | Integer | 状态码 | 200 | |
| message | String | 状态描述 | Success | |
| returnObj | Object | 返回数据 | returnObj | |
| error | String | 错误码，执行成功时，不返回该字段 | ECX_0001 |
表 returnObj
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| cloudDiskList | Array of Objects | 云盘信息列表 | cloudDiskList | |
| lvmDiskList | Array of Objects | 本地盘信息列表 | lvmDiskList | |
| rawDiskList | Array of Objects | 本地裸盘信息列表 | rawDiskList | |
| nvmeDiskList | Array of Objects | NVMe盘信息列表 | nvmeDiskList |
表 cloudDiskList
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| offerId | Integer | 云盘规格id | 123 | |
| productInstanceName | String | 云盘产品实例名称 | hdd.eds | |
| ioType | String | 云盘IO类型。NORMAL(高IO)，HIGH(通用型SSD)， ULTRA(超高IO) ，ULTRAFAST(极速IO) | NORMAL | |
| systemDiskType | String | 创建自定义规格虚机使用的非共享类型系统盘类型 。 UNDEFINE: 未知， Cloud_Disk: cd， LVM_Disk_HDD: lvm_hdd， LVM_Disk_SSD: lvm_ssd， LVM_Disk_NVME: lvm_nvme， RAW_Disk_HDD: raw_hdd， RAW_Disk_SSD: raw_ssd， RAW_Disk_NVME: raw_nvme， LVM_Disk_ALLTYPE: lvm_all_type， RAW_Disk_ALLTYPE: raw_all_type， ZFS_Disk_HDD: zfs hdd， ZFS_Disk_SSD: zfs ssd， Cloud_Disk_SSD: cd ssh， Cloud_Disk_NVME: cd nvme | Cloud_Disk |
表 lvmDiskList
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| offerId | Integer | 本地盘规格id | 123 | |
| productInstanceName | String | 本地盘产品实例名称 | ssd.lvm | |
| ioType | String | 本地盘IO类型。NORMAL(高IO)，HIGH(通用型SSD)， ULTRA(超高IO) ，ULTRAFAST(极速IO) | HIGH | |
| systemDiskType | String | 创建自定义规格虚机使用的非共享类型系统盘类型。UNDEFINE: 未知， Cloud_Disk: cd， LVM_Disk_HDD: lvm_hdd， LVM_Disk_SSD: lvm_ssd， LVM_Disk_NVME: lvm_nvme， RAW_Disk_HDD: raw_hdd， RAW_Disk_SSD: raw_ssd， RAW_Disk_NVME: raw_nvme， LVM_Disk_ALLTYPE: lvm_all_type， RAW_Disk_ALLTYPE: raw_all_type， ZFS_Disk_HDD: zfs hdd， ZFS_Disk_SSD: zfs ssd， Cloud_Disk_SSD: cd ssh， Cloud_Disk_NVME: cd nvme | LVM_Disk_SSD | |
| diskType | String | 本地盘类型。取值类型：LVM、ZFS | LVM |
表 rawDiskList
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| ioType | String | 本地裸盘IO类型 | NORMAL | |
| specList | Array of Objects | 当前IO类型本地裸盘规格信息列表 | specList |
表 specList
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| systemDiskType | String | 创建自定义规格虚机使用的非共享类型系统盘类型 。 UNDEFINE: 未知， Cloud_Disk: cd， LVM_Disk_HDD: lvm_hdd， LVM_Disk_SSD: lvm_ssd， LVM_Disk_NVME: lvm_nvme， RAW_Disk_HDD: raw_hdd， RAW_Disk_SSD: raw_ssd， RAW_Disk_NVME: raw_nvme， LVM_Disk_ALLTYPE: lvm_all_type， RAW_Disk_ALLTYPE: raw_all_type， ZFS_Disk_HDD: zfs hdd， ZFS_Disk_SSD: zfs ssd， Cloud_Disk_SSD: cd ssh， Cloud_Disk_NVME: cd nvme | RAW_Disk_HDD | |
| offerId | Integer | 本地裸盘销售规格id | 123 | |
| specId | Integer | 本地裸盘规格id | 123 | |
| specSize | Integer | 本地裸盘大小，单位GB | 200 | |
| maxCount | Integer | 当前集群本规格本地裸盘所能使用的最大数量 | 50 |
表 nvmeDiskList
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| offerId | Integer | NVMe盘销售规格id | 123 | |
| specId | Integer | NVMe盘规格id | 123 | |
| specSize | Integer | NVMe盘大小，单位GB | 200 | |
| maxCount | Integer | 当前集群本规格NVMe盘所能使用的最大数量 | 50 | |
| productInstanceName | String | NVMe盘产品实例名称 | abc | |
| pciResourceName | String | NVMe直通的设备资源名称 | abc |
枚举参数
无
请求示例
请求url
GET https://{host}/v3/evm/listDisk?nodeCode=yn-baoshan-1&priceType=PAY_FOR_USE
请求头header
无
请求体body
无
响应示例
{
"statusCode": 200,
"message": "Success",
"returnObj": {
"nvmeDiskList": [],
"rawDiskList": [
{
"specList": [
{
"systemDiskType": "RAW_Disk_HDD",
"specId": 3,
"offerId": 15,
"specSize": 3725,
"maxCount": 6
}
],
"ioType": "NORMAL"
},
{
"specList": [
{
"systemDiskType": "RAW_Disk_SSD",
"specId": 4,
"offerId": 85,
"specSize": 446,
"maxCount": 2
}
],
"ioType": "HIGH"
}
],
"lvmDiskList": [
{
"ioType": "NORMAL",
"systemDiskType": "ZFS_Disk_HDD",
"productInstanceName": "hdd.zfs",
"offerId": 76,
"diskType": "ZFS"
}
],
"cloudDiskList": []
}
}
状态码
请参考 状态码
错误码
请参考 错误码
