阿里云如何使用创建磁盘接口

　　创建磁盘需要通过实名认证。没有通过实名认证的可以前往 阿里云官网 中的用户中心 —> 会员信息中进行实名认证。

　　本接口是用于创建可卸载云盘的数据盘，包括普通云盘、高效云盘和SSD云盘，系统盘的快照不能用来创建数据盘。创建磁盘时，默认在删除磁盘时删除自动快照，即 DeleteAutoSnapshot=true，可以通过 修改磁盘属性 修改该参数。通过该接口创建的盘Portable属性为true。收费方式为按量付费。

　　请求参数中 Size 和 SnapshotId 必须选择其中一项来指定磁盘的大小或使用快照创建磁盘。

　　请求参数

名称 类型 是否必须 描述
Action   String   是   操作接口名，系统规定参数，取值：CreateDisk  
RegionId   String   是   实例所属的 Region ID  
ZoneId   String   是   可用区 ID  
DiskName   String   否   磁盘名称，不填则为空，默认值为空，[2, 128] 英文或中文字符，必须以大小字母或中文开头，可包含数字，”.”，”_”或”-”，磁盘名称会展示在控制台。不能以 和 https:// 开头。  
Description   String   否   磁盘描述，不填则为空，默认值为空，[2, 256] 个字符，磁盘描述会展示在控制台。不能以 和 https:// 开头。  
DiskCategory   String   否   数据盘的磁盘种类
可选值：

cloud – 普通云盘

cloud_efficiency – 高效云盘

cloud_ssd – SSD云盘

默认值：cloud  
Size   Integer   否   容量大小，以GB为单位：

cloud：5 ~ 2000

cloud_efficiency：20 ~ 32768

cloud_ssd：20 ~ 32768

指定该参数后，Size大小必须 ≥ 指定快照 SnapshotId 的大小。  
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   找不到指定的快照  

　　示例

　　请求示例