Creates a snapshot of an EBS volume and stores it in Amazon S3. You can use snapshots for backups, to make copies of EBS volumes, and to save data before shutting down an instance.
When a snapshot is created, any AWS Marketplace product codes that are associated with the source volume are propagated to the snapshot.
You can take a snapshot of an attached volume that is in use. However, snapshots only capture
data that has been written to your EBS volume at the time the snapshot command is issued; this
may exclude any data that has been cached by any applications or the operating system. If you
can pause any file systems on the volume long enough to take a snapshot, your snapshot should
be complete. However, if you cannot pause all file writes to the volume, you should unmount
the volume from within the instance, issue the snapshot command, and then remount the volume
to ensure a consistent and complete snapshot. You may remount and use your volume while the
snapshot status is
To create a snapshot for EBS volumes that serve as root devices, you should stop the instance before taking the snapshot.
Snapshots that are taken from encrypted volumes are automatically encrypted. Volumes that are created from encrypted snapshots are also automatically encrypted. Your encrypted volumes and any associated snapshots always remain protected.
The following parameters are for this specific action. For more information about required and optional parameters that are common to all actions, see Common Query Parameters.
A description for the snapshot.
Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is
DryRunOperation. Otherwise, it is
The ID of the EBS volume.
The following elements are returned by the service.
The data encryption key identifier for the snapshot. This value is a unique identifier that corresponds to the data encryption key that was used to encrypt the original volume or snapshot copy. Because data encryption keys are inherited by volumes created from snapshots, and vice versa, if snapshots share the same data encryption key identifier, then they belong to the same volume/snapshot lineage. This parameter is only returned by the DescribeSnapshots API operation.
The description for the snapshot.
Indicates whether the snapshot is encrypted.
The full ARN of the AWS Key Management Service (AWS KMS) customer master key (CMK) that was used to protect the volume encryption key for the parent volume.
Value from an Amazon-maintained list (
microsoft) of snapshot owners. Not to be confused with the user-configured AWS account alias, which is set from the IAM console.
The AWS account ID of the EBS snapshot owner.
The progress of the snapshot, as a percentage.
The ID of the request.
The ID of the snapshot. Each snapshot receives a unique identifier when it is created.
The time stamp when the snapshot was initiated.
The snapshot state.
pending | completed | error
Encrypted Amazon EBS snapshots are copied asynchronously. If a snapshot copy operation fails (for example, if the proper AWS Key Management Service (AWS KMS) permissions are not obtained) this field displays error state details to help you diagnose why the error occurred. This parameter is only returned by the DescribeSnapshots API operation.
Any tags assigned to the snapshot.
Type: array of Tag objects
The ID of the volume that was used to create the snapshot. Snapshots created by the CopySnapshot action have an arbitrary volume ID that should not be used for any purpose.
The size of the volume, in GiB.
For information about the errors that are common to all actions, see Common Errors.
This example creates a snapshot of the volume with the ID
https://ec2.amazonaws.com/?Action=CreateSnapshot &VolumeId=vol-1234567890abcdef0 &Description=Daily+Backup &AUTHPARAMS
<CreateSnapshotResponse xmlns="http://ec2.amazonaws.com/doc/2016-11-15/"> <requestId>59dbff89-35bd-4eac-99ed-be587EXAMPLE</requestId> <snapshotId>snap-1234567890abcdef0</snapshotId> <volumeId>vol-1234567890abcdef0</volumeId> <status>pending</status> <startTime>YYYY-MM-DDTHH:MM:SS.000Z</startTime> <progress>60%</progress> <ownerId>111122223333</ownerId> <volumeSize>30</volumeSize> <description>Daily Backup</description> </CreateSnapshotResponse>
For more information about using this API in one of the language-specific AWS SDKs, see the following: