全部產品
Search
文件中心

Elastic Compute Service:CloneDisks - 雲端硬碟複製

更新時間:Apr 04, 2026

通過雲端硬碟複製可以快速在同一可用性區域複製出一塊與來源硬碟相同資料的新雲端硬碟。複製出的新雲端硬碟支援自訂容量、類型和加密屬性,掛載至執行個體後,可實現業務資料的快速複製或服務的橫向擴充。

介面說明

說明

雲端硬碟複製功能本身不收費,但複製產生的新雲端硬碟將按照Block Storage計費規則收取費用。雲端硬碟的計費項目因類型而異,包括雲端硬碟容量費用、預配置效能費用及效能突發費用。除效能突發費用在突發後計費外,其他費用在建立後即開始計費,無論是否掛載至執行個體。

使用方式

  • 該介面為非同步介面,調用成功後請使用 taskGroupId 並調用 DescribeTasks 介面擷取執行結果

功能特性

  • 複製僅支援從 ESSD 全系雲端硬碟(cloud_essd、cloud_auto、cloud_essd_entry、cloud_regional_disk_auto)直接複製新雲端硬碟,複製出的新雲端硬碟僅支援 ESSD 全系雲端硬碟類型
    • 非同城冗餘雲端硬碟僅能複製至非同城冗餘類型,同城冗餘雲端硬碟僅能複製至同城冗餘雲端硬碟

    • 本地碟、彈性臨時盤既不支援複製,也不支援被複製

  • 複製可以指定新雲端硬碟類型以及效能等級

  • 複製可以指定新雲端硬碟容量,但新雲端硬碟容量需要大於等於源雲端硬碟

  • 複製可以配置新雲端硬碟的預置效能、效能突發,前提是目標磁碟類型需要支援預置、效能突發

  • 複製可以為新雲端硬碟指定加密以及更換加密金鑰。若源雲端硬碟為加密盤,無法複製出非加密雲端硬碟,但可以更換加密金鑰

  • 複製可以使用訂用帳戶的雲端硬碟作為源雲端硬碟,即使訂用帳戶的雲端硬碟到期,也可以作為源雲端硬碟

  • 複製出的新雲端硬碟不支援重新初始化

  • 複製不支援儲存集、專屬儲存叢集,但是其中的盤可以作為源雲端硬碟,複製出的盤將不會在儲存集、專屬儲存叢集內

  • 源雲端硬碟狀態限制
    • 源雲端硬碟狀態為“使用中”,且對應執行個體狀態為“運行中”或者“已關機”

    • 源雲端硬碟狀態為“待掛載”,且雲端硬碟曾經被掛載過

    • 變更配置期間的磁碟不支援作為源雲端硬碟

    • 擴容期間的磁碟不支援作為源雲端硬碟

  • 執行個體休眠情境不支援雲端硬碟複製,即如果盤在休眠執行個體上,那麼不允許作為源雲端硬碟

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

當前API暫無授權資訊透出。

請求參數

名稱

類型

必填

描述

樣本值

RegionId

string

所屬的地區 ID。您可以調用 DescribeRegions 查看最新的阿里雲地區列表。

cn-hangzhou

DryRun

string

是否只預檢此次請求。取值範圍:

  • true:發送檢查請求,不會查詢報備單狀況。檢查項包括 AccessKey 是否有效、RAM 使用者的授權情況和是否填寫了必需參數。如果檢查不通過,則返回對應錯誤。如果檢查通過,會返回錯誤碼 DryRunOperation。

  • false(預設值):發送正常請求,通過檢查後返回 2XX HTTP 狀態代碼並直接查詢報備單狀況。

true

ClientToken

string

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

123e4567-e89b-12d3-a456-426655440000

Tag

array<object>

磁碟的標籤資訊列表。

object

磁碟的標籤資訊列表。

Key

string

磁碟的標籤鍵。N 的取值範圍:1~20。一旦傳入 Tag.N.Key 值,則不允許為空白字串。最多支援 128 個字元,不能以 aliyun 和 acs:開頭,不能包含 http://或者 https://。

TestKey

Value

string

磁碟的標籤值。N 的取值範圍:1~20。一旦傳入 Tag.N.Value 值,可以為空白字串。最多支援 128 個字元,不能包含 http://或者 https://。

TestValue

ResourceGroupId

string

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

rg-bp199lyny9b3****

SourceDiskId

string

源磁碟 ID

d-bp1d6tsvznfghy7y****

DiskName

string

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

預設值:空。

MyDiskName

DiskCategory

string

新磁碟的磁碟類型。取值範圍:

  • cloud_essd:ESSD 雲端硬碟。

  • cloud_auto:ESSD AutoPL 雲端硬碟。

  • cloud_essd_entry:ESSD Entry 雲端硬碟。

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

說明

雲端硬碟複製的磁碟類型限制

  • 非同城冗餘類型的雲端硬碟,僅能複製成非同城冗餘類型

  • 同城冗餘類型的雲端硬碟,僅能複製成同城冗餘類型

cloud_essd

PerformanceLevel

string

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

  • PL0:單盤最高隨機讀寫 IOPS 1 萬。

  • PL1:單盤最高隨機讀寫 IOPS 5 萬。

  • PL2:單盤最高隨機讀寫 IOPS 10 萬。

  • PL3:單盤最高隨機讀寫 IOPS 100 萬。

說明

如果 DiskCategory = cloud_essd,則 PerformanceLevel 是必傳值

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

PL1

Size

integer

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

  • cloud_essd:具體取值範圍與
    • 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。

60

MultiAttach

string

新磁碟是否開啟多重掛載特性。取值範圍:

  • Disabled: 不開啟。

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

Disabled

ProvisionedIops

integer

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}。

說明

當 DiskCategory = cloud_auto 時才支援設定該參數。更多資訊,請參見 ESSD AutoPL 雲端硬碟

10

BurstingEnabled

boolean

新磁碟是否開啟 Burst(效能突發)。取值範圍:

  • true:是。

  • false:否。

說明

當 DiskCategory = cloud_auto 時才支援設定該參數。更多資訊,請參見 ESSD AutoPL 雲端硬碟

true

Encrypted

boolean

新磁碟是否是加密雲端硬碟。取值範圍:

  • true:是。

  • false:否。

預設值:false。

false

KmsKeyId

string

新磁碟使用的 KMS 金鑰識別碼。

key-szz67b2f696f4wh9yeg5d

Arn

array<object>

說明

該參數暫未開放使用

object

說明

該參數暫未開放使用

RoleType

string

說明

該參數暫未開放使用

null

Rolearn

string

說明

該參數暫未開放使用

null

AssumeRoleFor

string

說明

該參數暫未開放使用

null

返回參數

名稱

類型

描述

樣本值

object

Schema of Response

RequestId

string

請求 ID

473469C7-AA6F-4DC5-B3DB-A3DC0DE3****

TaskGroupId

string

雲端硬碟複製的工作群組 ID,您可以通過 DescribeTasks 查詢任務執行結果

g-2ze2op2grqpclwu7****

樣本

正常返回樣本

JSON格式

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "TaskGroupId": "g-2ze2op2grqpclwu7****"
}

錯誤碼

HTTP status code

錯誤碼

錯誤資訊

描述

400 InvalidDiskCategory.SourceDiskCategoryNotSupport The specified target disk category %s is not support clone from origin disk category %s.
400 InvalidDisk.NeverAttached The specified disk %s has been never attached to any instance.
400 InvalidStatus.SourceDiskStatusViolation The specified disk %s status error, want Available or In_use, but %s.
400 InvalidDiskCategory.ValueNotSupported The specified parameter "DiskCategory" is not valid. 指定的參數雲端硬碟類型DiskCategory無效。
400 InvalidDiskName.ValueNotSupported The specified parameter "DiskName" is not valid.
400 InvalidPerformanceLevel.ValueNotSupported The specified parameter "PerformanceLevel" is not valid.
400 InvalidMultiAttach.ValueNotSupported The specified parameter "MultiAttach" is not valid.
400 InvalidBurstingEnabled.DiskCategoryNotSupported The specified disk category does not support bursting enabled.
400 InvalidProvisionedIops.DiskCategoryNotSupported The specified disk category does not support provisioned IOPS.
400 InvalidProvisionedIops.LimitExceed The provisioned IOPS exceeds the permitted range limit for the specified disk category
400 InvalidSize.MustGreaterThanSourceDisk The specified size %s(GB) must greater than source disk size %s(GB).
400 DryRunOperation Request validation has been passed with DryRun flag set. 通過“DryRun”校正,您的請求已通過驗證。
400 InvalidSourceDisk.Lazyloading The specified source disk %s is lazyloading.
400 InvalidParameter.Arns The specified Arns is not valid. 該Arns參數無效,請檢查後重新傳遞。
401 InvalidOperation.UserNotInWhiteList The specified user %s is not in the CloneDisks whitelist.
404 InvalidRegionId.NotFound The specified region does not exist. 指定的 RegionId 不存在,請您檢查此產品在該地區是否可用。
404 InvalidSourceDiskId.NotFound The specified source disk does not exist.

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情