1)接口功能介绍
创建裸盘。
2)接口约束
无。
3)URI
POST /v1/createRawDisk。
4)请求参数
请求体body参数
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
nodeCode | 是 | String | 边缘池id。可通过查看区域集群编码列表接口获取 | cn-guangzhou3 | |
rawDisks | 是 | List | 云盘信息 | * | rawDisks |
vmOpt | 是 | Object | 磁盘操作 | * | vmOpt |
表 rawDisks
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
diskIOType | 是 | String | 磁盘IO类型。HHD 普通IO :NORMAL; SSD 高IO :HIGH;NVME :超高IO ULTRA ; 列表接口默查所有类型 ALL_IO_TYPE = -1; |
HIGH | |
specSize | 是 | Integer | 磁盘容量大小,单位为G | 20 | |
offerId | 是 | Integer | 销售品规格Id | 100 | |
specId | 是 | Integer | 裸盘规格id | 12 | |
count | 是 | Integer | 云盘块数 | 2 | |
bus | 是 | String | 存储驱动类型,Virtio驱动支持离线挂载/卸载; SCSI驱动支持在线挂载/卸载 |
SCSI |
表 vmOpt
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
opt | 是 | String | MOUNT;创建接口不支持UNMOUNT操作 | 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
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
lvmList | 是 | List | 创建的云盘id列表,待废弃 | ||
idsList | 是 | List | 创建的云盘实例id列表 | * | idsList |
表 idsList
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
id | 是 | Int | 创建的云盘实例id | 222 | |
diskInstanceName | 是 | String | 创建的云盘实例名 | cd-xxxx |
6)请求示例
请求体body
{
"nodeCode": "hn-changde-1",
"rawDisks": [
{
"diskIOType": "NORMAL",
"offerId": 60,
"specId": 3,
"specSize": 3725,
"count": 1,
"bus": "SCSI"
}
],
"vmOpt": {
"opt": "MOUNT",
"vmName": "evm-ca645sivaou0kda7u4p0"
}
}
7)响应示例
{
"requestId": "e3acc572-9d28-4553-9173-7acc17f5b126",
"status": {
"code": "Success",
"message": "Success"
},
"data": {
"rawList": [
189
],
"idsList": [
{
"id": 189,
"diskInstanceName": "rd-cal8okei15hs86ekf9g0"
}
]
}
}
8)状态码
状态码 | 描述 |
---|---|
Success | 表示请求成功。 |