Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1448186240.2 KB

Creates an access token for a DNS view. Access tokens provide token-based authentication for DNS-over-HTTPS (DoH) and DNS-over-TLS (DoT) connections to the Route 53 Global Resolver.

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/tokens/{dnsViewId}

Path parameters

dnsViewIdstring required

The ID of the DNS view to associate with this token.

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.

expiresAtstring date-time

The date and time when the token expires. Tokens can have a minimum expiration of 30 days and maximum of 365 days from creation.

namestring

A descriptive name for the access token.

tagsobject

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

Response

Success

idstring required

The unique identifier for the access token.

arnstring required

The Amazon Resource Name (ARN) of the access token.

clientTokenstring

The unique string that identifies the request and ensures idempotency.

createdAtstring date-time required

The date and time when the access token was created.

dnsViewIdstring required

The ID of the DNS view associated with this access token.

expiresAtstring date-time required

The date and time when the access token expires.

namestring

The name of the access token.

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

The operational status of the access token.

valuestring password required

The access token value. This token should be included in DoH and DoT requests for authentication. Keep this value secure as it provides access to your Route 53 Global Resolver.