Elastic Compute Service：CreateDisk

所屬的地域 ID。您可以呼叫 DescribeRegions 查看最新的阿里雲地域列表。

在指定可用區內建立一塊隨用隨付磁碟。

• 如果您不設定 InstanceId，則 ZoneId 為必填參數。

• 您不能同時指定 ZoneId 和 InstanceId。

建立雲端硬碟使用的快照 ID。2013 年 7 月 15 日及以前的快照不能用來建立雲端硬碟。

SnapshotId 參數和 Size 參數存在以下限制：

• 如果 SnapshotId 參數對應的快照容量大於設定的 Size 參數值，實際建立的雲端硬碟大小為指定快照的大小。

• 如果 SnapshotId 參數對應的快照容量小於設定的 Size 參數值，實際建立的雲端硬碟大小為指定的 Size 參數值。

• 不支援使用快照建立彈性臨時碟。

磁碟名稱。長度為 2~128 個字元，支援 Unicode 中 letter 分類下的字元（其中包括英文、中文等），ASCII 數字（0-9）。可以包含半形冒號（:）、底線（_）、半形句號（.）或者連字號（-）。必須以 Unicode 中 letter 分類下的字元開頭。

預設值：空。

容量大小。單位：GiB。您必須為該參數傳入參數值。取值範圍：

• cloud：5~2,000。

• cloud_efficiency：20~32,768。

• cloud_ssd：20~32,768。

• cloud_essd：具體取值範圍與 PerformanceLevel 的取值有關。

  • PL0：1~65,536。

  • PL1：20~65,536。

  • PL2：461~65,536。

  • PL3：1,261~65,536。

• cloud_auto：1~65,536。

• cloud_essd_entry：10~32,768。

• cloud_regional_disk_auto：10~65,536。

• elastic_ephemeral_disk_standard：64～8,192。

• elastic_ephemeral_disk_premium：64～8,192。

如果您指定了 SnapshotId 參數，SnapshotId 參數和 Size 參數存在以下限制：

• 如果 SnapshotId 參數對應的快照容量大於設定的 Size 參數值，實際建立的雲端硬碟大小為指定快照的大小。

• 如果 SnapshotId 參數對應的快照容量小於設定的 Size 參數值，實際建立的雲端硬碟大小為指定的 Size 參數值。

資料磁碟的磁碟種類。取值範圍：

• cloud：普通雲端硬碟。

• cloud_efficiency：高效雲端硬碟。

• cloud_ssd：SSD 雲端硬碟。

• cloud_essd：ESSD 雲端硬碟。

• cloud_auto：ESSD AutoPL 雲端硬碟。

• cloud_essd_entry：ESSD Entry 雲端硬碟。

• cloud_regional_disk_auto：ESSD 同城冗餘雲端硬碟。

• elastic_ephemeral_disk_standard：彈性臨時碟-標準版。

• elastic_ephemeral_disk_premium：彈性臨時碟-進階版。

預設值：cloud。

磁碟描述。長度為 2~256 個英文或中文字元，不能以 http:// 或 https:// 開頭。

預設值：空。

是否加密雲端硬碟。取值範圍：

• true：是。

• false：否。

預設值：false。

保證請求冪等性。從您的用戶端生成一個參數值，確保不同請求間該參數值唯一。ClientToken 只支援 ASCII 字元，且不能超過 64 個字元。更多資訊，請參見如何保證冪等性。

建立一塊包年包月磁碟，並自動掛載到指定的包年包月執行個體（InstanceId）上。

• 設定執行個體 ID 後，會忽略您設定的 ResourceGroupId、Tag.N.Key、Tag.N.Value、ClientToken 和 KMSKeyId 參數。

• 您不能同時指定 ZoneId 和 InstanceId。

預設值：空，代表建立的是隨用隨付雲端硬碟，雲端硬碟所屬地由 RegionId 和 ZoneId 確定。

磁碟所在的企業資源群組 ID。

雲端硬碟使用的 KMS 金鑰 ID。

建立一塊 ESSD 雲端硬碟時，設定雲端硬碟的效能等級。取值範圍：

• PL0：單碟最高隨機讀寫 IOPS 1 萬。

• PL1：單碟最高隨機讀寫 IOPS 5 萬。

• PL2：單碟最高隨機讀寫 IOPS 10 萬。

• PL3：單碟最高隨機讀寫 IOPS 100 萬。

預設值：PL1。

有關如何選擇 ESSD 效能等級，請參見 ESSD 雲端硬碟。

該參數暫未開放使用。

儲存集 ID。

該參數暫未開放使用。

儲存集分割區數。取值範圍：大於等於 2，最高不能超過呼叫 DescribeAccountAttributes 後顯示的權益配額限制。

預設值：2。

專屬區塊儲存叢集 ID。如果您需要在指定的專屬區塊儲存叢集中建立雲端硬碟，請指定該參數。

是否開啟多重掛載特性。取值範圍：

• Disabled: 不開啟。

• Enabled : 開啟。目前僅 ESSD 雲端硬碟支援設定為 Enabled。

預設值：Disabled。

ESSD AutoPL 雲端硬碟（單碟）預配置效能的讀寫 IOPS。可能值：

• 容量（GiB）<=3：不支援設定預配置效能。

• 容量（GiB）>=4：[0，min{(1,000

IOPS/GiB*容量-基準 IOPS)，50,000}]

基準效能=max{min{1,800+50*容量，50,000}, 3,000}。

是否開啟 Burst（效能突發）。取值範圍：

• true：是。

• false：否。