Class AbstractAmazonRoute53

  • All Implemented Interfaces:
    AmazonRoute53
    Direct Known Subclasses:
    AbstractAmazonRoute53Async

    public class AbstractAmazonRoute53
    extends Object
    implements AmazonRoute53
    Abstract implementation of AmazonRoute53. Convenient method forms pass through to the corresponding overload that takes a request object, which throws an UnsupportedOperationException.
    • Constructor Detail

      • AbstractAmazonRoute53

        protected AbstractAmazonRoute53()
    • Method Detail

      • setEndpoint

        public void setEndpoint​(String endpoint)
        Description copied from interface: AmazonRoute53
        Overrides the default endpoint for this client ("https://route53.amazonaws.com"). Callers can use this method to control which AWS region they want to work with.

        Callers can pass in just the endpoint (ex: "route53.amazonaws.com") or a full URL, including the protocol (ex: "https://route53.amazonaws.com"). If the protocol is not specified here, the default protocol from this client's ClientConfiguration will be used, which by default is HTTPS.

        For more information on using AWS regions with the AWS SDK for Java, and a complete list of all available endpoints for all AWS services, see: http://developer.amazonwebservices.com/connect/entry.jspa?externalID= 3912

        This method is not threadsafe. An endpoint should be configured when the client is created and before any service requests are made. Changing it afterwards creates inevitable race conditions for any service requests in transit or retrying.

        Specified by:
        setEndpoint in interface AmazonRoute53
        Parameters:
        endpoint - The endpoint (ex: "route53.amazonaws.com") or a full URL, including the protocol (ex: "https://route53.amazonaws.com") of the region specific AWS endpoint this client will communicate with.
      • associateVPCWithHostedZone

        public AssociateVPCWithHostedZoneResult associateVPCWithHostedZone​(AssociateVPCWithHostedZoneRequest request)
        Description copied from interface: AmazonRoute53

        This action associates a VPC with an hosted zone.

        To associate a VPC with an hosted zone, send a POST request to the /Route 53 API version/hostedzone/hosted zone ID/associatevpc resource. The request body must include a document with a AssociateVPCWithHostedZoneRequest element. The response returns the AssociateVPCWithHostedZoneResponse element that contains ChangeInfo for you to track the progress of the AssociateVPCWithHostedZoneRequest you made. See GetChange operation for how to track the progress of your change.

        Specified by:
        associateVPCWithHostedZone in interface AmazonRoute53
        Parameters:
        request - A complex type that contains information about the request to associate a VPC with an hosted zone.
        Returns:
        Result of the AssociateVPCWithHostedZone operation returned by the service.
      • changeResourceRecordSets

        public ChangeResourceRecordSetsResult changeResourceRecordSets​(ChangeResourceRecordSetsRequest request)
        Description copied from interface: AmazonRoute53

        Use this action to create or change your authoritative DNS information. To use this action, send a POST request to the /Route 53 API version/hostedzone/hosted Zone ID/rrset resource. The request body must include a document with a ChangeResourceRecordSetsRequest element.

        Changes are a list of change items and are considered transactional. For more information on transactional changes, also known as change batches, see POST ChangeResourceRecordSets in the Amazon Route 53 API Reference.

        Due to the nature of transactional changes, you cannot delete the same resource record set more than once in a single change batch. If you attempt to delete the same change batch more than once, Amazon Route 53 returns an InvalidChangeBatch error.

        In response to a ChangeResourceRecordSets request, your DNS data is changed on all Amazon Route 53 DNS servers. Initially, the status of a change is PENDING. This means the change has not yet propagated to all the authoritative Amazon Route 53 DNS servers. When the change is propagated to all hosts, the change returns a status of INSYNC.

        Note the following limitations on a ChangeResourceRecordSets request:

        • A request cannot contain more than 100 Change elements.
        • A request cannot contain more than 1000 ResourceRecord elements.
        • The sum of the number of characters (including spaces) in all Value elements in a request cannot exceed 32,000 characters.
        Specified by:
        changeResourceRecordSets in interface AmazonRoute53
        Parameters:
        request - A complex type that contains a change batch.
        Returns:
        Result of the ChangeResourceRecordSets operation returned by the service.
      • createHealthCheck

        public CreateHealthCheckResult createHealthCheck​(CreateHealthCheckRequest request)
        Description copied from interface: AmazonRoute53

        This action creates a new health check.

        To create a new health check, send a POST request to the /Route 53 API version/healthcheck resource. The request body must include a document with a CreateHealthCheckRequest element. The response returns the CreateHealthCheckResponse element that contains metadata about the health check.

        Specified by:
        createHealthCheck in interface AmazonRoute53
        Parameters:
        request - >A complex type that contains information about the request to create a health check.
        Returns:
        Result of the CreateHealthCheck operation returned by the service.
      • createHostedZone

        public CreateHostedZoneResult createHostedZone​(CreateHostedZoneRequest request)
        Description copied from interface: AmazonRoute53

        This action creates a new hosted zone.

        To create a new hosted zone, send a POST request to the /Route 53 API version/hostedzone resource. The request body must include a document with a CreateHostedZoneRequest element. The response returns the CreateHostedZoneResponse element that contains metadata about the hosted zone.

        Amazon Route 53 automatically creates a default SOA record and four NS records for the zone. The NS records in the hosted zone are the name servers you give your registrar to delegate your domain to. For more information about SOA and NS records, see NS and SOA Records that Amazon Route 53 Creates for a Hosted Zone in the Amazon Route 53 Developer Guide.

        When you create a zone, its initial status is PENDING. This means that it is not yet available on all DNS servers. The status of the zone changes to INSYNC when the NS and SOA records are available on all Amazon Route 53 DNS servers.

        When trying to create a hosted zone using a reusable delegation set, you could specify an optional DelegationSetId, and Route53 would assign those 4 NS records for the zone, instead of alloting a new one.

        Specified by:
        createHostedZone in interface AmazonRoute53
        Parameters:
        request - A complex type that contains information about the request to create a hosted zone.
        Returns:
        Result of the CreateHostedZone operation returned by the service.
      • createReusableDelegationSet

        public CreateReusableDelegationSetResult createReusableDelegationSet​(CreateReusableDelegationSetRequest request)
        Description copied from interface: AmazonRoute53

        This action creates a reusable delegationSet.

        To create a new reusable delegationSet, send a POST request to the /Route 53 API version/delegationset resource. The request body must include a document with a CreateReusableDelegationSetRequest element. The response returns the CreateReusableDelegationSetResponse element that contains metadata about the delegationSet.

        If the optional parameter HostedZoneId is specified, it marks the delegationSet associated with that particular hosted zone as reusable.

        Specified by:
        createReusableDelegationSet in interface AmazonRoute53
        Returns:
        Result of the CreateReusableDelegationSet operation returned by the service.
      • createTrafficPolicy

        public CreateTrafficPolicyResult createTrafficPolicy​(CreateTrafficPolicyRequest request)
        Description copied from interface: AmazonRoute53

        Creates 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 www.example.com).

        To create a traffic policy, send a POST request to the /Route 53 API version/trafficpolicy resource. The request body must include a document with a CreateTrafficPolicyRequest element. The response includes the CreateTrafficPolicyResponse element, which contains information about the new traffic policy.

        Specified by:
        createTrafficPolicy in interface AmazonRoute53
        Parameters:
        request - A complex type that contains information about the traffic policy that you want to create.
        Returns:
        Result of the CreateTrafficPolicy operation returned by the service.
      • createTrafficPolicyInstance

        public CreateTrafficPolicyInstanceResult createTrafficPolicyInstance​(CreateTrafficPolicyInstanceRequest request)
        Description copied from interface: AmazonRoute53

        Creates resource record sets in a specified hosted zone based on the settings in a specified traffic policy version. In addition, CreateTrafficPolicyInstance associates the resource record sets with a specified domain name (such as example.com) or subdomain name (such as www.example.com). Amazon Route 53 responds to DNS queries for the domain or subdomain name by using the resource record sets that CreateTrafficPolicyInstance created.

        To create a traffic policy instance, send a POST request to the /Route 53 API version/trafficpolicyinstance resource. The request body must include a document with a CreateTrafficPolicyRequest element. The response returns the CreateTrafficPolicyInstanceResponse element, which contains information about the traffic policy instance.

        Specified by:
        createTrafficPolicyInstance in interface AmazonRoute53
        Parameters:
        request - A complex type that contains information about the resource record sets that you want to create based on a specified traffic policy.
        Returns:
        Result of the CreateTrafficPolicyInstance operation returned by the service.
      • createTrafficPolicyVersion

        public CreateTrafficPolicyVersionResult createTrafficPolicyVersion​(CreateTrafficPolicyVersionRequest request)
        Description copied from interface: AmazonRoute53

        Creates 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 to update and a JSON-formatted document that describes the new version.

        You use traffic policies to create multiple DNS resource record sets for one domain name (such as example.com) or one subdomain name (such as www.example.com).

        To create a new version, send a POST request to the /Route 53 API version/trafficpolicy/ resource. The request body includes a document with a CreateTrafficPolicyVersionRequest element. The response returns the CreateTrafficPolicyVersionResponse element, which contains information about the new version of the traffic policy.

        Specified by:
        createTrafficPolicyVersion in interface AmazonRoute53
        Parameters:
        request - A complex type that contains information about the traffic policy for which you want to create a new version.
        Returns:
        Result of the CreateTrafficPolicyVersion operation returned by the service.
      • deleteHealthCheck

        public DeleteHealthCheckResult deleteHealthCheck​(DeleteHealthCheckRequest request)
        Description copied from interface: AmazonRoute53

        This action deletes a health check. To delete a health check, send a DELETE request to the /Route 53 API version/healthcheck/health check ID resource.

        You can delete a health check only if there are no resource record sets associated with this health check. If resource record sets are associated with this health check, you must disassociate them before you can delete your health check. If you try to delete a health check that is associated with resource record sets, Amazon Route 53 will deny your request with a HealthCheckInUse error. For information about disassociating the records from your health check, see ChangeResourceRecordSets.
        Specified by:
        deleteHealthCheck in interface AmazonRoute53
        Parameters:
        request - A complex type containing the request information for delete health check.
        Returns:
        Result of the DeleteHealthCheck operation returned by the service.
      • deleteHostedZone

        public DeleteHostedZoneResult deleteHostedZone​(DeleteHostedZoneRequest request)
        Description copied from interface: AmazonRoute53

        This action deletes a hosted zone. To delete a hosted zone, send a DELETE request to the /Route 53 API version/hostedzone/hosted zone ID resource.

        For more information about deleting a hosted zone, see Deleting a Hosted Zone in the Amazon Route 53 Developer Guide.

        You can delete a hosted zone only if there are no resource record sets other than the default SOA record and NS resource record sets. If your hosted zone contains other resource record sets, you must delete them before you can delete your hosted zone. If you try to delete a hosted zone that contains other resource record sets, Amazon Route 53 will deny your request with a HostedZoneNotEmpty error. For information about deleting records from your hosted zone, see ChangeResourceRecordSets.
        Specified by:
        deleteHostedZone in interface AmazonRoute53
        Parameters:
        request - A complex type that contains information about the hosted zone that you want to delete.
        Returns:
        Result of the DeleteHostedZone operation returned by the service.
      • deleteReusableDelegationSet

        public DeleteReusableDelegationSetResult deleteReusableDelegationSet​(DeleteReusableDelegationSetRequest request)
        Description copied from interface: AmazonRoute53

        This action deletes a reusable delegation set. To delete a reusable delegation set, send a DELETE request to the /Route 53 API version/delegationset/delegation set ID resource.

        You can delete a reusable delegation set only if there are no associated hosted zones. If your reusable delegation set contains associated hosted zones, you must delete them before you can delete your reusable delegation set. If you try to delete a reusable delegation set that contains associated hosted zones, Amazon Route 53 will deny your request with a DelegationSetInUse error.
        Specified by:
        deleteReusableDelegationSet in interface AmazonRoute53
        Parameters:
        request - A complex type containing the information for the delete request.
        Returns:
        Result of the DeleteReusableDelegationSet operation returned by the service.
      • deleteTrafficPolicy

        public DeleteTrafficPolicyResult deleteTrafficPolicy​(DeleteTrafficPolicyRequest request)
        Description copied from interface: AmazonRoute53

        Deletes a traffic policy. To delete a traffic policy, send a DELETE request to the /Route 53 API version/trafficpolicy resource.

        Specified by:
        deleteTrafficPolicy in interface AmazonRoute53
        Parameters:
        request - A request to delete a specified traffic policy version.
        Returns:
        Result of the DeleteTrafficPolicy operation returned by the service.
      • deleteTrafficPolicyInstance

        public DeleteTrafficPolicyInstanceResult deleteTrafficPolicyInstance​(DeleteTrafficPolicyInstanceRequest request)
        Description copied from interface: AmazonRoute53

        Deletes a traffic policy instance and all of the resource record sets that Amazon Route 53 created when you created the instance.

        To delete a traffic policy instance, send a DELETE request to the /Route 53 API version/trafficpolicy/traffic policy instance ID resource.

        When you delete a traffic policy instance, Amazon Route 53 also deletes all of the resource record sets that were created when you created the traffic policy instance.
        Specified by:
        deleteTrafficPolicyInstance in interface AmazonRoute53
        Parameters:
        request - A complex type that contains information about the traffic policy instance that you want to delete.
        Returns:
        Result of the DeleteTrafficPolicyInstance operation returned by the service.
      • disassociateVPCFromHostedZone

        public DisassociateVPCFromHostedZoneResult disassociateVPCFromHostedZone​(DisassociateVPCFromHostedZoneRequest request)
        Description copied from interface: AmazonRoute53

        This action disassociates a VPC from an hosted zone.

        To disassociate a VPC to a hosted zone, send a POST request to the /Route 53 API version/hostedzone/hosted zone ID/disassociatevpc resource. The request body must include a document with a DisassociateVPCFromHostedZoneRequest element. The response returns the DisassociateVPCFromHostedZoneResponse element that contains ChangeInfo for you to track the progress of the DisassociateVPCFromHostedZoneRequest you made. See GetChange operation for how to track the progress of your change.

        Specified by:
        disassociateVPCFromHostedZone in interface AmazonRoute53
        Parameters:
        request - A complex type that contains information about the request to disassociate a VPC from an hosted zone.
        Returns:
        Result of the DisassociateVPCFromHostedZone operation returned by the service.
      • getChange

        public GetChangeResult getChange​(GetChangeRequest request)
        Description copied from interface: AmazonRoute53

        This action returns 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 replicated to all Amazon Route 53 DNS servers. This is the initial status of all change batch requests.

        - INSYNC indicates that the changes have replicated to all Amazon Route 53 DNS servers.

        Specified by:
        getChange in interface AmazonRoute53
        Parameters:
        request - The input for a GetChange request.
        Returns:
        Result of the GetChange operation returned by the service.
      • getCheckerIpRanges

        public GetCheckerIpRangesResult getCheckerIpRanges​(GetCheckerIpRangesRequest request)
        Description copied from interface: AmazonRoute53

        To retrieve a list of the IP ranges used by Amazon Route 53 health checkers to check the health of your resources, send a GET request to the /Route 53 API version/checkeripranges resource. You can use these IP addresses to configure router and firewall rules to allow health checkers to check the health of your resources.

        Specified by:
        getCheckerIpRanges in interface AmazonRoute53
        Parameters:
        request - Empty request.
        Returns:
        Result of the GetCheckerIpRanges operation returned by the service.
      • getGeoLocation

        public GetGeoLocationResult getGeoLocation​(GetGeoLocationRequest request)
        Description copied from interface: AmazonRoute53

        To retrieve a single geo location, send a GET request to the /Route 53 API version/geolocation resource with one of these options: continentcode | countrycode | countrycode and subdivisioncode.

        Specified by:
        getGeoLocation in interface AmazonRoute53
        Parameters:
        request - A complex type that contains information about the request to get a geo location.
        Returns:
        Result of the GetGeoLocation operation returned by the service.
      • getHealthCheck

        public GetHealthCheckResult getHealthCheck​(GetHealthCheckRequest request)
        Description copied from interface: AmazonRoute53

        To retrieve the health check, send a GET request to the /Route 53 API version/healthcheck/health check ID resource.

        Specified by:
        getHealthCheck in interface AmazonRoute53
        Parameters:
        request - A complex type that contains information about the request to get a health check.
        Returns:
        Result of the GetHealthCheck operation returned by the service.
      • getHealthCheckCount

        public GetHealthCheckCountResult getHealthCheckCount​(GetHealthCheckCountRequest request)
        Description copied from interface: AmazonRoute53

        To retrieve a count of all your health checks, send a GET request to the /Route 53 API version/healthcheckcount resource.

        Specified by:
        getHealthCheckCount in interface AmazonRoute53
        Parameters:
        request - To retrieve a count of all your health checks, send a GET request to the /Route 53 API version/healthcheckcount resource.
        Returns:
        Result of the GetHealthCheckCount operation returned by the service.
      • getHealthCheckLastFailureReason

        public GetHealthCheckLastFailureReasonResult getHealthCheckLastFailureReason​(GetHealthCheckLastFailureReasonRequest request)
        Description copied from interface: AmazonRoute53

        If you want to learn why a health check is currently failing or why it failed most recently (if at all), you can get the failure reason for the most recent failure. Send a GET request to the /Route 53 API version/healthcheck/health check ID/lastfailurereason resource.

        Specified by:
        getHealthCheckLastFailureReason in interface AmazonRoute53
        Parameters:
        request - A complex type that contains information about the request to get the most recent failure reason for a health check.
        Returns:
        Result of the GetHealthCheckLastFailureReason operation returned by the service.
      • getHealthCheckStatus

        public GetHealthCheckStatusResult getHealthCheckStatus​(GetHealthCheckStatusRequest request)
        Description copied from interface: AmazonRoute53

        To retrieve the health check status, send a GET request to the /Route 53 API version/healthcheck/health check ID/status resource. You can use this call to get a health check's current status.

        Specified by:
        getHealthCheckStatus in interface AmazonRoute53
        Parameters:
        request - A complex type that contains information about the request to get health check status for a health check.
        Returns:
        Result of the GetHealthCheckStatus operation returned by the service.
      • getHostedZone

        public GetHostedZoneResult getHostedZone​(GetHostedZoneRequest request)
        Description copied from interface: AmazonRoute53

        To retrieve the delegation set for a hosted zone, send a GET request to the /Route 53 API version/hostedzone/hosted zone ID resource. The delegation set is the four Amazon Route 53 name servers that were assigned to the hosted zone when you created it.

        Specified by:
        getHostedZone in interface AmazonRoute53
        Parameters:
        request - The input for a GetHostedZone request.
        Returns:
        Result of the GetHostedZone operation returned by the service.
      • getHostedZoneCount

        public GetHostedZoneCountResult getHostedZoneCount​(GetHostedZoneCountRequest request)
        Description copied from interface: AmazonRoute53

        To retrieve a count of all your hosted zones, send a GET request to the /Route 53 API version/hostedzonecount resource.

        Specified by:
        getHostedZoneCount in interface AmazonRoute53
        Parameters:
        request - To retrieve a count of all your hosted zones, send a GET request to the /Route 53 API version/hostedzonecount resource.
        Returns:
        Result of the GetHostedZoneCount operation returned by the service.
      • getTrafficPolicy

        public GetTrafficPolicyResult getTrafficPolicy​(GetTrafficPolicyRequest request)
        Description copied from interface: AmazonRoute53

        Gets information about a specific traffic policy version. To get the information, send a GET request to the /Route 53 API version/trafficpolicy resource.

        Specified by:
        getTrafficPolicy in interface AmazonRoute53
        Parameters:
        request - Gets information about a specific traffic policy version. To get the information, send a GET request to the /Route 53 API version/trafficpolicy resource, and specify the ID and the version of the traffic policy.
        Returns:
        Result of the GetTrafficPolicy operation returned by the service.
      • getTrafficPolicyInstance

        public GetTrafficPolicyInstanceResult getTrafficPolicyInstance​(GetTrafficPolicyInstanceRequest request)
        Description copied from interface: AmazonRoute53

        Gets information about a specified traffic policy instance.

        To get information about the traffic policy instance, send a GET request to the /Route 53 API version/trafficpolicyinstance resource.

        After you submit a CreateTrafficPolicyInstance or an UpdateTrafficPolicyInstance request, there's a brief delay while Amazon Route 53 creates the resource record sets that are specified in the traffic policy definition. For more information, see the State response element.
        Specified by:
        getTrafficPolicyInstance in interface AmazonRoute53
        Parameters:
        request - Gets information about a specified traffic policy instance.

        To get information about a traffic policy instance, send a GET request to the /Route 53 API version/trafficpolicyinstance/Id resource.

        Returns:
        Result of the GetTrafficPolicyInstance operation returned by the service.
      • getTrafficPolicyInstanceCount

        public GetTrafficPolicyInstanceCountResult getTrafficPolicyInstanceCount​(GetTrafficPolicyInstanceCountRequest request)
        Description copied from interface: AmazonRoute53

        Gets the number of traffic policy instances that are associated with the current AWS account.

        To get the number of traffic policy instances, send a GET request to the /Route 53 API version/trafficpolicyinstancecount resource.

        Specified by:
        getTrafficPolicyInstanceCount in interface AmazonRoute53
        Parameters:
        request - To retrieve a count of all your traffic policy instances, send a GET request to the /Route 53 API version/trafficpolicyinstancecount resource.
        Returns:
        Result of the GetTrafficPolicyInstanceCount operation returned by the service.
      • listGeoLocations

        public ListGeoLocationsResult listGeoLocations​(ListGeoLocationsRequest request)
        Description copied from interface: AmazonRoute53

        To retrieve a list of supported geo locations, send a GET request to the /Route 53 API version/geolocations resource. The response to this request includes a GeoLocationDetailsList element with zero, one, or multiple GeoLocationDetails child elements. The list is sorted by country code, and then subdivision code, followed by continents at the end of the list.

        By default, the list of geo locations is displayed on a single page. You can control the length of the page that is displayed by using the MaxItems parameter. If the list is truncated, IsTruncated will be set to true and a combination of NextContinentCode, NextCountryCode, NextSubdivisionCode will be populated. You can pass these as parameters to StartContinentCode, StartCountryCode, StartSubdivisionCode to control the geo location that the list begins with.

        Specified by:
        listGeoLocations in interface AmazonRoute53
        Parameters:
        request - The input for a ListGeoLocations request.
        Returns:
        Result of the ListGeoLocations operation returned by the service.
      • listHealthChecks

        public ListHealthChecksResult listHealthChecks​(ListHealthChecksRequest request)
        Description copied from interface: AmazonRoute53

        To retrieve a list of your health checks, send a GET request to the /Route 53 API version/healthcheck resource. The response to this request includes a HealthChecks element with zero, one, or multiple HealthCheck child elements. By default, the list of health checks is displayed on a single page. You can control the length of the page that is displayed by using the MaxItems parameter. You can use the Marker parameter to control the health check that the list begins with.

        Amazon Route 53 returns a maximum of 100 items. If you set MaxItems to a value greater than 100, Amazon Route 53 returns only the first 100.
        Specified by:
        listHealthChecks in interface AmazonRoute53
        Parameters:
        request - To retrieve a list of your health checks, send a GET request to the /Route 53 API version/healthcheck resource. The response to this request includes a HealthChecks element with zero or more HealthCheck child elements. By default, the list of health checks is displayed on a single page. You can control the length of the page that is displayed by using the MaxItems parameter. You can use the Marker parameter to control the health check that the list begins with.

        Amazon Route 53 returns a maximum of 100 items. If you set MaxItems to a value greater than 100, Amazon Route 53 returns only the first 100.
        Returns:
        Result of the ListHealthChecks operation returned by the service.
      • listHostedZones

        public ListHostedZonesResult listHostedZones​(ListHostedZonesRequest request)
        Description copied from interface: AmazonRoute53

        To retrieve a list of your hosted zones, send a GET request to the /Route 53 API version/hostedzone resource. The response to this request includes a HostedZones element with zero, one, or multiple HostedZone child elements. By default, the list of hosted zones is displayed on a single page. You can control the length of the page that is displayed by using the MaxItems parameter. You can use the Marker parameter to control the hosted zone that the list begins with.

        Amazon Route 53 returns a maximum of 100 items. If you set MaxItems to a value greater than 100, Amazon Route 53 returns only the first 100.
        Specified by:
        listHostedZones in interface AmazonRoute53
        Parameters:
        request - To retrieve a list of your hosted zones, send a GET request to the /Route 53 API version/hostedzone resource. The response to this request includes a HostedZones element with zero or more HostedZone child elements. By default, the list of hosted zones is displayed on a single page. You can control the length of the page that is displayed by using the MaxItems parameter. You can use the Marker parameter to control the hosted zone that the list begins with. For more information about listing hosted zones, see Listing the Hosted Zones for an AWS Account in the Amazon Route 53 Developer Guide.

        Amazon Route 53 returns a maximum of 100 items. If you set MaxItems to a value greater than 100, Amazon Route 53 returns only the first 100.
        Returns:
        Result of the ListHostedZones operation returned by the service.
      • listHostedZonesByName

        public ListHostedZonesByNameResult listHostedZonesByName​(ListHostedZonesByNameRequest request)
        Description copied from interface: AmazonRoute53

        To retrieve a list of your hosted zones in lexicographic order, send a GET request to the /Route 53 API version/hostedzonesbyname resource. The response to this request includes a HostedZones element with zero or more HostedZone child elements lexicographically ordered by DNS name. By default, the list of hosted zones is displayed on a single page. You can control the length of the page that is displayed by using the MaxItems parameter. You can use the DNSName and HostedZoneId parameters to control the hosted zone that the list begins with.

        Amazon Route 53 returns a maximum of 100 items. If you set MaxItems to a value greater than 100, Amazon Route 53 returns only the first 100.
        Specified by:
        listHostedZonesByName in interface AmazonRoute53
        Parameters:
        request - To retrieve a list of your hosted zones in lexicographic order, send a GET request to the /Route 53 API version/hostedzonesbyname resource. The response to this request includes a HostedZones element with zero or more HostedZone child elements lexicographically ordered by DNS name. By default, the list of hosted zones is displayed on a single page. You can control the length of the page that is displayed by using the MaxItems parameter. You can use the DNSName and HostedZoneId parameters to control the hosted zone that the list begins with.

        For more information about listing hosted zones, see Listing the Hosted Zones for an AWS Account in the Amazon Route 53 Developer Guide.

        Returns:
        Result of the ListHostedZonesByName operation returned by the service.
      • listResourceRecordSets

        public ListResourceRecordSetsResult listResourceRecordSets​(ListResourceRecordSetsRequest request)
        Description copied from interface: AmazonRoute53

        Imagine all the resource record sets in a zone listed out in front of you. Imagine them sorted lexicographically first by DNS name (with the labels reversed, like "com.amazon.www" for example), and secondarily, lexicographically by record type. This operation retrieves at most MaxItems resource record sets from this list, in order, starting at a position specified by the Name and Type arguments:

        • If both Name and Type are omitted, this means start the results at the first RRSET in the HostedZone.
        • If Name is specified but Type is omitted, this means start the results at the first RRSET in the list whose name is greater than or equal to Name.
        • If both Name and Type are specified, this means start the results at the first RRSET in the list whose name is greater than or equal to Name and whose type is greater than or equal to Type.
        • It is an error to specify the Type but not the Name.

        Use ListResourceRecordSets to retrieve a single known record set by specifying the record set's name and type, and setting MaxItems = 1

        To retrieve all the records in a HostedZone, first pause any processes making calls to ChangeResourceRecordSets. Initially call ListResourceRecordSets without a Name and Type to get the first page of record sets. For subsequent calls, set Name and Type to the NextName and NextType values returned by the previous response.

        In the presence of concurrent ChangeResourceRecordSets calls, there is no consistency of results across calls to ListResourceRecordSets. The only way to get a consistent multi-page snapshot of all RRSETs in a zone is to stop making changes while pagination is in progress.

        However, the results from ListResourceRecordSets are consistent within a page. If MakeChange calls are taking place concurrently, the result of each one will either be completely visible in your results or not at all. You will not see partial changes, or changes that do not ultimately succeed. (This follows from the fact that MakeChange is atomic)

        The results from ListResourceRecordSets are strongly consistent with ChangeResourceRecordSets. To be precise, if a single process makes a call to ChangeResourceRecordSets and receives a successful response, the effects of that change will be visible in a subsequent call to ListResourceRecordSets by that process.

        Specified by:
        listResourceRecordSets in interface AmazonRoute53
        Parameters:
        request - The input for a ListResourceRecordSets request.
        Returns:
        Result of the ListResourceRecordSets operation returned by the service.
      • listReusableDelegationSets

        public ListReusableDelegationSetsResult listReusableDelegationSets​(ListReusableDelegationSetsRequest request)
        Description copied from interface: AmazonRoute53

        To retrieve a list of your reusable delegation sets, send a GET request to the /Route 53 API version/delegationset resource. The response to this request includes a DelegationSets element with zero, one, or multiple DelegationSet child elements. By default, the list of delegation sets is displayed on a single page. You can control the length of the page that is displayed by using the MaxItems parameter. You can use the Marker parameter to control the delegation set that the list begins with.

        Amazon Route 53 returns a maximum of 100 items. If you set MaxItems to a value greater than 100, Amazon Route 53 returns only the first 100.
        Specified by:
        listReusableDelegationSets in interface AmazonRoute53
        Parameters:
        request - To retrieve a list of your reusable delegation sets, send a GET request to the /Route 53 API version/delegationset resource. The response to this request includes a DelegationSets element with zero or more DelegationSet child elements. By default, the list of reusable delegation sets is displayed on a single page. You can control the length of the page that is displayed by using the MaxItems parameter. You can use the Marker parameter to control the delegation set that the list begins with.

        Amazon Route 53 returns a maximum of 100 items. If you set MaxItems to a value greater than 100, Amazon Route 53 returns only the first 100.
        Returns:
        Result of the ListReusableDelegationSets operation returned by the service.
      • listTrafficPolicies

        public ListTrafficPoliciesResult listTrafficPolicies​(ListTrafficPoliciesRequest request)
        Description copied from interface: AmazonRoute53

        Gets information about the latest version for every traffic policy that is associated with the current AWS account. To get the information, send a GET request to the /Route 53 API version/trafficpolicy resource.

        Amazon Route 53 returns a maximum of 100 items in each response. If you have a lot of traffic policies, you can use the maxitems parameter to list them in groups of up to 100.

        The response includes three values that help you navigate from one group of maxitems traffic policies to the next:

        • IsTruncated
        • If the value of IsTruncated in the response is true, there are more traffic policies associated with the current AWS account.

          If IsTruncated is false, this response includes the last traffic policy that is associated with the current account.

        • TrafficPolicyIdMarker
        • If IsTruncated is true, TrafficPolicyIdMarker is the ID of the first traffic policy in the next group of MaxItems traffic policies. If you want to list more traffic policies, make another call to ListTrafficPolicies, and specify the value of the TrafficPolicyIdMarker element from the response in the TrafficPolicyIdMarker request parameter.

          If IsTruncated is false, the TrafficPolicyIdMarker element is omitted from the response.

        • MaxItems
        • The value that you specified for the MaxItems parameter in the request that produced the current response.

        Specified by:
        listTrafficPolicies in interface AmazonRoute53
        Parameters:
        request - A complex type that contains the information about the request to list the traffic policies that are associated with the current AWS account.
        Returns:
        Result of the ListTrafficPolicies operation returned by the service.
      • listTrafficPolicyInstances

        public ListTrafficPolicyInstancesResult listTrafficPolicyInstances​(ListTrafficPolicyInstancesRequest request)
        Description copied from interface: AmazonRoute53

        Gets information about the traffic policy instances that you created by using the current AWS account.

        After you submit an UpdateTrafficPolicyInstance request, there's a brief delay while Amazon Route 53 creates the resource record sets that are specified in the traffic policy definition. For more information, see the State response element.

        To get information about the traffic policy instances that are associated with the current AWS account, send a GET request to the /Route 53 API version/trafficpolicyinstance resource.

        Amazon Route 53 returns a maximum of 100 items in each response. If you have a lot of traffic policy instances, you can use the MaxItems parameter to list them in groups of up to 100.

        The response includes five values that help you navigate from one group of MaxItems traffic policy instances to the next:

        • IsTruncated
        • If the value of IsTruncated in the response is true, there are more traffic policy instances associated with the current AWS account.

          If IsTruncated is false, this response includes the last traffic policy instance that is associated with the current account.

        • MaxItems
        • The value that you specified for the MaxItems parameter in the request that produced the current response.

        • HostedZoneIdMarker, TrafficPolicyInstanceNameMarker, and TrafficPolicyInstanceTypeMarker
        • If IsTruncated is true, these three values in the response represent the first traffic policy instance in the next group of MaxItems traffic policy instances. To list more traffic policy instances, make another call to ListTrafficPolicyInstances, and specify these values in the corresponding request parameters.

          If IsTruncated is false, all three elements are omitted from the response.

        Specified by:
        listTrafficPolicyInstances in interface AmazonRoute53
        Parameters:
        request - A complex type that contains the information about the request to list your traffic policy instances.
        Returns:
        Result of the ListTrafficPolicyInstances operation returned by the service.
      • listTrafficPolicyInstancesByHostedZone

        public ListTrafficPolicyInstancesByHostedZoneResult listTrafficPolicyInstancesByHostedZone​(ListTrafficPolicyInstancesByHostedZoneRequest request)
        Description copied from interface: AmazonRoute53

        Gets information about the traffic policy instances that you created in a specified hosted zone.

        After you submit an UpdateTrafficPolicyInstance request, there's a brief delay while Amazon Route 53 creates the resource record sets that are specified in the traffic policy definition. For more information, see the State response element.

        To get information about the traffic policy instances that you created in a specified hosted zone, send a GET request to the /Route 53 API version/trafficpolicyinstance resource and include the ID of the hosted zone.

        Amazon Route 53 returns a maximum of 100 items in each response. If you have a lot of traffic policy instances, you can use the MaxItems parameter to list them in groups of up to 100.

        The response includes four values that help you navigate from one group of MaxItems traffic policy instances to the next:

        • IsTruncated
        • If the value of IsTruncated in the response is true, there are more traffic policy instances associated with the current AWS account.

          If IsTruncated is false, this response includes the last traffic policy instance that is associated with the current account.

        • MaxItems
        • The value that you specified for the MaxItems parameter in the request that produced the current response.

        • TrafficPolicyInstanceNameMarker and TrafficPolicyInstanceTypeMarker
        • If IsTruncated is true, these two values in the response represent the first traffic policy instance in the next group of MaxItems traffic policy instances. To list more traffic policy instances, make another call to ListTrafficPolicyInstancesByHostedZone, and specify these values in the corresponding request parameters.

          If IsTruncated is false, all three elements are omitted from the response.

        Specified by:
        listTrafficPolicyInstancesByHostedZone in interface AmazonRoute53
        Parameters:
        request - A request for the traffic policy instances that you created in a specified hosted zone.
        Returns:
        Result of the ListTrafficPolicyInstancesByHostedZone operation returned by the service.
      • listTrafficPolicyInstancesByPolicy

        public ListTrafficPolicyInstancesByPolicyResult listTrafficPolicyInstancesByPolicy​(ListTrafficPolicyInstancesByPolicyRequest request)
        Description copied from interface: AmazonRoute53

        Gets information about the traffic policy instances that you created by using a specify traffic policy version.

        After you submit a CreateTrafficPolicyInstance or an UpdateTrafficPolicyInstance request, there's a brief delay while Amazon Route 53 creates the resource record sets that are specified in the traffic policy definition. For more information, see the State response element.

        To get information about the traffic policy instances that you created by using a specify traffic policy version, send a GET request to the /Route 53 API version/trafficpolicyinstance resource and include the ID and version of the traffic policy.

        Amazon Route 53 returns a maximum of 100 items in each response. If you have a lot of traffic policy instances, you can use the MaxItems parameter to list them in groups of up to 100.

        The response includes five values that help you navigate from one group of MaxItems traffic policy instances to the next:

        • IsTruncated

          If the value of IsTruncated in the response is true, there are more traffic policy instances associated with the specified traffic policy.

          If IsTruncated is false, this response includes the last traffic policy instance that is associated with the specified traffic policy.

        • MaxItems

          The value that you specified for the MaxItems parameter in the request that produced the current response.

        • HostedZoneIdMarker, TrafficPolicyInstanceNameMarker, and TrafficPolicyInstanceTypeMarker

          If IsTruncated is true, these values in the response represent the first traffic policy instance in the next group of MaxItems traffic policy instances. To list more traffic policy instances, make another call to ListTrafficPolicyInstancesByPolicy, and specify these values in the corresponding request parameters.

          If IsTruncated is false, all three elements are omitted from the response.

        Specified by:
        listTrafficPolicyInstancesByPolicy in interface AmazonRoute53
        Parameters:
        request - A complex type that contains the information about the request to list your traffic policy instances.
        Returns:
        Result of the ListTrafficPolicyInstancesByPolicy operation returned by the service.
      • listTrafficPolicyVersions

        public ListTrafficPolicyVersionsResult listTrafficPolicyVersions​(ListTrafficPolicyVersionsRequest request)
        Description copied from interface: AmazonRoute53

        Gets information about all of the versions for a specified traffic policy. ListTrafficPolicyVersions lists only versions that have not been deleted.

        Amazon Route 53 returns a maximum of 100 items in each response. If you have a lot of traffic policies, you can use the maxitems parameter to list them in groups of up to 100.

        The response includes three values that help you navigate from one group of maxitemsmaxitems traffic policies to the next:

        • IsTruncated
        • If the value of IsTruncated in the response is true, there are more traffic policy versions associated with the specified traffic policy.

          If IsTruncated is false, this response includes the last traffic policy version that is associated with the specified traffic policy.

        • TrafficPolicyVersionMarker
        • The ID of the next traffic policy version that is associated with the current AWS account. If you want to list more traffic policies, make another call to ListTrafficPolicyVersions, and specify the value of the TrafficPolicyVersionMarker element in the TrafficPolicyVersionMarker request parameter.

          If IsTruncated is false, Amazon Route 53 omits the TrafficPolicyVersionMarker element from the response.

        • MaxItems
        • The value that you specified for the MaxItems parameter in the request that produced the current response.

        Specified by:
        listTrafficPolicyVersions in interface AmazonRoute53
        Parameters:
        request - A complex type that contains the information about the request to list your traffic policies.
        Returns:
        Result of the ListTrafficPolicyVersions operation returned by the service.
      • updateHealthCheck

        public UpdateHealthCheckResult updateHealthCheck​(UpdateHealthCheckRequest request)
        Description copied from interface: AmazonRoute53

        This action updates an existing health check.

        To update a health check, send a POST request to the /Route 53 API version/healthcheck/health check ID resource. The request body must include a document with an UpdateHealthCheckRequest element. The response returns an UpdateHealthCheckResponse element, which contains metadata about the health check.

        Specified by:
        updateHealthCheck in interface AmazonRoute53
        Parameters:
        request - >A complex type that contains information about the request to update a health check.
        Returns:
        Result of the UpdateHealthCheck operation returned by the service.
      • updateHostedZoneComment

        public UpdateHostedZoneCommentResult updateHostedZoneComment​(UpdateHostedZoneCommentRequest request)
        Description copied from interface: AmazonRoute53

        To update the hosted zone comment, send a POST request to the /Route 53 API version/hostedzone/hosted zone ID resource. The request body must include a document with a UpdateHostedZoneCommentRequest element. The response to this request includes the modified HostedZone element.

        The comment can have a maximum length of 256 characters.
        Specified by:
        updateHostedZoneComment in interface AmazonRoute53
        Parameters:
        request - A complex type that contains information about the request to update a hosted zone comment.
        Returns:
        Result of the UpdateHostedZoneComment operation returned by the service.
      • updateTrafficPolicyComment

        public UpdateTrafficPolicyCommentResult updateTrafficPolicyComment​(UpdateTrafficPolicyCommentRequest request)
        Description copied from interface: AmazonRoute53

        Updates the comment for a specified traffic policy version.

        To update the comment, send a POST request to the /Route 53 API version/trafficpolicy/ resource.

        The request body must include a document with an UpdateTrafficPolicyCommentRequest element.

        Specified by:
        updateTrafficPolicyComment in interface AmazonRoute53
        Parameters:
        request - A complex type that contains information about the traffic policy for which you want to update the comment.
        Returns:
        Result of the UpdateTrafficPolicyComment operation returned by the service.
      • updateTrafficPolicyInstance

        public UpdateTrafficPolicyInstanceResult updateTrafficPolicyInstance​(UpdateTrafficPolicyInstanceRequest request)
        Description copied from interface: AmazonRoute53

        Updates the resource record sets in a specified hosted zone that were created based on the settings in a specified traffic policy version.

        The DNS type of the resource record sets that you're updating must match the DNS type in the JSON document that is associated with the traffic policy version that you're using to update the traffic policy instance.

        When you update a traffic policy instance, Amazon Route 53 continues to respond to DNS queries for the root resource record set name (such as example.com) while it replaces one group of resource record sets with another. Amazon Route 53 performs the following operations:

        1. Amazon Route 53 creates a new group of resource record sets based on the specified traffic policy. This is true regardless of how substantial the differences are between the existing resource record sets and the new resource record sets.
        2. When all of the new resource record sets have been created, Amazon Route 53 starts to respond to DNS queries for the root resource record set name (such as example.com) by using the new resource record sets.
        3. Amazon Route 53 deletes the old group of resource record sets that are associated with the root resource record set name.

        To update a traffic policy instance, send a POST request to the /Route 53 API version/trafficpolicyinstance/traffic policy ID resource. The request body must include a document with an UpdateTrafficPolicyInstanceRequest element.

        Specified by:
        updateTrafficPolicyInstance in interface AmazonRoute53
        Parameters:
        request - A complex type that contains information about the resource record sets that you want to update based on a specified traffic policy instance.
        Returns:
        Result of the UpdateTrafficPolicyInstance operation returned by the service.
      • shutdown

        public void shutdown()
        Description copied from interface: AmazonRoute53
        Shuts down this client object, releasing any resources that might be held open. This is an optional method, and callers are not expected to call it, but can if they want to explicitly release any open resources. Once a client has been shutdown, it should not be used to make any more requests.
        Specified by:
        shutdown in interface AmazonRoute53
      • getCachedResponseMetadata

        public ResponseMetadata getCachedResponseMetadata​(AmazonWebServiceRequest request)
        Description copied from interface: AmazonRoute53
        Returns additional metadata for a previously executed successful request, typically used for debugging issues where a service isn't acting as expected. This data isn't considered part of the result data returned by an operation, so it's available through this separate, diagnostic interface.

        Response metadata is only cached for a limited period of time, so if you need to access this extra diagnostic information for an executed request, you should use this method to retrieve it as soon as possible after executing a request.

        Specified by:
        getCachedResponseMetadata in interface AmazonRoute53
        Parameters:
        request - The originally executed request.
        Returns:
        The response metadata for the specified request, or null if none is available.