v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1448186240.2 KB

Updates the configuration of a Route 53 Global Resolver instance. You can modify the name, description, and observability Region.

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.

patch/global-resolver/{globalResolverId}

Path parameters

globalResolverIdstring required

The ID of the Global Resolver.

Request body

namestring

The name of the Global Resolver.

observabilityRegionstring

The Amazon Web Services Regions in which the users' Global Resolver query resolution logs will be propagated.

descriptionstring

The description of the Global Resolver.

ipAddressType'IPV4' | 'DUAL_STACK'

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

regionsRegion[]

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

Response

Success

idstring required

The ID of the Global Resolver.

arnstring required

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

clientTokenstring required

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.

dnsNamestring required

The hostname to be used by the customers' DNS clients for certification validation.

observabilityRegionstring

The Amazon Web Services Regions in which the users' Global Resolver query resolution logs will be propagated.

namestring required

Name of the Global Resolver.

descriptionstring

Description of the Global Resolver.

regionsRegion[] required

The Amazon Web Services Regions in which the Global Resolver will operate.

createdAtstring date-time required

The time and date the Global Resolverwas created.

updatedAtstring date-time required

The time and date the Global Resolver was updated.

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

The operational status of the Global Resolver.

ipv4AddressesIPv4Address[] required

List of anycast IPv4 addresses associated with the Global Resolver instance.

ipv6AddressesIPv6Address[]

List of anycast IPv6 addresses associated with the updated Global Resolver instance. This field is only populated when ipAddressType is DUAL_STACK.

ipAddressType'IPV4' | 'DUAL_STACK'

The IP address type configured for the updated Global Resolver.