阿里云服务器CreateDisk-[云淘科技_教程]

调用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

在指定可用区内创建一块按量付费云盘。

  • 如果您不设置InstanceId,则ZoneId为必填参数。
  • 您不能同时指定ZoneId和InstanceId。
SnapshotId String s-bp67acfmxazb4p****

创建云盘使用的快照。2013年7月15日及以前的快照不能用来创建云盘。

SnapshotId参数和Size参数存在以下限制:

  • 如果SnapshotId参数对应的快照容量大于设置的Size参数值,实际创建的云盘大小为指定快照的大小。
  • 如果SnapshotId参数对应的快照容量小于设置的Size参数值,实际创建的云盘大小为指定的Size参数值。
DiskName String testDiskName

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

默认值:空。

Size Integer 2000

容量大小。单位:GiB。您必须为该参数传入参数值。取值范围:

  • cloud:5~2,000。
  • cloud_efficiency:20~32,768。
  • cloud_ssd:20~32,768。
  • cloud_essd:具体取值范围与PerformanceLevel的取值有关。
    • PL0:40~32,768。
    • PL1:20~32,768。
    • PL2:461~32,768。
    • PL3:1,261~32,768。
  • cloud_auto:40~32,768。
  • cloud_essd_entry:10~32,768。

如果您指定了SnapshotId参数,SnapshotId参数和Size参数存在以下限制:

  • 如果SnapshotId参数对应的快照容量大于设置的Size参数值,实际创建的云盘大小为指定快照的大小。
  • 如果SnapshotId参数对应的快照容量小于设置的Size参数值,实际创建的云盘大小为指定的Size参数值。
DiskCategory String cloud_ssd

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

  • cloud:普通云盘。
  • cloud_efficiency:高效云盘。
  • cloud_ssd:SSD云盘。
  • cloud_essd:ESSD云盘。
  • cloud_auto:ESSD AutoPL云盘。
  • cloud_essd_entry:ESSD Entry云盘。

默认值:cloud。

Description String testDescription

云盘描述。长度为2~256个英文或中文字符,不能以http://https://开头。

默认值:空。

Encrypted Boolean false

是否加密云盘。取值范围:

  • true:是。
  • false:否。

默认值:false。

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

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

InstanceId String i-bp18pnlg1ds9rky4****

创建一块包年包月云盘,并自动挂载到指定的包年包月实例(InstanceId)上。

  • 设置实例ID后,会忽略您设置的ResourceGroupId、Tag.N.Key、Tag.N.Value、ClientToken和KMSKeyId参数。
  • 您不能同时指定ZoneId和InstanceId。

默认值:空,代表创建的是按量付费云盘,云盘所属地由RegionId和ZoneId确定。

ResourceGroupId String rg-bp67acfmxazb4p****

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

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

云盘使用的KMS密钥ID。

PerformanceLevel String PL1

创建一块ESSD云盘时,设置云盘的性能等级。取值范围:

  • PL0:单盘最高随机读写IOPS 1万。
  • PL1:单盘最高随机读写IOPS 5万。
  • PL2:单盘最高随机读写IOPS 10万。
  • PL3:单盘最高随机读写IOPS 100万。

默认值:PL1。

有关如何选择ESSD性能等级,请参见ESSD云盘。

AdvancedFeatures String hide

该参数暂未开放使用。

StorageSetId String ss-bp67acfmxazb4p****

存储集ID。

说明 存储集相关参数(StorageSetIdStorageSetPartitionNumber)与专属块存储集群参数(StorageClusterId)只能选择其中之一设置。如果同时设置,那么调用接口将会失败。

EncryptAlgorithmStringhide

该参数暂未开放使用。

StorageSetPartitionNumber Integer 3

存储集分区数。取值范围:大于等于2,最高不能超过调用DescribeAccountAttributes后显示的权益配额限制。

默认值:2。

StorageClusterId String dbsc-j5e1sf2vaf5he8m2****

专属块存储集群ID。如果您需要在指定的专属块存储集群中创建云盘,请指定该参数。

说明 存储集相关参数(StorageSetIdStorageSetPartitionNumber)与专属块存储集群参数(StorageClusterId)只能选择其中之一设置。如果同时设置,那么调用接口将会失败。

MultiAttachStringDisabled

是否开启多重挂载特性。取值范围:

  • Disabled: 不开启。
  • Enabled : 开启。目前仅ESSD云盘支持设置为Enabled

默认值:Disabled。

说明 开启多重挂载特性的云盘只支持按量付费的计费方式。因此MultiAttach=Enabled 时,不能同时设置InstanceId参数。您可以在创建云盘后调用AttachDisk进行挂载,但需要注意开启多重挂载功能的云盘只能作为数据盘进行挂载。

Tag.N.keyStringTest

云盘的标签键。

说明 为提高代码兼容性,请尽量使用Tag.N.Key参数。

Tag.N.KeyStringTestKey

云盘的标签键。N的取值范围:1~20。一旦传入Tag.N.Key值,则不允许为空字符串。最多支持128个字符,不能以aliyunacs:开头,不能包含http://或者https://

Tag.N.Value String TestValue

云盘的标签值。N的取值范围:1~20。一旦传入Tag.N.Value值,可以为空字符串。最多支持128个字符,不能以acs:开头,不能包含http://或者https://

Tag.N.value String Test

云盘的标签值。

说明 为提高代码兼容性,请尽量使用Tag.N.Value参数。

Arn.N.RoleTypeStringhide

该参数暂未开放使用。

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云盘。

BurstingEnabledBooleanfalse

是否开启Burst(性能突发)。取值范围:

  • true:是。
  • false:否。

说明 当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折起,即将结束: 马上收藏

同尘科技为腾讯云授权服务中心。

购买腾讯云产品享受折上折,更有现金返利:同意关联,立享优惠

本文来自投稿,不代表新手站长_郑州云淘科技有限公司立场,如若转载,请注明出处:http://www.cnzhanzhang.com/9607.html

(0)
匿名
上一篇 2023年12月15日
下一篇 2023年12月15日

相关推荐

新手站长从“心”出发,感谢16年您始终不离不弃。