DescribeSnapshots

Amazon Elastic Compute Cloud: 2008-05-05

previous page next page

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

Name	Description	Required
`snapshotId`.`n`	The ID of the Amazon EBS snapshot Type: xsd:string Default: Describes all snapshots that you own Valid Values: IDs of one or more snapshots that you own Constraints: none	No

snapshotId.n

The ID of the Amazon EBS snapshot

Type: xsd:string

Default: Describes all snapshots that you own

Valid Values: IDs of one or more snapshots that you own

Constraints: none

Response Elements

The following table describes the default response tags included in DescribeSnapshots responses.

Name	Description
`snapshotId`	The ID of the snapshot Type: xsd:string
`volumeId`	The ID of the volume Type: xsd:string
`status`	Snapshot state (e.g., `pending`, `completed`) Type: xsd:string
`startTime`	Time stamp when the snapshot was initiated Type: xsd:dateTime
`progress`	The progress of the snapshot, in percentage Type: xsd:string

Sample Request

<DescribeSnapshots xmlns="http://ec2.amazonaws.com/doc/2008-05-05">
  <snapshotId>snap-78a54011</snapshotId>
</DescribeSnapshots>

Sample Response

<DescribeSnapshotsResponse xmlns="http://ec2.amazonaws.com/doc/2008-05-05">
  <snapshotId>snap-78a54011</snapshotId>
  <volumeId>vol-4d826724</volumeId>
  <status>pending</status>
  <startTime>2008-05-07T12:51:50.000Z</startTime>
  <progress>80%</progress>
</DescribeSnapshotsResponse>

Related Operations

previous page start next page