创建磁盘
描述
创建磁盘需要通过实名认证。没有通过实名认证的可以前往 阿里云官网 中的用户中心 —> 会员信息中进行实名认证。
本接口是用于创建可卸载云盘的数据盘,包括普通云盘、高效云盘和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
找不到指定的快照
示例
请求示例
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"}
所属专题: