创建磁盘
1. 接口描述
调用 CreateDisk 接口创建一块包年包月的数据盘。
- 预付费磁盘的购买会预先扣除本次实例购买所需金额，在调用本次接口前请确保账户余额充足。
- 创建磁盘需要通过实名认证。您可以参见实名认证相关文档完成认证。
- 磁盘创建必须挂载在实例上，实例的状态必须为已停止（STOPPED）或已启动（STARTED）。
2. 请求参数
| 名称 | 类型 | 是否必选 | 描述 |
|---|---|---|---|
| Action | String | 是 | 固定取值：CreateDisk |
| RegionCode | String | 是 | 磁盘所属的地域编码，您可以调用 DescribeRegionConfig 查看最新的地域列表 |
| ZoneCode | String | 是 | 磁盘所属的可用区编码，您可以调用 DescribeZoneConfig 查看可用区列表 |
| DiskCategory | String | 是 | 磁盘种类，您可以调用 DescribeProductConfig 查看您可购买磁盘种类 |
| DiskSize | Integer | 是 | 磁盘大小，单位:GB |
| DiskChargeType | String | 是 | 磁盘付费方式，取值范围: PRE_PAID 预付费 |
| AutoRenew | String | 否 | 是否自动续费，取值范围: NONE 不开启自动续费 INFINITE 开启自动续费 |
| BuyTime | Integer | 是 | 购买时长 |
| BillingCycle | String | 是 | 计费周期，取值范围: MONTH 月 |
| SnapshotUUID | String | 否 | 快照ID，如果有传值话，表明从快照创建磁盘 |
| InstanceUUID | String | 是 | 实例ID |
| ClientToken | String | 是 | 用于保证请求的幂等性 |
3. 返回数据
| 名称 | 类型 | 说明 |
|---|---|---|
| DiskUUID | String | 磁盘ID |
| RequestId | String | 请求ID |
4. 示例
请求示例
https://openapi.kaopuyun.com/?SignatureVersion=1.0
&Action=CreateDisk
&Format=JSON
&SignatureNonce=fad368fd-b5e3-476b-903b-2ef34e0e9fba
&Version=2014-05-26
&AccessKeyId=hfWkfqG6a794
&Signature=IcyHYfUBWSzJauAbDaqniNSNE94=
&SignatureMethod=HMAC-SHA1
&Timestamp=2023-02-25T15:29:21Z
&RegionCode=cn-fuzhou-1
&ZoneCode=cn-fuzhou-1-a
&DiskCategory=LOCAL
&DiskSize=100
&DiskChargeType=PRE_PAID
&BuyTime=1
&BillingCycle=MONTH
&InstanceUUID=ecs-x8sfa05erl
&ClientToken=fad368fd-b5e3-476b-903b
正常返回示例
{
"DiskUUID":"disk-z500000czmnb",
"RequestId":"742fbe80-0ea9-11eb-9b36-0208cb7f7896"
}
5. 错误码
| 错误码 | 错误信息 |
|---|---|
| MissingParameter | RegionCode 参数不能为空 |
| MissingParameter | ZoneCode 参数不能为空 |
| MissingParameter | DiskCategory 参数不能为空 |
| MissingParameter | DiskSize 参数不能为空 |
| MissingParameter | DiskChargeType 参数不能为空 |
| MissingParameter | BuyTime 参数不能为空 |
| MissingParameter | BillingCycle 参数不能为空 |
| MissingParameter | InstanceUUID 参数不能为空 |
| ValueNotSupported | BillingCycle 参数不合法 |
| ValueNotSupported | DiskCategory 参数不合法 |
| ValueNotSupported | DiskChargeType 参数不合法 |
| ValueNotSupported | AutoRenew 参数不合法 |
| AccountBalnceNotEnough | 账户余额不足 |
| AccountNotRealnameAuth | 账户未实名认证 |
| InvalidDiskConfigNotSupported | 磁盘配置不合法 |
| CreateDiskFail | 创建磁盘失败:xxx |