DescribeSnapshots
Description
Describes the status of Amazon EBS snapshots. If no snapshots are specified, Amazon EBS returns information about all snapshots owned by the account. For more information about Amazon EBS, go to the
Request Parameters
| Name | Description | Required |
|---|---|---|
|
|
Type: DescribeSnapshotsType Ancestor: None Children: |
|
|
Set of snapshots. Type: DescribeSnapshotsSetType Ancestor: Children: |
|
|
Information for a snapshot. Type: DescribeSnapshotsSetItemType Ancestor: Children: |
|
|
The ID of the Amazon EBS snapshot. Type: xsd:string Default: Describes all snapshots that you own. Ancestor: Children: None |
No |
Response Elements
| Name | Description |
|---|---|
|
|
Type: DescribeSnapshotsResponseType Ancestor: None Children: |
|
The ID of the request. Type: xsd:string Ancestor: Children: None |
|
Snapshot set. Type: DescribeSnapshotsSetResponseType Ancestor: Children: |
|
Information for a snapshot. Type: DescribeSnapshotsSetItemResponseType Ancestor: Children: |
|
The ID of the snapshot. Type: xsd:string Ancestor: Children: None |
|
The ID of the volume. Type: xsd:string Ancestor: Children: None |
|
Snapshot state (e.g., pending, completed, error). Type: xsd:string Ancestor: Children: None |
|
Time stamp when the snapshot was initiated. Type: xsd:dateTime Ancestor: Children: None |
|
The progress of the snapshot, in percentage. Type: xsd:string Ancestor: Children: None |
Examples
Example Request
This example describes snapshot snap-78a54011.
<DescribeSnapshots xmlns="http://ec2.amazonaws.com/doc/2009-07-15/">
<snapshotSet>
<item>
<snapshotId>snap-78a54011</snapshotId>
</item>
</snapshotSet>
</DescribeSnapshots>
Example Response
<DescribeSnapshotsResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/">
<snapshotSet>
<item>
<snapshotId>snap-78a54011</snapshotId>
<volumeId>vol-4d826724</volumeId>
<status>pending</status>
<startTime>2008-05-07T12:51:50.000Z</startTime>
<progress>80%</progress>
</item>
</snapshotSet>
</DescribeSnapshotsResponse>