Amazon Web Services, Inc.

Amazon Route 53 Global Resolver

Amazon Route 53 Global Resolver is a global, internet-accessible DNS resolver that enables customers to resolve and forward traffic for both public and…

Maps & location#openapi

Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.

Overview

Amazon Route 53 Global Resolver is a global, internet-accessible DNS resolver that enables customers to resolve and forward traffic for both public and private domains while ensuring security and authenticity of queries over the internet. Route 53 Global Resolver supports DNS-over-port 53 (Do53), DNS-over-TLS (DoT), and DNS-over-HTTPS (DoH) protocols 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.

Endpoints 48

Hosted zone association

  • POSTAssociate hosted zone/hosted-zone-associations/:hostedZoneIdAssociates a Route 53 private hosted zone with a Route 53 Global Resolver resource. This allows the resolver to resolve DNS queries for the private hosted…
  • GETGet hosted zone association/hosted-zone-associations/:hostedZoneAssociationIdRetrieves information about a hosted zone association. Route 53 Global Resolver is a global service that supports resolvers in multiple Amazon Web Services…
  • PATCHUpdate hosted zone association/hosted-zone-associations/:hostedZoneAssociationIdUpdates the configuration of a hosted zone association. Route 53 Global Resolver is a global service that supports resolvers in multiple Amazon Web Services…
  • GETList hosted zone associations/hosted-zone-associations?max_results=0&next_token=string&resourceArn=stringLists hosted zone associations with pagination support. Specify a DNS view through the resourceArn parameter to list the hosted zone associations for that DNS…

Firewall rule

  • POSTBatch create firewall rule/firewall-rules/batch-createCreates multiple DNS firewall rules in a single operation. This is more efficient than creating rules individually when you need to set up multiple rules at…
  • POSTBatch delete firewall rule/firewall-rules/batch-deleteDeletes multiple DNS firewall rules in a single operation. This is more efficient than deleting rules individually. Route 53 Global Resolver is a global…
  • POSTBatch update firewall rule/firewall-rules/batch-updateUpdates multiple DNS firewall rules in a single operation. This is more efficient than updating rules individually. Route 53 Global Resolver is a global…
  • GETList firewall rules/firewall-rules?max_results=0&next_token=string&dnsview_id=stringLists all DNS firewall rules for a DNS view with pagination support. Route 53 Global Resolver is a global service that supports resolvers in multiple Amazon…
  • POSTCreate firewall rule/firewall-rulesCreates a DNS firewall rule. Firewall rules define actions (ALLOW, BLOCK, or ALERT) to take on DNS queries that match specified domain lists, managed domain…
  • GETGet firewall rule/firewall-rules/:firewallRuleIdRetrieves information about a DNS firewall rule. Route 53 Global Resolver is a global service that supports resolvers in multiple Amazon Web Services Regions…
  • DELETEDelete firewall rule/firewall-rules/:firewallRuleIdDeletes a DNS firewall rule. This operation cannot be undone. Route 53 Global Resolver is a global service that supports resolvers in multiple Amazon Web…
  • PATCHUpdate firewall rule/firewall-rules/:firewallRuleIdUpdates the configuration of a DNS firewall rule. Route 53 Global Resolver is a global service that supports resolvers in multiple Amazon Web Services Regions…

Access source

  • GETList access sources/access-sources?max_results=0&next_token=stringLists all access sources with pagination support. Route 53 Global Resolver is a global service that supports resolvers in multiple Amazon Web Services Regions…
  • POSTCreate access source/access-sourcesCreates an access source for a DNS view. Access sources define IP addresses or CIDR ranges that are allowed to send DNS queries to the Route 53 Global…
  • GETGet access source/access-sources/:accessSourceIdRetrieves information about an access source. Route 53 Global Resolver is a global service that supports resolvers in multiple Amazon Web Services Regions but…
  • DELETEDelete access source/access-sources/:accessSourceIdDeletes an access source. This operation cannot be undone. Route 53 Global Resolver is a global service that supports resolvers in multiple Amazon Web…
  • PATCHUpdate access source/access-sources/:accessSourceIdUpdates the configuration of an access source. Route 53 Global Resolver is a global service that supports resolvers in multiple Amazon Web Services Regions…

Access token

  • POSTCreate access token/tokens/:dnsViewIdCreates 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…
  • GETGet access token/tokens/:accessTokenIdRetrieves information about an access token. Route 53 Global Resolver is a global service that supports resolvers in multiple Amazon Web Services Regions but…
  • DELETEDelete access token/tokens/:accessTokenIdDeletes an access token. This operation cannot be undone. Route 53 Global Resolver is a global service that supports resolvers in multiple Amazon Web Services…
  • PATCHUpdate access token/tokens/:accessTokenIdUpdates the configuration of an access token. Route 53 Global Resolver is a global service that supports resolvers in multiple Amazon Web Services Regions but…
  • GETList access tokens/tokens/dns-view/:dnsViewId?max_results=0&next_token=stringLists all access tokens for a DNS view with pagination support. Route 53 Global Resolver is a global service that supports resolvers in multiple Amazon Web…

DNS view

  • POSTCreate dNS view/dns-views/:globalResolverIdCreates 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…
  • GETGet dNS view/dns-views/:dnsViewIdRetrieves information about a DNS view. Route 53 Global Resolver is a global service that supports resolvers in multiple Amazon Web Services Regions but you…
  • DELETEDelete dNS view/dns-views/:dnsViewIdDeletes a DNS view. This operation cannot be undone. Route 53 Global Resolver is a global service that supports resolvers in multiple Amazon Web Services…
  • PATCHUpdate dNS view/dns-views/:dnsViewIdUpdates the configuration of a DNS view. Route 53 Global Resolver is a global service that supports resolvers in multiple Amazon Web Services Regions but you…
  • PATCHDisable dNS view/dns-views/:dnsViewId/disableDisables a DNS view, preventing it from serving DNS queries. Route 53 Global Resolver is a global service that supports resolvers in multiple Amazon Web…
  • PATCHEnable dNS view/dns-views/:dnsViewId/enableEnables a disabled DNS view, allowing it to serve DNS queries again. Route 53 Global Resolver is a global service that supports resolvers in multiple Amazon…
  • GETList dNS views/dns-views/resolver/:globalResolverId?max_results=0&next_token=stringLists all DNS views for a Route 53 Global Resolver with pagination support. Route 53 Global Resolver is a global service that supports resolvers in multiple…

Firewall domain list

  • POSTCreate firewall domain list/firewall-domain-lists/:globalResolverIdCreates a firewall domain list. Domain lists are reusable sets of domain specifications that you use in DNS firewall rules to allow, block, or alert on DNS…
  • GETGet firewall domain list/firewall-domain-lists/:firewallDomainListIdRetrieves information about a firewall domain list. Route 53 Global Resolver is a global service that supports resolvers in multiple Amazon Web Services…
  • DELETEDelete firewall domain list/firewall-domain-lists/:firewallDomainListIdDeletes a firewall domain list. This operation cannot be undone. Route 53 Global Resolver is a global service that supports resolvers in multiple Amazon Web…
  • PATCHImport firewall domains/firewall-domain-lists/:firewallDomainListId/domains/s3_file_urlImports a list of domains from an Amazon S3 file into a firewall domain list. The file should contain one domain per line. Route 53 Global Resolver is a…
  • GETList firewall domain lists/firewall-domain-lists?max_results=0&next_token=string&global_resolver_id=stringLists all firewall domain lists for a Route 53 Global Resolver with pagination support. Route 53 Global Resolver is a global service that supports resolvers…
  • GETList firewall domains/firewall-domain-lists/:firewallDomainListId/domains?max_results=0&next_token=stringLists all the domains in DNS Firewall domain list you have created. Route 53 Global Resolver is a global service that supports resolvers in multiple Amazon…
  • PATCHUpdate firewall domains/firewall-domain-lists/:firewallDomainListId/domainsUpdates a DNS Firewall domain list from an array of specified domains. Route 53 Global Resolver is a global service that supports resolvers in multiple Amazon…

Global resolver

  • GETList global resolvers/global-resolver?max_results=0&next_token=stringLists all Route 53 Global Resolver instances in your account with pagination support. Route 53 Global Resolver is a global service that supports resolvers in…
  • POSTCreate global resolver/global-resolverCreates a new Route 53 Global Resolver instance. A Route 53 Global Resolver is a global, internet-accessible DNS resolver that provides secure DNS resolution…
  • GETGet global resolver/global-resolver/:globalResolverIdRetrieves information about a Route 53 Global Resolver instance. Route 53 Global Resolver is a global service that supports resolvers in multiple Amazon Web…
  • DELETEDelete global resolver/global-resolver/:globalResolverIdDeletes a Route 53 Global Resolver instance. This operation cannot be undone. All associated DNS views, access sources, tokens, and firewall rules are also…
  • PATCHUpdate global resolver/global-resolver/:globalResolverIdUpdates the configuration of a Route 53 Global Resolver instance. You can modify the name, description, and observability Region. Route 53 Global Resolver is…

Managed firewall domain list

  • GETGet managed firewall domain list/managed-firewall-domain-lists/:managedFirewallDomainListIdRetrieves information about an Amazon Web Services-managed firewall domain list. Managed domain lists contain domains associated with malicious activity,…
  • GETList managed firewall domain lists/list-managed-firewall-domain-lists/:managedFirewallDomainListType?max_results=0&next_token=stringReturns a paginated list of the Amazon Web Services Managed DNS Lists and the categories for DNS Firewall. The categories are either THREAT or CONTENT . Route…
  • DELETEDisassociate hosted zone/hosted-zone-associations/hosted-zone/:hostedZoneId/resource-arn/:resourceArnDisassociates a Route 53 private hosted zone from a Route 53 Global Resolver resource. Route 53 Global Resolver is a global service that supports resolvers in…
  • GETList shared dNS views/shared-dns-views?max_results=0&next_token=stringLists the DNS views that have been shared with your Amazon Web Services account through Amazon Web Services Resource Access Manager (Amazon Web Services RAM),…
  • POSTList tags for resource/get-all-tagsLists the tags associated with a Route 53 Global Resolver resource. Route 53 Global Resolver is a global service that supports resolvers in multiple Amazon…
  • POSTTag resource/tag-resourceAdds or updates tags for a Route 53 Global Resolver resource. Tags are key-value pairs that help you organize and identify your resources. Route 53 Global…
  • POSTUntag resource/untag-resourceRemoves tags from a Route 53 Global Resolver resource. Route 53 Global Resolver is a global service that supports resolvers in multiple Amazon Web Services…

API details

Base URL
https://route53globalresolver.{region}.amazonaws.com
Authentication
AWS Signature Version 4 (requests signed with your AWS access key)
Operations
48 operations on 32 pathsGET 18POST 13PATCH 10DELETE 7
Main resources
Firewall rule 8DNS view 7Firewall domain list 7Access source 5Access token 5Global resolver 5Hosted zone association 4Managed firewall domain list 2
Description format
AWS Smithy model, API version 2022-09-27

How to test the Amazon Route 53 Global Resolver in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the Amazon Route 53 Global Resolver collection, without the publisher's secrets.
  3. Add your credentialsThis API uses AWS Signature Version 4 (requests signed with your AWS access key). Add yours in the collection's variables or an environment; the requests already reference it.
  4. Send a requestPick an endpoint, for example “Associate hosted zone” (POST /hosted-zone-associations/:hostedZoneId), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the Amazon Route 53 Global Resolver?

Amazon Route 53 Global Resolver is a global, internet-accessible DNS resolver that enables customers to resolve and forward traffic for both public and… It is listed under Maps & location and has 48 endpoints.

Who publishes the Amazon Route 53 Global Resolver?

It is listed from Amazon Web Services, Inc.'s public API description (an OpenAPI document), not published by Amazon Web Services, Inc. on Swastik Codes. Anyone who controls amazonaws.com can claim the profile by adding a DNS TXT record.

What is the base URL of the Amazon Route 53 Global Resolver?

Requests go to https://route53globalresolver.{region}.amazonaws.com. Endpoint paths are added to this base URL.

How do I authenticate with the Amazon Route 53 Global Resolver?

With AWS Signature Version 4 (requests signed with your AWS access key).

How many endpoints does the Amazon Route 53 Global Resolver have?

48 operations on 32 paths (18 GET, 13 POST, 10 PATCH, 7 DELETE). The largest groups are Firewall rule, DNS view, Firewall domain list, Access source.

Is forking the Amazon Route 53 Global Resolver free?

Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.