Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1448186240.2 KB

Creates a DNS view within a Route 53 Global Resolver. A DNS view models end users, user groups, networks, and devices, and serves as a parent resource that holds configurations controlling access, authorization, DNS firewall rules, and forwarding rules.

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/dns-views/{globalResolverId}

Path parameters

globalResolverIdstring required

The ID of the Route 53 Global Resolver to associate with this DNS view.

Request body

clientTokenstring

A unique string that identifies the request and ensures idempotency.

namestring required

A descriptive name for the DNS view.

dnssecValidation'ENABLED' | 'DISABLED'

Whether to enable DNSSEC validation for DNS queries in this DNS view. When enabled, the resolver verifies the authenticity and integrity of DNS responses from public name servers for DNSSEC-signed domains.

ednsClientSubnet'ENABLED' | 'DISABLED'

Whether to enable EDNS Client Subnet injection for DNS queries in this DNS view. When enabled, client subnet information is forwarded to provide more accurate geographic-based DNS responses.

firewallRulesFailOpen'ENABLED' | 'DISABLED'

Determines the behavior when Route 53 Global Resolver cannot apply DNS firewall rules due to service impairment. When enabled, DNS queries are allowed through; when disabled, queries are blocked.

descriptionstring

An optional description for the DNS view.

tagsobject

Tags to associate with the DNS view.

Response

Success

idstring required

The unique identifier for the DNS view.

arnstring required

The Amazon Resource Name (ARN) of the DNS view.

clientTokenstring

The unique string that identifies the request and ensures idempotency.

dnssecValidation'ENABLED' | 'DISABLED' required

Whether DNSSEC validation is enabled for DNS queries in this DNS view.

ednsClientSubnet'ENABLED' | 'DISABLED' required

Whether EDNS Client Subnet injection is enabled for DNS queries in this DNS view.

firewallRulesFailOpen'ENABLED' | 'DISABLED' required

The behavior when Route 53 Global Resolver cannot apply DNS firewall rules due to service impairment.

namestring required

The descriptive name of the DNS view.

descriptionstring

The description of the DNS view.

globalResolverIdstring required

The ID of the Route 53 Global Resolver instance the DNS view is created for.

createdAtstring date-time required

The date and time when the DNS view was created.

updatedAtstring date-time required

The date and time when the DNS view was last updated.

status'CREATING' | 'OPERATIONAL' | 'UPDATING' | 'ENABLING' | 'DISABLING' | 'DISABLED' | 'DELETING' required

The operational status of the DNS view.