steampipe plugin install aws

Table: aws_globalaccelerator_accelerator - Query AWS Global Accelerator using SQL

The AWS Global Accelerator is a networking service that improves the availability and performance of the applications you offer to your global users. It leverages the vast, congestion-free AWS global network to direct internet traffic from your users to your applications on AWS. With Global Accelerator, your users are directed to your workload based on their geographic location, application health, and routing policies that you configure.

Table Usage Guide

The aws_globalaccelerator_accelerator table in Steampipe provides you with information about accelerators within AWS Global Accelerator. These accelerators direct traffic to optimal endpoints over the AWS global network to enhance the availability and performance of your applications. This table allows you, as a DevOps engineer, to query accelerator-specific details, including the accelerator's ARN, creation time, and status. You can utilize this table to gather insights on accelerators, such as the accelerators' DNS names, IP address sets, and associated tags. The schema outlines the various attributes of the accelerator for you, including the accelerator ARN, creation date, and associated tags.

Examples

Basic info

Explore the status and key details of your AWS Global Accelerator to understand its operational state and configuration. This can assist in troubleshooting or optimizing performance.

select
name,
created_time,
dns_name,
enabled,
ip_address_type,
last_modified_time,
status
from
aws_globalaccelerator_accelerator;
select
name,
created_time,
dns_name,
enabled,
ip_address_type,
last_modified_time,
status
from
aws_globalaccelerator_accelerator;

List IPs used by global accelerators

Determine the areas in which global accelerators are being used by identifying their IP addresses. This can help in assessing network performance and identifying potential issues.

select
name,
created_time,
dns_name,
enabled,
ip_address_type,
last_modified_time,
status,
anycast_ip
from
aws_globalaccelerator_accelerator,
jsonb_array_elements(ip_sets -> 0 -> 'IpAddresses') as anycast_ip;
select
name,
created_time,
dns_name,
enabled,
ip_address_type,
last_modified_time,
status,
json_extract(ip.value, '$') as anycast_ip
from
aws_globalaccelerator_accelerator,
json_each(json_extract(ip_sets, '$[0].IpAddresses')) as ip;

List global accelerators without owner tag key

Identify instances where global accelerators in AWS do not have an assigned owner. This is useful for maintaining organizational oversight and ensuring accountability for resource usage.

select
name,
tags
from
aws_globalaccelerator_accelerator
where
not tags :: JSONB ? 'owner';
select
name,
tags
from
aws_globalaccelerator_accelerator
where
json_extract(tags, '$.owner') is null;

Schema for aws_globalaccelerator_accelerator

NameTypeOperatorsDescription
_ctxjsonbSteampipe context in JSON form.
accelerator_attributesjsonbAttributes of the accelerator.
account_idtext=, !=, ~~, ~~*, !~~, !~~*The AWS Account ID in which the resource is located.
akasjsonbArray of globally unique identifier strings (also known as) for the resource.
arntext=The Amazon Resource Name (ARN) of the accelerator.
created_timetimestamp with time zoneThe date and time that the accelerator was created.
dns_nametextThe Domain Name System (DNS) name that Global Accelerator creates that points to your accelerator's static IP addresses.
dual_stack_dns_nametextThe Domain Name System (DNS) name that Global Accelerator creates that points to a dual-stack accelerator's four static IP addresses: two IPv4 addresses and two IPv6 addresses.
enabledbooleanIndicates whether the accelerator is enabled.
eventsjsonbA history of changes that you make to an accelerator in Global Accelerator.
ip_address_typetextThe value for the address type must be IPv4.
ip_setsjsonbThe static IP addresses that Global Accelerator associates with the accelerator.
last_modified_timetimestamp with time zoneThe date and time that the accelerator was last modified.
nametextThe name of the accelerator.
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.
sp_connection_nametext=, !=, ~~, ~~*, !~~, !~~*Steampipe connection name.
sp_ctxjsonbSteampipe context in JSON form.
statustextDescribes the deployment status of the accelerator.
tagsjsonbA map of tags for the resource.
tags_srcjsonbA list of tags associated with the accelerator.
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_globalaccelerator_accelerator