com.amazonaws.services.route53

Interface AmazonRoute53

All Known Subinterfaces:

AmazonRoute53Async

All Known Implementing Classes:

AmazonRoute53AsyncClient, AmazonRoute53Client

public interface AmazonRoute53

Interface for accessing AmazonRoute53.

Method Summary

Methods

Modifier and Type	Method and Description
AssociateVPCWithHostedZoneResult	associateVPCWithHostedZone(AssociateVPCWithHostedZoneRequest associateVPCWithHostedZoneRequest) This action associates a VPC with an hosted zone.
ChangeResourceRecordSetsResult	changeResourceRecordSets(ChangeResourceRecordSetsRequest changeResourceRecordSetsRequest) Use this action to create or change your authoritative DNS information.
ChangeTagsForResourceResult	changeTagsForResource(ChangeTagsForResourceRequest changeTagsForResourceRequest)
CreateHealthCheckResult	createHealthCheck(CreateHealthCheckRequest createHealthCheckRequest) This action creates a new health check.
CreateHostedZoneResult	createHostedZone(CreateHostedZoneRequest createHostedZoneRequest) This action creates a new hosted zone.
CreateReusableDelegationSetResult	createReusableDelegationSet(CreateReusableDelegationSetRequest createReusableDelegationSetRequest) This action creates a reusable delegationSet.
CreateTrafficPolicyResult	createTrafficPolicy(CreateTrafficPolicyRequest createTrafficPolicyRequest) 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).
CreateTrafficPolicyInstanceResult	createTrafficPolicyInstance(CreateTrafficPolicyInstanceRequest createTrafficPolicyInstanceRequest) Creates resource record sets in a specified hosted zone based on the settings in a specified traffic policy version.
CreateTrafficPolicyVersionResult	createTrafficPolicyVersion(CreateTrafficPolicyVersionRequest createTrafficPolicyVersionRequest) Creates a new version of an existing traffic policy.
DeleteHealthCheckResult	deleteHealthCheck(DeleteHealthCheckRequest deleteHealthCheckRequest) This action deletes a health check.
DeleteHostedZoneResult	deleteHostedZone(DeleteHostedZoneRequest deleteHostedZoneRequest) This action deletes a hosted zone.
DeleteReusableDelegationSetResult	deleteReusableDelegationSet(DeleteReusableDelegationSetRequest deleteReusableDelegationSetRequest) This action deletes a reusable delegation set.
DeleteTrafficPolicyResult	deleteTrafficPolicy(DeleteTrafficPolicyRequest deleteTrafficPolicyRequest) Deletes a traffic policy.
DeleteTrafficPolicyInstanceResult	deleteTrafficPolicyInstance(DeleteTrafficPolicyInstanceRequest deleteTrafficPolicyInstanceRequest) Deletes a traffic policy instance and all of the resource record sets that Amazon Route 53 created when you created the instance.
DisassociateVPCFromHostedZoneResult	disassociateVPCFromHostedZone(DisassociateVPCFromHostedZoneRequest disassociateVPCFromHostedZoneRequest) This action disassociates a VPC from an hosted zone.
ResponseMetadata	getCachedResponseMetadata(AmazonWebServiceRequest request) Returns additional metadata for a previously executed successful request, typically used for debugging issues where a service isn't acting as expected.
GetChangeResult	getChange(GetChangeRequest getChangeRequest) This action returns the current status of a change batch request.
GetChangeDetailsResult	getChangeDetails(GetChangeDetailsRequest getChangeDetailsRequest) This action returns the status and changes of a change batch request.
GetCheckerIpRangesResult	getCheckerIpRanges() 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 2013-04-01/checkeripranges resource.
GetCheckerIpRangesResult	getCheckerIpRanges(GetCheckerIpRangesRequest getCheckerIpRangesRequest) 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 2013-04-01/checkeripranges resource.
GetGeoLocationResult	getGeoLocation() To retrieve a single geo location, send a GET request to the 2013-04-01/geolocation resource with one of these options: continentcode | countrycode | countrycode and subdivisioncode.
GetGeoLocationResult	getGeoLocation(GetGeoLocationRequest getGeoLocationRequest) To retrieve a single geo location, send a GET request to the 2013-04-01/geolocation resource with one of these options: continentcode | countrycode | countrycode and subdivisioncode.
GetHealthCheckResult	getHealthCheck(GetHealthCheckRequest getHealthCheckRequest) To retrieve the health check, send a GET request to the 2013-04-01/healthcheck/health check ID resource.
GetHealthCheckCountResult	getHealthCheckCount() To retrieve a count of all your health checks, send a GET request to the 2013-04-01/healthcheckcount resource.
GetHealthCheckCountResult	getHealthCheckCount(GetHealthCheckCountRequest getHealthCheckCountRequest) To retrieve a count of all your health checks, send a GET request to the 2013-04-01/healthcheckcount resource.
GetHealthCheckLastFailureReasonResult	getHealthCheckLastFailureReason(GetHealthCheckLastFailureReasonRequest getHealthCheckLastFailureReasonRequest) 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.
GetHealthCheckStatusResult	getHealthCheckStatus(GetHealthCheckStatusRequest getHealthCheckStatusRequest) To retrieve the health check status, send a GET request to the 2013-04-01/healthcheck/health check ID/status resource.
GetHostedZoneResult	getHostedZone(GetHostedZoneRequest getHostedZoneRequest) To retrieve the delegation set for a hosted zone, send a GET request to the 2013-04-01/hostedzone/hosted zone ID resource.
GetHostedZoneCountResult	getHostedZoneCount() To retrieve a count of all your hosted zones, send a GET request to the 2013-04-01/hostedzonecount resource.
GetHostedZoneCountResult	getHostedZoneCount(GetHostedZoneCountRequest getHostedZoneCountRequest) To retrieve a count of all your hosted zones, send a GET request to the 2013-04-01/hostedzonecount resource.
GetReusableDelegationSetResult	getReusableDelegationSet(GetReusableDelegationSetRequest getReusableDelegationSetRequest) To retrieve the reusable delegation set, send a GET request to the 2013-04-01/delegationset/delegation set ID resource.
GetTrafficPolicyResult	getTrafficPolicy(GetTrafficPolicyRequest getTrafficPolicyRequest) Gets information about a specific traffic policy version.
GetTrafficPolicyInstanceResult	getTrafficPolicyInstance(GetTrafficPolicyInstanceRequest getTrafficPolicyInstanceRequest) Gets information about a specified traffic policy instance.
GetTrafficPolicyInstanceCountResult	getTrafficPolicyInstanceCount() Gets the number of traffic policy instances that are associated with the current AWS account.
GetTrafficPolicyInstanceCountResult	getTrafficPolicyInstanceCount(GetTrafficPolicyInstanceCountRequest getTrafficPolicyInstanceCountRequest) Gets the number of traffic policy instances that are associated with the current AWS account.
ListChangeBatchesByHostedZoneResult	listChangeBatchesByHostedZone(ListChangeBatchesByHostedZoneRequest listChangeBatchesByHostedZoneRequest) This action gets the list of ChangeBatches in a given time period for a given hosted zone.
ListChangeBatchesByRRSetResult	listChangeBatchesByRRSet(ListChangeBatchesByRRSetRequest listChangeBatchesByRRSetRequest) This action gets the list of ChangeBatches in a given time period for a given hosted zone and RRSet.
ListGeoLocationsResult	listGeoLocations() To retrieve a list of supported geo locations, send a GET request to the 2013-04-01/geolocations resource.
ListGeoLocationsResult	listGeoLocations(ListGeoLocationsRequest listGeoLocationsRequest) To retrieve a list of supported geo locations, send a GET request to the 2013-04-01/geolocations resource.
ListHealthChecksResult	listHealthChecks() To retrieve a list of your health checks, send a GET request to the 2013-04-01/healthcheck resource.
ListHealthChecksResult	listHealthChecks(ListHealthChecksRequest listHealthChecksRequest) To retrieve a list of your health checks, send a GET request to the 2013-04-01/healthcheck resource.
ListHostedZonesResult	listHostedZones() To retrieve a list of your hosted zones, send a GET request to the 2013-04-01/hostedzone resource.
ListHostedZonesResult	listHostedZones(ListHostedZonesRequest listHostedZonesRequest) To retrieve a list of your hosted zones, send a GET request to the 2013-04-01/hostedzone resource.
ListHostedZonesByNameResult	listHostedZonesByName() To retrieve a list of your hosted zones in lexicographic order, send a GET request to the 2013-04-01/hostedzonesbyname resource.
ListHostedZonesByNameResult	listHostedZonesByName(ListHostedZonesByNameRequest listHostedZonesByNameRequest) To retrieve a list of your hosted zones in lexicographic order, send a GET request to the 2013-04-01/hostedzonesbyname resource.
ListResourceRecordSetsResult	listResourceRecordSets(ListResourceRecordSetsRequest listResourceRecordSetsRequest) Imagine all the resource record sets in a zone listed out in front of you.
ListReusableDelegationSetsResult	listReusableDelegationSets() To retrieve a list of your reusable delegation sets, send a GET request to the 2013-04-01/delegationset resource.
ListReusableDelegationSetsResult	listReusableDelegationSets(ListReusableDelegationSetsRequest listReusableDelegationSetsRequest) To retrieve a list of your reusable delegation sets, send a GET request to the 2013-04-01/delegationset resource.
ListTagsForResourceResult	listTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest)
ListTagsForResourcesResult	listTagsForResources(ListTagsForResourcesRequest listTagsForResourcesRequest)
ListTrafficPoliciesResult	listTrafficPolicies() Gets information about the latest version for every traffic policy that is associated with the current AWS account.
ListTrafficPoliciesResult	listTrafficPolicies(ListTrafficPoliciesRequest listTrafficPoliciesRequest) Gets information about the latest version for every traffic policy that is associated with the current AWS account.
ListTrafficPolicyInstancesResult	listTrafficPolicyInstances() Gets information about the traffic policy instances that you created by using the current AWS account.
ListTrafficPolicyInstancesResult	listTrafficPolicyInstances(ListTrafficPolicyInstancesRequest listTrafficPolicyInstancesRequest) Gets information about the traffic policy instances that you created by using the current AWS account.
ListTrafficPolicyInstancesByHostedZoneResult	listTrafficPolicyInstancesByHostedZone(ListTrafficPolicyInstancesByHostedZoneRequest listTrafficPolicyInstancesByHostedZoneRequest) Gets information about the traffic policy instances that you created in a specified hosted zone.
ListTrafficPolicyInstancesByPolicyResult	listTrafficPolicyInstancesByPolicy(ListTrafficPolicyInstancesByPolicyRequest listTrafficPolicyInstancesByPolicyRequest) Gets information about the traffic policy instances that you created by using a specify traffic policy version.
ListTrafficPolicyVersionsResult	listTrafficPolicyVersions(ListTrafficPolicyVersionsRequest listTrafficPolicyVersionsRequest) Gets information about all of the versions for a specified traffic policy.
void	setEndpoint(String endpoint) Overrides the default endpoint for this client ("https://route53.amazonaws.com").
void	setRegion(Region region) An alternative to setEndpoint(String), sets the regional endpoint for this client's service calls.
void	shutdown() Shuts down this client object, releasing any resources that might be held open.
UpdateHealthCheckResult	updateHealthCheck(UpdateHealthCheckRequest updateHealthCheckRequest) This action updates an existing health check.
UpdateHostedZoneCommentResult	updateHostedZoneComment(UpdateHostedZoneCommentRequest updateHostedZoneCommentRequest) To update the hosted zone comment, send a POST request to the 2013-04-01/hostedzone/hosted zone ID resource.
UpdateTrafficPolicyCommentResult	updateTrafficPolicyComment(UpdateTrafficPolicyCommentRequest updateTrafficPolicyCommentRequest) Updates the comment for a specified traffic policy version.
UpdateTrafficPolicyInstanceResult	updateTrafficPolicyInstance(UpdateTrafficPolicyInstanceRequest updateTrafficPolicyInstanceRequest) Updates the resource record sets in a specified hosted zone that were created based on the settings in a specified traffic policy version.

Method Detail

setEndpoint

void setEndpoint(String endpoint)
                 throws IllegalArgumentException

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.

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.

Throws:

IllegalArgumentException - If any problems are detected with the specified endpoint.

setRegion

void setRegion(Region region)
               throws IllegalArgumentException

An alternative to setEndpoint(String), sets the regional endpoint for this client's service calls. Callers can use this method to control which AWS region they want to work with.

By default, all service endpoints in all regions use the https protocol. To use http instead, specify it in the ClientConfiguration supplied at construction.

This method is not threadsafe. A region 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.

Parameters:

region - The region this client will communicate with. See Region.getRegion(com.amazonaws.regions.Regions) for accessing a given region.

Throws:

IllegalArgumentException - If the given region is null, or if this service isn't available in the given region. See Region.isServiceSupported(String)

See Also:

Region.getRegion(com.amazonaws.regions.Regions), Region.createClient(Class, com.amazonaws.auth.AWSCredentialsProvider, ClientConfiguration)

getTrafficPolicyInstance

GetTrafficPolicyInstanceResult getTrafficPolicyInstance(GetTrafficPolicyInstanceRequest getTrafficPolicyInstanceRequest)
                                                        throws AmazonServiceException,
                                                               AmazonClientException

Gets information about a specified traffic policy instance.

To get information about the traffic policy instance, send a GET request to the 2013-04-01/trafficpolicyinstance resource.

NOTE: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.

Parameters:

getTrafficPolicyInstanceRequest - Container for the necessary parameters to execute the GetTrafficPolicyInstance service method on AmazonRoute53.

Returns:

The response from the GetTrafficPolicyInstance service method, as returned by AmazonRoute53.

Throws:

InvalidInputException

NoSuchTrafficPolicyInstanceException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.

createTrafficPolicy

CreateTrafficPolicyResult createTrafficPolicy(CreateTrafficPolicyRequest createTrafficPolicyRequest)
                                              throws AmazonServiceException,
                                                     AmazonClientException

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 2013-04-01/trafficpolicy resource. The request body must include an XML document with a CreateTrafficPolicyRequest element. The response includes the CreateTrafficPolicyResponse element, which contains information about the new traffic policy.

Parameters:

createTrafficPolicyRequest - Container for the necessary parameters to execute the CreateTrafficPolicy service method on AmazonRoute53.

Returns:

The response from the CreateTrafficPolicy service method, as returned by AmazonRoute53.

Throws:

InvalidTrafficPolicyDocumentException

InvalidInputException

TrafficPolicyAlreadyExistsException

TooManyTrafficPoliciesException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.

updateTrafficPolicyComment

UpdateTrafficPolicyCommentResult updateTrafficPolicyComment(UpdateTrafficPolicyCommentRequest updateTrafficPolicyCommentRequest)
                                                            throws AmazonServiceException,
                                                                   AmazonClientException

Updates the comment for a specified traffic policy version.

To update the comment, send a POST request to the /2013-04-01/trafficpolicy/ resource.

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

Parameters:

updateTrafficPolicyCommentRequest - Container for the necessary parameters to execute the UpdateTrafficPolicyComment service method on AmazonRoute53.

Returns:

The response from the UpdateTrafficPolicyComment service method, as returned by AmazonRoute53.

Throws:

ConcurrentModificationException

NoSuchTrafficPolicyException

InvalidInputException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.

getHostedZone

GetHostedZoneResult getHostedZone(GetHostedZoneRequest getHostedZoneRequest)
                                  throws AmazonServiceException,
                                         AmazonClientException

To retrieve the delegation set for a hosted zone, send a GET request to the 2013-04-01/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.

Parameters:

getHostedZoneRequest - Container for the necessary parameters to execute the GetHostedZone service method on AmazonRoute53.

Returns:

The response from the GetHostedZone service method, as returned by AmazonRoute53.

Throws:

NoSuchHostedZoneException

InvalidInputException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.

getChange

GetChangeResult getChange(GetChangeRequest getChangeRequest)
                          throws AmazonServiceException,
                                 AmazonClientException

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.

Parameters:

getChangeRequest - Container for the necessary parameters to execute the GetChange service method on AmazonRoute53.

Returns:

The response from the GetChange service method, as returned by AmazonRoute53.

Throws:

NoSuchChangeException

InvalidInputException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.

updateTrafficPolicyInstance

UpdateTrafficPolicyInstanceResult updateTrafficPolicyInstance(UpdateTrafficPolicyInstanceRequest updateTrafficPolicyInstanceRequest)
                                                              throws AmazonServiceException,
                                                                     AmazonClientException

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

IMPORTANT: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 /2013-04-01/trafficpolicyinstance/traffic policy ID resource. The request body must include an XML document with an UpdateTrafficPolicyInstanceRequest element.

Parameters:

updateTrafficPolicyInstanceRequest - Container for the necessary parameters to execute the UpdateTrafficPolicyInstance service method on AmazonRoute53.

Returns:

The response from the UpdateTrafficPolicyInstance service method, as returned by AmazonRoute53.

Throws:

PriorRequestNotCompleteException

ConflictingTypesException

NoSuchTrafficPolicyException

InvalidInputException

NoSuchTrafficPolicyInstanceException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.

getGeoLocation

GetGeoLocationResult getGeoLocation(GetGeoLocationRequest getGeoLocationRequest)
                                    throws AmazonServiceException,
                                           AmazonClientException

To retrieve a single geo location, send a GET request to the 2013-04-01/geolocation resource with one of these options: continentcode | countrycode | countrycode and subdivisioncode.

Parameters:

getGeoLocationRequest - Container for the necessary parameters to execute the GetGeoLocation service method on AmazonRoute53.

Returns:

The response from the GetGeoLocation service method, as returned by AmazonRoute53.

Throws:

NoSuchGeoLocationException

InvalidInputException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.

updateHostedZoneComment

UpdateHostedZoneCommentResult updateHostedZoneComment(UpdateHostedZoneCommentRequest updateHostedZoneCommentRequest)
                                                      throws AmazonServiceException,
                                                             AmazonClientException

To update the hosted zone comment, send a POST request to the 2013-04-01/hostedzone/hosted zone ID resource. The request body must include an XML document with a UpdateHostedZoneCommentRequest element. The response to this request includes the modified HostedZone element.

NOTE: The comment can have a maximum length of 256 characters.

Parameters:

updateHostedZoneCommentRequest - Container for the necessary parameters to execute the UpdateHostedZoneComment service method on AmazonRoute53.

Returns:

The response from the UpdateHostedZoneComment service method, as returned by AmazonRoute53.

Throws:

NoSuchHostedZoneException

InvalidInputException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.

listTrafficPolicyVersions

ListTrafficPolicyVersionsResult listTrafficPolicyVersions(ListTrafficPolicyVersionsRequest listTrafficPolicyVersionsRequest)
                                                          throws AmazonServiceException,
                                                                 AmazonClientException

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 maxitems maxitems 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.

Parameters:

listTrafficPolicyVersionsRequest - Container for the necessary parameters to execute the ListTrafficPolicyVersions service method on AmazonRoute53.

Returns:

The response from the ListTrafficPolicyVersions service method, as returned by AmazonRoute53.

Throws:

NoSuchTrafficPolicyException

InvalidInputException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.

deleteHealthCheck

DeleteHealthCheckResult deleteHealthCheck(DeleteHealthCheckRequest deleteHealthCheckRequest)
                                          throws AmazonServiceException,
                                                 AmazonClientException

This action deletes a health check. To delete a health check, send a DELETE request to the 2013-04-01/healthcheck/health check ID resource.

IMPORTANT: 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.

Parameters:

deleteHealthCheckRequest - Container for the necessary parameters to execute the DeleteHealthCheck service method on AmazonRoute53.

Returns:

The response from the DeleteHealthCheck service method, as returned by AmazonRoute53.

Throws:

NoSuchHealthCheckException

HealthCheckInUseException

InvalidInputException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.

listTagsForResources

ListTagsForResourcesResult listTagsForResources(ListTagsForResourcesRequest listTagsForResourcesRequest)
                                                throws AmazonServiceException,
                                                       AmazonClientException

Parameters:

listTagsForResourcesRequest - Container for the necessary parameters to execute the ListTagsForResources service method on AmazonRoute53.

Returns:

The response from the ListTagsForResources service method, as returned by AmazonRoute53.

Throws:

PriorRequestNotCompleteException

NoSuchHealthCheckException

ThrottlingException

NoSuchHostedZoneException

InvalidInputException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.

listResourceRecordSets

ListResourceRecordSetsResult listResourceRecordSets(ListResourceRecordSetsRequest listResourceRecordSetsRequest)
                                                    throws AmazonServiceException,
                                                           AmazonClientException

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.

Parameters:

listResourceRecordSetsRequest - Container for the necessary parameters to execute the ListResourceRecordSets service method on AmazonRoute53.

Returns:

The response from the ListResourceRecordSets service method, as returned by AmazonRoute53.

Throws:

NoSuchHostedZoneException

InvalidInputException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.

deleteTrafficPolicyInstance

DeleteTrafficPolicyInstanceResult deleteTrafficPolicyInstance(DeleteTrafficPolicyInstanceRequest deleteTrafficPolicyInstanceRequest)
                                                              throws AmazonServiceException,
                                                                     AmazonClientException

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 2013-04-01/trafficpolicy/traffic policy instance ID resource.

IMPORTANT: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.

Parameters:

deleteTrafficPolicyInstanceRequest - Container for the necessary parameters to execute the DeleteTrafficPolicyInstance service method on AmazonRoute53.

Returns:

The response from the DeleteTrafficPolicyInstance service method, as returned by AmazonRoute53.

Throws:

PriorRequestNotCompleteException

InvalidInputException

NoSuchTrafficPolicyInstanceException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.

listTrafficPolicyInstancesByHostedZone

ListTrafficPolicyInstancesByHostedZoneResult listTrafficPolicyInstancesByHostedZone(ListTrafficPolicyInstancesByHostedZoneRequest listTrafficPolicyInstancesByHostedZoneRequest)
                                                                                    throws AmazonServiceException,
                                                                                           AmazonClientException

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

NOTE: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 2013-04-01/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.

Parameters:

listTrafficPolicyInstancesByHostedZoneRequest - Container for the necessary parameters to execute the ListTrafficPolicyInstancesByHostedZone service method on AmazonRoute53.

Returns:

The response from the ListTrafficPolicyInstancesByHostedZone service method, as returned by AmazonRoute53.

Throws:

NoSuchHostedZoneException

InvalidInputException

NoSuchTrafficPolicyInstanceException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.

deleteReusableDelegationSet

DeleteReusableDelegationSetResult deleteReusableDelegationSet(DeleteReusableDelegationSetRequest deleteReusableDelegationSetRequest)
                                                              throws AmazonServiceException,
                                                                     AmazonClientException

This action deletes a reusable delegation set. To delete a reusable delegation set, send a DELETE request to the 2013-04-01/delegationset/delegation set ID resource.

IMPORTANT: 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.

Parameters:

deleteReusableDelegationSetRequest - Container for the necessary parameters to execute the DeleteReusableDelegationSet service method on AmazonRoute53.

Returns:

The response from the DeleteReusableDelegationSet service method, as returned by AmazonRoute53.

Throws:

NoSuchDelegationSetException

DelegationSetInUseException

DelegationSetNotReusableException

InvalidInputException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.

getChangeDetails

GetChangeDetailsResult getChangeDetails(GetChangeDetailsRequest getChangeDetailsRequest)
                                        throws AmazonServiceException,
                                               AmazonClientException

This action returns the status and changes of a change batch request.

Parameters:

getChangeDetailsRequest - Container for the necessary parameters to execute the GetChangeDetails service method on AmazonRoute53.

Returns:

The response from the GetChangeDetails service method, as returned by AmazonRoute53.

Throws:

NoSuchChangeException

InvalidInputException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.

getHealthCheck

GetHealthCheckResult getHealthCheck(GetHealthCheckRequest getHealthCheckRequest)
                                    throws AmazonServiceException,
                                           AmazonClientException

To retrieve the health check, send a GET request to the 2013-04-01/healthcheck/health check ID resource.

Parameters:

getHealthCheckRequest - Container for the necessary parameters to execute the GetHealthCheck service method on AmazonRoute53.

Returns:

The response from the GetHealthCheck service method, as returned by AmazonRoute53.

Throws:

NoSuchHealthCheckException

IncompatibleVersionException

InvalidInputException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.

createReusableDelegationSet

CreateReusableDelegationSetResult createReusableDelegationSet(CreateReusableDelegationSetRequest createReusableDelegationSetRequest)
                                                              throws AmazonServiceException,
                                                                     AmazonClientException

This action creates a reusable delegationSet.

To create a new reusable delegationSet, send a POST request to the 2013-04-01/delegationset resource. The request body must include an XML 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.

Parameters:

createReusableDelegationSetRequest - Container for the necessary parameters to execute the CreateReusableDelegationSet service method on AmazonRoute53.

Returns:

The response from the CreateReusableDelegationSet service method, as returned by AmazonRoute53.

Throws:

DelegationSetAlreadyCreatedException

HostedZoneNotFoundException

DelegationSetNotAvailableException

InvalidInputException

InvalidArgumentException

LimitsExceededException

DelegationSetAlreadyReusableException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.

getCheckerIpRanges

GetCheckerIpRangesResult getCheckerIpRanges(GetCheckerIpRangesRequest getCheckerIpRangesRequest)
                                            throws AmazonServiceException,
                                                   AmazonClientException

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 2013-04-01/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.

Parameters:

getCheckerIpRangesRequest - Container for the necessary parameters to execute the GetCheckerIpRanges service method on AmazonRoute53.

Returns:

The response from the GetCheckerIpRanges service method, as returned by AmazonRoute53.

Throws:

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.

disassociateVPCFromHostedZone

DisassociateVPCFromHostedZoneResult disassociateVPCFromHostedZone(DisassociateVPCFromHostedZoneRequest disassociateVPCFromHostedZoneRequest)
                                                                  throws AmazonServiceException,
                                                                         AmazonClientException

This action disassociates a VPC from an hosted zone.

To disassociate a VPC to a hosted zone, send a POST request to the 2013-04-01/hostedzone/hosted zone ID/disassociatevpc resource. The request body must include an XML 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.

Parameters:

disassociateVPCFromHostedZoneRequest - Container for the necessary parameters to execute the DisassociateVPCFromHostedZone service method on AmazonRoute53.

Returns:

The response from the DisassociateVPCFromHostedZone service method, as returned by AmazonRoute53.

Throws:

InvalidVPCIdException

NoSuchHostedZoneException

LastVPCAssociationException

InvalidInputException

VPCAssociationNotFoundException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.

listChangeBatchesByRRSet

ListChangeBatchesByRRSetResult listChangeBatchesByRRSet(ListChangeBatchesByRRSetRequest listChangeBatchesByRRSetRequest)
                                                        throws AmazonServiceException,
                                                               AmazonClientException

This action gets the list of ChangeBatches in a given time period for a given hosted zone and RRSet.

Parameters:

listChangeBatchesByRRSetRequest - Container for the necessary parameters to execute the ListChangeBatchesByRRSet service method on AmazonRoute53.

Returns:

The response from the ListChangeBatchesByRRSet service method, as returned by AmazonRoute53.

Throws:

NoSuchHostedZoneException

InvalidInputException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.

getHealthCheckLastFailureReason

GetHealthCheckLastFailureReasonResult getHealthCheckLastFailureReason(GetHealthCheckLastFailureReasonRequest getHealthCheckLastFailureReasonRequest)
                                                                      throws AmazonServiceException,
                                                                             AmazonClientException

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 2013-04-01/healthcheck/health check ID/lastfailurereason resource.

Parameters:

getHealthCheckLastFailureReasonRequest - Container for the necessary parameters to execute the GetHealthCheckLastFailureReason service method on AmazonRoute53.

Returns:

The response from the GetHealthCheckLastFailureReason service method, as returned by AmazonRoute53.

Throws:

NoSuchHealthCheckException

InvalidInputException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.

listHealthChecks

ListHealthChecksResult listHealthChecks(ListHealthChecksRequest listHealthChecksRequest)
                                        throws AmazonServiceException,
                                               AmazonClientException

To retrieve a list of your health checks, send a GET request to the 2013-04-01/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.

NOTE: 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.

Parameters:

listHealthChecksRequest - Container for the necessary parameters to execute the ListHealthChecks service method on AmazonRoute53.

Returns:

The response from the ListHealthChecks service method, as returned by AmazonRoute53.

Throws:

IncompatibleVersionException

InvalidInputException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.

listGeoLocations

ListGeoLocationsResult listGeoLocations(ListGeoLocationsRequest listGeoLocationsRequest)
                                        throws AmazonServiceException,
                                               AmazonClientException

To retrieve a list of supported geo locations, send a GET request to the 2013-04-01/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.

Parameters:

listGeoLocationsRequest - Container for the necessary parameters to execute the ListGeoLocations service method on AmazonRoute53.

Returns:

The response from the ListGeoLocations service method, as returned by AmazonRoute53.

Throws:

InvalidInputException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.

createHealthCheck

CreateHealthCheckResult createHealthCheck(CreateHealthCheckRequest createHealthCheckRequest)
                                          throws AmazonServiceException,
                                                 AmazonClientException

This action creates a new health check.

To create a new health check, send a POST request to the 2013-04-01/healthcheck resource. The request body must include an XML document with a CreateHealthCheckRequest element. The response returns the CreateHealthCheckResponse element that contains metadata about the health check.

Parameters:

createHealthCheckRequest - Container for the necessary parameters to execute the CreateHealthCheck service method on AmazonRoute53.

Returns:

The response from the CreateHealthCheck service method, as returned by AmazonRoute53.

Throws:

HealthCheckAlreadyExistsException

InvalidInputException

TooManyHealthChecksException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.

getHealthCheckCount

GetHealthCheckCountResult getHealthCheckCount(GetHealthCheckCountRequest getHealthCheckCountRequest)
                                              throws AmazonServiceException,
                                                     AmazonClientException

To retrieve a count of all your health checks, send a GET request to the 2013-04-01/healthcheckcount resource.

Parameters:

getHealthCheckCountRequest - Container for the necessary parameters to execute the GetHealthCheckCount service method on AmazonRoute53.

Returns:

The response from the GetHealthCheckCount service method, as returned by AmazonRoute53.

Throws:

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.

changeTagsForResource

ChangeTagsForResourceResult changeTagsForResource(ChangeTagsForResourceRequest changeTagsForResourceRequest)
                                                  throws AmazonServiceException,
                                                         AmazonClientException

Parameters:

changeTagsForResourceRequest - Container for the necessary parameters to execute the ChangeTagsForResource service method on AmazonRoute53.

Returns:

The response from the ChangeTagsForResource service method, as returned by AmazonRoute53.

Throws:

PriorRequestNotCompleteException

NoSuchHealthCheckException

ThrottlingException

NoSuchHostedZoneException

InvalidInputException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.

createTrafficPolicyInstance

CreateTrafficPolicyInstanceResult createTrafficPolicyInstance(CreateTrafficPolicyInstanceRequest createTrafficPolicyInstanceRequest)
                                                              throws AmazonServiceException,
                                                                     AmazonClientException

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 2013-04-01/trafficpolicyinstance resource. The request body must include an XML document with a CreateTrafficPolicyRequest element. The response returns the CreateTrafficPolicyInstanceResponse element, which contains information about the traffic policy instance.

Parameters:

createTrafficPolicyInstanceRequest - Container for the necessary parameters to execute the CreateTrafficPolicyInstance service method on AmazonRoute53.

Returns:

The response from the CreateTrafficPolicyInstance service method, as returned by AmazonRoute53.

Throws:

NoSuchTrafficPolicyException

TrafficPolicyInstanceAlreadyExistsException

NoSuchHostedZoneException

TooManyTrafficPolicyInstancesException

InvalidInputException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.

listTrafficPolicyInstances

ListTrafficPolicyInstancesResult listTrafficPolicyInstances(ListTrafficPolicyInstancesRequest listTrafficPolicyInstancesRequest)
                                                            throws AmazonServiceException,
                                                                   AmazonClientException

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

NOTE: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 2013-04-01/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.

Parameters:

listTrafficPolicyInstancesRequest - Container for the necessary parameters to execute the ListTrafficPolicyInstances service method on AmazonRoute53.

Returns:

The response from the ListTrafficPolicyInstances service method, as returned by AmazonRoute53.

Throws:

InvalidInputException

NoSuchTrafficPolicyInstanceException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.

listTrafficPolicies

ListTrafficPoliciesResult listTrafficPolicies(ListTrafficPoliciesRequest listTrafficPoliciesRequest)
                                              throws AmazonServiceException,
                                                     AmazonClientException

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 2013-04-01/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.

Parameters:

listTrafficPoliciesRequest - Container for the necessary parameters to execute the ListTrafficPolicies service method on AmazonRoute53.

Returns:

The response from the ListTrafficPolicies service method, as returned by AmazonRoute53.

Throws:

InvalidInputException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.

getHealthCheckStatus

GetHealthCheckStatusResult getHealthCheckStatus(GetHealthCheckStatusRequest getHealthCheckStatusRequest)
                                                throws AmazonServiceException,
                                                       AmazonClientException

To retrieve the health check status, send a GET request to the 2013-04-01/healthcheck/health check ID/status resource. You can use this call to get a health check's current status.

Parameters:

getHealthCheckStatusRequest - Container for the necessary parameters to execute the GetHealthCheckStatus service method on AmazonRoute53.

Returns:

The response from the GetHealthCheckStatus service method, as returned by AmazonRoute53.

Throws:

NoSuchHealthCheckException

InvalidInputException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.

listHostedZones

ListHostedZonesResult listHostedZones(ListHostedZonesRequest listHostedZonesRequest)
                                      throws AmazonServiceException,
                                             AmazonClientException

To retrieve a list of your hosted zones, send a GET request to the 2013-04-01/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.

NOTE: 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.

Parameters:

listHostedZonesRequest - Container for the necessary parameters to execute the ListHostedZones service method on AmazonRoute53.

Returns:

The response from the ListHostedZones service method, as returned by AmazonRoute53.

Throws:

NoSuchDelegationSetException

DelegationSetNotReusableException

InvalidInputException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.

getHostedZoneCount

GetHostedZoneCountResult getHostedZoneCount(GetHostedZoneCountRequest getHostedZoneCountRequest)
                                            throws AmazonServiceException,
                                                   AmazonClientException

To retrieve a count of all your hosted zones, send a GET request to the 2013-04-01/hostedzonecount resource.

Parameters:

getHostedZoneCountRequest - Container for the necessary parameters to execute the GetHostedZoneCount service method on AmazonRoute53.

Returns:

The response from the GetHostedZoneCount service method, as returned by AmazonRoute53.

Throws:

InvalidInputException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.

updateHealthCheck

UpdateHealthCheckResult updateHealthCheck(UpdateHealthCheckRequest updateHealthCheckRequest)
                                          throws AmazonServiceException,
                                                 AmazonClientException

This action updates an existing health check.

To update a health check, send a POST request to the 2013-04-01/healthcheck/health check ID resource. The request body must include an XML document with an UpdateHealthCheckRequest element. The response returns an UpdateHealthCheckResponse element, which contains metadata about the health check.

Parameters:

updateHealthCheckRequest - Container for the necessary parameters to execute the UpdateHealthCheck service method on AmazonRoute53.

Returns:

The response from the UpdateHealthCheck service method, as returned by AmazonRoute53.

Throws:

HealthCheckVersionMismatchException

NoSuchHealthCheckException

InvalidInputException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.

getReusableDelegationSet

GetReusableDelegationSetResult getReusableDelegationSet(GetReusableDelegationSetRequest getReusableDelegationSetRequest)
                                                        throws AmazonServiceException,
                                                               AmazonClientException

To retrieve the reusable delegation set, send a GET request to the 2013-04-01/delegationset/delegation set ID resource.

Parameters:

getReusableDelegationSetRequest - Container for the necessary parameters to execute the GetReusableDelegationSet service method on AmazonRoute53.

Returns:

The response from the GetReusableDelegationSet service method, as returned by AmazonRoute53.

Throws:

NoSuchDelegationSetException

DelegationSetNotReusableException

InvalidInputException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.

listHostedZonesByName

ListHostedZonesByNameResult listHostedZonesByName(ListHostedZonesByNameRequest listHostedZonesByNameRequest)
                                                  throws AmazonServiceException,
                                                         AmazonClientException

To retrieve a list of your hosted zones in lexicographic order, send a GET request to the 2013-04-01/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.

NOTE: 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.

Parameters:

listHostedZonesByNameRequest - Container for the necessary parameters to execute the ListHostedZonesByName service method on AmazonRoute53.

Returns:

The response from the ListHostedZonesByName service method, as returned by AmazonRoute53.

Throws:

InvalidInputException

InvalidDomainNameException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.

getTrafficPolicy

GetTrafficPolicyResult getTrafficPolicy(GetTrafficPolicyRequest getTrafficPolicyRequest)
                                        throws AmazonServiceException,
                                               AmazonClientException

Gets information about a specific traffic policy version. To get the information, send a GET request to the 2013-04-01/trafficpolicy resource.

Parameters:

getTrafficPolicyRequest - Container for the necessary parameters to execute the GetTrafficPolicy service method on AmazonRoute53.

Returns:

The response from the GetTrafficPolicy service method, as returned by AmazonRoute53.

Throws:

NoSuchTrafficPolicyException

InvalidInputException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.

deleteTrafficPolicy

DeleteTrafficPolicyResult deleteTrafficPolicy(DeleteTrafficPolicyRequest deleteTrafficPolicyRequest)
                                              throws AmazonServiceException,
                                                     AmazonClientException

Deletes a traffic policy. To delete a traffic policy, send a DELETE request to the 2013-04-01/trafficpolicy resource.

Parameters:

deleteTrafficPolicyRequest - Container for the necessary parameters to execute the DeleteTrafficPolicy service method on AmazonRoute53.

Returns:

The response from the DeleteTrafficPolicy service method, as returned by AmazonRoute53.

Throws:

ConcurrentModificationException

NoSuchTrafficPolicyException

TrafficPolicyInUseException

InvalidInputException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.

getTrafficPolicyInstanceCount

GetTrafficPolicyInstanceCountResult getTrafficPolicyInstanceCount(GetTrafficPolicyInstanceCountRequest getTrafficPolicyInstanceCountRequest)
                                                                  throws AmazonServiceException,
                                                                         AmazonClientException

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 2013-04-01/trafficpolicyinstancecount resource.

Parameters:

getTrafficPolicyInstanceCountRequest - Container for the necessary parameters to execute the GetTrafficPolicyInstanceCount service method on AmazonRoute53.

Returns:

The response from the GetTrafficPolicyInstanceCount service method, as returned by AmazonRoute53.

Throws:

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.

deleteHostedZone

DeleteHostedZoneResult deleteHostedZone(DeleteHostedZoneRequest deleteHostedZoneRequest)
                                        throws AmazonServiceException,
                                               AmazonClientException

This action deletes a hosted zone. To delete a hosted zone, send a DELETE request to the 2013-04-01/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 .

IMPORTANT: 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.

Parameters:

deleteHostedZoneRequest - Container for the necessary parameters to execute the DeleteHostedZone service method on AmazonRoute53.

Returns:

The response from the DeleteHostedZone service method, as returned by AmazonRoute53.

Throws:

PriorRequestNotCompleteException

HostedZoneNotEmptyException

NoSuchHostedZoneException

InvalidInputException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.

createHostedZone

CreateHostedZoneResult createHostedZone(CreateHostedZoneRequest createHostedZoneRequest)
                                        throws AmazonServiceException,
                                               AmazonClientException

This action creates a new hosted zone.

To create a new hosted zone, send a POST request to the 2013-04-01/hostedzone resource. The request body must include an XML 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.

Parameters:

createHostedZoneRequest - Container for the necessary parameters to execute the CreateHostedZone service method on AmazonRoute53.

Returns:

The response from the CreateHostedZone service method, as returned by AmazonRoute53.

Throws:

ConflictingDomainExistsException

TooManyHostedZonesException

NoSuchDelegationSetException

InvalidVPCIdException

DelegationSetNotAvailableException

DelegationSetNotReusableException

InvalidDomainNameException

InvalidInputException

HostedZoneAlreadyExistsException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.

associateVPCWithHostedZone

AssociateVPCWithHostedZoneResult associateVPCWithHostedZone(AssociateVPCWithHostedZoneRequest associateVPCWithHostedZoneRequest)
                                                            throws AmazonServiceException,
                                                                   AmazonClientException

This action associates a VPC with an hosted zone.

To associate a VPC with an hosted zone, send a POST request to the 2013-04-01/hostedzone/hosted zone ID/associatevpc resource. The request body must include an XML 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.

Parameters:

associateVPCWithHostedZoneRequest - Container for the necessary parameters to execute the AssociateVPCWithHostedZone service method on AmazonRoute53.

Returns:

The response from the AssociateVPCWithHostedZone service method, as returned by AmazonRoute53.

Throws:

ConflictingDomainExistsException

InvalidVPCIdException

NoSuchHostedZoneException

PublicZoneVPCAssociationException

InvalidInputException

LimitsExceededException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.

listTagsForResource

ListTagsForResourceResult listTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest)
                                              throws AmazonServiceException,
                                                     AmazonClientException

Parameters:

listTagsForResourceRequest - Container for the necessary parameters to execute the ListTagsForResource service method on AmazonRoute53.

Returns:

The response from the ListTagsForResource service method, as returned by AmazonRoute53.

Throws:

PriorRequestNotCompleteException

NoSuchHealthCheckException

ThrottlingException

NoSuchHostedZoneException

InvalidInputException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.

listReusableDelegationSets

ListReusableDelegationSetsResult listReusableDelegationSets(ListReusableDelegationSetsRequest listReusableDelegationSetsRequest)
                                                            throws AmazonServiceException,
                                                                   AmazonClientException

To retrieve a list of your reusable delegation sets, send a GET request to the 2013-04-01/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.

NOTE: 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.

Parameters:

listReusableDelegationSetsRequest - Container for the necessary parameters to execute the ListReusableDelegationSets service method on AmazonRoute53.

Returns:

The response from the ListReusableDelegationSets service method, as returned by AmazonRoute53.

Throws:

InvalidInputException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.

listChangeBatchesByHostedZone

ListChangeBatchesByHostedZoneResult listChangeBatchesByHostedZone(ListChangeBatchesByHostedZoneRequest listChangeBatchesByHostedZoneRequest)
                                                                  throws AmazonServiceException,
                                                                         AmazonClientException

This action gets the list of ChangeBatches in a given time period for a given hosted zone.

Parameters:

listChangeBatchesByHostedZoneRequest - Container for the necessary parameters to execute the ListChangeBatchesByHostedZone service method on AmazonRoute53.

Returns:

The response from the ListChangeBatchesByHostedZone service method, as returned by AmazonRoute53.

Throws:

NoSuchHostedZoneException

InvalidInputException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.

changeResourceRecordSets

ChangeResourceRecordSetsResult changeResourceRecordSets(ChangeResourceRecordSetsRequest changeResourceRecordSetsRequest)
                                                        throws AmazonServiceException,
                                                               AmazonClientException

Use this action to create or change your authoritative DNS information. To use this action, send a POST request to the 2013-04-01/hostedzone/hosted Zone ID/rrset resource. The request body must include an XML 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 .

IMPORTANT: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.

Parameters:

changeResourceRecordSetsRequest - Container for the necessary parameters to execute the ChangeResourceRecordSets service method on AmazonRoute53.

Returns:

The response from the ChangeResourceRecordSets service method, as returned by AmazonRoute53.

Throws:

PriorRequestNotCompleteException

NoSuchHealthCheckException

NoSuchHostedZoneException

InvalidInputException

InvalidChangeBatchException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.

createTrafficPolicyVersion

CreateTrafficPolicyVersionResult createTrafficPolicyVersion(CreateTrafficPolicyVersionRequest createTrafficPolicyVersionRequest)
                                                            throws AmazonServiceException,
                                                                   AmazonClientException

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 2013-04-01/trafficpolicy/ resource. The request body includes an XML document with a CreateTrafficPolicyVersionRequest element. The response returns the CreateTrafficPolicyVersionResponse element, which contains information about the new version of the traffic policy.

Parameters:

createTrafficPolicyVersionRequest - Container for the necessary parameters to execute the CreateTrafficPolicyVersion service method on AmazonRoute53.

Returns:

The response from the CreateTrafficPolicyVersion service method, as returned by AmazonRoute53.

Throws:

ConcurrentModificationException

InvalidTrafficPolicyDocumentException

NoSuchTrafficPolicyException

InvalidInputException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.

listTrafficPolicyInstancesByPolicy

ListTrafficPolicyInstancesByPolicyResult listTrafficPolicyInstancesByPolicy(ListTrafficPolicyInstancesByPolicyRequest listTrafficPolicyInstancesByPolicyRequest)
                                                                            throws AmazonServiceException,
                                                                                   AmazonClientException

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

NOTE: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 2013-04-01/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.

Parameters:

listTrafficPolicyInstancesByPolicyRequest - Container for the necessary parameters to execute the ListTrafficPolicyInstancesByPolicy service method on AmazonRoute53.

Returns:

The response from the ListTrafficPolicyInstancesByPolicy service method, as returned by AmazonRoute53.

Throws:

NoSuchTrafficPolicyException

InvalidInputException

NoSuchTrafficPolicyInstanceException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.

getGeoLocation

GetGeoLocationResult getGeoLocation()
                                    throws AmazonServiceException,
                                           AmazonClientException

To retrieve a single geo location, send a GET request to the 2013-04-01/geolocation resource with one of these options: continentcode | countrycode | countrycode and subdivisioncode.

Returns:

The response from the GetGeoLocation service method, as returned by AmazonRoute53.

Throws:

NoSuchGeoLocationException

InvalidInputException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.

getCheckerIpRanges

GetCheckerIpRangesResult getCheckerIpRanges()
                                            throws AmazonServiceException,
                                                   AmazonClientException

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 2013-04-01/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.

Returns:

The response from the GetCheckerIpRanges service method, as returned by AmazonRoute53.

Throws:

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.

listHealthChecks

ListHealthChecksResult listHealthChecks()
                                        throws AmazonServiceException,
                                               AmazonClientException

To retrieve a list of your health checks, send a GET request to the 2013-04-01/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.

NOTE: 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:

The response from the ListHealthChecks service method, as returned by AmazonRoute53.

Throws:

IncompatibleVersionException

InvalidInputException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.

listGeoLocations

ListGeoLocationsResult listGeoLocations()
                                        throws AmazonServiceException,
                                               AmazonClientException

To retrieve a list of supported geo locations, send a GET request to the 2013-04-01/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.

Returns:

The response from the ListGeoLocations service method, as returned by AmazonRoute53.

Throws:

InvalidInputException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.

getHealthCheckCount

GetHealthCheckCountResult getHealthCheckCount()
                                              throws AmazonServiceException,
                                                     AmazonClientException

To retrieve a count of all your health checks, send a GET request to the 2013-04-01/healthcheckcount resource.

Returns:

The response from the GetHealthCheckCount service method, as returned by AmazonRoute53.

Throws:

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.

listTrafficPolicyInstances

ListTrafficPolicyInstancesResult listTrafficPolicyInstances()
                                                            throws AmazonServiceException,
                                                                   AmazonClientException

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

NOTE: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 2013-04-01/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.

Returns:

The response from the ListTrafficPolicyInstances service method, as returned by AmazonRoute53.

Throws:

InvalidInputException

NoSuchTrafficPolicyInstanceException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.

listTrafficPolicies

ListTrafficPoliciesResult listTrafficPolicies()
                                              throws AmazonServiceException,
                                                     AmazonClientException

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 2013-04-01/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.

Returns:

The response from the ListTrafficPolicies service method, as returned by AmazonRoute53.

Throws:

InvalidInputException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.

listHostedZones

ListHostedZonesResult listHostedZones()
                                      throws AmazonServiceException,
                                             AmazonClientException

To retrieve a list of your hosted zones, send a GET request to the 2013-04-01/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.

NOTE: 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:

The response from the ListHostedZones service method, as returned by AmazonRoute53.

Throws:

NoSuchDelegationSetException

DelegationSetNotReusableException

InvalidInputException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.

getHostedZoneCount

GetHostedZoneCountResult getHostedZoneCount()
                                            throws AmazonServiceException,
                                                   AmazonClientException

To retrieve a count of all your hosted zones, send a GET request to the 2013-04-01/hostedzonecount resource.

Returns:

The response from the GetHostedZoneCount service method, as returned by AmazonRoute53.

Throws:

InvalidInputException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.

listHostedZonesByName

ListHostedZonesByNameResult listHostedZonesByName()
                                                  throws AmazonServiceException,
                                                         AmazonClientException

To retrieve a list of your hosted zones in lexicographic order, send a GET request to the 2013-04-01/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.

NOTE: 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:

The response from the ListHostedZonesByName service method, as returned by AmazonRoute53.

Throws:

InvalidInputException

InvalidDomainNameException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.

getTrafficPolicyInstanceCount

GetTrafficPolicyInstanceCountResult getTrafficPolicyInstanceCount()
                                                                  throws AmazonServiceException,
                                                                         AmazonClientException

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 2013-04-01/trafficpolicyinstancecount resource.

Returns:

The response from the GetTrafficPolicyInstanceCount service method, as returned by AmazonRoute53.

Throws:

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.

listReusableDelegationSets

ListReusableDelegationSetsResult listReusableDelegationSets()
                                                            throws AmazonServiceException,
                                                                   AmazonClientException

To retrieve a list of your reusable delegation sets, send a GET request to the 2013-04-01/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.

NOTE: 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:

The response from the ListReusableDelegationSets service method, as returned by AmazonRoute53.

Throws:

InvalidInputException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.

shutdown

void shutdown()

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.

getCachedResponseMetadata

ResponseMetadata getCachedResponseMetadata(AmazonWebServiceRequest request)

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.

Parameters:

request - The originally executed request.

Returns:

The response metadata for the specified request, or null if none is available.