すべてのプロダクト
Search
ドキュメントセンター

Elastic Compute Service:CloneDisks

最終更新日:Sep 02, 2026

ディスククローンを使用すると、同じゾーン内のソースディスクと同じデータを持つ新しいディスクをすばやく作成できます。クローン作成されたディスクは、カスタムの容量、タイプ、および暗号化属性をサポートします。クローン作成されたディスクをインスタンスにアタッチした後、ビジネスデータをすばやく複製したり、サービスをスケールアウトしたりできます。

操作説明

説明

ディスククローン機能自体は無料ですが、クローンによって生成された新しいディスクはブロックストレージの課金ルールに基づいて課金されます。課金項目はディスクタイプによって異なり、ディスク容量料金、プロビジョニング済みパフォーマンス料金、バースト機能料金が含まれます。バースト機能料金はバースト発生後に課金されますが、その他の料金はディスクがインスタンスにアタッチされているかどうかに関係なく、ディスク作成後に発生し始めます。

使用上の注意

  • これは非同期操作です。呼び出しが成功した後、taskGroupId を使用して DescribeTasks 操作を呼び出し、実行結果を照会してください。

特徴

  • クローン作成では、ESSD シリーズディスク (cloud_essd、cloud_auto、cloud_essd_entry、cloud_regional_disk_auto) のみをソースとしてサポートし、新しいディスクも ESSD シリーズのディスクタイプのみとすることができます。
    • 非リージョナルディスクは非リージョナルディスクタイプにのみクローン作成できます。リージョナルディスクはリージョナルディスクタイプにのみクローン作成できます。

    • ローカルディスクおよびエラスティックエフェメラルディスクは、クローン作成やクローンソースとしての使用はできません。

  • クローン作成時に新しいディスクのタイプとパフォーマンスレベル (PL) を指定できます。

  • クローン作成時に新しいディスクの容量を指定できますが、新しいディスクの容量はソースディスクの容量以上である必要があります。

  • 送信先ディスクタイプがプロビジョニング済みパフォーマンスとバースト機能をサポートしている場合、新しいディスクに対してプロビジョニング済みパフォーマンスとバースト機能を設定できます。

  • 新しいディスクに対して暗号化を指定したり、暗号鍵を変更したりできます。ソースディスクが暗号化されている場合、暗号化されていないディスクにクローン作成することはできませんが、暗号鍵を変更することは可能です。

  • サブスクリプションディスクをソースディスクとして使用できます。サブスクリプションディスクが期限切れの場合でも、ソースディスクとして使用できます。

  • クローン作成された新しいディスクは再初期化をサポートしません。

  • クローン作成はストレージセットまたは専用ブロックストレージクラスターをサポートしません。ただし、これらのリソース内のディスクをソースディスクとして使用することはできます。クローン作成されたディスクはストレージセットまたは専用ブロックストレージクラスターには配置されません。

  • ソースディスクのステータス制限:
    • ソースディスクのステータスが [使用中] で、関連付けられたインスタンスステータスが [実行中] または [停止] であること。

    • ソースディスクのステータスが [利用可能] で、かつ過去にアタッチされたことがあること。

    • スペック変更中のディスクはソースディスクとして使用できません。

    • 拡張中のディスクはソースディスクとして使用できません。

  • インスタンスの休止状態シナリオでは、ディスククローンはサポートされません。ディスクが休止状態のインスタンス上にある場合、そのディスクをソースディスクとして使用することはできません。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

  • アクション:特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

  • API:アクションを具体的に実行するための API。

  • アクセスレベル:各 API に対して事前定義されているアクセスの種類。有効な値:create、list、get、update、delete。

  • リソースタイプ:アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

    • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

    • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

  • 条件キー:サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

  • 依存アクション:ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

ecs:CloneDisks

create

*Disk

acs:ecs:{#regionId}:{#accountId}:disk/{#SourceDiskId}

*Disk

acs:ecs:{#regionId}:{#accountId}:disk/*

なし なし

リクエストパラメーター

パラメーター

型

必須 / 任意

説明

例

RegionId

string

必須

リージョン ID。 DescribeRegions を呼び出して最新のリージョンリストを照会できます。

cn-hangzhou

DryRun

string

任意

実際のリクエストを実行せずにドライランのみを実行するかどうかを指定します。有効な値:

  • true: ファイリングステータスを照会せずにチェックリクエストを送信します。チェック項目には、AccessKey ペアが有効かどうか、Resource Access Management (RAM) ユーザーに必要な権限付与が付与されているかどうか、必須のパラメーターが指定されているかどうかが含まれます。チェックが失敗した場合、対応するエラーメッセージが返されます。チェックが成功した場合、DryRunOperation エラーコードが返されます。

  • false (デフォルト): Normal リクエストを送信します。チェックが成功した後、2XX HTTP ステータスコードが返され、ファイリングステータスが直接照会されます。

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: ESSD (エンタープライズ SSD)。

  • cloud_auto: ESSD AutoPL ディスク。

  • cloud_essd_entry: ESSD Entry ディスク。

  • cloud_regional_disk_auto: リージョナル ESSD。

説明

ディスククローンのディスクカテゴリ制限:

  • 非リージョナルディスクは非リージョナルディスクタイプにのみクローン作成できます。

  • リージョナルディスクはリージョナルディスクタイプにのみクローン作成できます。

cloud_essd

PerformanceLevel

string

任意

新しい標準 SSD のパフォーマンスレベル (PL)。有効な値:

  • PL0: 単一ディスクで最大 10,000 のランダム読み取り/書き込み IOPS を配信できます。

  • PL1: 単一ディスクで最大 50,000 のランダム読み取り/書き込み IOPS を配信できます。

  • PL2: 単一ディスクで最大 100,000 のランダム読み取り/書き込み IOPS を配信できます。

  • PL3: 単一ディスクで最大 1,000,000 のランダム読み取り/書き込み IOPS を配信できます。

説明

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: マルチアタッチ属性を有効にします。このパラメーターを Enabled に設定できるのは ESSD (エンタープライズ SSD) のみです。

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

任意

新しいディスクのバースト機能を有効にするかどうかを指定します。有効な値:

  • true: バースト機能を有効にします。

  • false: バースト機能を有効にしません。

説明

このパラメーターは、DiskCategory が cloud_auto に設定されている場合にのみサポートされます。詳細については、「ESSD AutoPL ディスク」を参照してください。

true

Encrypted

boolean

任意

新しいディスクが暗号化されているかどうかを指定します。有効な値:

  • true: 新しいディスクは暗号化されています。

  • false: 新しいディスクは暗号化されていません。

デフォルト値: 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.

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。