Amazon Web Services, Inc.

Amazon Route 53

Amazon Route 53 is a highly available and scalable Domain Name System (DNS) web service. You can use Route 53 to: Register domain names. For more information,…

Maps & location#openapi#cloud

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 is a highly available and scalable Domain Name System (DNS) web
service.
You can use Route 53 to:

Register domain names.
For more information, see How domain registration works .

Route internet traffic to the resources for your domain
For more information, see How internet traffic is routed to your website or web application .

Check the health of your resources.
For more information, see How Route 53 checks the health of your resources .

Endpoints 74

  • POSTActivate key signing key/2013-04-01/keysigningkey/:HostedZoneId/:Name/activateActivates a key-signing key (KSK) so that it can be used for signing by DNSSEC. This operation changes the KSK status to ACTIVE .
  • POSTAssociate vPC with hosted zone/2013-04-01/hostedzone/:HostedZoneId/associatevpcAssociates an Amazon VPC with a private hosted zone. To perform the association, the VPC and the private hosted zone must already exist. You can't convert a…
  • POSTChange cidr collection/2013-04-01/cidrcollection/:IdCreates, changes, or deletes CIDR blocks within a collection. Contains authoritative IP information mapping blocks to one or multiple locations. A change…
  • DELETEDelete cidr collection/2013-04-01/cidrcollection/:IdDeletes a CIDR collection in the current Amazon Web Services account. The collection must be empty before it can be deleted.
  • GETList resource record sets/2013-04-01/hostedzone/:HostedZoneId/rrset?name=string&type=string&identifier=string&maxitems=0Lists the resource record sets in a specified hosted zone. ListResourceRecordSets returns up to 300 resource record sets at a time in ASCII order, beginning…
  • POSTChange resource record sets/2013-04-01/hostedzone/:HostedZoneId/rrsetCreates, changes, or deletes a resource record set, which contains authoritative DNS information for a specified domain name or subdomain name. For example,…
  • GETList tags for resource/2013-04-01/tags/:ResourceType/:ResourceIdLists tags for one health check or hosted zone. For information about using tags for cost allocation, see Using Cost Allocation Tags in the Billing and Cost…
  • POSTChange tags for resource/2013-04-01/tags/:ResourceType/:ResourceIdAdds, edits, or deletes tags for a health check or a hosted zone. For information about using tags for cost allocation, see Using Cost Allocation Tags in the…
  • GETList cidr collections/2013-04-01/cidrcollection?nexttoken=string&maxresults=0Returns a paginated list of CIDR collections in the Amazon Web Services account (metadata only).
  • POSTCreate cidr collection/2013-04-01/cidrcollectionCreates a CIDR collection in the current Amazon Web Services account.
  • GETList health checks/2013-04-01/healthcheck?marker=string&maxitems=0Retrieve a list of the health checks that are associated with the current Amazon Web Services account.
  • POSTCreate health check/2013-04-01/healthcheckCreates a new health check. For information about adding health checks to resource record sets, see HealthCheckId in ChangeResourceRecordSets . ELB Load…
  • GETList hosted zones/2013-04-01/hostedzone?marker=string&maxitems=0&delegationsetid=string&hostedzonetype=stringRetrieves a list of the public and private hosted zones that are associated with the current Amazon Web Services account. The response includes a HostedZones…
  • POSTCreate hosted zone/2013-04-01/hostedzoneCreates a new public or private hosted zone. You create records in a public hosted zone to define how you want to route traffic on the internet for a domain,…
  • POSTCreate key signing key/2013-04-01/keysigningkeyCreates a new key-signing key (KSK) associated with a hosted zone. You can only have two KSKs per hosted zone.
  • GETList query logging configs/2013-04-01/queryloggingconfig?hostedzoneid=string&nexttoken=string&maxresults=0Lists the configurations for DNS query logging that are associated with the current Amazon Web Services account or the configuration that is associated with a…
  • POSTCreate query logging config/2013-04-01/queryloggingconfigCreates a configuration for DNS query logging. After you create a query logging configuration, Amazon Route 53 begins to publish log data to an Amazon…
  • GETList resource record set protections/2013-04-01/hostedzone/:HostedZoneId/rrsetprotection?name=string&type=string&maxresults=0&nexttoken=stringLists the resource record set protections in a hosted zone. We recommend using pagination to ensure that the operation returns quickly and successfully. If…
  • POSTCreate resource record set protections/2013-04-01/hostedzone/:HostedZoneId/rrsetprotectionCreates one or more resource record set protections in a hosted zone. A protection applies to every resource record set in the hosted zone that has the…
  • GETList reusable delegation sets/2013-04-01/delegationset?marker=string&maxitems=0Retrieves a list of the reusable delegation sets that are associated with the current Amazon Web Services account.
  • POSTCreate reusable delegation set/2013-04-01/delegationsetCreates a delegation set (a group of four name servers) that can be reused by multiple hosted zones that were created by the same Amazon Web Services account.…
  • POSTCreate traffic policy/2013-04-01/trafficpolicyCreates a traffic policy, which you use to create multiple DNS resource record sets for one domain name (such as example.com) or one subdomain name (such as…
  • POSTCreate traffic policy instance/2013-04-01/trafficpolicyinstanceCreates resource record sets in a specified hosted zone based on the settings in a specified traffic policy version. In addition, CreateTrafficPolicyInstance…
  • POSTCreate traffic policy version/2013-04-01/trafficpolicy/:IdCreates a new version of an existing traffic policy. When you create a new version of a traffic policy, you specify the ID of the traffic policy that you want…
  • GETList vPC association authorizations/2013-04-01/hostedzone/:HostedZoneId/authorizevpcassociation?nexttoken=string&maxresults=0Gets a list of the VPCs that were created by other accounts and that can be associated with a specified hosted zone because you've submitted one or more…
  • POSTCreate vPC association authorization/2013-04-01/hostedzone/:HostedZoneId/authorizevpcassociationAuthorizes the Amazon Web Services account that created a specified VPC to submit an AssociateVPCWithHostedZone request to associate the VPC with a specified…
  • POSTDeactivate key signing key/2013-04-01/keysigningkey/:HostedZoneId/:Name/deactivateDeactivates a key-signing key (KSK) so that it will not be used for signing by DNSSEC. This operation changes the KSK status to INACTIVE .
  • GETGet health check/2013-04-01/healthcheck/:HealthCheckIdGets information about a specified health check.
  • POSTUpdate health check/2013-04-01/healthcheck/:HealthCheckIdUpdates an existing health check. Note that some values can't be updated. For more information about updating health checks, see Creating, Updating, and…
  • DELETEDelete health check/2013-04-01/healthcheck/:HealthCheckIdDeletes a health check. Amazon Route 53 does not prevent you from deleting a health check even if the health check is associated with one or more resource…
  • GETGet hosted zone/2013-04-01/hostedzone/:IdGets information about a specified hosted zone including the four name servers assigned to the hosted zone. returns the VPCs associated with the specified…
  • POSTUpdate hosted zone comment/2013-04-01/hostedzone/:IdUpdates the comment for a specified hosted zone.
  • DELETEDelete hosted zone/2013-04-01/hostedzone/:IdDeletes a hosted zone. If the hosted zone was created by another service, such as Cloud Map, see Deleting Public Hosted Zones That Were Created by Another…
  • DELETEDelete key signing key/2013-04-01/keysigningkey/:HostedZoneId/:NameDeletes a key-signing key (KSK). Before you can delete a KSK, you must deactivate it. The KSK must be deactivated before you can delete it regardless of…
  • GETGet query logging config/2013-04-01/queryloggingconfig/:IdGets information about a specified configuration for DNS query logging. For more information about DNS query logs, see CreateQueryLoggingConfig and Logging…
  • DELETEDelete query logging config/2013-04-01/queryloggingconfig/:IdDeletes a configuration for DNS query logging. If you delete a configuration, Amazon Route 53 stops sending query logs to CloudWatch Logs. Route 53 doesn't…
  • POSTDelete resource record set protections/2013-04-01/hostedzone/:HostedZoneId/rrsetprotection/deleteDeletes one or more resource record set protections from a hosted zone. After a protection is deleted, you can change the resource record sets that have that…
  • GETGet reusable delegation set/2013-04-01/delegationset/:IdRetrieves information about a specified reusable delegation set, including the four name servers that are assigned to the delegation set.
  • DELETEDelete reusable delegation set/2013-04-01/delegationset/:IdDeletes a reusable delegation set. You can delete a reusable delegation set only if it isn't associated with any hosted zones. To verify that the reusable…
  • GETGet traffic policy/2013-04-01/trafficpolicy/:Id/:VersionGets information about a specific traffic policy version. For information about how of deleting a traffic policy affects the response from GetTrafficPolicy ,…
  • POSTUpdate traffic policy comment/2013-04-01/trafficpolicy/:Id/:VersionUpdates the comment for a specified traffic policy version.
  • DELETEDelete traffic policy/2013-04-01/trafficpolicy/:Id/:VersionDeletes a traffic policy. When you delete a traffic policy, Route 53 sets a flag on the policy to indicate that it has been deleted. However, Route 53 never…
  • GETGet traffic policy instance/2013-04-01/trafficpolicyinstance/:IdGets information about a specified traffic policy instance. Use GetTrafficPolicyInstance with the id of new traffic policy instance to confirm that the…
  • POSTUpdate traffic policy instance/2013-04-01/trafficpolicyinstance/:IdAfter you submit a UpdateTrafficPolicyInstance request, there's a brief delay while Route 53 creates the resource record sets that are specified in the…
  • DELETEDelete traffic policy instance/2013-04-01/trafficpolicyinstance/:IdDeletes a traffic policy instance and all of the resource record sets that Amazon Route 53 created when you created the instance. In the Route 53 console,…
  • POSTDelete vPC association authorization/2013-04-01/hostedzone/:HostedZoneId/deauthorizevpcassociationRemoves authorization to submit an AssociateVPCWithHostedZone request to associate a specified VPC with a hosted zone that was created by a different account.…
  • POSTDisable hosted zone dNSSEC/2013-04-01/hostedzone/:HostedZoneId/disable-dnssecDisables DNSSEC signing in a specific hosted zone. This action does not deactivate any key-signing keys (KSKs) that are active in the hosted zone.
  • POSTDisassociate vPC from hosted zone/2013-04-01/hostedzone/:HostedZoneId/disassociatevpcDisassociates an Amazon Virtual Private Cloud (Amazon VPC) from an Amazon Route 53 private hosted zone. Note the following: You can't disassociate the last…
  • POSTEnable hosted zone dNSSEC/2013-04-01/hostedzone/:HostedZoneId/enable-dnssecEnables DNSSEC signing in a specific hosted zone.
  • GETGet account limit/2013-04-01/accountlimit/:TypeGets the specified limit for the current account, for example, the maximum number of health checks that you can create using the account. For the default…
  • GETGet change/2013-04-01/change/:IdReturns the current status of a change batch request. The status is one of the following values: PENDING indicates that the changes in this request have not…
  • GETGet checker ip ranges/2013-04-01/checkeriprangesRoute 53 does not perform authorization for this API because it retrieves information that is already available to the public. GetCheckerIpRanges still works,…
  • GETGet dNSSEC/2013-04-01/hostedzone/:HostedZoneId/dnssecReturns information about DNSSEC for a specific hosted zone, including the key-signing keys (KSKs) in the hosted zone.
  • GETGet geo location/2013-04-01/geolocation?continentcode=string&countrycode=string&subdivisioncode=stringGets information about whether a specified geographic location is supported for Amazon Route 53 geolocation resource record sets. Route 53 does not perform…
  • GETGet health check count/2013-04-01/healthcheckcountRetrieves the number of health checks that are associated with the current Amazon Web Services account.
  • GETGet health check last failure reason/2013-04-01/healthcheck/:HealthCheckId/lastfailurereasonGets the reason that a specified health check failed most recently.
  • GETGet health check status/2013-04-01/healthcheck/:HealthCheckId/statusGets status of a specified health check. This API is intended for use during development to diagnose behavior. It doesn’t support production use-cases with…
  • GETGet hosted zone count/2013-04-01/hostedzonecountRetrieves the number of hosted zones that are associated with the current Amazon Web Services account.
  • GETGet hosted zone limit/2013-04-01/hostedzonelimit/:HostedZoneId/:TypeGets the specified limit for a specified hosted zone, for example, the maximum number of records that you can create in the hosted zone. For the default…
  • GETGet reusable delegation set limit/2013-04-01/reusabledelegationsetlimit/:DelegationSetId/:TypeGets the maximum number of hosted zones that you can associate with the specified reusable delegation set. For the default limit, see Limits in the Amazon…
  • GETGet traffic policy instance count/2013-04-01/trafficpolicyinstancecountGets the number of traffic policy instances that are associated with the current Amazon Web Services account.
  • GETList cidr blocks/2013-04-01/cidrcollection/:CollectionId/cidrblocks?location=string&nexttoken=string&maxresults=0Returns a paginated list of location objects and their CIDR blocks.
  • GETList cidr locations/2013-04-01/cidrcollection/:CollectionId?nexttoken=string&maxresults=0Returns a paginated list of CIDR locations for the given collection (metadata only, does not include CIDR blocks).
  • GETList geo locations/2013-04-01/geolocations?startcontinentcode=string&startcountrycode=string&startsubdivisioncode=string&maxitems=0Retrieves a list of supported geographic locations. Countries are listed first, and continents are listed last. If Amazon Route 53 supports subdivisions for a…
  • GETList hosted zones by name/2013-04-01/hostedzonesbyname?dnsname=string&hostedzoneid=string&maxitems=0Retrieves a list of your hosted zones in lexicographic order. The response includes a HostedZones child element for each hosted zone created by the current…
  • GETList hosted zones by vPC/2013-04-01/hostedzonesbyvpc?vpcid=string&vpcregion=string&maxitems=0&nexttoken=stringLists all the private hosted zones that a specified VPC is associated with, regardless of which Amazon Web Services account or Amazon Web Services service…
  • POSTList tags for resources/2013-04-01/tags/:ResourceTypeLists tags for up to 10 health checks or hosted zones. For information about using tags for cost allocation, see Using Cost Allocation Tags in the Billing and…
  • GETList traffic policies/2013-04-01/trafficpolicies?trafficpolicyid=string&maxitems=0Gets information about the latest version for every traffic policy that is associated with the current Amazon Web Services account. Policies are listed in the…
  • GETList traffic policy instances/2013-04-01/trafficpolicyinstances?hostedzoneid=string&trafficpolicyinstancename=string&trafficpolicyinstancetype=string&maxitems=0Gets information about the traffic policy instances that you created by using the current Amazon Web Services account. After you submit an…
  • GETList traffic policy instances by hosted zone/2013-04-01/trafficpolicyinstances/hostedzone?id=string&trafficpolicyinstancename=string&trafficpolicyinstancetype=string&maxitems=0Gets information about the traffic policy instances that you created in a specified hosted zone. After you submit a CreateTrafficPolicyInstance or an…
  • GETList traffic policy instances by policy/2013-04-01/trafficpolicyinstances/trafficpolicy?id=string&version=0&hostedzoneid=string&trafficpolicyinstancename=string&trafficpolicyinstancetype=string&maxitems=0Gets information about the traffic policy instances that you created by using a specify traffic policy version. After you submit a CreateTrafficPolicyInstance…
  • GETList traffic policy versions/2013-04-01/trafficpolicies/:Id/versions?trafficpolicyversion=string&maxitems=0Gets information about all of the versions for a specified traffic policy. Traffic policy versions are listed in numerical order by VersionNumber .
  • GETTest dNS answer/2013-04-01/testdnsanswer?hostedzoneid=string&recordname=string&recordtype=string&resolverip=string&edns0clientsubnetip=string&edns0clientsubnetmask=stringGets the value that Amazon Route 53 returns in response to a DNS request for a specified record name and type. You can optionally specify the IP address of a…
  • POSTUpdate hosted zone features/2013-04-01/hostedzone/:HostedZoneId/featuresUpdates the features configuration for a hosted zone. This operation allows you to enable or disable specific features for your hosted zone, such as…

API details

Base URL
https://route53.{region}.amazonaws.com
Authentication
AWS Signature Version 4 (requests signed with your AWS access key)
Operations
74 operations on 54 pathsGET 38POST 28DELETE 8
Description format
AWS Smithy model, API version 2013-04-01

How to test the Amazon Route 53 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 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 “Activate key signing key” (POST /2013-04-01/keysigningkey/:HostedZoneId/:Name/activate), 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?

Amazon Route 53 is a highly available and scalable Domain Name System (DNS) web service. You can use Route 53 to: Register domain names. For more information,… It is listed under Maps & location and has 74 endpoints.

Who publishes the Amazon Route 53?

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?

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

How do I authenticate with the Amazon Route 53?

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

How many endpoints does the Amazon Route 53 have?

74 operations on 54 paths (38 GET, 28 POST, 8 DELETE).

Is forking the Amazon Route 53 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.