建立一塊隨用隨付資料盤。磁碟類型包括普通雲端硬碟、高效雲端硬碟和SSD雲端硬碟。

描述

  • 建立磁碟會涉及到資源計費，您需要提前瞭解Elastic Compute Service 的計費方式。更多詳情，請參閱 隨用隨付（PostPaid）。

  • 建立磁碟時，預設在刪除磁碟時刪除其自動快照，即 DeleteAutoSnapshot 取值為 true，可以通過 ModifyDiskAttribute 修改該參數。

  • 建立的磁碟預設 Portable 屬性為 true，收費方式預設為為隨用隨付。

  • 必須指定一項請求參數 Size 或 SnapshotId。請求參數 Size 指定磁碟容量大小，請求參數 SnapshotId 使用快照建立磁碟。

請求參數

名稱 類型 是否必需 描述
Action String 是 系統規定參數。取值：CreateDisk
RegionId String 是 執行個體所屬的地區 ID。您可以調用 DescribeRegions 查看最新的阿里雲地區列表。
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 否 用於保證請求的等冪性。由用戶端產生該參數值，要保證在不同請求間唯一。只支援 ASCII 字元，且不能超過 64 個字元。更多詳情，請參閱 如何保證等冪性。

返回參數

名稱 類型 描述
DiskId String 磁碟 ID

樣本

請求樣本 
https://ecs.aliyuncs.com/?Action=CreateDisk
&RegionId=cn-qingdao
&ZoneId=cn-qingdao-b
&Size=200
&DiskName=ThisIsDiskName
&Description=ThisIsDescription
&<公用請求參數>
返回樣本

XML 格式

<CreateDiskResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
    <DiskId>d-bp131n0q38u3a4ziXXXXX</DiskId>
</CreateDiskResponse>
JSON 格式 
{
    "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
    "DiskId": "d-bp131n0q38u3a4ziXXXXX"
}

錯誤碼

以下為本介面特有的錯誤碼。更多錯誤碼，請訪問 API 錯誤中心。

錯誤碼 錯誤資訊 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 所選擇的地區 不支援加密特性。
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 不存在。