DescribeSnapshots
In this article:
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.
Type: List of Snapshot objects
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>