1)接口功能介绍
创建云硬盘。
2)接口约束
创建云盘规格单位需要注意单位与数量。
3)URI
POST /v1/createCloudDisk。
4)请求参数
请求体body参数
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
nodeCode | 是 | String | 边缘池id。可通过查看区域集群编码列表接口获取 | cn-guangzhou3 | |
disks | 是 | List | 云盘信息 | * | disks |
vmOpt | 是 | Object | 磁盘操作 | * | vmOpt |
表 disks
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
diskIOType | 是 | String | 磁盘IO类型。 HHD 普通IO NORMAL = 0; SSD 高IO HIGH = 1; NVME 超高IO ULTRA = 2; 列表接口默查所有类型 ALL_IO_TYPE = -1; | HIGH | |
diskSize | 是 | Integer | 磁盘容量大小,单位为G,最小为100 | 100 | |
offerId | 是 | Integer | 销售品规格Id,规格信息从DescribeDiskTypes接口获取 | 100 | |
count | 是 | Integer | 云盘块数 | 2 | |
bus | 是 | String | 存储驱动类型。 存储驱动类型,Virtio驱动支持离线挂载/卸载,SCSI驱动支持在线挂载/卸载 | SCSI |
表 vmOpt
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
opt | 是 | String | 不挂载:UNMOUNT,挂载:MOUNT | MOUNT | |
vmName | 否 | String | 虚拟机id | evm-ass**** |
5)响应参数
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
requestId | 是 | String | 请求id | b84233d3-0796-xxx | |
status | 是 | Object | 应答状态 | status | |
data | 是 | Object | 返回数据 | data |
表 status
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
message | 是 | String | 状态描述 | Success | |
code | 是 | String | 状态码 | Success |
表 data
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
idList | 是 | List | 创建的云盘id列表 | * | |
idsList | 是 | List | 创建的云盘实例id列表 | idsList |
表 idsList
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
id | 是 | Int | 创建的云盘实例id | 222 | |
diskInstanceName | 是 | String | 创建的云盘实例名 | cd-xxxx |
6)请求示例
请求体body
{
"nodeCode": "yn-xxx-1",
"disks": [
{
"diskIOType": "NORMAL",
"diskSize": 100,
"offerId": 125,
"count": 1,
"bus": "SCSI"
}
],
"vmOpt": {
"opt": "MOUNT",
"vmName": "evm-cajfcbqvaou6sr7tgprg"
}
}
7)响应示例
{
"status": {
"message": "Success",
"code": "Success"
},
"data": {
"idList": [
1592
],
"idsList": [
{
"diskInstanceName": "cd-ce5uv1qvaoua2pjbodi0",
"id": 1592
}
]
},
"requestId": "bd6a4beb-892b-4bc0-a57f-f31be2de4fd5"
}
8)状态码
状态码 | 描述 |
---|---|
Success | 表示请求成功。 |