steampipe plugin install aws

Table: aws_backup_selection - Query AWS Backup Selections using SQL

The AWS Backup Selection is a component of AWS Backup, a fully managed backup service that simplifies the backup of data across AWS services. It allows you to automate and centrally manage backups, enforcing policies and monitoring backup activities for AWS resources. The selection includes a list of resources to be backed up, identified by an array of ARNs, as well as a backup plan to specify how AWS Backup handles backup and restore operations.

Table Usage Guide

The aws_backup_selection table in Steampipe provides you with comprehensive information about backup selection resources within the AWS Backup service. This table allows you, as a DevOps engineer, security professional, or system administrator, to query backup selection-specific details, including the selection's ARN, backup plan ID, creation and modification dates, and associated creator request ID. You can utilize this table to gather insights on backup selections, such as identifying backup selections associated with specific backup plans, tracking creation and modification times of backup selections, and more. The schema outlines the various attributes of the backup selection for you, including the backup selection ARN, backup plan ID, creation date, creator request ID, and associated tags.

Examples

Basic Info

Explore which AWS backup plans are associated with specific IAM roles and regions. This can be useful for auditing and managing your AWS resources efficiently.

select
selection_name,
backup_plan_id,
iam_role_arn,
region,
account_id
from
aws_backup_selection;
select
selection_name,
backup_plan_id,
iam_role_arn,
region,
account_id
from
aws_backup_selection;

List EBS volumes that are in a backup plan

Identify the EBS volumes included in a backup plan to ensure crucial data is secured and maintained. This is essential for data recovery planning and to minimize potential data loss.

with filtered_data as (
select
backup_plan_id,
jsonb_agg(r) as assigned_resource
from
aws_backup_selection,
jsonb_array_elements(resources) as r
group by
backup_plan_id
)
select
v.volume_id,
v.region,
v.account_id
from
aws_ebs_volume as v
join filtered_data t on t.assigned_resource ?| array [ v.arn ];
Error: SQLite does not support the ?| operator used in array operations.

Schema for aws_backup_selection

NameTypeOperatorsDescription
_ctxjsonbSteampipe context in JSON form, e.g. connection_name.
account_idtextThe AWS Account ID in which the resource is located.
akasjsonbArray of globally unique identifier strings (also known as) for the resource.
arntextThe Amazon Resource Name (ARN) specifying the backup selection.
backup_plan_idtext=An ID that uniquely identifies a backup plan.
creation_datetimestamp with time zoneThe date and time a resource backup plan is created.
creator_request_idtextAn unique string that identifies the request and allows failed requests to be retried without the risk of running the operation twice.
iam_role_arntextSpecifies the IAM role Amazon Resource Name (ARN) to create the target recovery point.
list_of_tagsjsonbAn array of conditions used to specify a set of resources to assign to a backup plan.
partitiontextThe AWS partition in which the resource is located (aws, aws-cn, or aws-us-gov).
regiontextThe AWS Region in which the resource is located.
resourcesjsonbContains a list of BackupOptions for a resource type.
selection_idtext=Uniquely identifies a request to assign a set of resources to a backup plan.
selection_nametextThe display name of a resource selection document.
titletextTitle of the resource.

Export

This table is available as a standalone Exporter CLI. Steampipe exporters are stand-alone binaries that allow you to extract data using Steampipe plugins without a database.

You can download the tarball for your platform from the Releases page, but it is simplest to install them with the steampipe_export_installer.sh script:

/bin/sh -c "$(curl -fsSL https://steampipe.io/install/export.sh)" -- aws

You can pass the configuration to the command with the --config argument:

steampipe_export_aws --config '<your_config>' aws_backup_selection