firewall_domains

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

Overview

Name	firewall_domains
Type	Resource
Id	aws.route53globalresolver.firewall_domains

Fields

The following fields are returned by SELECT queries:

list_firewall_domains

Name	Datatype	Description
domain	string	List of domains in the specified domain list.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
list_firewall_domains	select	firewall_domain_list_id, region	max_results, next_token	Lists all the domains in DNS Firewall domain list you have created. Route 53 Global Resolver is a global service that supports resolvers in multiple Amazon Web Services Regions but you must specify the US East (Ohio) Region to create, update, or otherwise work with Route 53 Global Resolver resources. That is, for example, specify --region us-east-2 on Amazon Web Services CLI commands.
update_firewall_domains	update	firewall_domain_list_id, region, domains, operation		Updates a DNS Firewall domain list from an array of specified domains. Route 53 Global Resolver is a global service that supports resolvers in multiple Amazon Web Services Regions but you must specify the US East (Ohio) Region to create, update, or otherwise work with Route 53 Global Resolver resources. That is, for example, specify --region us-east-2 on Amazon Web Services CLI commands.
import_firewall_domains	exec	firewall_domain_list_id, region, domainFileUrl, operation		Imports a list of domains from an Amazon S3 file into a firewall domain list. The file should contain one domain per line. Route 53 Global Resolver is a global service that supports resolvers in multiple Amazon Web Services Regions but you must specify the US East (Ohio) Region to create, update, or otherwise work with Route 53 Global Resolver resources. That is, for example, specify --region us-east-2 on Amazon Web Services CLI commands.

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.

Name	Datatype	Description
firewall_domain_list_id	string	ID of the DNS Firewall domain list that you want to import the domain list to.
region	string	AWS region (default: us-east-1)
max_results	integer	The maximum number of results to retrieve in a single call.
next_token	string	A pagination token used for large sets of results that can't be returned in a single response.

SELECT examples

list_firewall_domains

Lists all the domains in DNS Firewall domain list you have created. Route 53 Global Resolver is a global service that supports resolvers in multiple Amazon Web Services Regions but you must specify the US East (Ohio) Region to create, update, or otherwise work with Route 53 Global Resolver resources. That is, for example, specify --region us-east-2 on Amazon Web Services CLI commands.

SELECT
domain
FROM aws.route53globalresolver.firewall_domains
WHERE firewall_domain_list_id = '{{ firewall_domain_list_id }}' -- required
AND region = '{{ region }}' -- required
AND max_results = '{{ max_results }}'
AND next_token = '{{ next_token }}'
;

UPDATE examples

update_firewall_domains

Updates a DNS Firewall domain list from an array of specified domains. Route 53 Global Resolver is a global service that supports resolvers in multiple Amazon Web Services Regions but you must specify the US East (Ohio) Region to create, update, or otherwise work with Route 53 Global Resolver resources. That is, for example, specify --region us-east-2 on Amazon Web Services CLI commands.

UPDATE aws.route53globalresolver.firewall_domains
SET 
domains = '{{ domains }}',
operation = '{{ operation }}'
WHERE 
firewall_domain_list_id = '{{ firewall_domain_list_id }}' --required
AND region = '{{ region }}' --required
AND domains = '{{ domains }}' --required
AND operation = '{{ operation }}' --required
RETURNING
id,
name,
status;

Lifecycle Methods

import_firewall_domains

Imports a list of domains from an Amazon S3 file into a firewall domain list. The file should contain one domain per line. Route 53 Global Resolver is a global service that supports resolvers in multiple Amazon Web Services Regions but you must specify the US East (Ohio) Region to create, update, or otherwise work with Route 53 Global Resolver resources. That is, for example, specify --region us-east-2 on Amazon Web Services CLI commands.

EXEC aws.route53globalresolver.firewall_domains.import_firewall_domains 
@firewall_domain_list_id='{{ firewall_domain_list_id }}' --required, 
@region='{{ region }}' --required 
@@json=
'{
"domainFileUrl": "{{ domainFileUrl }}", 
"operation": "{{ operation }}"
}'
;