public class AbstractAmazonRoute53 extends Object implements AmazonRoute53
AmazonRoute53
. Convenient method forms
pass through to the corresponding overload that takes a request object, which
throws an UnsupportedOperationException
.ENDPOINT_PREFIX
Modifier and Type | Method and Description |
---|---|
AssociateVPCWithHostedZoneResult |
associateVPCWithHostedZone(AssociateVPCWithHostedZoneRequest request)
This action associates a VPC with an hosted zone.
|
ChangeResourceRecordSetsResult |
changeResourceRecordSets(ChangeResourceRecordSetsRequest request)
Use this action to create or change your authoritative DNS information.
|
ChangeTagsForResourceResult |
changeTagsForResource(ChangeTagsForResourceRequest request) |
CreateHealthCheckResult |
createHealthCheck(CreateHealthCheckRequest request)
This action creates a new health check.
|
CreateHostedZoneResult |
createHostedZone(CreateHostedZoneRequest request)
This action creates a new hosted zone.
|
CreateReusableDelegationSetResult |
createReusableDelegationSet(CreateReusableDelegationSetRequest request)
This action creates a reusable delegationSet.
|
CreateTrafficPolicyResult |
createTrafficPolicy(CreateTrafficPolicyRequest request)
Creates a traffic policy, which you use to create multiple DNS resource
record sets for one domain name (such as example.com) or one subdomain
name (such as www.example.com).
|
CreateTrafficPolicyInstanceResult |
createTrafficPolicyInstance(CreateTrafficPolicyInstanceRequest request)
Creates resource record sets in a specified hosted zone based on the
settings in a specified traffic policy version.
|
CreateTrafficPolicyVersionResult |
createTrafficPolicyVersion(CreateTrafficPolicyVersionRequest request)
Creates a new version of an existing traffic policy.
|
DeleteHealthCheckResult |
deleteHealthCheck(DeleteHealthCheckRequest request)
This action deletes a health check.
|
DeleteHostedZoneResult |
deleteHostedZone(DeleteHostedZoneRequest request)
This action deletes a hosted zone.
|
DeleteReusableDelegationSetResult |
deleteReusableDelegationSet(DeleteReusableDelegationSetRequest request)
This action deletes a reusable delegation set.
|
DeleteTrafficPolicyResult |
deleteTrafficPolicy(DeleteTrafficPolicyRequest request)
Deletes a traffic policy.
|
DeleteTrafficPolicyInstanceResult |
deleteTrafficPolicyInstance(DeleteTrafficPolicyInstanceRequest request)
Deletes a traffic policy instance and all of the resource record sets
that Amazon Route 53 created when you created the instance.
|
DisassociateVPCFromHostedZoneResult |
disassociateVPCFromHostedZone(DisassociateVPCFromHostedZoneRequest request)
This action disassociates a VPC from an hosted zone.
|
ResponseMetadata |
getCachedResponseMetadata(AmazonWebServiceRequest request)
Returns additional metadata for a previously executed successful request,
typically used for debugging issues where a service isn't acting as
expected.
|
GetChangeResult |
getChange(GetChangeRequest request)
This action returns the current status of a change batch request.
|
GetChangeDetailsResult |
getChangeDetails(GetChangeDetailsRequest request)
Deprecated.
|
GetCheckerIpRangesResult |
getCheckerIpRanges()
Simplified method form for invoking the GetCheckerIpRanges operation.
|
GetCheckerIpRangesResult |
getCheckerIpRanges(GetCheckerIpRangesRequest request)
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. |
GetGeoLocationResult |
getGeoLocation()
Simplified method form for invoking the GetGeoLocation operation.
|
GetGeoLocationResult |
getGeoLocation(GetGeoLocationRequest request)
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. |
GetHealthCheckResult |
getHealthCheck(GetHealthCheckRequest request)
To retrieve the health check, send a
GET request to the
/Route 53 API version/healthcheck/health check ID
resource. |
GetHealthCheckCountResult |
getHealthCheckCount()
Simplified method form for invoking the GetHealthCheckCount operation.
|
GetHealthCheckCountResult |
getHealthCheckCount(GetHealthCheckCountRequest request)
To retrieve a count of all your health checks, send a
GET
request to the /Route 53 API version/healthcheckcount
resource. |
GetHealthCheckLastFailureReasonResult |
getHealthCheckLastFailureReason(GetHealthCheckLastFailureReasonRequest request)
If you want to learn why a health check is currently failing or why it
failed most recently (if at all), you can get the failure reason for the
most recent failure.
|
GetHealthCheckStatusResult |
getHealthCheckStatus(GetHealthCheckStatusRequest request)
To retrieve the health check status, send a
GET request to
the
/Route 53 API version/healthcheck/health check ID/status
resource. |
GetHostedZoneResult |
getHostedZone(GetHostedZoneRequest request)
To retrieve the delegation set for a hosted zone, send a
GET
request to the
/Route 53 API version/hostedzone/hosted zone ID
resource. |
GetHostedZoneCountResult |
getHostedZoneCount()
Simplified method form for invoking the GetHostedZoneCount operation.
|
GetHostedZoneCountResult |
getHostedZoneCount(GetHostedZoneCountRequest request)
To retrieve a count of all your hosted zones, send a
GET
request to the /Route 53 API version/hostedzonecount
resource. |
GetReusableDelegationSetResult |
getReusableDelegationSet(GetReusableDelegationSetRequest request)
To retrieve the reusable delegation set, send a
GET request
to the
/Route 53 API version/delegationset/delegation set ID
resource. |
GetTrafficPolicyResult |
getTrafficPolicy(GetTrafficPolicyRequest request)
Gets information about a specific traffic policy version.
|
GetTrafficPolicyInstanceResult |
getTrafficPolicyInstance(GetTrafficPolicyInstanceRequest request)
Gets information about a specified traffic policy instance.
|
GetTrafficPolicyInstanceCountResult |
getTrafficPolicyInstanceCount()
Simplified method form for invoking the GetTrafficPolicyInstanceCount
operation.
|
GetTrafficPolicyInstanceCountResult |
getTrafficPolicyInstanceCount(GetTrafficPolicyInstanceCountRequest request)
Gets the number of traffic policy instances that are associated with the
current AWS account.
|
ListChangeBatchesByHostedZoneResult |
listChangeBatchesByHostedZone(ListChangeBatchesByHostedZoneRequest request)
Deprecated.
|
ListChangeBatchesByRRSetResult |
listChangeBatchesByRRSet(ListChangeBatchesByRRSetRequest request)
Deprecated.
|
ListGeoLocationsResult |
listGeoLocations()
Simplified method form for invoking the ListGeoLocations operation.
|
ListGeoLocationsResult |
listGeoLocations(ListGeoLocationsRequest request)
To retrieve a list of supported geo locations, send a
GET
request to the /Route 53 API version/geolocations
resource. |
ListHealthChecksResult |
listHealthChecks()
Simplified method form for invoking the ListHealthChecks operation.
|
ListHealthChecksResult |
listHealthChecks(ListHealthChecksRequest request)
To retrieve a list of your health checks, send a
GET request
to the /Route 53 API version/healthcheck resource. |
ListHostedZonesResult |
listHostedZones()
Simplified method form for invoking the ListHostedZones operation.
|
ListHostedZonesResult |
listHostedZones(ListHostedZonesRequest request)
To retrieve a list of your hosted zones, send a
GET request
to the /Route 53 API version/hostedzone resource. |
ListHostedZonesByNameResult |
listHostedZonesByName()
Simplified method form for invoking the ListHostedZonesByName operation.
|
ListHostedZonesByNameResult |
listHostedZonesByName(ListHostedZonesByNameRequest request)
To retrieve a list of your hosted zones in lexicographic order, send a
GET request to the
/Route 53 API version/hostedzonesbyname resource. |
ListResourceRecordSetsResult |
listResourceRecordSets(ListResourceRecordSetsRequest request)
List the resource record sets in a specified hosted zone.
|
ListReusableDelegationSetsResult |
listReusableDelegationSets()
Simplified method form for invoking the ListReusableDelegationSets
operation.
|
ListReusableDelegationSetsResult |
listReusableDelegationSets(ListReusableDelegationSetsRequest request)
To retrieve a list of your reusable delegation sets, send a
GET request to the
/Route 53 API version/delegationset resource. |
ListTagsForResourceResult |
listTagsForResource(ListTagsForResourceRequest request) |
ListTagsForResourcesResult |
listTagsForResources(ListTagsForResourcesRequest request) |
ListTrafficPoliciesResult |
listTrafficPolicies()
Simplified method form for invoking the ListTrafficPolicies operation.
|
ListTrafficPoliciesResult |
listTrafficPolicies(ListTrafficPoliciesRequest request)
Gets information about the latest version for every traffic policy that
is associated with the current AWS account.
|
ListTrafficPolicyInstancesResult |
listTrafficPolicyInstances()
Simplified method form for invoking the ListTrafficPolicyInstances
operation.
|
ListTrafficPolicyInstancesResult |
listTrafficPolicyInstances(ListTrafficPolicyInstancesRequest request)
Gets information about the traffic policy instances that you created by
using the current AWS account.
|
ListTrafficPolicyInstancesByHostedZoneResult |
listTrafficPolicyInstancesByHostedZone(ListTrafficPolicyInstancesByHostedZoneRequest request)
Gets information about the traffic policy instances that you created in a
specified hosted zone.
|
ListTrafficPolicyInstancesByPolicyResult |
listTrafficPolicyInstancesByPolicy(ListTrafficPolicyInstancesByPolicyRequest request)
Gets information about the traffic policy instances that you created by
using a specify traffic policy version.
|
ListTrafficPolicyVersionsResult |
listTrafficPolicyVersions(ListTrafficPolicyVersionsRequest request)
Gets information about all of the versions for a specified traffic
policy.
|
void |
setEndpoint(String endpoint)
Overrides the default endpoint for this client
("https://route53.amazonaws.com").
|
void |
setRegion(Region region)
An alternative to
AmazonRoute53.setEndpoint(String) , sets the
regional endpoint for this client's service calls. |
void |
shutdown()
Shuts down this client object, releasing any resources that might be held
open.
|
UpdateHealthCheckResult |
updateHealthCheck(UpdateHealthCheckRequest request)
This action updates an existing health check.
|
UpdateHostedZoneCommentResult |
updateHostedZoneComment(UpdateHostedZoneCommentRequest request)
To update the hosted zone comment, send a
POST request to
the
/Route 53 API version/hostedzone/hosted zone ID
resource. |
UpdateTrafficPolicyCommentResult |
updateTrafficPolicyComment(UpdateTrafficPolicyCommentRequest request)
Updates the comment for a specified traffic policy version.
|
UpdateTrafficPolicyInstanceResult |
updateTrafficPolicyInstance(UpdateTrafficPolicyInstanceRequest request)
Updates the resource record sets in a specified hosted zone that were
created based on the settings in a specified traffic policy version.
|
public void setEndpoint(String endpoint)
AmazonRoute53
Callers can pass in just the endpoint (ex: "route53.amazonaws.com") or a
full URL, including the protocol (ex: "https://route53.amazonaws.com").
If the protocol is not specified here, the default protocol from this
client's ClientConfiguration
will be used, which by default is
HTTPS.
For more information on using AWS regions with the AWS SDK for Java, and a complete list of all available endpoints for all AWS services, see: http://developer.amazonwebservices.com/connect/entry.jspa?externalID= 3912
This method is not threadsafe. An endpoint should be configured when the client is created and before any service requests are made. Changing it afterwards creates inevitable race conditions for any service requests in transit or retrying.
setEndpoint
in interface AmazonRoute53
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.public void setRegion(Region region)
AmazonRoute53
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 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.
setRegion
in interface AmazonRoute53
region
- The region this client will communicate with. See
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.Region.getRegion(com.amazonaws.regions.Regions)
,
Region.createClient(Class,
com.amazonaws.auth.AWSCredentialsProvider, ClientConfiguration)
,
Region.isServiceSupported(String)
public AssociateVPCWithHostedZoneResult associateVPCWithHostedZone(AssociateVPCWithHostedZoneRequest request)
AmazonRoute53
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.
associateVPCWithHostedZone
in interface AmazonRoute53
request
- A complex type that contains information about the request to
associate a VPC with an hosted zone.public ChangeResourceRecordSetsResult changeResourceRecordSets(ChangeResourceRecordSetsRequest request)
AmazonRoute53
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.
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:
Value
elements in a request cannot exceed 32,000 characters.
changeResourceRecordSets
in interface AmazonRoute53
request
- A complex type that contains a change batch.public ChangeTagsForResourceResult changeTagsForResource(ChangeTagsForResourceRequest request)
changeTagsForResource
in interface AmazonRoute53
request
- A complex type containing information about a request to add,
change, or delete the tags that are associated with a resource.public CreateHealthCheckResult createHealthCheck(CreateHealthCheckRequest request)
AmazonRoute53
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.
createHealthCheck
in interface AmazonRoute53
request
- >A complex type that contains information about the request to
create a health check.public CreateHostedZoneResult createHostedZone(CreateHostedZoneRequest request)
AmazonRoute53
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.
createHostedZone
in interface AmazonRoute53
request
- A complex type that contains information about the request to
create a hosted zone.public CreateReusableDelegationSetResult createReusableDelegationSet(CreateReusableDelegationSetRequest request)
AmazonRoute53
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.
createReusableDelegationSet
in interface AmazonRoute53
public CreateTrafficPolicyResult createTrafficPolicy(CreateTrafficPolicyRequest request)
AmazonRoute53
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.
createTrafficPolicy
in interface AmazonRoute53
request
- A complex type that contains information about the traffic policy
that you want to create.public CreateTrafficPolicyInstanceResult createTrafficPolicyInstance(CreateTrafficPolicyInstanceRequest request)
AmazonRoute53
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.
createTrafficPolicyInstance
in interface AmazonRoute53
request
- A complex type that contains information about the resource record
sets that you want to create based on a specified traffic policy.public CreateTrafficPolicyVersionResult createTrafficPolicyVersion(CreateTrafficPolicyVersionRequest request)
AmazonRoute53
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.
createTrafficPolicyVersion
in interface AmazonRoute53
request
- A complex type that contains information about the traffic policy
for which you want to create a new version.public DeleteHealthCheckResult deleteHealthCheck(DeleteHealthCheckRequest request)
AmazonRoute53
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.
HealthCheckInUse
error. For information
about disassociating the records from your health check, see
ChangeResourceRecordSets
.deleteHealthCheck
in interface AmazonRoute53
request
- A complex type containing the request information for delete
health check.public DeleteHostedZoneResult deleteHostedZone(DeleteHostedZoneRequest request)
AmazonRoute53
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.
HostedZoneNotEmpty
error. For
information about deleting records from your hosted zone, see
ChangeResourceRecordSets
.deleteHostedZone
in interface AmazonRoute53
request
- A complex type that contains information about the hosted zone
that you want to delete.public DeleteReusableDelegationSetResult deleteReusableDelegationSet(DeleteReusableDelegationSetRequest request)
AmazonRoute53
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.
DelegationSetInUse
error.deleteReusableDelegationSet
in interface AmazonRoute53
request
- A complex type containing the information for the delete request.public DeleteTrafficPolicyResult deleteTrafficPolicy(DeleteTrafficPolicyRequest request)
AmazonRoute53
Deletes a traffic policy. To delete a traffic policy, send a
DELETE
request to the
/Route 53 API version/trafficpolicy
resource.
deleteTrafficPolicy
in interface AmazonRoute53
request
- A request to delete a specified traffic policy version.public DeleteTrafficPolicyInstanceResult deleteTrafficPolicyInstance(DeleteTrafficPolicyInstanceRequest request)
AmazonRoute53
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.
deleteTrafficPolicyInstance
in interface AmazonRoute53
request
- A complex type that contains information about the traffic policy
instance that you want to delete.public DisassociateVPCFromHostedZoneResult disassociateVPCFromHostedZone(DisassociateVPCFromHostedZoneRequest request)
AmazonRoute53
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.
disassociateVPCFromHostedZone
in interface AmazonRoute53
request
- A complex type that contains information about the request to
disassociate a VPC from an hosted zone.public GetChangeResult getChange(GetChangeRequest request)
AmazonRoute53
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.
getChange
in interface AmazonRoute53
request
- The input for a GetChange request.@Deprecated public GetChangeDetailsResult getChangeDetails(GetChangeDetailsRequest request)
AmazonRoute53
This action returns the status and changes of a change batch request.
getChangeDetails
in interface AmazonRoute53
request
- The input for a GetChangeDetails request.public GetCheckerIpRangesResult getCheckerIpRanges(GetCheckerIpRangesRequest request)
AmazonRoute53
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.
getCheckerIpRanges
in interface AmazonRoute53
request
- Empty request.public GetCheckerIpRangesResult getCheckerIpRanges()
AmazonRoute53
getCheckerIpRanges
in interface AmazonRoute53
AmazonRoute53.getCheckerIpRanges(GetCheckerIpRangesRequest)
public GetGeoLocationResult getGeoLocation(GetGeoLocationRequest request)
AmazonRoute53
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.
getGeoLocation
in interface AmazonRoute53
request
- A complex type that contains information about the request to get
a geo location.public GetGeoLocationResult getGeoLocation()
AmazonRoute53
getGeoLocation
in interface AmazonRoute53
AmazonRoute53.getGeoLocation(GetGeoLocationRequest)
public GetHealthCheckResult getHealthCheck(GetHealthCheckRequest request)
AmazonRoute53
To retrieve the health check, send a GET
request to the
/Route 53 API version/healthcheck/health check ID
resource.
getHealthCheck
in interface AmazonRoute53
request
- A complex type that contains information about the request to get
a health check.public GetHealthCheckCountResult getHealthCheckCount(GetHealthCheckCountRequest request)
AmazonRoute53
To retrieve a count of all your health checks, send a GET
request to the /Route 53 API version/healthcheckcount
resource.
getHealthCheckCount
in interface AmazonRoute53
request
- To retrieve a count of all your health checks, send a
GET
request to the
/Route 53 API version/healthcheckcount
resource.public GetHealthCheckCountResult getHealthCheckCount()
AmazonRoute53
getHealthCheckCount
in interface AmazonRoute53
AmazonRoute53.getHealthCheckCount(GetHealthCheckCountRequest)
public GetHealthCheckLastFailureReasonResult getHealthCheckLastFailureReason(GetHealthCheckLastFailureReasonRequest request)
AmazonRoute53
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.
getHealthCheckLastFailureReason
in interface AmazonRoute53
request
- A complex type that contains information about the request to get
the most recent failure reason for a health check.public GetHealthCheckStatusResult getHealthCheckStatus(GetHealthCheckStatusRequest request)
AmazonRoute53
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.
getHealthCheckStatus
in interface AmazonRoute53
request
- A complex type that contains information about the request to get
health check status for a health check.public GetHostedZoneResult getHostedZone(GetHostedZoneRequest request)
AmazonRoute53
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.
getHostedZone
in interface AmazonRoute53
request
- The input for a GetHostedZone request.public GetHostedZoneCountResult getHostedZoneCount(GetHostedZoneCountRequest request)
AmazonRoute53
To retrieve a count of all your hosted zones, send a GET
request to the /Route 53 API version/hostedzonecount
resource.
getHostedZoneCount
in interface AmazonRoute53
request
- To retrieve a count of all your hosted zones, send a
GET
request to the
/Route 53 API version/hostedzonecount
resource.public GetHostedZoneCountResult getHostedZoneCount()
AmazonRoute53
getHostedZoneCount
in interface AmazonRoute53
AmazonRoute53.getHostedZoneCount(GetHostedZoneCountRequest)
public GetReusableDelegationSetResult getReusableDelegationSet(GetReusableDelegationSetRequest request)
AmazonRoute53
To retrieve the reusable delegation set, send a GET
request
to the
/Route 53 API version/delegationset/delegation set ID
resource.
getReusableDelegationSet
in interface AmazonRoute53
request
- The input for a GetReusableDelegationSet
request.public GetTrafficPolicyResult getTrafficPolicy(GetTrafficPolicyRequest request)
AmazonRoute53
Gets information about a specific traffic policy version. To get the
information, send a GET
request to the
/Route 53 API version/trafficpolicy
resource.
getTrafficPolicy
in interface AmazonRoute53
request
- 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.public GetTrafficPolicyInstanceResult getTrafficPolicyInstance(GetTrafficPolicyInstanceRequest request)
AmazonRoute53
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.
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.getTrafficPolicyInstance
in interface AmazonRoute53
request
- 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.
public GetTrafficPolicyInstanceCountResult getTrafficPolicyInstanceCount(GetTrafficPolicyInstanceCountRequest request)
AmazonRoute53
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.
getTrafficPolicyInstanceCount
in interface AmazonRoute53
request
- To retrieve a count of all your traffic policy instances, send a
GET
request to the
/Route 53 API version/trafficpolicyinstancecount
resource.public GetTrafficPolicyInstanceCountResult getTrafficPolicyInstanceCount()
AmazonRoute53
getTrafficPolicyInstanceCount
in interface AmazonRoute53
AmazonRoute53.getTrafficPolicyInstanceCount(GetTrafficPolicyInstanceCountRequest)
@Deprecated public ListChangeBatchesByHostedZoneResult listChangeBatchesByHostedZone(ListChangeBatchesByHostedZoneRequest request)
AmazonRoute53
This action gets the list of ChangeBatches in a given time period for a given hosted zone.
listChangeBatchesByHostedZone
in interface AmazonRoute53
request
- The input for a ListChangeBatchesByHostedZone request.@Deprecated public ListChangeBatchesByRRSetResult listChangeBatchesByRRSet(ListChangeBatchesByRRSetRequest request)
AmazonRoute53
This action gets the list of ChangeBatches in a given time period for a given hosted zone and RRSet.
listChangeBatchesByRRSet
in interface AmazonRoute53
request
- The input for a ListChangeBatchesByRRSet request.public ListGeoLocationsResult listGeoLocations(ListGeoLocationsRequest request)
AmazonRoute53
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.
listGeoLocations
in interface AmazonRoute53
request
- The input for a ListGeoLocations
request.public ListGeoLocationsResult listGeoLocations()
AmazonRoute53
listGeoLocations
in interface AmazonRoute53
AmazonRoute53.listGeoLocations(ListGeoLocationsRequest)
public ListHealthChecksResult listHealthChecks(ListHealthChecksRequest request)
AmazonRoute53
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.
listHealthChecks
in interface AmazonRoute53
request
- 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. MaxItems
to a value greater
than 100, Amazon Route 53 returns only the first 100.public ListHealthChecksResult listHealthChecks()
AmazonRoute53
listHealthChecks
in interface AmazonRoute53
AmazonRoute53.listHealthChecks(ListHealthChecksRequest)
public ListHostedZonesResult listHostedZones(ListHostedZonesRequest request)
AmazonRoute53
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.
listHostedZones
in interface AmazonRoute53
request
- 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. MaxItems
to a value greater
than 100, Amazon Route 53 returns only the first 100.public ListHostedZonesResult listHostedZones()
AmazonRoute53
listHostedZones
in interface AmazonRoute53
AmazonRoute53.listHostedZones(ListHostedZonesRequest)
public ListHostedZonesByNameResult listHostedZonesByName(ListHostedZonesByNameRequest request)
AmazonRoute53
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.
listHostedZonesByName
in interface AmazonRoute53
request
- 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.public ListHostedZonesByNameResult listHostedZonesByName()
AmazonRoute53
listHostedZonesByName
in interface AmazonRoute53
AmazonRoute53.listHostedZonesByName(ListHostedZonesByNameRequest)
public ListResourceRecordSetsResult listResourceRecordSets(ListResourceRecordSetsRequest request)
AmazonRoute53
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:
Name
or Type
:
The results begin with the first resource record set that the hosted zone
contains.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.Type
but not Name
:
Amazon Route 53 returns the InvalidInput
error.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.
listResourceRecordSets
in interface AmazonRoute53
request
- The input for a ListResourceRecordSets request.public ListReusableDelegationSetsResult listReusableDelegationSets(ListReusableDelegationSetsRequest request)
AmazonRoute53
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.
listReusableDelegationSets
in interface AmazonRoute53
request
- 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. MaxItems
to a value greater
than 100, Amazon Route 53 returns only the first 100.public ListReusableDelegationSetsResult listReusableDelegationSets()
AmazonRoute53
listReusableDelegationSets
in interface AmazonRoute53
AmazonRoute53.listReusableDelegationSets(ListReusableDelegationSetsRequest)
public ListTagsForResourceResult listTagsForResource(ListTagsForResourceRequest request)
listTagsForResource
in interface AmazonRoute53
request
- A complex type containing information about a request for a list
of the tags that are associated with an individual resource.public ListTagsForResourcesResult listTagsForResources(ListTagsForResourcesRequest request)
listTagsForResources
in interface AmazonRoute53
request
- A complex type containing information about a request for a list
of the tags that are associated with up to 10 specified resources.public ListTrafficPoliciesResult listTrafficPolicies(ListTrafficPoliciesRequest request)
AmazonRoute53
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:
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.
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.
The value that you specified for the MaxItems
parameter in
the request that produced the current response.
listTrafficPolicies
in interface AmazonRoute53
request
- A complex type that contains the information about the request to
list the traffic policies that are associated with the current AWS
account.public ListTrafficPoliciesResult listTrafficPolicies()
AmazonRoute53
listTrafficPolicies
in interface AmazonRoute53
AmazonRoute53.listTrafficPolicies(ListTrafficPoliciesRequest)
public ListTrafficPolicyInstancesResult listTrafficPolicyInstances(ListTrafficPolicyInstancesRequest request)
AmazonRoute53
Gets information about the traffic policy instances that you created by using the current AWS account.
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:
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.
The value that you specified for the MaxItems
parameter in
the request that produced the current response.
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.
listTrafficPolicyInstances
in interface AmazonRoute53
request
- A complex type that contains the information about the request to
list your traffic policy instances.public ListTrafficPolicyInstancesResult listTrafficPolicyInstances()
AmazonRoute53
listTrafficPolicyInstances
in interface AmazonRoute53
AmazonRoute53.listTrafficPolicyInstances(ListTrafficPolicyInstancesRequest)
public ListTrafficPolicyInstancesByHostedZoneResult listTrafficPolicyInstancesByHostedZone(ListTrafficPolicyInstancesByHostedZoneRequest request)
AmazonRoute53
Gets information about the traffic policy instances that you created in a specified hosted zone.
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:
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.
The value that you specified for the MaxItems
parameter in
the request that produced the current response.
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.
listTrafficPolicyInstancesByHostedZone
in interface AmazonRoute53
request
- A request for the traffic policy instances that you created in a
specified hosted zone.public ListTrafficPolicyInstancesByPolicyResult listTrafficPolicyInstancesByPolicy(ListTrafficPolicyInstancesByPolicyRequest request)
AmazonRoute53
Gets information about the traffic policy instances that you created by using a specify traffic policy version.
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:
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.
The value that you specified for the MaxItems
parameter in
the request that produced the current response.
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.
listTrafficPolicyInstancesByPolicy
in interface AmazonRoute53
request
- A complex type that contains the information about the request to
list your traffic policy instances.public ListTrafficPolicyVersionsResult listTrafficPolicyVersions(ListTrafficPolicyVersionsRequest request)
AmazonRoute53
Gets information about all of the versions for a specified traffic
policy. ListTrafficPolicyVersions
lists only versions that
have not been deleted.
Amazon Route 53 returns a maximum of 100 items in each response. If you
have a lot of traffic policies, you can use the maxitems
parameter to list them in groups of up to 100.
The response includes three values that help you navigate from one group
of maxitems
maxitems traffic policies to the next:
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.
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.
The value that you specified for the MaxItems
parameter in
the request that produced the current response.
listTrafficPolicyVersions
in interface AmazonRoute53
request
- A complex type that contains the information about the request to
list your traffic policies.public UpdateHealthCheckResult updateHealthCheck(UpdateHealthCheckRequest request)
AmazonRoute53
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.
updateHealthCheck
in interface AmazonRoute53
request
- >A complex type that contains information about the request to
update a health check.public UpdateHostedZoneCommentResult updateHostedZoneComment(UpdateHostedZoneCommentRequest request)
AmazonRoute53
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.
updateHostedZoneComment
in interface AmazonRoute53
request
- A complex type that contains information about the request to
update a hosted zone comment.public UpdateTrafficPolicyCommentResult updateTrafficPolicyComment(UpdateTrafficPolicyCommentRequest request)
AmazonRoute53
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.
updateTrafficPolicyComment
in interface AmazonRoute53
request
- A complex type that contains information about the traffic policy
for which you want to update the comment.public UpdateTrafficPolicyInstanceResult updateTrafficPolicyInstance(UpdateTrafficPolicyInstanceRequest request)
AmazonRoute53
Updates the resource record sets in a specified hosted zone that were created based on the settings in a specified traffic policy version.
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:
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.
updateTrafficPolicyInstance
in interface AmazonRoute53
request
- A complex type that contains information about the resource record
sets that you want to update based on a specified traffic policy
instance.public void shutdown()
AmazonRoute53
shutdown
in interface AmazonRoute53
public ResponseMetadata getCachedResponseMetadata(AmazonWebServiceRequest request)
AmazonRoute53
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.
getCachedResponseMetadata
in interface AmazonRoute53
request
- The originally executed request.Copyright © 2013 Amazon Web Services, Inc. All Rights Reserved.