Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1448186240.2 KB

Creates a firewall domain list. Domain lists are reusable sets of domain specifications that you use in DNS firewall rules to allow, block, or alert on DNS queries to specific 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.

post/firewall-domain-lists/{globalResolverId}

Path parameters

globalResolverIdstring required

The ID of the Route 53 Global Resolver that the domain list will be associated with.

Request body

clientTokenstring

A unique, case-sensitive identifier to ensure idempotency. This means that making the same request multiple times with the same <code>clientToken</code> has the same result every time.

descriptionstring

An optional description for the firewall domain list.

namestring required

A descriptive name for the firewall domain list.

tagsobject

An array of user-defined keys and optional values. These tags can be used for categorization and organization.

Response

Success

arnstring required

An Amazon Resource Name (ARN) for the domain list.

globalResolverIdstring required

The ID of the Route 53 Global Resolver that the domain list is associated with.

createdAtstring date-time required

The time and date the domain list was created on.

descriptionstring

Description for the domain list.

domainCountinteger required

Number of domains in the domain list.

idstring required

ID of the domain list.

namestring required

Name of the domain list.

status'CREATING' | 'OPERATIONAL' | 'UPDATING' | 'DELETING' required

Creation status of the domain list.

updatedAtstring date-time required

The time and date the domain list was updated.