Interface Route53DomainsAsyncClient
- All Superinterfaces:
AutoCloseable
,AwsClient
,SdkAutoCloseable
,SdkClient
builder()
method.The asynchronous client performs non-blocking I/O when configured with any
invalid reference
SdkAsyncHttpClient
Amazon Route 53 API actions let you register domain names and perform related operations.
-
Field Summary
Modifier and TypeFieldDescriptionstatic final String
Value for looking up the service's metadata from theServiceMetadataProvider
.static final String
-
Method Summary
Modifier and TypeMethodDescriptionacceptDomainTransferFromAnotherAwsAccount
(Consumer<AcceptDomainTransferFromAnotherAwsAccountRequest.Builder> acceptDomainTransferFromAnotherAwsAccountRequest) Accepts the transfer of a domain from another Amazon Web Services account to the currentAmazon Web Services account.acceptDomainTransferFromAnotherAwsAccount
(AcceptDomainTransferFromAnotherAwsAccountRequest acceptDomainTransferFromAnotherAwsAccountRequest) Accepts the transfer of a domain from another Amazon Web Services account to the currentAmazon Web Services account.associateDelegationSignerToDomain
(Consumer<AssociateDelegationSignerToDomainRequest.Builder> associateDelegationSignerToDomainRequest) Creates a delegation signer (DS) record in the registry zone for this domain name.associateDelegationSignerToDomain
(AssociateDelegationSignerToDomainRequest associateDelegationSignerToDomainRequest) Creates a delegation signer (DS) record in the registry zone for this domain name.builder()
Create a builder that can be used to configure and create aRoute53DomainsAsyncClient
.cancelDomainTransferToAnotherAwsAccount
(Consumer<CancelDomainTransferToAnotherAwsAccountRequest.Builder> cancelDomainTransferToAnotherAwsAccountRequest) Cancels the transfer of a domain from the current Amazon Web Services account to another Amazon Web Services account.cancelDomainTransferToAnotherAwsAccount
(CancelDomainTransferToAnotherAwsAccountRequest cancelDomainTransferToAnotherAwsAccountRequest) Cancels the transfer of a domain from the current Amazon Web Services account to another Amazon Web Services account.checkDomainAvailability
(Consumer<CheckDomainAvailabilityRequest.Builder> checkDomainAvailabilityRequest) This operation checks the availability of one domain name.checkDomainAvailability
(CheckDomainAvailabilityRequest checkDomainAvailabilityRequest) This operation checks the availability of one domain name.checkDomainTransferability
(Consumer<CheckDomainTransferabilityRequest.Builder> checkDomainTransferabilityRequest) Checks whether a domain name can be transferred to Amazon Route 53.checkDomainTransferability
(CheckDomainTransferabilityRequest checkDomainTransferabilityRequest) Checks whether a domain name can be transferred to Amazon Route 53.static Route53DomainsAsyncClient
create()
Create aRoute53DomainsAsyncClient
with the region loaded from theDefaultAwsRegionProviderChain
and credentials loaded from theDefaultCredentialsProvider
.default CompletableFuture
<DeleteDomainResponse> deleteDomain
(Consumer<DeleteDomainRequest.Builder> deleteDomainRequest) This operation deletes the specified domain.default CompletableFuture
<DeleteDomainResponse> deleteDomain
(DeleteDomainRequest deleteDomainRequest) This operation deletes the specified domain.deleteTagsForDomain
(Consumer<DeleteTagsForDomainRequest.Builder> deleteTagsForDomainRequest) This operation deletes the specified tags for a domain.deleteTagsForDomain
(DeleteTagsForDomainRequest deleteTagsForDomainRequest) This operation deletes the specified tags for a domain.disableDomainAutoRenew
(Consumer<DisableDomainAutoRenewRequest.Builder> disableDomainAutoRenewRequest) This operation disables automatic renewal of domain registration for the specified domain.disableDomainAutoRenew
(DisableDomainAutoRenewRequest disableDomainAutoRenewRequest) This operation disables automatic renewal of domain registration for the specified domain.disableDomainTransferLock
(Consumer<DisableDomainTransferLockRequest.Builder> disableDomainTransferLockRequest) This operation removes the transfer lock on the domain (specifically theclientTransferProhibited
status) to allow domain transfers.disableDomainTransferLock
(DisableDomainTransferLockRequest disableDomainTransferLockRequest) This operation removes the transfer lock on the domain (specifically theclientTransferProhibited
status) to allow domain transfers.disassociateDelegationSignerFromDomain
(Consumer<DisassociateDelegationSignerFromDomainRequest.Builder> disassociateDelegationSignerFromDomainRequest) Deletes a delegation signer (DS) record in the registry zone for this domain name.disassociateDelegationSignerFromDomain
(DisassociateDelegationSignerFromDomainRequest disassociateDelegationSignerFromDomainRequest) Deletes a delegation signer (DS) record in the registry zone for this domain name.enableDomainAutoRenew
(Consumer<EnableDomainAutoRenewRequest.Builder> enableDomainAutoRenewRequest) This operation configures Amazon Route 53 to automatically renew the specified domain before the domain registration expires.enableDomainAutoRenew
(EnableDomainAutoRenewRequest enableDomainAutoRenewRequest) This operation configures Amazon Route 53 to automatically renew the specified domain before the domain registration expires.enableDomainTransferLock
(Consumer<EnableDomainTransferLockRequest.Builder> enableDomainTransferLockRequest) This operation sets the transfer lock on the domain (specifically theclientTransferProhibited
status) to prevent domain transfers.enableDomainTransferLock
(EnableDomainTransferLockRequest enableDomainTransferLockRequest) This operation sets the transfer lock on the domain (specifically theclientTransferProhibited
status) to prevent domain transfers.getContactReachabilityStatus
(Consumer<GetContactReachabilityStatusRequest.Builder> getContactReachabilityStatusRequest) 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.getContactReachabilityStatus
(GetContactReachabilityStatusRequest getContactReachabilityStatusRequest) 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.default CompletableFuture
<GetDomainDetailResponse> getDomainDetail
(Consumer<GetDomainDetailRequest.Builder> getDomainDetailRequest) This operation returns detailed information about a specified domain that is associated with the current Amazon Web Services account.default CompletableFuture
<GetDomainDetailResponse> getDomainDetail
(GetDomainDetailRequest getDomainDetailRequest) This operation returns detailed information about a specified domain that is associated with the current Amazon Web Services account.getDomainSuggestions
(Consumer<GetDomainSuggestionsRequest.Builder> getDomainSuggestionsRequest) The GetDomainSuggestions operation returns a list of suggested domain names.getDomainSuggestions
(GetDomainSuggestionsRequest getDomainSuggestionsRequest) The GetDomainSuggestions operation returns a list of suggested domain names.getOperationDetail
(Consumer<GetOperationDetailRequest.Builder> getOperationDetailRequest) This operation returns the current status of an operation that is not completed.getOperationDetail
(GetOperationDetailRequest getOperationDetailRequest) This operation returns the current status of an operation that is not completed.default CompletableFuture
<ListDomainsResponse> This operation returns all the domain names registered with Amazon Route 53 for the current Amazon Web Services account if no filtering conditions are used.default CompletableFuture
<ListDomainsResponse> listDomains
(Consumer<ListDomainsRequest.Builder> listDomainsRequest) This operation returns all the domain names registered with Amazon Route 53 for the current Amazon Web Services account if no filtering conditions are used.default CompletableFuture
<ListDomainsResponse> listDomains
(ListDomainsRequest listDomainsRequest) This operation returns all the domain names registered with Amazon Route 53 for the current Amazon Web Services account if no filtering conditions are used.default ListDomainsPublisher
This is a variant oflistDomains(software.amazon.awssdk.services.route53domains.model.ListDomainsRequest)
operation.default ListDomainsPublisher
listDomainsPaginator
(Consumer<ListDomainsRequest.Builder> listDomainsRequest) This is a variant oflistDomains(software.amazon.awssdk.services.route53domains.model.ListDomainsRequest)
operation.default ListDomainsPublisher
listDomainsPaginator
(ListDomainsRequest listDomainsRequest) This is a variant oflistDomains(software.amazon.awssdk.services.route53domains.model.ListDomainsRequest)
operation.default CompletableFuture
<ListOperationsResponse> 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.default CompletableFuture
<ListOperationsResponse> listOperations
(Consumer<ListOperationsRequest.Builder> listOperationsRequest) 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.default CompletableFuture
<ListOperationsResponse> listOperations
(ListOperationsRequest listOperationsRequest) 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.default ListOperationsPublisher
This is a variant oflistOperations(software.amazon.awssdk.services.route53domains.model.ListOperationsRequest)
operation.default ListOperationsPublisher
listOperationsPaginator
(Consumer<ListOperationsRequest.Builder> listOperationsRequest) This is a variant oflistOperations(software.amazon.awssdk.services.route53domains.model.ListOperationsRequest)
operation.default ListOperationsPublisher
listOperationsPaginator
(ListOperationsRequest listOperationsRequest) This is a variant oflistOperations(software.amazon.awssdk.services.route53domains.model.ListOperationsRequest)
operation.default CompletableFuture
<ListPricesResponse> listPrices
(Consumer<ListPricesRequest.Builder> listPricesRequest) Lists the following prices for either all the TLDs supported by Route 53, or the specified TLD:default CompletableFuture
<ListPricesResponse> listPrices
(ListPricesRequest listPricesRequest) Lists the following prices for either all the TLDs supported by Route 53, or the specified TLD:default ListPricesPublisher
listPricesPaginator
(Consumer<ListPricesRequest.Builder> listPricesRequest) This is a variant oflistPrices(software.amazon.awssdk.services.route53domains.model.ListPricesRequest)
operation.default ListPricesPublisher
listPricesPaginator
(ListPricesRequest listPricesRequest) This is a variant oflistPrices(software.amazon.awssdk.services.route53domains.model.ListPricesRequest)
operation.listTagsForDomain
(Consumer<ListTagsForDomainRequest.Builder> listTagsForDomainRequest) This operation returns all of the tags that are associated with the specified domain.listTagsForDomain
(ListTagsForDomainRequest listTagsForDomainRequest) This operation returns all of the tags that are associated with the specified domain.default CompletableFuture
<PushDomainResponse> pushDomain
(Consumer<PushDomainRequest.Builder> pushDomainRequest) Moves a domain from Amazon Web Services to another registrar.default CompletableFuture
<PushDomainResponse> pushDomain
(PushDomainRequest pushDomainRequest) Moves a domain from Amazon Web Services to another registrar.default CompletableFuture
<RegisterDomainResponse> registerDomain
(Consumer<RegisterDomainRequest.Builder> registerDomainRequest) This operation registers a domain.default CompletableFuture
<RegisterDomainResponse> registerDomain
(RegisterDomainRequest registerDomainRequest) This operation registers a domain.rejectDomainTransferFromAnotherAwsAccount
(Consumer<RejectDomainTransferFromAnotherAwsAccountRequest.Builder> rejectDomainTransferFromAnotherAwsAccountRequest) Rejects the transfer of a domain from another Amazon Web Services account to the current Amazon Web Services account.rejectDomainTransferFromAnotherAwsAccount
(RejectDomainTransferFromAnotherAwsAccountRequest rejectDomainTransferFromAnotherAwsAccountRequest) Rejects the transfer of a domain from another Amazon Web Services account to the current Amazon Web Services account.default CompletableFuture
<RenewDomainResponse> renewDomain
(Consumer<RenewDomainRequest.Builder> renewDomainRequest) This operation renews a domain for the specified number of years.default CompletableFuture
<RenewDomainResponse> renewDomain
(RenewDomainRequest renewDomainRequest) This operation renews a domain for the specified number of years.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
(Consumer<ResendContactReachabilityEmailRequest.Builder> resendContactReachabilityEmailRequest) 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
(ResendContactReachabilityEmailRequest resendContactReachabilityEmailRequest) 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.resendOperationAuthorization
(Consumer<ResendOperationAuthorizationRequest.Builder> resendOperationAuthorizationRequest) Resend the form of authorization email for this operation.resendOperationAuthorization
(ResendOperationAuthorizationRequest resendOperationAuthorizationRequest) Resend the form of authorization email for this operation.retrieveDomainAuthCode
(Consumer<RetrieveDomainAuthCodeRequest.Builder> retrieveDomainAuthCodeRequest) This operation returns the authorization code for the domain.retrieveDomainAuthCode
(RetrieveDomainAuthCodeRequest retrieveDomainAuthCodeRequest) This operation returns the authorization code for the domain.The SDK service client configuration exposes client settings to the user, e.g., ClientOverrideConfigurationdefault CompletableFuture
<TransferDomainResponse> transferDomain
(Consumer<TransferDomainRequest.Builder> transferDomainRequest) Transfers a domain from another registrar to Amazon Route 53.default CompletableFuture
<TransferDomainResponse> transferDomain
(TransferDomainRequest transferDomainRequest) Transfers a domain from another registrar to Amazon Route 53.transferDomainToAnotherAwsAccount
(Consumer<TransferDomainToAnotherAwsAccountRequest.Builder> transferDomainToAnotherAwsAccountRequest) Transfers a domain from the current Amazon Web Services account to another Amazon Web Services account.transferDomainToAnotherAwsAccount
(TransferDomainToAnotherAwsAccountRequest transferDomainToAnotherAwsAccountRequest) Transfers a domain from the current Amazon Web Services account to another Amazon Web Services account.updateDomainContact
(Consumer<UpdateDomainContactRequest.Builder> updateDomainContactRequest) This operation updates the contact information for a particular domain.updateDomainContact
(UpdateDomainContactRequest updateDomainContactRequest) This operation updates the contact information for a particular domain.updateDomainContactPrivacy
(Consumer<UpdateDomainContactPrivacyRequest.Builder> updateDomainContactPrivacyRequest) This operation updates the specified domain contact's privacy setting.updateDomainContactPrivacy
(UpdateDomainContactPrivacyRequest updateDomainContactPrivacyRequest) This operation updates the specified domain contact's privacy setting.updateDomainNameservers
(Consumer<UpdateDomainNameserversRequest.Builder> updateDomainNameserversRequest) This operation replaces the current set of name servers for the domain with the specified set of name servers.updateDomainNameservers
(UpdateDomainNameserversRequest updateDomainNameserversRequest) This operation replaces the current set of name servers for the domain with the specified set of name servers.updateTagsForDomain
(Consumer<UpdateTagsForDomainRequest.Builder> updateTagsForDomainRequest) This operation adds or updates tags for a specified domain.updateTagsForDomain
(UpdateTagsForDomainRequest updateTagsForDomainRequest) This operation adds or updates tags for a specified domain.default CompletableFuture
<ViewBillingResponse> viewBilling
(Consumer<ViewBillingRequest.Builder> viewBillingRequest) Returns all the domain-related billing records for the current Amazon Web Services account for a specified perioddefault CompletableFuture
<ViewBillingResponse> viewBilling
(ViewBillingRequest viewBillingRequest) Returns all the domain-related billing records for the current Amazon Web Services account for a specified perioddefault ViewBillingPublisher
viewBillingPaginator
(Consumer<ViewBillingRequest.Builder> viewBillingRequest) This is a variant ofviewBilling(software.amazon.awssdk.services.route53domains.model.ViewBillingRequest)
operation.default ViewBillingPublisher
viewBillingPaginator
(ViewBillingRequest viewBillingRequest) This is a variant ofviewBilling(software.amazon.awssdk.services.route53domains.model.ViewBillingRequest)
operation.Methods inherited from interface software.amazon.awssdk.utils.SdkAutoCloseable
close
Methods inherited from interface software.amazon.awssdk.core.SdkClient
serviceName
-
Field Details
-
SERVICE_NAME
- See Also:
-
SERVICE_METADATA_ID
Value for looking up the service's metadata from theServiceMetadataProvider
.- See Also:
-
-
Method Details
-
acceptDomainTransferFromAnotherAwsAccount
default CompletableFuture<AcceptDomainTransferFromAnotherAwsAccountResponse> acceptDomainTransferFromAnotherAwsAccount(AcceptDomainTransferFromAnotherAwsAccountRequest acceptDomainTransferFromAnotherAwsAccountRequest) Accepts the transfer of a domain from another Amazon Web Services account to the currentAmazon Web Services account. You initiate a transfer between Amazon Web Services accounts using TransferDomainToAnotherAwsAccount.
If you use the CLI command at accept-domain-transfer-from-another-aws-account, use JSON format as input instead of text because otherwise CLI will throw an error from domain transfer input that includes single quotes.
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
.- Parameters:
acceptDomainTransferFromAnotherAwsAccountRequest
- The AcceptDomainTransferFromAnotherAwsAccount request includes the following elements.- Returns:
- A Java Future containing the result of the AcceptDomainTransferFromAnotherAwsAccount operation returned
by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- 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.
- UnsupportedTldException Amazon Route 53 does not support this top-level domain (TLD).
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- Route53DomainsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- 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
- See Also:
-
acceptDomainTransferFromAnotherAwsAccount
default CompletableFuture<AcceptDomainTransferFromAnotherAwsAccountResponse> acceptDomainTransferFromAnotherAwsAccount(Consumer<AcceptDomainTransferFromAnotherAwsAccountRequest.Builder> acceptDomainTransferFromAnotherAwsAccountRequest) Accepts the transfer of a domain from another Amazon Web Services account to the currentAmazon Web Services account. You initiate a transfer between Amazon Web Services accounts using TransferDomainToAnotherAwsAccount.
If you use the CLI command at accept-domain-transfer-from-another-aws-account, use JSON format as input instead of text because otherwise CLI will throw an error from domain transfer input that includes single quotes.
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
.
This is a convenience which creates an instance of the
AcceptDomainTransferFromAnotherAwsAccountRequest.Builder
avoiding the need to create one manually viaAcceptDomainTransferFromAnotherAwsAccountRequest.builder()
- Parameters:
acceptDomainTransferFromAnotherAwsAccountRequest
- AConsumer
that will call methods onAcceptDomainTransferFromAnotherAwsAccountRequest.Builder
to create a request. The AcceptDomainTransferFromAnotherAwsAccount request includes the following elements.- Returns:
- A Java Future containing the result of the AcceptDomainTransferFromAnotherAwsAccount operation returned
by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- 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.
- UnsupportedTldException Amazon Route 53 does not support this top-level domain (TLD).
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- Route53DomainsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- 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
- See Also:
-
associateDelegationSignerToDomain
default CompletableFuture<AssociateDelegationSignerToDomainResponse> associateDelegationSignerToDomain(AssociateDelegationSignerToDomainRequest associateDelegationSignerToDomainRequest) Creates a delegation signer (DS) record in the registry zone for this domain name.
Note that creating DS record at the registry impacts DNSSEC validation of your DNS records. This action may render your domain name unavailable on the internet if the steps are completed in the wrong order, or with incorrect timing. For more information about DNSSEC signing, see Configuring DNSSEC signing in the Route 53 developer guide.
- Parameters:
associateDelegationSignerToDomainRequest
-- Returns:
- A Java Future containing the result of the AssociateDelegationSignerToDomain operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DuplicateRequestException The request is already in progress for the 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. - OperationLimitExceededException The number of operations or jobs running exceeded the allowed threshold for the account.
- TldRulesViolationException The top-level domain does not support this operation.
- UnsupportedTldException Amazon Route 53 does not support this top-level domain (TLD).
- DnssecLimitExceededException This error is returned if you call
AssociateDelegationSignerToDomain
when the specified domain has reached the maximum number of DS records. You can't add any additional DS records unless you delete an existing one first. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- Route53DomainsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
associateDelegationSignerToDomain
default CompletableFuture<AssociateDelegationSignerToDomainResponse> associateDelegationSignerToDomain(Consumer<AssociateDelegationSignerToDomainRequest.Builder> associateDelegationSignerToDomainRequest) Creates a delegation signer (DS) record in the registry zone for this domain name.
Note that creating DS record at the registry impacts DNSSEC validation of your DNS records. This action may render your domain name unavailable on the internet if the steps are completed in the wrong order, or with incorrect timing. For more information about DNSSEC signing, see Configuring DNSSEC signing in the Route 53 developer guide.
This is a convenience which creates an instance of the
AssociateDelegationSignerToDomainRequest.Builder
avoiding the need to create one manually viaAssociateDelegationSignerToDomainRequest.builder()
- Parameters:
associateDelegationSignerToDomainRequest
- AConsumer
that will call methods onAssociateDelegationSignerToDomainRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the AssociateDelegationSignerToDomain operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DuplicateRequestException The request is already in progress for the 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. - OperationLimitExceededException The number of operations or jobs running exceeded the allowed threshold for the account.
- TldRulesViolationException The top-level domain does not support this operation.
- UnsupportedTldException Amazon Route 53 does not support this top-level domain (TLD).
- DnssecLimitExceededException This error is returned if you call
AssociateDelegationSignerToDomain
when the specified domain has reached the maximum number of DS records. You can't add any additional DS records unless you delete an existing one first. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- Route53DomainsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
cancelDomainTransferToAnotherAwsAccount
default CompletableFuture<CancelDomainTransferToAnotherAwsAccountResponse> cancelDomainTransferToAnotherAwsAccount(CancelDomainTransferToAnotherAwsAccountRequest cancelDomainTransferToAnotherAwsAccountRequest) Cancels the transfer of a domain from the current Amazon Web Services account to another Amazon Web Services account. You initiate a transfer betweenAmazon Web Services accounts using TransferDomainToAnotherAwsAccount.
You must cancel the transfer before the other Amazon Web Services 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
.- Parameters:
cancelDomainTransferToAnotherAwsAccountRequest
- The CancelDomainTransferToAnotherAwsAccount request includes the following element.- Returns:
- A Java Future containing the result of the CancelDomainTransferToAnotherAwsAccount operation returned by
the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- 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).
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- Route53DomainsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- 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
- See Also:
-
cancelDomainTransferToAnotherAwsAccount
default CompletableFuture<CancelDomainTransferToAnotherAwsAccountResponse> cancelDomainTransferToAnotherAwsAccount(Consumer<CancelDomainTransferToAnotherAwsAccountRequest.Builder> cancelDomainTransferToAnotherAwsAccountRequest) Cancels the transfer of a domain from the current Amazon Web Services account to another Amazon Web Services account. You initiate a transfer betweenAmazon Web Services accounts using TransferDomainToAnotherAwsAccount.
You must cancel the transfer before the other Amazon Web Services 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
.
This is a convenience which creates an instance of the
CancelDomainTransferToAnotherAwsAccountRequest.Builder
avoiding the need to create one manually viaCancelDomainTransferToAnotherAwsAccountRequest.builder()
- Parameters:
cancelDomainTransferToAnotherAwsAccountRequest
- AConsumer
that will call methods onCancelDomainTransferToAnotherAwsAccountRequest.Builder
to create a request. The CancelDomainTransferToAnotherAwsAccount request includes the following element.- Returns:
- A Java Future containing the result of the CancelDomainTransferToAnotherAwsAccount operation returned by
the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- 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).
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- Route53DomainsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- 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
- See Also:
-
checkDomainAvailability
default CompletableFuture<CheckDomainAvailabilityResponse> checkDomainAvailability(CheckDomainAvailabilityRequest checkDomainAvailabilityRequest) 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.
- Parameters:
checkDomainAvailabilityRequest
- The CheckDomainAvailability request contains the following elements.- Returns:
- A Java Future containing the result of the CheckDomainAvailability operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- 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).
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- Route53DomainsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- 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
- See Also:
-
checkDomainAvailability
default CompletableFuture<CheckDomainAvailabilityResponse> checkDomainAvailability(Consumer<CheckDomainAvailabilityRequest.Builder> checkDomainAvailabilityRequest) 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.
This is a convenience which creates an instance of the
CheckDomainAvailabilityRequest.Builder
avoiding the need to create one manually viaCheckDomainAvailabilityRequest.builder()
- Parameters:
checkDomainAvailabilityRequest
- AConsumer
that will call methods onCheckDomainAvailabilityRequest.Builder
to create a request. The CheckDomainAvailability request contains the following elements.- Returns:
- A Java Future containing the result of the CheckDomainAvailability operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- 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).
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- Route53DomainsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- 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
- See Also:
-
checkDomainTransferability
default CompletableFuture<CheckDomainTransferabilityResponse> checkDomainTransferability(CheckDomainTransferabilityRequest checkDomainTransferabilityRequest) Checks whether a domain name can be transferred to Amazon Route 53.
- Parameters:
checkDomainTransferabilityRequest
- The CheckDomainTransferability request contains the following elements.- Returns:
- A Java Future containing the result of the CheckDomainTransferability operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- 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).
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- Route53DomainsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- 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
- See Also:
-
checkDomainTransferability
default CompletableFuture<CheckDomainTransferabilityResponse> checkDomainTransferability(Consumer<CheckDomainTransferabilityRequest.Builder> checkDomainTransferabilityRequest) Checks whether a domain name can be transferred to Amazon Route 53.
This is a convenience which creates an instance of the
CheckDomainTransferabilityRequest.Builder
avoiding the need to create one manually viaCheckDomainTransferabilityRequest.builder()
- Parameters:
checkDomainTransferabilityRequest
- AConsumer
that will call methods onCheckDomainTransferabilityRequest.Builder
to create a request. The CheckDomainTransferability request contains the following elements.- Returns:
- A Java Future containing the result of the CheckDomainTransferability operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- 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).
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- Route53DomainsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- 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
- See Also:
-
deleteDomain
default CompletableFuture<DeleteDomainResponse> deleteDomain(DeleteDomainRequest deleteDomainRequest) This operation deletes the specified domain. This action is permanent. For more information, see Deleting a domain name registration.
To transfer the domain registration to another registrar, use the transfer process that’s provided by the registrar to which you want to transfer the registration. Otherwise, the following apply:
-
You can’t get a refund for the cost of a deleted domain registration.
-
The registry for the top-level domain might hold the domain name for a brief time before releasing it for other users to register (varies by registry).
-
When the registration has been deleted, we'll send you a confirmation to the registrant contact. The email will come from
noreply@domainnameverification.net
ornoreply@registrar.amazon.com
.
- Parameters:
deleteDomainRequest
-- Returns:
- A Java Future containing the result of the DeleteDomain operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- 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.
- UnsupportedTldException Amazon Route 53 does not support this top-level domain (TLD).
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- Route53DomainsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- 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
- See Also:
-
-
deleteDomain
default CompletableFuture<DeleteDomainResponse> deleteDomain(Consumer<DeleteDomainRequest.Builder> deleteDomainRequest) This operation deletes the specified domain. This action is permanent. For more information, see Deleting a domain name registration.
To transfer the domain registration to another registrar, use the transfer process that’s provided by the registrar to which you want to transfer the registration. Otherwise, the following apply:
-
You can’t get a refund for the cost of a deleted domain registration.
-
The registry for the top-level domain might hold the domain name for a brief time before releasing it for other users to register (varies by registry).
-
When the registration has been deleted, we'll send you a confirmation to the registrant contact. The email will come from
noreply@domainnameverification.net
ornoreply@registrar.amazon.com
.
This is a convenience which creates an instance of the
DeleteDomainRequest.Builder
avoiding the need to create one manually viaDeleteDomainRequest.builder()
- Parameters:
deleteDomainRequest
- AConsumer
that will call methods onDeleteDomainRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the DeleteDomain operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- 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.
- UnsupportedTldException Amazon Route 53 does not support this top-level domain (TLD).
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- Route53DomainsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- 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
- See Also:
-
-
deleteTagsForDomain
default CompletableFuture<DeleteTagsForDomainResponse> deleteTagsForDomain(DeleteTagsForDomainRequest deleteTagsForDomainRequest) This operation deletes the specified tags for a domain.
All tag operations are eventually consistent; subsequent operations might not immediately represent all issued operations.
- Parameters:
deleteTagsForDomainRequest
- The DeleteTagsForDomainRequest includes the following elements.- Returns:
- A Java Future containing the result of the DeleteTagsForDomain operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- 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).
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- Route53DomainsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- 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
- See Also:
-
deleteTagsForDomain
default CompletableFuture<DeleteTagsForDomainResponse> deleteTagsForDomain(Consumer<DeleteTagsForDomainRequest.Builder> deleteTagsForDomainRequest) This operation deletes the specified tags for a domain.
All tag operations are eventually consistent; subsequent operations might not immediately represent all issued operations.
This is a convenience which creates an instance of the
DeleteTagsForDomainRequest.Builder
avoiding the need to create one manually viaDeleteTagsForDomainRequest.builder()
- Parameters:
deleteTagsForDomainRequest
- AConsumer
that will call methods onDeleteTagsForDomainRequest.Builder
to create a request. The DeleteTagsForDomainRequest includes the following elements.- Returns:
- A Java Future containing the result of the DeleteTagsForDomain operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- 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).
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- Route53DomainsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- 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
- See Also:
-
disableDomainAutoRenew
default CompletableFuture<DisableDomainAutoRenewResponse> disableDomainAutoRenew(DisableDomainAutoRenewRequest disableDomainAutoRenewRequest) This operation disables automatic renewal of domain registration for the specified domain.
- Parameters:
disableDomainAutoRenewRequest
-- Returns:
- A Java Future containing the result of the DisableDomainAutoRenew operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- 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).
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- Route53DomainsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- 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
- See Also:
-
disableDomainAutoRenew
default CompletableFuture<DisableDomainAutoRenewResponse> disableDomainAutoRenew(Consumer<DisableDomainAutoRenewRequest.Builder> disableDomainAutoRenewRequest) This operation disables automatic renewal of domain registration for the specified domain.
This is a convenience which creates an instance of the
DisableDomainAutoRenewRequest.Builder
avoiding the need to create one manually viaDisableDomainAutoRenewRequest.builder()
- Parameters:
disableDomainAutoRenewRequest
- AConsumer
that will call methods onDisableDomainAutoRenewRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the DisableDomainAutoRenew operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- 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).
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- Route53DomainsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- 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
- See Also:
-
disableDomainTransferLock
default CompletableFuture<DisableDomainTransferLockResponse> disableDomainTransferLock(DisableDomainTransferLockRequest disableDomainTransferLockRequest) 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.- Parameters:
disableDomainTransferLockRequest
- The DisableDomainTransferLock request includes the following element.- Returns:
- A Java Future containing the result of the DisableDomainTransferLock operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- 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).
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- Route53DomainsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- 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
- See Also:
-
disableDomainTransferLock
default CompletableFuture<DisableDomainTransferLockResponse> disableDomainTransferLock(Consumer<DisableDomainTransferLockRequest.Builder> disableDomainTransferLockRequest) 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.
This is a convenience which creates an instance of the
DisableDomainTransferLockRequest.Builder
avoiding the need to create one manually viaDisableDomainTransferLockRequest.builder()
- Parameters:
disableDomainTransferLockRequest
- AConsumer
that will call methods onDisableDomainTransferLockRequest.Builder
to create a request. The DisableDomainTransferLock request includes the following element.- Returns:
- A Java Future containing the result of the DisableDomainTransferLock operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- 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).
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- Route53DomainsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- 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
- See Also:
-
disassociateDelegationSignerFromDomain
default CompletableFuture<DisassociateDelegationSignerFromDomainResponse> disassociateDelegationSignerFromDomain(DisassociateDelegationSignerFromDomainRequest disassociateDelegationSignerFromDomainRequest) Deletes a delegation signer (DS) record in the registry zone for this domain name.
- Parameters:
disassociateDelegationSignerFromDomainRequest
-- Returns:
- A Java Future containing the result of the DisassociateDelegationSignerFromDomain operation returned by
the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DuplicateRequestException The request is already in progress for the 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. - OperationLimitExceededException The number of operations or jobs running exceeded the allowed threshold for the account.
- TldRulesViolationException The top-level domain does not support this operation.
- UnsupportedTldException Amazon Route 53 does not support this top-level domain (TLD).
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- Route53DomainsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
disassociateDelegationSignerFromDomain
default CompletableFuture<DisassociateDelegationSignerFromDomainResponse> disassociateDelegationSignerFromDomain(Consumer<DisassociateDelegationSignerFromDomainRequest.Builder> disassociateDelegationSignerFromDomainRequest) Deletes a delegation signer (DS) record in the registry zone for this domain name.
This is a convenience which creates an instance of the
DisassociateDelegationSignerFromDomainRequest.Builder
avoiding the need to create one manually viaDisassociateDelegationSignerFromDomainRequest.builder()
- Parameters:
disassociateDelegationSignerFromDomainRequest
- AConsumer
that will call methods onDisassociateDelegationSignerFromDomainRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the DisassociateDelegationSignerFromDomain operation returned by
the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DuplicateRequestException The request is already in progress for the 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. - OperationLimitExceededException The number of operations or jobs running exceeded the allowed threshold for the account.
- TldRulesViolationException The top-level domain does not support this operation.
- UnsupportedTldException Amazon Route 53 does not support this top-level domain (TLD).
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- Route53DomainsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
enableDomainAutoRenew
default CompletableFuture<EnableDomainAutoRenewResponse> enableDomainAutoRenew(EnableDomainAutoRenewRequest enableDomainAutoRenewRequest) 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 Amazon Web Services 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.
- Parameters:
enableDomainAutoRenewRequest
-- Returns:
- A Java Future containing the result of the EnableDomainAutoRenew operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- 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.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- Route53DomainsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- 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
- See Also:
-
enableDomainAutoRenew
default CompletableFuture<EnableDomainAutoRenewResponse> enableDomainAutoRenew(Consumer<EnableDomainAutoRenewRequest.Builder> enableDomainAutoRenewRequest) 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 Amazon Web Services 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.
This is a convenience which creates an instance of the
EnableDomainAutoRenewRequest.Builder
avoiding the need to create one manually viaEnableDomainAutoRenewRequest.builder()
- Parameters:
enableDomainAutoRenewRequest
- AConsumer
that will call methods onEnableDomainAutoRenewRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the EnableDomainAutoRenew operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- 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.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- Route53DomainsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- 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
- See Also:
-
enableDomainTransferLock
default CompletableFuture<EnableDomainTransferLockResponse> enableDomainTransferLock(EnableDomainTransferLockRequest enableDomainTransferLockRequest) 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.- Parameters:
enableDomainTransferLockRequest
- A request to set the transfer lock for the specified domain.- Returns:
- A Java Future containing the result of the EnableDomainTransferLock operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- 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).
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- Route53DomainsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- 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
- See Also:
-
enableDomainTransferLock
default CompletableFuture<EnableDomainTransferLockResponse> enableDomainTransferLock(Consumer<EnableDomainTransferLockRequest.Builder> enableDomainTransferLockRequest) 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.
This is a convenience which creates an instance of the
EnableDomainTransferLockRequest.Builder
avoiding the need to create one manually viaEnableDomainTransferLockRequest.builder()
- Parameters:
enableDomainTransferLockRequest
- AConsumer
that will call methods onEnableDomainTransferLockRequest.Builder
to create a request. A request to set the transfer lock for the specified domain.- Returns:
- A Java Future containing the result of the EnableDomainTransferLock operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- 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).
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- Route53DomainsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- 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
- See Also:
-
getContactReachabilityStatus
default CompletableFuture<GetContactReachabilityStatusResponse> getContactReachabilityStatus(GetContactReachabilityStatusRequest getContactReachabilityStatusRequest) 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.- Parameters:
getContactReachabilityStatusRequest
-- Returns:
- A Java Future containing the result of the GetContactReachabilityStatus operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- 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).
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- Route53DomainsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- 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
- See Also:
-
getContactReachabilityStatus
default CompletableFuture<GetContactReachabilityStatusResponse> getContactReachabilityStatus(Consumer<GetContactReachabilityStatusRequest.Builder> getContactReachabilityStatusRequest) 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.
This is a convenience which creates an instance of the
GetContactReachabilityStatusRequest.Builder
avoiding the need to create one manually viaGetContactReachabilityStatusRequest.builder()
- Parameters:
getContactReachabilityStatusRequest
- AConsumer
that will call methods onGetContactReachabilityStatusRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the GetContactReachabilityStatus operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- 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).
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- Route53DomainsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- 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
- See Also:
-
getDomainDetail
default CompletableFuture<GetDomainDetailResponse> getDomainDetail(GetDomainDetailRequest getDomainDetailRequest) This operation returns detailed information about a specified domain that is associated with the current Amazon Web Services account. Contact information for the domain is also returned as part of the output.
- Parameters:
getDomainDetailRequest
- The GetDomainDetail request includes the following element.- Returns:
- A Java Future containing the result of the GetDomainDetail operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- 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).
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- Route53DomainsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- 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
- See Also:
-
getDomainDetail
default CompletableFuture<GetDomainDetailResponse> getDomainDetail(Consumer<GetDomainDetailRequest.Builder> getDomainDetailRequest) This operation returns detailed information about a specified domain that is associated with the current Amazon Web Services account. Contact information for the domain is also returned as part of the output.
This is a convenience which creates an instance of the
GetDomainDetailRequest.Builder
avoiding the need to create one manually viaGetDomainDetailRequest.builder()
- Parameters:
getDomainDetailRequest
- AConsumer
that will call methods onGetDomainDetailRequest.Builder
to create a request. The GetDomainDetail request includes the following element.- Returns:
- A Java Future containing the result of the GetDomainDetail operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- 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).
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- Route53DomainsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- 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
- See Also:
-
getDomainSuggestions
default CompletableFuture<GetDomainSuggestionsResponse> getDomainSuggestions(GetDomainSuggestionsRequest getDomainSuggestionsRequest) The GetDomainSuggestions operation returns a list of suggested domain names.
- Parameters:
getDomainSuggestionsRequest
-- Returns:
- A Java Future containing the result of the GetDomainSuggestions operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- 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).
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- Route53DomainsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- 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
- See Also:
-
getDomainSuggestions
default CompletableFuture<GetDomainSuggestionsResponse> getDomainSuggestions(Consumer<GetDomainSuggestionsRequest.Builder> getDomainSuggestionsRequest) The GetDomainSuggestions operation returns a list of suggested domain names.
This is a convenience which creates an instance of the
GetDomainSuggestionsRequest.Builder
avoiding the need to create one manually viaGetDomainSuggestionsRequest.builder()
- Parameters:
getDomainSuggestionsRequest
- AConsumer
that will call methods onGetDomainSuggestionsRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the GetDomainSuggestions operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- 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).
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- Route53DomainsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- 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
- See Also:
-
getOperationDetail
default CompletableFuture<GetOperationDetailResponse> getOperationDetail(GetOperationDetailRequest getOperationDetailRequest) This operation returns the current status of an operation that is not completed.
- Parameters:
getOperationDetailRequest
- The GetOperationDetail request includes the following element.- Returns:
- A Java Future containing the result of the GetOperationDetail operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- 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. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- Route53DomainsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- 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
- See Also:
-
getOperationDetail
default CompletableFuture<GetOperationDetailResponse> getOperationDetail(Consumer<GetOperationDetailRequest.Builder> getOperationDetailRequest) This operation returns the current status of an operation that is not completed.
This is a convenience which creates an instance of the
GetOperationDetailRequest.Builder
avoiding the need to create one manually viaGetOperationDetailRequest.builder()
- Parameters:
getOperationDetailRequest
- AConsumer
that will call methods onGetOperationDetailRequest.Builder
to create a request. The GetOperationDetail request includes the following element.- Returns:
- A Java Future containing the result of the GetOperationDetail operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- 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. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- Route53DomainsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- 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
- See Also:
-
listDomains
This operation returns all the domain names registered with Amazon Route 53 for the current Amazon Web Services account if no filtering conditions are used.
- Parameters:
listDomainsRequest
- The ListDomains request includes the following elements.- Returns:
- A Java Future containing the result of the ListDomains operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- 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. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- Route53DomainsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- 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
- See Also:
-
listDomains
default CompletableFuture<ListDomainsResponse> listDomains(Consumer<ListDomainsRequest.Builder> listDomainsRequest) This operation returns all the domain names registered with Amazon Route 53 for the current Amazon Web Services account if no filtering conditions are used.
This is a convenience which creates an instance of the
ListDomainsRequest.Builder
avoiding the need to create one manually viaListDomainsRequest.builder()
- Parameters:
listDomainsRequest
- AConsumer
that will call methods onListDomainsRequest.Builder
to create a request. The ListDomains request includes the following elements.- Returns:
- A Java Future containing the result of the ListDomains operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- 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. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- Route53DomainsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- 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
- See Also:
-
listDomains
This operation returns all the domain names registered with Amazon Route 53 for the current Amazon Web Services account if no filtering conditions are used.
- Returns:
- A Java Future containing the result of the ListDomains operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- 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. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- Route53DomainsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- 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
- See Also:
-
listDomainsPaginator
This is a variant of
listDomains(software.amazon.awssdk.services.route53domains.model.ListDomainsRequest)
operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber)
. Each call to the subscribe method will result in a newSubscription
i.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper methodsoftware.amazon.awssdk.services.route53domains.paginators.ListDomainsPublisher publisher = client.listDomainsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
software.amazon.awssdk.services.route53domains.paginators.ListDomainsPublisher publisher = client.listDomainsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.route53domains.model.ListDomainsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.route53domains.model.ListDomainsResponse response) { //... }; });
Please notice that the configuration of MaxItems won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listDomains(software.amazon.awssdk.services.route53domains.model.ListDomainsRequest)
operation.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- 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. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- Route53DomainsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- 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
- See Also:
-
listDomainsPaginator
This is a variant of
listDomains(software.amazon.awssdk.services.route53domains.model.ListDomainsRequest)
operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber)
. Each call to the subscribe method will result in a newSubscription
i.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper methodsoftware.amazon.awssdk.services.route53domains.paginators.ListDomainsPublisher publisher = client.listDomainsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
software.amazon.awssdk.services.route53domains.paginators.ListDomainsPublisher publisher = client.listDomainsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.route53domains.model.ListDomainsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.route53domains.model.ListDomainsResponse response) { //... }; });
Please notice that the configuration of MaxItems won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listDomains(software.amazon.awssdk.services.route53domains.model.ListDomainsRequest)
operation.- Parameters:
listDomainsRequest
- The ListDomains request includes the following elements.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- 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. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- Route53DomainsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- 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
- See Also:
-
listDomainsPaginator
default ListDomainsPublisher listDomainsPaginator(Consumer<ListDomainsRequest.Builder> listDomainsRequest) This is a variant of
listDomains(software.amazon.awssdk.services.route53domains.model.ListDomainsRequest)
operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber)
. Each call to the subscribe method will result in a newSubscription
i.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper methodsoftware.amazon.awssdk.services.route53domains.paginators.ListDomainsPublisher publisher = client.listDomainsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
software.amazon.awssdk.services.route53domains.paginators.ListDomainsPublisher publisher = client.listDomainsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.route53domains.model.ListDomainsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.route53domains.model.ListDomainsResponse response) { //... }; });
Please notice that the configuration of MaxItems won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listDomains(software.amazon.awssdk.services.route53domains.model.ListDomainsRequest)
operation.
This is a convenience which creates an instance of the
ListDomainsRequest.Builder
avoiding the need to create one manually viaListDomainsRequest.builder()
- Parameters:
listDomainsRequest
- AConsumer
that will call methods onListDomainsRequest.Builder
to create a request. The ListDomains request includes the following elements.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- 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. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- Route53DomainsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- 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
- See Also:
-
listOperations
default CompletableFuture<ListOperationsResponse> listOperations(ListOperationsRequest listOperationsRequest) 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.
This command runs only in the us-east-1 Region.
- Parameters:
listOperationsRequest
- The ListOperations request includes the following elements.- Returns:
- A Java Future containing the result of the ListOperations operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- 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. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- Route53DomainsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- 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
- See Also:
-
listOperations
default CompletableFuture<ListOperationsResponse> listOperations(Consumer<ListOperationsRequest.Builder> listOperationsRequest) 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.
This command runs only in the us-east-1 Region.
This is a convenience which creates an instance of the
ListOperationsRequest.Builder
avoiding the need to create one manually viaListOperationsRequest.builder()
- Parameters:
listOperationsRequest
- AConsumer
that will call methods onListOperationsRequest.Builder
to create a request. The ListOperations request includes the following elements.- Returns:
- A Java Future containing the result of the ListOperations operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- 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. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- Route53DomainsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- 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
- See Also:
-
listOperations
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.
This command runs only in the us-east-1 Region.
- Returns:
- A Java Future containing the result of the ListOperations operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- 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. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- Route53DomainsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- 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
- See Also:
-
listOperationsPaginator
This is a variant of
listOperations(software.amazon.awssdk.services.route53domains.model.ListOperationsRequest)
operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber)
. Each call to the subscribe method will result in a newSubscription
i.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper methodsoftware.amazon.awssdk.services.route53domains.paginators.ListOperationsPublisher publisher = client.listOperationsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
software.amazon.awssdk.services.route53domains.paginators.ListOperationsPublisher publisher = client.listOperationsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.route53domains.model.ListOperationsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.route53domains.model.ListOperationsResponse response) { //... }; });
Please notice that the configuration of MaxItems won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listOperations(software.amazon.awssdk.services.route53domains.model.ListOperationsRequest)
operation.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- 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. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- Route53DomainsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- 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
- See Also:
-
listOperationsPaginator
default ListOperationsPublisher listOperationsPaginator(ListOperationsRequest listOperationsRequest) This is a variant of
listOperations(software.amazon.awssdk.services.route53domains.model.ListOperationsRequest)
operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber)
. Each call to the subscribe method will result in a newSubscription
i.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper methodsoftware.amazon.awssdk.services.route53domains.paginators.ListOperationsPublisher publisher = client.listOperationsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
software.amazon.awssdk.services.route53domains.paginators.ListOperationsPublisher publisher = client.listOperationsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.route53domains.model.ListOperationsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.route53domains.model.ListOperationsResponse response) { //... }; });
Please notice that the configuration of MaxItems won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listOperations(software.amazon.awssdk.services.route53domains.model.ListOperationsRequest)
operation.- Parameters:
listOperationsRequest
- The ListOperations request includes the following elements.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- 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. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- Route53DomainsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- 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
- See Also:
-
listOperationsPaginator
default ListOperationsPublisher listOperationsPaginator(Consumer<ListOperationsRequest.Builder> listOperationsRequest) This is a variant of
listOperations(software.amazon.awssdk.services.route53domains.model.ListOperationsRequest)
operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber)
. Each call to the subscribe method will result in a newSubscription
i.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper methodsoftware.amazon.awssdk.services.route53domains.paginators.ListOperationsPublisher publisher = client.listOperationsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
software.amazon.awssdk.services.route53domains.paginators.ListOperationsPublisher publisher = client.listOperationsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.route53domains.model.ListOperationsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.route53domains.model.ListOperationsResponse response) { //... }; });
Please notice that the configuration of MaxItems won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listOperations(software.amazon.awssdk.services.route53domains.model.ListOperationsRequest)
operation.
This is a convenience which creates an instance of the
ListOperationsRequest.Builder
avoiding the need to create one manually viaListOperationsRequest.builder()
- Parameters:
listOperationsRequest
- AConsumer
that will call methods onListOperationsRequest.Builder
to create a request. The ListOperations request includes the following elements.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- 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. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- Route53DomainsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- 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
- See Also:
-
listPrices
Lists the following prices for either all the TLDs supported by Route 53, or the specified TLD:
-
Registration
-
Transfer
-
Owner change
-
Domain renewal
-
Domain restoration
- Parameters:
listPricesRequest
-- Returns:
- A Java Future containing the result of the ListPrices operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- 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).
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- Route53DomainsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- 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
- See Also:
-
-
listPrices
default CompletableFuture<ListPricesResponse> listPrices(Consumer<ListPricesRequest.Builder> listPricesRequest) Lists the following prices for either all the TLDs supported by Route 53, or the specified TLD:
-
Registration
-
Transfer
-
Owner change
-
Domain renewal
-
Domain restoration
This is a convenience which creates an instance of the
ListPricesRequest.Builder
avoiding the need to create one manually viaListPricesRequest.builder()
- Parameters:
listPricesRequest
- AConsumer
that will call methods onListPricesRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the ListPrices operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- 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).
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- Route53DomainsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- 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
- See Also:
-
-
listPricesPaginator
This is a variant of
listPrices(software.amazon.awssdk.services.route53domains.model.ListPricesRequest)
operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber)
. Each call to the subscribe method will result in a newSubscription
i.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper methodsoftware.amazon.awssdk.services.route53domains.paginators.ListPricesPublisher publisher = client.listPricesPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
software.amazon.awssdk.services.route53domains.paginators.ListPricesPublisher publisher = client.listPricesPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.route53domains.model.ListPricesResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.route53domains.model.ListPricesResponse response) { //... }; });
Please notice that the configuration of MaxItems won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listPrices(software.amazon.awssdk.services.route53domains.model.ListPricesRequest)
operation.- Parameters:
listPricesRequest
-- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- 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).
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- Route53DomainsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- 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
- See Also:
-
listPricesPaginator
default ListPricesPublisher listPricesPaginator(Consumer<ListPricesRequest.Builder> listPricesRequest) This is a variant of
listPrices(software.amazon.awssdk.services.route53domains.model.ListPricesRequest)
operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber)
. Each call to the subscribe method will result in a newSubscription
i.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper methodsoftware.amazon.awssdk.services.route53domains.paginators.ListPricesPublisher publisher = client.listPricesPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
software.amazon.awssdk.services.route53domains.paginators.ListPricesPublisher publisher = client.listPricesPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.route53domains.model.ListPricesResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.route53domains.model.ListPricesResponse response) { //... }; });
Please notice that the configuration of MaxItems won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listPrices(software.amazon.awssdk.services.route53domains.model.ListPricesRequest)
operation.
This is a convenience which creates an instance of the
ListPricesRequest.Builder
avoiding the need to create one manually viaListPricesRequest.builder()
- Parameters:
listPricesRequest
- AConsumer
that will call methods onListPricesRequest.Builder
to create a request.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- 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).
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- Route53DomainsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- 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
- See Also:
-
listTagsForDomain
default CompletableFuture<ListTagsForDomainResponse> listTagsForDomain(ListTagsForDomainRequest listTagsForDomainRequest) 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.
- Parameters:
listTagsForDomainRequest
- The ListTagsForDomainRequest includes the following elements.- Returns:
- A Java Future containing the result of the ListTagsForDomain operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- 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).
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- Route53DomainsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- 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
- See Also:
-
listTagsForDomain
default CompletableFuture<ListTagsForDomainResponse> listTagsForDomain(Consumer<ListTagsForDomainRequest.Builder> listTagsForDomainRequest) 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.
This is a convenience which creates an instance of the
ListTagsForDomainRequest.Builder
avoiding the need to create one manually viaListTagsForDomainRequest.builder()
- Parameters:
listTagsForDomainRequest
- AConsumer
that will call methods onListTagsForDomainRequest.Builder
to create a request. The ListTagsForDomainRequest includes the following elements.- Returns:
- A Java Future containing the result of the ListTagsForDomain operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- 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).
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- Route53DomainsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- 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
- See Also:
-
pushDomain
Moves a domain from Amazon Web Services to another registrar.
Supported actions:
-
Changes the IPS tags of a .uk domain, and pushes it to transit. Transit means that the domain is ready to be transferred to another registrar.
- Parameters:
pushDomainRequest
-- Returns:
- A Java Future containing the result of the PushDomain operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- 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).
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- Route53DomainsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- 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
- See Also:
-
-
pushDomain
default CompletableFuture<PushDomainResponse> pushDomain(Consumer<PushDomainRequest.Builder> pushDomainRequest) Moves a domain from Amazon Web Services to another registrar.
Supported actions:
-
Changes the IPS tags of a .uk domain, and pushes it to transit. Transit means that the domain is ready to be transferred to another registrar.
This is a convenience which creates an instance of the
PushDomainRequest.Builder
avoiding the need to create one manually viaPushDomainRequest.builder()
- Parameters:
pushDomainRequest
- AConsumer
that will call methods onPushDomainRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the PushDomain operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- 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).
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- Route53DomainsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- 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
- See Also:
-
-
registerDomain
default CompletableFuture<RegisterDomainResponse> registerDomain(RegisterDomainRequest registerDomainRequest) This operation registers a domain. 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 auto renew, 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 for the registrar or the phrase "REDACTED FOR PRIVACY", or "On behalf of <domain name> owner." If you don't enable privacy protection, WHOIS queries return the information that you entered for the administrative, registrant, and technical contacts.
While some domains may allow different privacy settings per contact, we recommend specifying the same privacy setting for all 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 Amazon Web Services account an amount based on the top-level domain. For more information, see Amazon Route 53 Pricing.
- Parameters:
registerDomainRequest
- The RegisterDomain request includes the following elements.- Returns:
- A Java Future containing the result of the RegisterDomain operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- 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.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- Route53DomainsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- 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
- See Also:
-
-
registerDomain
default CompletableFuture<RegisterDomainResponse> registerDomain(Consumer<RegisterDomainRequest.Builder> registerDomainRequest) This operation registers a domain. 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 auto renew, 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 for the registrar or the phrase "REDACTED FOR PRIVACY", or "On behalf of <domain name> owner." If you don't enable privacy protection, WHOIS queries return the information that you entered for the administrative, registrant, and technical contacts.
While some domains may allow different privacy settings per contact, we recommend specifying the same privacy setting for all 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 Amazon Web Services account an amount based on the top-level domain. For more information, see Amazon Route 53 Pricing.
This is a convenience which creates an instance of the
RegisterDomainRequest.Builder
avoiding the need to create one manually viaRegisterDomainRequest.builder()
- Parameters:
registerDomainRequest
- AConsumer
that will call methods onRegisterDomainRequest.Builder
to create a request. The RegisterDomain request includes the following elements.- Returns:
- A Java Future containing the result of the RegisterDomain operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- 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.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- Route53DomainsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- 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
- See Also:
-
-
rejectDomainTransferFromAnotherAwsAccount
default CompletableFuture<RejectDomainTransferFromAnotherAwsAccountResponse> rejectDomainTransferFromAnotherAwsAccount(RejectDomainTransferFromAnotherAwsAccountRequest rejectDomainTransferFromAnotherAwsAccountRequest) Rejects the transfer of a domain from another Amazon Web Services account to the current Amazon Web Services account. You initiate a transfer betweenAmazon Web Services 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
.- Parameters:
rejectDomainTransferFromAnotherAwsAccountRequest
- The RejectDomainTransferFromAnotherAwsAccount request includes the following element.- Returns:
- A Java Future containing the result of the RejectDomainTransferFromAnotherAwsAccount operation returned
by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- 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).
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- Route53DomainsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- 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
- See Also:
-
rejectDomainTransferFromAnotherAwsAccount
default CompletableFuture<RejectDomainTransferFromAnotherAwsAccountResponse> rejectDomainTransferFromAnotherAwsAccount(Consumer<RejectDomainTransferFromAnotherAwsAccountRequest.Builder> rejectDomainTransferFromAnotherAwsAccountRequest) Rejects the transfer of a domain from another Amazon Web Services account to the current Amazon Web Services account. You initiate a transfer betweenAmazon Web Services 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
.
This is a convenience which creates an instance of the
RejectDomainTransferFromAnotherAwsAccountRequest.Builder
avoiding the need to create one manually viaRejectDomainTransferFromAnotherAwsAccountRequest.builder()
- Parameters:
rejectDomainTransferFromAnotherAwsAccountRequest
- AConsumer
that will call methods onRejectDomainTransferFromAnotherAwsAccountRequest.Builder
to create a request. The RejectDomainTransferFromAnotherAwsAccount request includes the following element.- Returns:
- A Java Future containing the result of the RejectDomainTransferFromAnotherAwsAccount operation returned
by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- 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).
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- Route53DomainsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- 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
- See Also:
-
renewDomain
This operation renews a domain for the specified number of years. The cost of renewing your domain is billed to your Amazon Web Services 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.
- Parameters:
renewDomainRequest
- ARenewDomain
request includes the number of years that you want to renew for and the current expiration year.- Returns:
- A Java Future containing the result of the RenewDomain operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- 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.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- Route53DomainsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- 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
- See Also:
-
renewDomain
default CompletableFuture<RenewDomainResponse> renewDomain(Consumer<RenewDomainRequest.Builder> renewDomainRequest) This operation renews a domain for the specified number of years. The cost of renewing your domain is billed to your Amazon Web Services 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.
This is a convenience which creates an instance of the
RenewDomainRequest.Builder
avoiding the need to create one manually viaRenewDomainRequest.builder()
- Parameters:
renewDomainRequest
- AConsumer
that will call methods onRenewDomainRequest.Builder
to create a request. ARenewDomain
request includes the number of years that you want to renew for and the current expiration year.- Returns:
- A Java Future containing the result of the RenewDomain operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- 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.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- Route53DomainsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- 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
- See Also:
-
resendContactReachabilityEmail
default CompletableFuture<ResendContactReachabilityEmailResponse> resendContactReachabilityEmail(ResendContactReachabilityEmailRequest resendContactReachabilityEmailRequest) 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.
- Parameters:
resendContactReachabilityEmailRequest
-- Returns:
- A Java Future containing the result of the ResendContactReachabilityEmail operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- 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).
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- Route53DomainsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- 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
- See Also:
-
resendContactReachabilityEmail
default CompletableFuture<ResendContactReachabilityEmailResponse> resendContactReachabilityEmail(Consumer<ResendContactReachabilityEmailRequest.Builder> resendContactReachabilityEmailRequest) 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.
This is a convenience which creates an instance of the
ResendContactReachabilityEmailRequest.Builder
avoiding the need to create one manually viaResendContactReachabilityEmailRequest.builder()
- Parameters:
resendContactReachabilityEmailRequest
- AConsumer
that will call methods onResendContactReachabilityEmailRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the ResendContactReachabilityEmail operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- 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).
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- Route53DomainsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- 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
- See Also:
-
resendContactReachabilityEmail
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.
- Returns:
- A Java Future containing the result of the ResendContactReachabilityEmail operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- 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).
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- Route53DomainsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- 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
- See Also:
-
resendOperationAuthorization
default CompletableFuture<ResendOperationAuthorizationResponse> resendOperationAuthorization(ResendOperationAuthorizationRequest resendOperationAuthorizationRequest) Resend the form of authorization email for this operation.
- Parameters:
resendOperationAuthorizationRequest
-- Returns:
- A Java Future containing the result of the ResendOperationAuthorization operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- 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. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- Route53DomainsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- 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
- See Also:
-
resendOperationAuthorization
default CompletableFuture<ResendOperationAuthorizationResponse> resendOperationAuthorization(Consumer<ResendOperationAuthorizationRequest.Builder> resendOperationAuthorizationRequest) Resend the form of authorization email for this operation.
This is a convenience which creates an instance of the
ResendOperationAuthorizationRequest.Builder
avoiding the need to create one manually viaResendOperationAuthorizationRequest.builder()
- Parameters:
resendOperationAuthorizationRequest
- AConsumer
that will call methods onResendOperationAuthorizationRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the ResendOperationAuthorization operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- 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. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- Route53DomainsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- 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
- See Also:
-
retrieveDomainAuthCode
default CompletableFuture<RetrieveDomainAuthCodeResponse> retrieveDomainAuthCode(RetrieveDomainAuthCodeRequest retrieveDomainAuthCodeRequest) This operation returns the authorization code for the domain. To transfer a domain to another registrar, you provide this value to the new registrar.
- Parameters:
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.- Returns:
- A Java Future containing the result of the RetrieveDomainAuthCode operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- 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).
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- Route53DomainsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- 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
- See Also:
-
retrieveDomainAuthCode
default CompletableFuture<RetrieveDomainAuthCodeResponse> retrieveDomainAuthCode(Consumer<RetrieveDomainAuthCodeRequest.Builder> retrieveDomainAuthCodeRequest) This operation returns the authorization code for the domain. To transfer a domain to another registrar, you provide this value to the new registrar.
This is a convenience which creates an instance of the
RetrieveDomainAuthCodeRequest.Builder
avoiding the need to create one manually viaRetrieveDomainAuthCodeRequest.builder()
- Parameters:
retrieveDomainAuthCodeRequest
- AConsumer
that will call methods onRetrieveDomainAuthCodeRequest.Builder
to create a request. 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.- Returns:
- A Java Future containing the result of the RetrieveDomainAuthCode operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- 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).
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- Route53DomainsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- 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
- See Also:
-
transferDomain
default CompletableFuture<TransferDomainResponse> transferDomain(TransferDomainRequest transferDomainRequest) Transfers a domain from another registrar to Amazon Route 53.
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 Amazon Web Services 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.
During the transfer of any country code top-level domains (ccTLDs) to Route 53, except for .cc and .tv, updates to the owner contact are ignored and the owner contact data from the registry is used. You can update the owner contact after the transfer is complete. For more information, see UpdateDomainContact.
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.
- Parameters:
transferDomainRequest
- The TransferDomain request includes the following elements.- Returns:
- A Java Future containing the result of the TransferDomain operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- 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.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- Route53DomainsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- 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
- See Also:
-
-
transferDomain
default CompletableFuture<TransferDomainResponse> transferDomain(Consumer<TransferDomainRequest.Builder> transferDomainRequest) Transfers a domain from another registrar to Amazon Route 53.
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 Amazon Web Services 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.
During the transfer of any country code top-level domains (ccTLDs) to Route 53, except for .cc and .tv, updates to the owner contact are ignored and the owner contact data from the registry is used. You can update the owner contact after the transfer is complete. For more information, see UpdateDomainContact.
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.
This is a convenience which creates an instance of the
TransferDomainRequest.Builder
avoiding the need to create one manually viaTransferDomainRequest.builder()
- Parameters:
transferDomainRequest
- AConsumer
that will call methods onTransferDomainRequest.Builder
to create a request. The TransferDomain request includes the following elements.- Returns:
- A Java Future containing the result of the TransferDomain operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- 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.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- Route53DomainsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- 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
- See Also:
-
-
transferDomainToAnotherAwsAccount
default CompletableFuture<TransferDomainToAnotherAwsAccountResponse> transferDomainToAnotherAwsAccount(TransferDomainToAnotherAwsAccountRequest transferDomainToAnotherAwsAccountRequest) Transfers a domain from the current Amazon Web Services account to another Amazon Web Services account. Note the following:
-
The Amazon Web Services 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 Amazon Web Services 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 Amazon Web Services account, see Migrating a Hosted Zone to a Different Amazon Web Services 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
.- Parameters:
transferDomainToAnotherAwsAccountRequest
- The TransferDomainToAnotherAwsAccount request includes the following elements.- Returns:
- A Java Future containing the result of the TransferDomainToAnotherAwsAccount operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- 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.
- UnsupportedTldException Amazon Route 53 does not support this top-level domain (TLD).
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- Route53DomainsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- 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
- See Also:
-
-
transferDomainToAnotherAwsAccount
default CompletableFuture<TransferDomainToAnotherAwsAccountResponse> transferDomainToAnotherAwsAccount(Consumer<TransferDomainToAnotherAwsAccountRequest.Builder> transferDomainToAnotherAwsAccountRequest) Transfers a domain from the current Amazon Web Services account to another Amazon Web Services account. Note the following:
-
The Amazon Web Services 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 Amazon Web Services 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 Amazon Web Services account, see Migrating a Hosted Zone to a Different Amazon Web Services 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
.
This is a convenience which creates an instance of the
TransferDomainToAnotherAwsAccountRequest.Builder
avoiding the need to create one manually viaTransferDomainToAnotherAwsAccountRequest.builder()
- Parameters:
transferDomainToAnotherAwsAccountRequest
- AConsumer
that will call methods onTransferDomainToAnotherAwsAccountRequest.Builder
to create a request. The TransferDomainToAnotherAwsAccount request includes the following elements.- Returns:
- A Java Future containing the result of the TransferDomainToAnotherAwsAccount operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- 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.
- UnsupportedTldException Amazon Route 53 does not support this top-level domain (TLD).
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- Route53DomainsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- 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
- See Also:
-
-
updateDomainContact
default CompletableFuture<UpdateDomainContactResponse> updateDomainContact(UpdateDomainContactRequest updateDomainContactRequest) 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 operation. If the request is not completed successfully, the domain registrant will be notified by email.
- Parameters:
updateDomainContactRequest
- The UpdateDomainContact request includes the following elements.- Returns:
- A Java Future containing the result of the UpdateDomainContact operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- 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).
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- Route53DomainsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- 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
- See Also:
-
updateDomainContact
default CompletableFuture<UpdateDomainContactResponse> updateDomainContact(Consumer<UpdateDomainContactRequest.Builder> updateDomainContactRequest) 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 operation. If the request is not completed successfully, the domain registrant will be notified by email.
This is a convenience which creates an instance of the
UpdateDomainContactRequest.Builder
avoiding the need to create one manually viaUpdateDomainContactRequest.builder()
- Parameters:
updateDomainContactRequest
- AConsumer
that will call methods onUpdateDomainContactRequest.Builder
to create a request. The UpdateDomainContact request includes the following elements.- Returns:
- A Java Future containing the result of the UpdateDomainContact operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- 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).
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- Route53DomainsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- 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
- See Also:
-
updateDomainContactPrivacy
default CompletableFuture<UpdateDomainContactPrivacyResponse> updateDomainContactPrivacy(UpdateDomainContactPrivacyRequest updateDomainContactPrivacyRequest) This operation updates the specified domain contact's privacy setting. When privacy protection is enabled, your contact information is replaced with contact information for the registrar or with the phrase "REDACTED FOR PRIVACY", or "On behalf of <domain name> owner."
While some domains may allow different privacy settings per contact, we recommend specifying the same privacy setting for all contacts.
This operation affects only the contact information for the specified contact type (administrative, registrant, or technical). 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/.- Parameters:
updateDomainContactPrivacyRequest
- The UpdateDomainContactPrivacy request includes the following elements.- Returns:
- A Java Future containing the result of the UpdateDomainContactPrivacy operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- 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).
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- Route53DomainsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- 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
- See Also:
-
updateDomainContactPrivacy
default CompletableFuture<UpdateDomainContactPrivacyResponse> updateDomainContactPrivacy(Consumer<UpdateDomainContactPrivacyRequest.Builder> updateDomainContactPrivacyRequest) This operation updates the specified domain contact's privacy setting. When privacy protection is enabled, your contact information is replaced with contact information for the registrar or with the phrase "REDACTED FOR PRIVACY", or "On behalf of <domain name> owner."
While some domains may allow different privacy settings per contact, we recommend specifying the same privacy setting for all contacts.
This operation affects only the contact information for the specified contact type (administrative, registrant, or technical). 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/.
This is a convenience which creates an instance of the
UpdateDomainContactPrivacyRequest.Builder
avoiding the need to create one manually viaUpdateDomainContactPrivacyRequest.builder()
- Parameters:
updateDomainContactPrivacyRequest
- AConsumer
that will call methods onUpdateDomainContactPrivacyRequest.Builder
to create a request. The UpdateDomainContactPrivacy request includes the following elements.- Returns:
- A Java Future containing the result of the UpdateDomainContactPrivacy operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- 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).
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- Route53DomainsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- 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
- See Also:
-
updateDomainNameservers
default CompletableFuture<UpdateDomainNameserversResponse> updateDomainNameservers(UpdateDomainNameserversRequest updateDomainNameserversRequest) 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.
- Parameters:
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.
- Returns:
- A Java Future containing the result of the UpdateDomainNameservers operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- 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).
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- Route53DomainsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- 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
- See Also:
-
updateDomainNameservers
default CompletableFuture<UpdateDomainNameserversResponse> updateDomainNameservers(Consumer<UpdateDomainNameserversRequest.Builder> updateDomainNameserversRequest) 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.
This is a convenience which creates an instance of the
UpdateDomainNameserversRequest.Builder
avoiding the need to create one manually viaUpdateDomainNameserversRequest.builder()
- Parameters:
updateDomainNameserversRequest
- AConsumer
that will call methods onUpdateDomainNameserversRequest.Builder
to create a request. 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.
- Returns:
- A Java Future containing the result of the UpdateDomainNameservers operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- 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).
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- Route53DomainsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- 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
- See Also:
-
updateTagsForDomain
default CompletableFuture<UpdateTagsForDomainResponse> updateTagsForDomain(UpdateTagsForDomainRequest updateTagsForDomainRequest) 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.
- Parameters:
updateTagsForDomainRequest
- The UpdateTagsForDomainRequest includes the following elements.- Returns:
- A Java Future containing the result of the UpdateTagsForDomain operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- 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).
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- Route53DomainsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- 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
- See Also:
-
updateTagsForDomain
default CompletableFuture<UpdateTagsForDomainResponse> updateTagsForDomain(Consumer<UpdateTagsForDomainRequest.Builder> updateTagsForDomainRequest) 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.
This is a convenience which creates an instance of the
UpdateTagsForDomainRequest.Builder
avoiding the need to create one manually viaUpdateTagsForDomainRequest.builder()
- Parameters:
updateTagsForDomainRequest
- AConsumer
that will call methods onUpdateTagsForDomainRequest.Builder
to create a request. The UpdateTagsForDomainRequest includes the following elements.- Returns:
- A Java Future containing the result of the UpdateTagsForDomain operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- 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).
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- Route53DomainsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- 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
- See Also:
-
viewBilling
Returns all the domain-related billing records for the current Amazon Web Services account for a specified period
- Parameters:
viewBillingRequest
- The ViewBilling request includes the following elements.- Returns:
- A Java Future containing the result of the ViewBilling operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- 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. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- Route53DomainsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- 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
- See Also:
-
viewBilling
default CompletableFuture<ViewBillingResponse> viewBilling(Consumer<ViewBillingRequest.Builder> viewBillingRequest) Returns all the domain-related billing records for the current Amazon Web Services account for a specified period
This is a convenience which creates an instance of the
ViewBillingRequest.Builder
avoiding the need to create one manually viaViewBillingRequest.builder()
- Parameters:
viewBillingRequest
- AConsumer
that will call methods onViewBillingRequest.Builder
to create a request. The ViewBilling request includes the following elements.- Returns:
- A Java Future containing the result of the ViewBilling operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- 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. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- Route53DomainsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- 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
- See Also:
-
viewBillingPaginator
This is a variant of
viewBilling(software.amazon.awssdk.services.route53domains.model.ViewBillingRequest)
operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber)
. Each call to the subscribe method will result in a newSubscription
i.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper methodsoftware.amazon.awssdk.services.route53domains.paginators.ViewBillingPublisher publisher = client.viewBillingPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
software.amazon.awssdk.services.route53domains.paginators.ViewBillingPublisher publisher = client.viewBillingPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.route53domains.model.ViewBillingResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.route53domains.model.ViewBillingResponse response) { //... }; });
Please notice that the configuration of MaxItems won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
viewBilling(software.amazon.awssdk.services.route53domains.model.ViewBillingRequest)
operation.- Parameters:
viewBillingRequest
- The ViewBilling request includes the following elements.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- 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. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- Route53DomainsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- 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
- See Also:
-
viewBillingPaginator
default ViewBillingPublisher viewBillingPaginator(Consumer<ViewBillingRequest.Builder> viewBillingRequest) This is a variant of
viewBilling(software.amazon.awssdk.services.route53domains.model.ViewBillingRequest)
operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber)
. Each call to the subscribe method will result in a newSubscription
i.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper methodsoftware.amazon.awssdk.services.route53domains.paginators.ViewBillingPublisher publisher = client.viewBillingPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
software.amazon.awssdk.services.route53domains.paginators.ViewBillingPublisher publisher = client.viewBillingPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.route53domains.model.ViewBillingResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.route53domains.model.ViewBillingResponse response) { //... }; });
Please notice that the configuration of MaxItems won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
viewBilling(software.amazon.awssdk.services.route53domains.model.ViewBillingRequest)
operation.
This is a convenience which creates an instance of the
ViewBillingRequest.Builder
avoiding the need to create one manually viaViewBillingRequest.builder()
- Parameters:
viewBillingRequest
- AConsumer
that will call methods onViewBillingRequest.Builder
to create a request. The ViewBilling request includes the following elements.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- 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. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- Route53DomainsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- 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
- See Also:
-
serviceClientConfiguration
Description copied from interface:SdkClient
The SDK service client configuration exposes client settings to the user, e.g., ClientOverrideConfiguration- Specified by:
serviceClientConfiguration
in interfaceAwsClient
- Specified by:
serviceClientConfiguration
in interfaceSdkClient
- Returns:
- SdkServiceClientConfiguration
-
create
Create aRoute53DomainsAsyncClient
with the region loaded from theDefaultAwsRegionProviderChain
and credentials loaded from theDefaultCredentialsProvider
. -
builder
Create a builder that can be used to configure and create aRoute53DomainsAsyncClient
.
-