@ThreadSafe @Generated(value="com.amazonaws:aws-java-sdk-code-generator") public class AmazonRoute53DomainsClient extends AmazonWebServiceClient implements AmazonRoute53Domains
Amazon Route 53 API actions let you register domain names and perform related operations.
LOGGING_AWS_REQUEST_METRIC
ENDPOINT_PREFIX
Constructor and Description |
---|
AmazonRoute53DomainsClient()
Deprecated.
|
AmazonRoute53DomainsClient(AWSCredentials awsCredentials)
Deprecated.
use
AwsClientBuilder.withCredentials(AWSCredentialsProvider) for example:
AmazonRoute53DomainsClientBuilder.standard().withCredentials(new AWSStaticCredentialsProvider(awsCredentials)).build(); |
AmazonRoute53DomainsClient(AWSCredentials awsCredentials,
ClientConfiguration clientConfiguration)
|
AmazonRoute53DomainsClient(AWSCredentialsProvider awsCredentialsProvider)
Deprecated.
|
AmazonRoute53DomainsClient(AWSCredentialsProvider awsCredentialsProvider,
ClientConfiguration clientConfiguration)
|
AmazonRoute53DomainsClient(AWSCredentialsProvider awsCredentialsProvider,
ClientConfiguration clientConfiguration,
RequestMetricCollector requestMetricCollector)
|
AmazonRoute53DomainsClient(ClientConfiguration clientConfiguration)
Deprecated.
|
Modifier and Type | Method and Description |
---|---|
AcceptDomainTransferFromAnotherAwsAccountResult |
acceptDomainTransferFromAnotherAwsAccount(AcceptDomainTransferFromAnotherAwsAccountRequest request)
Accepts the transfer of a domain from another AWS account to the current AWS account.
|
static AmazonRoute53DomainsClientBuilder |
builder() |
CancelDomainTransferToAnotherAwsAccountResult |
cancelDomainTransferToAnotherAwsAccount(CancelDomainTransferToAnotherAwsAccountRequest request)
Cancels the transfer of a domain from the current AWS account to another AWS account.
|
CheckDomainAvailabilityResult |
checkDomainAvailability(CheckDomainAvailabilityRequest request)
This operation checks the availability of one domain name.
|
CheckDomainTransferabilityResult |
checkDomainTransferability(CheckDomainTransferabilityRequest request)
Checks whether a domain name can be transferred to Amazon Route 53.
|
DeleteTagsForDomainResult |
deleteTagsForDomain(DeleteTagsForDomainRequest request)
This operation deletes the specified tags for a domain.
|
DisableDomainAutoRenewResult |
disableDomainAutoRenew(DisableDomainAutoRenewRequest request)
This operation disables automatic renewal of domain registration for the specified domain.
|
DisableDomainTransferLockResult |
disableDomainTransferLock(DisableDomainTransferLockRequest request)
This operation removes the transfer lock on the domain (specifically the
clientTransferProhibited
status) to allow domain transfers. |
EnableDomainAutoRenewResult |
enableDomainAutoRenew(EnableDomainAutoRenewRequest request)
This operation configures Amazon Route 53 to automatically renew the specified domain before the domain
registration expires.
|
EnableDomainTransferLockResult |
enableDomainTransferLock(EnableDomainTransferLockRequest request)
This operation sets the transfer lock on the domain (specifically the
clientTransferProhibited
status) to prevent domain transfers. |
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.
|
GetContactReachabilityStatusResult |
getContactReachabilityStatus(GetContactReachabilityStatusRequest request)
For operations that require confirmation that the email address for the registrant contact is valid, such as
registering a new domain, this operation returns information about whether the registrant contact has responded.
|
GetDomainDetailResult |
getDomainDetail(GetDomainDetailRequest request)
This operation returns detailed information about a specified domain that is associated with the current AWS
account.
|
GetDomainSuggestionsResult |
getDomainSuggestions(GetDomainSuggestionsRequest request)
The GetDomainSuggestions operation returns a list of suggested domain names.
|
GetOperationDetailResult |
getOperationDetail(GetOperationDetailRequest request)
This operation returns the current status of an operation that is not completed.
|
ListDomainsResult |
listDomains()
Simplified method form for invoking the ListDomains operation.
|
ListDomainsResult |
listDomains(ListDomainsRequest request)
This operation returns all the domain names registered with Amazon Route 53 for the current AWS account.
|
ListOperationsResult |
listOperations()
Simplified method form for invoking the ListOperations operation.
|
ListOperationsResult |
listOperations(ListOperationsRequest request)
Returns information about all of the operations that return an operation ID and that have ever been performed on
domains that were registered by the current account.
|
ListTagsForDomainResult |
listTagsForDomain(ListTagsForDomainRequest request)
This operation returns all of the tags that are associated with the specified domain.
|
RegisterDomainResult |
registerDomain(RegisterDomainRequest request)
This operation registers a domain.
|
RejectDomainTransferFromAnotherAwsAccountResult |
rejectDomainTransferFromAnotherAwsAccount(RejectDomainTransferFromAnotherAwsAccountRequest request)
Rejects the transfer of a domain from another AWS account to the current AWS account.
|
RenewDomainResult |
renewDomain(RenewDomainRequest request)
This operation renews a domain for the specified number of years.
|
ResendContactReachabilityEmailResult |
resendContactReachabilityEmail(ResendContactReachabilityEmailRequest request)
For operations that require confirmation that the email address for the registrant contact is valid, such as
registering a new domain, this operation resends the confirmation email to the current email address for the
registrant contact.
|
RetrieveDomainAuthCodeResult |
retrieveDomainAuthCode(RetrieveDomainAuthCodeRequest request)
This operation returns the AuthCode for the domain.
|
void |
shutdown()
Shuts down this client object, releasing any resources that might be held
open.
|
TransferDomainResult |
transferDomain(TransferDomainRequest request)
Transfers a domain from another registrar to Amazon Route 53.
|
TransferDomainToAnotherAwsAccountResult |
transferDomainToAnotherAwsAccount(TransferDomainToAnotherAwsAccountRequest request)
Transfers a domain from the current AWS account to another AWS account.
|
UpdateDomainContactResult |
updateDomainContact(UpdateDomainContactRequest request)
This operation updates the contact information for a particular domain.
|
UpdateDomainContactPrivacyResult |
updateDomainContactPrivacy(UpdateDomainContactPrivacyRequest request)
This operation updates the specified domain contact's privacy setting.
|
UpdateDomainNameserversResult |
updateDomainNameservers(UpdateDomainNameserversRequest request)
This operation replaces the current set of name servers for the domain with the specified set of name servers.
|
UpdateTagsForDomainResult |
updateTagsForDomain(UpdateTagsForDomainRequest request)
This operation adds or updates tags for a specified domain.
|
ViewBillingResult |
viewBilling(ViewBillingRequest request)
Returns all the domain-related billing records for the current AWS account for a specified period
|
addRequestHandler, addRequestHandler, configureRegion, getClientConfiguration, getEndpointPrefix, getMonitoringListeners, getRequestMetricsCollector, getServiceName, getSignerByURI, getSignerOverride, getSignerRegionOverride, getTimeOffset, makeImmutable, removeRequestHandler, removeRequestHandler, setEndpoint, setEndpoint, setRegion, setServiceNameIntern, setSignerRegionOverride, setTimeOffset, withEndpoint, withRegion, withRegion, withTimeOffset
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
setEndpoint, setRegion
@Deprecated public AmazonRoute53DomainsClient()
AmazonRoute53DomainsClientBuilder.defaultClient()
All service calls made using this new client object are blocking, and will not return until the service call completes.
DefaultAWSCredentialsProviderChain
@Deprecated public AmazonRoute53DomainsClient(ClientConfiguration clientConfiguration)
AwsClientBuilder.withClientConfiguration(ClientConfiguration)
All service calls made using this new client object are blocking, and will not return until the service call completes.
clientConfiguration
- The client configuration options controlling how this client connects to Amazon Route 53 Domains (ex:
proxy settings, retry counts, etc.).DefaultAWSCredentialsProviderChain
@Deprecated public AmazonRoute53DomainsClient(AWSCredentials awsCredentials)
AwsClientBuilder.withCredentials(AWSCredentialsProvider)
for example:
AmazonRoute53DomainsClientBuilder.standard().withCredentials(new AWSStaticCredentialsProvider(awsCredentials)).build();
All service calls made using this new client object are blocking, and will not return until the service call completes.
awsCredentials
- The AWS credentials (access key ID and secret key) to use when authenticating with AWS services.@Deprecated public AmazonRoute53DomainsClient(AWSCredentials awsCredentials, ClientConfiguration clientConfiguration)
AwsClientBuilder.withCredentials(AWSCredentialsProvider)
and
AwsClientBuilder.withClientConfiguration(ClientConfiguration)
All service calls made using this new client object are blocking, and will not return until the service call completes.
awsCredentials
- The AWS credentials (access key ID and secret key) to use when authenticating with AWS services.clientConfiguration
- The client configuration options controlling how this client connects to Amazon Route 53 Domains (ex:
proxy settings, retry counts, etc.).@Deprecated public AmazonRoute53DomainsClient(AWSCredentialsProvider awsCredentialsProvider)
AwsClientBuilder.withCredentials(AWSCredentialsProvider)
All service calls made using this new client object are blocking, and will not return until the service call completes.
awsCredentialsProvider
- The AWS credentials provider which will provide credentials to authenticate requests with AWS services.@Deprecated public AmazonRoute53DomainsClient(AWSCredentialsProvider awsCredentialsProvider, ClientConfiguration clientConfiguration)
AwsClientBuilder.withCredentials(AWSCredentialsProvider)
and
AwsClientBuilder.withClientConfiguration(ClientConfiguration)
All service calls made using this new client object are blocking, and will not return until the service call completes.
awsCredentialsProvider
- The AWS credentials provider which will provide credentials to authenticate requests with AWS services.clientConfiguration
- The client configuration options controlling how this client connects to Amazon Route 53 Domains (ex:
proxy settings, retry counts, etc.).@Deprecated public AmazonRoute53DomainsClient(AWSCredentialsProvider awsCredentialsProvider, ClientConfiguration clientConfiguration, RequestMetricCollector requestMetricCollector)
AwsClientBuilder.withCredentials(AWSCredentialsProvider)
and
AwsClientBuilder.withClientConfiguration(ClientConfiguration)
and
AwsClientBuilder.withMetricsCollector(RequestMetricCollector)
All service calls made using this new client object are blocking, and will not return until the service call completes.
awsCredentialsProvider
- The AWS credentials provider which will provide credentials to authenticate requests with AWS services.clientConfiguration
- The client configuration options controlling how this client connects to Amazon Route 53 Domains (ex:
proxy settings, retry counts, etc.).requestMetricCollector
- optional request metric collectorpublic static AmazonRoute53DomainsClientBuilder builder()
public AcceptDomainTransferFromAnotherAwsAccountResult acceptDomainTransferFromAnotherAwsAccount(AcceptDomainTransferFromAnotherAwsAccountRequest request)
Accepts the transfer of a domain from another AWS account to the current AWS account. You initiate a transfer between AWS accounts using TransferDomainToAnotherAwsAccount.
Use either ListOperations
or
GetOperationDetail to determine whether the operation succeeded. GetOperationDetail provides additional information, for example,
Domain Transfer from Aws Account 111122223333 has been cancelled
.
acceptDomainTransferFromAnotherAwsAccount
in interface AmazonRoute53Domains
acceptDomainTransferFromAnotherAwsAccountRequest
- The AcceptDomainTransferFromAnotherAwsAccount request includes the following elements.InvalidInputException
- The requested item is not acceptable. For example, for APIs that accept a domain name, the request might
specify a domain name that doesn't belong to the account that submitted the request. For
AcceptDomainTransferFromAnotherAwsAccount
, the password might be invalid.OperationLimitExceededException
- The number of operations or jobs running exceeded the allowed threshold for the account.DomainLimitExceededException
- The number of domains has exceeded the allowed threshold for the account.public CancelDomainTransferToAnotherAwsAccountResult cancelDomainTransferToAnotherAwsAccount(CancelDomainTransferToAnotherAwsAccountRequest request)
Cancels the transfer of a domain from the current AWS account to another AWS account. You initiate a transfer between AWS accounts using TransferDomainToAnotherAwsAccount.
You must cancel the transfer before the other AWS account accepts the transfer using AcceptDomainTransferFromAnotherAwsAccount.
Use either ListOperations
or
GetOperationDetail to determine whether the operation succeeded. GetOperationDetail provides additional information, for example,
Domain Transfer from Aws Account 111122223333 has been cancelled
.
cancelDomainTransferToAnotherAwsAccount
in interface AmazonRoute53Domains
cancelDomainTransferToAnotherAwsAccountRequest
- The CancelDomainTransferToAnotherAwsAccount request includes the following element.InvalidInputException
- The requested item is not acceptable. For example, for APIs that accept a domain name, the request might
specify a domain name that doesn't belong to the account that submitted the request. For
AcceptDomainTransferFromAnotherAwsAccount
, the password might be invalid.OperationLimitExceededException
- The number of operations or jobs running exceeded the allowed threshold for the account.public CheckDomainAvailabilityResult checkDomainAvailability(CheckDomainAvailabilityRequest request)
This operation checks the availability of one domain name. Note that if the availability status of a domain is pending, you must submit another request to determine the availability of the domain name.
checkDomainAvailability
in interface AmazonRoute53Domains
checkDomainAvailabilityRequest
- The CheckDomainAvailability request contains the following elements.InvalidInputException
- The requested item is not acceptable. For example, for APIs that accept a domain name, the request might
specify a domain name that doesn't belong to the account that submitted the request. For
AcceptDomainTransferFromAnotherAwsAccount
, the password might be invalid.UnsupportedTLDException
- Amazon Route 53 does not support this top-level domain (TLD).public CheckDomainTransferabilityResult checkDomainTransferability(CheckDomainTransferabilityRequest request)
Checks whether a domain name can be transferred to Amazon Route 53.
checkDomainTransferability
in interface AmazonRoute53Domains
checkDomainTransferabilityRequest
- The CheckDomainTransferability request contains the following elements.InvalidInputException
- The requested item is not acceptable. For example, for APIs that accept a domain name, the request might
specify a domain name that doesn't belong to the account that submitted the request. For
AcceptDomainTransferFromAnotherAwsAccount
, the password might be invalid.UnsupportedTLDException
- Amazon Route 53 does not support this top-level domain (TLD).public DeleteTagsForDomainResult deleteTagsForDomain(DeleteTagsForDomainRequest request)
This operation deletes the specified tags for a domain.
All tag operations are eventually consistent; subsequent operations might not immediately represent all issued operations.
deleteTagsForDomain
in interface AmazonRoute53Domains
deleteTagsForDomainRequest
- The DeleteTagsForDomainRequest includes the following elements.InvalidInputException
- The requested item is not acceptable. For example, for APIs that accept a domain name, the request might
specify a domain name that doesn't belong to the account that submitted the request. For
AcceptDomainTransferFromAnotherAwsAccount
, the password might be invalid.OperationLimitExceededException
- The number of operations or jobs running exceeded the allowed threshold for the account.UnsupportedTLDException
- Amazon Route 53 does not support this top-level domain (TLD).public DisableDomainAutoRenewResult disableDomainAutoRenew(DisableDomainAutoRenewRequest request)
This operation disables automatic renewal of domain registration for the specified domain.
disableDomainAutoRenew
in interface AmazonRoute53Domains
disableDomainAutoRenewRequest
- InvalidInputException
- The requested item is not acceptable. For example, for APIs that accept a domain name, the request might
specify a domain name that doesn't belong to the account that submitted the request. For
AcceptDomainTransferFromAnotherAwsAccount
, the password might be invalid.UnsupportedTLDException
- Amazon Route 53 does not support this top-level domain (TLD).public DisableDomainTransferLockResult disableDomainTransferLock(DisableDomainTransferLockRequest request)
This operation removes the transfer lock on the domain (specifically the clientTransferProhibited
status) to allow domain transfers. We recommend you refrain from performing this action unless you intend to
transfer the domain to a different registrar. Successful submission returns an operation ID that you can use to
track the progress and completion of the action. If the request is not completed successfully, the domain
registrant will be notified by email.
disableDomainTransferLock
in interface AmazonRoute53Domains
disableDomainTransferLockRequest
- The DisableDomainTransferLock request includes the following element.InvalidInputException
- The requested item is not acceptable. For example, for APIs that accept a domain name, the request might
specify a domain name that doesn't belong to the account that submitted the request. For
AcceptDomainTransferFromAnotherAwsAccount
, the password might be invalid.DuplicateRequestException
- The request is already in progress for the domain.TLDRulesViolationException
- The top-level domain does not support this operation.OperationLimitExceededException
- The number of operations or jobs running exceeded the allowed threshold for the account.UnsupportedTLDException
- Amazon Route 53 does not support this top-level domain (TLD).public EnableDomainAutoRenewResult enableDomainAutoRenew(EnableDomainAutoRenewRequest request)
This operation configures Amazon Route 53 to automatically renew the specified domain before the domain registration expires. The cost of renewing your domain registration is billed to your AWS account.
The period during which you can renew a domain name varies by TLD. For a list of TLDs and their renewal policies, see Domains That You Can Register with Amazon Route 53 in the Amazon Route 53 Developer Guide. Route 53 requires that you renew before the end of the renewal period so we can complete processing before the deadline.
enableDomainAutoRenew
in interface AmazonRoute53Domains
enableDomainAutoRenewRequest
- InvalidInputException
- The requested item is not acceptable. For example, for APIs that accept a domain name, the request might
specify a domain name that doesn't belong to the account that submitted the request. For
AcceptDomainTransferFromAnotherAwsAccount
, the password might be invalid.UnsupportedTLDException
- Amazon Route 53 does not support this top-level domain (TLD).TLDRulesViolationException
- The top-level domain does not support this operation.public EnableDomainTransferLockResult enableDomainTransferLock(EnableDomainTransferLockRequest request)
This operation sets the transfer lock on the domain (specifically the clientTransferProhibited
status) to prevent domain transfers. Successful submission returns an operation ID that you can use to track the
progress and completion of the action. If the request is not completed successfully, the domain registrant will
be notified by email.
enableDomainTransferLock
in interface AmazonRoute53Domains
enableDomainTransferLockRequest
- A request to set the transfer lock for the specified domain.InvalidInputException
- The requested item is not acceptable. For example, for APIs that accept a domain name, the request might
specify a domain name that doesn't belong to the account that submitted the request. For
AcceptDomainTransferFromAnotherAwsAccount
, the password might be invalid.DuplicateRequestException
- The request is already in progress for the domain.TLDRulesViolationException
- The top-level domain does not support this operation.OperationLimitExceededException
- The number of operations or jobs running exceeded the allowed threshold for the account.UnsupportedTLDException
- Amazon Route 53 does not support this top-level domain (TLD).public GetContactReachabilityStatusResult getContactReachabilityStatus(GetContactReachabilityStatusRequest request)
For operations that require confirmation that the email address for the registrant contact is valid, such as registering a new domain, this operation returns information about whether the registrant contact has responded.
If you want us to resend the email, use the ResendContactReachabilityEmail
operation.
getContactReachabilityStatus
in interface AmazonRoute53Domains
getContactReachabilityStatusRequest
- InvalidInputException
- The requested item is not acceptable. For example, for APIs that accept a domain name, the request might
specify a domain name that doesn't belong to the account that submitted the request. For
AcceptDomainTransferFromAnotherAwsAccount
, the password might be invalid.OperationLimitExceededException
- The number of operations or jobs running exceeded the allowed threshold for the account.UnsupportedTLDException
- Amazon Route 53 does not support this top-level domain (TLD).public GetDomainDetailResult getDomainDetail(GetDomainDetailRequest request)
This operation returns detailed information about a specified domain that is associated with the current AWS account. Contact information for the domain is also returned as part of the output.
getDomainDetail
in interface AmazonRoute53Domains
getDomainDetailRequest
- The GetDomainDetail request includes the following element.InvalidInputException
- The requested item is not acceptable. For example, for APIs that accept a domain name, the request might
specify a domain name that doesn't belong to the account that submitted the request. For
AcceptDomainTransferFromAnotherAwsAccount
, the password might be invalid.UnsupportedTLDException
- Amazon Route 53 does not support this top-level domain (TLD).public GetDomainSuggestionsResult getDomainSuggestions(GetDomainSuggestionsRequest request)
The GetDomainSuggestions operation returns a list of suggested domain names.
getDomainSuggestions
in interface AmazonRoute53Domains
getDomainSuggestionsRequest
- InvalidInputException
- The requested item is not acceptable. For example, for APIs that accept a domain name, the request might
specify a domain name that doesn't belong to the account that submitted the request. For
AcceptDomainTransferFromAnotherAwsAccount
, the password might be invalid.UnsupportedTLDException
- Amazon Route 53 does not support this top-level domain (TLD).public GetOperationDetailResult getOperationDetail(GetOperationDetailRequest request)
This operation returns the current status of an operation that is not completed.
getOperationDetail
in interface AmazonRoute53Domains
getOperationDetailRequest
- The
GetOperationDetail request includes the following element.InvalidInputException
- The requested item is not acceptable. For example, for APIs that accept a domain name, the request might
specify a domain name that doesn't belong to the account that submitted the request. For
AcceptDomainTransferFromAnotherAwsAccount
, the password might be invalid.public ListDomainsResult listDomains(ListDomainsRequest request)
This operation returns all the domain names registered with Amazon Route 53 for the current AWS account.
listDomains
in interface AmazonRoute53Domains
listDomainsRequest
- The ListDomains request includes the following elements.InvalidInputException
- The requested item is not acceptable. For example, for APIs that accept a domain name, the request might
specify a domain name that doesn't belong to the account that submitted the request. For
AcceptDomainTransferFromAnotherAwsAccount
, the password might be invalid.public ListDomainsResult listDomains()
AmazonRoute53Domains
listDomains
in interface AmazonRoute53Domains
AmazonRoute53Domains.listDomains(ListDomainsRequest)
public ListOperationsResult listOperations(ListOperationsRequest request)
Returns information about all of the operations that return an operation ID and that have ever been performed on domains that were registered by the current account.
listOperations
in interface AmazonRoute53Domains
listOperationsRequest
- The ListOperations request includes the following elements.InvalidInputException
- The requested item is not acceptable. For example, for APIs that accept a domain name, the request might
specify a domain name that doesn't belong to the account that submitted the request. For
AcceptDomainTransferFromAnotherAwsAccount
, the password might be invalid.public ListOperationsResult listOperations()
AmazonRoute53Domains
listOperations
in interface AmazonRoute53Domains
AmazonRoute53Domains.listOperations(ListOperationsRequest)
public ListTagsForDomainResult listTagsForDomain(ListTagsForDomainRequest request)
This operation returns all of the tags that are associated with the specified domain.
All tag operations are eventually consistent; subsequent operations might not immediately represent all issued operations.
listTagsForDomain
in interface AmazonRoute53Domains
listTagsForDomainRequest
- The ListTagsForDomainRequest includes the following elements.InvalidInputException
- The requested item is not acceptable. For example, for APIs that accept a domain name, the request might
specify a domain name that doesn't belong to the account that submitted the request. For
AcceptDomainTransferFromAnotherAwsAccount
, the password might be invalid.OperationLimitExceededException
- The number of operations or jobs running exceeded the allowed threshold for the account.UnsupportedTLDException
- Amazon Route 53 does not support this top-level domain (TLD).public RegisterDomainResult registerDomain(RegisterDomainRequest request)
This operation registers a domain. Domains are registered either by Amazon Registrar (for .com, .net, and .org domains) or by our registrar associate, Gandi (for all other domains). For some top-level domains (TLDs), this operation requires extra parameters.
When you register a domain, Amazon Route 53 does the following:
Creates a Route 53 hosted zone that has the same name as the domain. Route 53 assigns four name servers to your hosted zone and automatically updates your domain registration with the names of these name servers.
Enables autorenew, so your domain registration will renew automatically each year. We'll notify you in advance of the renewal date so you can choose whether to renew the registration.
Optionally enables privacy protection, so WHOIS queries return contact information either for Amazon Registrar (for .com, .net, and .org domains) or for our registrar associate, Gandi (for all other TLDs). If you don't enable privacy protection, WHOIS queries return the information that you entered for the registrant, admin, and tech contacts.
If registration is successful, returns an operation ID that you can use to track the progress and completion of the action. If the request is not completed successfully, the domain registrant is notified by email.
Charges your AWS account an amount based on the top-level domain. For more information, see Amazon Route 53 Pricing.
registerDomain
in interface AmazonRoute53Domains
registerDomainRequest
- The RegisterDomain request includes the following elements.InvalidInputException
- The requested item is not acceptable. For example, for APIs that accept a domain name, the request might
specify a domain name that doesn't belong to the account that submitted the request. For
AcceptDomainTransferFromAnotherAwsAccount
, the password might be invalid.UnsupportedTLDException
- Amazon Route 53 does not support this top-level domain (TLD).DuplicateRequestException
- The request is already in progress for the domain.TLDRulesViolationException
- The top-level domain does not support this operation.DomainLimitExceededException
- The number of domains has exceeded the allowed threshold for the account.OperationLimitExceededException
- The number of operations or jobs running exceeded the allowed threshold for the account.public RejectDomainTransferFromAnotherAwsAccountResult rejectDomainTransferFromAnotherAwsAccount(RejectDomainTransferFromAnotherAwsAccountRequest request)
Rejects the transfer of a domain from another AWS account to the current AWS account. You initiate a transfer between AWS accounts using TransferDomainToAnotherAwsAccount.
Use either ListOperations
or
GetOperationDetail to determine whether the operation succeeded. GetOperationDetail provides additional information, for example,
Domain Transfer from Aws Account 111122223333 has been cancelled
.
rejectDomainTransferFromAnotherAwsAccount
in interface AmazonRoute53Domains
rejectDomainTransferFromAnotherAwsAccountRequest
- The RejectDomainTransferFromAnotherAwsAccount request includes the following element.InvalidInputException
- The requested item is not acceptable. For example, for APIs that accept a domain name, the request might
specify a domain name that doesn't belong to the account that submitted the request. For
AcceptDomainTransferFromAnotherAwsAccount
, the password might be invalid.OperationLimitExceededException
- The number of operations or jobs running exceeded the allowed threshold for the account.public RenewDomainResult renewDomain(RenewDomainRequest request)
This operation renews a domain for the specified number of years. The cost of renewing your domain is billed to your AWS account.
We recommend that you renew your domain several weeks before the expiration date. Some TLD registries delete domains before the expiration date if you haven't renewed far enough in advance. For more information about renewing domain registration, see Renewing Registration for a Domain in the Amazon Route 53 Developer Guide.
renewDomain
in interface AmazonRoute53Domains
renewDomainRequest
- A RenewDomain
request includes the number of years that you want to renew for and the current
expiration year.InvalidInputException
- The requested item is not acceptable. For example, for APIs that accept a domain name, the request might
specify a domain name that doesn't belong to the account that submitted the request. For
AcceptDomainTransferFromAnotherAwsAccount
, the password might be invalid.UnsupportedTLDException
- Amazon Route 53 does not support this top-level domain (TLD).DuplicateRequestException
- The request is already in progress for the domain.TLDRulesViolationException
- The top-level domain does not support this operation.OperationLimitExceededException
- The number of operations or jobs running exceeded the allowed threshold for the account.public ResendContactReachabilityEmailResult resendContactReachabilityEmail(ResendContactReachabilityEmailRequest request)
For operations that require confirmation that the email address for the registrant contact is valid, such as registering a new domain, this operation resends the confirmation email to the current email address for the registrant contact.
resendContactReachabilityEmail
in interface AmazonRoute53Domains
resendContactReachabilityEmailRequest
- InvalidInputException
- The requested item is not acceptable. For example, for APIs that accept a domain name, the request might
specify a domain name that doesn't belong to the account that submitted the request. For
AcceptDomainTransferFromAnotherAwsAccount
, the password might be invalid.OperationLimitExceededException
- The number of operations or jobs running exceeded the allowed threshold for the account.UnsupportedTLDException
- Amazon Route 53 does not support this top-level domain (TLD).public RetrieveDomainAuthCodeResult retrieveDomainAuthCode(RetrieveDomainAuthCodeRequest request)
This operation returns the AuthCode for the domain. To transfer a domain to another registrar, you provide this value to the new registrar.
retrieveDomainAuthCode
in interface AmazonRoute53Domains
retrieveDomainAuthCodeRequest
- A request for the authorization code for the specified domain. To transfer a domain to another registrar,
you provide this value to the new registrar.InvalidInputException
- The requested item is not acceptable. For example, for APIs that accept a domain name, the request might
specify a domain name that doesn't belong to the account that submitted the request. For
AcceptDomainTransferFromAnotherAwsAccount
, the password might be invalid.UnsupportedTLDException
- Amazon Route 53 does not support this top-level domain (TLD).public TransferDomainResult transferDomain(TransferDomainRequest request)
Transfers a domain from another registrar to Amazon Route 53. When the transfer is complete, the domain is registered either with Amazon Registrar (for .com, .net, and .org domains) or with our registrar associate, Gandi (for all other TLDs).
For more information about transferring domains, see the following topics:
For transfer requirements, a detailed procedure, and information about viewing the status of a domain that you're transferring to Route 53, see Transferring Registration for a Domain to Amazon Route 53 in the Amazon Route 53 Developer Guide.
For information about how to transfer a domain from one AWS account to another, see TransferDomainToAnotherAwsAccount.
For information about how to transfer a domain to another domain registrar, see Transferring a Domain from Amazon Route 53 to Another Registrar in the Amazon Route 53 Developer Guide.
If the registrar for your domain is also the DNS service provider for the domain, we highly recommend that you transfer your DNS service to Route 53 or to another DNS service provider before you transfer your registration. Some registrars provide free DNS service when you purchase a domain registration. When you transfer the registration, the previous registrar will not renew your domain registration and could end your DNS service at any time.
If the registrar for your domain is also the DNS service provider for the domain and you don't transfer DNS service to another provider, your website, email, and the web applications associated with the domain might become unavailable.
If the transfer is successful, this method returns an operation ID that you can use to track the progress and completion of the action. If the transfer doesn't complete successfully, the domain registrant will be notified by email.
transferDomain
in interface AmazonRoute53Domains
transferDomainRequest
- The TransferDomain request includes the following elements.InvalidInputException
- The requested item is not acceptable. For example, for APIs that accept a domain name, the request might
specify a domain name that doesn't belong to the account that submitted the request. For
AcceptDomainTransferFromAnotherAwsAccount
, the password might be invalid.UnsupportedTLDException
- Amazon Route 53 does not support this top-level domain (TLD).DuplicateRequestException
- The request is already in progress for the domain.TLDRulesViolationException
- The top-level domain does not support this operation.DomainLimitExceededException
- The number of domains has exceeded the allowed threshold for the account.OperationLimitExceededException
- The number of operations or jobs running exceeded the allowed threshold for the account.public TransferDomainToAnotherAwsAccountResult transferDomainToAnotherAwsAccount(TransferDomainToAnotherAwsAccountRequest request)
Transfers a domain from the current AWS account to another AWS account. Note the following:
The AWS account that you're transferring the domain to must accept the transfer. If the other account doesn't accept the transfer within 3 days, we cancel the transfer. See AcceptDomainTransferFromAnotherAwsAccount.
You can cancel the transfer before the other account accepts it. See CancelDomainTransferToAnotherAwsAccount.
The other account can reject the transfer. See RejectDomainTransferFromAnotherAwsAccount.
When you transfer a domain from one AWS account to another, Route 53 doesn't transfer the hosted zone that is associated with the domain. DNS resolution isn't affected if the domain and the hosted zone are owned by separate accounts, so transferring the hosted zone is optional. For information about transferring the hosted zone to another AWS account, see Migrating a Hosted Zone to a Different AWS Account in the Amazon Route 53 Developer Guide.
Use either ListOperations
or
GetOperationDetail to determine whether the operation succeeded. GetOperationDetail provides additional information, for example,
Domain Transfer from Aws Account 111122223333 has been cancelled
.
transferDomainToAnotherAwsAccount
in interface AmazonRoute53Domains
transferDomainToAnotherAwsAccountRequest
- The TransferDomainToAnotherAwsAccount request includes the following elements.InvalidInputException
- The requested item is not acceptable. For example, for APIs that accept a domain name, the request might
specify a domain name that doesn't belong to the account that submitted the request. For
AcceptDomainTransferFromAnotherAwsAccount
, the password might be invalid.OperationLimitExceededException
- The number of operations or jobs running exceeded the allowed threshold for the account.DuplicateRequestException
- The request is already in progress for the domain.public UpdateDomainContactResult updateDomainContact(UpdateDomainContactRequest request)
This operation updates the contact information for a particular domain. You must specify information for at least one contact: registrant, administrator, or technical.
If the update is successful, this method returns an operation ID that you can use to track the progress and completion of the action. If the request is not completed successfully, the domain registrant will be notified by email.
updateDomainContact
in interface AmazonRoute53Domains
updateDomainContactRequest
- The UpdateDomainContact request includes the following elements.InvalidInputException
- The requested item is not acceptable. For example, for APIs that accept a domain name, the request might
specify a domain name that doesn't belong to the account that submitted the request. For
AcceptDomainTransferFromAnotherAwsAccount
, the password might be invalid.DuplicateRequestException
- The request is already in progress for the domain.TLDRulesViolationException
- The top-level domain does not support this operation.OperationLimitExceededException
- The number of operations or jobs running exceeded the allowed threshold for the account.UnsupportedTLDException
- Amazon Route 53 does not support this top-level domain (TLD).public UpdateDomainContactPrivacyResult updateDomainContactPrivacy(UpdateDomainContactPrivacyRequest request)
This operation updates the specified domain contact's privacy setting. When privacy protection is enabled, contact information such as email address is replaced either with contact information for Amazon Registrar (for .com, .net, and .org domains) or with contact information for our registrar associate, Gandi.
This operation affects only the contact information for the specified contact type (registrant, administrator, or tech). If the request succeeds, Amazon Route 53 returns an operation ID that you can use with GetOperationDetail to track the progress and completion of the action. If the request doesn't complete successfully, the domain registrant will be notified by email.
By disabling the privacy service via API, you consent to the publication of the contact information provided for
this domain via the public WHOIS database. You certify that you are the registrant of this domain name and have
the authority to make this decision. You may withdraw your consent at any time by enabling privacy protection
using either UpdateDomainContactPrivacy
or the Route 53 console. Enabling privacy protection removes
the contact information provided for this domain from the WHOIS database. For more information on our privacy
practices, see https://aws.amazon.com/privacy/.
updateDomainContactPrivacy
in interface AmazonRoute53Domains
updateDomainContactPrivacyRequest
- The UpdateDomainContactPrivacy request includes the following elements.InvalidInputException
- The requested item is not acceptable. For example, for APIs that accept a domain name, the request might
specify a domain name that doesn't belong to the account that submitted the request. For
AcceptDomainTransferFromAnotherAwsAccount
, the password might be invalid.DuplicateRequestException
- The request is already in progress for the domain.TLDRulesViolationException
- The top-level domain does not support this operation.OperationLimitExceededException
- The number of operations or jobs running exceeded the allowed threshold for the account.UnsupportedTLDException
- Amazon Route 53 does not support this top-level domain (TLD).public UpdateDomainNameserversResult updateDomainNameservers(UpdateDomainNameserversRequest request)
This operation replaces the current set of name servers for the domain with the specified set of name servers. If you use Amazon Route 53 as your DNS service, specify the four name servers in the delegation set for the hosted zone for the domain.
If successful, this operation returns an operation ID that you can use to track the progress and completion of the action. If the request is not completed successfully, the domain registrant will be notified by email.
updateDomainNameservers
in interface AmazonRoute53Domains
updateDomainNameserversRequest
- Replaces the current set of name servers for the domain with the specified set of name servers. If you use
Amazon Route 53 as your DNS service, specify the four name servers in the delegation set for the hosted
zone for the domain.
If successful, this operation returns an operation ID that you can use to track the progress and completion of the action. If the request is not completed successfully, the domain registrant will be notified by email.
InvalidInputException
- The requested item is not acceptable. For example, for APIs that accept a domain name, the request might
specify a domain name that doesn't belong to the account that submitted the request. For
AcceptDomainTransferFromAnotherAwsAccount
, the password might be invalid.DuplicateRequestException
- The request is already in progress for the domain.TLDRulesViolationException
- The top-level domain does not support this operation.OperationLimitExceededException
- The number of operations or jobs running exceeded the allowed threshold for the account.UnsupportedTLDException
- Amazon Route 53 does not support this top-level domain (TLD).public UpdateTagsForDomainResult updateTagsForDomain(UpdateTagsForDomainRequest request)
This operation adds or updates tags for a specified domain.
All tag operations are eventually consistent; subsequent operations might not immediately represent all issued operations.
updateTagsForDomain
in interface AmazonRoute53Domains
updateTagsForDomainRequest
- The UpdateTagsForDomainRequest includes the following elements.InvalidInputException
- The requested item is not acceptable. For example, for APIs that accept a domain name, the request might
specify a domain name that doesn't belong to the account that submitted the request. For
AcceptDomainTransferFromAnotherAwsAccount
, the password might be invalid.OperationLimitExceededException
- The number of operations or jobs running exceeded the allowed threshold for the account.UnsupportedTLDException
- Amazon Route 53 does not support this top-level domain (TLD).public ViewBillingResult viewBilling(ViewBillingRequest request)
Returns all the domain-related billing records for the current AWS account for a specified period
viewBilling
in interface AmazonRoute53Domains
viewBillingRequest
- The ViewBilling request includes the following elements.InvalidInputException
- The requested item is not acceptable. For example, for APIs that accept a domain name, the request might
specify a domain name that doesn't belong to the account that submitted the request. For
AcceptDomainTransferFromAnotherAwsAccount
, the password might be invalid.public ResponseMetadata getCachedResponseMetadata(AmazonWebServiceRequest request)
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 the request.
getCachedResponseMetadata
in interface AmazonRoute53Domains
request
- The originally executed requestpublic void shutdown()
AmazonWebServiceClient
shutdown
in interface AmazonRoute53Domains
shutdown
in class AmazonWebServiceClient