Amazon Elastic Compute Cloud
User Guide (API Version 2013-02-01)
« PreviousNext »
View the PDF for this guide.Go to the AWS Discussion Forum for this product.Go to the Kindle Store to download this guide in Kindle format.Did this page help you?  Yes | No |  Tell us about it...

Describing Snapshots

This section describes how to view snapshots that you created.

AWS Management Console

To describe snapshots

  1. Open the Amazon EC2 console at https://console.aws.amazon.com/ec2/.

  2. Click Snapshots in the navigation pane.

    The console displays a list of all snapshots to which you have access and their status.

  3. To reduce the list, select an option from the Viewing list box. For example, to view only your snapshots, select Owned by Me.

    The console displays a new list of snapshots.

  4. To view more information about a snapshot, select it.

    Information about the snapshot appears in the lower pane.

Command Line Interface

To describe snapshots, use the ec2-describe-snapshots command.

PROMPT>  ec2-describe-snapshots snap-78a54011

Amazon EC2 returns information about the snapshot.

SNAPSHOT snap-78a54011 vol-4d826724 pending 2008-02-15T09:03:58+0000   60% 

If the snapshot is in the process of being created, the status is pending and a percentage complete is displayed (e.g., 60%). After the snapshot is complete, its status changes to completed.

Tip

If you have a large number of snapshots, you can use ec2-describe-snapshots to filter the results to only the snapshots that match the criteria you specify.

API

To describe snapshots, use the DescribeSnapshots action. Construct the following request.

https://ec2.amazonaws.com/
?Action=DescribeSnapshots
&SnapshotId=snapshot-id
&AUTHPARAMS

The following is an example response.

<DescribeSnapshotsResponse xmlns="http://ec2.amazonaws.com/doc/2013-02-01/">
  <requestId>26245bae-2c70-4846-82d3-65784e298820</requestId>
  <snapshotSet>
      <item>
         <snapshotId>snap-05b4aa6c</snapshotId>
         <volumeId>vol-d11fbbb8</volumeId>
         <status>completed</status>
         <startTime>2010-03-23T09:43:52.000Z</startTime>
         <progress>100%</progress>
         <ownerId>999988887777</ownerId>
         <volumeSize>20</volumeSize>
         <description/>
      </item>
  </snapshotSet>
</DescribeSnapshotsResponse>

Tip

If you have a large number of snapshots, you can use DescribeSnapshots to filter the list to only the snapshots that match criteria you specify.