| « PreviousNext » | |
  | Did this page help you? Yes | No | Tell us about it... |
ec2-create-snapshot
Description
Creates a snapshot of an Amazon EBS volume and stores it in Amazon S3. You can use snapshots for backups, to make copies of instance store volumes, and to save data before shutting down an instance. For more information about Amazon EBS, see Amazon Elastic Block Store in the Amazon Elastic Compute Cloud User Guide.
When a snapshot is created, any AWS Marketplace product codes from the 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 Amazon 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 writes to 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 need to unmount the volume from within the instance, issue the snapshot command, and then remount the volume to ensure a consistent and complete snapshot.
To create a snapshot for Amazon EBS volumes that serve as root devices, you should stop the instance before taking the snapshot.
To unmount the volume in Linux/UNIX
Enter the following command from the command line.
umount -d
device_nameFor example:
#umount -d /dev/sdh
To unmount the volume in Windows
In Disk Management, right-click the volume to unmount, and select Change Drive Letter and Path.
Select the mount point to remove and click Remove.
The short version of this command is ec2addsnap.
Syntax
ec2-create-snapshot
volume_id [-d
description]
Options
| Name | Description |
|---|---|
|
|
The ID of the Amazon EBS volume to take a snapshot of. Type: String Default: None Required: Yes Example: vol-4d826724 |
|
|
The description of the Amazon EBS snapshot. Type: String Default: None Constraints: Up to 255 characters Required: No Example: -d "Daily backup" |
Common Options
| Option | Description |
|---|---|
|
|
Overrides the region specified by the Default: The value of the Example: |
|
|
The uniform resource locator (URL) of the Amazon EC2 web service entry point. Default: The value of the Example: |
|
|
The private key that identifies you to Amazon EC2. For more information, see Tell the Tools Who You Are. Default: The value of the Example: |
|
|
The X.509 certificate that identifies you to Amazon EC2. Default: The value of the Example: |
|
|
The access key ID associated with your AWS account. For more information, see Tell the Tools Who You Are. Default: The value of the Example: Note For more information, see the following section, Deprecated Options. |
|
|
The secret access key associated with your AWS account. Default: The value of the Example: Note For more information, see the following section, Deprecated Options. |
|
|
The AWS delegation token. Default: The value of the environment variable (if set). |
|
|
The connection timeout, in seconds. Example: |
|
|
The request timeout, in seconds. Example: |
|
|
Displays verbose output, including the API request and response on the command line. This is useful if you are building tools to talk directly to our Query API. |
|
|
Includes column headers in the command output. |
|
|
Shows empty columns as |
|
|
Omits tags for tagged resources. |
|
|
Displays internal debugging information. This can assist us when helping you troubleshooting problems. |
|
|
Displays usage information for the command. |
|
|
Reads arguments from standard input. This is useful when piping the output from one command to the input of another. Example: |
Deprecated Options
For a limited time, you can still use the private key and X.509 certificate instead of your access key ID and secret access key. However, we recommend that you start using your access key ID (-O, --aws-access-key) and secret access key (-W, --aws-secret-key) now, as the private key (-K, --private-key) and X.509 certificate (-C, --cert) won't be supported after the transition period elapses. For more information, see Tell the Tools Who You Are.
| Option | Description |
|---|---|
|
|
The private key to use when constructing requests to Amazon EC2. Default: The value of the Example: |
|
|
The X.509 certificate to use when constructing requests to Amazon EC2. Default: The value of the Example: |
Output
This command returns a table that contains the following information:
The SNAPSHOT identifier
The ID of the snapshot
The ID of the volume
The state of the snapshot (
pending,completed,error)The time stamp when the snapshot initiated
The percentage of completion
The ID of the snapshot owner
The size of the volume
The description of the snapshot
Amazon EC2 command line tools display errors on stderr.
Examples
Example Request
This example creates a snapshot of volume vol-1a2b3c4d.
PROMPT>ec2-create-snapshot vol-1a2b3c4d --description "Daily Backup"SNAPSHOT snap-1a2b3c4d vol-1a2b3c4d pending YYYY-MM-DDTHH:MM:SS+0000 111122223333 30 Daily Backup
