创建云硬盘
更新时间 2026-05-22 15:56:04
最近更新时间: 2026-05-22 15:56:04
接口功能介绍
创建云硬盘。
接口约束
创建云盘规格单位需要注意单位与数量。
URI
POST /v3/disk/createCloudDisk
路径参数 无
Query参数 无
请求参数
请求头header参数 无
请求体body参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| nodeCode | 是 | String | 边缘池id，可通过查看区域集群编码列表接口获取。 | cn-guangzhou3 | |
| disks | 是 | Array of Objects | 云盘信息。 | disks | |
| vmOpt | 是 | Object | 磁盘操作。 | vmOpt |
表 disks
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| diskIOType | 是 | String | 磁盘IO类型，可选值为：NORMAL(高IO)，HIGH(通用型SSD)， ULTRA(超高IO) ，ULTRAFAST(极速IO)，ALL_IO_TYPE(所有类型)，列表接口默查所有类型。 | HIGH | |
| diskSize | 是 | Integer | 磁盘容量大小。单位为G，云盘大小范围为10GB～32TB。 | 100 | |
| offerId | 是 | Integer | 销售品规格Id。 | 100 | |
| count | 是 | Integer | 云盘块数。 | 2 | |
| bus | 是 | String | 存储驱动类型， 支持Virtio和SCSI两种，均支持在线挂载/卸载。 | SCSI |
表 vmOpt
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| opt | 否 | String | 不挂载:UNMOUNT，挂载:MOUNT, 不传则默认不操作。 | MOUNT | |
| vmName | 否 | String | 虚拟机id。 | evm-ass**** |
响应参数
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| statusCode | Integer | 状态码。 | 200 | |
| message | String | 状态描述。 | Success | |
| returnObj | Object | 返回数据。 | returnObj | |
| error | String | 错误码，执行成功时，不返回该字段。 | ECX_0001 |
表 returnObj
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| idList | Array of Integers | 创建的云盘id列表。 | * | |
| idsList | Array of Objects | 创建的云盘实例id列表。 | idsList |
表 idsList
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| id | Integer | 创建的云盘实例id。 | 222 | |
| diskInstanceName | String | 创建的云盘实例名。 | cd-xxxx |
枚举参数
无
请求示例
请求url
无
请求头header
无
请求体body
{
"nodeCode": "yn-xxx-1",
"disks": [
{
"diskIOType": "NORMAL",
"diskSize": 100,
"offerId": 125,
"count": 1,
"bus": "SCSI"
}
],
"vmOpt": {
"opt": "MOUNT",
"vmName": "evm-cajfcbqvaou6sr7tgprg"
}
}
响应示例
{
"statusCode": 200,
"message": "Success",
"returnObj": {
"idList": [
1592
],
"idsList": [
{
"diskInstanceName": "cd-ce5uv1qvaoua2pjbodi0",
"id": 1592
}
]
}
}
状态码
请参考 状态码
错误码
请参考 错误码
