接口说明
-
创建磁盘时支持开启多重挂载特性（
MultiAttach）。建议您先了解该特性及使用限制，更多信息，请参见ESSD 云盘支持 NVMe以及使用多重挂载功能。 -
支持创建的磁盘类型：普通云盘、高效云盘、SSD 云盘、ESSD 云盘、ESSD Entry 云盘、ESSD 同城冗余、ESSD AutoPL 云盘、弹性临时盘-标准版和弹性临时盘-高级版。
-
创建磁盘需要通过实名认证。请前往会员信息实名认证。
-
创建磁盘会涉及到资源计费，建议您提前了解云服务器 ECS 的计费方式。更多信息，请参见计费概述。
-
创建磁盘时，默认设置：
- 删除磁盘时删除其自动快照，即
DeleteAutoSnapshot取值为true。您可以调用 DescribeDisks 查询该参数配置，调用 ModifyDiskAttribute 修改该参数。 - 创建 ESSD 云盘时，如果您不设置磁盘性能等级，默认为 PL1 等级。您可以通过 ModifyDiskSpec 修改磁盘性能等级。
- 计费方式为按量付费，即默认
Portable属性为true。
- 删除磁盘时删除其自动快照，即
流控信息
授权信息
当前云产品暂无权限信息透出。
请求参数
| 字段名称 | 字段详情 |
|---|---|
RegionIdstring | 所属的地域 ID。您可以调用 DescribeRegions 查看最新的阿里云地域列表。 示例值:cn-hangzhou参考取值来源: DescribeRegions |
ZoneIdstring | 在指定可用区内创建一块按量付费磁盘。展开详情 示例值:cn-hangzhou-g参考取值来源: DescribeZones |
SnapshotIdstring | 创建云盘使用的快照 ID。2013 年 7 月 15 日及以前的快照不能用来创建云盘。 展开详情 示例值:s-bp67acfmxazb4p****参考取值来源: CopySnapshot CreateSnapshot DescribeSnapshots |
DiskNamestring | 磁盘名称。长度为 2~128 个字符，支持 Unicode 中 letter 分类下的字符（其中包括英文、中文等），ASCII 数字（0-9）。可以包含半角冒号（:）、下划线（_）、半角句号（.）或者短划线（-）。必须以 Unicode 中 letter 分类下的字符开头。展开详情 示例值:testDiskName参考取值来源: DescribeDisks |
Sizeinteger<int32> | 容量大小。单位：GiB。您必须为该参数传入参数值。取值范围：展开详情 示例值:2000取值 <= 65536 |
DiskCategorystring | 数据盘的磁盘种类。取值范围：展开详情 示例值:cloud_ssd |
Descriptionstring | 磁盘描述。长度为 2~256 个英文或中文字符，不能以 示例值:testDescription |
Encryptedboolean | 是否加密云盘。取值范围：展开详情 示例值:false |
ClientTokenstring | 保证请求幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。ClientToken 只支持 ASCII 字符，且不能超过 64 个字符。更多信息，请参见如何保证幂等性。 示例值:123e4567-e89b-12d3-a456-426655440000 |
InstanceIdstring | 创建一块包年包月磁盘，并自动挂载到指定的包年包月实例（InstanceId）上。展开详情 示例值:i-bp18pnlg1ds9rky4****参考取值来源: RunInstances StopInstances CreateInstance StartInstances RebootInstances DescribeInstances ModifyManagedInstance RenewReservedInstances AttachInstanceRamRole DetachInstanceRamRole DeregisterManagedInstance PurchaseReservedInstancesOffering |
ResourceGroupIdstring | 磁盘所在的企业资源组 ID。 示例值:rg-bp67acfmxazb4p****参考取值来源: DescribeSecurityGroups |
KMSKeyIdstring | 云盘使用的 KMS 密钥 ID。 示例值:0e478b7a-4262-4802-b8cb-00d3fb40826X参考取值来源: DescribeDiskDefaultKMSKeyId |
PerformanceLevelstring | 创建一块 ESSD 云盘时，设置云盘的性能等级。取值范围：展开详情 示例值:PL1 |
AdvancedFeaturesstring | 该参数暂未开放使用。 示例值:hide |
StorageSetIdstring | 存储集 ID。展开详情 示例值:ss-bp67acfmxazb4p**** |
EncryptAlgorithmstring | 该参数暂未开放使用。 示例值:hide |
StorageSetPartitionNumberinteger<int32> | 存储集分区数。取值范围：大于等于 2，最高不能超过调用 DescribeAccountAttributes 后显示的权益配额限制。展开详情 示例值:3取值 >= 1 |
StorageClusterIdstring | 专属块存储集群 ID。如果您需要在指定的专属块存储集群中创建云盘，请指定该参数。展开详情 示例值:dbsc-j5e1sf2vaf5he8m2**** |
MultiAttachstring | 是否开启多重挂载特性。取值范围：展开详情 示例值:Disabled |
Tagarray<object> | 磁盘的标签信息列表。 子级条数 <= 20 |
Arnarray<object> | 说明
该参数暂未开放使用。
子级条数 <= 10 |
ProvisionedIopsinteger<int64> | ESSD AutoPL 云盘预配置的读写 IOPS。可能值：0~min{50,000, 1000*容量-基准性能}。展开详情 注意
该字段类型为 Long，在序列化/反序列化的过程中可能导致精度丢失，请注意数值不得大于 9007199254740991。 示例值:40000取值 >= 0 |
BurstingEnabledboolean | 是否开启 Burst（性能突发）。取值范围：展开详情 示例值:false |
返回参数
| 字段名称 | 字段详情 |
|---|---|
DiskIdstring | 磁盘 ID。 示例值:d-bp131n0q38u3a4zi**** |
RequestIdstring | 请求 ID。 示例值:473469C7-AA6F-4DC5-B3DB-A3DC0DE3**** |
OrderIdstring | 生成的订单 ID。展开详情 示例值:20413515388**** |