ディスクのスナップショットを作成します。
操作説明
従来のローカルスナップショットは、スナップショット即時アクセスに置き換えられました。パラメーターの説明は次のとおりです。
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"}} が含まれている場合、すべての操作が禁止されています。
-
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
ecs:CreateSnapshot |
create |
*Disk
*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 |
任意 |
スナップショットタイプ。有効な値:
説明
[非推奨] このパラメーターは非推奨になります。ESSD ディスクの標準スナップショット (標準 SSD とは異なる) は、デフォルトでスナップショット即時アクセス にアップグレードされました。追加の構成は不要で、追加コストも発生しません。 |
Standard |
| ClientToken |
string |
任意 |
リクエストのべき等性を確保するために使用されるクライアントトークン。クライアントからパラメーター値を生成して、異なるリクエスト間で値が一意になるようにすることができます。ClientToken パラメーターは ASCII 文字のみをサポートし、長さは 64 文字を超えることはできません。詳細については、「べき等性の確保」を参照してください。 |
123e4567-e89b-12d3-a456-426655440000 |
| ResourceGroupId |
string |
任意 |
スナップショットが属するリソースグループの ID。 |
rg-bp67acfmxazb4p**** |
| InstantAccess |
boolean |
任意 |
スナップショット即時アクセスの特徴を有効にするかどうかを指定します。有効な値:
デフォルト値: false。 説明
[非推奨] このパラメーターは非推奨です。ESSD ディスクの標準スナップショット (標準 SSD とは異なる) は、デフォルトでスナップショット即時アクセス にアップグレードされました。追加の構成は不要で、追加コストも発生しません。 |
false |
| InstantAccessRetentionDays |
integer |
任意 |
スナップショット即時アクセスの特徴の保持期間を指定します。保持期間の経過後、スナップショットは自動的にリリースされます。このパラメーターは、 デフォルト値: 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. | レコードにリソースグループが見つかりません。 |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。