AWS::Route53GlobalResolver::GlobalResolver - AWS CloudFormation
SyntaxPropertiesReturn values

This is the new CloudFormation Template Reference Guide. Please update your bookmarks and links. For help getting started with CloudFormation, see the AWS CloudFormation User Guide.

AWS::Route53GlobalResolver::GlobalResolver

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.

Important

Route 53 Global Resolver is a global service that supports resolvers in multiple AWS 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 AWS CLI commands.

Syntax

To declare this entity in your CloudFormation template, use the following syntax:

JSON

{
  "Type" : "AWS::Route53GlobalResolver::GlobalResolver",
  "Properties" : {
      "ClientToken" : String,
      "Description" : String,
      "IpAddressType" : String,
      "Name" : String,
      "ObservabilityRegion" : String,
      "Regions" : [ String, ... ],
      "Tags" : [ Tag, ... ]
    }
}

YAML

Type: AWS::Route53GlobalResolver::GlobalResolver
Properties:
  ClientToken: String
  Description: String
  IpAddressType: String
  Name: String
  ObservabilityRegion: String
  Regions: 
    - String
  Tags: 
    - Tag

Properties

ClientToken

The unique string that identifies the request and ensures idempotency.

Required: No

Type: String

Minimum: 1

Maximum: 256

Update requires: Replacement

Description

A description of the global resolver.

Required: No

Type: String

Minimum: 1

Maximum: 256

Update requires: No interruption

IpAddressType

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

Required: No

Type: String

Allowed values: IPV4 | DUAL_STACK

Update requires: No interruption

Name

The name of the global resolver.

Required: Yes

Type: String

Pattern: (?!^[0-9]+$)([a-zA-Z0-9-_' ']+)

Minimum: 1

Maximum: 64

Update requires: No interruption

ObservabilityRegion

The AWS Region where observability data is collected for the global resolver.

Required: No

Type: String

Minimum: 1

Maximum: 32

Update requires: No interruption

Regions

The AWS Regions where the global resolver is deployed.

Required: Yes

Type: Array of String

Update requires: Replacement

Tags

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

Required: No

Type: Array of Tag

Maximum: 50

Update requires: No interruption

Return values

Ref

Fn::GetAtt

Arn

The Amazon Resource Name (ARN) of the global resolver.

CreatedAt

The date and time when the global resolver was created.

DnsName

The DNS name of the global resolver.

GlobalResolverId

The unique identifier for the Route 53 Global Resolver.

IPv4Addresses

The IPv4 addresses assigned to the global resolver.

IPv6Addresses

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.

Status

The current status of the global resolver.

UpdatedAt

The date and time when the global resolver was last updated.