* Note: Do not directly implement this interface, new methods are added to it regularly. Extend from * {@link com.amazonaws.services.route53.AbstractAmazonRoute53} instead. *
**
* Amazon Route 53 is a highly available and scalable Domain Name System (DNS) web service. *
** You can use Route 53 to: *
** Register domain names. *
** For more information, see How domain * registration works. *
** Route internet traffic to the resources for your domain *
** For more information, see How internet traffic is * routed to your website or web application. *
** Check the health of your resources. *
** For more information, see How Route 53 checks the * health of your resources. *
** 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: https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/java-dg-region-selection.html#region-selection- * choose-endpoint *
* 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. * @deprecated use {@link AwsClientBuilder#setEndpointConfiguration(AwsClientBuilder.EndpointConfiguration)} for * example: * {@code builder.setEndpointConfiguration(new EndpointConfiguration(endpoint, signingRegion));} */ @Deprecated 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) * @deprecated use {@link AwsClientBuilder#setRegion(String)} */ @Deprecated void setRegion(Region region); /** *
* Activates a key-signing key (KSK) so that it can be used for signing by DNSSEC. This operation changes the KSK
* status to ACTIVE.
*
INTERNAL_FAILURE.
* @throws InvalidSigningStatusException
* Your hosted zone status isn't valid for this operation. In the hosted zone, change the status to enable
* DNSSEC or disable DNSSEC.
* @throws InvalidKMSArnException
* The KeyManagementServiceArn that you specified isn't valid to use with DNSSEC signing.
* @throws InvalidInputException
* The input is not valid.
* @sample AmazonRoute53.ActivateKeySigningKey
* @see AWS
* API Documentation
*/
ActivateKeySigningKeyResult activateKeySigningKey(ActivateKeySigningKeyRequest activateKeySigningKeyRequest);
/**
* * Associates an Amazon VPC with a private hosted zone. *
** To perform the association, the VPC and the private hosted zone must already exist. You can't convert a public * hosted zone into a private hosted zone. *
*
* If you want to associate a VPC that was created by using one Amazon Web Services account with a private hosted
* zone that was created by using a different account, the Amazon Web Services account that created the private
* hosted zone must first submit a CreateVPCAssociationAuthorization request. Then the account that
* created the VPC must submit an AssociateVPCWithHostedZone request.
*
* When granting access, the hosted zone and the Amazon VPC must belong to the same partition. A partition is a * group of Amazon Web Services Regions. Each Amazon Web Services account is scoped to one partition. *
** The following are the supported partitions: *
*
* aws - Amazon Web Services Regions
*
* aws-cn - China Regions
*
* aws-us-gov - Amazon Web Services GovCloud (US) Region
*
* For more information, see Access Management in the * Amazon Web Services General Reference. *
** Create a public hosted zone: Two hosted zones that have the same name or that have a parent/child * relationship (example.com and test.example.com) can't have any common name servers. You tried to create a * hosted zone that has the same name as an existing hosted zone or that's the parent or child of an * existing hosted zone, and you specified a delegation set that shares one or more name servers with the * existing hosted zone. For more information, see CreateReusableDelegationSet. *
** Create a private hosted zone: A hosted zone with the specified name already exists and is already * associated with the Amazon VPC that you specified. *
** Associate VPCs with a private hosted zone: The VPC that you specified is already associated with * another hosted zone that has the same name. *
*HTTP 400 error (Bad request).
* If Route 53 returns this error repeatedly for the same request, we recommend that you wait, in intervals
* of increasing duration, before you try the request again.
* @sample AmazonRoute53.AssociateVPCWithHostedZone
* @see AWS API Documentation
*/
AssociateVPCWithHostedZoneResult associateVPCWithHostedZone(AssociateVPCWithHostedZoneRequest associateVPCWithHostedZoneRequest);
/**
* * Creates, changes, or deletes CIDR blocks within a collection. Contains authoritative IP information mapping * blocks to one or multiple locations. *
** A change request can update multiple locations in a collection at a time, which is helpful if you want to move * one or more CIDR blocks from one location to another in one transaction, without downtime. *
** Limits *
** The max number of CIDR blocks included in the request is 1000. As a result, big updates require multiple API * calls. *
** PUT and DELETE_IF_EXISTS *
*
* Use ChangeCidrCollection to perform the following actions:
*
* PUT: Create a CIDR block within the specified collection.
*
* DELETE_IF_EXISTS: Delete an existing CIDR block from the collection.
*
ListCidrCollections
* operation.
* @throws InvalidInputException
* The input is not valid.
* @throws CidrBlockInUseException
* This CIDR block is already in use.
* @throws LimitsExceededException
* This operation can't be completed because the current account has reached the limit on the resource you
* are trying to create. To request a higher limit, create a
* case with the Amazon Web Services Support Center.
* @throws ConcurrentModificationException
* Another user submitted a request to create, update, or delete the object at the same time that you did.
* Retry the request.
* @sample AmazonRoute53.ChangeCidrCollection
* @see AWS
* API Documentation
*/
ChangeCidrCollectionResult changeCidrCollection(ChangeCidrCollectionRequest changeCidrCollectionRequest);
/**
*
* Creates, changes, or deletes a resource record set, which contains authoritative DNS information for a specified
* domain name or subdomain name. For example, you can use ChangeResourceRecordSets to create a
* resource record set that routes traffic for test.example.com to a web server that has an IP address of
* 192.0.2.44.
*
* Deleting Resource Record Sets *
** To delete a resource record set, you must specify all the same values that you specified when you created it. *
** Change Batches and Transactional Changes *
*
* The request body must include a document with a ChangeResourceRecordSetsRequest element. The request
* body contains a list of change items, known as a change batch. Change batches are considered transactional
* changes. Route 53 validates the changes in the request and then either makes all or none of the changes in the
* change batch request. This ensures that DNS routing isn't adversely affected by partial changes to the resource
* record sets in a hosted zone.
*
* For example, suppose a change batch request contains two changes: it deletes the CNAME resource
* record set for www.example.com and creates an alias resource record set for www.example.com. If validation for
* both records succeeds, Route 53 deletes the first resource record set and creates the second resource record set
* in a single operation. If validation for either the DELETE or the CREATE action fails,
* then the request is canceled, and the original CNAME record continues to exist.
*
* If you try to delete the same resource record set more than once in a single change batch, Route 53 returns an
* InvalidChangeBatch error.
*
* Traffic Flow *
** To create resource record sets for complex routing configurations, use either the traffic flow visual editor in * the Route 53 console or the API actions for traffic policies and traffic policy instances. Save the configuration * as a traffic policy, then associate the traffic policy with one or more domain names (such as example.com) or * subdomain names (such as www.example.com), in the same hosted zone or in multiple hosted zones. You can roll back * the updates if the new configuration isn't performing as expected. For more information, see Using Traffic Flow to Route * DNS Traffic in the Amazon Route 53 Developer Guide. *
** Create, Delete, and Upsert *
*
* Use ChangeResourceRecordsSetsRequest to perform the following actions:
*
* CREATE: Creates a resource record set that has the specified values.
*
* DELETE: Deletes an existing resource record set that has the specified values.
*
* UPSERT: If a resource set exists Route 53 updates it with the values in the request.
*
* Syntaxes for Creating, Updating, and Deleting Resource Record Sets *
** The syntax for a request depends on the type of resource record set that you want to create, delete, or update, * such as weighted, alias, or failover. The XML elements in your request must appear in the order listed in the * syntax. *
** For an example for each type of resource record set, see "Examples." *
*
* Don't refer to the syntax in the "Parameter Syntax" section, which includes all of the elements for every kind of
* resource record set that you can create, delete, or update by using ChangeResourceRecordSets.
*
* Change Propagation to Route 53 DNS Servers *
*
* When you submit a ChangeResourceRecordSets request, Route 53 propagates your changes to all of the
* Route 53 authoritative DNS servers managing the hosted zone. While your changes are propagating,
* GetChange returns a status of PENDING. When propagation is complete,
* GetChange returns a status of INSYNC. Changes generally propagate to all Route 53 name
* servers managing the hosted zone within 60 seconds. For more information, see GetChange.
*
* Limits on ChangeResourceRecordSets Requests *
*
* For information about the limits on a ChangeResourceRecordSets request, see Limits in the Amazon
* Route 53 Developer Guide.
*
HTTP 400 error (Bad request).
* If Route 53 returns this error repeatedly for the same request, we recommend that you wait, in intervals
* of increasing duration, before you try the request again.
* @sample AmazonRoute53.ChangeResourceRecordSets
* @see AWS API Documentation
*/
ChangeResourceRecordSetsResult changeResourceRecordSets(ChangeResourceRecordSetsRequest changeResourceRecordSetsRequest);
/**
* * Adds, edits, or deletes tags for a health check or a hosted zone. *
** For information about using tags for cost allocation, see Using Cost Allocation * Tags in the Billing and Cost Management User Guide. *
* * @param changeTagsForResourceRequest * A complex type that contains information about the tags that you want to add, edit, or delete. * @return Result of the ChangeTagsForResource operation returned by the service. * @throws InvalidInputException * The input is not valid. * @throws NoSuchHealthCheckException * No health check exists with the specified ID. * @throws NoSuchHostedZoneException * No hosted zone exists with the ID that you specified. * @throws PriorRequestNotCompleteException * If Amazon Route 53 can't process a request before the next request arrives, it will reject subsequent * requests for the same hosted zone and return anHTTP 400 error (Bad request).
* If Route 53 returns this error repeatedly for the same request, we recommend that you wait, in intervals
* of increasing duration, before you try the request again.
* @throws ThrottlingException
* The limit on the number of requests per second was exceeded.
* @sample AmazonRoute53.ChangeTagsForResource
* @see AWS
* API Documentation
*/
ChangeTagsForResourceResult changeTagsForResource(ChangeTagsForResourceRequest changeTagsForResourceRequest);
/**
* * Creates a CIDR collection in the current Amazon Web Services account. *
* * @param createCidrCollectionRequest * @return Result of the CreateCidrCollection operation returned by the service. * @throws LimitsExceededException * This operation can't be completed because the current account has reached the limit on the resource you * are trying to create. To request a higher limit, create a * case with the Amazon Web Services Support Center. * @throws InvalidInputException * The input is not valid. * @throws CidrCollectionAlreadyExistsException * A CIDR collection with this name and a different caller reference already exists in this account. * @throws ConcurrentModificationException * Another user submitted a request to create, update, or delete the object at the same time that you did. * Retry the request. * @sample AmazonRoute53.CreateCidrCollection * @see AWS * API Documentation */ CreateCidrCollectionResult createCidrCollection(CreateCidrCollectionRequest createCidrCollectionRequest); /** ** Creates a new health check. *
** For information about adding health checks to resource record sets, see HealthCheckId in ChangeResourceRecordSets. *
** ELB Load Balancers *
** If you're registering EC2 instances with an Elastic Load Balancing (ELB) load balancer, do not create Amazon * Route 53 health checks for the EC2 instances. When you register an EC2 instance with a load balancer, you * configure settings for an ELB health check, which performs a similar function to a Route 53 health check. *
** Private Hosted Zones *
** You can associate health checks with failover resource record sets in a private hosted zone. Note the following: *
** Route 53 health checkers are outside the VPC. To check the health of an endpoint within a VPC by IP address, you * must assign a public IP address to the instance in the VPC. *
** You can configure a health checker to check the health of an external resource that the instance relies on, such * as a database server. *
*
* You can create a CloudWatch metric, associate an alarm with the metric, and then create a health check that is
* based on the state of the alarm. For example, you might create a CloudWatch metric that checks the status of the
* Amazon EC2 StatusCheckFailed metric, add an alarm to the metric, and then create a health check that
* is based on the state of the alarm. For information about creating CloudWatch metrics and alarms by using the
* CloudWatch console, see the Amazon CloudWatch
* User Guide.
*
* For information about default limits, see Limits in the * Amazon Route 53 Developer Guide. *
** For information about how to get the current limit for an account, see GetAccountLimit. To request a higher limit, create a * case with the Amazon Web Services Support Center. *
** You have reached the maximum number of active health checks for an Amazon Web Services account. To * request a higher limit, create a case with the Amazon * Web Services Support Center. * @throws HealthCheckAlreadyExistsException * The health check you're attempting to create already exists. Amazon Route 53 returns this error when you * submit a request that has the following values: *
*
* The same value for CallerReference as an existing health check, and one or more values that
* differ from the existing health check that has the same caller reference.
*
* The same value for CallerReference as a health check that you created and later deleted,
* regardless of the other settings in the request.
*
* Creates a new public or private hosted zone. You create records in a public hosted zone to define how you want to * route traffic on the internet for a domain, such as example.com, and its subdomains (apex.example.com, * acme.example.com). You create records in a private hosted zone to define how you want to route traffic for a * domain and its subdomains within one or more Amazon Virtual Private Clouds (Amazon VPCs). *
** You can't convert a public hosted zone to a private hosted zone or vice versa. Instead, you must create a new * hosted zone with the same name and create new resource record sets. *
** For more information about charges for hosted zones, see Amazon * Route 53 Pricing. *
** Note the following: *
** You can't create a hosted zone for a top-level domain (TLD) such as .com. *
** For public hosted zones, Route 53 automatically creates a default SOA record and four NS records for the zone. * For more information about SOA and NS records, see NS and SOA Records that * Route 53 Creates for a Hosted Zone in the Amazon Route 53 Developer Guide. *
*
* If you want to use the same name servers for multiple public hosted zones, you can optionally associate a
* reusable delegation set with the hosted zone. See the DelegationSetId element.
*
* If your domain is registered with a registrar other than Route 53, you must update the name servers with your * registrar to make Route 53 the DNS service for the domain. For more information, see Migrating DNS Service for an * Existing Domain to Amazon Route 53 in the Amazon Route 53 Developer Guide. *
*
* When you submit a CreateHostedZone request, the initial status of the hosted zone is
* PENDING. For public hosted zones, this means that the NS and SOA records are not yet available on
* all Route 53 DNS servers. When the NS and SOA records are available, the status of the zone changes to
* INSYNC.
*
* The CreateHostedZone request requires the caller to have an ec2:DescribeVpcs
* permission.
*
* When creating private hosted zones, the Amazon VPC must belong to the same partition where the hosted zone is * created. A partition is a group of Amazon Web Services Regions. Each Amazon Web Services account is scoped to one * partition. *
** The following are the supported partitions: *
*
* aws - Amazon Web Services Regions
*
* aws-cn - China Regions
*
* aws-us-gov - Amazon Web Services GovCloud (US) Region
*
* For more information, see Access Management in the * Amazon Web Services General Reference. *
*CallerReference.
* @throws TooManyHostedZonesException
* This operation can't be completed either because the current account has reached the limit on the number
* of hosted zones or because you've reached the limit on the number of hosted zones that can be associated
* with a reusable delegation set.
* * For information about default limits, see Limits in the * Amazon Route 53 Developer Guide. *
** To get the current limit on hosted zones that can be created by an account, see GetAccountLimit. *
** To get the current limit on hosted zones that can be associated with a reusable delegation set, see * GetReusableDelegationSetLimit. *
** To request a higher limit, create a case with the * Amazon Web Services Support Center. * @throws InvalidVPCIdException * The VPC ID that you specified either isn't a valid ID or the current account is not authorized to access * this VPC. * @throws InvalidInputException * The input is not valid. * @throws DelegationSetNotAvailableException * You can create a hosted zone that has the same name as an existing hosted zone (example.com is common), * but there is a limit to the number of hosted zones that have the same name. If you get this error, Amazon * Route 53 has reached that limit. If you own the domain name and Route 53 generates this error, contact * Customer Support. * @throws ConflictingDomainExistsException * The cause of this error depends on the operation that you're performing: *
** Create a public hosted zone: Two hosted zones that have the same name or that have a parent/child * relationship (example.com and test.example.com) can't have any common name servers. You tried to create a * hosted zone that has the same name as an existing hosted zone or that's the parent or child of an * existing hosted zone, and you specified a delegation set that shares one or more name servers with the * existing hosted zone. For more information, see CreateReusableDelegationSet. *
** Create a private hosted zone: A hosted zone with the specified name already exists and is already * associated with the Amazon VPC that you specified. *
** Associate VPCs with a private hosted zone: The VPC that you specified is already associated with * another hosted zone that has the same name. *
** Creates a new key-signing key (KSK) associated with a hosted zone. You can only have two KSKs per hosted zone. *
* * @param createKeySigningKeyRequest * @return Result of the CreateKeySigningKey operation returned by the service. * @throws NoSuchHostedZoneException * No hosted zone exists with the ID that you specified. * @throws InvalidArgumentException * Parameter name is not valid. * @throws InvalidInputException * The input is not valid. * @throws InvalidKMSArnException * The KeyManagementServiceArn that you specified isn't valid to use with DNSSEC signing. * @throws InvalidKeySigningKeyStatusException * The key-signing key (KSK) status isn't valid or another KSK has the statusINTERNAL_FAILURE.
* @throws InvalidSigningStatusException
* Your hosted zone status isn't valid for this operation. In the hosted zone, change the status to enable
* DNSSEC or disable DNSSEC.
* @throws InvalidKeySigningKeyNameException
* The key-signing key (KSK) name that you specified isn't a valid name.
* @throws KeySigningKeyAlreadyExistsException
* You've already created a key-signing key (KSK) with this name or with the same customer managed key ARN.
* @throws TooManyKeySigningKeysException
* You've reached the limit for the number of key-signing keys (KSKs). Remove at least one KSK, and then try
* again.
* @throws ConcurrentModificationException
* Another user submitted a request to create, update, or delete the object at the same time that you did.
* Retry the request.
* @sample AmazonRoute53.CreateKeySigningKey
* @see AWS
* API Documentation
*/
CreateKeySigningKeyResult createKeySigningKey(CreateKeySigningKeyRequest createKeySigningKeyRequest);
/**
* * Creates a configuration for DNS query logging. After you create a query logging configuration, Amazon Route 53 * begins to publish log data to an Amazon CloudWatch Logs log group. *
** DNS query logs contain information about the queries that Route 53 receives for a specified public hosted zone, * such as the following: *
** Route 53 edge location that responded to the DNS query *
** Domain or subdomain that was requested *
** DNS record type, such as A or AAAA *
*
* DNS response code, such as NoError or ServFail
*
* Before you create a query logging configuration, perform the following operations. *
** If you create a query logging configuration using the Route 53 console, Route 53 performs these operations * automatically. *
** Create a CloudWatch Logs log group, and make note of the ARN, which you specify when you create a query logging * configuration. Note the following: *
** You must create the log group in the us-east-1 region. *
** You must use the same Amazon Web Services account to create the log group and the hosted zone that you want to * configure query logging for. *
** When you create log groups for query logging, we recommend that you use a consistent prefix, for example: *
*
* /aws/route53/hosted zone name
*
* In the next step, you'll create a resource policy, which controls access to one or more log groups and the * associated Amazon Web Services resources, such as Route 53 hosted zones. There's a limit on the number of * resource policies that you can create, so we recommend that you use a consistent prefix so you can use the same * resource policy for all the log groups that you create for query logging. *
*
* Create a CloudWatch Logs resource policy, and give it the permissions that Route 53 needs to create log streams
* and to send query logs to log streams. For the value of Resource, specify the ARN for the log group
* that you created in the previous step. To use the same resource policy for all the CloudWatch Logs log groups
* that you created for query logging configurations, replace the hosted zone name with *, for example:
*
* arn:aws:logs:us-east-1:123412341234:log-group:/aws/route53/*
*
* To avoid the confused deputy problem, a security issue where an entity without a permission for an action can * coerce a more-privileged entity to perform it, you can optionally limit the permissions that a service has to a * resource in a resource-based policy by supplying the following values: *
*
* For aws:SourceArn, supply the hosted zone ARN used in creating the query logging configuration. For
* example, aws:SourceArn: arn:aws:route53:::hostedzone/hosted zone ID.
*
* For aws:SourceAccount, supply the account ID for the account that creates the query logging
* configuration. For example, aws:SourceAccount:111111111111.
*
* For more information, see The * confused deputy problem in the Amazon Web Services IAM User Guide. *
** You can't use the CloudWatch console to create or edit a resource policy. You must use the CloudWatch API, one of * the Amazon Web Services SDKs, or the CLI. *
** When Route 53 finishes creating the configuration for DNS query logging, it does the following: *
** Creates a log stream for an edge location the first time that the edge location responds to DNS queries for the * specified hosted zone. That log stream is used to log all queries that Route 53 responds to for that edge * location. *
** Begins to send query logs to the applicable log stream. *
** The name of each log stream is in the following format: *
*
* hosted zone ID/edge location code
*
* The edge location code is a three-letter code and an arbitrarily assigned number, for example, DFW3. The * three-letter code typically corresponds with the International Air Transport Association airport code for an * airport near the edge location. (These abbreviations might change in the future.) For a list of edge locations, * see "The Route 53 Global Network" on the Route 53 Product * Details page. *
** Query logs contain only the queries that DNS resolvers forward to Route 53. If a DNS resolver has already cached * the response to a query (such as the IP address for a load balancer for example.com), the resolver will continue * to return the cached response. It doesn't forward another query to Route 53 until the TTL for the corresponding * resource record set expires. Depending on how many DNS queries are submitted for a resource record set, and * depending on the TTL for that resource record set, query logs might contain information about only one query out * of every several thousand queries that are submitted to DNS. For more information about how DNS works, see Routing Internet * Traffic to Your Website or Web Application in the Amazon Route 53 Developer Guide. *
** For a list of the values in each query log and the format of each value, see Logging DNS Queries in the * Amazon Route 53 Developer Guide. *
** For information about charges for query logs, see Amazon * CloudWatch Pricing. *
** If you want Route 53 to stop sending query logs to CloudWatch Logs, delete the query logging configuration. For * more information, see DeleteQueryLoggingConfig. *
*
* There is no resource policy that specifies the log group ARN in the value for Resource.
*
* The resource policy that includes the log group ARN in the value for Resource doesn't have
* the necessary permissions.
*
* The resource policy hasn't finished propagating yet. *
** The Key management service (KMS) key you specified doesn’t exist or it can’t be used with the log group * associated with query log. Update or provide a resource policy to grant permissions for the KMS key. *
** The Key management service (KMS) key you specified is marked as disabled for the log group associated * with query log. Update or provide a resource policy to grant permissions for the KMS key. *
** Creates a delegation set (a group of four name servers) that can be reused by multiple hosted zones that were * created by the same Amazon Web Services account. *
*
* You can also create a reusable delegation set that uses the four name servers that are associated with an
* existing hosted zone. Specify the hosted zone ID in the CreateReusableDelegationSet request.
*
* You can't associate a reusable delegation set with a private hosted zone. *
** For information about using a reusable delegation set to configure white label name servers, see Configuring White * Label Name Servers. *
** The process for migrating existing hosted zones to use a reusable delegation set is comparable to the process for * configuring white label name servers. You need to perform the following steps: *
** Create a reusable delegation set. *
** Recreate hosted zones, and reduce the TTL to 60 seconds or less. *
** Recreate resource record sets in the new hosted zones. *
** Change the registrar's name servers to use the name servers for the new hosted zones. *
** Monitor traffic for the website or application. *
** Change TTLs back to their original values. *
** If you want to migrate existing hosted zones to use a reusable delegation set, the existing hosted zones can't * use any of the name servers that are assigned to the reusable delegation set. If one or more hosted zones do use * one or more name servers that are assigned to the reusable delegation set, you can do one of the following: *
** For small numbers of hosted zones—up to a few hundred—it's relatively easy to create reusable delegation sets * until you get one that has four name servers that don't overlap with any of the name servers in your hosted * zones. *
** For larger numbers of hosted zones, the easiest solution is to use more than one reusable delegation set. *
** For larger numbers of hosted zones, you can also migrate hosted zones that have overlapping name servers to * hosted zones that don't have overlapping name servers, then migrate the hosted zones again to use the reusable * delegation set. *
** 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). *
* * @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 * The input is not valid. * @throws TooManyTrafficPoliciesException * This traffic policy can't be created because the current account has reached the limit on the number of * traffic policies. ** For information about default limits, see Limits in the * Amazon Route 53 Developer Guide. *
** To get the current limit for an account, see GetAccountLimit. *
*
* To request a higher limit, create a case with the
* Amazon Web Services Support Center.
* @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 not
* valid.
* @sample AmazonRoute53.CreateTrafficPolicy
* @see AWS
* API Documentation
*/
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.
*
* After you submit an CreateTrafficPolicyInstance request, there's a brief delay while Amazon Route 53
* creates the resource record sets that are specified in the traffic policy definition. Use
* GetTrafficPolicyInstance with the id of new traffic policy instance to confirm that the
* CreateTrafficPolicyInstance request completed successfully. For more information, see the
* State response element.
*
* For information about default limits, see Limits in the * Amazon Route 53 Developer Guide. *
** For information about how to get the current limit for an account, see GetAccountLimit. *
** To request a higher limit, create a case with the * Amazon Web Services Support Center. * @throws NoSuchTrafficPolicyException * No traffic policy exists with the specified ID. * @throws TrafficPolicyInstanceAlreadyExistsException * There is already a traffic policy instance with the specified ID. * @sample AmazonRoute53.CreateTrafficPolicyInstance * @see AWS API Documentation */ 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). You can create a maximum of 1000 versions of a * traffic policy. If you reach the limit and need to create another version, you'll need to start a new traffic * policy. *
* * @param createTrafficPolicyVersionRequest * A complex type that contains information about the traffic policy that you want to create a new version * for. * @return Result of the CreateTrafficPolicyVersion operation returned by the service. * @throws NoSuchTrafficPolicyException * No traffic policy exists with the specified ID. * @throws InvalidInputException * The input is not valid. * @throws TooManyTrafficPolicyVersionsForCurrentPolicyException * This traffic policy version can't be created because you've reached the limit of 1000 on the number of * versions that you can create for the current traffic policy. *
* To create more traffic policy versions, you can use GetTrafficPolicy to get the traffic policy document for a specified traffic policy version, and then
* use
* CreateTrafficPolicy to create a new traffic policy using the traffic policy document.
* @throws ConcurrentModificationException
* Another user submitted a request to create, update, or delete 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 not
* valid.
* @sample AmazonRoute53.CreateTrafficPolicyVersion
* @see AWS API Documentation
*/
CreateTrafficPolicyVersionResult createTrafficPolicyVersion(CreateTrafficPolicyVersionRequest createTrafficPolicyVersionRequest);
/**
*
* Authorizes the Amazon Web Services account that created a specified VPC to submit an
* AssociateVPCWithHostedZone request to associate the VPC with a specified hosted zone that was
* created by a different account. To submit a CreateVPCAssociationAuthorization request, you must use
* the account that created the hosted zone. After you authorize the association, use the account that created the
* VPC to submit an AssociateVPCWithHostedZone request.
*
* If you want to associate multiple VPCs that you created by using one account with a hosted zone that you created * by using a different account, you must submit one authorization request for each VPC. *
*DeleteVPCAssociationAuthorization request to remove an existing authorization. To get a list
* of existing authorizations, submit a ListVPCAssociationAuthorizations request.
* @throws NoSuchHostedZoneException
* No hosted zone exists with the ID that you specified.
* @throws InvalidVPCIdException
* The VPC ID that you specified either isn't a valid ID or the current account is not authorized to access
* this VPC.
* @throws InvalidInputException
* The input is not valid.
* @sample AmazonRoute53.CreateVPCAssociationAuthorization
* @see AWS API Documentation
*/
CreateVPCAssociationAuthorizationResult createVPCAssociationAuthorization(CreateVPCAssociationAuthorizationRequest createVPCAssociationAuthorizationRequest);
/**
*
* Deactivates a key-signing key (KSK) so that it will not be used for signing by DNSSEC. This operation changes the
* KSK status to INACTIVE.
*
INTERNAL_FAILURE.
* @throws InvalidSigningStatusException
* Your hosted zone status isn't valid for this operation. In the hosted zone, change the status to enable
* DNSSEC or disable DNSSEC.
* @throws KeySigningKeyInUseException
* The key-signing key (KSK) that you specified can't be deactivated because it's the only KSK for a
* currently-enabled DNSSEC. Disable DNSSEC signing, or add or enable another KSK.
* @throws KeySigningKeyInParentDSRecordException
* The key-signing key (KSK) is specified in a parent DS record.
* @throws InvalidInputException
* The input is not valid.
* @sample AmazonRoute53.DeactivateKeySigningKey
* @see AWS API Documentation
*/
DeactivateKeySigningKeyResult deactivateKeySigningKey(DeactivateKeySigningKeyRequest deactivateKeySigningKeyRequest);
/**
* * Deletes a CIDR collection in the current Amazon Web Services account. The collection must be empty before it can * be deleted. *
* * @param deleteCidrCollectionRequest * @return Result of the DeleteCidrCollection operation returned by the service. * @throws NoSuchCidrCollectionException * The CIDR collection you specified, doesn't exist. * @throws CidrCollectionInUseException * This CIDR collection is in use, and isn't empty. * @throws InvalidInputException * The input is not valid. * @throws ConcurrentModificationException * Another user submitted a request to create, update, or delete the object at the same time that you did. * Retry the request. * @sample AmazonRoute53.DeleteCidrCollection * @see AWS * API Documentation */ DeleteCidrCollectionResult deleteCidrCollection(DeleteCidrCollectionRequest deleteCidrCollectionRequest); /** ** Deletes a health check. *
** Amazon Route 53 does not prevent you from deleting a health check even if the health check is associated with one * or more resource record sets. If you delete a health check and you don't update the associated resource record * sets, the future status of the health check can't be predicted and may change. This will affect the routing of * DNS queries for your DNS failover configuration. For more information, see Replacing and Deleting Health Checks in the Amazon Route 53 Developer Guide. *
*
* If you're using Cloud Map and you configured Cloud Map to create a Route 53 health check when you register an
* instance, you can't use the Route 53 DeleteHealthCheck command to delete the health check. The
* health check is deleted automatically when you deregister the instance; there can be a delay of several hours
* before the health check is deleted from Route 53.
*
* Deletes a hosted zone. *
** If the hosted zone was created by another service, such as Cloud Map, see Deleting Public Hosted Zones That Were Created by Another Service in the Amazon Route 53 Developer * Guide for information about how to delete it. (The process is the same for public and private hosted zones * that were created by another service.) *
** If you want to keep your domain registration but you want to stop routing internet traffic to your website or web * application, we recommend that you delete resource record sets in the hosted zone instead of deleting the hosted * zone. *
** If you delete a hosted zone, you can't undelete it. You must create a new hosted zone and update the name servers * for your domain registration, which can require up to 48 hours to take effect. (If you delegated responsibility * for a subdomain to a hosted zone and you delete the child hosted zone, you must update the name servers in the * parent hosted zone.) In addition, if you delete a hosted zone, someone could hijack the domain and route traffic * to their own resources using your domain name. *
** If you want to avoid the monthly charge for the hosted zone, you can transfer DNS service for the domain to a * free DNS service. When you transfer DNS service, you have to update the name servers for the domain registration. * If the domain is registered with Route 53, see UpdateDomainNameservers for information about how to replace Route 53 name servers with name servers for the * new DNS service. If the domain is registered with another registrar, use the method provided by the registrar to * update name servers for the domain registration. For more information, perform an internet search on * "free DNS service." *
*
* You can delete a hosted zone only if it contains only the default SOA record and NS resource record sets. If the
* hosted zone contains other resource record sets, you must delete them before you can delete the hosted zone. If
* you try to delete a hosted zone that contains other resource record sets, the request fails, and Route 53 returns
* a HostedZoneNotEmpty error. For information about deleting records from your hosted zone, see
* ChangeResourceRecordSets.
*
* To verify that the hosted zone has been deleted, do one of the following: *
*
* Use the GetHostedZone action to request information about the hosted zone.
*
* Use the ListHostedZones action to get a list of the hosted zones associated with the current Amazon
* Web Services account.
*
HTTP 400 error (Bad request).
* If Route 53 returns this error repeatedly for the same request, we recommend that you wait, in intervals
* of increasing duration, before you try the request again.
* @throws InvalidInputException
* The input is not valid.
* @throws InvalidDomainNameException
* The specified domain name is not valid.
* @sample AmazonRoute53.DeleteHostedZone
* @see AWS API
* Documentation
*/
DeleteHostedZoneResult deleteHostedZone(DeleteHostedZoneRequest deleteHostedZoneRequest);
/**
* * Deletes a key-signing key (KSK). Before you can delete a KSK, you must deactivate it. The KSK must be deactivated * before you can delete it regardless of whether the hosted zone is enabled for DNSSEC signing. *
** You can use * DeactivateKeySigningKey to deactivate the key before you delete it. *
*
* Use GetDNSSEC to verify
* that the KSK is in an INACTIVE status.
*
INTERNAL_FAILURE.
* @throws InvalidSigningStatusException
* Your hosted zone status isn't valid for this operation. In the hosted zone, change the status to enable
* DNSSEC or disable DNSSEC.
* @throws InvalidKMSArnException
* The KeyManagementServiceArn that you specified isn't valid to use with DNSSEC signing.
* @throws InvalidInputException
* The input is not valid.
* @sample AmazonRoute53.DeleteKeySigningKey
* @see AWS
* API Documentation
*/
DeleteKeySigningKeyResult deleteKeySigningKey(DeleteKeySigningKeyRequest deleteKeySigningKeyRequest);
/**
* * Deletes a configuration for DNS query logging. If you delete a configuration, Amazon Route 53 stops sending query * logs to CloudWatch Logs. Route 53 doesn't delete any logs that are already in CloudWatch Logs. *
** For more information about DNS query logs, see CreateQueryLoggingConfig. *
* * @param deleteQueryLoggingConfigRequest * @return Result of the DeleteQueryLoggingConfig operation returned by the service. * @throws ConcurrentModificationException * Another user submitted a request to create, update, or delete the object at the same time that you did. * Retry the request. * @throws NoSuchQueryLoggingConfigException * There is no DNS query logging configuration with the specified ID. * @throws InvalidInputException * The input is not valid. * @sample AmazonRoute53.DeleteQueryLoggingConfig * @see AWS API Documentation */ DeleteQueryLoggingConfigResult deleteQueryLoggingConfig(DeleteQueryLoggingConfigRequest deleteQueryLoggingConfigRequest); /** ** Deletes a reusable delegation set. *
** You can delete a reusable delegation set only if it isn't associated with any hosted zones. *
** To verify that the reusable delegation set is not associated with any hosted zones, submit a GetReusableDelegationSet request and specify the ID of the reusable delegation set that you want to delete. *
* * @param deleteReusableDelegationSetRequest * A request to delete a reusable delegation set. * @return Result of the DeleteReusableDelegationSet operation returned by the service. * @throws NoSuchDelegationSetException * A reusable delegation set with the specified ID 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 * A reusable delegation set with the specified ID does not exist. * @throws InvalidInputException * The input is not valid. * @sample AmazonRoute53.DeleteReusableDelegationSet * @see AWS API Documentation */ DeleteReusableDelegationSetResult deleteReusableDelegationSet(DeleteReusableDelegationSetRequest deleteReusableDelegationSetRequest); /** ** Deletes a traffic policy. *
** When you delete a traffic policy, Route 53 sets a flag on the policy to indicate that it has been deleted. * However, Route 53 never fully deletes the traffic policy. Note the following: *
** Deleted traffic policies aren't listed if you run ListTrafficPolicies. *
** There's no way to get a list of deleted policies. *
** If you retain the ID of the policy, you can get information about the policy, including the traffic policy * document, by running GetTrafficPolicy. *
** Deletes a traffic policy instance and all of the resource record sets that Amazon Route 53 created when you * created the instance. *
** In the Route 53 console, traffic policy instances are known as policy records. *
*HTTP 400 error (Bad request).
* If Route 53 returns this error repeatedly for the same request, we recommend that you wait, in intervals
* of increasing duration, before you try the request again.
* @sample AmazonRoute53.DeleteTrafficPolicyInstance
* @see AWS API Documentation
*/
DeleteTrafficPolicyInstanceResult deleteTrafficPolicyInstance(DeleteTrafficPolicyInstanceRequest deleteTrafficPolicyInstanceRequest);
/**
*
* Removes authorization to submit an AssociateVPCWithHostedZone request to associate a specified VPC
* with a hosted zone that was created by a different account. You must use the account that created the hosted zone
* to submit a DeleteVPCAssociationAuthorization request.
*
* Sending this request only prevents the Amazon Web Services account that created the VPC from associating the VPC
* with the Amazon Route 53 hosted zone in the future. If the VPC is already associated with the hosted zone,
* DeleteVPCAssociationAuthorization won't disassociate the VPC from the hosted zone. If you want to
* delete an existing association, use DisassociateVPCFromHostedZone.
*
* Disables DNSSEC signing in a specific hosted zone. This action does not deactivate any key-signing keys (KSKs) * that are active in the hosted zone. *
* * @param disableHostedZoneDNSSECRequest * @return Result of the DisableHostedZoneDNSSEC operation returned by the service. * @throws NoSuchHostedZoneException * No hosted zone exists with the ID that you specified. * @throws InvalidArgumentException * Parameter name is not valid. * @throws ConcurrentModificationException * Another user submitted a request to create, update, or delete the object at the same time that you did. * Retry the request. * @throws KeySigningKeyInParentDSRecordException * The key-signing key (KSK) is specified in a parent DS record. * @throws DNSSECNotFoundException * The hosted zone doesn't have any DNSSEC resources. * @throws InvalidKeySigningKeyStatusException * The key-signing key (KSK) status isn't valid or another KSK has the statusINTERNAL_FAILURE.
* @throws InvalidKMSArnException
* The KeyManagementServiceArn that you specified isn't valid to use with DNSSEC signing.
* @throws InvalidInputException
* The input is not valid.
* @sample AmazonRoute53.DisableHostedZoneDNSSEC
* @see AWS API Documentation
*/
DisableHostedZoneDNSSECResult disableHostedZoneDNSSEC(DisableHostedZoneDNSSECRequest disableHostedZoneDNSSECRequest);
/**
* * Disassociates an Amazon Virtual Private Cloud (Amazon VPC) from an Amazon Route 53 private hosted zone. Note the * following: *
** You can't disassociate the last Amazon VPC from a private hosted zone. *
** You can't convert a private hosted zone into a public hosted zone. *
*
* You can submit a DisassociateVPCFromHostedZone request using either the account that created the
* hosted zone or the account that created the Amazon VPC.
*
* Some services, such as Cloud Map and Amazon Elastic File System (Amazon EFS) automatically create hosted zones * and associate VPCs with the hosted zones. A service can create a hosted zone using your account or using its own * account. You can disassociate a VPC from a hosted zone only if the service created the hosted zone using your * account. *
*
* When you run
* DisassociateVPCFromHostedZone, if the hosted zone has a value for OwningAccount, you can use
* DisassociateVPCFromHostedZone. If the hosted zone has a value for OwningService, you
* can't use DisassociateVPCFromHostedZone.
*
* When revoking access, the hosted zone and the Amazon VPC must belong to the same partition. A partition is a * group of Amazon Web Services Regions. Each Amazon Web Services account is scoped to one partition. *
** The following are the supported partitions: *
*
* aws - Amazon Web Services Regions
*
* aws-cn - China Regions
*
* aws-us-gov - Amazon Web Services GovCloud (US) Region
*
* For more information, see Access Management in the * Amazon Web Services General Reference. *
** Enables DNSSEC signing in a specific hosted zone. *
* * @param enableHostedZoneDNSSECRequest * @return Result of the EnableHostedZoneDNSSEC operation returned by the service. * @throws NoSuchHostedZoneException * No hosted zone exists with the ID that you specified. * @throws InvalidArgumentException * Parameter name is not valid. * @throws ConcurrentModificationException * Another user submitted a request to create, update, or delete the object at the same time that you did. * Retry the request. * @throws KeySigningKeyWithActiveStatusNotFoundException * A key-signing key (KSK) withACTIVE status wasn't found.
* @throws InvalidKMSArnException
* The KeyManagementServiceArn that you specified isn't valid to use with DNSSEC signing.
* @throws HostedZonePartiallyDelegatedException
* The hosted zone nameservers don't match the parent nameservers. The hosted zone and parent must have the
* same nameservers.
* @throws DNSSECNotFoundException
* The hosted zone doesn't have any DNSSEC resources.
* @throws InvalidKeySigningKeyStatusException
* The key-signing key (KSK) status isn't valid or another KSK has the status INTERNAL_FAILURE.
* @throws InvalidInputException
* The input is not valid.
* @sample AmazonRoute53.EnableHostedZoneDNSSEC
* @see AWS
* API Documentation
*/
EnableHostedZoneDNSSECResult enableHostedZoneDNSSEC(EnableHostedZoneDNSSECRequest enableHostedZoneDNSSECRequest);
/**
* * Gets the specified limit for the current account, for example, the maximum number of health checks that you can * create using the account. *
** For the default limit, see Limits in the Amazon * Route 53 Developer Guide. To request a higher limit, open a case. *
** You can also view account limits in Amazon Web Services Trusted Advisor. Sign in to the Amazon Web Services * Management Console and open the Trusted Advisor console at https://console.aws.amazon.com/trustedadvisor/. Then * choose Service limits in the navigation pane. *
** 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 propagated to all Amazon Route 53 DNS
* servers managing the hosted zone. This is the initial status of all change batch requests.
*
* INSYNC indicates that the changes have propagated to all Route 53 DNS servers managing the hosted
* zone.
*
* Route 53 does not perform authorization for this API because it retrieves information that is already available * to the public. *
*
* GetCheckerIpRanges still works, but we recommend that you download ip-ranges.json, which includes IP
* address ranges for all Amazon Web Services services. For more information, see IP Address Ranges of
* Amazon Route 53 Servers in the Amazon Route 53 Developer Guide.
*
* Returns information about DNSSEC for a specific hosted zone, including the key-signing keys (KSKs) in the hosted * zone. *
* * @param getDNSSECRequest * @return Result of the GetDNSSEC operation returned by the service. * @throws NoSuchHostedZoneException * No hosted zone exists with the ID that you specified. * @throws InvalidArgumentException * Parameter name is not valid. * @throws InvalidInputException * The input is not valid. * @sample AmazonRoute53.GetDNSSEC * @see AWS API * Documentation */ GetDNSSECResult getDNSSEC(GetDNSSECRequest getDNSSECRequest); /** ** Gets information about whether a specified geographic location is supported for Amazon Route 53 geolocation * resource record sets. *
** Route 53 does not perform authorization for this API because it retrieves information that is already available * to the public. *
** Use the following syntax to determine whether a continent is supported for geolocation: *
*
* GET /2013-04-01/geolocation?continentcode=two-letter abbreviation for a continent
*
* Use the following syntax to determine whether a country is supported for geolocation: *
*
* GET /2013-04-01/geolocation?countrycode=two-character country code
*
* Use the following syntax to determine whether a subdivision of a country is supported for geolocation: *
*
* GET /2013-04-01/geolocation?countrycode=two-character country code&subdivisioncode=subdivision code
*
* Gets information about a specified health check. *
* * @param getHealthCheckRequest * A request to get information about a specified health check. * @return Result of the GetHealthCheck operation returned by the service. * @throws NoSuchHealthCheckException * No health check exists with the specified ID. * @throws InvalidInputException * The input is not valid. * @throws IncompatibleVersionException * The resource you're trying to access is unsupported on this Amazon Route 53 endpoint. * @sample AmazonRoute53.GetHealthCheck * @see AWS API * Documentation */ GetHealthCheckResult getHealthCheck(GetHealthCheckRequest getHealthCheckRequest); /** ** Retrieves the number of health checks that are associated with the current Amazon Web Services account. *
* * @param getHealthCheckCountRequest * A request for the number of health checks that are associated with the current Amazon Web Services * account. * @return Result of the GetHealthCheckCount operation returned by the service. * @sample AmazonRoute53.GetHealthCheckCount * @see AWS * API Documentation */ GetHealthCheckCountResult getHealthCheckCount(GetHealthCheckCountRequest getHealthCheckCountRequest); /** * Simplified method form for invoking the GetHealthCheckCount operation. * * @see #getHealthCheckCount(GetHealthCheckCountRequest) */ GetHealthCheckCountResult getHealthCheckCount(); /** ** Gets the reason that a specified health check failed most recently. *
* * @param getHealthCheckLastFailureReasonRequest * A request for the reason that a health check failed most recently. * @return Result of the GetHealthCheckLastFailureReason operation returned by the service. * @throws NoSuchHealthCheckException * No health check exists with the specified ID. * @throws InvalidInputException * The input is not valid. * @sample AmazonRoute53.GetHealthCheckLastFailureReason * @see AWS API Documentation */ GetHealthCheckLastFailureReasonResult getHealthCheckLastFailureReason(GetHealthCheckLastFailureReasonRequest getHealthCheckLastFailureReasonRequest); /** ** Gets status of a specified health check. *
** This API is intended for use during development to diagnose behavior. It doesn’t support production use-cases * with high query rates that require immediate and actionable responses. *
** Gets information about a specified hosted zone including the four name servers assigned to the hosted zone. *
* * @param getHostedZoneRequest * A request to get information about a specified hosted zone. * @return Result of the GetHostedZone operation returned by the service. * @throws NoSuchHostedZoneException * No hosted zone exists with the ID that you specified. * @throws InvalidInputException * The input is not valid. * @sample AmazonRoute53.GetHostedZone * @see AWS API * Documentation */ GetHostedZoneResult getHostedZone(GetHostedZoneRequest getHostedZoneRequest); /** ** Retrieves the number of hosted zones that are associated with the current Amazon Web Services account. *
* * @param getHostedZoneCountRequest * A request to retrieve a count of all the hosted zones that are associated with the current Amazon Web * Services account. * @return Result of the GetHostedZoneCount operation returned by the service. * @throws InvalidInputException * The input is not valid. * @sample AmazonRoute53.GetHostedZoneCount * @see AWS API * Documentation */ GetHostedZoneCountResult getHostedZoneCount(GetHostedZoneCountRequest getHostedZoneCountRequest); /** * Simplified method form for invoking the GetHostedZoneCount operation. * * @see #getHostedZoneCount(GetHostedZoneCountRequest) */ GetHostedZoneCountResult getHostedZoneCount(); /** ** Gets the specified limit for a specified hosted zone, for example, the maximum number of records that you can * create in the hosted zone. *
** For the default limit, see Limits in the Amazon * Route 53 Developer Guide. To request a higher limit, open a case. *
* * @param getHostedZoneLimitRequest * A complex type that contains information about the request to create a hosted zone. * @return Result of the GetHostedZoneLimit operation returned by the service. * @throws NoSuchHostedZoneException * No hosted zone exists with the ID that you specified. * @throws InvalidInputException * The input is not valid. * @throws HostedZoneNotPrivateException * The specified hosted zone is a public hosted zone, not a private hosted zone. * @sample AmazonRoute53.GetHostedZoneLimit * @see AWS API * Documentation */ GetHostedZoneLimitResult getHostedZoneLimit(GetHostedZoneLimitRequest getHostedZoneLimitRequest); /** ** Gets information about a specified configuration for DNS query logging. *
** For more information about DNS query logs, see CreateQueryLoggingConfig and Logging DNS Queries. *
* * @param getQueryLoggingConfigRequest * @return Result of the GetQueryLoggingConfig operation returned by the service. * @throws NoSuchQueryLoggingConfigException * There is no DNS query logging configuration with the specified ID. * @throws InvalidInputException * The input is not valid. * @sample AmazonRoute53.GetQueryLoggingConfig * @see AWS * API Documentation */ GetQueryLoggingConfigResult getQueryLoggingConfig(GetQueryLoggingConfigRequest getQueryLoggingConfigRequest); /** ** Retrieves information about a specified reusable delegation set, including the four name servers that are * assigned to the delegation set. *
* * @param getReusableDelegationSetRequest * A request to get information about a specified reusable delegation set. * @return Result of the GetReusableDelegationSet operation returned by the service. * @throws NoSuchDelegationSetException * A reusable delegation set with the specified ID does not exist. * @throws DelegationSetNotReusableException * A reusable delegation set with the specified ID does not exist. * @throws InvalidInputException * The input is not valid. * @sample AmazonRoute53.GetReusableDelegationSet * @see AWS API Documentation */ GetReusableDelegationSetResult getReusableDelegationSet(GetReusableDelegationSetRequest getReusableDelegationSetRequest); /** ** Gets the maximum number of hosted zones that you can associate with the specified reusable delegation set. *
** For the default limit, see Limits in the Amazon * Route 53 Developer Guide. To request a higher limit, open a case. *
* * @param getReusableDelegationSetLimitRequest * A complex type that contains information about the request to create a hosted zone. * @return Result of the GetReusableDelegationSetLimit operation returned by the service. * @throws InvalidInputException * The input is not valid. * @throws NoSuchDelegationSetException * A reusable delegation set with the specified ID does not exist. * @sample AmazonRoute53.GetReusableDelegationSetLimit * @see AWS API Documentation */ GetReusableDelegationSetLimitResult getReusableDelegationSetLimit(GetReusableDelegationSetLimitRequest getReusableDelegationSetLimitRequest); /** ** Gets information about a specific traffic policy version. *
*
* For information about how of deleting a traffic policy affects the response from GetTrafficPolicy,
* see DeleteTrafficPolicy
* .
*
* Gets information about a specified traffic policy instance. *
*
* Use GetTrafficPolicyInstance with the id of new traffic policy instance to confirm that
* the CreateTrafficPolicyInstance or an UpdateTrafficPolicyInstance request completed
* successfully. For more information, see the State response element.
*
* In the Route 53 console, traffic policy instances are known as policy records. *
** Gets the number of traffic policy instances that are associated with the current Amazon Web Services account. *
* * @param getTrafficPolicyInstanceCountRequest * Request to get the number of traffic policy instances that are associated with the current Amazon Web * Services account. * @return Result of the GetTrafficPolicyInstanceCount operation returned by the service. * @sample AmazonRoute53.GetTrafficPolicyInstanceCount * @see AWS API Documentation */ GetTrafficPolicyInstanceCountResult getTrafficPolicyInstanceCount(GetTrafficPolicyInstanceCountRequest getTrafficPolicyInstanceCountRequest); /** * Simplified method form for invoking the GetTrafficPolicyInstanceCount operation. * * @see #getTrafficPolicyInstanceCount(GetTrafficPolicyInstanceCountRequest) */ GetTrafficPolicyInstanceCountResult getTrafficPolicyInstanceCount(); /** ** Returns a paginated list of location objects and their CIDR blocks. *
* * @param listCidrBlocksRequest * @return Result of the ListCidrBlocks operation returned by the service. * @throws NoSuchCidrCollectionException * The CIDR collection you specified, doesn't exist. * @throws NoSuchCidrLocationException * The CIDR collection location doesn't match any locations in your account. * @throws InvalidInputException * The input is not valid. * @sample AmazonRoute53.ListCidrBlocks * @see AWS API * Documentation */ ListCidrBlocksResult listCidrBlocks(ListCidrBlocksRequest listCidrBlocksRequest); /** ** Returns a paginated list of CIDR collections in the Amazon Web Services account (metadata only). *
* * @param listCidrCollectionsRequest * @return Result of the ListCidrCollections operation returned by the service. * @throws InvalidInputException * The input is not valid. * @sample AmazonRoute53.ListCidrCollections * @see AWS * API Documentation */ ListCidrCollectionsResult listCidrCollections(ListCidrCollectionsRequest listCidrCollectionsRequest); /** ** Returns a paginated list of CIDR locations for the given collection (metadata only, does not include CIDR * blocks). *
* * @param listCidrLocationsRequest * @return Result of the ListCidrLocations operation returned by the service. * @throws NoSuchCidrCollectionException * The CIDR collection you specified, doesn't exist. * @throws InvalidInputException * The input is not valid. * @sample AmazonRoute53.ListCidrLocations * @see AWS API * Documentation */ ListCidrLocationsResult listCidrLocations(ListCidrLocationsRequest listCidrLocationsRequest); /** ** Retrieves a list of supported geographic locations. *
** Countries are listed first, and continents are listed last. If Amazon Route 53 supports subdivisions for a * country (for example, states or provinces), the subdivisions for that country are listed in alphabetical order * immediately after the corresponding country. *
** Route 53 does not perform authorization for this API because it retrieves information that is already available * to the public. *
** For a list of supported geolocation codes, see the GeoLocation data type. *
* * @param listGeoLocationsRequest * A request to get a list of geographic locations that Amazon Route 53 supports for geolocation resource * record sets. * @return Result of the ListGeoLocations operation returned by the service. * @throws InvalidInputException * The input is not valid. * @sample AmazonRoute53.ListGeoLocations * @see AWS API * Documentation */ ListGeoLocationsResult listGeoLocations(ListGeoLocationsRequest listGeoLocationsRequest); /** * Simplified method form for invoking the ListGeoLocations operation. * * @see #listGeoLocations(ListGeoLocationsRequest) */ ListGeoLocationsResult listGeoLocations(); /** ** Retrieve a list of the health checks that are associated with the current Amazon Web Services account. *
* * @param listHealthChecksRequest * A request to retrieve a list of the health checks that are associated with the current Amazon Web Services * account. * @return Result of the ListHealthChecks operation returned by the service. * @throws InvalidInputException * The input is not valid. * @throws IncompatibleVersionException * The resource you're trying to access is unsupported on this Amazon Route 53 endpoint. * @sample AmazonRoute53.ListHealthChecks * @see AWS API * Documentation */ ListHealthChecksResult listHealthChecks(ListHealthChecksRequest listHealthChecksRequest); /** * Simplified method form for invoking the ListHealthChecks operation. * * @see #listHealthChecks(ListHealthChecksRequest) */ ListHealthChecksResult listHealthChecks(); /** *
* Retrieves a list of the public and private hosted zones that are associated with the current Amazon Web Services
* account. The response includes a HostedZones child element for each hosted zone.
*
* Amazon Route 53 returns a maximum of 100 items in each response. If you have a lot of hosted zones, you can use
* the maxitems parameter to list them in groups of up to 100.
*
* Retrieves a list of your hosted zones in lexicographic order. The response includes a HostedZones
* child element for each hosted zone created by the current Amazon Web Services account.
*
* ListHostedZonesByName sorts hosted zones by name with the labels reversed. For example:
*
* com.example.www.
*
* Note the trailing dot, which can change the sort order in some circumstances. *
*
* If the domain name includes escape characters or Punycode, ListHostedZonesByName alphabetizes the
* domain name using the escaped or Punycoded value, which is the format that Amazon Route 53 saves in its database.
* For example, to create a hosted zone for exämple.com, you specify ex\344mple.com for the domain name.
* ListHostedZonesByName alphabetizes it as:
*
* com.ex\344mple.
*
* The labels are reversed and alphabetized using the escaped value. For more information about valid domain name * formats, including internationalized domain names, see DNS Domain Name Format * in the Amazon Route 53 Developer Guide. *
*
* Route 53 returns up to 100 items in each response. If you have a lot of hosted zones, use the
* MaxItems parameter to list them in groups of up to 100. The response includes values that help
* navigate from one group of MaxItems hosted zones to the next:
*
* The DNSName and HostedZoneId elements in the response contain the values, if any,
* specified for the dnsname and hostedzoneid parameters in the request that produced the
* current response.
*
* The MaxItems element in the response contains the value, if any, that you specified for the
* maxitems parameter in the request that produced the current response.
*
* If the value of IsTruncated in the response is true, there are more hosted zones associated with the
* current Amazon Web Services account.
*
* If IsTruncated is false, this response includes the last hosted zone that is associated with the
* current account. The NextDNSName element and NextHostedZoneId elements are omitted from
* the response.
*
* The NextDNSName and NextHostedZoneId elements in the response contain the domain name
* and the hosted zone ID of the next hosted zone that is associated with the current Amazon Web Services account.
* If you want to list more hosted zones, make another call to ListHostedZonesByName, and specify the
* value of NextDNSName and NextHostedZoneId in the dnsname and
* hostedzoneid parameters, respectively.
*
* Lists all the private hosted zones that a specified VPC is associated with, regardless of which Amazon Web
* Services account or Amazon Web Services service owns the hosted zones. The HostedZoneOwner structure
* in the response contains one of the following values:
*
* An OwningAccount element, which contains the account number of either the current Amazon Web
* Services account or another Amazon Web Services account. Some services, such as Cloud Map, create hosted zones
* using the current account.
*
* An OwningService element, which identifies the Amazon Web Services service that created and owns the
* hosted zone. For example, if a hosted zone was created by Amazon Elastic File System (Amazon EFS), the value of
* Owner is efs.amazonaws.com.
*
* When listing private hosted zones, the hosted zone and the Amazon VPC must belong to the same partition where the * hosted zones were created. A partition is a group of Amazon Web Services Regions. Each Amazon Web Services * account is scoped to one partition. *
** The following are the supported partitions: *
*
* aws - Amazon Web Services Regions
*
* aws-cn - China Regions
*
* aws-us-gov - Amazon Web Services GovCloud (US) Region
*
* For more information, see Access Management in the * Amazon Web Services General Reference. *
** Lists the configurations for DNS query logging that are associated with the current Amazon Web Services account * or the configuration that is associated with a specified hosted zone. *
** For more information about DNS query logs, see CreateQueryLoggingConfig. Additional information, including the format of DNS query logs, appears in Logging DNS Queries in the * Amazon Route 53 Developer Guide. *
* * @param listQueryLoggingConfigsRequest * @return Result of the ListQueryLoggingConfigs operation returned by the service. * @throws InvalidInputException * The input is not valid. * @throws InvalidPaginationTokenException * The value that you specified to get the second or subsequent page of results is invalid. * @throws NoSuchHostedZoneException * No hosted zone exists with the ID that you specified. * @sample AmazonRoute53.ListQueryLoggingConfigs * @see AWS API Documentation */ ListQueryLoggingConfigsResult listQueryLoggingConfigs(ListQueryLoggingConfigsRequest listQueryLoggingConfigsRequest); /** ** Lists the resource record sets in a specified hosted zone. *
*
* ListResourceRecordSets returns up to 300 resource record sets at a time in ASCII order, beginning at
* a position specified by the name and type elements.
*
* Sort order *
*
* ListResourceRecordSets 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 when the record name contains characters that appear
* before . (decimal 46) in the ASCII table. These characters include the following:
* ! " # $ % & ' ( ) * + , -
*
* When multiple records have the same DNS name, ListResourceRecordSets sorts results by the record
* type.
*
* Specifying where to start listing records *
** You can use the name and type elements to specify the resource record set that the list begins with: *
** The results begin with the first resource record set that the hosted zone contains. *
*
* The results begin with the first resource record set in the list whose name is greater than or equal to
* Name.
*
* Amazon Route 53 returns the InvalidInput error.
*
* 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.
*
* Resource record sets that are PENDING *
*
* This action returns the most current version of the records. This includes records that are PENDING,
* and that are not yet available on all Route 53 DNS servers.
*
* Changing resource record sets *
*
* 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're 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.
*
* Displaying the next page of results *
*
* If a ListResourceRecordSets command returns more than one page of results, the value of
* IsTruncated is true. To display the next page of results, get the values of
* NextRecordName, NextRecordType, and NextRecordIdentifier (if any) from the
* response. Then submit another ListResourceRecordSets request, and specify those values for
* StartRecordName, StartRecordType, and StartRecordIdentifier.
*
* Retrieves a list of the reusable delegation sets that are associated with the current Amazon Web Services * account. *
* * @param listReusableDelegationSetsRequest * A request to get a list of the reusable delegation sets that are associated with the current Amazon Web * Services account. * @return Result of the ListReusableDelegationSets operation returned by the service. * @throws InvalidInputException * The input is not valid. * @sample AmazonRoute53.ListReusableDelegationSets * @see AWS API Documentation */ ListReusableDelegationSetsResult listReusableDelegationSets(ListReusableDelegationSetsRequest listReusableDelegationSetsRequest); /** * Simplified method form for invoking the ListReusableDelegationSets operation. * * @see #listReusableDelegationSets(ListReusableDelegationSetsRequest) */ ListReusableDelegationSetsResult listReusableDelegationSets(); /** ** Lists tags for one health check or hosted zone. *
** For information about using tags for cost allocation, see Using Cost Allocation * Tags in the Billing and Cost Management User Guide. *
* * @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 * The input is not valid. * @throws NoSuchHealthCheckException * No health check exists with the specified ID. * @throws NoSuchHostedZoneException * No hosted zone exists with the ID that you specified. * @throws PriorRequestNotCompleteException * If Amazon Route 53 can't process a request before the next request arrives, it will reject subsequent * requests for the same hosted zone and return anHTTP 400 error (Bad request).
* If Route 53 returns this error repeatedly for the same request, we recommend that you wait, in intervals
* of increasing duration, before you try the request again.
* @throws ThrottlingException
* The limit on the number of requests per second was exceeded.
* @sample AmazonRoute53.ListTagsForResource
* @see AWS
* API Documentation
*/
ListTagsForResourceResult listTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest);
/**
* * Lists tags for up to 10 health checks or hosted zones. *
** For information about using tags for cost allocation, see Using Cost Allocation * Tags in the Billing and Cost Management User Guide. *
* * @param listTagsForResourcesRequest * A complex type that contains information about the health checks or hosted zones for which you want to * list tags. * @return Result of the ListTagsForResources operation returned by the service. * @throws InvalidInputException * The input is not valid. * @throws NoSuchHealthCheckException * No health check exists with the specified ID. * @throws NoSuchHostedZoneException * No hosted zone exists with the ID that you specified. * @throws PriorRequestNotCompleteException * If Amazon Route 53 can't process a request before the next request arrives, it will reject subsequent * requests for the same hosted zone and return anHTTP 400 error (Bad request).
* If Route 53 returns this error repeatedly for the same request, we recommend that you wait, in intervals
* of increasing duration, before you try the request again.
* @throws ThrottlingException
* The limit on the number of requests per second was exceeded.
* @sample AmazonRoute53.ListTagsForResources
* @see AWS
* API Documentation
*/
ListTagsForResourcesResult listTagsForResources(ListTagsForResourcesRequest listTagsForResourcesRequest);
/**
* * Gets information about the latest version for every traffic policy that is associated with the current Amazon Web * Services account. Policies are listed in the order that they were created in. *
*
* For information about how of deleting a traffic policy affects the response from ListTrafficPolicies
* , see DeleteTrafficPolicy
* .
*
* Gets information about the traffic policy instances that you created by using the current Amazon Web Services * 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.
*
* 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.
*
* Gets information about the traffic policy instances that you created in a specified hosted zone. *
*
* 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.
*
* 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.
*
* 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.
*
* 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.
*
* Gets information about all of the versions for a specified traffic policy. *
*
* Traffic policy versions are listed in numerical order by VersionNumber.
*
* Gets a list of the VPCs that were created by other accounts and that can be associated with a specified hosted
* zone because you've submitted one or more CreateVPCAssociationAuthorization requests.
*
* The response includes a VPCs element with a VPC child element for each VPC that can be
* associated with the hosted zone.
*
* Gets the value that Amazon Route 53 returns in response to a DNS request for a specified record name and type. * You can optionally specify the IP address of a DNS resolver, an EDNS0 client subnet IP address, and a subnet * mask. *
** This call only supports querying public hosted zones. *
*
* The TestDnsAnswer returns information similar to what you would expect from the answer section of
* the dig command. Therefore, if you query for the name servers of a subdomain that point to the
* parent name servers, those will not be returned.
*
* Updates an existing health check. Note that some values can't be updated. *
** For more information about updating health checks, see Creating, * Updating, and Deleting Health Checks in the Amazon Route 53 Developer Guide. *
* * @param updateHealthCheckRequest * A complex type that contains information about a request to update a health check. * @return Result of the UpdateHealthCheck operation returned by the service. * @throws NoSuchHealthCheckException * No health check exists with the specified ID. * @throws InvalidInputException * The input is not valid. * @throws HealthCheckVersionMismatchException * The value ofHealthCheckVersion in the request doesn't match the value of
* HealthCheckVersion in the health check.
* @sample AmazonRoute53.UpdateHealthCheck
* @see AWS API
* Documentation
*/
UpdateHealthCheckResult updateHealthCheck(UpdateHealthCheckRequest updateHealthCheckRequest);
/**
* * Updates the comment for a specified hosted zone. *
* * @param updateHostedZoneCommentRequest * A request to update the comment for a hosted zone. * @return Result of the UpdateHostedZoneComment operation returned by the service. * @throws NoSuchHostedZoneException * No hosted zone exists with the ID that you specified. * @throws InvalidInputException * The input is not valid. * @throws PriorRequestNotCompleteException * If Amazon Route 53 can't process a request before the next request arrives, it will reject subsequent * requests for the same hosted zone and return anHTTP 400 error (Bad request).
* If Route 53 returns this error repeatedly for the same request, we recommend that you wait, in intervals
* of increasing duration, before you try the request again.
* @sample AmazonRoute53.UpdateHostedZoneComment
* @see AWS API Documentation
*/
UpdateHostedZoneCommentResult updateHostedZoneComment(UpdateHostedZoneCommentRequest updateHostedZoneCommentRequest);
/**
* * Updates the comment for a specified traffic policy version. *
* * @param updateTrafficPolicyCommentRequest * A complex type that contains information about the traffic policy that you want to update the comment for. * @return Result of the UpdateTrafficPolicyComment operation returned by the service. * @throws InvalidInputException * The input is not valid. * @throws NoSuchTrafficPolicyException * No traffic policy exists with the specified ID. * @throws ConcurrentModificationException * Another user submitted a request to create, update, or delete the object at the same time that you did. * Retry the request. * @sample AmazonRoute53.UpdateTrafficPolicyComment * @see AWS API Documentation */ UpdateTrafficPolicyCommentResult updateTrafficPolicyComment(UpdateTrafficPolicyCommentRequest updateTrafficPolicyCommentRequest); /** *
* After you submit a UpdateTrafficPolicyInstance request, there's a brief delay while Route 53 creates
* the resource record sets that are specified in the traffic policy definition. Use
* GetTrafficPolicyInstance with the id of updated traffic policy instance confirm that
* the UpdateTrafficPolicyInstance request completed successfully. For more information, see the
* State response element.
*
* 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. * Route 53 performs the following operations: *
** Route 53 creates a new group of resource record sets based on the specified traffic policy. This is true * regardless of how significant 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, 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. *
** Route 53 deletes the old group of resource record sets that are associated with the root resource record set * name. *
*HTTP 400 error (Bad request).
* If Route 53 returns this error repeatedly for the same request, we recommend that you wait, in intervals
* of increasing duration, before you try the request again.
* @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
* @see AWS API Documentation
*/
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); AmazonRoute53Waiters waiters(); }