createDisks
描述
按照指定配置创建一块或多块云硬盘
- 云硬盘类型可以选择hdd.std1、ssd.gp1、ssd.io1
- 磁盘大小
- hdd.std1: 容量型hdd,范围[20,16000]GiB,步长为10GiB, iops为计算得出,与购买磁盘的容量成正比
- ssd.gp1: 通用型ssd,范围[20,16000]GiB,步长为10GiB, iops为计算得出,与购买磁盘的容量成正比。
- ssd.io1: 性能型ssd,范围[20,16000]GiB,步长为10GiB, iops可以通过购买容量计算得出,或者为用户指定。
- 其他
- 创建完成后,云硬盘状态为 available
- 可选参数快照 ID用于从快照创建新盘
- 批量创建时,云硬盘的命名为 硬盘名称-数字,例如 myDisk-1,myDisk-2
- maxCount为最大努力,不保证一定能达到maxCount
请求方式
POST
请求地址
https://disk.jdcloud-api.com/v1/regions/{regionId}/disks
名称 |
类型 |
是否必需 |
默认值 |
描述 |
regionId |
String |
True |
|
地域ID |
请求参数
名称 |
类型 |
是否必需 |
默认值 |
描述 |
diskSpec |
DiskSpec |
True |
|
创建云硬盘规格 |
maxCount |
Integer |
True |
|
购买实例数量;取值范围:[1,100] |
userTags |
Tag[ ] |
False |
|
用户标签 |
clientToken |
String |
True |
|
幂等性校验参数 |
Tag
名称 |
类型 |
是否必需 |
默认值 |
描述 |
key |
String |
False |
|
Tag键 |
value |
String |
False |
|
Tag值 |
DiskSpec
名称 |
类型 |
是否必需 |
默认值 |
描述 |
az |
String |
True |
|
云硬盘所属的可用区 |
name |
String |
True |
|
云硬盘名称 |
description |
String |
False |
|
云硬盘描述 |
diskType |
String |
True |
|
云硬盘类型,取值为ssd.gp1、ssd.io1、hdd.std1之一 |
diskSizeGB |
Integer |
True |
|
云硬盘大小,单位为 GiB;ssd.io1 类型取值范围[20,16000]GB,步长为10G; ssd.gp1 类型取值范围[20,16000]GB,步长为10G; hdd.std1 类型取值范围[20,16000]GB,步长为10G |
iops |
Integer |
False |
|
云硬盘IOPS的大小,当且仅当云盘类型是ssd.io1型的云盘有效,步长是10,默认值为容量30,最大值为容量50 |
snapshotId |
String |
False |
|
用于创建云硬盘的快照ID |
charge |
ChargeSpec |
False |
|
计费配置;如不指定,默认计费类型是后付费-按使用时常付费 |
multiAttachable |
Boolean |
False |
|
云硬盘是否支持一盘多主机挂载,默认为false(不支持) |
encrypt |
Boolean |
False |
|
云硬盘是否加密,默认为false(不加密) |
ChargeSpec
名称 |
类型 |
是否必需 |
默认值 |
描述 |
chargeMode |
String |
False |
postpaid_by_duration |
计费模式,取值为:prepaid_by_duration,postpaid_by_usage或postpaid_by_duration,prepaid_by_duration表示预付费,postpaid_by_usage表示按用量后付费,postpaid_by_duration表示按配置后付费,默认为postpaid_by_duration.请参阅具体产品线帮助文档确认该产品线支持的计费类型 |
chargeUnit |
String |
False |
|
预付费计费单位,预付费必填,当chargeMode为prepaid_by_duration时有效,取值为:month、year,默认为month |
chargeDuration |
Integer |
False |
|
预付费计费时长,预付费必填,当chargeMode取值为prepaid_by_duration时有效。当chargeUnit为month时取值为:1~9,当chargeUnit为year时取值为:1、2、3 |
autoRenew |
boolean |
False |
false |
true为开通自动续费,false为不开通自动续费,,仅对包年包月资源有效。开通后,将以本次创建时的购买时长作为自动续费周期,自动续费周期可在续费管理功能中进行修改。 |
成功的响应
json
{
"result": {
"diskIds": [string]
},
"requestId": string
}
返回参数
名称 |
类型 |
描述 |
result |
Result |
结果集 |
requestId |
String |
请求ID |
Result
名称 |
类型 |
描述 |
diskIds |
String[ ] |
创建的云硬盘ID列表 |
tagmsg |
String |
标签结果信息 |
返回码
返回码 |
描述 |
200 |
OK |
400 |
Invalid parameter |
401 |
Authentication failed |
404 |
Not found |
429 |
Quota exceeded |
500 |
Internal server error |
503 |
Service unavailable |