DescribeSnapshots
The DescribeSnapshots
operation describes the status of Amazon EBS snapshots. For
more information about Amazon EBS, see Amazon Elastic Block Store.
Request Parameters
The following table describes the request parameters for
DescribeSnapshots
. Parameter names are case
sensitive.
Name | Description | Required |
---|---|---|
|
The ID of the Amazon EBS snapshot Type: String Default: Describes all snapshots that you own Valid Values: IDs of one or more snapshots that you own Constraints: none |
No |
Response Elements
The following table describes the default response tags included
in DescribeSnapshots
responses.
Name | Description |
---|---|
|
The ID of the snapshot Type: xsd:string |
|
The ID of the volume Type: xsd:string |
|
Snapshot state (e.g., Type: xsd:string |
|
Time stamp when the snapshot was initiated Type: xsd:dateTime |
|
The progress of the snapshot, in percentage Type: xsd:string |
Sample Request
https://ec2.amazonaws.com/ ?Action=DescribeSnapshots &SnapshotId=snap-78a54011 &...auth parameters...
Sample Response
<DescribeSnapshotsResponse xmlns="http://ec2.amazonaws.com/doc/2009-03-01/"> <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>