Start line:  
End line:  

Snippet Preview

Snippet HTML Code

Stack Overflow Questions
   /*
    * Copyright 2010-2015 Amazon.com, Inc. or its affiliates. All Rights Reserved.
    * 
    * Licensed under the Apache License, Version 2.0 (the "License").
    * You may not use this file except in compliance with the License.
    * A copy of the License is located at
    * 
    *  http://aws.amazon.com/apache2.0
    * 
   * or in the "license" file accompanying this file. This file is distributed
   * on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either
   * express or implied. See the License for the specific language governing
   * permissions and limitations under the License.
   */
  package com.amazonaws.services.route53;
  
  import com.amazonaws.*;
Interface for accessing AmazonRoute53.
  
  public interface AmazonRoute53 {

    
Overrides the default endpoint for this client ("https://route53.amazonaws.com"). Callers can use this method to control which AWS region they want to work with.

Callers can pass in just the endpoint (ex: "route53.amazonaws.com") or a full URL, including the protocol (ex: "https://route53.amazonaws.com"). If the protocol is not specified here, the default protocol from this client's com.amazonaws.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:
java.lang.IllegalArgumentException If any problems are detected with the specified endpoint.
  
      public void setEndpoint(String endpointthrows java.lang.IllegalArgumentException;

    
An alternative to setEndpoint(java.lang.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 com.amazonaws.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.

  
      public void setRegion(Region regionthrows java.lang.IllegalArgumentException;
    
    

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 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:
com.amazonaws.services.route53.model.NoSuchHostedZoneException
com.amazonaws.services.route53.model.InvalidInputException
com.amazonaws.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.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.
 
     public GetHostedZoneResult getHostedZone(GetHostedZoneRequest getHostedZoneRequest
             throws AmazonServiceExceptionAmazonClientException;

    

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.

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:
com.amazonaws.services.route53.model.NoSuchChangeException
com.amazonaws.services.route53.model.InvalidInputException
com.amazonaws.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.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.
 
     public GetChangeResult getChange(GetChangeRequest getChangeRequest
             throws AmazonServiceExceptionAmazonClientException;

    

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:
com.amazonaws.services.route53.model.NoSuchGeoLocationException
com.amazonaws.services.route53.model.InvalidInputException
com.amazonaws.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.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.
 
     public GetGeoLocationResult getGeoLocation(GetGeoLocationRequest getGeoLocationRequest
             throws AmazonServiceExceptionAmazonClientException;

    

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:
com.amazonaws.services.route53.model.NoSuchHostedZoneException
com.amazonaws.services.route53.model.InvalidInputException
com.amazonaws.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.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.
 
             throws AmazonServiceExceptionAmazonClientException;

    

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:
com.amazonaws.services.route53.model.PriorRequestNotCompleteException
com.amazonaws.services.route53.model.NoSuchHealthCheckException
com.amazonaws.services.route53.model.ThrottlingException
com.amazonaws.services.route53.model.NoSuchHostedZoneException
com.amazonaws.services.route53.model.InvalidInputException
com.amazonaws.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.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.
 
     public ListTagsForResourcesResult listTagsForResources(ListTagsForResourcesRequest listTagsForResourcesRequest
             throws AmazonServiceExceptionAmazonClientException;

    

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, 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:
com.amazonaws.services.route53.model.NoSuchHealthCheckException
com.amazonaws.services.route53.model.HealthCheckInUseException
com.amazonaws.services.route53.model.InvalidInputException
com.amazonaws.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.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.
 
     public DeleteHealthCheckResult deleteHealthCheck(DeleteHealthCheckRequest deleteHealthCheckRequest
             throws AmazonServiceExceptionAmazonClientException;

    

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:
com.amazonaws.services.route53.model.NoSuchHostedZoneException
com.amazonaws.services.route53.model.InvalidInputException
com.amazonaws.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.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.
 
     public ListResourceRecordSetsResult listResourceRecordSets(ListResourceRecordSetsRequest listResourceRecordSetsRequest
             throws AmazonServiceExceptionAmazonClientException;

    

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, 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:
com.amazonaws.services.route53.model.NoSuchDelegationSetException
com.amazonaws.services.route53.model.DelegationSetInUseException
com.amazonaws.services.route53.model.DelegationSetNotReusableException
com.amazonaws.services.route53.model.InvalidInputException
com.amazonaws.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.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.
 
             throws AmazonServiceExceptionAmazonClientException;

    

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:
com.amazonaws.services.route53.model.NoSuchHealthCheckException
com.amazonaws.services.route53.model.IncompatibleVersionException
com.amazonaws.services.route53.model.InvalidInputException
com.amazonaws.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.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.
 
     public GetHealthCheckResult getHealthCheck(GetHealthCheckRequest getHealthCheckRequest
             throws AmazonServiceExceptionAmazonClientException;

    

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:
com.amazonaws.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.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.
 
     public GetCheckerIpRangesResult getCheckerIpRanges(GetCheckerIpRangesRequest getCheckerIpRangesRequest
             throws AmazonServiceExceptionAmazonClientException;

    

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:
com.amazonaws.services.route53.model.DelegationSetAlreadyCreatedException
com.amazonaws.services.route53.model.HostedZoneNotFoundException
com.amazonaws.services.route53.model.DelegationSetNotAvailableException
com.amazonaws.services.route53.model.InvalidInputException
com.amazonaws.services.route53.model.InvalidArgumentException
com.amazonaws.services.route53.model.LimitsExceededException
com.amazonaws.services.route53.model.DelegationSetAlreadyReusableException
com.amazonaws.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.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.
 
             throws AmazonServiceExceptionAmazonClientException;

    

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:
com.amazonaws.services.route53.model.InvalidVPCIdException
com.amazonaws.services.route53.model.NoSuchHostedZoneException
com.amazonaws.services.route53.model.LastVPCAssociationException
com.amazonaws.services.route53.model.InvalidInputException
com.amazonaws.services.route53.model.VPCAssociationNotFoundException
com.amazonaws.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.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.
 
             throws AmazonServiceExceptionAmazonClientException;

    

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:
com.amazonaws.services.route53.model.NoSuchHealthCheckException
com.amazonaws.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.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.
 
             throws AmazonServiceExceptionAmazonClientException;

    

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:
com.amazonaws.services.route53.model.InvalidInputException
com.amazonaws.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.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.
 
     public ListGeoLocationsResult listGeoLocations(ListGeoLocationsRequest listGeoLocationsRequest
             throws AmazonServiceExceptionAmazonClientException;

    

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:
com.amazonaws.services.route53.model.HealthCheckAlreadyExistsException
com.amazonaws.services.route53.model.InvalidInputException
com.amazonaws.services.route53.model.TooManyHealthChecksException
com.amazonaws.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.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.
 
     public CreateHealthCheckResult createHealthCheck(CreateHealthCheckRequest createHealthCheckRequest
             throws AmazonServiceExceptionAmazonClientException;

    

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:
com.amazonaws.services.route53.model.IncompatibleVersionException
com.amazonaws.services.route53.model.InvalidInputException
com.amazonaws.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.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.
 
     public ListHealthChecksResult listHealthChecks(ListHealthChecksRequest listHealthChecksRequest
             throws AmazonServiceExceptionAmazonClientException;

    

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:
com.amazonaws.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.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.
 
     public GetHealthCheckCountResult getHealthCheckCount(GetHealthCheckCountRequest getHealthCheckCountRequest
             throws AmazonServiceExceptionAmazonClientException;

    

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:
com.amazonaws.services.route53.model.PriorRequestNotCompleteException
com.amazonaws.services.route53.model.NoSuchHealthCheckException
com.amazonaws.services.route53.model.ThrottlingException
com.amazonaws.services.route53.model.NoSuchHostedZoneException
com.amazonaws.services.route53.model.InvalidInputException
com.amazonaws.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.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.
 
     public ChangeTagsForResourceResult changeTagsForResource(ChangeTagsForResourceRequest changeTagsForResourceRequest
             throws AmazonServiceExceptionAmazonClientException;

    

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:
com.amazonaws.services.route53.model.NoSuchHealthCheckException
com.amazonaws.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.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.
 
     public GetHealthCheckStatusResult getHealthCheckStatus(GetHealthCheckStatusRequest getHealthCheckStatusRequest
             throws AmazonServiceExceptionAmazonClientException;

    

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:
com.amazonaws.services.route53.model.NoSuchDelegationSetException
com.amazonaws.services.route53.model.DelegationSetNotReusableException
com.amazonaws.services.route53.model.InvalidInputException
com.amazonaws.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.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.
 
     public ListHostedZonesResult listHostedZones(ListHostedZonesRequest listHostedZonesRequest
             throws AmazonServiceExceptionAmazonClientException;

    

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:
com.amazonaws.services.route53.model.InvalidInputException
com.amazonaws.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.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.
 
     public GetHostedZoneCountResult getHostedZoneCount(GetHostedZoneCountRequest getHostedZoneCountRequest
             throws AmazonServiceExceptionAmazonClientException;

    

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:
com.amazonaws.services.route53.model.NoSuchDelegationSetException
com.amazonaws.services.route53.model.DelegationSetNotReusableException
com.amazonaws.services.route53.model.InvalidInputException
com.amazonaws.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.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.
 
             throws AmazonServiceExceptionAmazonClientException;

    

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:
com.amazonaws.services.route53.model.HealthCheckVersionMismatchException
com.amazonaws.services.route53.model.NoSuchHealthCheckException
com.amazonaws.services.route53.model.InvalidInputException
com.amazonaws.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.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.
 
     public UpdateHealthCheckResult updateHealthCheck(UpdateHealthCheckRequest updateHealthCheckRequest
             throws AmazonServiceExceptionAmazonClientException;

    

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:
com.amazonaws.services.route53.model.InvalidInputException
com.amazonaws.services.route53.model.InvalidDomainNameException
com.amazonaws.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.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.
 
     public ListHostedZonesByNameResult listHostedZonesByName(ListHostedZonesByNameRequest listHostedZonesByNameRequest
             throws AmazonServiceExceptionAmazonClientException;

    

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, 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:
com.amazonaws.services.route53.model.PriorRequestNotCompleteException
com.amazonaws.services.route53.model.HostedZoneNotEmptyException
com.amazonaws.services.route53.model.NoSuchHostedZoneException
com.amazonaws.services.route53.model.InvalidInputException
com.amazonaws.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.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.
 
     public DeleteHostedZoneResult deleteHostedZone(DeleteHostedZoneRequest deleteHostedZoneRequest
             throws AmazonServiceExceptionAmazonClientException;

    

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.

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.

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:
com.amazonaws.services.route53.model.ConflictingDomainExistsException
com.amazonaws.services.route53.model.TooManyHostedZonesException
com.amazonaws.services.route53.model.NoSuchDelegationSetException
com.amazonaws.services.route53.model.InvalidVPCIdException
com.amazonaws.services.route53.model.DelegationSetNotAvailableException
com.amazonaws.services.route53.model.DelegationSetNotReusableException
com.amazonaws.services.route53.model.InvalidDomainNameException
com.amazonaws.services.route53.model.InvalidInputException
com.amazonaws.services.route53.model.HostedZoneAlreadyExistsException
com.amazonaws.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.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.
    public CreateHostedZoneResult createHostedZone(CreateHostedZoneRequest createHostedZoneRequest
            throws AmazonServiceExceptionAmazonClientException;

    

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:
com.amazonaws.services.route53.model.ConflictingDomainExistsException
com.amazonaws.services.route53.model.InvalidVPCIdException
com.amazonaws.services.route53.model.NoSuchHostedZoneException
com.amazonaws.services.route53.model.PublicZoneVPCAssociationException
com.amazonaws.services.route53.model.InvalidInputException
com.amazonaws.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.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.
            throws AmazonServiceExceptionAmazonClientException;

    

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:
com.amazonaws.services.route53.model.PriorRequestNotCompleteException
com.amazonaws.services.route53.model.NoSuchHealthCheckException
com.amazonaws.services.route53.model.ThrottlingException
com.amazonaws.services.route53.model.NoSuchHostedZoneException
com.amazonaws.services.route53.model.InvalidInputException
com.amazonaws.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.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.
    public ListTagsForResourceResult listTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest
            throws AmazonServiceExceptionAmazonClientException;

    

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:
com.amazonaws.services.route53.model.InvalidInputException
com.amazonaws.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.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.
            throws AmazonServiceExceptionAmazonClientException;

    

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

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:
com.amazonaws.services.route53.model.PriorRequestNotCompleteException
com.amazonaws.services.route53.model.NoSuchHealthCheckException
com.amazonaws.services.route53.model.NoSuchHostedZoneException
com.amazonaws.services.route53.model.InvalidInputException
com.amazonaws.services.route53.model.InvalidChangeBatchException
com.amazonaws.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.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.
            throws AmazonServiceExceptionAmazonClientException;

    

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:
com.amazonaws.services.route53.model.NoSuchGeoLocationException
com.amazonaws.services.route53.model.InvalidInputException
com.amazonaws.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.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.

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:
com.amazonaws.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.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.

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:
com.amazonaws.services.route53.model.InvalidInputException
com.amazonaws.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.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.

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:
com.amazonaws.services.route53.model.IncompatibleVersionException
com.amazonaws.services.route53.model.InvalidInputException
com.amazonaws.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.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.

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:
com.amazonaws.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.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.

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:
com.amazonaws.services.route53.model.NoSuchDelegationSetException
com.amazonaws.services.route53.model.DelegationSetNotReusableException
com.amazonaws.services.route53.model.InvalidInputException
com.amazonaws.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.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.

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:
com.amazonaws.services.route53.model.InvalidInputException
com.amazonaws.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.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.

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:
com.amazonaws.services.route53.model.InvalidInputException
com.amazonaws.services.route53.model.InvalidDomainNameException
com.amazonaws.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.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.

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:
com.amazonaws.services.route53.model.InvalidInputException
com.amazonaws.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.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.
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.
    public void shutdown();
    
    
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.
}
        
New to GrepCode? Check out our FAQ X