com.amazonaws.services.route53.AmazonRoute53 Maven / Gradle / Ivy
Show all versions of aws-java-sdk-route53 Show documentation
/*
* Copyright 2010-2016 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.*;
import com.amazonaws.regions.*;
import com.amazonaws.services.route53.model.*;
/**
* Interface for accessing Route 53.
*/
public interface AmazonRoute53 {
/**
* The region metadata service name for computing region endpoints. You can
* use this value to retrieve metadata (such as supported regions) of the
* service.
*
* @see RegionUtils#getRegionsForService(String)
*/
String ENDPOINT_PREFIX = "route53";
/**
* 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 {@link 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.
*
* @param 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.
*/
void setEndpoint(String endpoint);
/**
* An alternative to {@link AmazonRoute53#setEndpoint(String)}, sets the
* regional endpoint for this client's service calls. Callers can use this
* method to control which AWS region they want to work with.
*
* By default, all service endpoints in all regions use the https protocol.
* To use http instead, specify it in the {@link 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.
*
* @param region
* The region this client will communicate with. See
* {@link Region#getRegion(com.amazonaws.regions.Regions)} for
* accessing a given region. Must not be null and must be a region
* where the service is available.
*
* @see Region#getRegion(com.amazonaws.regions.Regions)
* @see Region#createClient(Class,
* com.amazonaws.auth.AWSCredentialsProvider, ClientConfiguration)
* @see Region#isServiceSupported(String)
*/
void setRegion(Region region);
/**
*
* This action associates a VPC with an hosted zone.
*
*
* To associate a VPC with an hosted zone, send a POST request
* to the
* /Route 53 API version/hostedzone/hosted zone ID/associatevpc
* resource. The request body must include a document with a
* AssociateVPCWithHostedZoneRequest element. The response
* returns the AssociateVPCWithHostedZoneResponse element that
* contains ChangeInfo for you to track the progress of the
* AssociateVPCWithHostedZoneRequest you made. See
* GetChange operation for how to track the progress of your
* change.
*
*
* @param associateVPCWithHostedZoneRequest
* A complex type that contains information about the request to
* associate a VPC with an hosted zone.
* @return Result of the AssociateVPCWithHostedZone operation returned by
* the service.
* @throws NoSuchHostedZoneException
* @throws InvalidVPCIdException
* The hosted zone you are trying to create for your VPC_ID does not
* belong to you. Amazon Route 53 returns this error when the VPC
* specified by VPCId does not belong to you.
* @throws InvalidInputException
* Some value specified in the request is invalid or the XML
* document is malformed.
* @throws PublicZoneVPCAssociationException
* The hosted zone you are trying to associate VPC with doesn't have
* any VPC association. Amazon Route 53 currently doesn't support
* associate a VPC with a public hosted zone.
* @throws ConflictingDomainExistsException
* @throws LimitsExceededException
* The limits specified for a resource have been exceeded.
* @sample AmazonRoute53.AssociateVPCWithHostedZone
*/
AssociateVPCWithHostedZoneResult associateVPCWithHostedZone(
AssociateVPCWithHostedZoneRequest associateVPCWithHostedZoneRequest);
/**
*
* Use this action to create or change your authoritative DNS information.
* To use this action, send a POST request to the
* /Route 53 API version/hostedzone/hosted Zone ID/rrset
* resource. The request body must include a document with a
* ChangeResourceRecordSetsRequest element.
*
*
* Changes are a list of change items and are considered transactional. For
* more information on transactional changes, also known as change batches,
* see POST ChangeResourceRecordSets in the Amazon Route 53 API
* Reference.
*
* Due to the nature of transactional changes, you cannot delete
* the same resource record set more than once in a single change batch. If
* you attempt to delete the same change batch more than once, Amazon Route
* 53 returns an InvalidChangeBatch error.
*
* In response to a ChangeResourceRecordSets request, your DNS
* data is changed on all Amazon Route 53 DNS servers. Initially, the status
* of a change is PENDING. This means the change has not yet
* propagated to all the authoritative Amazon Route 53 DNS servers. When the
* change is propagated to all hosts, the change returns a status of
* INSYNC.
*
*
* Note the following limitations on a ChangeResourceRecordSets
* request:
*
*
* - A request cannot contain more than 100 Change elements.
* - A request cannot contain more than 1000 ResourceRecord elements.
* - The sum of the number of characters (including spaces) in all
*
Value elements in a request cannot exceed 32,000 characters.
*
*
*
* @param changeResourceRecordSetsRequest
* A complex type that contains a change batch.
* @return Result of the ChangeResourceRecordSets operation returned by the
* service.
* @throws NoSuchHostedZoneException
* @throws NoSuchHealthCheckException
* The health check you are trying to get or delete does not exist.
* @throws InvalidChangeBatchException
* This error contains a list of one or more error messages. Each
* error message indicates one error in the change batch.
* @throws InvalidInputException
* Some value specified in the request is invalid or the XML
* document is malformed.
* @throws PriorRequestNotCompleteException
* The request was rejected because Amazon Route 53 was still
* processing a prior request.
* @sample AmazonRoute53.ChangeResourceRecordSets
*/
ChangeResourceRecordSetsResult changeResourceRecordSets(
ChangeResourceRecordSetsRequest changeResourceRecordSetsRequest);
/**
* @param changeTagsForResourceRequest
* A complex type containing information about a request to add,
* change, or delete the tags that are associated with a resource.
* @return Result of the ChangeTagsForResource operation returned by the
* service.
* @throws InvalidInputException
* Some value specified in the request is invalid or the XML
* document is malformed.
* @throws NoSuchHealthCheckException
* The health check you are trying to get or delete does not exist.
* @throws NoSuchHostedZoneException
* @throws PriorRequestNotCompleteException
* The request was rejected because Amazon Route 53 was still
* processing a prior request.
* @throws ThrottlingException
* @sample AmazonRoute53.ChangeTagsForResource
*/
ChangeTagsForResourceResult changeTagsForResource(
ChangeTagsForResourceRequest changeTagsForResourceRequest);
/**
*
* This action creates a new health check.
*
*
* To create a new health check, send a POST request to the
* /Route 53 API version/healthcheck resource. The
* request body must include a document with a
* CreateHealthCheckRequest element. The response returns the
* CreateHealthCheckResponse element that contains metadata
* about the health check.
*
*
* @param createHealthCheckRequest
* >A complex type that contains information about the request to
* create a health check.
* @return Result of the CreateHealthCheck operation returned by the
* service.
* @throws TooManyHealthChecksException
* @throws HealthCheckAlreadyExistsException
* The health check you are trying to create already exists. Amazon
* Route 53 returns this error when a health check has already been
* created with the specified CallerReference.
* @throws InvalidInputException
* Some value specified in the request is invalid or the XML
* document is malformed.
* @sample AmazonRoute53.CreateHealthCheck
*/
CreateHealthCheckResult createHealthCheck(
CreateHealthCheckRequest createHealthCheckRequest);
/**
*
* This action creates a new hosted zone.
*
*
* To create a new hosted zone, send a POST request to the
* /Route 53 API version/hostedzone resource. The
* request body must include a document with a
* CreateHostedZoneRequest element. The response returns the
* CreateHostedZoneResponse element that contains metadata
* about the hosted zone.
*
*
* Amazon Route 53 automatically creates a default SOA record and four NS
* records for the zone. The NS records in the hosted zone are the name
* servers you give your registrar to delegate your domain to. For more
* information about SOA and NS records, see NS and SOA Records that Amazon Route 53 Creates for a Hosted Zone in
* the Amazon Route 53 Developer Guide.
*
*
* When you create a zone, its initial status is PENDING. This
* means that it is not yet available on all DNS servers. The status of the
* zone changes to INSYNC when the NS and SOA records are
* available on all Amazon Route 53 DNS servers.
*
*
* When trying to create a hosted zone using a reusable delegation set, you
* could specify an optional DelegationSetId, and Route53 would assign those
* 4 NS records for the zone, instead of alloting a new one.
*
*
* @param createHostedZoneRequest
* A complex type that contains information about the request to
* create a hosted zone.
* @return Result of the CreateHostedZone operation returned by the service.
* @throws InvalidDomainNameException
* This error indicates that the specified domain name is not valid.
* @throws HostedZoneAlreadyExistsException
* The hosted zone you are trying to create already exists. Amazon
* Route 53 returns this error when a hosted zone has already been
* created with the specified CallerReference.
* @throws TooManyHostedZonesException
* This error indicates that you've reached the maximum number of
* hosted zones that can be created for the current AWS account. You
* can request an increase to the limit on the Contact Us
* page.
* @throws InvalidVPCIdException
* The hosted zone you are trying to create for your VPC_ID does not
* belong to you. Amazon Route 53 returns this error when the VPC
* specified by VPCId does not belong to you.
* @throws InvalidInputException
* Some value specified in the request is invalid or the XML
* document is malformed.
* @throws DelegationSetNotAvailableException
* Amazon Route 53 allows some duplicate domain names, but there is
* a maximum number of duplicate names. This error indicates that
* you have reached that maximum. If you want to create another
* hosted zone with the same name and Amazon Route 53 generates this
* error, you can request an increase to the limit on the Contact Us
* page.
* @throws ConflictingDomainExistsException
* @throws NoSuchDelegationSetException
* The specified delegation set does not exist.
* @throws DelegationSetNotReusableException
* The specified delegation set has not been marked as reusable.
* @sample AmazonRoute53.CreateHostedZone
*/
CreateHostedZoneResult createHostedZone(
CreateHostedZoneRequest createHostedZoneRequest);
/**
*
* This action creates a reusable delegationSet.
*
*
* To create a new reusable delegationSet, send a POST request
* to the /Route 53 API version/delegationset resource.
* The request body must include a document with a
* CreateReusableDelegationSetRequest element. The response
* returns the CreateReusableDelegationSetResponse element that
* contains metadata about the delegationSet.
*
*
* If the optional parameter HostedZoneId is specified, it marks the
* delegationSet associated with that particular hosted zone as reusable.
*
*
* @param createReusableDelegationSetRequest
* @return Result of the CreateReusableDelegationSet operation returned by
* the service.
* @throws DelegationSetAlreadyCreatedException
* A delegation set with the same owner and caller reference
* combination has already been created.
* @throws LimitsExceededException
* The limits specified for a resource have been exceeded.
* @throws HostedZoneNotFoundException
* The specified HostedZone cannot be found.
* @throws InvalidArgumentException
* At least one of the specified arguments is invalid.
* @throws InvalidInputException
* Some value specified in the request is invalid or the XML
* document is malformed.
* @throws DelegationSetNotAvailableException
* Amazon Route 53 allows some duplicate domain names, but there is
* a maximum number of duplicate names. This error indicates that
* you have reached that maximum. If you want to create another
* hosted zone with the same name and Amazon Route 53 generates this
* error, you can request an increase to the limit on the Contact Us
* page.
* @throws DelegationSetAlreadyReusableException
* The specified delegation set has already been marked as reusable.
* @sample AmazonRoute53.CreateReusableDelegationSet
*/
CreateReusableDelegationSetResult createReusableDelegationSet(
CreateReusableDelegationSetRequest createReusableDelegationSetRequest);
/**
*
* Creates a traffic policy, which you use to create multiple DNS resource
* record sets for one domain name (such as example.com) or one subdomain
* name (such as www.example.com).
*
*
* To create a traffic policy, send a POST request to the
* /Route 53 API version/trafficpolicy resource. The
* request body must include a document with a
* CreateTrafficPolicyRequest element. The response includes
* the CreateTrafficPolicyResponse element, which contains
* information about the new traffic policy.
*
*
* @param createTrafficPolicyRequest
* A complex type that contains information about the traffic policy
* that you want to create.
* @return Result of the CreateTrafficPolicy operation returned by the
* service.
* @throws InvalidInputException
* Some value specified in the request is invalid or the XML
* document is malformed.
* @throws TooManyTrafficPoliciesException
* You've created the maximum number of traffic policies that can be
* created for the current AWS account. You can request an increase
* to the limit on the Contact Us
* page.
* @throws TrafficPolicyAlreadyExistsException
* A traffic policy that has the same value for Name
* already exists.
* @throws InvalidTrafficPolicyDocumentException
* The format of the traffic policy document that you specified in
* the Document element is invalid.
* @sample AmazonRoute53.CreateTrafficPolicy
*/
CreateTrafficPolicyResult createTrafficPolicy(
CreateTrafficPolicyRequest createTrafficPolicyRequest);
/**
*
* Creates resource record sets in a specified hosted zone based on the
* settings in a specified traffic policy version. In addition,
* CreateTrafficPolicyInstance associates the resource record
* sets with a specified domain name (such as example.com) or subdomain name
* (such as www.example.com). Amazon Route 53 responds to DNS queries for
* the domain or subdomain name by using the resource record sets that
* CreateTrafficPolicyInstance created.
*
*
* To create a traffic policy instance, send a POST request to
* the /Route 53 API version/trafficpolicyinstance
* resource. The request body must include a document with a
* CreateTrafficPolicyRequest element. The response returns the
* CreateTrafficPolicyInstanceResponse element, which contains
* information about the traffic policy instance.
*
*
* @param createTrafficPolicyInstanceRequest
* A complex type that contains information about the resource record
* sets that you want to create based on a specified traffic policy.
* @return Result of the CreateTrafficPolicyInstance operation returned by
* the service.
* @throws NoSuchHostedZoneException
* @throws InvalidInputException
* Some value specified in the request is invalid or the XML
* document is malformed.
* @throws TooManyTrafficPolicyInstancesException
* You've created the maximum number of traffic policy instances
* that can be created for the current AWS account. You can request
* an increase to the limit on the Contact Us
* page.
* @throws NoSuchTrafficPolicyException
* No traffic policy exists with the specified ID.
* @throws TrafficPolicyInstanceAlreadyExistsException
* Traffic policy instance with given Id already exists.
* @sample AmazonRoute53.CreateTrafficPolicyInstance
*/
CreateTrafficPolicyInstanceResult createTrafficPolicyInstance(
CreateTrafficPolicyInstanceRequest createTrafficPolicyInstanceRequest);
/**
*
* Creates a new version of an existing traffic policy. When you create a
* new version of a traffic policy, you specify the ID of the traffic policy
* that you want to update and a JSON-formatted document that describes the
* new version.
*
*
* You use traffic policies to create multiple DNS resource record sets for
* one domain name (such as example.com) or one subdomain name (such as
* www.example.com).
*
*
* To create a new version, send a POST request to the
* /Route 53 API version/trafficpolicy/ resource. The
* request body includes a document with a
* CreateTrafficPolicyVersionRequest element. The response
* returns the CreateTrafficPolicyVersionResponse element,
* which contains information about the new version of the traffic policy.
*
*
* @param createTrafficPolicyVersionRequest
* A complex type that contains information about the traffic policy
* for which you want to create a new version.
* @return Result of the CreateTrafficPolicyVersion operation returned by
* the service.
* @throws NoSuchTrafficPolicyException
* No traffic policy exists with the specified ID.
* @throws InvalidInputException
* Some value specified in the request is invalid or the XML
* document is malformed.
* @throws ConcurrentModificationException
* Another user submitted a request to update the object at the same
* time that you did. Retry the request.
* @throws InvalidTrafficPolicyDocumentException
* The format of the traffic policy document that you specified in
* the Document element is invalid.
* @sample AmazonRoute53.CreateTrafficPolicyVersion
*/
CreateTrafficPolicyVersionResult createTrafficPolicyVersion(
CreateTrafficPolicyVersionRequest createTrafficPolicyVersionRequest);
/**
*
* This action deletes a health check. To delete a health check, send a
* DELETE request to the
* /Route 53 API version/healthcheck/health check ID
* resource.
*
* You can delete a health check only if there are no resource
* record sets associated with this health check. If resource record sets
* are associated with this health check, you must disassociate them before
* you can delete your health check. If you try to delete a health check
* that is associated with resource record sets, Amazon Route 53 will deny
* your request with a HealthCheckInUse error. For information
* about disassociating the records from your health check, see
* ChangeResourceRecordSets.
*
* @param deleteHealthCheckRequest
* A complex type containing the request information for delete
* health check.
* @return Result of the DeleteHealthCheck operation returned by the
* service.
* @throws NoSuchHealthCheckException
* The health check you are trying to get or delete does not exist.
* @throws HealthCheckInUseException
* There are resource records associated with this health check.
* Before you can delete the health check, you must disassociate it
* from the resource record sets.
* @throws InvalidInputException
* Some value specified in the request is invalid or the XML
* document is malformed.
* @sample AmazonRoute53.DeleteHealthCheck
*/
DeleteHealthCheckResult deleteHealthCheck(
DeleteHealthCheckRequest deleteHealthCheckRequest);
/**
*
* This action deletes a hosted zone. To delete a hosted zone, send a
* DELETE request to the
* /Route 53 API version/hostedzone/hosted zone ID
* resource.
*
* You can delete a hosted zone only if there are no resource
* record sets other than the default SOA record and NS resource record
* sets. If your hosted zone contains other resource record sets, you must
* delete them before you can delete your hosted zone. If you try to delete
* a hosted zone that contains other resource record sets, Amazon Route 53
* will deny your request with a HostedZoneNotEmpty error. For
* information about deleting records from your hosted zone, see
* ChangeResourceRecordSets.
*
* @param deleteHostedZoneRequest
* A complex type that contains information about the hosted zone
* that you want to delete.
* @return Result of the DeleteHostedZone operation returned by the service.
* @throws NoSuchHostedZoneException
* @throws HostedZoneNotEmptyException
* The hosted zone contains resource record sets in addition to the
* default NS and SOA resource record sets. Before you can delete
* the hosted zone, you must delete the additional resource record
* sets.
* @throws PriorRequestNotCompleteException
* The request was rejected because Amazon Route 53 was still
* processing a prior request.
* @throws InvalidInputException
* Some value specified in the request is invalid or the XML
* document is malformed.
* @throws InvalidDomainNameException
* This error indicates that the specified domain name is not valid.
* @sample AmazonRoute53.DeleteHostedZone
*/
DeleteHostedZoneResult deleteHostedZone(
DeleteHostedZoneRequest deleteHostedZoneRequest);
/**
*
* This action deletes a reusable delegation set. To delete a reusable
* delegation set, send a DELETE request to the
* /Route 53 API version/delegationset/delegation set ID
* resource.
*
* You can delete a reusable delegation set only if there are no
* associated hosted zones. If your reusable delegation set contains
* associated hosted zones, you must delete them before you can delete your
* reusable delegation set. If you try to delete a reusable delegation set
* that contains associated hosted zones, Amazon Route 53 will deny your
* request with a DelegationSetInUse error.
*
* @param deleteReusableDelegationSetRequest
* A complex type containing the information for the delete request.
* @return Result of the DeleteReusableDelegationSet operation returned by
* the service.
* @throws NoSuchDelegationSetException
* The specified delegation set does not exist.
* @throws DelegationSetInUseException
* The specified delegation contains associated hosted zones which
* must be deleted before the reusable delegation set can be
* deleted.
* @throws DelegationSetNotReusableException
* The specified delegation set has not been marked as reusable.
* @throws InvalidInputException
* Some value specified in the request is invalid or the XML
* document is malformed.
* @sample AmazonRoute53.DeleteReusableDelegationSet
*/
DeleteReusableDelegationSetResult deleteReusableDelegationSet(
DeleteReusableDelegationSetRequest deleteReusableDelegationSetRequest);
/**
*
* Deletes a traffic policy. To delete a traffic policy, send a
* DELETE request to the
* /Route 53 API version/trafficpolicy resource.
*
*
* @param deleteTrafficPolicyRequest
* A request to delete a specified traffic policy version.
* @return Result of the DeleteTrafficPolicy operation returned by the
* service.
* @throws NoSuchTrafficPolicyException
* No traffic policy exists with the specified ID.
* @throws InvalidInputException
* Some value specified in the request is invalid or the XML
* document is malformed.
* @throws TrafficPolicyInUseException
* One or more traffic policy instances were created by using the
* specified traffic policy.
* @throws ConcurrentModificationException
* Another user submitted a request to update the object at the same
* time that you did. Retry the request.
* @sample AmazonRoute53.DeleteTrafficPolicy
*/
DeleteTrafficPolicyResult deleteTrafficPolicy(
DeleteTrafficPolicyRequest deleteTrafficPolicyRequest);
/**
*
* Deletes a traffic policy instance and all of the resource record sets
* that Amazon Route 53 created when you created the instance.
*
*
* To delete a traffic policy instance, send a DELETE request
* to the
* /Route 53 API version/trafficpolicy/traffic policy instance ID
* resource.
*
* When you delete a traffic policy instance, Amazon Route 53
* also deletes all of the resource record sets that were created when you
* created the traffic policy instance.
*
* @param deleteTrafficPolicyInstanceRequest
* A complex type that contains information about the traffic policy
* instance that you want to delete.
* @return Result of the DeleteTrafficPolicyInstance operation returned by
* the service.
* @throws NoSuchTrafficPolicyInstanceException
* No traffic policy instance exists with the specified ID.
* @throws InvalidInputException
* Some value specified in the request is invalid or the XML
* document is malformed.
* @throws PriorRequestNotCompleteException
* The request was rejected because Amazon Route 53 was still
* processing a prior request.
* @sample AmazonRoute53.DeleteTrafficPolicyInstance
*/
DeleteTrafficPolicyInstanceResult deleteTrafficPolicyInstance(
DeleteTrafficPolicyInstanceRequest deleteTrafficPolicyInstanceRequest);
/**
*
* This action disassociates a VPC from an hosted zone.
*
*
* To disassociate a VPC to a hosted zone, send a POST request
* to the
* /Route 53 API version/hostedzone/hosted zone ID/disassociatevpc
* resource. The request body must include a document with a
* DisassociateVPCFromHostedZoneRequest element. The response
* returns the DisassociateVPCFromHostedZoneResponse element
* that contains ChangeInfo for you to track the progress of
* the DisassociateVPCFromHostedZoneRequest you made. See
* GetChange operation for how to track the progress of your
* change.
*
*
* @param disassociateVPCFromHostedZoneRequest
* A complex type that contains information about the request to
* disassociate a VPC from an hosted zone.
* @return Result of the DisassociateVPCFromHostedZone operation returned by
* the service.
* @throws NoSuchHostedZoneException
* @throws InvalidVPCIdException
* The hosted zone you are trying to create for your VPC_ID does not
* belong to you. Amazon Route 53 returns this error when the VPC
* specified by VPCId does not belong to you.
* @throws VPCAssociationNotFoundException
* The VPC you specified is not currently associated with the hosted
* zone.
* @throws LastVPCAssociationException
* The VPC you are trying to disassociate from the hosted zone is
* the last the VPC that is associated with the hosted zone. Amazon
* Route 53 currently doesn't support disassociate the last VPC from
* the hosted zone.
* @throws InvalidInputException
* Some value specified in the request is invalid or the XML
* document is malformed.
* @sample AmazonRoute53.DisassociateVPCFromHostedZone
*/
DisassociateVPCFromHostedZoneResult disassociateVPCFromHostedZone(
DisassociateVPCFromHostedZoneRequest disassociateVPCFromHostedZoneRequest);
/**
*
* This action returns the current status of a change batch request. The
* status is one of the following values:
*
*
* - PENDING indicates that the changes in this request have
* not replicated to all Amazon Route 53 DNS servers. This is the initial
* status of all change batch requests.
*
*
* - INSYNC indicates that the changes have replicated to all
* Amazon Route 53 DNS servers.
*
*
* @param getChangeRequest
* The input for a GetChange request.
* @return Result of the GetChange operation returned by the service.
* @throws NoSuchChangeException
* @throws InvalidInputException
* Some value specified in the request is invalid or the XML
* document is malformed.
* @sample AmazonRoute53.GetChange
*/
GetChangeResult getChange(GetChangeRequest getChangeRequest);
/**
*
* This action returns the status and changes of a change batch request.
*
*
* @param getChangeDetailsRequest
* The input for a GetChangeDetails request.
* @return Result of the GetChangeDetails operation returned by the service.
* @throws NoSuchChangeException
* @throws InvalidInputException
* Some value specified in the request is invalid or the XML
* document is malformed.
* @sample AmazonRoute53.GetChangeDetails
*/
@Deprecated
GetChangeDetailsResult getChangeDetails(
GetChangeDetailsRequest getChangeDetailsRequest);
/**
*
* To retrieve a list of the IP ranges used by Amazon Route 53 health
* checkers to check the health of your resources, send a GET
* request to the /Route 53 API version/checkeripranges
* resource. You can use these IP addresses to configure router and firewall
* rules to allow health checkers to check the health of your resources.
*
*
* @param getCheckerIpRangesRequest
* Empty request.
* @return Result of the GetCheckerIpRanges operation returned by the
* service.
* @sample AmazonRoute53.GetCheckerIpRanges
*/
GetCheckerIpRangesResult getCheckerIpRanges(
GetCheckerIpRangesRequest getCheckerIpRangesRequest);
/**
* Simplified method form for invoking the GetCheckerIpRanges operation.
*
* @see #getCheckerIpRanges(GetCheckerIpRangesRequest)
*/
GetCheckerIpRangesResult getCheckerIpRanges();
/**
*
* To retrieve a single geo location, send a GET request to the
* /Route 53 API version/geolocation resource with one
* of these options: continentcode | countrycode | countrycode and
* subdivisioncode.
*
*
* @param getGeoLocationRequest
* A complex type that contains information about the request to get
* a geo location.
* @return Result of the GetGeoLocation operation returned by the service.
* @throws NoSuchGeoLocationException
* The geo location you are trying to get does not exist.
* @throws InvalidInputException
* Some value specified in the request is invalid or the XML
* document is malformed.
* @sample AmazonRoute53.GetGeoLocation
*/
GetGeoLocationResult getGeoLocation(
GetGeoLocationRequest getGeoLocationRequest);
/**
* Simplified method form for invoking the GetGeoLocation operation.
*
* @see #getGeoLocation(GetGeoLocationRequest)
*/
GetGeoLocationResult getGeoLocation();
/**
*
* To retrieve the health check, send a GET request to the
* /Route 53 API version/healthcheck/health check ID
* resource.
*
*
* @param getHealthCheckRequest
* A complex type that contains information about the request to get
* a health check.
* @return Result of the GetHealthCheck operation returned by the service.
* @throws NoSuchHealthCheckException
* The health check you are trying to get or delete does not exist.
* @throws InvalidInputException
* Some value specified in the request is invalid or the XML
* document is malformed.
* @throws IncompatibleVersionException
* The resource you are trying to access is unsupported on this
* Amazon Route 53 endpoint. Please consider using a newer endpoint
* or a tool that does so.
* @sample AmazonRoute53.GetHealthCheck
*/
GetHealthCheckResult getHealthCheck(
GetHealthCheckRequest getHealthCheckRequest);
/**
*
* To retrieve a count of all your health checks, send a GET
* request to the /Route 53 API version/healthcheckcount
* resource.
*
*
* @param getHealthCheckCountRequest
* To retrieve a count of all your health checks, send a
* GET request to the
* /Route 53 API version/healthcheckcount
* resource.
* @return Result of the GetHealthCheckCount operation returned by the
* service.
* @sample AmazonRoute53.GetHealthCheckCount
*/
GetHealthCheckCountResult getHealthCheckCount(
GetHealthCheckCountRequest getHealthCheckCountRequest);
/**
* Simplified method form for invoking the GetHealthCheckCount operation.
*
* @see #getHealthCheckCount(GetHealthCheckCountRequest)
*/
GetHealthCheckCountResult getHealthCheckCount();
/**
*
* If you want to learn why a health check is currently failing or why it
* failed most recently (if at all), you can get the failure reason for the
* most recent failure. Send a GET request to the
* /Route 53 API version/healthcheck/health check ID/lastfailurereason
* resource.
*
*
* @param getHealthCheckLastFailureReasonRequest
* A complex type that contains information about the request to get
* the most recent failure reason for a health check.
* @return Result of the GetHealthCheckLastFailureReason operation returned
* by the service.
* @throws NoSuchHealthCheckException
* The health check you are trying to get or delete does not exist.
* @throws InvalidInputException
* Some value specified in the request is invalid or the XML
* document is malformed.
* @sample AmazonRoute53.GetHealthCheckLastFailureReason
*/
GetHealthCheckLastFailureReasonResult getHealthCheckLastFailureReason(
GetHealthCheckLastFailureReasonRequest getHealthCheckLastFailureReasonRequest);
/**
*
* To retrieve the health check status, send a GET request to
* the
* /Route 53 API version/healthcheck/health check ID/status
* resource. You can use this call to get a health check's current status.
*
*
* @param getHealthCheckStatusRequest
* A complex type that contains information about the request to get
* health check status for a health check.
* @return Result of the GetHealthCheckStatus operation returned by the
* service.
* @throws NoSuchHealthCheckException
* The health check you are trying to get or delete does not exist.
* @throws InvalidInputException
* Some value specified in the request is invalid or the XML
* document is malformed.
* @sample AmazonRoute53.GetHealthCheckStatus
*/
GetHealthCheckStatusResult getHealthCheckStatus(
GetHealthCheckStatusRequest getHealthCheckStatusRequest);
/**
*
* To retrieve the delegation set for a hosted zone, send a GET
* request to the
* /Route 53 API version/hostedzone/hosted zone ID
* resource. The delegation set is the four Amazon Route 53 name servers
* that were assigned to the hosted zone when you created it.
*
*
* @param getHostedZoneRequest
* The input for a GetHostedZone request.
* @return Result of the GetHostedZone operation returned by the service.
* @throws NoSuchHostedZoneException
* @throws InvalidInputException
* Some value specified in the request is invalid or the XML
* document is malformed.
* @sample AmazonRoute53.GetHostedZone
*/
GetHostedZoneResult getHostedZone(GetHostedZoneRequest getHostedZoneRequest);
/**
*
* To retrieve a count of all your hosted zones, send a GET
* request to the /Route 53 API version/hostedzonecount
* resource.
*
*
* @param getHostedZoneCountRequest
* To retrieve a count of all your hosted zones, send a
* GET request to the
* /Route 53 API version/hostedzonecount
* resource.
* @return Result of the GetHostedZoneCount operation returned by the
* service.
* @throws InvalidInputException
* Some value specified in the request is invalid or the XML
* document is malformed.
* @sample AmazonRoute53.GetHostedZoneCount
*/
GetHostedZoneCountResult getHostedZoneCount(
GetHostedZoneCountRequest getHostedZoneCountRequest);
/**
* Simplified method form for invoking the GetHostedZoneCount operation.
*
* @see #getHostedZoneCount(GetHostedZoneCountRequest)
*/
GetHostedZoneCountResult getHostedZoneCount();
/**
*
* To retrieve the reusable delegation set, send a GET request
* to the
* /Route 53 API version/delegationset/delegation set ID
* resource.
*
*
* @param getReusableDelegationSetRequest
* The input for a GetReusableDelegationSet request.
* @return Result of the GetReusableDelegationSet operation returned by the
* service.
* @throws NoSuchDelegationSetException
* The specified delegation set does not exist.
* @throws DelegationSetNotReusableException
* The specified delegation set has not been marked as reusable.
* @throws InvalidInputException
* Some value specified in the request is invalid or the XML
* document is malformed.
* @sample AmazonRoute53.GetReusableDelegationSet
*/
GetReusableDelegationSetResult getReusableDelegationSet(
GetReusableDelegationSetRequest getReusableDelegationSetRequest);
/**
*
* Gets information about a specific traffic policy version. To get the
* information, send a GET request to the
* /Route 53 API version/trafficpolicy resource.
*
*
* @param getTrafficPolicyRequest
* Gets information about a specific traffic policy version. To get
* the information, send a GET request to the /Route 53 API
* version/trafficpolicy resource, and specify the ID and the
* version of the traffic policy.
* @return Result of the GetTrafficPolicy operation returned by the service.
* @throws NoSuchTrafficPolicyException
* No traffic policy exists with the specified ID.
* @throws InvalidInputException
* Some value specified in the request is invalid or the XML
* document is malformed.
* @sample AmazonRoute53.GetTrafficPolicy
*/
GetTrafficPolicyResult getTrafficPolicy(
GetTrafficPolicyRequest getTrafficPolicyRequest);
/**
*
* Gets information about a specified traffic policy instance.
*
*
* To get information about the traffic policy instance, send a
* GET request to the
* /Route 53 API version/trafficpolicyinstance resource.
*
* After you submit a CreateTrafficPolicyInstance or an
* UpdateTrafficPolicyInstance request, there's a brief delay
* while Amazon Route 53 creates the resource record sets that are specified
* in the traffic policy definition. For more information, see the
* State response element.
*
* @param getTrafficPolicyInstanceRequest
* Gets information about a specified traffic policy instance.
*
* To get information about a traffic policy instance, send a
* GET request to the
* /Route 53 API version/trafficpolicyinstance/Id
* resource.
* @return Result of the GetTrafficPolicyInstance operation returned by the
* service.
* @throws NoSuchTrafficPolicyInstanceException
* No traffic policy instance exists with the specified ID.
* @throws InvalidInputException
* Some value specified in the request is invalid or the XML
* document is malformed.
* @sample AmazonRoute53.GetTrafficPolicyInstance
*/
GetTrafficPolicyInstanceResult getTrafficPolicyInstance(
GetTrafficPolicyInstanceRequest getTrafficPolicyInstanceRequest);
/**
*
* Gets the number of traffic policy instances that are associated with the
* current AWS account.
*
*
* To get the number of traffic policy instances, send a GET
* request to the
* /Route 53 API version/trafficpolicyinstancecount
* resource.
*
*
* @param getTrafficPolicyInstanceCountRequest
* To retrieve a count of all your traffic policy instances, send a
* GET request to the
* /Route 53 API version/trafficpolicyinstancecount
* resource.
* @return Result of the GetTrafficPolicyInstanceCount operation returned by
* the service.
* @sample AmazonRoute53.GetTrafficPolicyInstanceCount
*/
GetTrafficPolicyInstanceCountResult getTrafficPolicyInstanceCount(
GetTrafficPolicyInstanceCountRequest getTrafficPolicyInstanceCountRequest);
/**
* Simplified method form for invoking the GetTrafficPolicyInstanceCount
* operation.
*
* @see #getTrafficPolicyInstanceCount(GetTrafficPolicyInstanceCountRequest)
*/
GetTrafficPolicyInstanceCountResult getTrafficPolicyInstanceCount();
/**
*
* This action gets the list of ChangeBatches in a given time period for a
* given hosted zone.
*
*
* @param listChangeBatchesByHostedZoneRequest
* The input for a ListChangeBatchesByHostedZone request.
* @return Result of the ListChangeBatchesByHostedZone operation returned by
* the service.
* @throws NoSuchHostedZoneException
* @throws InvalidInputException
* Some value specified in the request is invalid or the XML
* document is malformed.
* @sample AmazonRoute53.ListChangeBatchesByHostedZone
*/
@Deprecated
ListChangeBatchesByHostedZoneResult listChangeBatchesByHostedZone(
ListChangeBatchesByHostedZoneRequest listChangeBatchesByHostedZoneRequest);
/**
*
* This action gets the list of ChangeBatches in a given time period for a
* given hosted zone and RRSet.
*
*
* @param listChangeBatchesByRRSetRequest
* The input for a ListChangeBatchesByRRSet request.
* @return Result of the ListChangeBatchesByRRSet operation returned by the
* service.
* @throws NoSuchHostedZoneException
* @throws InvalidInputException
* Some value specified in the request is invalid or the XML
* document is malformed.
* @sample AmazonRoute53.ListChangeBatchesByRRSet
*/
@Deprecated
ListChangeBatchesByRRSetResult listChangeBatchesByRRSet(
ListChangeBatchesByRRSetRequest listChangeBatchesByRRSetRequest);
/**
*
* To retrieve a list of supported geo locations, send a GET
* request to the /Route 53 API version/geolocations
* resource. The response to this request includes a
* GeoLocationDetailsList element with zero, one, or multiple
* GeoLocationDetails child elements. The list is sorted by
* country code, and then subdivision code, followed by continents at the
* end of the list.
*
*
* By default, the list of geo locations is displayed on a single page. You
* can control the length of the page that is displayed by using the
* MaxItems parameter. If the list is truncated,
* IsTruncated will be set to true and a combination of
* NextContinentCode, NextCountryCode, NextSubdivisionCode will
* be populated. You can pass these as parameters to
* StartContinentCode, StartCountryCode, StartSubdivisionCode
* to control the geo location that the list begins with.
*
*
* @param listGeoLocationsRequest
* The input for a ListGeoLocations request.
* @return Result of the ListGeoLocations operation returned by the service.
* @throws InvalidInputException
* Some value specified in the request is invalid or the XML
* document is malformed.
* @sample AmazonRoute53.ListGeoLocations
*/
ListGeoLocationsResult listGeoLocations(
ListGeoLocationsRequest listGeoLocationsRequest);
/**
* Simplified method form for invoking the ListGeoLocations operation.
*
* @see #listGeoLocations(ListGeoLocationsRequest)
*/
ListGeoLocationsResult listGeoLocations();
/**
*
* To retrieve a list of your health checks, send a GET request
* to the /Route 53 API version/healthcheck resource.
* The response to this request includes a HealthChecks element
* with zero, one, or multiple HealthCheck child elements. By
* default, the list of health checks is displayed on a single page. You can
* control the length of the page that is displayed by using the
* MaxItems parameter. You can use the Marker
* parameter to control the health check that the list begins with.
*
* Amazon Route 53 returns a maximum of 100 items. If you set
* MaxItems to a value greater than 100, Amazon Route 53 returns only the
* first 100.
*
* @param listHealthChecksRequest
* To retrieve a list of your health checks, send a GET
* request to the
* /Route 53 API version/healthcheck resource.
* The response to this request includes a HealthChecks
* element with zero or more HealthCheck child elements.
* By default, the list of health checks is displayed on a single
* page. You can control the length of the page that is displayed by
* using the MaxItems parameter. You can use the
* Marker parameter to control the health check that the
* list begins with. Amazon Route 53 returns a maximum of
* 100 items. If you set MaxItems to a value greater
* than 100, Amazon Route 53 returns only the first 100.
* @return Result of the ListHealthChecks operation returned by the service.
* @throws InvalidInputException
* Some value specified in the request is invalid or the XML
* document is malformed.
* @throws IncompatibleVersionException
* The resource you are trying to access is unsupported on this
* Amazon Route 53 endpoint. Please consider using a newer endpoint
* or a tool that does so.
* @sample AmazonRoute53.ListHealthChecks
*/
ListHealthChecksResult listHealthChecks(
ListHealthChecksRequest listHealthChecksRequest);
/**
* Simplified method form for invoking the ListHealthChecks operation.
*
* @see #listHealthChecks(ListHealthChecksRequest)
*/
ListHealthChecksResult listHealthChecks();
/**
*
* To retrieve a list of your hosted zones, send a GET request
* to the /Route 53 API version/hostedzone resource. The
* response to this request includes a HostedZones element with
* zero, one, or multiple HostedZone child elements. By
* default, the list of hosted zones is displayed on a single page. You can
* control the length of the page that is displayed by using the
* MaxItems parameter. You can use the Marker
* parameter to control the hosted zone that the list begins with.
*
* Amazon Route 53 returns a maximum of 100 items. If you set
* MaxItems to a value greater than 100, Amazon Route 53 returns only the
* first 100.
*
* @param listHostedZonesRequest
* To retrieve a list of your hosted zones, send a GET
* request to the
* /Route 53 API version/hostedzone resource. The
* response to this request includes a HostedZones
* element with zero or more HostedZone child elements.
* By default, the list of hosted zones is displayed on a single
* page. You can control the length of the page that is displayed by
* using the MaxItems parameter. You can use the
* Marker parameter to control the hosted zone that the
* list begins with. 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.
* @return Result of the ListHostedZones operation returned by the service.
* @throws InvalidInputException
* Some value specified in the request is invalid or the XML
* document is malformed.
* @throws NoSuchDelegationSetException
* The specified delegation set does not exist.
* @throws DelegationSetNotReusableException
* The specified delegation set has not been marked as reusable.
* @sample AmazonRoute53.ListHostedZones
*/
ListHostedZonesResult listHostedZones(
ListHostedZonesRequest listHostedZonesRequest);
/**
* Simplified method form for invoking the ListHostedZones operation.
*
* @see #listHostedZones(ListHostedZonesRequest)
*/
ListHostedZonesResult listHostedZones();
/**
*
* To retrieve a list of your hosted zones in lexicographic order, send a
* GET request to the
* /Route 53 API version/hostedzonesbyname resource. The
* response to this request includes a HostedZones element with
* zero or more HostedZone child elements lexicographically
* ordered by DNS name. By default, the list of hosted zones is displayed on
* a single page. You can control the length of the page that is displayed
* by using the MaxItems parameter. You can use the
* DNSName and HostedZoneId parameters to control
* the hosted zone that the list begins with.
*
* Amazon Route 53 returns a maximum of 100 items. If you set
* MaxItems to a value greater than 100, Amazon Route 53 returns only the
* first 100.
*
* @param listHostedZonesByNameRequest
* To retrieve a list of your hosted zones in lexicographic order,
* send a GET request to the
* /Route 53 API version/hostedzonesbyname
* resource. The response to this request includes a
* HostedZones element with zero or more
* HostedZone child elements lexicographically ordered
* by DNS name. By default, the list of hosted zones is displayed on
* a single page. You can control the length of the page that is
* displayed by using the MaxItems parameter. You can
* use the DNSName and HostedZoneId
* parameters to control the hosted zone that the list begins with.
* @return Result of the ListHostedZonesByName operation returned by the
* service.
* @throws InvalidInputException
* Some value specified in the request is invalid or the XML
* document is malformed.
* @throws InvalidDomainNameException
* This error indicates that the specified domain name is not valid.
* @sample AmazonRoute53.ListHostedZonesByName
*/
ListHostedZonesByNameResult listHostedZonesByName(
ListHostedZonesByNameRequest listHostedZonesByNameRequest);
/**
* Simplified method form for invoking the ListHostedZonesByName operation.
*
* @see #listHostedZonesByName(ListHostedZonesByNameRequest)
*/
ListHostedZonesByNameResult listHostedZonesByName();
/**
*
* List the resource record sets in a specified hosted zone. Send a GET
* request to the
* 2013-04-01/hostedzone/hosted zone ID/rrset resource.
*
*
* ListResourceRecordSets returns up to 100 resource record
* sets at a time in ASCII order, beginning at a position specified by the
* name and type elements. The action sorts results first by DNS name with
* the labels reversed, for example:
*
*
* com.example.www.
*
*
* Note the trailing dot, which can change the sort order in some
* circumstances. When multiple records have the same DNS name, the action
* sorts results by the record type.
*
*
* You can use the name and type elements to adjust the beginning position
* of the list of resource record sets returned:
*
*
* - If you do not specify
Name or Type:
* The results begin with the first resource record set that the hosted zone
* contains.
* - If you specify
Name but not Type:
* The results begin with the first resource record set in the list whose
* name is greater than or equal to Name.
* - If you specify
Type but not Name:
* Amazon Route 53 returns the InvalidInput error.
* - If you specify both
Name and Type:
* The results begin with the first resource record set in the list whose
* name is greater than or equal to Name, and whose type is
* greater than or equal to Type.
*
*
* This action returns the most current version of the records. This
* includes records that are PENDING, and that are not yet
* available on all Amazon Route 53 DNS servers.
*
*
* To ensure that you get an accurate listing of the resource record sets
* for a hosted zone at a point in time, do not submit a
* ChangeResourceRecordSets request while you are paging
* through the results of a ListResourceRecordSets request. If
* you do, some pages may display results without the latest changes while
* other pages display results with the latest changes.
*
*
* @param listResourceRecordSetsRequest
* The input for a ListResourceRecordSets request.
* @return Result of the ListResourceRecordSets operation returned by the
* service.
* @throws NoSuchHostedZoneException
* @throws InvalidInputException
* Some value specified in the request is invalid or the XML
* document is malformed.
* @sample AmazonRoute53.ListResourceRecordSets
*/
ListResourceRecordSetsResult listResourceRecordSets(
ListResourceRecordSetsRequest listResourceRecordSetsRequest);
/**
*
* To retrieve a list of your reusable delegation sets, send a
* GET request to the
* /Route 53 API version/delegationset resource. The
* response to this request includes a DelegationSets element
* with zero, one, or multiple DelegationSet child elements. By
* default, the list of delegation sets is displayed on a single page. You
* can control the length of the page that is displayed by using the
* MaxItems parameter. You can use the Marker
* parameter to control the delegation set that the list begins with.
*
* Amazon Route 53 returns a maximum of 100 items. If you set
* MaxItems to a value greater than 100, Amazon Route 53 returns only the
* first 100.
*
* @param listReusableDelegationSetsRequest
* To retrieve a list of your reusable delegation sets, send a
* GET request to the
* /Route 53 API version/delegationset resource.
* The response to this request includes a
* DelegationSets element with zero or more
* DelegationSet child elements. By default, the list of
* reusable delegation sets is displayed on a single page. You can
* control the length of the page that is displayed by using the
* MaxItems parameter. You can use the
* Marker parameter to control the delegation set that
* the list begins with. Amazon Route 53 returns a maximum
* of 100 items. If you set MaxItems to a value greater
* than 100, Amazon Route 53 returns only the first 100.
* @return Result of the ListReusableDelegationSets operation returned by
* the service.
* @throws InvalidInputException
* Some value specified in the request is invalid or the XML
* document is malformed.
* @sample AmazonRoute53.ListReusableDelegationSets
*/
ListReusableDelegationSetsResult listReusableDelegationSets(
ListReusableDelegationSetsRequest listReusableDelegationSetsRequest);
/**
* Simplified method form for invoking the ListReusableDelegationSets
* operation.
*
* @see #listReusableDelegationSets(ListReusableDelegationSetsRequest)
*/
ListReusableDelegationSetsResult listReusableDelegationSets();
/**
* @param listTagsForResourceRequest
* A complex type containing information about a request for a list
* of the tags that are associated with an individual resource.
* @return Result of the ListTagsForResource operation returned by the
* service.
* @throws InvalidInputException
* Some value specified in the request is invalid or the XML
* document is malformed.
* @throws NoSuchHealthCheckException
* The health check you are trying to get or delete does not exist.
* @throws NoSuchHostedZoneException
* @throws PriorRequestNotCompleteException
* The request was rejected because Amazon Route 53 was still
* processing a prior request.
* @throws ThrottlingException
* @sample AmazonRoute53.ListTagsForResource
*/
ListTagsForResourceResult listTagsForResource(
ListTagsForResourceRequest listTagsForResourceRequest);
/**
* @param listTagsForResourcesRequest
* A complex type containing information about a request for a list
* of the tags that are associated with up to 10 specified resources.
* @return Result of the ListTagsForResources operation returned by the
* service.
* @throws InvalidInputException
* Some value specified in the request is invalid or the XML
* document is malformed.
* @throws NoSuchHealthCheckException
* The health check you are trying to get or delete does not exist.
* @throws NoSuchHostedZoneException
* @throws PriorRequestNotCompleteException
* The request was rejected because Amazon Route 53 was still
* processing a prior request.
* @throws ThrottlingException
* @sample AmazonRoute53.ListTagsForResources
*/
ListTagsForResourcesResult listTagsForResources(
ListTagsForResourcesRequest listTagsForResourcesRequest);
/**
*
* Gets information about the latest version for every traffic policy that
* is associated with the current AWS account. To get the information, send
* a GET request to the
* /Route 53 API version/trafficpolicy resource.
*
*
* Amazon Route 53 returns a maximum of 100 items in each response. If you
* have a lot of traffic policies, you can use the maxitems
* parameter to list them in groups of up to 100.
*
*
* The response includes three values that help you navigate from one group
* of maxitems traffic policies to the next:
*
*
* - IsTruncated
*
* If the value of IsTruncated in the response is
* true, there are more traffic policies associated with the
* current AWS account.
*
*
* If IsTruncated is false, this response includes
* the last traffic policy that is associated with the current account.
*
* - TrafficPolicyIdMarker
*
* If IsTruncated is true,
* TrafficPolicyIdMarker is the ID of the first traffic policy
* in the next group of MaxItems traffic policies. If you want
* to list more traffic policies, make another call to
* ListTrafficPolicies, and specify the value of the
* TrafficPolicyIdMarker element from the response in the
* TrafficPolicyIdMarker request parameter.
*
*
* If IsTruncated is false, the
* TrafficPolicyIdMarker element is omitted from the response.
*
* - MaxItems
*
* The value that you specified for the MaxItems parameter in
* the request that produced the current response.
*
*
*
* @param listTrafficPoliciesRequest
* A complex type that contains the information about the request to
* list the traffic policies that are associated with the current AWS
* account.
* @return Result of the ListTrafficPolicies operation returned by the
* service.
* @throws InvalidInputException
* Some value specified in the request is invalid or the XML
* document is malformed.
* @sample AmazonRoute53.ListTrafficPolicies
*/
ListTrafficPoliciesResult listTrafficPolicies(
ListTrafficPoliciesRequest listTrafficPoliciesRequest);
/**
* Simplified method form for invoking the ListTrafficPolicies operation.
*
* @see #listTrafficPolicies(ListTrafficPoliciesRequest)
*/
ListTrafficPoliciesResult listTrafficPolicies();
/**
*
* Gets information about the traffic policy instances that you created by
* using the current AWS account.
*
* After you submit an UpdateTrafficPolicyInstance
* request, there's a brief delay while Amazon Route 53 creates the resource
* record sets that are specified in the traffic policy definition. For more
* information, see the State response element.
*
* To get information about the traffic policy instances that are associated
* with the current AWS account, send a GET request to the
* /Route 53 API version/trafficpolicyinstance resource.
*
*
* Amazon Route 53 returns a maximum of 100 items in each response. If you
* have a lot of traffic policy instances, you can use the
* MaxItems parameter to list them in groups of up to 100.
*
*
* The response includes five values that help you navigate from one group
* of MaxItems traffic policy instances to the next:
*
*
* - IsTruncated
*
* If the value of IsTruncated in the response is
* true, there are more traffic policy instances associated
* with the current AWS account.
*
*
* If IsTruncated is false, this response includes
* the last traffic policy instance that is associated with the current
* account.
*
* - MaxItems
*
* The value that you specified for the MaxItems parameter in
* the request that produced the current response.
*
* - HostedZoneIdMarker, TrafficPolicyInstanceNameMarker,
* and TrafficPolicyInstanceTypeMarker
*
* If IsTruncated is true, these three values in
* the response represent the first traffic policy instance in the next
* group of MaxItems traffic policy instances. To list more
* traffic policy instances, make another call to
* ListTrafficPolicyInstances, and specify these values in the
* corresponding request parameters.
*
*
* If IsTruncated is false, all three elements are
* omitted from the response.
*
*
*
* @param listTrafficPolicyInstancesRequest
* A complex type that contains the information about the request to
* list your traffic policy instances.
* @return Result of the ListTrafficPolicyInstances operation returned by
* the service.
* @throws InvalidInputException
* Some value specified in the request is invalid or the XML
* document is malformed.
* @throws NoSuchTrafficPolicyInstanceException
* No traffic policy instance exists with the specified ID.
* @sample AmazonRoute53.ListTrafficPolicyInstances
*/
ListTrafficPolicyInstancesResult listTrafficPolicyInstances(
ListTrafficPolicyInstancesRequest listTrafficPolicyInstancesRequest);
/**
* Simplified method form for invoking the ListTrafficPolicyInstances
* operation.
*
* @see #listTrafficPolicyInstances(ListTrafficPolicyInstancesRequest)
*/
ListTrafficPolicyInstancesResult listTrafficPolicyInstances();
/**
*
* Gets information about the traffic policy instances that you created in a
* specified hosted zone.
*
* After you submit an UpdateTrafficPolicyInstance
* request, there's a brief delay while Amazon Route 53 creates the resource
* record sets that are specified in the traffic policy definition. For more
* information, see the State response element.
*
* To get information about the traffic policy instances that you created in
* a specified hosted zone, send a GET request to the
* /Route 53 API version/trafficpolicyinstance resource
* and include the ID of the hosted zone.
*
*
* Amazon Route 53 returns a maximum of 100 items in each response. If you
* have a lot of traffic policy instances, you can use the
* MaxItems parameter to list them in groups of up to 100.
*
*
* The response includes four values that help you navigate from one group
* of MaxItems traffic policy instances to the next:
*
*
* - IsTruncated
*
* If the value of true,
* there are more traffic policy instances associated with the current AWS
* account.
*
*
* If IsTruncated is false, this response includes
* the last traffic policy instance that is associated with the current
* account.
*
* - MaxItems
*
* The value that you specified for the MaxItems parameter in
* the request that produced the current response.
*
* - TrafficPolicyInstanceNameMarker and
* TrafficPolicyInstanceTypeMarker
*
* If IsTruncated is true, these two values in the
* response represent the first traffic policy instance in the next group of
* MaxItems traffic policy instances. To list more traffic
* policy instances, make another call to
* ListTrafficPolicyInstancesByHostedZone, and specify these
* values in the corresponding request parameters.
*
*
* If IsTruncated is false, all three elements are
* omitted from the response.
*
*
*
* @param listTrafficPolicyInstancesByHostedZoneRequest
* A request for the traffic policy instances that you created in a
* specified hosted zone.
* @return Result of the ListTrafficPolicyInstancesByHostedZone operation
* returned by the service.
* @throws InvalidInputException
* Some value specified in the request is invalid or the XML
* document is malformed.
* @throws NoSuchTrafficPolicyInstanceException
* No traffic policy instance exists with the specified ID.
* @throws NoSuchHostedZoneException
* @sample AmazonRoute53.ListTrafficPolicyInstancesByHostedZone
*/
ListTrafficPolicyInstancesByHostedZoneResult listTrafficPolicyInstancesByHostedZone(
ListTrafficPolicyInstancesByHostedZoneRequest listTrafficPolicyInstancesByHostedZoneRequest);
/**
*
* Gets information about the traffic policy instances that you created by
* using a specify traffic policy version.
*
* After you submit a CreateTrafficPolicyInstance or an
* UpdateTrafficPolicyInstance request, there's a brief delay
* while Amazon Route 53 creates the resource record sets that are specified
* in the traffic policy definition. For more information, see the
* State response element.
*
* To get information about the traffic policy instances that you created by
* using a specify traffic policy version, send a GET request
* to the /Route 53 API version/trafficpolicyinstance
* resource and include the ID and version of the traffic policy.
*
*
* Amazon Route 53 returns a maximum of 100 items in each response. If you
* have a lot of traffic policy instances, you can use the
* MaxItems parameter to list them in groups of up to 100.
*
*
* The response includes five values that help you navigate from one group
* of MaxItems traffic policy instances to the next:
*
*
* - IsTruncated
*
* If the value of IsTruncated in the response is
* true, there are more traffic policy instances associated
* with the specified traffic policy.
*
*
* If IsTruncated is false, this response includes
* the last traffic policy instance that is associated with the specified
* traffic policy.
*
*
* - MaxItems
*
* The value that you specified for the MaxItems parameter in
* the request that produced the current response.
*
*
* - HostedZoneIdMarker, TrafficPolicyInstanceNameMarker,
* and TrafficPolicyInstanceTypeMarker
*
* If IsTruncated is true, these values in the
* response represent the first traffic policy instance in the next group of
* MaxItems traffic policy instances. To list more traffic
* policy instances, make another call to
* ListTrafficPolicyInstancesByPolicy, and specify these values
* in the corresponding request parameters.
*
*
* If IsTruncated is false, all three elements are
* omitted from the response.
*
*
*
*
* @param listTrafficPolicyInstancesByPolicyRequest
* A complex type that contains the information about the request to
* list your traffic policy instances.
* @return Result of the ListTrafficPolicyInstancesByPolicy operation
* returned by the service.
* @throws InvalidInputException
* Some value specified in the request is invalid or the XML
* document is malformed.
* @throws NoSuchTrafficPolicyInstanceException
* No traffic policy instance exists with the specified ID.
* @throws NoSuchTrafficPolicyException
* No traffic policy exists with the specified ID.
* @sample AmazonRoute53.ListTrafficPolicyInstancesByPolicy
*/
ListTrafficPolicyInstancesByPolicyResult listTrafficPolicyInstancesByPolicy(
ListTrafficPolicyInstancesByPolicyRequest listTrafficPolicyInstancesByPolicyRequest);
/**
*
* Gets information about all of the versions for a specified traffic
* policy. ListTrafficPolicyVersions lists only versions that
* have not been deleted.
*
*
* Amazon Route 53 returns a maximum of 100 items in each response. If you
* have a lot of traffic policies, you can use the maxitems
* parameter to list them in groups of up to 100.
*
*
* The response includes three values that help you navigate from one group
* of maxitemsmaxitems traffic policies to the next:
*
*
* - IsTruncated
*
* If the value of IsTruncated in the response is
* true, there are more traffic policy versions associated with
* the specified traffic policy.
*
*
* If IsTruncated is false, this response includes
* the last traffic policy version that is associated with the specified
* traffic policy.
*
* - TrafficPolicyVersionMarker
*
* The ID of the next traffic policy version that is associated with the
* current AWS account. If you want to list more traffic policies, make
* another call to ListTrafficPolicyVersions, and specify the
* value of the TrafficPolicyVersionMarker element in the
* TrafficPolicyVersionMarker request parameter.
*
*
* If IsTruncated is false, Amazon Route 53 omits
* the TrafficPolicyVersionMarker element from the response.
*
* - MaxItems
*
* The value that you specified for the MaxItems parameter in
* the request that produced the current response.
*
*
*
* @param listTrafficPolicyVersionsRequest
* A complex type that contains the information about the request to
* list your traffic policies.
* @return Result of the ListTrafficPolicyVersions operation returned by the
* service.
* @throws InvalidInputException
* Some value specified in the request is invalid or the XML
* document is malformed.
* @throws NoSuchTrafficPolicyException
* No traffic policy exists with the specified ID.
* @sample AmazonRoute53.ListTrafficPolicyVersions
*/
ListTrafficPolicyVersionsResult listTrafficPolicyVersions(
ListTrafficPolicyVersionsRequest listTrafficPolicyVersionsRequest);
/**
*
* This action updates an existing health check.
*
*
* To update a health check, send a POST request to the
* /Route 53 API version/healthcheck/health check ID
* resource. The request body must include a document with an
* UpdateHealthCheckRequest element. The response returns an
* UpdateHealthCheckResponse element, which contains metadata
* about the health check.
*
*
* @param updateHealthCheckRequest
* >A complex type that contains information about the request to
* update a health check.
* @return Result of the UpdateHealthCheck operation returned by the
* service.
* @throws NoSuchHealthCheckException
* The health check you are trying to get or delete does not exist.
* @throws InvalidInputException
* Some value specified in the request is invalid or the XML
* document is malformed.
* @throws HealthCheckVersionMismatchException
* @sample AmazonRoute53.UpdateHealthCheck
*/
UpdateHealthCheckResult updateHealthCheck(
UpdateHealthCheckRequest updateHealthCheckRequest);
/**
*
* To update the hosted zone comment, send a POST request to
* the
* /Route 53 API version/hostedzone/hosted zone ID
* resource. The request body must include a document with a
* UpdateHostedZoneCommentRequest element. The response to this
* request includes the modified HostedZone element.
*
* The comment can have a maximum length of 256 characters.
*
* @param updateHostedZoneCommentRequest
* A complex type that contains information about the request to
* update a hosted zone comment.
* @return Result of the UpdateHostedZoneComment operation returned by the
* service.
* @throws NoSuchHostedZoneException
* @throws InvalidInputException
* Some value specified in the request is invalid or the XML
* document is malformed.
* @sample AmazonRoute53.UpdateHostedZoneComment
*/
UpdateHostedZoneCommentResult updateHostedZoneComment(
UpdateHostedZoneCommentRequest updateHostedZoneCommentRequest);
/**
*
* Updates the comment for a specified traffic policy version.
*
*
* To update the comment, send a POST request to the
* /Route 53 API version/trafficpolicy/ resource.
*
*
* The request body must include a document with an
* UpdateTrafficPolicyCommentRequest element.
*
*
* @param updateTrafficPolicyCommentRequest
* A complex type that contains information about the traffic policy
* for which you want to update the comment.
* @return Result of the UpdateTrafficPolicyComment operation returned by
* the service.
* @throws InvalidInputException
* Some value specified in the request is invalid or the XML
* document is malformed.
* @throws NoSuchTrafficPolicyException
* No traffic policy exists with the specified ID.
* @throws ConcurrentModificationException
* Another user submitted a request to update the object at the same
* time that you did. Retry the request.
* @sample AmazonRoute53.UpdateTrafficPolicyComment
*/
UpdateTrafficPolicyCommentResult updateTrafficPolicyComment(
UpdateTrafficPolicyCommentRequest updateTrafficPolicyCommentRequest);
/**
*
* Updates the resource record sets in a specified hosted zone that were
* created based on the settings in a specified traffic policy version.
*
* The DNS type of the resource record sets that you're updating
* must match the DNS type in the JSON document that is associated with the
* traffic policy version that you're using to update the traffic policy
* instance.
*
* When you update a traffic policy instance, Amazon Route 53 continues to
* respond to DNS queries for the root resource record set name (such as
* example.com) while it replaces one group of resource record sets with
* another. Amazon Route 53 performs the following operations:
*
*
* - Amazon Route 53 creates a new group of resource record sets based on
* the specified traffic policy. This is true regardless of how substantial
* the differences are between the existing resource record sets and the new
* resource record sets.
* - When all of the new resource record sets have been created, Amazon
* Route 53 starts to respond to DNS queries for the root resource record
* set name (such as example.com) by using the new resource record sets.
* - Amazon Route 53 deletes the old group of resource record sets that
* are associated with the root resource record set name.
*
*
* To update a traffic policy instance, send a POST request to
* the
* /Route 53 API version/trafficpolicyinstance/traffic policy ID
* resource. The request body must include a document with an
* UpdateTrafficPolicyInstanceRequest element.
*
*
* @param updateTrafficPolicyInstanceRequest
* A complex type that contains information about the resource record
* sets that you want to update based on a specified traffic policy
* instance.
* @return Result of the UpdateTrafficPolicyInstance operation returned by
* the service.
* @throws InvalidInputException
* Some value specified in the request is invalid or the XML
* document is malformed.
* @throws NoSuchTrafficPolicyException
* No traffic policy exists with the specified ID.
* @throws NoSuchTrafficPolicyInstanceException
* No traffic policy instance exists with the specified ID.
* @throws PriorRequestNotCompleteException
* The request was rejected because Amazon Route 53 was still
* processing a prior request.
* @throws ConflictingTypesException
* You tried to update a traffic policy instance by using a traffic
* policy version that has a different DNS type than the current
* type for the instance. You specified the type in the JSON
* document in the CreateTrafficPolicy or
* CreateTrafficPolicyVersionrequest.
* @sample AmazonRoute53.UpdateTrafficPolicyInstance
*/
UpdateTrafficPolicyInstanceResult updateTrafficPolicyInstance(
UpdateTrafficPolicyInstanceRequest updateTrafficPolicyInstanceRequest);
/**
* 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.
*/
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.
*
* @param request
* The originally executed request.
*
* @return The response metadata for the specified request, or null if none
* is available.
*/
ResponseMetadata getCachedResponseMetadata(AmazonWebServiceRequest request);
}