通過雲端硬碟複製可以快速在同一可用性區域複製出一塊與來源硬碟相同資料的新雲端硬碟。複製出的新雲端硬碟支援自訂容量、類型和加密屬性,掛載至執行個體後,可實現業務資料的快速複製或服務的橫向擴充。
介面說明
雲端硬碟複製功能本身不收費,但複製產生的新雲端硬碟將按照Block Storage計費規則收取費用。雲端硬碟的計費項目因類型而異,包括雲端硬碟容量費用、預配置效能費用及效能突發費用。除效能突發費用在突發後計費外,其他費用在建立後即開始計費,無論是否掛載至執行個體。
使用方式
該介面為非同步介面,調用成功後請使用 taskGroupId 並調用 DescribeTasks 介面擷取執行結果
功能特性
- 複製僅支援從 ESSD 全系雲端硬碟(cloud_essd、cloud_auto、cloud_essd_entry、cloud_regional_disk_auto)直接複製
新雲端硬碟,複製出的新雲端硬碟僅支援 ESSD 全系雲端硬碟類型非同城冗餘雲端硬碟僅能複製至非同城冗餘類型,同城冗餘雲端硬碟僅能複製至同城冗餘雲端硬碟
本地碟、彈性臨時盤既不支援複製,也不支援被複製
複製可以指定
新雲端硬碟類型以及效能等級複製可以指定
新雲端硬碟容量,但新雲端硬碟容量需要大於等於源雲端硬碟複製可以配置
新雲端硬碟的預置效能、效能突發,前提是目標磁碟類型需要支援預置、效能突發複製可以為
新雲端硬碟指定加密以及更換加密金鑰。若源雲端硬碟為加密盤,無法複製出非加密雲端硬碟,但可以更換加密金鑰複製可以使用訂用帳戶的雲端硬碟作為
源雲端硬碟,即使訂用帳戶的雲端硬碟到期,也可以作為源雲端硬碟複製出的
新雲端硬碟不支援重新初始化複製不支援儲存集、專屬儲存叢集,但是其中的盤可以作為
源雲端硬碟,複製出的盤將不會在儲存集、專屬儲存叢集內源雲端硬碟狀態限制源雲端硬碟狀態為“使用中”,且對應執行個體狀態為“運行中”或者“已關機”源雲端硬碟狀態為“待掛載”,且雲端硬碟曾經被掛載過變更配置期間的磁碟不支援作為
源雲端硬碟擴容期間的磁碟不支援作為
源雲端硬碟
執行個體休眠情境不支援雲端硬碟複製,即如果盤在休眠執行個體上,那麼不允許作為
源雲端硬碟
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| RegionId |
string |
是 |
所屬的地區 ID。您可以調用 DescribeRegions 查看最新的阿里雲地區列表。 |
cn-hangzhou |
| DryRun |
string |
否 |
是否只預檢此次請求。取值範圍:
|
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 |
| PerformanceLevel |
string |
否 |
建立一塊 ESSD 雲端硬碟時,設定雲端硬碟的效能等級。取值範圍:
說明
如果 DiskCategory = cloud_essd,則 PerformanceLevel 是必傳值 有關如何選擇 ESSD 效能等級,請參見 ESSD 雲端硬碟。 |
PL1 |
| Size |
integer |
是 |
新磁碟容量大小。單位:GiB。您必須為該參數傳入參數值。取值範圍:
|
60 |
| MultiAttach |
string |
是 |
新磁碟是否開啟多重掛載特性。取值範圍:
|
Disabled |
| ProvisionedIops |
integer |
否 |
ESSD AutoPL 雲端硬碟(單盤)預配置效能的讀寫 IOPS。可能值:
基準效能=max{min{1,800+50*容量,50,000}, 3,000}。 說明
當 DiskCategory = cloud_auto 時才支援設定該參數。更多資訊,請參見 ESSD AutoPL 雲端硬碟。 |
10 |
| BurstingEnabled |
boolean |
否 |
新磁碟是否開啟 Burst(效能突發)。取值範圍:
說明
當 DiskCategory = cloud_auto 時才支援設定該參數。更多資訊,請參見 ESSD AutoPL 雲端硬碟。 |
true |
| Encrypted |
boolean |
否 |
新磁碟是否是加密雲端硬碟。取值範圍:
預設值: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. |
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊,參考變更詳情。