Package software.amazon.awssdk.services.account

Interface AccountClient

All Superinterfaces:

AutoCloseable, AwsClient, SdkAutoCloseable, SdkClient

@Generated("software.amazon.awssdk:codegen")
@ThreadSafe
public interface AccountClient
extends AwsClient

Service client for accessing AWS Account. This can be created using the static builder() method.

Operations for Amazon Web Services Account Management

Field Summary

Fields

Modifier and Type	Field	Description
static String	SERVICE_METADATA_ID	Value for looking up the service's metadata from the ServiceMetadataProvider.
static String	SERVICE_NAME

Method Summary

Modifier and Type	Method	Description
default 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.
default 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.
static AccountClientBuilder	builder()	Create a builder that can be used to configure and create a AccountClient.
static AccountClient	create()	Create a AccountClient with the region loaded from the DefaultAwsRegionProviderChain and credentials loaded from the DefaultCredentialsProvider.
default DeleteAlternateContactResponse	deleteAlternateContact(Consumer<DeleteAlternateContactRequest.Builder> deleteAlternateContactRequest)	Deletes the specified alternate contact from an Amazon Web Services account.
default DeleteAlternateContactResponse	deleteAlternateContact(DeleteAlternateContactRequest deleteAlternateContactRequest)	Deletes the specified alternate contact from an Amazon Web Services account.
default DisableRegionResponse	disableRegion(Consumer<DisableRegionRequest.Builder> disableRegionRequest)	Disables (opts-out) a particular Region for an account.
default DisableRegionResponse	disableRegion(DisableRegionRequest disableRegionRequest)	Disables (opts-out) a particular Region for an account.
default EnableRegionResponse	enableRegion(Consumer<EnableRegionRequest.Builder> enableRegionRequest)	Enables (opts-in) a particular Region for an account.
default EnableRegionResponse	enableRegion(EnableRegionRequest enableRegionRequest)	Enables (opts-in) a particular Region for an account.
default GetAlternateContactResponse	getAlternateContact(Consumer<GetAlternateContactRequest.Builder> getAlternateContactRequest)	Retrieves the specified alternate contact attached to an Amazon Web Services account.
default GetAlternateContactResponse	getAlternateContact(GetAlternateContactRequest getAlternateContactRequest)	Retrieves the specified alternate contact attached to an Amazon Web Services account.
default GetContactInformationResponse	getContactInformation(Consumer<GetContactInformationRequest.Builder> getContactInformationRequest)	Retrieves the primary contact information of an Amazon Web Services account.
default GetContactInformationResponse	getContactInformation(GetContactInformationRequest getContactInformationRequest)	Retrieves the primary contact information of an Amazon Web Services account.
default GetPrimaryEmailResponse	getPrimaryEmail(Consumer<GetPrimaryEmailRequest.Builder> getPrimaryEmailRequest)	Retrieves the primary email address for the specified account.
default GetPrimaryEmailResponse	getPrimaryEmail(GetPrimaryEmailRequest getPrimaryEmailRequest)	Retrieves the primary email address for the specified account.
default GetRegionOptStatusResponse	getRegionOptStatus(Consumer<GetRegionOptStatusRequest.Builder> getRegionOptStatusRequest)	Retrieves the opt-in status of a particular Region.
default GetRegionOptStatusResponse	getRegionOptStatus(GetRegionOptStatusRequest getRegionOptStatusRequest)	Retrieves the opt-in status of a particular Region.
default ListRegionsResponse	listRegions(Consumer<ListRegionsRequest.Builder> listRegionsRequest)	Lists all the Regions for a given account and their respective opt-in statuses.
default ListRegionsResponse	listRegions(ListRegionsRequest listRegionsRequest)	Lists all the Regions for a given account and their respective opt-in statuses.
default ListRegionsIterable	listRegionsPaginator(Consumer<ListRegionsRequest.Builder> listRegionsRequest)	This is a variant of listRegions(software.amazon.awssdk.services.account.model.ListRegionsRequest) operation.
default ListRegionsIterable	listRegionsPaginator(ListRegionsRequest listRegionsRequest)	This is a variant of listRegions(software.amazon.awssdk.services.account.model.ListRegionsRequest) operation.
default PutAlternateContactResponse	putAlternateContact(Consumer<PutAlternateContactRequest.Builder> putAlternateContactRequest)	Modifies the specified alternate contact attached to an Amazon Web Services account.
default PutAlternateContactResponse	putAlternateContact(PutAlternateContactRequest putAlternateContactRequest)	Modifies the specified alternate contact attached to an Amazon Web Services account.
default PutContactInformationResponse	putContactInformation(Consumer<PutContactInformationRequest.Builder> putContactInformationRequest)	Updates the primary contact information of an Amazon Web Services account.
default PutContactInformationResponse	putContactInformation(PutContactInformationRequest putContactInformationRequest)	Updates the primary contact information of an Amazon Web Services account.
default AccountServiceClientConfiguration	serviceClientConfiguration()
static ServiceMetadata	serviceMetadata()
default StartPrimaryEmailUpdateResponse	startPrimaryEmailUpdate(Consumer<StartPrimaryEmailUpdateRequest.Builder> startPrimaryEmailUpdateRequest)	Starts the process to update the primary email address for the specified account.
default StartPrimaryEmailUpdateResponse	startPrimaryEmailUpdate(StartPrimaryEmailUpdateRequest startPrimaryEmailUpdateRequest)	Starts the process to update the primary email address for the specified account.

Methods inherited from interface software.amazon.awssdk.utils.SdkAutoCloseable

close

Methods inherited from interface software.amazon.awssdk.core.SdkClient

serviceName

Field Detail

SERVICE_NAME

static final String SERVICE_NAME

See Also:

Constant Field Values

SERVICE_METADATA_ID

static final String SERVICE_METADATA_ID

Value for looking up the service's metadata from the ServiceMetadataProvider.

See Also:

Constant Field Values

Method Detail

acceptPrimaryEmailUpdate

default AcceptPrimaryEmailUpdateResponse acceptPrimaryEmailUpdate(AcceptPrimaryEmailUpdateRequest acceptPrimaryEmailUpdateRequest)
                                                           throws ResourceNotFoundException,
                                                                  ValidationException,
                                                                  ConflictException,
                                                                  AccessDeniedException,
                                                                  TooManyRequestsException,
                                                                  InternalServerException,
                                                                  AwsServiceException,
                                                                  SdkClientException,
                                                                  AccountException

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:

Result of the AcceptPrimaryEmailUpdate operation returned by the service.

Throws:

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.

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).

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.

AwsServiceException

See Also:

AWS API Documentation

acceptPrimaryEmailUpdate

default AcceptPrimaryEmailUpdateResponse acceptPrimaryEmailUpdate(Consumer<AcceptPrimaryEmailUpdateRequest.Builder> acceptPrimaryEmailUpdateRequest)
                                                           throws ResourceNotFoundException,
                                                                  ValidationException,
                                                                  ConflictException,
                                                                  AccessDeniedException,
                                                                  TooManyRequestsException,
                                                                  InternalServerException,
                                                                  AwsServiceException,
                                                                  SdkClientException,
                                                                  AccountException

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:

Result of the AcceptPrimaryEmailUpdate operation returned by the service.

Throws:

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.

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).

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.

AwsServiceException

See Also:

AWS API Documentation

deleteAlternateContact

default DeleteAlternateContactResponse deleteAlternateContact(DeleteAlternateContactRequest deleteAlternateContactRequest)
                                                       throws ResourceNotFoundException,
                                                              ValidationException,
                                                              AccessDeniedException,
                                                              TooManyRequestsException,
                                                              InternalServerException,
                                                              AwsServiceException,
                                                              SdkClientException,
                                                              AccountException

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:

Result of the DeleteAlternateContact operation returned by the service.

Throws:

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.

AwsServiceException

See Also:

AWS API Documentation

deleteAlternateContact

default DeleteAlternateContactResponse deleteAlternateContact(Consumer<DeleteAlternateContactRequest.Builder> deleteAlternateContactRequest)
                                                       throws ResourceNotFoundException,
                                                              ValidationException,
                                                              AccessDeniedException,
                                                              TooManyRequestsException,
                                                              InternalServerException,
                                                              AwsServiceException,
                                                              SdkClientException,
                                                              AccountException

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:

Result of the DeleteAlternateContact operation returned by the service.

Throws:

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.

AwsServiceException

See Also:

AWS API Documentation

disableRegion

default DisableRegionResponse disableRegion(DisableRegionRequest disableRegionRequest)
                                     throws ValidationException,
                                            ConflictException,
                                            AccessDeniedException,
                                            TooManyRequestsException,
                                            InternalServerException,
                                            AwsServiceException,
                                            SdkClientException,
                                            AccountException

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:

Result of the DisableRegion operation returned by the service.

Throws:

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).

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.

AwsServiceException

See Also:

AWS API Documentation

disableRegion

default DisableRegionResponse disableRegion(Consumer<DisableRegionRequest.Builder> disableRegionRequest)
                                     throws ValidationException,
                                            ConflictException,
                                            AccessDeniedException,
                                            TooManyRequestsException,
                                            InternalServerException,
                                            AwsServiceException,
                                            SdkClientException,
                                            AccountException

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:

Result of the DisableRegion operation returned by the service.

Throws:

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).

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.

AwsServiceException

See Also:

AWS API Documentation

enableRegion

default EnableRegionResponse enableRegion(EnableRegionRequest enableRegionRequest)
                                   throws ValidationException,
                                          ConflictException,
                                          AccessDeniedException,
                                          TooManyRequestsException,
                                          InternalServerException,
                                          AwsServiceException,
                                          SdkClientException,
                                          AccountException

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

Parameters:

enableRegionRequest -

Returns:

Result of the EnableRegion operation returned by the service.

Throws:

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).

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.

AwsServiceException

See Also:

AWS API Documentation

enableRegion

default EnableRegionResponse enableRegion(Consumer<EnableRegionRequest.Builder> enableRegionRequest)
                                   throws ValidationException,
                                          ConflictException,
                                          AccessDeniedException,
                                          TooManyRequestsException,
                                          InternalServerException,
                                          AwsServiceException,
                                          SdkClientException,
                                          AccountException

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:

Result of the EnableRegion operation returned by the service.

Throws:

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).

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.

AwsServiceException

See Also:

AWS API Documentation

getAlternateContact

default GetAlternateContactResponse getAlternateContact(GetAlternateContactRequest getAlternateContactRequest)
                                                 throws ResourceNotFoundException,
                                                        ValidationException,
                                                        AccessDeniedException,
                                                        TooManyRequestsException,
                                                        InternalServerException,
                                                        AwsServiceException,
                                                        SdkClientException,
                                                        AccountException

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:

Result of the GetAlternateContact operation returned by the service.

Throws:

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.

AwsServiceException

See Also:

AWS API Documentation

getAlternateContact

default GetAlternateContactResponse getAlternateContact(Consumer<GetAlternateContactRequest.Builder> getAlternateContactRequest)
                                                 throws ResourceNotFoundException,
                                                        ValidationException,
                                                        AccessDeniedException,
                                                        TooManyRequestsException,
                                                        InternalServerException,
                                                        AwsServiceException,
                                                        SdkClientException,
                                                        AccountException

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:

Result of the GetAlternateContact operation returned by the service.

Throws:

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.

AwsServiceException

See Also:

AWS API Documentation

getContactInformation

default GetContactInformationResponse getContactInformation(GetContactInformationRequest getContactInformationRequest)
                                                     throws ResourceNotFoundException,
                                                            ValidationException,
                                                            AccessDeniedException,
                                                            TooManyRequestsException,
                                                            InternalServerException,
                                                            AwsServiceException,
                                                            SdkClientException,
                                                            AccountException

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:

Result of the GetContactInformation operation returned by the service.

Throws:

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.

AwsServiceException

See Also:

AWS API Documentation

getContactInformation

default GetContactInformationResponse getContactInformation(Consumer<GetContactInformationRequest.Builder> getContactInformationRequest)
                                                     throws ResourceNotFoundException,
                                                            ValidationException,
                                                            AccessDeniedException,
                                                            TooManyRequestsException,
                                                            InternalServerException,
                                                            AwsServiceException,
                                                            SdkClientException,
                                                            AccountException

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:

Result of the GetContactInformation operation returned by the service.

Throws:

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.

AwsServiceException

See Also:

AWS API Documentation

getPrimaryEmail

default GetPrimaryEmailResponse getPrimaryEmail(GetPrimaryEmailRequest getPrimaryEmailRequest)
                                         throws ResourceNotFoundException,
                                                ValidationException,
                                                AccessDeniedException,
                                                TooManyRequestsException,
                                                InternalServerException,
                                                AwsServiceException,
                                                SdkClientException,
                                                AccountException

Retrieves the primary email address for the specified account.

Parameters:

getPrimaryEmailRequest -

Returns:

Result of the GetPrimaryEmail operation returned by the service.

Throws:

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.

AwsServiceException

See Also:

AWS API Documentation

getPrimaryEmail

default GetPrimaryEmailResponse getPrimaryEmail(Consumer<GetPrimaryEmailRequest.Builder> getPrimaryEmailRequest)
                                         throws ResourceNotFoundException,
                                                ValidationException,
                                                AccessDeniedException,
                                                TooManyRequestsException,
                                                InternalServerException,
                                                AwsServiceException,
                                                SdkClientException,
                                                AccountException

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:

Result of the GetPrimaryEmail operation returned by the service.

Throws:

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.

AwsServiceException

See Also:

AWS API Documentation

getRegionOptStatus

default GetRegionOptStatusResponse getRegionOptStatus(GetRegionOptStatusRequest getRegionOptStatusRequest)
                                               throws ValidationException,
                                                      AccessDeniedException,
                                                      TooManyRequestsException,
                                                      InternalServerException,
                                                      AwsServiceException,
                                                      SdkClientException,
                                                      AccountException

Retrieves the opt-in status of a particular Region.

Parameters:

getRegionOptStatusRequest -

Returns:

Result of the GetRegionOptStatus operation returned by the service.

Throws:

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.

AwsServiceException

See Also:

AWS API Documentation

getRegionOptStatus

default GetRegionOptStatusResponse getRegionOptStatus(Consumer<GetRegionOptStatusRequest.Builder> getRegionOptStatusRequest)
                                               throws ValidationException,
                                                      AccessDeniedException,
                                                      TooManyRequestsException,
                                                      InternalServerException,
                                                      AwsServiceException,
                                                      SdkClientException,
                                                      AccountException

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:

Result of the GetRegionOptStatus operation returned by the service.

Throws:

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.

AwsServiceException

See Also:

AWS API Documentation

listRegions

default ListRegionsResponse listRegions(ListRegionsRequest listRegionsRequest)
                                 throws ValidationException,
                                        AccessDeniedException,
                                        TooManyRequestsException,
                                        InternalServerException,
                                        AwsServiceException,
                                        SdkClientException,
                                        AccountException

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:

Result of the ListRegions operation returned by the service.

Throws:

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.

AwsServiceException

See Also:

AWS API Documentation

listRegions

default ListRegionsResponse listRegions(Consumer<ListRegionsRequest.Builder> listRegionsRequest)
                                 throws ValidationException,
                                        AccessDeniedException,
                                        TooManyRequestsException,
                                        InternalServerException,
                                        AwsServiceException,
                                        SdkClientException,
                                        AccountException

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:

Result of the ListRegions operation returned by the service.

Throws:

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.

AwsServiceException

See Also:

AWS API Documentation

listRegionsPaginator

default ListRegionsIterable listRegionsPaginator(ListRegionsRequest listRegionsRequest)
                                          throws ValidationException,
                                                 AccessDeniedException,
                                                 TooManyRequestsException,
                                                 InternalServerException,
                                                 AwsServiceException,
                                                 SdkClientException,
                                                 AccountException

This is a variant of listRegions(software.amazon.awssdk.services.account.model.ListRegionsRequest) operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will internally handle making service calls for you.

When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.

The following are few ways to iterate through the response pages:

1) Using a Stream

 
 software.amazon.awssdk.services.account.paginators.ListRegionsIterable responses = client.listRegionsPaginator(request);
 responses.stream().forEach(....);
 
 

2) Using For loop

 {
     @code
     software.amazon.awssdk.services.account.paginators.ListRegionsIterable responses = client.listRegionsPaginator(request);
     for (software.amazon.awssdk.services.account.model.ListRegionsResponse response : responses) {
         // do something;
     }
 }
 

3) Use iterator directly

 
 software.amazon.awssdk.services.account.paginators.ListRegionsIterable responses = client.listRegionsPaginator(request);
 responses.iterator().forEachRemaining(....);
 
 

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 iterable that can be used to iterate through all the response pages.

Throws:

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.

AwsServiceException

See Also:

AWS API Documentation

listRegionsPaginator

default ListRegionsIterable listRegionsPaginator(Consumer<ListRegionsRequest.Builder> listRegionsRequest)
                                          throws ValidationException,
                                                 AccessDeniedException,
                                                 TooManyRequestsException,
                                                 InternalServerException,
                                                 AwsServiceException,
                                                 SdkClientException,
                                                 AccountException

This is a variant of listRegions(software.amazon.awssdk.services.account.model.ListRegionsRequest) operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will internally handle making service calls for you.

When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.

The following are few ways to iterate through the response pages:

1) Using a Stream

 
 software.amazon.awssdk.services.account.paginators.ListRegionsIterable responses = client.listRegionsPaginator(request);
 responses.stream().forEach(....);
 
 

2) Using For loop

 {
     @code
     software.amazon.awssdk.services.account.paginators.ListRegionsIterable responses = client.listRegionsPaginator(request);
     for (software.amazon.awssdk.services.account.model.ListRegionsResponse response : responses) {
         // do something;
     }
 }
 

3) Use iterator directly

 
 software.amazon.awssdk.services.account.paginators.ListRegionsIterable responses = client.listRegionsPaginator(request);
 responses.iterator().forEachRemaining(....);
 
 

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 iterable that can be used to iterate through all the response pages.

Throws:

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.

AwsServiceException

See Also:

AWS API Documentation

putAlternateContact

default PutAlternateContactResponse putAlternateContact(PutAlternateContactRequest putAlternateContactRequest)
                                                 throws ValidationException,
                                                        AccessDeniedException,
                                                        TooManyRequestsException,
                                                        InternalServerException,
                                                        AwsServiceException,
                                                        SdkClientException,
                                                        AccountException

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:

Result of the PutAlternateContact operation returned by the service.

Throws:

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.

AwsServiceException

See Also:

AWS API Documentation

putAlternateContact

default PutAlternateContactResponse putAlternateContact(Consumer<PutAlternateContactRequest.Builder> putAlternateContactRequest)
                                                 throws ValidationException,
                                                        AccessDeniedException,
                                                        TooManyRequestsException,
                                                        InternalServerException,
                                                        AwsServiceException,
                                                        SdkClientException,
                                                        AccountException

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:

Result of the PutAlternateContact operation returned by the service.

Throws:

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.

AwsServiceException

See Also:

AWS API Documentation

putContactInformation

default PutContactInformationResponse putContactInformation(PutContactInformationRequest putContactInformationRequest)
                                                     throws ValidationException,
                                                            AccessDeniedException,
                                                            TooManyRequestsException,
                                                            InternalServerException,
                                                            AwsServiceException,
                                                            SdkClientException,
                                                            AccountException

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:

Result of the PutContactInformation operation returned by the service.

Throws:

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.

AwsServiceException

See Also:

AWS API Documentation

putContactInformation

default PutContactInformationResponse putContactInformation(Consumer<PutContactInformationRequest.Builder> putContactInformationRequest)
                                                     throws ValidationException,
                                                            AccessDeniedException,
                                                            TooManyRequestsException,
                                                            InternalServerException,
                                                            AwsServiceException,
                                                            SdkClientException,
                                                            AccountException

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:

Result of the PutContactInformation operation returned by the service.

Throws:

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.

AwsServiceException

See Also:

AWS API Documentation

startPrimaryEmailUpdate

default StartPrimaryEmailUpdateResponse startPrimaryEmailUpdate(StartPrimaryEmailUpdateRequest startPrimaryEmailUpdateRequest)
                                                         throws ResourceNotFoundException,
                                                                ValidationException,
                                                                ConflictException,
                                                                AccessDeniedException,
                                                                TooManyRequestsException,
                                                                InternalServerException,
                                                                AwsServiceException,
                                                                SdkClientException,
                                                                AccountException

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

Parameters:

startPrimaryEmailUpdateRequest -

Returns:

Result of the StartPrimaryEmailUpdate operation returned by the service.

Throws:

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.

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).

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.

AwsServiceException

See Also:

AWS API Documentation

startPrimaryEmailUpdate

default StartPrimaryEmailUpdateResponse startPrimaryEmailUpdate(Consumer<StartPrimaryEmailUpdateRequest.Builder> startPrimaryEmailUpdateRequest)
                                                         throws ResourceNotFoundException,
                                                                ValidationException,
                                                                ConflictException,
                                                                AccessDeniedException,
                                                                TooManyRequestsException,
                                                                InternalServerException,
                                                                AwsServiceException,
                                                                SdkClientException,
                                                                AccountException

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:

Result of the StartPrimaryEmailUpdate operation returned by the service.

Throws:

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.

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).

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.

AwsServiceException

See Also:

AWS API Documentation

create

static AccountClient create()

Create a AccountClient with the region loaded from the DefaultAwsRegionProviderChain and credentials loaded from the DefaultCredentialsProvider.

builder

static AccountClientBuilder builder()

Create a builder that can be used to configure and create a AccountClient.

serviceMetadata

static ServiceMetadata serviceMetadata()

serviceClientConfiguration

default AccountServiceClientConfiguration serviceClientConfiguration()

Specified by:

serviceClientConfiguration in interface AwsClient

Specified by:

serviceClientConfiguration in interface SdkClient