com.amazonaws.services.route53
Class AmazonRoute53AsyncClient

java.lang.Object
  com.amazonaws.AmazonWebServiceClient
      com.amazonaws.services.route53.AmazonRoute53Client
          com.amazonaws.services.route53.AmazonRoute53AsyncClient

All Implemented Interfaces:

AmazonRoute53, AmazonRoute53Async

public class AmazonRoute53AsyncClient
extends AmazonRoute53Client
implements AmazonRoute53Async

Asynchronous client for accessing AmazonRoute53. All asynchronous calls made using this client are non-blocking. Callers could either process the result and handle the exceptions in the worker thread by providing a callback handler when making the call, or use the returned Future object to check the result of the call in the calling thread.

Constructor Summary

AmazonRoute53AsyncClient()
Constructs a new asynchronous client to invoke service methods on AmazonRoute53.

AmazonRoute53AsyncClient(AWSCredentials awsCredentials)
Constructs a new asynchronous client to invoke service methods on AmazonRoute53 using the specified AWS account credentials.

AmazonRoute53AsyncClient(AWSCredentials awsCredentials, ClientConfiguration clientConfiguration, ExecutorService executorService)
Constructs a new asynchronous client to invoke service methods on AmazonRoute53 using the specified AWS account credentials, executor service, and client configuration options.

AmazonRoute53AsyncClient(AWSCredentials awsCredentials, ExecutorService executorService)
Constructs a new asynchronous client to invoke service methods on AmazonRoute53 using the specified AWS account credentials and executor service.

AmazonRoute53AsyncClient(AWSCredentialsProvider awsCredentialsProvider)
Constructs a new asynchronous client to invoke service methods on AmazonRoute53 using the specified AWS account credentials provider.

AmazonRoute53AsyncClient(AWSCredentialsProvider awsCredentialsProvider, ClientConfiguration clientConfiguration)
Constructs a new asynchronous client to invoke service methods on AmazonRoute53 using the specified AWS account credentials provider and client configuration options.

AmazonRoute53AsyncClient(AWSCredentialsProvider awsCredentialsProvider, ClientConfiguration clientConfiguration, ExecutorService executorService)
Constructs a new asynchronous client to invoke service methods on AmazonRoute53 using the specified AWS account credentials provider, executor service, and client configuration options.

AmazonRoute53AsyncClient(AWSCredentialsProvider awsCredentialsProvider, ExecutorService executorService)
Constructs a new asynchronous client to invoke service methods on AmazonRoute53 using the specified AWS account credentials provider and executor service.

AmazonRoute53AsyncClient(ClientConfiguration clientConfiguration)
Constructs a new asynchronous client to invoke service methods on AmazonRoute53.

Method Summary

Future<ChangeResourceRecordSetsResult>	changeResourceRecordSetsAsync(ChangeResourceRecordSetsRequest changeResourceRecordSetsRequest) Use this action to create or change your authoritative DNS information.
Future<ChangeResourceRecordSetsResult>	changeResourceRecordSetsAsync(ChangeResourceRecordSetsRequest changeResourceRecordSetsRequest, AsyncHandler<ChangeResourceRecordSetsRequest,ChangeResourceRecordSetsResult> asyncHandler) Use this action to create or change your authoritative DNS information.
Future<CreateHealthCheckResult>	createHealthCheckAsync(CreateHealthCheckRequest createHealthCheckRequest) This action creates a new health check.
Future<CreateHealthCheckResult>	createHealthCheckAsync(CreateHealthCheckRequest createHealthCheckRequest, AsyncHandler<CreateHealthCheckRequest,CreateHealthCheckResult> asyncHandler) This action creates a new health check.
Future<CreateHostedZoneResult>	createHostedZoneAsync(CreateHostedZoneRequest createHostedZoneRequest) This action creates a new hosted zone.
Future<CreateHostedZoneResult>	createHostedZoneAsync(CreateHostedZoneRequest createHostedZoneRequest, AsyncHandler<CreateHostedZoneRequest,CreateHostedZoneResult> asyncHandler) This action creates a new hosted zone.
Future<DeleteHealthCheckResult>	deleteHealthCheckAsync(DeleteHealthCheckRequest deleteHealthCheckRequest) This action deletes a health check.
Future<DeleteHealthCheckResult>	deleteHealthCheckAsync(DeleteHealthCheckRequest deleteHealthCheckRequest, AsyncHandler<DeleteHealthCheckRequest,DeleteHealthCheckResult> asyncHandler) This action deletes a health check.
Future<DeleteHostedZoneResult>	deleteHostedZoneAsync(DeleteHostedZoneRequest deleteHostedZoneRequest) This action deletes a hosted zone.
Future<DeleteHostedZoneResult>	deleteHostedZoneAsync(DeleteHostedZoneRequest deleteHostedZoneRequest, AsyncHandler<DeleteHostedZoneRequest,DeleteHostedZoneResult> asyncHandler) This action deletes a hosted zone.
Future<GetChangeResult>	getChangeAsync(GetChangeRequest getChangeRequest) This action returns the current status of a change batch request.
Future<GetChangeResult>	getChangeAsync(GetChangeRequest getChangeRequest, AsyncHandler<GetChangeRequest,GetChangeResult> asyncHandler) This action returns the current status of a change batch request.
ExecutorService	getExecutorService() Returns the executor service used by this async client to execute requests.
Future<GetHealthCheckResult>	getHealthCheckAsync(GetHealthCheckRequest getHealthCheckRequest) To retrieve the health check, send a GET request to the 2012-12-12/healthcheck/health check ID resource.
Future<GetHealthCheckResult>	getHealthCheckAsync(GetHealthCheckRequest getHealthCheckRequest, AsyncHandler<GetHealthCheckRequest,GetHealthCheckResult> asyncHandler) To retrieve the health check, send a GET request to the 2012-12-12/healthcheck/health check ID resource.
Future<GetHostedZoneResult>	getHostedZoneAsync(GetHostedZoneRequest getHostedZoneRequest) To retrieve the delegation set for a hosted zone, send a GET request to the 2012-12-12/hostedzone/hosted zone ID resource.
Future<GetHostedZoneResult>	getHostedZoneAsync(GetHostedZoneRequest getHostedZoneRequest, AsyncHandler<GetHostedZoneRequest,GetHostedZoneResult> asyncHandler) To retrieve the delegation set for a hosted zone, send a GET request to the 2012-12-12/hostedzone/hosted zone ID resource.
Future<ListHealthChecksResult>	listHealthChecksAsync(ListHealthChecksRequest listHealthChecksRequest) To retrieve a list of your health checks, send a GET request to the 2012-12-12/healthcheck resource.
Future<ListHealthChecksResult>	listHealthChecksAsync(ListHealthChecksRequest listHealthChecksRequest, AsyncHandler<ListHealthChecksRequest,ListHealthChecksResult> asyncHandler) To retrieve a list of your health checks, send a GET request to the 2012-12-12/healthcheck resource.
Future<ListHostedZonesResult>	listHostedZonesAsync(ListHostedZonesRequest listHostedZonesRequest) To retrieve a list of your hosted zones, send a GET request to the 2012-12-12/hostedzone resource.
Future<ListHostedZonesResult>	listHostedZonesAsync(ListHostedZonesRequest listHostedZonesRequest, AsyncHandler<ListHostedZonesRequest,ListHostedZonesResult> asyncHandler) To retrieve a list of your hosted zones, send a GET request to the 2012-12-12/hostedzone resource.
Future<ListResourceRecordSetsResult>	listResourceRecordSetsAsync(ListResourceRecordSetsRequest listResourceRecordSetsRequest) Imagine all the resource record sets in a zone listed out in front of you.
Future<ListResourceRecordSetsResult>	listResourceRecordSetsAsync(ListResourceRecordSetsRequest listResourceRecordSetsRequest, AsyncHandler<ListResourceRecordSetsRequest,ListResourceRecordSetsResult> asyncHandler) Imagine all the resource record sets in a zone listed out in front of you.
void	shutdown() Shuts down the client, releasing all managed resources.

Methods inherited from class com.amazonaws.services.route53.AmazonRoute53Client

changeResourceRecordSets, createHealthCheck, createHostedZone, deleteHealthCheck, deleteHostedZone, getCachedResponseMetadata, getChange, getHealthCheck, getHostedZone, listHealthChecks, listHealthChecks, listHostedZones, listHostedZones, listResourceRecordSets

Methods inherited from class com.amazonaws.AmazonWebServiceClient

addRequestHandler, getTimeOffset, removeRequestHandler, setConfiguration, setEndpoint, setRegion, setTimeOffset, withTimeOffset

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.amazonaws.services.route53.AmazonRoute53

changeResourceRecordSets, createHealthCheck, createHostedZone, deleteHealthCheck, deleteHostedZone, getCachedResponseMetadata, getChange, getHealthCheck, getHostedZone, listHealthChecks, listHealthChecks, listHostedZones, listHostedZones, listResourceRecordSets, setEndpoint, setRegion

Constructor Detail

AmazonRoute53AsyncClient

public AmazonRoute53AsyncClient()

Constructs a new asynchronous client to invoke service methods on AmazonRoute53. A credentials provider chain will be used that searches for credentials in this order:

• Environment Variables - AWS_ACCESS_KEY_ID and AWS_SECRET_KEY
• Java System Properties - aws.accessKeyId and aws.secretKey
• Instance profile credentials delivered through the Amazon EC2 metadata service

All service calls made using this new client object are blocking, and will not return until the service call completes.

See Also:

DefaultAWSCredentialsProvider

AmazonRoute53AsyncClient

public AmazonRoute53AsyncClient(ClientConfiguration clientConfiguration)

Constructs a new asynchronous client to invoke service methods on AmazonRoute53. A credentials provider chain will be used that searches for credentials in this order:

• Environment Variables - AWS_ACCESS_KEY_ID and AWS_SECRET_KEY
• Java System Properties - aws.accessKeyId and aws.secretKey
• Instance profile credentials delivered through the Amazon EC2 metadata service

All service calls made using this new client object are blocking, and will not return until the service call completes.

Parameters:

clientConfiguration - The client configuration options controlling how this client connects to AmazonRoute53 (ex: proxy settings, retry counts, etc.).

See Also:

DefaultAWSCredentialsProvider

AmazonRoute53AsyncClient

public AmazonRoute53AsyncClient(AWSCredentials awsCredentials)

Constructs a new asynchronous client to invoke service methods on AmazonRoute53 using the specified AWS account credentials. Default client settings will be used, and a default cached thread pool will be created for executing the asynchronous tasks.

All calls made using this new client object are non-blocking, and will immediately return a Java Future object that the caller can later check to see if the service call has actually completed.

Parameters:

awsCredentials - The AWS credentials (access key ID and secret key) to use when authenticating with AWS services.

AmazonRoute53AsyncClient

public AmazonRoute53AsyncClient(AWSCredentials awsCredentials,
                                ExecutorService executorService)

Constructs a new asynchronous client to invoke service methods on AmazonRoute53 using the specified AWS account credentials and executor service. Default client settings will be used.

All calls made using this new client object are non-blocking, and will immediately return a Java Future object that the caller can later check to see if the service call has actually completed.

Parameters:

awsCredentials - The AWS credentials (access key ID and secret key) to use when authenticating with AWS services.

executorService - The executor service by which all asynchronous requests will be executed.

AmazonRoute53AsyncClient

public AmazonRoute53AsyncClient(AWSCredentials awsCredentials,
                                ClientConfiguration clientConfiguration,
                                ExecutorService executorService)

Constructs a new asynchronous client to invoke service methods on AmazonRoute53 using the specified AWS account credentials, executor service, and client configuration options.

All calls made using this new client object are non-blocking, and will immediately return a Java Future object that the caller can later check to see if the service call has actually completed.

Parameters:

awsCredentials - The AWS credentials (access key ID and secret key) to use when authenticating with AWS services.

clientConfiguration - Client configuration options (ex: max retry limit, proxy settings, etc).

executorService - The executor service by which all asynchronous requests will be executed.

AmazonRoute53AsyncClient

public AmazonRoute53AsyncClient(AWSCredentialsProvider awsCredentialsProvider)

Constructs a new asynchronous client to invoke service methods on AmazonRoute53 using the specified AWS account credentials provider. Default client settings will be used, and a default cached thread pool will be created for executing the asynchronous tasks.

All calls made using this new client object are non-blocking, and will immediately return a Java Future object that the caller can later check to see if the service call has actually completed.

Parameters:

awsCredentialsProvider - The AWS credentials provider which will provide credentials to authenticate requests with AWS services.

AmazonRoute53AsyncClient

public AmazonRoute53AsyncClient(AWSCredentialsProvider awsCredentialsProvider,
                                ExecutorService executorService)

Constructs a new asynchronous client to invoke service methods on AmazonRoute53 using the specified AWS account credentials provider and executor service. Default client settings will be used.

All calls made using this new client object are non-blocking, and will immediately return a Java Future object that the caller can later check to see if the service call has actually completed.

Parameters:

awsCredentialsProvider - The AWS credentials provider which will provide credentials to authenticate requests with AWS services.

executorService - The executor service by which all asynchronous requests will be executed.

AmazonRoute53AsyncClient

public AmazonRoute53AsyncClient(AWSCredentialsProvider awsCredentialsProvider,
                                ClientConfiguration clientConfiguration)

Constructs a new asynchronous client to invoke service methods on AmazonRoute53 using the specified AWS account credentials provider and client configuration options.

All calls made using this new client object are non-blocking, and will immediately return a Java Future object that the caller can later check to see if the service call has actually completed.

Parameters:

awsCredentialsProvider - The AWS credentials provider which will provide credentials to authenticate requests with AWS services.

clientConfiguration - Client configuration options (ex: max retry limit, proxy settings, etc).

AmazonRoute53AsyncClient

public AmazonRoute53AsyncClient(AWSCredentialsProvider awsCredentialsProvider,
                                ClientConfiguration clientConfiguration,
                                ExecutorService executorService)

Constructs a new asynchronous client to invoke service methods on AmazonRoute53 using the specified AWS account credentials provider, executor service, and client configuration options.

All calls made using this new client object are non-blocking, and will immediately return a Java Future object that the caller can later check to see if the service call has actually completed.

Parameters:

awsCredentialsProvider - The AWS credentials provider which will provide credentials to authenticate requests with AWS services.

clientConfiguration - Client configuration options (ex: max retry limit, proxy settings, etc).

executorService - The executor service by which all asynchronous requests will be executed.

Method Detail

getExecutorService

public ExecutorService getExecutorService()

Returns the executor service used by this async client to execute requests.

Returns:

The executor service used by this async client to execute requests.

shutdown

public void shutdown()

Shuts down the client, releasing all managed resources. This includes forcibly terminating all pending asynchronous service calls. Clients who wish to give pending asynchronous service calls time to complete should call getExecutorService().shutdown() prior to calling this method.

Specified by:

shutdown in interface AmazonRoute53

Overrides:

shutdown in class AmazonWebServiceClient

listResourceRecordSetsAsync

public Future<ListResourceRecordSetsResult> listResourceRecordSetsAsync(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.

Specified by:

listResourceRecordSetsAsync in interface AmazonRoute53Async

Parameters:

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

Returns:

A Java Future object containing the response from the ListResourceRecordSets 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.

listResourceRecordSetsAsync

public Future<ListResourceRecordSetsResult> listResourceRecordSetsAsync(ListResourceRecordSetsRequest listResourceRecordSetsRequest,
                                                                        AsyncHandler<ListResourceRecordSetsRequest,ListResourceRecordSetsResult> asyncHandler)
                                                                 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.

Specified by:

listResourceRecordSetsAsync in interface AmazonRoute53Async

Parameters:

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

asyncHandler - Asynchronous callback handler for events in the life-cycle of the request. Users could provide the implementation of the four callback methods in this interface to process the operation result or handle the exception.

Returns:

A Java Future object containing the response from the ListResourceRecordSets 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.

changeResourceRecordSetsAsync

public Future<ChangeResourceRecordSetsResult> changeResourceRecordSetsAsync(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 2012-12-12/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 Creating, Changing, and Deleting Resource Record Sets Using the Route 53 API in the Amazon Route 53 Developer Guide .

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, Route 53 returns an InvalidChangeBatch error.

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

Note the following limitations on a ChangeResourceRecordSets request:

- A request cannot contain more than 100 Change elements.

- A request cannot contain more than 1000 ResourceRecord elements.

The sum of the number of characters (including spaces) in all Value elements in a request cannot exceed 32,000 characters.

Specified by:

changeResourceRecordSetsAsync in interface AmazonRoute53Async

Parameters:

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

Returns:

A Java Future object containing the response from the ChangeResourceRecordSets 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.

changeResourceRecordSetsAsync

public Future<ChangeResourceRecordSetsResult> changeResourceRecordSetsAsync(ChangeResourceRecordSetsRequest changeResourceRecordSetsRequest,
                                                                            AsyncHandler<ChangeResourceRecordSetsRequest,ChangeResourceRecordSetsResult> asyncHandler)
                                                                     throws AmazonServiceException,
                                                                            AmazonClientException

Use this action to create or change your authoritative DNS information. To use this action, send a POST request to the 2012-12-12/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 Creating, Changing, and Deleting Resource Record Sets Using the Route 53 API in the Amazon Route 53 Developer Guide .

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, Route 53 returns an InvalidChangeBatch error.

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

Note the following limitations on a ChangeResourceRecordSets request:

- A request cannot contain more than 100 Change elements.

- A request cannot contain more than 1000 ResourceRecord elements.

The sum of the number of characters (including spaces) in all Value elements in a request cannot exceed 32,000 characters.

Specified by:

changeResourceRecordSetsAsync in interface AmazonRoute53Async

Parameters:

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

asyncHandler - Asynchronous callback handler for events in the life-cycle of the request. Users could provide the implementation of the four callback methods in this interface to process the operation result or handle the exception.

Returns:

A Java Future object containing the response from the ChangeResourceRecordSets 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.

createHostedZoneAsync

public Future<CreateHostedZoneResult> createHostedZoneAsync(CreateHostedZoneRequest createHostedZoneRequest)
                                                     throws AmazonServiceException,
                                                            AmazonClientException

This action creates a new hosted zone.

To create a new hosted zone, send a POST request to the 2012-12-12/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.

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 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 Route 53 DNS servers.

Specified by:

createHostedZoneAsync in interface AmazonRoute53Async

Parameters:

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

Returns:

A Java Future object containing the response from the CreateHostedZone 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.

createHostedZoneAsync

public Future<CreateHostedZoneResult> createHostedZoneAsync(CreateHostedZoneRequest createHostedZoneRequest,
                                                            AsyncHandler<CreateHostedZoneRequest,CreateHostedZoneResult> asyncHandler)
                                                     throws AmazonServiceException,
                                                            AmazonClientException

This action creates a new hosted zone.

To create a new hosted zone, send a POST request to the 2012-12-12/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.

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 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 Route 53 DNS servers.

Specified by:

createHostedZoneAsync in interface AmazonRoute53Async

Parameters:

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

asyncHandler - Asynchronous callback handler for events in the life-cycle of the request. Users could provide the implementation of the four callback methods in this interface to process the operation result or handle the exception.

Returns:

A Java Future object containing the response from the CreateHostedZone 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.

getHealthCheckAsync

public Future<GetHealthCheckResult> getHealthCheckAsync(GetHealthCheckRequest getHealthCheckRequest)
                                                 throws AmazonServiceException,
                                                        AmazonClientException

To retrieve the health check, send a GET request to the 2012-12-12/healthcheck/health check ID resource.

Specified by:

getHealthCheckAsync in interface AmazonRoute53Async

Parameters:

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

Returns:

A Java Future object containing the response from the GetHealthCheck 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.

getHealthCheckAsync

public Future<GetHealthCheckResult> getHealthCheckAsync(GetHealthCheckRequest getHealthCheckRequest,
                                                        AsyncHandler<GetHealthCheckRequest,GetHealthCheckResult> asyncHandler)
                                                 throws AmazonServiceException,
                                                        AmazonClientException

To retrieve the health check, send a GET request to the 2012-12-12/healthcheck/health check ID resource.

Specified by:

getHealthCheckAsync in interface AmazonRoute53Async

Parameters:

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

asyncHandler - Asynchronous callback handler for events in the life-cycle of the request. Users could provide the implementation of the four callback methods in this interface to process the operation result or handle the exception.

Returns:

A Java Future object containing the response from the GetHealthCheck 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.

createHealthCheckAsync

public Future<CreateHealthCheckResult> createHealthCheckAsync(CreateHealthCheckRequest createHealthCheckRequest)
                                                       throws AmazonServiceException,
                                                              AmazonClientException

This action creates a new health check.

To create a new health check, send a POST request to the 2012-12-12/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.

Specified by:

createHealthCheckAsync in interface AmazonRoute53Async

Parameters:

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

Returns:

A Java Future object containing the response from the CreateHealthCheck 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.

createHealthCheckAsync

public Future<CreateHealthCheckResult> createHealthCheckAsync(CreateHealthCheckRequest createHealthCheckRequest,
                                                              AsyncHandler<CreateHealthCheckRequest,CreateHealthCheckResult> asyncHandler)
                                                       throws AmazonServiceException,
                                                              AmazonClientException

This action creates a new health check.

To create a new health check, send a POST request to the 2012-12-12/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.

Specified by:

createHealthCheckAsync in interface AmazonRoute53Async

Parameters:

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

asyncHandler - Asynchronous callback handler for events in the life-cycle of the request. Users could provide the implementation of the four callback methods in this interface to process the operation result or handle the exception.

Returns:

A Java Future object containing the response from the CreateHealthCheck 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.

getChangeAsync

public Future<GetChangeResult> getChangeAsync(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 Route 53 DNS servers. This is the initial status of all change batch requests.

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

Specified by:

getChangeAsync in interface AmazonRoute53Async

Parameters:

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

Returns:

A Java Future object containing the response from the GetChange 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.

getChangeAsync

public Future<GetChangeResult> getChangeAsync(GetChangeRequest getChangeRequest,
                                              AsyncHandler<GetChangeRequest,GetChangeResult> asyncHandler)
                                       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 Route 53 DNS servers. This is the initial status of all change batch requests.

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

Specified by:

getChangeAsync in interface AmazonRoute53Async

Parameters:

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

asyncHandler - Asynchronous callback handler for events in the life-cycle of the request. Users could provide the implementation of the four callback methods in this interface to process the operation result or handle the exception.

Returns:

A Java Future object containing the response from the GetChange 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.

deleteHealthCheckAsync

public Future<DeleteHealthCheckResult> deleteHealthCheckAsync(DeleteHealthCheckRequest deleteHealthCheckRequest)
                                                       throws AmazonServiceException,
                                                              AmazonClientException

This action deletes a health check. To delete a health check, send a DELETE request to the 2012-12-12/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, Route 53 will deny your request with a HealthCheckInUse error. For information about disassociating the records from your health check, see ChangeResourceRecordSets.

Specified by:

deleteHealthCheckAsync in interface AmazonRoute53Async

Parameters:

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

Returns:

A Java Future object containing the response from the DeleteHealthCheck 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.

deleteHealthCheckAsync

public Future<DeleteHealthCheckResult> deleteHealthCheckAsync(DeleteHealthCheckRequest deleteHealthCheckRequest,
                                                              AsyncHandler<DeleteHealthCheckRequest,DeleteHealthCheckResult> asyncHandler)
                                                       throws AmazonServiceException,
                                                              AmazonClientException

This action deletes a health check. To delete a health check, send a DELETE request to the 2012-12-12/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, Route 53 will deny your request with a HealthCheckInUse error. For information about disassociating the records from your health check, see ChangeResourceRecordSets.

Specified by:

deleteHealthCheckAsync in interface AmazonRoute53Async

Parameters:

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

asyncHandler - Asynchronous callback handler for events in the life-cycle of the request. Users could provide the implementation of the four callback methods in this interface to process the operation result or handle the exception.

Returns:

A Java Future object containing the response from the DeleteHealthCheck 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.

getHostedZoneAsync

public Future<GetHostedZoneResult> getHostedZoneAsync(GetHostedZoneRequest getHostedZoneRequest)
                                               throws AmazonServiceException,
                                                      AmazonClientException

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

Specified by:

getHostedZoneAsync in interface AmazonRoute53Async

Parameters:

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

Returns:

A Java Future object containing the response from the GetHostedZone 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.

getHostedZoneAsync

public Future<GetHostedZoneResult> getHostedZoneAsync(GetHostedZoneRequest getHostedZoneRequest,
                                                      AsyncHandler<GetHostedZoneRequest,GetHostedZoneResult> asyncHandler)
                                               throws AmazonServiceException,
                                                      AmazonClientException

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

Specified by:

getHostedZoneAsync in interface AmazonRoute53Async

Parameters:

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

asyncHandler - Asynchronous callback handler for events in the life-cycle of the request. Users could provide the implementation of the four callback methods in this interface to process the operation result or handle the exception.

Returns:

A Java Future object containing the response from the GetHostedZone 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.

listHostedZonesAsync

public Future<ListHostedZonesResult> listHostedZonesAsync(ListHostedZonesRequest listHostedZonesRequest)
                                                   throws AmazonServiceException,
                                                          AmazonClientException

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

Specified by:

listHostedZonesAsync in interface AmazonRoute53Async

Parameters:

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

Returns:

A Java Future object containing the response from the ListHostedZones 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.

listHostedZonesAsync

public Future<ListHostedZonesResult> listHostedZonesAsync(ListHostedZonesRequest listHostedZonesRequest,
                                                          AsyncHandler<ListHostedZonesRequest,ListHostedZonesResult> asyncHandler)
                                                   throws AmazonServiceException,
                                                          AmazonClientException

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

Specified by:

listHostedZonesAsync in interface AmazonRoute53Async

Parameters:

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

asyncHandler - Asynchronous callback handler for events in the life-cycle of the request. Users could provide the implementation of the four callback methods in this interface to process the operation result or handle the exception.

Returns:

A Java Future object containing the response from the ListHostedZones 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.

deleteHostedZoneAsync

public Future<DeleteHostedZoneResult> deleteHostedZoneAsync(DeleteHostedZoneRequest deleteHostedZoneRequest)
                                                     throws AmazonServiceException,
                                                            AmazonClientException

This action deletes a hosted zone. To delete a hosted zone, send a DELETE request to the 2012-12-12/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, Route 53 will deny your request with a HostedZoneNotEmpty error. For information about deleting records from your hosted zone, see ChangeResourceRecordSets.

Specified by:

deleteHostedZoneAsync in interface AmazonRoute53Async

Parameters:

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

Returns:

A Java Future object containing the response from the DeleteHostedZone 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.

deleteHostedZoneAsync

public Future<DeleteHostedZoneResult> deleteHostedZoneAsync(DeleteHostedZoneRequest deleteHostedZoneRequest,
                                                            AsyncHandler<DeleteHostedZoneRequest,DeleteHostedZoneResult> asyncHandler)
                                                     throws AmazonServiceException,
                                                            AmazonClientException

This action deletes a hosted zone. To delete a hosted zone, send a DELETE request to the 2012-12-12/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, Route 53 will deny your request with a HostedZoneNotEmpty error. For information about deleting records from your hosted zone, see ChangeResourceRecordSets.

Specified by:

deleteHostedZoneAsync in interface AmazonRoute53Async

Parameters:

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

asyncHandler - Asynchronous callback handler for events in the life-cycle of the request. Users could provide the implementation of the four callback methods in this interface to process the operation result or handle the exception.

Returns:

A Java Future object containing the response from the DeleteHostedZone 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.

listHealthChecksAsync

public Future<ListHealthChecksResult> listHealthChecksAsync(ListHealthChecksRequest listHealthChecksRequest)
                                                     throws AmazonServiceException,
                                                            AmazonClientException

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

Specified by:

listHealthChecksAsync in interface AmazonRoute53Async

Parameters:

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

Returns:

A Java Future object containing the response from the ListHealthChecks 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.

listHealthChecksAsync

public Future<ListHealthChecksResult> listHealthChecksAsync(ListHealthChecksRequest listHealthChecksRequest,
                                                            AsyncHandler<ListHealthChecksRequest,ListHealthChecksResult> asyncHandler)
                                                     throws AmazonServiceException,
                                                            AmazonClientException

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

Specified by:

listHealthChecksAsync in interface AmazonRoute53Async

Parameters:

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

asyncHandler - Asynchronous callback handler for events in the life-cycle of the request. Users could provide the implementation of the four callback methods in this interface to process the operation result or handle the exception.

Returns:

A Java Future object containing the response from the ListHealthChecks 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.