Skip to main content

snapshots_in_recycle_bins

Creates, updates, deletes, gets or lists a snapshots_in_recycle_bins resource.

Overview

Namesnapshots_in_recycle_bins
TypeResource
Idaws.ec2.snapshots_in_recycle_bins

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
descriptionstringThe description for the snapshot.
recycle_bin_enter_timestringThe date and time when the snapshot entered the Recycle Bin.
recycle_bin_exit_timestringThe date and time when the snapshot is to be permanently deleted from the Recycle Bin.
snapshot_idstringThe ID of the snapshot.
volume_idstringThe ID of the volume from which the snapshot was created.

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
list_snapshots_in_recycle_binselectregionMaxResults, NextToken, SnapshotId, DryRunLists one or more snapshots that are currently in the Recycle Bin.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
regionstringAWS region (default: us-east-1)
DryRunbooleanChecks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.
MaxResultsintegerThe maximum number of items to return for this request. To get the next page of items, make another request with the token returned in the output. For more information, see Pagination.
NextTokenstringThe token returned from a previous paginated request. Pagination continues from the end of the items returned by the previous request.
SnapshotIdarrayThe IDs of the snapshots to list. Omit this parameter to list all of the snapshots that are in the Recycle Bin.

SELECT examples

Lists one or more snapshots that are currently in the Recycle Bin.

SELECT
description,
recycle_bin_enter_time,
recycle_bin_exit_time,
snapshot_id,
volume_id
FROM aws.ec2.snapshots_in_recycle_bins
WHERE region = '{{ region }}' -- required
AND MaxResults = '{{ MaxResults }}'
AND NextToken = '{{ NextToken }}'
AND SnapshotId = '{{ SnapshotId }}'
AND DryRun = '{{ DryRun }}'
;