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

Elastic Compute Service:CreateSnapshot

最終更新日:Oct 21, 2026

ディスクのスナップショットを作成します。

操作説明

従来のローカルスナップショットは、スナップショット即時アクセスに置き換えられました。パラメーターの説明は次のとおりです。

  • 2020 年 12 月 14 日より前にローカルスナップショットを使用していた場合は、通常どおり Category パラメーターを使用できます。

  • 2020 年 12 月 14 日より前にローカルスナップショットを使用していなかった場合は、追加の構成は必須ではありません。ESSD (エンタープライズ SSD) シリーズディスク (ESSD、ESSD AutoPL、ESSD Entry、およびリージョン ESSD) に対して作成されたスナップショットは、作成後にデフォルトでスナップショット即時アクセスが有効になり、手動スナップショットと自動スナップショットの両方がサポートされます。スナップショット即時アクセスの特徴に関連する InstantAccess、InstantAccessRetentionDays、および DisableInstantAccess パラメーターは、API 操作では効果がありません。DescribeSnapshots および DescribeSnapshotGroups API 操作では、スナップショットの利用可能なステータスを説明するために Available レスポンスパラメーターが追加されています。

開始する前に:

  • スナップショットの特徴が有効化されていること。詳細については、「スナップショットの有効化」を参照してください。

  • ディスクが 使用中 または 利用可能 な状態であること。状態別の注意事項は次のとおりです。

    • ディスクが 使用中 の状態の場合、インスタンスは 実行中 または 停止 状態である必要があります。

    • ディスクが 利用可能 な状態の場合、そのディスクが以前に ECS インスタンスにアタッチされていたことを確認してください。ECS インスタンスにアタッチされたことのないディスクのスナップショットは作成できません。

    • ディスクを使用して動的拡張ボリュームまたは RAID 配列を作成する場合は、スナップショット整合性グループを使用し、アプリケーション整合性スナップショットを有効にしてデータをバックアップすることを推奨します。スナップショット整合性グループは、ディスクに書き込まれるデータの時系列整合性を確保し、業務システムが複数のディスクにまたがるシナリオでクラッシュ整合性を保証します。詳細については、「スナップショット整合性グループの作成」および「アプリケーション整合性スナップショットの作成」を参照してください。

スナップショットを作成する際は、次の点に注意してください。

  • 業務のピーク時間帯のスナップショット作成は避けてください。スナップショットの作成中、ディスク I/O パフォーマンスは 10% 未満低下し、読み取りと書き込みのパフォーマンスに一時的な瞬間的な低下が発生する場合があります。

  • スナップショットの作成が完了していない場合、そのスナップショットを使用してカスタムイメージ ( CreateImage ) を作成することはできません。

  • スナップショット作成中のディスク操作によって生成された増分データは、スナップショットにバックアップされません。

  • ディスクが ECS インスタンスにアタッチされている場合、スナップショットの作成中に ECS インスタンスの停止や再起動など、インスタンスステータスを変更しないでください。変更すると、スナップショットの作成が失敗します。

  • スナップショットを作成中のディスクは拡張できません。ディスクを拡張する前に、スナップショットの作成が完了するまで待機してください。

  • 期限切れ (Expired) 状態のディスクのスナップショットを作成できます。スナップショットの作成中にディスクの有効期限とリリース時間に達した場合、作成中 (Creating) 状態のスナップショットはディスクのリリース時に削除されます。

  • スナップショットの作成後、システムは各リージョンのスナップショットのサイズに基づいて課金します。詳細については、「スナップショットの課金」を参照してください。

  • 次のシナリオでは、指定されたディスクのスナップショットを作成できません。

    • ディスクに対して保持されている手動スナップショットの数が上限に達している。詳細については、「スナップショットの使用制限」を参照してください。

    • スナップショットの作成には同時実行数の制限があります。制限を超えると作成が失敗します。詳細については、「スナップショットの使用制限」を参照してください。

    • ECS インスタンスの情報をクエリした際、応答に {"OperationLocks": {"LockReason" : "security"}} が含まれている場合、すべての操作が禁止されています。

今すぐお試しください

この 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:CreateSnapshot

create

*Disk

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

*Snapshot

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

なし なし

リクエストパラメーター

パラメーター

型

必須 / 任意

説明

例

DiskId

string

必須

ディスク ID。DescribeDisks 操作を呼び出し、InstanceId パラメーターを使用してインスタンスにアタッチされているディスクをフィルターできます。スナップショットの作成に使用するディスクは、使用中または利用可能な状態である必要があります。利用可能なディスクは、以前に ECS インスタンスにアタッチされている必要があります。

d-bp1s5fnvk4gn2tws0****

SnapshotName

string

任意

スナップショット名。名前は 2~128 文字である必要があります。英字または漢字で始める必要があり、Unicode 文字 (英字および漢字を含む) と ASCII 数字 (0-9) を含めることができます。コロン (:)、アンダースコア (_)、ピリオド (.)、およびハイフン (-) を含めることができます。

説明

http:// または https:// で始めることはできません。自動スナップショットの名前との競合を防ぐため、auto で始めることはできません。

testSnapshotName

Description

string

任意

スナップショットの説明。説明は 2~256 文字である必要があり、http:// または https:// で始めることはできません。

デフォルト値: 空。

testDescription

RetentionDays

integer

任意

スナップショットの保持期間を日数で指定します。有効な値: 1~65536。保持期間の経過後、スナップショットの自動リリースが実行されます。

デフォルト値: 空。空の場合、スナップショットは自動リリースの対象外であることを示します。

30

Category

string

任意

スナップショットタイプ。有効な値:

  • Standard: 標準スナップショット。

  • Flash: ローカルスナップショット。

説明

[非推奨] このパラメーターは非推奨になります。ESSD ディスクの標準スナップショット (標準 SSD とは異なる) は、デフォルトでスナップショット即時アクセス にアップグレードされました。追加の構成は不要で、追加コストも発生しません。

Standard

ClientToken

string

任意

リクエストのべき等性を確保するために使用されるクライアントトークン。クライアントからパラメーター値を生成して、異なるリクエスト間で値が一意になるようにすることができます。ClientToken パラメーターは ASCII 文字のみをサポートし、長さは 64 文字を超えることはできません。詳細については、「べき等性の確保」を参照してください。

123e4567-e89b-12d3-a456-426655440000

ResourceGroupId

string

任意

スナップショットが属するリソースグループの ID。

rg-bp67acfmxazb4p****

InstantAccess

boolean

任意

スナップショット即時アクセスの特徴を有効にするかどうかを指定します。有効な値:

  • true: 特徴を有効にします。この特徴は ESSD ディスク (標準 SSD は除く) のみでサポートされています。

  • false: 特徴を無効にします。標準スナップショットが作成されます。

デフォルト値: false。

説明

[非推奨] このパラメーターは非推奨です。ESSD ディスクの標準スナップショット (標準 SSD とは異なる) は、デフォルトでスナップショット即時アクセス にアップグレードされました。追加の構成は不要で、追加コストも発生しません。

false

InstantAccessRetentionDays

integer

任意

スナップショット即時アクセスの特徴の保持期間を指定します。保持期間の経過後、スナップショットは自動的にリリースされます。このパラメーターは、InstantAccess が true に設定されている場合にのみ効果があります。単位: 日。有効な値: 1~65535。

デフォルト値: RetentionDays パラメーターの値。

説明

[非推奨] このパラメーターは非推奨です。ESSD ディスクの標準スナップショット (標準 SSD とは異なる) は、デフォルトでスナップショット即時アクセス にアップグレードされました。追加の構成は不要で、追加コストも発生しません。

1

Tag

array<object>

任意

タグ。

object

任意

タグ。

Key

string

任意

スナップショットのタグキー。N の有効な値: 1~20。このパラメーターを指定する場合、空文字列にすることはできません。タグキーは最大 128 文字です。aliyun または acs: で始めることはできず、http:// または https:// を含めることはできません。

TestKey

Value

string

任意

スナップショットのタグ値。N の有効な値: 1~20。このパラメーターを指定する場合、空文字列にすることができます。タグ値は最大 128 文字で、http:// または https:// を含めることはできません。

TestValue

key

string

任意

スナップショットのタグキー。

説明

互換性を向上させるため、Tag.N.Key パラメーターの使用を推奨します。

null

value

string

任意

スナップショットのタグ値。

説明

互換性を向上させるため、Tag.N.Value パラメーターの使用を推奨します。

null

StorageLocationArn

string

任意

説明

このパラメーターは使用できません。

null

レスポンスフィールド

フィールド

型

説明

例

object

RequestId

string

リクエスト ID

473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

SnapshotId

string

スナップショット ID。

s-bp17441ohwka0yuh****

例

成功レスポンス

JSONJSON

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "SnapshotId": "s-bp17441ohwka0yuh****"
}

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

400 InvalidParameter.KMSKeyId.NotFound The specified KMSKeyId does not exist. Please verify that the key ID is correct and that the key resides in the current region.
400 InvalidSnapshotName.Malformed The specified SnapshotName is malformed.
400 IncorrectInstanceStatus The current status of the resource does not support this operation. 現在のインスタンスステータスでは、この操作はサポートされていません。
400 DiskCategory.OperationNotSupported The type of the specified disk does not support creating a snapshot. 現在のディスクタイプはこの操作をサポートしていません。
400 Duplicate.TagKey The Tag.N.Key contain duplicate key. タグに重複するキーが存在します。すべてのキーが一意になるようにしてください。
400 InvalidTagKey.Malformed The specified Tag.n.Key is not valid. 指定されたタグキーパラメーターが無効です。
400 InvalidTagValue.Malformed The specified Tag.n.Value is not valid. 指定されたタグ値パラメーターが無効です。
400 InvalidRetentionDays.Malformed The specified RetentionDays is not valid. 指定された保持日数の値は無効です。RetentionDays パラメーター値が正しいかどうかを確認してください。
400 CreateSnapshot.Failed The process of creating snapshot is failed. スナップショットの作成に失敗しました。
400 InvalidOperation.StorageLocationMismatch The specified storageLocation does not match the storage location of the last snapshot for the disk. Ensure the storageLocation is consistent with previous snapshots.
500 InternalError The request processing has failed due to an internal error and you may retry later or contact support with the request ID.
403 Throttling Request was denied due to user flow control. リクエストがスロットルされました。
403 IncorrectDiskStatus.CreatingSnapshot A previous snapshot creation is in process.
403 InstanceLockedForSecurity The disk attached instance is locked due to security.
403 IncorrectDiskStatus.NeverAttached The specified disk has never been attached to any instance.
403 QuotaExceed.Snapshot The snapshot quota exceeds.
403 IncorrectDiskStatus.NeverUsed The specified disk has never been used after creating.
403 CreateSnapshot.Failed The process of creating snapshot is failed.
403 DiskInArrears The specified operation is denied as your disk has expired.
403 DiskId.ValueNotSupported The specified parameter diskid is not supported. 指定されたブロックストレージタイプでは、この操作はサポートされていません。
403 IncorrectDiskStatus The current disk status does not support this operation.
403 InvalidAccountStatus.NotEnoughBalance Your account does not have enough balance.
403 InvalidAccountStatus.SnapshotServiceUnavailable Snapshot service has not been opened yet. スナップショットサービスが有効化されていません。操作を実行できません。
403 IncorrectInstanceStatus The current status of the resource does not support this operation.
403 IncorrectVolumeStatus The current volume status does not support this operation. 現在のステータスでは、この操作はサポートされていません。
403 IdempotentParameterMismatch The specified clientToken is used. リクエストパラメーターが、同じ ClientToken を持つリクエストと一致しません。
403 IncorrectDiskStatus.Invalid The specified disk status is invalid. Restart the instance and try again.
403 IncorrectDiskType.NotSupport The specified device type is not supported. 指定されたディスクのストレージタイプでは、この操作はサポートされていません。
403 IncorrectDiskStatus.Transferring The specified device is transferring. You can retry after the process is finished.
403 InvalidParameter.KMSKeyId.CMKUnauthorized ECS tags must be added to the CMK. ECS タグをカスタマーマスターキー (CMK) に追加する必要があります。
403 InvalidParameter.KMSKeyId.CMKNotEnabled The CMK needs to be enabled.
403 InvalidParameter.KMSKeyId.KMSUnauthorized ECS service does not have permission to access your KMS key. Please verify that the specified KMS key has authorized the ECS service.
403 IdempotentProcessing The previous idempotent request(s) is still processing. 前の冪等リクエストはまだ処理中です。後でもう一度お試しください。
403 InvalidSnapshotCategory.Malformed The specified Category is not valid. 指定されたスナップショットタイプは無効です。Category パラメーター値が正しいかどうかを確認してください。
403 InvalidAction.Unauthorized The specified action is not valid. 指定された操作は無効です。
403 InvalidRegion.NotSupportSnapshotInstantAccessRegion The snapshot InstantAccess is not supported for this region.
403 InvalidCategoryAndInstantAccess.Malformed The snapshot Category and InstantAccess can't be used together.
403 DISK_HAS_CREATING_SNAPSHOT The operation cannot be performed while a snapshot is being created for the disk.
403 HibernationConfigured.InstanceOperationForbidden The operation is not permitted due to limit of the hibernation configured instance. インスタンスが休止状態オプションの有効化に関する要件を満たしていないため、この操作は許可されていません。
403 QuotaExceed.SnapshotQuota The quota is insufficient. Please contact your channel partner to increase the quota.
403 InvalidInstantAccessRetentionDays.Malformed The specified InstantAccessRetentionDays is not valid. 指定された InstantAccessRetentionDays パラメーターの形式が無効です。
403 CloudBoxNotSupportSnapshotWithInstantAccess The specified disk in CloudBox does not support to create a snapshot with InstantAccess. CloudBox のディスクでは、インスタントアクセス特徴を使用したスナップショットの作成はサポートされていません。
403 InvalidOperation.UnfinishedEncryptedSnapshotCopy This disk has unfinished encrypted copy snapshots in the target region. ディスクで暗号化されたスナップショットのコピータスクが実行中です。
403 QuotaExceed.ConcurrentSnapshotQuota The number of snapshots being created for the disk %s has exceeded the concurrent quota (%s). Please wait for the previous snapshots to complete before trying again. このディスクに対して作成中のスナップショットの数が同時実行クォータを超えています。以前のスナップショットの作成が完了するまで待機してから、もう一度お試しください。
403 InvalidClientToken.Malformed The specified clientToken is improperly formatted. It must contain only ASCII characters and must not exceed 64 characters in length. 指定された冪等パラメーターは無効です。
403 InvalidParameter.UnauthorizedStorageLocationArn The operation has failed due to lack of permission for the specified "StorageLocationArn". Please use a resource with appropriate permission for the operation. 指定された StorageLocationArn に十分な権限がないため、操作は失敗した。必須の権限を取得するには、リソースの管理者にお問い合わせください。
403 InvalidStorageLocationArn.Malformed The specified parameter StorageLocationArn is malformed.
403 InvalidStatus.ResourceGroup You cannot perform an operation on a resource group that is being created or deleted. リソースグループの作成中または削除中は、操作が許可されていません。
403 OperationDenied.QuotaExceed The quota of tags on resource is beyond permitted range. リソースタグの数が上限に達しました。
403 Forbidden.InDebt The operation is not allowed because your account has an outstanding balance. Please settle the overdue payment and try again.
403 InvalidOperation.RegionUnsupported Creating snapshots is not supported in the specified region. Please use a region that supports the snapshot feature.
404 InvalidDiskId.NotFound The specified DiskId does not exist. Please verify the disk ID and the current region. 指定されたディスクは存在しません。ディスク ID が正しいことを確認してください。
404 InvalidDescription.Malformed The specified parameter Description is not valid. Please ensure that the description is 2 to 256 characters long and does not start with "http://" or "https://" and try again. 指定されたリソースの説明の形式が無効です。説明は 2 ~ 256 文字で、http:// または https:// で始めることはできません。
404 InvalidInstanceId.NotFound The specified InstanceId does not exist. 指定されたインスタンスが存在しません。インスタンス ID が正しいかどうかを確認してください。
404 InvalidVolumeId.NotFound The specified volume does not exist.
404 InvalidResourceGroup.NotFound The ResourceGroup provided does not exist in our records. レコードにリソースグループが見つかりません。

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

変更履歴

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