全部产品
云服务器 ECS

CreateDisk

更新时间:2017-09-21 16:37:16   分享:   

描述

本接口是用于创建可卸载云盘的数据盘。磁盘类型包括普通云盘、高效云盘和SSD云盘。

  • 创建磁盘需要通过实名认证。请前往会员信息中实名认证
  • 创建磁盘时,默认在删除磁盘时删除其自动快照,即 DeleteAutoSnapshot 取值为 true,可以通过 ModifyDiskAttribute 修改该参数。
  • 创建的磁盘默认 Portable 属性为 true,收费方式默认为为按量付费。
  • 必须指定一项请求参数 SizeSnapshotId。请求参数 Size 指定磁盘容量大小,请求参数 SnapshotId 使用快照创建磁盘。

请求参数

名称 类型 是否必须 描述
Action String 系统规定参数。取值:CreateDisk
RegionId String 实例所属的 Region ID。Region ID 的列表详见 地域列表
ZoneId String 可用区 ID。
DiskName String 磁盘名称。
  • 长度为 [2,128] 个大小写英文或中文字符,必须以大小字母或中文开头,可包含数字,下划线(_)或连字符(-)。
  • 磁盘名称会展示在控制台。
  • 不能以 http:// 和 https:// 开头。
  • 不填则为空,默认值:空。
Description String 磁盘描述。
  • 长度为 [2,256] 个大小写英文或中文字符。
  • 磁盘描述会展示在控制台。
  • 不能以 http:// 和 https:// 开头。
  • 不填则为空,默认值:空。
Encrypted Boolean 是否加密。取值范围:
  • true: 加密
  • false: 不加密
默认值:false
DiskCategory String 数据盘的磁盘种类。取值范围:
  • cloud:普通云盘
  • cloud_efficiency:高效云盘
  • cloud_ssd:SSD云盘
默认值:cloud
Size Integer 容量大小,以 GB 为单位。指定该参数后,其取值必须 ≥ 指定快照 ID 的容量大小。取值范围:
  • cloud:[5, 2000]
  • cloud_efficiency:[20, 32768]
  • cloud_ssd:[20, 32768]
SnapshotId String 创建磁盘使用的快照。
指定该参数后, Size 会被忽略,实际创建的磁盘大小为指定快照的大小。
2013 年 7 月 15 日及以前的快照不能用来创建磁盘。
ClientToken String 用于保证请求的幂等性。由客户端生成该参数值,要保证在不同请求间唯一,最大不值过 64 个 ASCII 字符。
具体参见附录:如何保证幂等性

返回参数

名称 类型 描述
DiskId String 磁盘 ID

错误码

错误代码 描述 HTTP 状态码 语义
Account.Arrearage Your account has an outstanding payment. 400 账号已经欠费。
InvalidDescription.Malformed The specified description is wrongly formed. 400 指定的 DescriptionName 格式不合法。
InvalidDiskCategory.NotSupported The specified disk category is not support. 400 指定的磁盘类型不支持。
InvalidDiskCategory.ValueNotSupported The specified parameter DiskCategory is not valid. 400 指定的 DiskCategory 不合法。
InvalidDiskName.Malformed The specified disk name is wrongly formed. 400 指定的 DiskName 格式不合法。
EncryptedOption.Conflict Encryption value of disk conflicts with that of snapshot . 400 磁盘的加密属性和快照的加密属性不一致。
InvalidParameter.Encrypted.KmsNotEnabled The encrypted disk need enable KMS. 400 账户未开通 KMS 服务(需用户主动开通 KMS 服务)。
InvalidParameter.EncryptedIllegal The value of parameter encrypted is illegal. 400 传入的参数 encrypted 非法。
InvalidParameter.EncryptedNotSupported Encrypted disk is not support in this region. 400 所选择的 region 不支持加密特性。
InvalidParameter.EncryptedNotSupported Corresponding data disk category does not support encryption. 400 对应的磁盘类型不支持加密。
InvalidSize.ValueNotSupported The specified parameter Size is not valid. 400 指定的 Size 不合法。
MissingParameter The input parameter either SnapshotId or Size should be specified. 400 SnapshotId 或者 Size 参数未指定。
InstanceDiskCategoryLimitExceed The total size of specified disk category in an instance exceeds. 403 指定的磁盘种类超过了单实例的最大容量。
InvalidAccountStatus.NotEnoughBalance Your account does not have enough balance. 403 账户余额不足。
InvalidAccountStatus.SnapshotServiceUnavailable Snapshot service has not been opened yet. 403 快照服务未开通。
InvalidDataDiskCategory.NotSupported Specified disk category is not supported. 403 指定的磁盘类型不支持。
InvalidDataDiskCategory.NotSupported diskCategory is CLOUD_SSD, but the supported DiskCategory is [io1, io4, io3]. 403 指定的磁盘类型不支持。
InvalidDiskCategory.ValueUnauthorized The disk category is not authorized. 403 指定磁盘种类无权限。
InvalidDiskSize.NotSupported disk size is not supported. 403 指定的磁盘大小不支持。
InvalidDiskSize.TooSmall Specified disk size is less than the size of snapshot. 403 指定的磁盘小于指定快照大小。
InvalidSnapshot.NotReady The specified snapshot creation is not completed yet. 403 指定的快照还在创建中。
InvalidSnapshot.TooLarge The capacity of snapshot exceeds 2000GB. 403 指定快照的容量超过磁盘种类的最大容量。
InvalidSnapshot.TooOld This operation is forbidden because the specified snapshot is created before 2013-07-15. 403 指定快照创建于 2013 年 7 月 15 日(含)之前,不能创建磁盘。
InvalidSnapshotId.NotReady The specified snapshot has not completed yet. 403 指定的快照未完成。
OperationDenied The specified snapshot is not allowed to create disk. 403 指定快照不允许创建磁盘。
OperationDenied The type of the disk does not support the operation. 403 指定磁盘类型不支持该操作。
QuotaExceed.PortableCloudDisk The quota of portable cloud disk exceeds. 403 可卸载普通云盘超过额度。
InvalidRegionId.NotFound The specified RegionId does not exist. 404 指定的 RegionId 不存在。
InvalidRegionId.NotFound The specified RegionId does not exist. 404 指定的 RegionId 不存在。
InvalidSnapshotId.NotFound The specified SnapshotId does not exist. 404 找不到指定的快照。
InvalidZoneId.NotFound The specified zone does not exist. 404 指定的 ZoneId 不存在。

示例

请求示例

  1. https://ecs.aliyuncs.com/?action=CreateDisk
  2. &RegionId=cn-qingdao
  3. &ZoneId=cn-qingdao-b
  4. &Size=200
  5. &DiskName=ThisIsDiskName
  6. &Description=ThisIsDescription&
  7. &<公共请求参数>

返回示例

XML格式

  1. <CreateDiskResponse>
  2. <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
  3. </CreateDiskResponse>

JSON格式

  1. {
  2. "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
  3. }
本文导读目录
本文导读目录
以上内容是否对您有帮助?