调用CreateDisk创建一块按量付费或包年包月数据盘。
接口说明
- 创建云盘时支持开启多重挂载特性(
MultiAttach
)。建议您先了解该特性及使用限制,更多信息,请参见ESSD云盘支持NVMe以及使用多重挂载功能。 - 支持创建的云盘类型:普通云盘、高效云盘、SSD云盘、ESSD云盘和ESSD AutoPL云盘。
- 创建云盘需要通过实名认证。请前往会员信息中实名认证。
- 创建云盘会涉及到资源计费,建议您提前了解云服务器ECS的计费方式。更多信息,请参见计费概述。
- 创建云盘时,默认在删除云盘时删除其自动快照,即
DeleteAutoSnapshot
取值为true
。您可以通过ModifyDiskAttribute修改该参数。 - 创建ESSD云盘时,如果您不设置云盘性能等级,默认为PL1等级。您可以通过ModifyDiskSpec修改云盘性能等级。
- 创建的云盘默认的计费方式为按量付费,即默认
Portable
属性为true
。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 |
类型 |
是否必选 |
示例值 |
描述 |
Action | String | 是 | CreateDisk |
系统规定参数。取值:CreateDisk。 |
RegionId | String | 是 | cn-hangzhou |
所属的地域ID。您可以调用DescribeRegions查看最新的阿里云地域列表。 |
ZoneId | String | 否 | cn-hangzhou-g |
在指定可用区内创建一块按量付费云盘。
|
SnapshotId | String | 否 | s-bp67acfmxazb4p**** |
创建云盘使用的快照。2013年7月15日及以前的快照不能用来创建云盘。
|
DiskName | String | 否 | testDiskName |
云盘名称。长度为2~128个英文或中文字符。必须以大小写字母或中文开头,不能以 默认值:空。 |
Size | Integer | 否 | 2000 |
容量大小。单位:GiB。您必须为该参数传入参数值。取值范围:
如果您指定了
|
DiskCategory | String | 否 | cloud_ssd |
数据盘的云盘种类。取值范围:
默认值:cloud。 |
Description | String | 否 | testDescription |
云盘描述。长度为2~256个英文或中文字符,不能以 默认值:空。 |
Encrypted | Boolean | 否 | false |
是否加密云盘。取值范围:
默认值:false。 |
ClientToken | String | 否 | 123e4567-e89b-12d3-a456-426655440000 |
保证请求幂等性。从您的客户端生成一个参数值,确保不同请求间该参数值唯一。ClientToken只支持ASCII字符,且不能超过64个字符。更多信息,请参见如何保证幂等性。 |
InstanceId | String | 否 | i-bp18pnlg1ds9rky4**** |
创建一块包年包月云盘,并自动挂载到指定的包年包月实例(InstanceId)上。
默认值:空,代表创建的是按量付费云盘,云盘所属地由RegionId和ZoneId确定。 |
ResourceGroupId | String | 否 | rg-bp67acfmxazb4p**** |
云盘所在的企业资源组ID。 |
KMSKeyId | String | 否 | 0e478b7a-4262-4802-b8cb-00d3fb40826X |
云盘使用的KMS密钥ID。 |
PerformanceLevel | String | 否 | PL1 |
创建一块ESSD云盘时,设置云盘的性能等级。取值范围:
默认值:PL1。 有关如何选择ESSD性能等级,请参见ESSD云盘。 |
AdvancedFeatures | String | 否 | hide |
该参数暂未开放使用。 |
StorageSetId | String | 否 | ss-bp67acfmxazb4p**** |
存储集ID。 说明 存储集相关参数( |
EncryptAlgorithm | String | 否 | hide | 该参数暂未开放使用。 |
StorageSetPartitionNumber | Integer | 否 | 3 |
存储集分区数。取值范围:大于等于2,最高不能超过调用DescribeAccountAttributes后显示的权益配额限制。 默认值:2。 |
StorageClusterId | String | 否 | dbsc-j5e1sf2vaf5he8m2**** |
专属块存储集群ID。如果您需要在指定的专属块存储集群中创建云盘,请指定该参数。 说明 存储集相关参数( |
MultiAttach | String | 否 | Disabled | 是否开启多重挂载特性。取值范围:
默认值:Disabled。 说明 开启多重挂载特性的云盘只支持按量付费的计费方式。因此 |
Tag.N.key | String | 否 | Test | 云盘的标签键。 说明 为提高代码兼容性,请尽量使用Tag.N.Key参数。 |
Tag.N.Key | String | 否 | TestKey | 云盘的标签键。N的取值范围:1~20。一旦传入Tag.N.Key值,则不允许为空字符串。最多支持128个字符,不能以 |
Tag.N.Value | String | 否 | TestValue |
云盘的标签值。N的取值范围:1~20。一旦传入Tag.N.Value值,可以为空字符串。最多支持128个字符,不能以 |
Tag.N.value | String | 否 | Test |
云盘的标签值。 说明 为提高代码兼容性,请尽量使用Tag.N.Value参数。 |
Arn.N.RoleType | String | 否 | hide | 该参数暂未开放使用。 |
Arn.N.Rolearn | String | 否 | hide |
该参数暂未开放使用。 |
Arn.N.AssumeRoleFor | Long | 否 | 1000000000 |
该参数暂未开放使用。 |
ProvisionedIops | Long | 否 | 40000 |
ESSD AutoPL云盘预配置的读写IOPS。可能值:0~min{50,000, 1000*容量-基准性能}。 基准性能=min{1,800+50*容量, 50000}。 说明 当DiskCategory取值为cloud_auto时才支持设置该参数。更多信息,请参见ESSD AutoPL云盘。 |
BurstingEnabled | Boolean | 否 | false | 是否开启Burst(性能突发)。取值范围:
说明 当DiskCategory取值为cloud_auto时才支持设置该参数。更多信息,请参见ESSD AutoPL云盘。 |
返回数据
名称 |
类型 |
示例值 |
描述 |
DiskId | String | d-bp131n0q38u3a4zi**** |
云盘ID。 |
RequestId | String | 473469C7-AA6F-4DC5-B3DB-A3DC0DE3**** |
请求ID。 |
OrderId | String | 20413515388**** |
生成的订单ID。 说明 仅在创建包年包月云盘时会返回订单ID。 |
示例
请求示例
https://ecs.aliyuncs.com/?Action=CreateDisk
&RegionId=cn-hangzhou
&ZoneId=cn-hangzhou-g
&SnapshotId=s-bp67acfmxazb4p****
&DiskName=testDiskName
&Size=2000
&DiskCategory=cloud_ssd
&Description=testDescription
&Encrypted=false
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&Tag.1.Key=TestKey
&Tag.1.Value=TestValue
&
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
473469C7-AA6F-4DC5-B3DB-A3DC0DE3****
d-bp131n0q38u3a4zi****
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
"DiskId" : "d-bp131n0q38u3a4zi****"
}
错误码
HttpCode |
错误码 |
错误信息 |
描述 |
400 | InvalidSize.ValueNotSupported | The specified parameter Size is not valid. | 指定的 Size 不合法。 |
400 | InvalidDiskName.Malformed | The specified disk name is wrongly formed. | 磁盘名称格式不正确。长度为2-128个字符,以英文字母或中文开头,可包含数字,点号(.),下划线(_)或连字符(-)。 不能以http://和https://开头。 |
400 | InvalidDescription.Malformed | The specified description is wrongly formed. | 指定的资源描述格式不合法。长度为 2-256 个字符,不能以 http:// 和 https:// 开头。 |
400 | InvalidDiskCategory.NotSupported | The specified disk category is not support. | 不支持的磁盘种类。 |
400 | Account.Arrearage | Your account has an outstanding payment. | 您的账号存在未支付的款项。 |
400 | InvalidDataDiskCategory.ValueNotSupported | %s | 指定的数据磁盘类型无效。%s为变量,将根据调用API的实际情况动态返回错误信息。 |
400 | InvalidParameter.Conflict | %s | 您输入的参数无效,请检查参数之间是否冲突。%s为变量,将根据调用API的实际情况动态返回错误信息。 |
400 | RegionUnauthorized | %s | 该地域未被授权。%s为变量,将根据调用API的实际情况动态返回错误信息。 |
400 | Zone.NotOnSale | %s | 该可用区暂时关闭了售卖。%s为变量,将根据调用API的实际情况动态返回错误信息。 |
400 | InvalidDataDiskSize.ValueNotSupported | %s | 指定的数据盘容量无效。%s为变量,将根据调用API的实际情况动态返回错误信息。 |
400 | OperationDenied | The specified Zone is not available or not authorized. | 指定的可用区不可用或未授权。 |
400 | InvalidDiskSize.NotSupported | The specified parameter size is not valid. | 指定的磁盘容量无效。 |
400 | InvalidDiskSizeOrCategory | The specified disk category or size is invalid. | 指定的磁盘类别或大小无效。 |
400 | InvalidParameter.EncryptedIllegal | %s | 您输入的参数无效,请确认您的加密是否合法。%s为变量,将根据调用 API 的实际情况动态返回错误信息。 |
400 | InvalidParameter.EncryptedNotSupported | %s | 您输入的参数无效,暂时不支持您的加密操作。%s为变量,将根据调用API的实际情况动态返回错误信息。 |
400 | EncryptedOption.Conflict | %s | 参数不支持(加密盘)。%s为变量,将根据调用API的实际情况动态返回错误信息。 |
400 | InvalidParameter.EncryptedIllegal | The specified parameter Encrypted must be true when kmsKeyId is not empty. | 设置参数 KMSKeyId 后,您必须开启加密属性。 |
400 | Duplicate.TagKey | The Tag.N.Key contain duplicate key. | 标签中存在重复的键,请保持键的唯一性。 |
400 | InvalidTagKey.Malformed | The specified Tag.n.Key is not valid. | 指定的标签键参数有误。 |
400 | InvalidTagValue.Malformed | The specified Tag.n.Value is not valid. | 指定的标签值参数有误。 |
400 | InvalidPerformanceLevel.Malformed | The specified parameter PerformanceLevel is not valid. | 指定的参数 PerformanceLevel 无效。 |
400 | InvalidStorageClusterId.CapacityNotEnough | The remaining capacity of the current dedicated storage cluster is less than the size of disk. | 磁盘所在专属存储集群的可用容量不足 |
400 | InvalidInstance.NotFoundSystemDisk | The specified instance has no system disk. | 指定的实例没有挂载系统盘。请确保指定的实例已挂载了系统盘。您可以调用 DescribeInstances 查询指定实例的信息。 |
400 | ProvisionedIopsForDiskCategoryUnsupported | The specified disk category does not support provisioned iops. | 指定的磁盘类型不支持预配置IOPS。 |
400 | BurstingEnabledForDiskCategoryUnsupported | The specified disk category does not support bursting enabled. | 指定的磁盘类型不支持开启性能突发特性。 |
400 | BurstingEnabledForMultiAttachDiskUnsupported | The multi attach disk does not support bursting enabled. | 多重挂载磁盘不支持开启性能突发特性。 |
400 | ProvisionedIopsForDiskCategoryRequired | The provisioned iops is required for this disk category. | 这种类型的磁盘必须传入预配置IOPS。 |
400 | NotSupportSnapshotEncrypted.ShareImage | Shared snapshot creating encrypted disks with native snapshot encrypt is not supported. | 不支持共享镜像原生加密创盘 |
400 | NotSupportSnapshotEncrypted.DiskCategory | The specified disk category does not support creating encrypted disks with native snapshot encrypt. | 该磁盘类型不支持快照原生加密方式创盘 |
400 | QuotaExceed.DiskCapacity | The used capacity of disk type has exceeded the quota in the zone, %s. | 指定磁盘类型的已用容量超出可用区配额限制,您可以前往配额中心查询和申请提升磁盘容量配额。 |
400 | InsufficientBalance.AgentAccount | The account balance is insufficient. Please contact your channel partner to recharge in time. | 您的渠道合作伙伴的账号可用金额不足,请联系您的渠道合作伙伴及时充值。 |
400 | InvalidAccountStatus.NotEnoughBalance | Your account does not have enough balance, please contact your partner to increase your account balance. | 您的账户可用金不足,请联系您的渠道伙伴为您增加账户可用金。 |
403 | InvalidDataDiskCategory.NotSupported | Specified disk category is not supported. | 不支持指定的磁盘种类。 |
403 | InstanceDiskCategoryLimitExceed | The total size of specified disk category in an instance exceeds. | 磁盘种类总容量超过实例限制。 |
403 | InvalidSnapshot.NotReady | The specified snapshot creation is not completed yet. | 指定快照未创建。 |
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. | 指定快照不支持创建磁盘。 |
403 | QuotaExceed.PortableCloudDisk | The quota of portable cloud disk exceeds. | 可卸载磁盘数量已达上限。 |
403 | 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 | 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 | 指定的数据磁盘类型无效。%s为变量,将根据调用API的实际情况动态返回错误信息。 |
403 | InvalidDiskSize.NotSupported | Disk size is not supported. | 磁盘大小不合法。 |
403 | InvalidAccountStatus.NotEnoughBalance | Your account does not have enough balance. | 账号余额不足,请您先充值再进行该操作。 |
403 | InvalidAccountStatus.SnapshotServiceUnavailable | Snapshot service has not been opened yet. | 快照服务未开通,操作无法执行。 |
403 | InvalidPayMethod | The specified pay method is not valid. | 没有可用的付费方式。 |
403 | InvalidDiskCategory.NotSupported | The specified disk category is not supported. | 指定的云盘类型不支持当前操作。 |
403 | InvalidDiskSize.NotSupported | The specified disk size is not supported. | 暂不支持您设置的磁盘容量。 |
403 | UserNotInTheWhiteList | The user is not in disk white list. | 您不在磁盘白名单中,请加入白名单后重试。 |
403 | QuotaExceed.PostPaidDisk | Living postPaid disks quota exceeded. | 按量付费磁盘数量已超出允许数量。 |
403 | InvalidRegion.NotSupport | The specified region does not support byok. | 该地域不支持BYOK。 |
403 | UserNotInTheWhiteList | The user is not in byok white list. | 您不在byok白名单中,请加入白名单后重试。 |
403 | InvalidParameter.KMSKeyId.CMKNotEnabled | The CMK needs to be enabled. | 加密云盘设置了 KMSKeyId 后,CMK必须处于启用状态。您可以调用密钥管理服务的 DescribeKey 接口查询指定CMK的相关信息。 |
403 | InvalidParameter.KMSKeyId.CMKUnauthorized | The CMK needs to be added ECS tag. | CMK 未授权 |
403 | InvalidParameter.KMSKeyId.KMSUnauthorized | ECS service have no right to access your KMS. | ECS 服务无权访问您的 KMS。 |
403 | SecurityRisk.3DVerification | We have detected a security risk with your default credit or debit card. Please proceed with verification via the link in your email. | 我们检测到您的默认信用卡或借记卡存在安全风险。请通过电子邮件中的链接进行验证。 |
403 | InvalidStatus.Upgrading | The instance is upgrading; please try again later. | 实例正在升级,请稍后重试。 |
403 | QuotaExceed.Tags | %s | 标签数超过可以配置的最大数量。%s为变量,将根据调用API的实际情况动态返回错误信息。 |
403 | QuotaExceeded.PostpaidDataDiskCapacity | The quota of postpaid data disk capacity exceeds. | 按量付费数据盘使用容量超出配额。 |
403 | OperationDenied.SnapshotNotAllowed | The specified snapshot is not allowed to create disk. | 指定的快照不支持创建磁盘。 |
403 | LastTokenProcessing | The last token request is processing. | 正在处理上一条令牌请求,请您稍后再试。 |
403 | InvalidParameter.MultiAttach | The specified param MultiAttach is not valid. | MultiAttach 参数的取值有误。 |
403 | InvalidParameter.MultiAttachAndInstanceIdConflict | The parameter MultiAttach and InstanceId are conflict. | 不支持同时设置 MultiAttach 参数和 InstanceId 参数。 |
403 | InvalidParameter.DiskCategoryAndMultiAttachConflict | The specified disk category does not support multi attach set. | 共享块存储不支持设置 MultiAttach 参数。 |
403 | InvalidParameter.DiskCategoryAndMultiAttachNotMatch | The specified disk category does not support multi attach enabled. | 要创建的云盘类型不支持开启多重挂载。 |
403 | OperationDenied.ZoneNotSupportMultiAttachDisk | The specified zone does support multi attach disk. | 指定的可用区不支持创建开启多重挂载特性的云盘。 |
403 | InvalidAccountStatus.CouponAmountNotEnough | Your coupon balance is insufficient or has expired. | 代金券余额不足或已过期。 |
403 | InvalidOperation.CreateFromSnapshotUnsupported | The elastic ephemeral disk cannot be created from snapshot. | 弹性临时盘不支持通过快照创建。 |
404 | InvalidRegionId.NotFound | The specified RegionId does not exist. | 指定的地域 ID 不存在。 |
404 | InvalidZoneId.NotFound | The specified zone does not exist. | 指定的可用区 ID 不存在。 |
404 | InvalidSnapshotId.NotFound | The specified SnapshotId does not exist. | 指定的快照不存在,请您检查快照是否正确。 |
404 | InvalidResourceGroup.NotFound | The ResourceGroup provided does not exist in our records. | 资源组并不在记录中。 |
404 | InvalidParameter.KMSKeyId.NotFound | The specified KMSKeyId does not exist. | 指定的参数 KMSKeyId 不存在。 |
404 | InvalidInstanceId.NotFound | The InstanceId provided does not exist in our records. | 指定的实例不存在,请您检查实例 ID 是否正确。 |
500 | InternalError | The request processing has failed due to some unknown error. | 内部错误,请重试。 |
500 | InternalError | The request processing has failed due to some unknown error, exception or failure. | 内部错误,请重试。 |
访问错误中心查看更多错误码。
关于阿里云ecs服务器的内容没看懂? 不太想学习?想快速解决? 有偿解决: 联系专家
阿里云企业补贴进行中: 马上申请
腾讯云限时活动1折起,即将结束: 马上收藏
同尘科技为腾讯云授权服务中心。
购买腾讯云产品享受折上折,更有现金返利:同意关联,立享优惠
本文来自投稿,不代表新手站长_郑州云淘科技有限公司立场,如若转载,请注明出处:https://www.cnzhanzhang.com/9607.html