|
Did this page help you?Yes No Tell us about it... |
||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||
public interface AmazonRoute53Async
Interface for accessing AmazonRoute53 asynchronously. Each asynchronous method will return a Java Future object, and users are also allowed to provide a callback handler.
| Method Summary | |
|---|---|
java.util.concurrent.Future<ChangeResourceRecordSetsResult> |
changeResourceRecordSetsAsync(ChangeResourceRecordSetsRequest changeResourceRecordSetsRequest)
Use this action to create or change your authoritative DNS information. |
java.util.concurrent.Future<ChangeResourceRecordSetsResult> |
changeResourceRecordSetsAsync(ChangeResourceRecordSetsRequest changeResourceRecordSetsRequest,
AsyncHandler<ChangeResourceRecordSetsRequest,ChangeResourceRecordSetsResult> asyncHandler)
Use this action to create or change your authoritative DNS information. |
java.util.concurrent.Future<CreateHostedZoneResult> |
createHostedZoneAsync(CreateHostedZoneRequest createHostedZoneRequest)
This action creates a new hosted zone. |
java.util.concurrent.Future<CreateHostedZoneResult> |
createHostedZoneAsync(CreateHostedZoneRequest createHostedZoneRequest,
AsyncHandler<CreateHostedZoneRequest,CreateHostedZoneResult> asyncHandler)
This action creates a new hosted zone. |
java.util.concurrent.Future<DeleteHostedZoneResult> |
deleteHostedZoneAsync(DeleteHostedZoneRequest deleteHostedZoneRequest)
This action deletes a hosted zone. |
java.util.concurrent.Future<DeleteHostedZoneResult> |
deleteHostedZoneAsync(DeleteHostedZoneRequest deleteHostedZoneRequest,
AsyncHandler<DeleteHostedZoneRequest,DeleteHostedZoneResult> asyncHandler)
This action deletes a hosted zone. |
java.util.concurrent.Future<GetChangeResult> |
getChangeAsync(GetChangeRequest getChangeRequest)
This action returns the current status of a change batch request. |
java.util.concurrent.Future<GetChangeResult> |
getChangeAsync(GetChangeRequest getChangeRequest,
AsyncHandler<GetChangeRequest,GetChangeResult> asyncHandler)
This action returns the current status of a change batch request. |
java.util.concurrent.Future<GetHostedZoneResult> |
getHostedZoneAsync(GetHostedZoneRequest getHostedZoneRequest)
To retrieve the delegation set for a hosted zone, send a GET request to the 2012-02-29/hostedzone/hosted
zone ID resource. |
java.util.concurrent.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-02-29/hostedzone/hosted
zone ID resource. |
java.util.concurrent.Future<ListHostedZonesResult> |
listHostedZonesAsync(ListHostedZonesRequest listHostedZonesRequest)
To retrieve a list of your hosted zones, send a GET
request to the 2012-02-29/hostedzone resource. |
java.util.concurrent.Future<ListHostedZonesResult> |
listHostedZonesAsync(ListHostedZonesRequest listHostedZonesRequest,
AsyncHandler<ListHostedZonesRequest,ListHostedZonesResult> asyncHandler)
To retrieve a list of your hosted zones, send a GET
request to the 2012-02-29/hostedzone resource. |
java.util.concurrent.Future<ListResourceRecordSetsResult> |
listResourceRecordSetsAsync(ListResourceRecordSetsRequest listResourceRecordSetsRequest)
Imagine all the resource record sets in a zone listed out in front of you. |
java.util.concurrent.Future<ListResourceRecordSetsResult> |
listResourceRecordSetsAsync(ListResourceRecordSetsRequest listResourceRecordSetsRequest,
AsyncHandler<ListResourceRecordSetsRequest,ListResourceRecordSetsResult> asyncHandler)
Imagine all the resource record sets in a zone listed out in front of you. |
| Methods inherited from interface com.amazonaws.services.route53.AmazonRoute53 |
|---|
changeResourceRecordSets, createHostedZone, deleteHostedZone, getCachedResponseMetadata, getChange, getHostedZone, listHostedZones, listHostedZones, listResourceRecordSets, setEndpoint, shutdown |
| Method Detail |
|---|
java.util.concurrent.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-02-29/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.
createHostedZoneRequest - Container for the necessary parameters
to execute the CreateHostedZone operation on AmazonRoute53.
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.
java.util.concurrent.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-02-29/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.
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.
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.
java.util.concurrent.Future<ListHostedZonesResult> listHostedZonesAsync(ListHostedZonesRequest listHostedZonesRequest)
throws AmazonServiceException,
AmazonClientException
To retrieve a list of your hosted zones, send a GET
request to the 2012-02-29/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.
listHostedZonesRequest - Container for the necessary parameters
to execute the ListHostedZones operation on AmazonRoute53.
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.
java.util.concurrent.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-02-29/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.
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.
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.
java.util.concurrent.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-02-29/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.
changeResourceRecordSetsRequest - Container for the necessary
parameters to execute the ChangeResourceRecordSets operation on
AmazonRoute53.
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.
java.util.concurrent.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-02-29/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.
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.
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.
java.util.concurrent.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.
getChangeRequest - Container for the necessary parameters to
execute the GetChange operation on AmazonRoute53.
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.
java.util.concurrent.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.
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.
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.
java.util.concurrent.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:
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.
listResourceRecordSetsRequest - Container for the necessary
parameters to execute the ListResourceRecordSets operation on
AmazonRoute53.
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.
java.util.concurrent.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:
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.
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.
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.
java.util.concurrent.Future<GetHostedZoneResult> getHostedZoneAsync(GetHostedZoneRequest getHostedZoneRequest)
throws AmazonServiceException,
AmazonClientException
To retrieve the delegation set for a hosted zone, send a
GET request to the 2012-02-29/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.
getHostedZoneRequest - Container for the necessary parameters to
execute the GetHostedZone operation on AmazonRoute53.
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.
java.util.concurrent.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-02-29/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.
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.
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.
java.util.concurrent.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-02-29/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.
deleteHostedZoneRequest - Container for the necessary parameters
to execute the DeleteHostedZone operation on AmazonRoute53.
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.
java.util.concurrent.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-02-29/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.
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.
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.
|
|||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||