创建磁盘
描述
创建磁盘需要通过实名认证。没有通过实名认证的可以前往 阿里云官网 中的用户中心 —> 会员信息中进行实名认证。
本接口是用于创建可卸载云盘的数据盘,包括普通云盘、高效云盘和SSD云盘,系统盘的快照不能用来创建数据盘。创建磁盘时,默认在删除磁盘时删除自动快照,即 DeleteAutoSnapshot=true,可以通过 修改磁盘属性 修改该参数。通过该接口创建的盘Portable属性为true。收费方式为按量付费。
请求参数中 Size 和 SnapshotId 必须选择其中一项来指定磁盘的大小或使用快照创建磁盘。
请求参数
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| Action | String | 是 | 操作接口名,系统规定参数,取值:CreateDisk |
| RegionId | String | 是 | 实例所属的 Region ID |
| ZoneId | String | 是 | 可用区 ID |
| DiskName | String | 否 | 磁盘名称,不填则为空,默认值为空,[2, 128] 英文或中文字符,必须以大小字母或中文开头,可包含数字,”.”,”_”或”-”,磁盘名称会展示在控制台。不能以 http:// 和 https:// 开头。 |
| Description | String | 否 | 磁盘描述,不填则为空,默认值为空,[2, 256] 个字符,磁盘描述会展示在控制台。不能以 http:// 和 https:// 开头。 |
| DiskCategory | String | 否 | 数据盘的磁盘种类 可选值:
|
| Size | Integer | 否 | 容量大小,以GB为单位:
|
| SnapshotId | String | 否 | 创建数据盘使用的快照 指定该参数后 Size 会被忽略,实际创建的磁盘大小为指定快照的大小 2013 年 7 月 15 日(含)前的快照不能用来创建磁盘 |
| ClientToken | String | 否 | 用于保证请求的幂等性。由客户端生成该参数值,要保证在不同请求间唯一,最大不值过 64 个 ASCII 字符。 具体参见附录:如何保证幂等性。 |
返回参数
| 名称 | 类型 | 描述 |
|---|---|---|
| DiskId | String | 磁盘 ID |
错误码
| 错误代码 | 描述 | Http 状态码 | 语义 |
|---|---|---|---|
| MissingParameter | The input parameter “RegionId” that is mandatory for processing this request is not supplied. | 400 | RegionId 参数未指定 |
| MissingParameter | The input parameter “ZoneId” that is mandatory for processing this request is not supplied. | 400 | 缺少 ZoneId 值(实际情况也可能是该用户无权使用此 Zone) |
| InvalidRegionId.NotFound | The specified region does not exist. | 404 | 指定的 RegionId 不存在 |
| InvalidZoneId.NotFound | The specified zone does not exist. | 404 | 指定的 ZoneId 不存在 |
| InvalidSnapshotId.NotFound | The specified snapshot does not exist. | 404 | 指定的 SnapshotId 不存在 |
| InvalidDiskName.Malformed | The specified disk name is wrongly formed. | 400 | 指定的 DiskName 格式不合法 |
| InvalidDescription.Malformed | The specified description is wrongly formed. | 400 | 指定的 DescriptionName 格式不合法 |
| InvalidParameter | The specified parameter “Size” is not valid. | 400 | Size 参数不合法 |
| InstanceDiskCategoryLimitExceed | The total size of specified disk category in an instance exceeds. | 403 | 指定的磁盘种类超过了单实例的最大容量 |
| InvalidSnapshot.TooOld | This operation is forbidden because the specified snapshot is created before 2013-07-15. | 403 | 指定快照创建于 2013 年 7 月 15 日(含)之前,不能创建磁盘 |
| InvalidSnapshot.TooLarge | The capacity of snapshot exceeds 2000GB. | 403 | 指定快照的容量超过磁盘种类的最大容量 |
| OperationDenied | The specified snapshot is not allowed to create disk. | 403 | 指定快照不允许创建磁盘 |
| QuotaExceed.PortableCloudDisk | The quota of portable cloud disk exceeds. | 403 | 可卸载普通云盘超过额度 |
| MissingParameter | The input parameter either “SnapshotId” or “Size” should be specified. | 400 | SnapshotId 或者 Size 参数未指定 |
| InvalidDiskCategory.ValueUnauthorized | The disk category is not authorized. | 403 | 指定磁盘种类无权限 |
| InvalidSnapshotId.NotReady | The specified snapshot has not completed yet. | 403 | 指定的快照未完成 |
| InvalidSnapshotId.NotDataDiskSnapshot | The specified snapshot is system disk snapshot. | 403 | 指定的快照不是数据盘快照,不能创建数据盘 |
| InvalidSnapshotId.NotFound | The specified snapshot does not exist. | 404 | 找不到指定的快照 |
示例
请求示例
https://ecs.aliyuncs.com/?action=CreateDisk&RegionId=cn-qingdao&ZoneId=cn-qingdao-b&Size=200&DiskName=ThisIsDiskName&Description=ThisIsDescription&&<公共请求参数>
返回示例
XML格式:
473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
JSON格式:
{ "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"}