CreateDisk

创建一块按量付费数据盘。磁盘类型包括普通云盘、高效云盘和SSD云盘。

接口说明

创建磁盘需要通过实名认证。请前往会员信息中 实名认证。

  • 创建磁盘会涉及到资源计费,建议您提前了解云服务器ECS的计费方式。更多详情,请参阅 计费概述。
  • 创建磁盘时,默认在删除磁盘时删除其自动快照,即DeleteAutoSnapshot取值为true,可以通过 ModifyDiskAttribute修改该参数。
  • 创建的磁盘默认Portable属性为true,计费方式默认为按量付费。
  • 必须指定一项请求参数Size或SnapshotId。请求参数Size指定磁盘容量大小,请求参数SnapshotId使用快照创建磁盘。

调试

前往【API Explorer】在线调试,API Explorer 提供在线调用 API、动态生成 SDK Example 代码和快速检索接口等能力,能显著降低使用云 API 的难度,强烈推荐使用。

请求参数

名称 类型 是否必选 示例值 描述
RegionId String cn-hangzhou

所属的地域ID。您可以调用 DescribeRegions 查看最新的阿里云地域列表。

ZoneId String cn-hangzhou-g

可用区ID。

Action String CreateDisk

系统规定参数。取值:CreateDisk

ClientToken String 123e4567-e89b-12d3-a456-426655440000

保证请求幂等性。从您的客户端生成一个参数值,确保不同请求间该参数值唯一。ClientToken 只支持 ASCII 字符,且不能超过 64 个字符。更多详情,请参阅 如何保证幂等性。

Description String FinanceDisk

磁盘描述。长度为 2~256 个英文或中文字符,不能以 http:// 和 https:// 开头。默认值:空。

DiskCategory String cloud_ssd

数据盘的磁盘种类。取值范围:

  • cloud:普通云盘
  • cloud_efficiency:高效云盘
  • cloud_ssd:SSD 云盘
  • cloud_essd:ESSD 云盘。目前 ESSD 云盘正在火热公测中,仅部分地域下的可用区可以选购。更多详情,请参阅 ESSD 云盘 FAQ。

默认值:cloud

DiskName String FinanceJoshua

磁盘名称。长度为 2~128 个英文或中文字符。必须以大小字母或中文开头,不能以 http:// 和 https:// 开头。可以包含数字、半角冒号(:)、下划线(_)或者连字符(-)。默认值:空。

Encrypted Boolean false

是否加密云盘。默认值:false

KMSKeyId String 0e478b7a-4262-4802-b8cb-00d3fb40826X

磁盘使用的KMS密钥ID。

OwnerAccount String ECSforCloud@Alibaba.com

RAM 用户的账号登录名称。

ResourceGroupId String rg-resourcegroupid1

磁盘所在的企业资源组 ID。

Size Integer 2000

容量大小,以GiB为单位。指定该参数后,其取值必须≥指定快照ID的容量大小。取值范围:

  • cloud:5~2000
  • cloud_efficiency:20~32768
  • cloud_ssd:20~32768
  • cloud_essd:20~32768
SnapshotId String s-snaoshot1

创建磁盘使用的快照。指定该参数后,Size会被忽略,实际创建的磁盘大小为指定快照的大小。2013年7月15日及以前的快照不能用来创建磁盘。

Tag.N.Key String FinanceDept

磁盘的标签键。n 的取值范围为 1~20。一旦传入该值,则不允许为空字符串。最多支持 64 个字符,不能以 aliyun、acs:、http:// 或者 https:// 开头。

Tag.N.Value String FinanceDeptJoshua

磁盘的标签值。n的取值范围为 1~20。一旦传入该值,可以为空字符串。最多支持 128 个字符,不能以 aliyun、acs:、http:// 或者 https:// 开头。

Tag.N.key String FinanceDept

磁盘的标签键。

说明 该参数即将被弃用,为提高兼容性,请尽量使用 Tag.N.Key。

Tag.N.value String FinanceDeptJoshua

磁盘的标签值。

说明 该参数即将被弃用,为提高兼容性,请尽量使用 Tag.N.Value。

返回参数

名称 类型 示例值 描述
DiskId String d-bp131n0q38u3a4ziXXXXX

磁盘ID。

RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

请求 ID。

示例

请求示例


https://ecs.aliyuncs.com/?Action=CreateDisk
&RegionId=cn-hangzhou
&ZoneId=cn-hangzhou-g
&SnapshotId=s-snaoshot1
&DiskName=FinanceJoshua
&Size=2000
&DiskCategory=cloud_ssd
&Description=FinanceDisk
&Encrypted=false
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&Tag.1.value=FinanceDeptJoshua
&Tag.1.key=FinanceDept
&Tag.1.Key=FinanceDept
&Tag.1.Value=FinanceDeptJoshua
&<公共请求参数>

正常返回示例

XML 格式

<CreateDiskResponse>
  <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
  <DiskId>d-bp131n0q38u3a4ziXXXXX</DiskId>
</CreateDiskResponse>

JSON 格式

{
	"RequestId":"473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
	"DiskId":"d-bp131n0q38u3a4ziXXXXX"
}

错误码

HttpCode 错误码 错误信息 描述
403 InvalidDataDiskCategory.NotSupported Specified disk category is not supported. 不支持指定的磁盘种类。
404 InvalidRegionId.NotFound The specified RegionId does not exist. 指定的 RegionId 不存在,请您检查此产品在该地域是否可用。
404 InvalidZoneId.NotFound The specified zone does not exist. 指定的可用区不存在。
403 InvalidSnapshot.TooOld This operation is forbidden because the specified snapshot is created before 2013-07-15. 指定磁盘的源快照创建于2013年7月15日(含)之前,不能重新初始化。
403 InvalidSnapshot.TooLarge The capacity of snapshot exceeds 2000GB. 快照容量超过 2000 GB。
403 OperationDenied The specified snapshot is not allowed to create disk. 指定快照不支持创建磁盘。
400 MissingParameter The input parameter either “SnapshotId” or “Size” should be specified. 参数 SnapshotId 或 Size 至少一项不得为空。
403 InvalidDiskCategory.ValueUnauthorized The disk category is not authorized. 该磁盘种类未经授权。
403 InvalidSnapshotId.NotReady The specified snapshot has not completed yet. 指定的快照未完成。
403 InvalidDiskSize.TooSmall Specified disk size is less than the size of snapshot. 指定的磁盘容量小于快照容量。
403 OperationDenied The type of the disk does not support the operation. 此磁盘种类不支持指定的操作。
403 InvalidDataDiskCategory.NotSupported %s 不支持指定的数据盘类型。
400 Account.Arrearage Your account has an outstanding payment. 账号存在未支付款项。
400 InvalidDiskCategory.ValueNotSupported The specified parameter “DiskCategory” is not valid. 参数 DiskCategory 不合法。
403 InvalidAccountStatus.NotEnoughBalance Your account does not have enough balance. 账号余额不足,请您先充值再进行该操作。
400 InvalidDataDiskCategory.ValueNotSupported %s 参数不支持。
400 InvalidParameter.Conflict %s 参数冲突。
400 InvalidDataDiskSize.ValueNotSupported %s 参数不支持。
400 OperationDenied The specified Zone is not available or not authorized. 指定的可用区不可用或未授权。
403 InvalidDiskCategory.NotSupported The specified disk category is not supported. 该云盘类型不支持。
403 InvalidDiskSize.NotSupported The specified disk size is not supported. 指定的磁盘容量不支持。
400 InvalidDiskSize.NotSupported The specified parameter size is not valid. 指定的容量参数无效。
403 UserNotInTheWhiteList The user is not in disk white list. 您暂时不能使用该磁盘服务。
400 InvalidParameter.EncryptedIllegal %s 参数不支持(加密盘)。
400 InvalidParameter.EncryptedNotSupported %s 参数不支持(加密盘)。
400 EncryptedOption.Conflict %s 参数不支持(加密盘)。
400 InvalidParameter.Encrypted.KmsNotEnabled The encrypted disk need enable KMS 加密磁盘需要启用密钥管理服务。
500 InternalError The request processing has failed due to some unknown error, exception or failure. 发生未知错误。
403 InvalidRegion.NotSupport The specified region does not support byok. 该地域不支持BYOK。
403 UserNotInTheWhiteList The user is not in byok white list. 您暂时不能使用BYOK服务。
400 InvalidParameter.EncryptedIllegal The specified parameter Encrypted must be true when kmsKeyId is not empty. 设置KmsKeyId后,您必须开启加密属性。
404 InvalidParameter.KMSKeyId.NotFound The specified KMSKeyId does not exist. 指定的参数值不存在。
403 InvalidParameter.KMSKeyId.KMSUnauthorized ECS service have no right to access your KMS. ECS未被授权访问您的KMS资源。

查看本产品错误码

发布者:佚, 佚名,转转请注明出处:https://www.cms2.cn/aliyun/1951.html

发表评论

邮箱地址不会被公开。 必填项已用*标注