Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1448186240.2 KB

Creates a new Route 53 Global Resolver instance. A Route 53 Global Resolver is a global, internet-accessible DNS resolver that provides secure DNS resolution for both public and private domains through global anycast IP addresses.

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/global-resolver

Request body

clientTokenstring

A unique string that identifies the request and ensures idempotency. If you make multiple requests with the same client token, only one Route 53 Global Resolver is created.

descriptionstring

An optional description for the Route 53 Global Resolver instance. Maximum length of 1024 characters.

ipAddressType'IPV4' | 'DUAL_STACK'

The IP address type for the Route 53 Global Resolver. Valid values are IPV4 (default) or DUAL_STACK for both IPv4 and IPv6 support.

namestring required

A descriptive name for the Route 53 Global Resolver instance. Maximum length of 64 characters.

observabilityRegionstring

The Amazon Web Services Region where query resolution logs and metrics will be aggregated and delivered. If not specified, logging is not enabled.

regionsRegion[] required

List of Amazon Web Services Regions where the Route 53 Global Resolver will operate. The resolver will be distributed across these Regions to provide global availability and low-latency DNS resolution.

tagsobject

Tags to associate with the Route 53 Global Resolver. Tags are key-value pairs that help you organize and identify your resources.

Response

Success

idstring required

The unique identifier for the Route 53 Global Resolver.

arnstring required

The Amazon Resource Name (ARN) of the Route 53 Global Resolver.

clientTokenstring required

The unique string that identifies the request and ensures idempotency.

createdAtstring date-time required

The date and time when the Route 53 Global Resolver was created.

descriptionstring

The description of the Route 53 Global Resolver.

dnsNamestring required

The hostname that DNS clients should use for TLS certificate validation when connecting to the Route 53 Global Resolver. This value resolves to the global anycast IP addresses for the resolver.

ipAddressType'IPV4' | 'DUAL_STACK'

The IP address type configured for the Route 53 Global Resolver (IPV4 or DUAL_STACK).

ipv4AddressesIPv4Address[] required

The global anycast IPv4 addresses associated with the Route 53 Global Resolver. DNS clients can send queries to these addresses from anywhere on the internet.

ipv6AddressesIPv6Address[]

The global anycast IPv6 addresses associated with the Route 53 Global Resolver. This field is only populated when ipAddressType is DUAL_STACK. DNS clients can send queries to these addresses from anywhere on the internet.

namestring required

The name of the Route 53 Global Resolver.

observabilityRegionstring

The Amazon Web Services Region where observability data for the Route 53 Global Resolver is stored.

regionsRegion[] required

The Amazon Web Services Regions where the Route 53 Global Resolver is deployed and operational.

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

The current status of the Route 53 Global Resolver. Possible values are CREATING (being provisioned), UPDATING (being modified), OPERATIONAL (ready to serve queries), or DELETING (being removed).

updatedAtstring date-time required

The date and time when the Route 53 Global Resolver was last updated.