Interface AccountAsyncClient

All Superinterfaces:
AutoCloseable, AwsClient, SdkAutoCloseable, SdkClient
@Generated("software.amazon.awssdk:codegen") @ThreadSafe public interface AccountAsyncClient extends AwsClient
Service client for accessing AWS Account asynchronously. This can be created using the static builder() method.The asynchronous client performs non-blocking I/O when configured with any SdkAsyncHttpClient supported in the SDK. However, full non-blocking is not guaranteed as the async client may perform blocking calls in some cases such as credentials retrieval and endpoint discovery as part of the async API call.

Operations for Amazon Web Services Account Management

  • Field Details

  • Method Details

    • acceptPrimaryEmailUpdate

      default CompletableFuture<AcceptPrimaryEmailUpdateResponse> acceptPrimaryEmailUpdate(AcceptPrimaryEmailUpdateRequest acceptPrimaryEmailUpdateRequest)

      Accepts the request that originated from StartPrimaryEmailUpdate to update the primary email address (also known as the root user email address) for the specified account.

      Parameters:
      acceptPrimaryEmailUpdateRequest -
      Returns:
      A Java Future containing the result of the AcceptPrimaryEmailUpdate 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 invoke Throwable.getCause() to retrieve the underlying exception.
      • ResourceNotFoundException The operation failed because it specified a resource that can't be found.
      • AccessDeniedException The operation failed because the calling identity doesn't have the minimum required permissions.
      • ValidationException The operation failed because one of the input parameters was invalid.
      • ConflictException The request could not be processed because of a conflict in the current status of the resource. For example, this happens if you try to enable a Region that is currently being disabled (in a status of DISABLING) or if you try to change an account’s root user email to an email address which is already in use.
      • TooManyRequestsException The operation failed because it was called too frequently and exceeded a throttle limit.
      • InternalServerException The operation failed because of an error internal to Amazon Web Services. Try your operation again later.
      • 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.
      • AccountException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • acceptPrimaryEmailUpdate

      default CompletableFuture<AcceptPrimaryEmailUpdateResponse> acceptPrimaryEmailUpdate(Consumer<AcceptPrimaryEmailUpdateRequest.Builder> acceptPrimaryEmailUpdateRequest)

      Accepts the request that originated from StartPrimaryEmailUpdate to update the primary email address (also known as the root user email address) for the specified account.


      This is a convenience which creates an instance of the AcceptPrimaryEmailUpdateRequest.Builder avoiding the need to create one manually via AcceptPrimaryEmailUpdateRequest.builder()

      Parameters:
      acceptPrimaryEmailUpdateRequest - A Consumer that will call methods on AcceptPrimaryEmailUpdateRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the AcceptPrimaryEmailUpdate 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 invoke Throwable.getCause() to retrieve the underlying exception.
      • ResourceNotFoundException The operation failed because it specified a resource that can't be found.
      • AccessDeniedException The operation failed because the calling identity doesn't have the minimum required permissions.
      • ValidationException The operation failed because one of the input parameters was invalid.
      • ConflictException The request could not be processed because of a conflict in the current status of the resource. For example, this happens if you try to enable a Region that is currently being disabled (in a status of DISABLING) or if you try to change an account’s root user email to an email address which is already in use.
      • TooManyRequestsException The operation failed because it was called too frequently and exceeded a throttle limit.
      • InternalServerException The operation failed because of an error internal to Amazon Web Services. Try your operation again later.
      • 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.
      • AccountException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • deleteAlternateContact

      default CompletableFuture<DeleteAlternateContactResponse> deleteAlternateContact(DeleteAlternateContactRequest deleteAlternateContactRequest)

      Deletes the specified alternate contact from an Amazon Web Services account.

      For complete details about how to use the alternate contact operations, see Access or updating the alternate contacts.

      Before you can update the alternate contact information for an Amazon Web Services account that is managed by Organizations, you must first enable integration between Amazon Web Services Account Management and Organizations. For more information, see Enabling trusted access for Amazon Web Services Account Management.

      Parameters:
      deleteAlternateContactRequest -
      Returns:
      A Java Future containing the result of the DeleteAlternateContact 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 invoke Throwable.getCause() to retrieve the underlying exception.
      • ResourceNotFoundException The operation failed because it specified a resource that can't be found.
      • ValidationException The operation failed because one of the input parameters was invalid.
      • AccessDeniedException The operation failed because the calling identity doesn't have the minimum required permissions.
      • TooManyRequestsException The operation failed because it was called too frequently and exceeded a throttle limit.
      • InternalServerException The operation failed because of an error internal to Amazon Web Services. Try your operation again later.
      • 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.
      • AccountException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • deleteAlternateContact

      default CompletableFuture<DeleteAlternateContactResponse> deleteAlternateContact(Consumer<DeleteAlternateContactRequest.Builder> deleteAlternateContactRequest)

      Deletes the specified alternate contact from an Amazon Web Services account.

      For complete details about how to use the alternate contact operations, see Access or updating the alternate contacts.

      Before you can update the alternate contact information for an Amazon Web Services account that is managed by Organizations, you must first enable integration between Amazon Web Services Account Management and Organizations. For more information, see Enabling trusted access for Amazon Web Services Account Management.


      This is a convenience which creates an instance of the DeleteAlternateContactRequest.Builder avoiding the need to create one manually via DeleteAlternateContactRequest.builder()

      Parameters:
      deleteAlternateContactRequest - A Consumer that will call methods on DeleteAlternateContactRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the DeleteAlternateContact 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 invoke Throwable.getCause() to retrieve the underlying exception.
      • ResourceNotFoundException The operation failed because it specified a resource that can't be found.
      • ValidationException The operation failed because one of the input parameters was invalid.
      • AccessDeniedException The operation failed because the calling identity doesn't have the minimum required permissions.
      • TooManyRequestsException The operation failed because it was called too frequently and exceeded a throttle limit.
      • InternalServerException The operation failed because of an error internal to Amazon Web Services. Try your operation again later.
      • 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.
      • AccountException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • disableRegion

      default CompletableFuture<DisableRegionResponse> disableRegion(DisableRegionRequest disableRegionRequest)

      Disables (opts-out) a particular Region for an account.

      The act of disabling a Region will remove all IAM access to any resources that reside in that Region.

      Parameters:
      disableRegionRequest -
      Returns:
      A Java Future containing the result of the DisableRegion 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 invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The operation failed because the calling identity doesn't have the minimum required permissions.
      • ValidationException The operation failed because one of the input parameters was invalid.
      • ConflictException The request could not be processed because of a conflict in the current status of the resource. For example, this happens if you try to enable a Region that is currently being disabled (in a status of DISABLING) or if you try to change an account’s root user email to an email address which is already in use.
      • TooManyRequestsException The operation failed because it was called too frequently and exceeded a throttle limit.
      • InternalServerException The operation failed because of an error internal to Amazon Web Services. Try your operation again later.
      • 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.
      • AccountException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • disableRegion

      default CompletableFuture<DisableRegionResponse> disableRegion(Consumer<DisableRegionRequest.Builder> disableRegionRequest)

      Disables (opts-out) a particular Region for an account.

      The act of disabling a Region will remove all IAM access to any resources that reside in that Region.


      This is a convenience which creates an instance of the DisableRegionRequest.Builder avoiding the need to create one manually via DisableRegionRequest.builder()

      Parameters:
      disableRegionRequest - A Consumer that will call methods on DisableRegionRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the DisableRegion 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 invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The operation failed because the calling identity doesn't have the minimum required permissions.
      • ValidationException The operation failed because one of the input parameters was invalid.
      • ConflictException The request could not be processed because of a conflict in the current status of the resource. For example, this happens if you try to enable a Region that is currently being disabled (in a status of DISABLING) or if you try to change an account’s root user email to an email address which is already in use.
      • TooManyRequestsException The operation failed because it was called too frequently and exceeded a throttle limit.
      • InternalServerException The operation failed because of an error internal to Amazon Web Services. Try your operation again later.
      • 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.
      • AccountException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • enableRegion

      default CompletableFuture<EnableRegionResponse> enableRegion(EnableRegionRequest enableRegionRequest)

      Enables (opts-in) a particular Region for an account.

      Parameters:
      enableRegionRequest -
      Returns:
      A Java Future containing the result of the EnableRegion 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 invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The operation failed because the calling identity doesn't have the minimum required permissions.
      • ValidationException The operation failed because one of the input parameters was invalid.
      • ConflictException The request could not be processed because of a conflict in the current status of the resource. For example, this happens if you try to enable a Region that is currently being disabled (in a status of DISABLING) or if you try to change an account’s root user email to an email address which is already in use.
      • TooManyRequestsException The operation failed because it was called too frequently and exceeded a throttle limit.
      • InternalServerException The operation failed because of an error internal to Amazon Web Services. Try your operation again later.
      • 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.
      • AccountException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • enableRegion

      default CompletableFuture<EnableRegionResponse> enableRegion(Consumer<EnableRegionRequest.Builder> enableRegionRequest)

      Enables (opts-in) a particular Region for an account.


      This is a convenience which creates an instance of the EnableRegionRequest.Builder avoiding the need to create one manually via EnableRegionRequest.builder()

      Parameters:
      enableRegionRequest - A Consumer that will call methods on EnableRegionRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the EnableRegion 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 invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The operation failed because the calling identity doesn't have the minimum required permissions.
      • ValidationException The operation failed because one of the input parameters was invalid.
      • ConflictException The request could not be processed because of a conflict in the current status of the resource. For example, this happens if you try to enable a Region that is currently being disabled (in a status of DISABLING) or if you try to change an account’s root user email to an email address which is already in use.
      • TooManyRequestsException The operation failed because it was called too frequently and exceeded a throttle limit.
      • InternalServerException The operation failed because of an error internal to Amazon Web Services. Try your operation again later.
      • 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.
      • AccountException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getAccountInformation

      default CompletableFuture<GetAccountInformationResponse> getAccountInformation(GetAccountInformationRequest getAccountInformationRequest)

      Retrieves information about the specified account including its account name, account ID, and account creation date and time. To use this API, an IAM user or role must have the account:GetAccountInformation IAM permission.

      Parameters:
      getAccountInformationRequest -
      Returns:
      A Java Future containing the result of the GetAccountInformation 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 invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The operation failed because the calling identity doesn't have the minimum required permissions.
      • ValidationException The operation failed because one of the input parameters was invalid.
      • TooManyRequestsException The operation failed because it was called too frequently and exceeded a throttle limit.
      • InternalServerException The operation failed because of an error internal to Amazon Web Services. Try your operation again later.
      • 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.
      • AccountException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getAccountInformation

      default CompletableFuture<GetAccountInformationResponse> getAccountInformation(Consumer<GetAccountInformationRequest.Builder> getAccountInformationRequest)

      Retrieves information about the specified account including its account name, account ID, and account creation date and time. To use this API, an IAM user or role must have the account:GetAccountInformation IAM permission.


      This is a convenience which creates an instance of the GetAccountInformationRequest.Builder avoiding the need to create one manually via GetAccountInformationRequest.builder()

      Parameters:
      getAccountInformationRequest - A Consumer that will call methods on GetAccountInformationRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the GetAccountInformation 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 invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The operation failed because the calling identity doesn't have the minimum required permissions.
      • ValidationException The operation failed because one of the input parameters was invalid.
      • TooManyRequestsException The operation failed because it was called too frequently and exceeded a throttle limit.
      • InternalServerException The operation failed because of an error internal to Amazon Web Services. Try your operation again later.
      • 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.
      • AccountException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getAlternateContact

      default CompletableFuture<GetAlternateContactResponse> getAlternateContact(GetAlternateContactRequest getAlternateContactRequest)

      Retrieves the specified alternate contact attached to an Amazon Web Services account.

      For complete details about how to use the alternate contact operations, see Access or updating the alternate contacts.

      Before you can update the alternate contact information for an Amazon Web Services account that is managed by Organizations, you must first enable integration between Amazon Web Services Account Management and Organizations. For more information, see Enabling trusted access for Amazon Web Services Account Management.

      Parameters:
      getAlternateContactRequest -
      Returns:
      A Java Future containing the result of the GetAlternateContact 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 invoke Throwable.getCause() to retrieve the underlying exception.
      • ResourceNotFoundException The operation failed because it specified a resource that can't be found.
      • ValidationException The operation failed because one of the input parameters was invalid.
      • AccessDeniedException The operation failed because the calling identity doesn't have the minimum required permissions.
      • TooManyRequestsException The operation failed because it was called too frequently and exceeded a throttle limit.
      • InternalServerException The operation failed because of an error internal to Amazon Web Services. Try your operation again later.
      • 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.
      • AccountException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getAlternateContact

      default CompletableFuture<GetAlternateContactResponse> getAlternateContact(Consumer<GetAlternateContactRequest.Builder> getAlternateContactRequest)

      Retrieves the specified alternate contact attached to an Amazon Web Services account.

      For complete details about how to use the alternate contact operations, see Access or updating the alternate contacts.

      Before you can update the alternate contact information for an Amazon Web Services account that is managed by Organizations, you must first enable integration between Amazon Web Services Account Management and Organizations. For more information, see Enabling trusted access for Amazon Web Services Account Management.


      This is a convenience which creates an instance of the GetAlternateContactRequest.Builder avoiding the need to create one manually via GetAlternateContactRequest.builder()

      Parameters:
      getAlternateContactRequest - A Consumer that will call methods on GetAlternateContactRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the GetAlternateContact 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 invoke Throwable.getCause() to retrieve the underlying exception.
      • ResourceNotFoundException The operation failed because it specified a resource that can't be found.
      • ValidationException The operation failed because one of the input parameters was invalid.
      • AccessDeniedException The operation failed because the calling identity doesn't have the minimum required permissions.
      • TooManyRequestsException The operation failed because it was called too frequently and exceeded a throttle limit.
      • InternalServerException The operation failed because of an error internal to Amazon Web Services. Try your operation again later.
      • 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.
      • AccountException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getContactInformation

      default CompletableFuture<GetContactInformationResponse> getContactInformation(GetContactInformationRequest getContactInformationRequest)

      Retrieves the primary contact information of an Amazon Web Services account.

      For complete details about how to use the primary contact operations, see Update the primary and alternate contact information.

      Parameters:
      getContactInformationRequest -
      Returns:
      A Java Future containing the result of the GetContactInformation 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 invoke Throwable.getCause() to retrieve the underlying exception.
      • ResourceNotFoundException The operation failed because it specified a resource that can't be found.
      • ValidationException The operation failed because one of the input parameters was invalid.
      • AccessDeniedException The operation failed because the calling identity doesn't have the minimum required permissions.
      • TooManyRequestsException The operation failed because it was called too frequently and exceeded a throttle limit.
      • InternalServerException The operation failed because of an error internal to Amazon Web Services. Try your operation again later.
      • 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.
      • AccountException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getContactInformation

      default CompletableFuture<GetContactInformationResponse> getContactInformation(Consumer<GetContactInformationRequest.Builder> getContactInformationRequest)

      Retrieves the primary contact information of an Amazon Web Services account.

      For complete details about how to use the primary contact operations, see Update the primary and alternate contact information.


      This is a convenience which creates an instance of the GetContactInformationRequest.Builder avoiding the need to create one manually via GetContactInformationRequest.builder()

      Parameters:
      getContactInformationRequest - A Consumer that will call methods on GetContactInformationRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the GetContactInformation 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 invoke Throwable.getCause() to retrieve the underlying exception.
      • ResourceNotFoundException The operation failed because it specified a resource that can't be found.
      • ValidationException The operation failed because one of the input parameters was invalid.
      • AccessDeniedException The operation failed because the calling identity doesn't have the minimum required permissions.
      • TooManyRequestsException The operation failed because it was called too frequently and exceeded a throttle limit.
      • InternalServerException The operation failed because of an error internal to Amazon Web Services. Try your operation again later.
      • 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.
      • AccountException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getPrimaryEmail

      default CompletableFuture<GetPrimaryEmailResponse> getPrimaryEmail(GetPrimaryEmailRequest getPrimaryEmailRequest)

      Retrieves the primary email address for the specified account.

      Parameters:
      getPrimaryEmailRequest -
      Returns:
      A Java Future containing the result of the GetPrimaryEmail 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 invoke Throwable.getCause() to retrieve the underlying exception.
      • ResourceNotFoundException The operation failed because it specified a resource that can't be found.
      • AccessDeniedException The operation failed because the calling identity doesn't have the minimum required permissions.
      • ValidationException The operation failed because one of the input parameters was invalid.
      • TooManyRequestsException The operation failed because it was called too frequently and exceeded a throttle limit.
      • InternalServerException The operation failed because of an error internal to Amazon Web Services. Try your operation again later.
      • 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.
      • AccountException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getPrimaryEmail

      default CompletableFuture<GetPrimaryEmailResponse> getPrimaryEmail(Consumer<GetPrimaryEmailRequest.Builder> getPrimaryEmailRequest)

      Retrieves the primary email address for the specified account.


      This is a convenience which creates an instance of the GetPrimaryEmailRequest.Builder avoiding the need to create one manually via GetPrimaryEmailRequest.builder()

      Parameters:
      getPrimaryEmailRequest - A Consumer that will call methods on GetPrimaryEmailRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the GetPrimaryEmail 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 invoke Throwable.getCause() to retrieve the underlying exception.
      • ResourceNotFoundException The operation failed because it specified a resource that can't be found.
      • AccessDeniedException The operation failed because the calling identity doesn't have the minimum required permissions.
      • ValidationException The operation failed because one of the input parameters was invalid.
      • TooManyRequestsException The operation failed because it was called too frequently and exceeded a throttle limit.
      • InternalServerException The operation failed because of an error internal to Amazon Web Services. Try your operation again later.
      • 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.
      • AccountException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getRegionOptStatus

      default CompletableFuture<GetRegionOptStatusResponse> getRegionOptStatus(GetRegionOptStatusRequest getRegionOptStatusRequest)

      Retrieves the opt-in status of a particular Region.

      Parameters:
      getRegionOptStatusRequest -
      Returns:
      A Java Future containing the result of the GetRegionOptStatus 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 invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The operation failed because the calling identity doesn't have the minimum required permissions.
      • ValidationException The operation failed because one of the input parameters was invalid.
      • TooManyRequestsException The operation failed because it was called too frequently and exceeded a throttle limit.
      • InternalServerException The operation failed because of an error internal to Amazon Web Services. Try your operation again later.
      • 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.
      • AccountException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getRegionOptStatus

      default CompletableFuture<GetRegionOptStatusResponse> getRegionOptStatus(Consumer<GetRegionOptStatusRequest.Builder> getRegionOptStatusRequest)

      Retrieves the opt-in status of a particular Region.


      This is a convenience which creates an instance of the GetRegionOptStatusRequest.Builder avoiding the need to create one manually via GetRegionOptStatusRequest.builder()

      Parameters:
      getRegionOptStatusRequest - A Consumer that will call methods on GetRegionOptStatusRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the GetRegionOptStatus 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 invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The operation failed because the calling identity doesn't have the minimum required permissions.
      • ValidationException The operation failed because one of the input parameters was invalid.
      • TooManyRequestsException The operation failed because it was called too frequently and exceeded a throttle limit.
      • InternalServerException The operation failed because of an error internal to Amazon Web Services. Try your operation again later.
      • 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.
      • AccountException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listRegions

      default CompletableFuture<ListRegionsResponse> listRegions(ListRegionsRequest listRegionsRequest)

      Lists all the Regions for a given account and their respective opt-in statuses. Optionally, this list can be filtered by the region-opt-status-contains parameter.

      Parameters:
      listRegionsRequest -
      Returns:
      A Java Future containing the result of the ListRegions 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 invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The operation failed because the calling identity doesn't have the minimum required permissions.
      • ValidationException The operation failed because one of the input parameters was invalid.
      • TooManyRequestsException The operation failed because it was called too frequently and exceeded a throttle limit.
      • InternalServerException The operation failed because of an error internal to Amazon Web Services. Try your operation again later.
      • 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.
      • AccountException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listRegions

      default CompletableFuture<ListRegionsResponse> listRegions(Consumer<ListRegionsRequest.Builder> listRegionsRequest)

      Lists all the Regions for a given account and their respective opt-in statuses. Optionally, this list can be filtered by the region-opt-status-contains parameter.


      This is a convenience which creates an instance of the ListRegionsRequest.Builder avoiding the need to create one manually via ListRegionsRequest.builder()

      Parameters:
      listRegionsRequest - A Consumer that will call methods on ListRegionsRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the ListRegions 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 invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The operation failed because the calling identity doesn't have the minimum required permissions.
      • ValidationException The operation failed because one of the input parameters was invalid.
      • TooManyRequestsException The operation failed because it was called too frequently and exceeded a throttle limit.
      • InternalServerException The operation failed because of an error internal to Amazon Web Services. Try your operation again later.
      • 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.
      • AccountException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listRegionsPaginator

      default ListRegionsPublisher listRegionsPaginator(ListRegionsRequest listRegionsRequest)

      This is a variant of listRegions(software.amazon.awssdk.services.account.model.ListRegionsRequest) 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 new Subscription 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 method 
       
 software.amazon.awssdk.services.account.paginators.ListRegionsPublisher publisher = client.listRegionsPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
      2) Using a custom subscriber 
       
 software.amazon.awssdk.services.account.paginators.ListRegionsPublisher publisher = client.listRegionsPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.account.model.ListRegionsResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.account.model.ListRegionsResponse response) { //... };
 });
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      Please notice that the configuration of MaxResults 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 listRegions(software.amazon.awssdk.services.account.model.ListRegionsRequest) operation.

      Parameters:
      listRegionsRequest -
      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 invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The operation failed because the calling identity doesn't have the minimum required permissions.
      • ValidationException The operation failed because one of the input parameters was invalid.
      • TooManyRequestsException The operation failed because it was called too frequently and exceeded a throttle limit.
      • InternalServerException The operation failed because of an error internal to Amazon Web Services. Try your operation again later.
      • 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.
      • AccountException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listRegionsPaginator

      default ListRegionsPublisher listRegionsPaginator(Consumer<ListRegionsRequest.Builder> listRegionsRequest)

      This is a variant of listRegions(software.amazon.awssdk.services.account.model.ListRegionsRequest) 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 new Subscription 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 method 
       
 software.amazon.awssdk.services.account.paginators.ListRegionsPublisher publisher = client.listRegionsPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
      2) Using a custom subscriber 
       
 software.amazon.awssdk.services.account.paginators.ListRegionsPublisher publisher = client.listRegionsPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.account.model.ListRegionsResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.account.model.ListRegionsResponse response) { //... };
 });
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      Please notice that the configuration of MaxResults 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 listRegions(software.amazon.awssdk.services.account.model.ListRegionsRequest) operation.


      This is a convenience which creates an instance of the ListRegionsRequest.Builder avoiding the need to create one manually via ListRegionsRequest.builder()

      Parameters:
      listRegionsRequest - A Consumer that will call methods on ListRegionsRequest.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 invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The operation failed because the calling identity doesn't have the minimum required permissions.
      • ValidationException The operation failed because one of the input parameters was invalid.
      • TooManyRequestsException The operation failed because it was called too frequently and exceeded a throttle limit.
      • InternalServerException The operation failed because of an error internal to Amazon Web Services. Try your operation again later.
      • 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.
      • AccountException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • putAccountName

      default CompletableFuture<PutAccountNameResponse> putAccountName(PutAccountNameRequest putAccountNameRequest)

      Updates the account name of the specified account. To use this API, IAM principals must have the account:PutAccountName IAM permission.

      Parameters:
      putAccountNameRequest -
      Returns:
      A Java Future containing the result of the PutAccountName 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 invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The operation failed because the calling identity doesn't have the minimum required permissions.
      • ValidationException The operation failed because one of the input parameters was invalid.
      • TooManyRequestsException The operation failed because it was called too frequently and exceeded a throttle limit.
      • InternalServerException The operation failed because of an error internal to Amazon Web Services. Try your operation again later.
      • 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.
      • AccountException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • putAccountName

      default CompletableFuture<PutAccountNameResponse> putAccountName(Consumer<PutAccountNameRequest.Builder> putAccountNameRequest)

      Updates the account name of the specified account. To use this API, IAM principals must have the account:PutAccountName IAM permission.


      This is a convenience which creates an instance of the PutAccountNameRequest.Builder avoiding the need to create one manually via PutAccountNameRequest.builder()

      Parameters:
      putAccountNameRequest - A Consumer that will call methods on PutAccountNameRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the PutAccountName 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 invoke Throwable.getCause() to retrieve the underlying exception.
      • AccessDeniedException The operation failed because the calling identity doesn't have the minimum required permissions.
      • ValidationException The operation failed because one of the input parameters was invalid.
      • TooManyRequestsException The operation failed because it was called too frequently and exceeded a throttle limit.
      • InternalServerException The operation failed because of an error internal to Amazon Web Services. Try your operation again later.
      • 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.
      • AccountException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • putAlternateContact

      default CompletableFuture<PutAlternateContactResponse> putAlternateContact(PutAlternateContactRequest putAlternateContactRequest)

      Modifies the specified alternate contact attached to an Amazon Web Services account.

      For complete details about how to use the alternate contact operations, see Access or updating the alternate contacts.

      Before you can update the alternate contact information for an Amazon Web Services account that is managed by Organizations, you must first enable integration between Amazon Web Services Account Management and Organizations. For more information, see Enabling trusted access for Amazon Web Services Account Management.

      Parameters:
      putAlternateContactRequest -
      Returns:
      A Java Future containing the result of the PutAlternateContact 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 invoke Throwable.getCause() to retrieve the underlying exception.
      • ValidationException The operation failed because one of the input parameters was invalid.
      • AccessDeniedException The operation failed because the calling identity doesn't have the minimum required permissions.
      • TooManyRequestsException The operation failed because it was called too frequently and exceeded a throttle limit.
      • InternalServerException The operation failed because of an error internal to Amazon Web Services. Try your operation again later.
      • 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.
      • AccountException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • putAlternateContact

      default CompletableFuture<PutAlternateContactResponse> putAlternateContact(Consumer<PutAlternateContactRequest.Builder> putAlternateContactRequest)

      Modifies the specified alternate contact attached to an Amazon Web Services account.

      For complete details about how to use the alternate contact operations, see Access or updating the alternate contacts.

      Before you can update the alternate contact information for an Amazon Web Services account that is managed by Organizations, you must first enable integration between Amazon Web Services Account Management and Organizations. For more information, see Enabling trusted access for Amazon Web Services Account Management.


      This is a convenience which creates an instance of the PutAlternateContactRequest.Builder avoiding the need to create one manually via PutAlternateContactRequest.builder()

      Parameters:
      putAlternateContactRequest - A Consumer that will call methods on PutAlternateContactRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the PutAlternateContact 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 invoke Throwable.getCause() to retrieve the underlying exception.
      • ValidationException The operation failed because one of the input parameters was invalid.
      • AccessDeniedException The operation failed because the calling identity doesn't have the minimum required permissions.
      • TooManyRequestsException The operation failed because it was called too frequently and exceeded a throttle limit.
      • InternalServerException The operation failed because of an error internal to Amazon Web Services. Try your operation again later.
      • 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.
      • AccountException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • putContactInformation

      default CompletableFuture<PutContactInformationResponse> putContactInformation(PutContactInformationRequest putContactInformationRequest)

      Updates the primary contact information of an Amazon Web Services account.

      For complete details about how to use the primary contact operations, see Update the primary and alternate contact information.

      Parameters:
      putContactInformationRequest -
      Returns:
      A Java Future containing the result of the PutContactInformation 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 invoke Throwable.getCause() to retrieve the underlying exception.
      • ValidationException The operation failed because one of the input parameters was invalid.
      • AccessDeniedException The operation failed because the calling identity doesn't have the minimum required permissions.
      • TooManyRequestsException The operation failed because it was called too frequently and exceeded a throttle limit.
      • InternalServerException The operation failed because of an error internal to Amazon Web Services. Try your operation again later.
      • 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.
      • AccountException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • putContactInformation

      default CompletableFuture<PutContactInformationResponse> putContactInformation(Consumer<PutContactInformationRequest.Builder> putContactInformationRequest)

      Updates the primary contact information of an Amazon Web Services account.

      For complete details about how to use the primary contact operations, see Update the primary and alternate contact information.


      This is a convenience which creates an instance of the PutContactInformationRequest.Builder avoiding the need to create one manually via PutContactInformationRequest.builder()

      Parameters:
      putContactInformationRequest - A Consumer that will call methods on PutContactInformationRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the PutContactInformation 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 invoke Throwable.getCause() to retrieve the underlying exception.
      • ValidationException The operation failed because one of the input parameters was invalid.
      • AccessDeniedException The operation failed because the calling identity doesn't have the minimum required permissions.
      • TooManyRequestsException The operation failed because it was called too frequently and exceeded a throttle limit.
      • InternalServerException The operation failed because of an error internal to Amazon Web Services. Try your operation again later.
      • 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.
      • AccountException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • startPrimaryEmailUpdate

      default CompletableFuture<StartPrimaryEmailUpdateResponse> startPrimaryEmailUpdate(StartPrimaryEmailUpdateRequest startPrimaryEmailUpdateRequest)

      Starts the process to update the primary email address for the specified account.

      Parameters:
      startPrimaryEmailUpdateRequest -
      Returns:
      A Java Future containing the result of the StartPrimaryEmailUpdate 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 invoke Throwable.getCause() to retrieve the underlying exception.
      • ResourceNotFoundException The operation failed because it specified a resource that can't be found.
      • AccessDeniedException The operation failed because the calling identity doesn't have the minimum required permissions.
      • ValidationException The operation failed because one of the input parameters was invalid.
      • ConflictException The request could not be processed because of a conflict in the current status of the resource. For example, this happens if you try to enable a Region that is currently being disabled (in a status of DISABLING) or if you try to change an account’s root user email to an email address which is already in use.
      • TooManyRequestsException The operation failed because it was called too frequently and exceeded a throttle limit.
      • InternalServerException The operation failed because of an error internal to Amazon Web Services. Try your operation again later.
      • 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.
      • AccountException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • startPrimaryEmailUpdate

      default CompletableFuture<StartPrimaryEmailUpdateResponse> startPrimaryEmailUpdate(Consumer<StartPrimaryEmailUpdateRequest.Builder> startPrimaryEmailUpdateRequest)

      Starts the process to update the primary email address for the specified account.


      This is a convenience which creates an instance of the StartPrimaryEmailUpdateRequest.Builder avoiding the need to create one manually via StartPrimaryEmailUpdateRequest.builder()

      Parameters:
      startPrimaryEmailUpdateRequest - A Consumer that will call methods on StartPrimaryEmailUpdateRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the StartPrimaryEmailUpdate 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 invoke Throwable.getCause() to retrieve the underlying exception.
      • ResourceNotFoundException The operation failed because it specified a resource that can't be found.
      • AccessDeniedException The operation failed because the calling identity doesn't have the minimum required permissions.
      • ValidationException The operation failed because one of the input parameters was invalid.
      • ConflictException The request could not be processed because of a conflict in the current status of the resource. For example, this happens if you try to enable a Region that is currently being disabled (in a status of DISABLING) or if you try to change an account’s root user email to an email address which is already in use.
      • TooManyRequestsException The operation failed because it was called too frequently and exceeded a throttle limit.
      • InternalServerException The operation failed because of an error internal to Amazon Web Services. Try your operation again later.
      • 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.
      • AccountException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • serviceClientConfiguration

      default AccountServiceClientConfiguration serviceClientConfiguration()
      Description copied from interface: SdkClient
      The SDK service client configuration exposes client settings to the user, e.g., ClientOverrideConfiguration
      Specified by:
      serviceClientConfiguration in interface AwsClient
      Specified by:
      serviceClientConfiguration in interface SdkClient
      Returns:
      SdkServiceClientConfiguration

    • create

      static AccountAsyncClient create()
      Create a AccountAsyncClient with the region loaded from the DefaultAwsRegionProviderChain and credentials loaded from the DefaultCredentialsProvider.

    • builder

      static AccountAsyncClientBuilder builder()
      Create a builder that can be used to configure and create a AccountAsyncClient.