DescribeSnapshots#

Description#

Describes one or more of the EBS snapshots available to you.

Request Parameters#

  • Filter.N — One or more filters.

    • Type: List of Filter objects

    • Required: No

  • Owner.N — Owners of volume snapshots.

    • Type: Array of strings

    • Required: No

  • SnapshotId.N — IDs of volume snapshots.

    • Type: Array of strings

    • Required: No

  • RestorableBy.N — The IDs of the users that can create volumes from a snapshot.

    • Type: Array of strings

    • Required: No

Supported Filters#

  • description — The description of the snapshot.

  • owner-alias — The alias of the image owner (for example, cloud_provider).

  • “owner-id” — The ID of the account that owns the snapshot.

  • “snapshot-id” — The ID of the snapshot.

  • “start-time” — The timestamp when the snapshot was initiated.

  • status — The state of the snapshot.

  • tag-key — The tag key. Such a filter allows you to get resources with the specified key and any value.

  • tag:<tag-key> — The key/value a pair of a tag. The tag key is passed in the filter name, while the tag value is used as the filter value.

  • type — The snapshot type (regular | backup).

  • volume-id — The ID of the volume.

  • volume-size — The size of the volume, in GiB.

Response Elements#

  • snapshotSet — Information about the snapshots.

Examples#

c2-ec2 DescribeSnapshots

c2-ec2 DescribeSnapshots Owner.1 self

c2-ec2 DescribeSnapshots SnapshotId.1 <snap_id>

c2-ec2 DescribeSnapshots Filter.1.Name tag:<tag-key> Filter.1.Value <tag-value>

c2-ec2 DescribeSnapshots Filter.1.Name tag-key Filter.1.Value <tag-key>