ディスククローンを使用すると、同じゾーン内のソースディスクと同じデータを持つ新しいディスクをすばやく作成できます。クローン作成されたディスクは、カスタムの容量、タイプ、および暗号化属性をサポートします。クローン作成されたディスクをインスタンスにアタッチした後、ビジネスデータをすばやく複製したり、サービスをスケールアウトしたりできます。
操作説明
ディスククローン機能自体は無料ですが、クローンによって生成された新しいディスクはブロックストレージの課金ルールに基づいて課金されます。課金項目はディスクタイプによって異なり、ディスク容量料金、プロビジョニング済みパフォーマンス料金、バースト機能料金が含まれます。バースト機能料金はバースト発生後に課金されますが、その他の料金はディスクがインスタンスにアタッチされているかどうかに関係なく、ディスク作成後に発生し始めます。
使用上の注意
これは非同期操作です。呼び出しが成功した後、taskGroupId を使用して DescribeTasks 操作を呼び出し、実行結果を照会してください。
特徴
- クローン作成では、ESSD シリーズディスク (cloud_essd、cloud_auto、cloud_essd_entry、cloud_regional_disk_auto) のみをソースとしてサポートし、
新しいディスクも ESSD シリーズのディスクタイプのみとすることができます。非リージョナルディスクは非リージョナルディスクタイプにのみクローン作成できます。リージョナルディスクはリージョナルディスクタイプにのみクローン作成できます。
ローカルディスクおよびエラスティックエフェメラルディスクは、クローン作成やクローンソースとしての使用はできません。
クローン作成時に
新しいディスクのタイプとパフォーマンスレベル (PL) を指定できます。クローン作成時に
新しいディスクの容量を指定できますが、新しいディスクの容量はソースディスクの容量以上である必要があります。送信先ディスクタイプがプロビジョニング済みパフォーマンスとバースト機能をサポートしている場合、
新しいディスクに対してプロビジョニング済みパフォーマンスとバースト機能を設定できます。新しいディスクに対して暗号化を指定したり、暗号鍵を変更したりできます。ソースディスクが暗号化されている場合、暗号化されていないディスクにクローン作成することはできませんが、暗号鍵を変更することは可能です。サブスクリプションディスクを
ソースディスクとして使用できます。サブスクリプションディスクが期限切れの場合でも、ソースディスクとして使用できます。クローン作成された
新しいディスクは再初期化をサポートしません。クローン作成はストレージセットまたは専用ブロックストレージクラスターをサポートしません。ただし、これらのリソース内のディスクを
ソースディスクとして使用することはできます。クローン作成されたディスクはストレージセットまたは専用ブロックストレージクラスターには配置されません。ソースディスクのステータス制限:ソースディスクのステータスが [使用中] で、関連付けられたインスタンスステータスが [実行中] または [停止] であること。ソースディスクのステータスが [利用可能] で、かつ過去にアタッチされたことがあること。スペック変更中のディスクは
ソースディスクとして使用できません。拡張中のディスクは
ソースディスクとして使用できません。
インスタンスの休止状態シナリオでは、ディスククローンはサポートされません。ディスクが休止状態のインスタンス上にある場合、そのディスクを
ソースディスクとして使用することはできません。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
ecs:CloneDisks |
create |
*Disk
*Disk
|
なし | なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| 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。タグキーを空文字列にすることはできません。タグキーの長さは最大 128 文字で、aliyun または acs: で始まることはできません。タグキーに http:// または https:// を含めることはできません。 |
TestKey |
| Value |
string |
任意 |
ディスクのタグ値。N の有効な値: 1~20。タグ値は空文字列にすることができます。タグ値の長さは最大 128 文字で、http:// または https:// を含めることはできません。 |
TestValue |
| ResourceGroupId |
string |
任意 |
ディスクが属するリソースグループの ID。 |
rg-bp199lyny9b3**** |
| SourceDiskId |
string |
必須 |
ソースディスクの ID。 |
d-bp1d6tsvznfghy7y**** |
| DiskName |
string |
任意 |
ディスクの名前。名前の長さは 2~128 文字で、英字、数字、コロン (:)、アンダースコア (_)、ピリオド (.)、ハイフン (-) を含めることができます。名前は英字で始める必要があります。 デフォルト値: 空。 |
MyDiskName |
| DiskCategory |
string |
必須 |
新しいディスクのカテゴリ。有効な値:
説明
ディスククローンのディスクカテゴリ制限:
|
cloud_essd |
| PerformanceLevel |
string |
任意 |
新しい標準 SSD のパフォーマンスレベル (PL)。有効な値:
説明
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 |
任意 |
新しいディスクのバースト機能を有効にするかどうかを指定します。有効な値:
説明
このパラメーターは、DiskCategory が cloud_auto に設定されている場合にのみサポートされます。詳細については、「ESSD AutoPL ディスク」を参照してください。 |
true |
| Encrypted |
boolean |
任意 |
新しいディスクが暗号化されているかどうかを指定します。有効な値:
デフォルト値: false。 |
false |
| KmsKeyId |
string |
任意 |
新しいディスクで使用される KMS キーのキー ID。 |
key-szz67b2f696f4wh9yeg5d |
| Arn |
array<object> |
任意 |
説明
このパラメーターは公開されていません。 |
|
|
object |
任意 |
説明
このパラメーターは公開されていません。 |
||
| RoleType |
string |
任意 |
説明
このパラメーターは公開されていません。 |
null |
| Rolearn |
string |
任意 |
説明
このパラメーターは公開されていません。 |
null |
| AssumeRoleFor |
string |
任意 |
説明
このパラメーターは公開されていません。 |
null |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
レスポンスのスキーマ。 |
||
| RequestId |
string |
リクエスト ID |
473469C7-AA6F-4DC5-B3DB-A3DC0DE3**** |
| TaskGroupId |
string |
ディスククロンタスクのタスクグループ ID。 DescribeTasks を呼び出してタスク実行結果を照会できます。 |
g-2ze2op2grqpclwu7**** |
例
成功レスポンス
JSONJSON
{
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
"TaskGroupId": "g-2ze2op2grqpclwu7****"
}
エラーコード
|
HTTP ステータスコード |
エラーコード |
エラーメッセージ |
説明 |
|---|---|---|---|
| 400 | InvalidDiskCategory.SourceDiskCategoryNotSupport | The specified target disk category %s does not support cloning 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 has an invalid status. The expected status is Available or In_use; but the current status is %s. | |
| 400 | InvalidDiskCategory.ValueNotSupported | The specified parameter "DiskCategory" is not valid. | 指定されたシステムディスクタイプおよびデータディスクタイプはサポートされていません。 |
| 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 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. | ドライランチェックに合格しました。リクエストは有効です。 |
| 400 | InvalidSourceDisk.Lazyloading | The specified source disk %s is lazyloading. | |
| 400 | InvalidOperation.DiskCloneExceedsConcurrencyLimit | The source disk %s has reached the maximum number (1) of concurrent clone operations. In-progress cloned disks: %s. Please wait a moment and try again later. | |
| 400 | InvalidParameter.Arns | The specified Arns is not valid. | Arns パラメーターが無効です。パラメーターを確認して、もう一度お試しください。 |
| 400 | InvalidOperation.DiskTypeUnsupported | The specified source disk "%s" does not support cloning. Please select a different source disk. | |
| 401 | InvalidOperation.UserNotInWhiteList | The specified user %s is not in the CloneDisks whitelist. | |
| 403 | OperationDenied.NotInArnsWhitelist | The current account is not authorized for this operation. Please check the ARNS whitelist configuration. | |
| 404 | InvalidRegionId.NotFound | The specified region does not exist. | 指定された RegionId が存在しません。このリージョンでプロダクトが利用可能かどうかを確認してください。 |
| 404 | InvalidSourceDiskId.NotFound | The specified source disk does not exist. |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。