Interface RdsClient
-
- All Superinterfaces:
AutoCloseable
,AwsClient
,SdkAutoCloseable
,SdkClient
@Generated("software.amazon.awssdk:codegen") @ThreadSafe public interface RdsClient extends AwsClient
Service client for accessing Amazon RDS. This can be created using the staticbuilder()
method.Amazon Relational Database Service Amazon Relational Database Service (Amazon RDS) is a web service that makes it easier to set up, operate, and scale a relational database in the cloud. It provides cost-efficient, resizeable capacity for an industry-standard relational database and manages common database administration tasks, freeing up developers to focus on what makes their applications and businesses unique.
Amazon RDS gives you access to the capabilities of a MySQL, MariaDB, PostgreSQL, Microsoft SQL Server, Oracle, Db2, or Amazon Aurora database server. These capabilities mean that the code, applications, and tools you already use today with your existing databases work with Amazon RDS without modification. Amazon RDS automatically backs up your database and maintains the database software that powers your DB instance. Amazon RDS is flexible: you can scale your DB instance's compute resources and storage capacity to meet your application's demand. As with all Amazon Web Services, there are no up-front investments, and you pay only for the resources you use.
This interface reference for Amazon RDS contains documentation for a programming or command line interface you can use to manage Amazon RDS. Amazon RDS is asynchronous, which means that some interfaces might require techniques such as polling or callback functions to determine when a command has been applied. In this reference, the parameter descriptions indicate whether a command is applied immediately, on the next instance reboot, or during the maintenance window. The reference structure is as follows, and we list following some related topics from the user guide.
Amazon RDS API Reference
-
For the alphabetical list of API actions, see API Actions.
-
For the alphabetical list of data types, see Data Types.
-
For a list of common query parameters, see Common Parameters.
-
For descriptions of the error codes, see Common Errors.
Amazon RDS User Guide
-
For a summary of the Amazon RDS interfaces, see Available RDS Interfaces.
-
For more information about how to use the Query API, see Using the Query API.
-
-
Field Summary
Fields Modifier and Type Field Description static String
SERVICE_METADATA_ID
Value for looking up the service's metadata from theServiceMetadataProvider
.static String
SERVICE_NAME
-
Method Summary
-
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 theServiceMetadataProvider
.- See Also:
- Constant Field Values
-
-
Method Detail
-
addRoleToDBCluster
default AddRoleToDbClusterResponse addRoleToDBCluster(AddRoleToDbClusterRequest addRoleToDbClusterRequest) throws DbClusterNotFoundException, DbClusterRoleAlreadyExistsException, InvalidDbClusterStateException, DbClusterRoleQuotaExceededException, AwsServiceException, SdkClientException, RdsException
Associates an Identity and Access Management (IAM) role with a DB cluster.
- Parameters:
addRoleToDbClusterRequest
-- Returns:
- Result of the AddRoleToDBCluster operation returned by the service.
- Throws:
DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.DbClusterRoleAlreadyExistsException
- The specified IAM role Amazon Resource Name (ARN) is already associated with the specified DB cluster.InvalidDbClusterStateException
- The requested operation can't be performed while the cluster is in this state.DbClusterRoleQuotaExceededException
- You have exceeded the maximum number of IAM roles that can be associated with the specified DB cluster.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
addRoleToDBCluster
default AddRoleToDbClusterResponse addRoleToDBCluster(Consumer<AddRoleToDbClusterRequest.Builder> addRoleToDbClusterRequest) throws DbClusterNotFoundException, DbClusterRoleAlreadyExistsException, InvalidDbClusterStateException, DbClusterRoleQuotaExceededException, AwsServiceException, SdkClientException, RdsException
Associates an Identity and Access Management (IAM) role with a DB cluster.
This is a convenience which creates an instance of the
AddRoleToDbClusterRequest.Builder
avoiding the need to create one manually viaAddRoleToDbClusterRequest.builder()
- Parameters:
addRoleToDbClusterRequest
- AConsumer
that will call methods onAddRoleToDbClusterRequest.Builder
to create a request.- Returns:
- Result of the AddRoleToDBCluster operation returned by the service.
- Throws:
DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.DbClusterRoleAlreadyExistsException
- The specified IAM role Amazon Resource Name (ARN) is already associated with the specified DB cluster.InvalidDbClusterStateException
- The requested operation can't be performed while the cluster is in this state.DbClusterRoleQuotaExceededException
- You have exceeded the maximum number of IAM roles that can be associated with the specified DB cluster.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
addRoleToDBInstance
default AddRoleToDbInstanceResponse addRoleToDBInstance(AddRoleToDbInstanceRequest addRoleToDbInstanceRequest) throws DbInstanceNotFoundException, DbInstanceRoleAlreadyExistsException, InvalidDbInstanceStateException, DbInstanceRoleQuotaExceededException, AwsServiceException, SdkClientException, RdsException
Associates an Amazon Web Services Identity and Access Management (IAM) role with a DB instance.
To add a role to a DB instance, the status of the DB instance must be
available
.This command doesn't apply to RDS Custom.
- Parameters:
addRoleToDbInstanceRequest
-- Returns:
- Result of the AddRoleToDBInstance operation returned by the service.
- Throws:
DbInstanceNotFoundException
-DBInstanceIdentifier
doesn't refer to an existing DB instance.DbInstanceRoleAlreadyExistsException
- The specifiedRoleArn
orFeatureName
value is already associated with the DB instance.InvalidDbInstanceStateException
- The DB instance isn't in a valid state.DbInstanceRoleQuotaExceededException
- You can't associate any more Amazon Web Services Identity and Access Management (IAM) roles with the DB instance because the quota has been reached.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
addRoleToDBInstance
default AddRoleToDbInstanceResponse addRoleToDBInstance(Consumer<AddRoleToDbInstanceRequest.Builder> addRoleToDbInstanceRequest) throws DbInstanceNotFoundException, DbInstanceRoleAlreadyExistsException, InvalidDbInstanceStateException, DbInstanceRoleQuotaExceededException, AwsServiceException, SdkClientException, RdsException
Associates an Amazon Web Services Identity and Access Management (IAM) role with a DB instance.
To add a role to a DB instance, the status of the DB instance must be
available
.This command doesn't apply to RDS Custom.
This is a convenience which creates an instance of the
AddRoleToDbInstanceRequest.Builder
avoiding the need to create one manually viaAddRoleToDbInstanceRequest.builder()
- Parameters:
addRoleToDbInstanceRequest
- AConsumer
that will call methods onAddRoleToDbInstanceRequest.Builder
to create a request.- Returns:
- Result of the AddRoleToDBInstance operation returned by the service.
- Throws:
DbInstanceNotFoundException
-DBInstanceIdentifier
doesn't refer to an existing DB instance.DbInstanceRoleAlreadyExistsException
- The specifiedRoleArn
orFeatureName
value is already associated with the DB instance.InvalidDbInstanceStateException
- The DB instance isn't in a valid state.DbInstanceRoleQuotaExceededException
- You can't associate any more Amazon Web Services Identity and Access Management (IAM) roles with the DB instance because the quota has been reached.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
addSourceIdentifierToSubscription
default AddSourceIdentifierToSubscriptionResponse addSourceIdentifierToSubscription(AddSourceIdentifierToSubscriptionRequest addSourceIdentifierToSubscriptionRequest) throws SubscriptionNotFoundException, SourceNotFoundException, AwsServiceException, SdkClientException, RdsException
Adds a source identifier to an existing RDS event notification subscription.
- Parameters:
addSourceIdentifierToSubscriptionRequest
-- Returns:
- Result of the AddSourceIdentifierToSubscription operation returned by the service.
- Throws:
SubscriptionNotFoundException
- The subscription name does not exist.SourceNotFoundException
- The requested source could not be found.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
addSourceIdentifierToSubscription
default AddSourceIdentifierToSubscriptionResponse addSourceIdentifierToSubscription(Consumer<AddSourceIdentifierToSubscriptionRequest.Builder> addSourceIdentifierToSubscriptionRequest) throws SubscriptionNotFoundException, SourceNotFoundException, AwsServiceException, SdkClientException, RdsException
Adds a source identifier to an existing RDS event notification subscription.
This is a convenience which creates an instance of the
AddSourceIdentifierToSubscriptionRequest.Builder
avoiding the need to create one manually viaAddSourceIdentifierToSubscriptionRequest.builder()
- Parameters:
addSourceIdentifierToSubscriptionRequest
- AConsumer
that will call methods onAddSourceIdentifierToSubscriptionRequest.Builder
to create a request.- Returns:
- Result of the AddSourceIdentifierToSubscription operation returned by the service.
- Throws:
SubscriptionNotFoundException
- The subscription name does not exist.SourceNotFoundException
- The requested source could not be found.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
addTagsToResource
default AddTagsToResourceResponse addTagsToResource(AddTagsToResourceRequest addTagsToResourceRequest) throws DbInstanceNotFoundException, DbClusterNotFoundException, DbSnapshotNotFoundException, DbProxyNotFoundException, DbProxyTargetGroupNotFoundException, BlueGreenDeploymentNotFoundException, IntegrationNotFoundException, TenantDatabaseNotFoundException, DbSnapshotTenantDatabaseNotFoundException, AwsServiceException, SdkClientException, RdsException
Adds metadata tags to an Amazon RDS resource. These tags can also be used with cost allocation reporting to track cost associated with Amazon RDS resources, or used in a Condition statement in an IAM policy for Amazon RDS.
For an overview on tagging your relational database resources, see Tagging Amazon RDS Resources or Tagging Amazon Aurora and Amazon RDS Resources.
- Parameters:
addTagsToResourceRequest
-- Returns:
- Result of the AddTagsToResource operation returned by the service.
- Throws:
DbInstanceNotFoundException
-DBInstanceIdentifier
doesn't refer to an existing DB instance.DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.DbSnapshotNotFoundException
-DBSnapshotIdentifier
doesn't refer to an existing DB snapshot.DbProxyNotFoundException
- The specified proxy name doesn't correspond to a proxy owned by your Amazon Web Services account in the specified Amazon Web Services Region.DbProxyTargetGroupNotFoundException
- The specified target group isn't available for a proxy owned by your Amazon Web Services account in the specified Amazon Web Services Region.BlueGreenDeploymentNotFoundException
-BlueGreenDeploymentIdentifier
doesn't refer to an existing blue/green deployment.IntegrationNotFoundException
- The specified integration could not be found.TenantDatabaseNotFoundException
- The specified tenant database wasn't found in the DB instance.DbSnapshotTenantDatabaseNotFoundException
- The specified snapshot tenant database wasn't found.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
addTagsToResource
default AddTagsToResourceResponse addTagsToResource(Consumer<AddTagsToResourceRequest.Builder> addTagsToResourceRequest) throws DbInstanceNotFoundException, DbClusterNotFoundException, DbSnapshotNotFoundException, DbProxyNotFoundException, DbProxyTargetGroupNotFoundException, BlueGreenDeploymentNotFoundException, IntegrationNotFoundException, TenantDatabaseNotFoundException, DbSnapshotTenantDatabaseNotFoundException, AwsServiceException, SdkClientException, RdsException
Adds metadata tags to an Amazon RDS resource. These tags can also be used with cost allocation reporting to track cost associated with Amazon RDS resources, or used in a Condition statement in an IAM policy for Amazon RDS.
For an overview on tagging your relational database resources, see Tagging Amazon RDS Resources or Tagging Amazon Aurora and Amazon RDS Resources.
This is a convenience which creates an instance of the
AddTagsToResourceRequest.Builder
avoiding the need to create one manually viaAddTagsToResourceRequest.builder()
- Parameters:
addTagsToResourceRequest
- AConsumer
that will call methods onAddTagsToResourceRequest.Builder
to create a request.- Returns:
- Result of the AddTagsToResource operation returned by the service.
- Throws:
DbInstanceNotFoundException
-DBInstanceIdentifier
doesn't refer to an existing DB instance.DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.DbSnapshotNotFoundException
-DBSnapshotIdentifier
doesn't refer to an existing DB snapshot.DbProxyNotFoundException
- The specified proxy name doesn't correspond to a proxy owned by your Amazon Web Services account in the specified Amazon Web Services Region.DbProxyTargetGroupNotFoundException
- The specified target group isn't available for a proxy owned by your Amazon Web Services account in the specified Amazon Web Services Region.BlueGreenDeploymentNotFoundException
-BlueGreenDeploymentIdentifier
doesn't refer to an existing blue/green deployment.IntegrationNotFoundException
- The specified integration could not be found.TenantDatabaseNotFoundException
- The specified tenant database wasn't found in the DB instance.DbSnapshotTenantDatabaseNotFoundException
- The specified snapshot tenant database wasn't found.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
applyPendingMaintenanceAction
default ApplyPendingMaintenanceActionResponse applyPendingMaintenanceAction(ApplyPendingMaintenanceActionRequest applyPendingMaintenanceActionRequest) throws ResourceNotFoundException, InvalidDbClusterStateException, InvalidDbInstanceStateException, AwsServiceException, SdkClientException, RdsException
Applies a pending maintenance action to a resource (for example, to a DB instance).
- Parameters:
applyPendingMaintenanceActionRequest
-- Returns:
- Result of the ApplyPendingMaintenanceAction operation returned by the service.
- Throws:
ResourceNotFoundException
- The specified resource ID was not found.InvalidDbClusterStateException
- The requested operation can't be performed while the cluster is in this state.InvalidDbInstanceStateException
- The DB instance isn't in a valid state.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
applyPendingMaintenanceAction
default ApplyPendingMaintenanceActionResponse applyPendingMaintenanceAction(Consumer<ApplyPendingMaintenanceActionRequest.Builder> applyPendingMaintenanceActionRequest) throws ResourceNotFoundException, InvalidDbClusterStateException, InvalidDbInstanceStateException, AwsServiceException, SdkClientException, RdsException
Applies a pending maintenance action to a resource (for example, to a DB instance).
This is a convenience which creates an instance of the
ApplyPendingMaintenanceActionRequest.Builder
avoiding the need to create one manually viaApplyPendingMaintenanceActionRequest.builder()
- Parameters:
applyPendingMaintenanceActionRequest
- AConsumer
that will call methods onApplyPendingMaintenanceActionRequest.Builder
to create a request.- Returns:
- Result of the ApplyPendingMaintenanceAction operation returned by the service.
- Throws:
ResourceNotFoundException
- The specified resource ID was not found.InvalidDbClusterStateException
- The requested operation can't be performed while the cluster is in this state.InvalidDbInstanceStateException
- The DB instance isn't in a valid state.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
authorizeDBSecurityGroupIngress
default AuthorizeDbSecurityGroupIngressResponse authorizeDBSecurityGroupIngress(AuthorizeDbSecurityGroupIngressRequest authorizeDbSecurityGroupIngressRequest) throws DbSecurityGroupNotFoundException, InvalidDbSecurityGroupStateException, AuthorizationAlreadyExistsException, AuthorizationQuotaExceededException, AwsServiceException, SdkClientException, RdsException
Enables ingress to a DBSecurityGroup using one of two forms of authorization. First, EC2 or VPC security groups can be added to the DBSecurityGroup if the application using the database is running on EC2 or VPC instances. Second, IP ranges are available if the application accessing your database is running on the internet. Required parameters for this API are one of CIDR range, EC2SecurityGroupId for VPC, or (EC2SecurityGroupOwnerId and either EC2SecurityGroupName or EC2SecurityGroupId for non-VPC).
You can't authorize ingress from an EC2 security group in one Amazon Web Services Region to an Amazon RDS DB instance in another. You can't authorize ingress from a VPC security group in one VPC to an Amazon RDS DB instance in another.
For an overview of CIDR ranges, go to the Wikipedia Tutorial.
EC2-Classic was retired on August 15, 2022. If you haven't migrated from EC2-Classic to a VPC, we recommend that you migrate as soon as possible. For more information, see Migrate from EC2-Classic to a VPC in the Amazon EC2 User Guide, the blog EC2-Classic Networking is Retiring – Here’s How to Prepare, and Moving a DB instance not in a VPC into a VPC in the Amazon RDS User Guide.
- Parameters:
authorizeDbSecurityGroupIngressRequest
-- Returns:
- Result of the AuthorizeDBSecurityGroupIngress operation returned by the service.
- Throws:
DbSecurityGroupNotFoundException
-DBSecurityGroupName
doesn't refer to an existing DB security group.InvalidDbSecurityGroupStateException
- The state of the DB security group doesn't allow deletion.AuthorizationAlreadyExistsException
- The specified CIDR IP range or Amazon EC2 security group is already authorized for the specified DB security group.AuthorizationQuotaExceededException
- The DB security group authorization quota has been reached.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
authorizeDBSecurityGroupIngress
default AuthorizeDbSecurityGroupIngressResponse authorizeDBSecurityGroupIngress(Consumer<AuthorizeDbSecurityGroupIngressRequest.Builder> authorizeDbSecurityGroupIngressRequest) throws DbSecurityGroupNotFoundException, InvalidDbSecurityGroupStateException, AuthorizationAlreadyExistsException, AuthorizationQuotaExceededException, AwsServiceException, SdkClientException, RdsException
Enables ingress to a DBSecurityGroup using one of two forms of authorization. First, EC2 or VPC security groups can be added to the DBSecurityGroup if the application using the database is running on EC2 or VPC instances. Second, IP ranges are available if the application accessing your database is running on the internet. Required parameters for this API are one of CIDR range, EC2SecurityGroupId for VPC, or (EC2SecurityGroupOwnerId and either EC2SecurityGroupName or EC2SecurityGroupId for non-VPC).
You can't authorize ingress from an EC2 security group in one Amazon Web Services Region to an Amazon RDS DB instance in another. You can't authorize ingress from a VPC security group in one VPC to an Amazon RDS DB instance in another.
For an overview of CIDR ranges, go to the Wikipedia Tutorial.
EC2-Classic was retired on August 15, 2022. If you haven't migrated from EC2-Classic to a VPC, we recommend that you migrate as soon as possible. For more information, see Migrate from EC2-Classic to a VPC in the Amazon EC2 User Guide, the blog EC2-Classic Networking is Retiring – Here’s How to Prepare, and Moving a DB instance not in a VPC into a VPC in the Amazon RDS User Guide.
This is a convenience which creates an instance of the
AuthorizeDbSecurityGroupIngressRequest.Builder
avoiding the need to create one manually viaAuthorizeDbSecurityGroupIngressRequest.builder()
- Parameters:
authorizeDbSecurityGroupIngressRequest
- AConsumer
that will call methods onAuthorizeDbSecurityGroupIngressRequest.Builder
to create a request.- Returns:
- Result of the AuthorizeDBSecurityGroupIngress operation returned by the service.
- Throws:
DbSecurityGroupNotFoundException
-DBSecurityGroupName
doesn't refer to an existing DB security group.InvalidDbSecurityGroupStateException
- The state of the DB security group doesn't allow deletion.AuthorizationAlreadyExistsException
- The specified CIDR IP range or Amazon EC2 security group is already authorized for the specified DB security group.AuthorizationQuotaExceededException
- The DB security group authorization quota has been reached.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
backtrackDBCluster
default BacktrackDbClusterResponse backtrackDBCluster(BacktrackDbClusterRequest backtrackDbClusterRequest) throws DbClusterNotFoundException, InvalidDbClusterStateException, AwsServiceException, SdkClientException, RdsException
Backtracks a DB cluster to a specific time, without creating a new DB cluster.
For more information on backtracking, see Backtracking an Aurora DB Cluster in the Amazon Aurora User Guide.
This action applies only to Aurora MySQL DB clusters.
- Parameters:
backtrackDbClusterRequest
-- Returns:
- Result of the BacktrackDBCluster operation returned by the service.
- Throws:
DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.InvalidDbClusterStateException
- The requested operation can't be performed while the cluster is in this state.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
backtrackDBCluster
default BacktrackDbClusterResponse backtrackDBCluster(Consumer<BacktrackDbClusterRequest.Builder> backtrackDbClusterRequest) throws DbClusterNotFoundException, InvalidDbClusterStateException, AwsServiceException, SdkClientException, RdsException
Backtracks a DB cluster to a specific time, without creating a new DB cluster.
For more information on backtracking, see Backtracking an Aurora DB Cluster in the Amazon Aurora User Guide.
This action applies only to Aurora MySQL DB clusters.
This is a convenience which creates an instance of the
BacktrackDbClusterRequest.Builder
avoiding the need to create one manually viaBacktrackDbClusterRequest.builder()
- Parameters:
backtrackDbClusterRequest
- AConsumer
that will call methods onBacktrackDbClusterRequest.Builder
to create a request.- Returns:
- Result of the BacktrackDBCluster operation returned by the service.
- Throws:
DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.InvalidDbClusterStateException
- The requested operation can't be performed while the cluster is in this state.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
cancelExportTask
default CancelExportTaskResponse cancelExportTask(CancelExportTaskRequest cancelExportTaskRequest) throws ExportTaskNotFoundException, InvalidExportTaskStateException, AwsServiceException, SdkClientException, RdsException
Cancels an export task in progress that is exporting a snapshot or cluster to Amazon S3. Any data that has already been written to the S3 bucket isn't removed.
- Parameters:
cancelExportTaskRequest
-- Returns:
- Result of the CancelExportTask operation returned by the service.
- Throws:
ExportTaskNotFoundException
- The export task doesn't exist.InvalidExportTaskStateException
- You can't cancel an export task that has completed.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
cancelExportTask
default CancelExportTaskResponse cancelExportTask(Consumer<CancelExportTaskRequest.Builder> cancelExportTaskRequest) throws ExportTaskNotFoundException, InvalidExportTaskStateException, AwsServiceException, SdkClientException, RdsException
Cancels an export task in progress that is exporting a snapshot or cluster to Amazon S3. Any data that has already been written to the S3 bucket isn't removed.
This is a convenience which creates an instance of the
CancelExportTaskRequest.Builder
avoiding the need to create one manually viaCancelExportTaskRequest.builder()
- Parameters:
cancelExportTaskRequest
- AConsumer
that will call methods onCancelExportTaskRequest.Builder
to create a request.- Returns:
- Result of the CancelExportTask operation returned by the service.
- Throws:
ExportTaskNotFoundException
- The export task doesn't exist.InvalidExportTaskStateException
- You can't cancel an export task that has completed.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
copyDBClusterParameterGroup
default CopyDbClusterParameterGroupResponse copyDBClusterParameterGroup(CopyDbClusterParameterGroupRequest copyDbClusterParameterGroupRequest) throws DbParameterGroupNotFoundException, DbParameterGroupQuotaExceededException, DbParameterGroupAlreadyExistsException, AwsServiceException, SdkClientException, RdsException
Copies the specified DB cluster parameter group.
You can't copy a default DB cluster parameter group. Instead, create a new custom DB cluster parameter group, which copies the default parameters and values for the specified DB cluster parameter group family.
- Parameters:
copyDbClusterParameterGroupRequest
-- Returns:
- Result of the CopyDBClusterParameterGroup operation returned by the service.
- Throws:
DbParameterGroupNotFoundException
-DBParameterGroupName
doesn't refer to an existing DB parameter group.DbParameterGroupQuotaExceededException
- The request would result in the user exceeding the allowed number of DB parameter groups.DbParameterGroupAlreadyExistsException
- A DB parameter group with the same name exists.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
copyDBClusterParameterGroup
default CopyDbClusterParameterGroupResponse copyDBClusterParameterGroup(Consumer<CopyDbClusterParameterGroupRequest.Builder> copyDbClusterParameterGroupRequest) throws DbParameterGroupNotFoundException, DbParameterGroupQuotaExceededException, DbParameterGroupAlreadyExistsException, AwsServiceException, SdkClientException, RdsException
Copies the specified DB cluster parameter group.
You can't copy a default DB cluster parameter group. Instead, create a new custom DB cluster parameter group, which copies the default parameters and values for the specified DB cluster parameter group family.
This is a convenience which creates an instance of the
CopyDbClusterParameterGroupRequest.Builder
avoiding the need to create one manually viaCopyDbClusterParameterGroupRequest.builder()
- Parameters:
copyDbClusterParameterGroupRequest
- AConsumer
that will call methods onCopyDbClusterParameterGroupRequest.Builder
to create a request.- Returns:
- Result of the CopyDBClusterParameterGroup operation returned by the service.
- Throws:
DbParameterGroupNotFoundException
-DBParameterGroupName
doesn't refer to an existing DB parameter group.DbParameterGroupQuotaExceededException
- The request would result in the user exceeding the allowed number of DB parameter groups.DbParameterGroupAlreadyExistsException
- A DB parameter group with the same name exists.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
copyDBClusterSnapshot
default CopyDbClusterSnapshotResponse copyDBClusterSnapshot(CopyDbClusterSnapshotRequest copyDbClusterSnapshotRequest) throws DbClusterSnapshotAlreadyExistsException, DbClusterSnapshotNotFoundException, InvalidDbClusterStateException, InvalidDbClusterSnapshotStateException, SnapshotQuotaExceededException, KmsKeyNotAccessibleException, AwsServiceException, SdkClientException, RdsException
Copies a snapshot of a DB cluster.
To copy a DB cluster snapshot from a shared manual DB cluster snapshot,
SourceDBClusterSnapshotIdentifier
must be the Amazon Resource Name (ARN) of the shared DB cluster snapshot.You can copy an encrypted DB cluster snapshot from another Amazon Web Services Region. In that case, the Amazon Web Services Region where you call the
CopyDBClusterSnapshot
operation is the destination Amazon Web Services Region for the encrypted DB cluster snapshot to be copied to. To copy an encrypted DB cluster snapshot from another Amazon Web Services Region, you must provide the following values:-
KmsKeyId
- The Amazon Web Services Key Management System (Amazon Web Services KMS) key identifier for the key to use to encrypt the copy of the DB cluster snapshot in the destination Amazon Web Services Region. -
TargetDBClusterSnapshotIdentifier
- The identifier for the new copy of the DB cluster snapshot in the destination Amazon Web Services Region. -
SourceDBClusterSnapshotIdentifier
- The DB cluster snapshot identifier for the encrypted DB cluster snapshot to be copied. This identifier must be in the ARN format for the source Amazon Web Services Region and is the same value as theSourceDBClusterSnapshotIdentifier
in the presigned URL.
To cancel the copy operation once it is in progress, delete the target DB cluster snapshot identified by
TargetDBClusterSnapshotIdentifier
while that DB cluster snapshot is in "copying" status.For more information on copying encrypted Amazon Aurora DB cluster snapshots from one Amazon Web Services Region to another, see Copying a Snapshot in the Amazon Aurora User Guide.
For more information on Amazon Aurora DB clusters, see What is Amazon Aurora? in the Amazon Aurora User Guide.
For more information on Multi-AZ DB clusters, see Multi-AZ DB cluster deployments in the Amazon RDS User Guide.
- Parameters:
copyDbClusterSnapshotRequest
-- Returns:
- Result of the CopyDBClusterSnapshot operation returned by the service.
- Throws:
DbClusterSnapshotAlreadyExistsException
- The user already has a DB cluster snapshot with the given identifier.DbClusterSnapshotNotFoundException
-DBClusterSnapshotIdentifier
doesn't refer to an existing DB cluster snapshot.InvalidDbClusterStateException
- The requested operation can't be performed while the cluster is in this state.InvalidDbClusterSnapshotStateException
- The supplied value isn't a valid DB cluster snapshot state.SnapshotQuotaExceededException
- The request would result in the user exceeding the allowed number of DB snapshots.KmsKeyNotAccessibleException
- An error occurred accessing an Amazon Web Services KMS key.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
-
copyDBClusterSnapshot
default CopyDbClusterSnapshotResponse copyDBClusterSnapshot(Consumer<CopyDbClusterSnapshotRequest.Builder> copyDbClusterSnapshotRequest) throws DbClusterSnapshotAlreadyExistsException, DbClusterSnapshotNotFoundException, InvalidDbClusterStateException, InvalidDbClusterSnapshotStateException, SnapshotQuotaExceededException, KmsKeyNotAccessibleException, AwsServiceException, SdkClientException, RdsException
Copies a snapshot of a DB cluster.
To copy a DB cluster snapshot from a shared manual DB cluster snapshot,
SourceDBClusterSnapshotIdentifier
must be the Amazon Resource Name (ARN) of the shared DB cluster snapshot.You can copy an encrypted DB cluster snapshot from another Amazon Web Services Region. In that case, the Amazon Web Services Region where you call the
CopyDBClusterSnapshot
operation is the destination Amazon Web Services Region for the encrypted DB cluster snapshot to be copied to. To copy an encrypted DB cluster snapshot from another Amazon Web Services Region, you must provide the following values:-
KmsKeyId
- The Amazon Web Services Key Management System (Amazon Web Services KMS) key identifier for the key to use to encrypt the copy of the DB cluster snapshot in the destination Amazon Web Services Region. -
TargetDBClusterSnapshotIdentifier
- The identifier for the new copy of the DB cluster snapshot in the destination Amazon Web Services Region. -
SourceDBClusterSnapshotIdentifier
- The DB cluster snapshot identifier for the encrypted DB cluster snapshot to be copied. This identifier must be in the ARN format for the source Amazon Web Services Region and is the same value as theSourceDBClusterSnapshotIdentifier
in the presigned URL.
To cancel the copy operation once it is in progress, delete the target DB cluster snapshot identified by
TargetDBClusterSnapshotIdentifier
while that DB cluster snapshot is in "copying" status.For more information on copying encrypted Amazon Aurora DB cluster snapshots from one Amazon Web Services Region to another, see Copying a Snapshot in the Amazon Aurora User Guide.
For more information on Amazon Aurora DB clusters, see What is Amazon Aurora? in the Amazon Aurora User Guide.
For more information on Multi-AZ DB clusters, see Multi-AZ DB cluster deployments in the Amazon RDS User Guide.
This is a convenience which creates an instance of the
CopyDbClusterSnapshotRequest.Builder
avoiding the need to create one manually viaCopyDbClusterSnapshotRequest.builder()
- Parameters:
copyDbClusterSnapshotRequest
- AConsumer
that will call methods onCopyDbClusterSnapshotRequest.Builder
to create a request.- Returns:
- Result of the CopyDBClusterSnapshot operation returned by the service.
- Throws:
DbClusterSnapshotAlreadyExistsException
- The user already has a DB cluster snapshot with the given identifier.DbClusterSnapshotNotFoundException
-DBClusterSnapshotIdentifier
doesn't refer to an existing DB cluster snapshot.InvalidDbClusterStateException
- The requested operation can't be performed while the cluster is in this state.InvalidDbClusterSnapshotStateException
- The supplied value isn't a valid DB cluster snapshot state.SnapshotQuotaExceededException
- The request would result in the user exceeding the allowed number of DB snapshots.KmsKeyNotAccessibleException
- An error occurred accessing an Amazon Web Services KMS key.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
-
copyDBParameterGroup
default CopyDbParameterGroupResponse copyDBParameterGroup(CopyDbParameterGroupRequest copyDbParameterGroupRequest) throws DbParameterGroupNotFoundException, DbParameterGroupAlreadyExistsException, DbParameterGroupQuotaExceededException, AwsServiceException, SdkClientException, RdsException
Copies the specified DB parameter group.
You can't copy a default DB parameter group. Instead, create a new custom DB parameter group, which copies the default parameters and values for the specified DB parameter group family.
- Parameters:
copyDbParameterGroupRequest
-- Returns:
- Result of the CopyDBParameterGroup operation returned by the service.
- Throws:
DbParameterGroupNotFoundException
-DBParameterGroupName
doesn't refer to an existing DB parameter group.DbParameterGroupAlreadyExistsException
- A DB parameter group with the same name exists.DbParameterGroupQuotaExceededException
- The request would result in the user exceeding the allowed number of DB parameter groups.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
copyDBParameterGroup
default CopyDbParameterGroupResponse copyDBParameterGroup(Consumer<CopyDbParameterGroupRequest.Builder> copyDbParameterGroupRequest) throws DbParameterGroupNotFoundException, DbParameterGroupAlreadyExistsException, DbParameterGroupQuotaExceededException, AwsServiceException, SdkClientException, RdsException
Copies the specified DB parameter group.
You can't copy a default DB parameter group. Instead, create a new custom DB parameter group, which copies the default parameters and values for the specified DB parameter group family.
This is a convenience which creates an instance of the
CopyDbParameterGroupRequest.Builder
avoiding the need to create one manually viaCopyDbParameterGroupRequest.builder()
- Parameters:
copyDbParameterGroupRequest
- AConsumer
that will call methods onCopyDbParameterGroupRequest.Builder
to create a request.- Returns:
- Result of the CopyDBParameterGroup operation returned by the service.
- Throws:
DbParameterGroupNotFoundException
-DBParameterGroupName
doesn't refer to an existing DB parameter group.DbParameterGroupAlreadyExistsException
- A DB parameter group with the same name exists.DbParameterGroupQuotaExceededException
- The request would result in the user exceeding the allowed number of DB parameter groups.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
copyDBSnapshot
default CopyDbSnapshotResponse copyDBSnapshot(CopyDbSnapshotRequest copyDbSnapshotRequest) throws DbSnapshotAlreadyExistsException, DbSnapshotNotFoundException, InvalidDbSnapshotStateException, SnapshotQuotaExceededException, KmsKeyNotAccessibleException, CustomAvailabilityZoneNotFoundException, AwsServiceException, SdkClientException, RdsException
Copies the specified DB snapshot. The source DB snapshot must be in the
available
state.You can copy a snapshot from one Amazon Web Services Region to another. In that case, the Amazon Web Services Region where you call the
CopyDBSnapshot
operation is the destination Amazon Web Services Region for the DB snapshot copy.This command doesn't apply to RDS Custom.
For more information about copying snapshots, see Copying a DB Snapshot in the Amazon RDS User Guide.
- Parameters:
copyDbSnapshotRequest
-- Returns:
- Result of the CopyDBSnapshot operation returned by the service.
- Throws:
DbSnapshotAlreadyExistsException
-DBSnapshotIdentifier
is already used by an existing snapshot.DbSnapshotNotFoundException
-DBSnapshotIdentifier
doesn't refer to an existing DB snapshot.InvalidDbSnapshotStateException
- The state of the DB snapshot doesn't allow deletion.SnapshotQuotaExceededException
- The request would result in the user exceeding the allowed number of DB snapshots.KmsKeyNotAccessibleException
- An error occurred accessing an Amazon Web Services KMS key.CustomAvailabilityZoneNotFoundException
-CustomAvailabilityZoneId
doesn't refer to an existing custom Availability Zone identifier.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
copyDBSnapshot
default CopyDbSnapshotResponse copyDBSnapshot(Consumer<CopyDbSnapshotRequest.Builder> copyDbSnapshotRequest) throws DbSnapshotAlreadyExistsException, DbSnapshotNotFoundException, InvalidDbSnapshotStateException, SnapshotQuotaExceededException, KmsKeyNotAccessibleException, CustomAvailabilityZoneNotFoundException, AwsServiceException, SdkClientException, RdsException
Copies the specified DB snapshot. The source DB snapshot must be in the
available
state.You can copy a snapshot from one Amazon Web Services Region to another. In that case, the Amazon Web Services Region where you call the
CopyDBSnapshot
operation is the destination Amazon Web Services Region for the DB snapshot copy.This command doesn't apply to RDS Custom.
For more information about copying snapshots, see Copying a DB Snapshot in the Amazon RDS User Guide.
This is a convenience which creates an instance of the
CopyDbSnapshotRequest.Builder
avoiding the need to create one manually viaCopyDbSnapshotRequest.builder()
- Parameters:
copyDbSnapshotRequest
- AConsumer
that will call methods onCopyDbSnapshotRequest.Builder
to create a request.- Returns:
- Result of the CopyDBSnapshot operation returned by the service.
- Throws:
DbSnapshotAlreadyExistsException
-DBSnapshotIdentifier
is already used by an existing snapshot.DbSnapshotNotFoundException
-DBSnapshotIdentifier
doesn't refer to an existing DB snapshot.InvalidDbSnapshotStateException
- The state of the DB snapshot doesn't allow deletion.SnapshotQuotaExceededException
- The request would result in the user exceeding the allowed number of DB snapshots.KmsKeyNotAccessibleException
- An error occurred accessing an Amazon Web Services KMS key.CustomAvailabilityZoneNotFoundException
-CustomAvailabilityZoneId
doesn't refer to an existing custom Availability Zone identifier.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
copyOptionGroup
default CopyOptionGroupResponse copyOptionGroup(CopyOptionGroupRequest copyOptionGroupRequest) throws OptionGroupAlreadyExistsException, OptionGroupNotFoundException, OptionGroupQuotaExceededException, AwsServiceException, SdkClientException, RdsException
Copies the specified option group.
- Parameters:
copyOptionGroupRequest
-- Returns:
- Result of the CopyOptionGroup operation returned by the service.
- Throws:
OptionGroupAlreadyExistsException
- The option group you are trying to create already exists.OptionGroupNotFoundException
- The specified option group could not be found.OptionGroupQuotaExceededException
- The quota of 20 option groups was exceeded for this Amazon Web Services account.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
copyOptionGroup
default CopyOptionGroupResponse copyOptionGroup(Consumer<CopyOptionGroupRequest.Builder> copyOptionGroupRequest) throws OptionGroupAlreadyExistsException, OptionGroupNotFoundException, OptionGroupQuotaExceededException, AwsServiceException, SdkClientException, RdsException
Copies the specified option group.
This is a convenience which creates an instance of the
CopyOptionGroupRequest.Builder
avoiding the need to create one manually viaCopyOptionGroupRequest.builder()
- Parameters:
copyOptionGroupRequest
- AConsumer
that will call methods onCopyOptionGroupRequest.Builder
to create a request.- Returns:
- Result of the CopyOptionGroup operation returned by the service.
- Throws:
OptionGroupAlreadyExistsException
- The option group you are trying to create already exists.OptionGroupNotFoundException
- The specified option group could not be found.OptionGroupQuotaExceededException
- The quota of 20 option groups was exceeded for this Amazon Web Services account.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
createBlueGreenDeployment
default CreateBlueGreenDeploymentResponse createBlueGreenDeployment(CreateBlueGreenDeploymentRequest createBlueGreenDeploymentRequest) throws DbInstanceNotFoundException, DbClusterNotFoundException, SourceDatabaseNotSupportedException, SourceClusterNotSupportedException, BlueGreenDeploymentAlreadyExistsException, DbParameterGroupNotFoundException, DbClusterParameterGroupNotFoundException, InstanceQuotaExceededException, DbClusterQuotaExceededException, InvalidDbInstanceStateException, InvalidDbClusterStateException, AwsServiceException, SdkClientException, RdsException
Creates a blue/green deployment.
A blue/green deployment creates a staging environment that copies the production environment. In a blue/green deployment, the blue environment is the current production environment. The green environment is the staging environment. The staging environment stays in sync with the current production environment using logical replication.
You can make changes to the databases in the green environment without affecting production workloads. For example, you can upgrade the major or minor DB engine version, change database parameters, or make schema changes in the staging environment. You can thoroughly test changes in the green environment. When ready, you can switch over the environments to promote the green environment to be the new production environment. The switchover typically takes under a minute.
For more information, see Using Amazon RDS Blue/Green Deployments for database updates in the Amazon RDS User Guide and Using Amazon RDS Blue/Green Deployments for database updates in the Amazon Aurora User Guide.
- Parameters:
createBlueGreenDeploymentRequest
-- Returns:
- Result of the CreateBlueGreenDeployment operation returned by the service.
- Throws:
DbInstanceNotFoundException
-DBInstanceIdentifier
doesn't refer to an existing DB instance.DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.SourceDatabaseNotSupportedException
- The source DB instance isn't supported for a blue/green deployment.SourceClusterNotSupportedException
- The source DB cluster isn't supported for a blue/green deployment.BlueGreenDeploymentAlreadyExistsException
- A blue/green deployment with the specified name already exists.DbParameterGroupNotFoundException
-DBParameterGroupName
doesn't refer to an existing DB parameter group.DbClusterParameterGroupNotFoundException
-DBClusterParameterGroupName
doesn't refer to an existing DB cluster parameter group.InstanceQuotaExceededException
- The request would result in the user exceeding the allowed number of DB instances.DbClusterQuotaExceededException
- The user attempted to create a new DB cluster and the user has already reached the maximum allowed DB cluster quota.InvalidDbInstanceStateException
- The DB instance isn't in a valid state.InvalidDbClusterStateException
- The requested operation can't be performed while the cluster is in this state.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
createBlueGreenDeployment
default CreateBlueGreenDeploymentResponse createBlueGreenDeployment(Consumer<CreateBlueGreenDeploymentRequest.Builder> createBlueGreenDeploymentRequest) throws DbInstanceNotFoundException, DbClusterNotFoundException, SourceDatabaseNotSupportedException, SourceClusterNotSupportedException, BlueGreenDeploymentAlreadyExistsException, DbParameterGroupNotFoundException, DbClusterParameterGroupNotFoundException, InstanceQuotaExceededException, DbClusterQuotaExceededException, InvalidDbInstanceStateException, InvalidDbClusterStateException, AwsServiceException, SdkClientException, RdsException
Creates a blue/green deployment.
A blue/green deployment creates a staging environment that copies the production environment. In a blue/green deployment, the blue environment is the current production environment. The green environment is the staging environment. The staging environment stays in sync with the current production environment using logical replication.
You can make changes to the databases in the green environment without affecting production workloads. For example, you can upgrade the major or minor DB engine version, change database parameters, or make schema changes in the staging environment. You can thoroughly test changes in the green environment. When ready, you can switch over the environments to promote the green environment to be the new production environment. The switchover typically takes under a minute.
For more information, see Using Amazon RDS Blue/Green Deployments for database updates in the Amazon RDS User Guide and Using Amazon RDS Blue/Green Deployments for database updates in the Amazon Aurora User Guide.
This is a convenience which creates an instance of the
CreateBlueGreenDeploymentRequest.Builder
avoiding the need to create one manually viaCreateBlueGreenDeploymentRequest.builder()
- Parameters:
createBlueGreenDeploymentRequest
- AConsumer
that will call methods onCreateBlueGreenDeploymentRequest.Builder
to create a request.- Returns:
- Result of the CreateBlueGreenDeployment operation returned by the service.
- Throws:
DbInstanceNotFoundException
-DBInstanceIdentifier
doesn't refer to an existing DB instance.DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.SourceDatabaseNotSupportedException
- The source DB instance isn't supported for a blue/green deployment.SourceClusterNotSupportedException
- The source DB cluster isn't supported for a blue/green deployment.BlueGreenDeploymentAlreadyExistsException
- A blue/green deployment with the specified name already exists.DbParameterGroupNotFoundException
-DBParameterGroupName
doesn't refer to an existing DB parameter group.DbClusterParameterGroupNotFoundException
-DBClusterParameterGroupName
doesn't refer to an existing DB cluster parameter group.InstanceQuotaExceededException
- The request would result in the user exceeding the allowed number of DB instances.DbClusterQuotaExceededException
- The user attempted to create a new DB cluster and the user has already reached the maximum allowed DB cluster quota.InvalidDbInstanceStateException
- The DB instance isn't in a valid state.InvalidDbClusterStateException
- The requested operation can't be performed while the cluster is in this state.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
createCustomDBEngineVersion
default CreateCustomDbEngineVersionResponse createCustomDBEngineVersion(CreateCustomDbEngineVersionRequest createCustomDbEngineVersionRequest) throws CustomDbEngineVersionAlreadyExistsException, CustomDbEngineVersionQuotaExceededException, Ec2ImagePropertiesNotSupportedException, KmsKeyNotAccessibleException, CreateCustomDbEngineVersionException, AwsServiceException, SdkClientException, RdsException
Creates a custom DB engine version (CEV).
- Parameters:
createCustomDbEngineVersionRequest
-- Returns:
- Result of the CreateCustomDBEngineVersion operation returned by the service.
- Throws:
CustomDbEngineVersionAlreadyExistsException
- A CEV with the specified name already exists.CustomDbEngineVersionQuotaExceededException
- You have exceeded your CEV quota.Ec2ImagePropertiesNotSupportedException
- The AMI configuration prerequisite has not been met.KmsKeyNotAccessibleException
- An error occurred accessing an Amazon Web Services KMS key.CreateCustomDbEngineVersionException
- An error occurred while trying to create the CEV.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
createCustomDBEngineVersion
default CreateCustomDbEngineVersionResponse createCustomDBEngineVersion(Consumer<CreateCustomDbEngineVersionRequest.Builder> createCustomDbEngineVersionRequest) throws CustomDbEngineVersionAlreadyExistsException, CustomDbEngineVersionQuotaExceededException, Ec2ImagePropertiesNotSupportedException, KmsKeyNotAccessibleException, CreateCustomDbEngineVersionException, AwsServiceException, SdkClientException, RdsException
Creates a custom DB engine version (CEV).
This is a convenience which creates an instance of the
CreateCustomDbEngineVersionRequest.Builder
avoiding the need to create one manually viaCreateCustomDbEngineVersionRequest.builder()
- Parameters:
createCustomDbEngineVersionRequest
- AConsumer
that will call methods onCreateCustomDbEngineVersionRequest.Builder
to create a request.- Returns:
- Result of the CreateCustomDBEngineVersion operation returned by the service.
- Throws:
CustomDbEngineVersionAlreadyExistsException
- A CEV with the specified name already exists.CustomDbEngineVersionQuotaExceededException
- You have exceeded your CEV quota.Ec2ImagePropertiesNotSupportedException
- The AMI configuration prerequisite has not been met.KmsKeyNotAccessibleException
- An error occurred accessing an Amazon Web Services KMS key.CreateCustomDbEngineVersionException
- An error occurred while trying to create the CEV.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
createDBCluster
default CreateDbClusterResponse createDBCluster(CreateDbClusterRequest createDbClusterRequest) throws DbClusterAlreadyExistsException, InsufficientDbInstanceCapacityException, InsufficientStorageClusterCapacityException, DbClusterQuotaExceededException, StorageQuotaExceededException, DbSubnetGroupNotFoundException, InvalidVpcNetworkStateException, InvalidDbClusterStateException, InvalidDbSubnetGroupException, InvalidDbSubnetGroupStateException, InvalidSubnetException, InvalidDbInstanceStateException, DbClusterParameterGroupNotFoundException, KmsKeyNotAccessibleException, DbClusterNotFoundException, DbInstanceNotFoundException, DbSubnetGroupDoesNotCoverEnoughAZsException, GlobalClusterNotFoundException, InvalidGlobalClusterStateException, DomainNotFoundException, OptionGroupNotFoundException, AwsServiceException, SdkClientException, RdsException
Creates a new Amazon Aurora DB cluster or Multi-AZ DB cluster.
If you create an Aurora DB cluster, the request creates an empty cluster. You must explicitly create the writer instance for your DB cluster using the CreateDBInstance operation. If you create a Multi-AZ DB cluster, the request creates a writer and two reader DB instances for you, each in a different Availability Zone.
You can use the
ReplicationSourceIdentifier
parameter to create an Amazon Aurora DB cluster as a read replica of another DB cluster or Amazon RDS for MySQL or PostgreSQL DB instance. For more information about Amazon Aurora, see What is Amazon Aurora? in the Amazon Aurora User Guide.You can also use the
ReplicationSourceIdentifier
parameter to create a Multi-AZ DB cluster read replica with an RDS for MySQL or PostgreSQL DB instance as the source. For more information about Multi-AZ DB clusters, see Multi-AZ DB cluster deployments in the Amazon RDS User Guide.- Parameters:
createDbClusterRequest
-- Returns:
- Result of the CreateDBCluster operation returned by the service.
- Throws:
DbClusterAlreadyExistsException
- The user already has a DB cluster with the given identifier.InsufficientDbInstanceCapacityException
- The specified DB instance class isn't available in the specified Availability Zone.InsufficientStorageClusterCapacityException
- There is insufficient storage available for the current action. You might be able to resolve this error by updating your subnet group to use different Availability Zones that have more storage available.DbClusterQuotaExceededException
- The user attempted to create a new DB cluster and the user has already reached the maximum allowed DB cluster quota.StorageQuotaExceededException
- The request would result in the user exceeding the allowed amount of storage available across all DB instances.DbSubnetGroupNotFoundException
-DBSubnetGroupName
doesn't refer to an existing DB subnet group.InvalidVpcNetworkStateException
- The DB subnet group doesn't cover all Availability Zones after it's created because of users' change.InvalidDbClusterStateException
- The requested operation can't be performed while the cluster is in this state.InvalidDbSubnetGroupException
- The DBSubnetGroup doesn't belong to the same VPC as that of an existing cross-region read replica of the same source instance.InvalidDbSubnetGroupStateException
- The DB subnet group cannot be deleted because it's in use.InvalidSubnetException
- The requested subnet is invalid, or multiple subnets were requested that are not all in a common VPC.InvalidDbInstanceStateException
- The DB instance isn't in a valid state.DbClusterParameterGroupNotFoundException
-DBClusterParameterGroupName
doesn't refer to an existing DB cluster parameter group.KmsKeyNotAccessibleException
- An error occurred accessing an Amazon Web Services KMS key.DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.DbInstanceNotFoundException
-DBInstanceIdentifier
doesn't refer to an existing DB instance.DbSubnetGroupDoesNotCoverEnoughAZsException
- Subnets in the DB subnet group should cover at least two Availability Zones unless there is only one Availability Zone.GlobalClusterNotFoundException
- TheGlobalClusterIdentifier
doesn't refer to an existing global database cluster.InvalidGlobalClusterStateException
- The global cluster is in an invalid state and can't perform the requested operation.DomainNotFoundException
-Domain
doesn't refer to an existing Active Directory domain.OptionGroupNotFoundException
- The specified option group could not be found.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
createDBCluster
default CreateDbClusterResponse createDBCluster(Consumer<CreateDbClusterRequest.Builder> createDbClusterRequest) throws DbClusterAlreadyExistsException, InsufficientDbInstanceCapacityException, InsufficientStorageClusterCapacityException, DbClusterQuotaExceededException, StorageQuotaExceededException, DbSubnetGroupNotFoundException, InvalidVpcNetworkStateException, InvalidDbClusterStateException, InvalidDbSubnetGroupException, InvalidDbSubnetGroupStateException, InvalidSubnetException, InvalidDbInstanceStateException, DbClusterParameterGroupNotFoundException, KmsKeyNotAccessibleException, DbClusterNotFoundException, DbInstanceNotFoundException, DbSubnetGroupDoesNotCoverEnoughAZsException, GlobalClusterNotFoundException, InvalidGlobalClusterStateException, DomainNotFoundException, OptionGroupNotFoundException, AwsServiceException, SdkClientException, RdsException
Creates a new Amazon Aurora DB cluster or Multi-AZ DB cluster.
If you create an Aurora DB cluster, the request creates an empty cluster. You must explicitly create the writer instance for your DB cluster using the CreateDBInstance operation. If you create a Multi-AZ DB cluster, the request creates a writer and two reader DB instances for you, each in a different Availability Zone.
You can use the
ReplicationSourceIdentifier
parameter to create an Amazon Aurora DB cluster as a read replica of another DB cluster or Amazon RDS for MySQL or PostgreSQL DB instance. For more information about Amazon Aurora, see What is Amazon Aurora? in the Amazon Aurora User Guide.You can also use the
ReplicationSourceIdentifier
parameter to create a Multi-AZ DB cluster read replica with an RDS for MySQL or PostgreSQL DB instance as the source. For more information about Multi-AZ DB clusters, see Multi-AZ DB cluster deployments in the Amazon RDS User Guide.
This is a convenience which creates an instance of the
CreateDbClusterRequest.Builder
avoiding the need to create one manually viaCreateDbClusterRequest.builder()
- Parameters:
createDbClusterRequest
- AConsumer
that will call methods onCreateDbClusterRequest.Builder
to create a request.- Returns:
- Result of the CreateDBCluster operation returned by the service.
- Throws:
DbClusterAlreadyExistsException
- The user already has a DB cluster with the given identifier.InsufficientDbInstanceCapacityException
- The specified DB instance class isn't available in the specified Availability Zone.InsufficientStorageClusterCapacityException
- There is insufficient storage available for the current action. You might be able to resolve this error by updating your subnet group to use different Availability Zones that have more storage available.DbClusterQuotaExceededException
- The user attempted to create a new DB cluster and the user has already reached the maximum allowed DB cluster quota.StorageQuotaExceededException
- The request would result in the user exceeding the allowed amount of storage available across all DB instances.DbSubnetGroupNotFoundException
-DBSubnetGroupName
doesn't refer to an existing DB subnet group.InvalidVpcNetworkStateException
- The DB subnet group doesn't cover all Availability Zones after it's created because of users' change.InvalidDbClusterStateException
- The requested operation can't be performed while the cluster is in this state.InvalidDbSubnetGroupException
- The DBSubnetGroup doesn't belong to the same VPC as that of an existing cross-region read replica of the same source instance.InvalidDbSubnetGroupStateException
- The DB subnet group cannot be deleted because it's in use.InvalidSubnetException
- The requested subnet is invalid, or multiple subnets were requested that are not all in a common VPC.InvalidDbInstanceStateException
- The DB instance isn't in a valid state.DbClusterParameterGroupNotFoundException
-DBClusterParameterGroupName
doesn't refer to an existing DB cluster parameter group.KmsKeyNotAccessibleException
- An error occurred accessing an Amazon Web Services KMS key.DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.DbInstanceNotFoundException
-DBInstanceIdentifier
doesn't refer to an existing DB instance.DbSubnetGroupDoesNotCoverEnoughAZsException
- Subnets in the DB subnet group should cover at least two Availability Zones unless there is only one Availability Zone.GlobalClusterNotFoundException
- TheGlobalClusterIdentifier
doesn't refer to an existing global database cluster.InvalidGlobalClusterStateException
- The global cluster is in an invalid state and can't perform the requested operation.DomainNotFoundException
-Domain
doesn't refer to an existing Active Directory domain.OptionGroupNotFoundException
- The specified option group could not be found.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
createDBClusterEndpoint
default CreateDbClusterEndpointResponse createDBClusterEndpoint(CreateDbClusterEndpointRequest createDbClusterEndpointRequest) throws DbClusterEndpointQuotaExceededException, DbClusterEndpointAlreadyExistsException, DbClusterNotFoundException, InvalidDbClusterStateException, DbInstanceNotFoundException, InvalidDbInstanceStateException, AwsServiceException, SdkClientException, RdsException
Creates a new custom endpoint and associates it with an Amazon Aurora DB cluster.
This action applies only to Aurora DB clusters.
- Parameters:
createDbClusterEndpointRequest
-- Returns:
- Result of the CreateDBClusterEndpoint operation returned by the service.
- Throws:
DbClusterEndpointQuotaExceededException
- The cluster already has the maximum number of custom endpoints.DbClusterEndpointAlreadyExistsException
- The specified custom endpoint can't be created because it already exists.DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.InvalidDbClusterStateException
- The requested operation can't be performed while the cluster is in this state.DbInstanceNotFoundException
-DBInstanceIdentifier
doesn't refer to an existing DB instance.InvalidDbInstanceStateException
- The DB instance isn't in a valid state.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
createDBClusterEndpoint
default CreateDbClusterEndpointResponse createDBClusterEndpoint(Consumer<CreateDbClusterEndpointRequest.Builder> createDbClusterEndpointRequest) throws DbClusterEndpointQuotaExceededException, DbClusterEndpointAlreadyExistsException, DbClusterNotFoundException, InvalidDbClusterStateException, DbInstanceNotFoundException, InvalidDbInstanceStateException, AwsServiceException, SdkClientException, RdsException
Creates a new custom endpoint and associates it with an Amazon Aurora DB cluster.
This action applies only to Aurora DB clusters.
This is a convenience which creates an instance of the
CreateDbClusterEndpointRequest.Builder
avoiding the need to create one manually viaCreateDbClusterEndpointRequest.builder()
- Parameters:
createDbClusterEndpointRequest
- AConsumer
that will call methods onCreateDbClusterEndpointRequest.Builder
to create a request.- Returns:
- Result of the CreateDBClusterEndpoint operation returned by the service.
- Throws:
DbClusterEndpointQuotaExceededException
- The cluster already has the maximum number of custom endpoints.DbClusterEndpointAlreadyExistsException
- The specified custom endpoint can't be created because it already exists.DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.InvalidDbClusterStateException
- The requested operation can't be performed while the cluster is in this state.DbInstanceNotFoundException
-DBInstanceIdentifier
doesn't refer to an existing DB instance.InvalidDbInstanceStateException
- The DB instance isn't in a valid state.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
createDBClusterParameterGroup
default CreateDbClusterParameterGroupResponse createDBClusterParameterGroup(CreateDbClusterParameterGroupRequest createDbClusterParameterGroupRequest) throws DbParameterGroupQuotaExceededException, DbParameterGroupAlreadyExistsException, AwsServiceException, SdkClientException, RdsException
Creates a new DB cluster parameter group.
Parameters in a DB cluster parameter group apply to all of the instances in a DB cluster.
A DB cluster parameter group is initially created with the default parameters for the database engine used by instances in the DB cluster. To provide custom values for any of the parameters, you must modify the group after creating it using
ModifyDBClusterParameterGroup
. Once you've created a DB cluster parameter group, you need to associate it with your DB cluster usingModifyDBCluster
.When you associate a new DB cluster parameter group with a running Aurora DB cluster, reboot the DB instances in the DB cluster without failover for the new DB cluster parameter group and associated settings to take effect.
When you associate a new DB cluster parameter group with a running Multi-AZ DB cluster, reboot the DB cluster without failover for the new DB cluster parameter group and associated settings to take effect.
After you create a DB cluster parameter group, you should wait at least 5 minutes before creating your first DB cluster that uses that DB cluster parameter group as the default parameter group. This allows Amazon RDS to fully complete the create action before the DB cluster parameter group is used as the default for a new DB cluster. This is especially important for parameters that are critical when creating the default database for a DB cluster, such as the character set for the default database defined by the
character_set_database
parameter. You can use the Parameter Groups option of the Amazon RDS console or theDescribeDBClusterParameters
operation to verify that your DB cluster parameter group has been created or modified.For more information on Amazon Aurora, see What is Amazon Aurora? in the Amazon Aurora User Guide.
For more information on Multi-AZ DB clusters, see Multi-AZ DB cluster deployments in the Amazon RDS User Guide.
- Parameters:
createDbClusterParameterGroupRequest
-- Returns:
- Result of the CreateDBClusterParameterGroup operation returned by the service.
- Throws:
DbParameterGroupQuotaExceededException
- The request would result in the user exceeding the allowed number of DB parameter groups.DbParameterGroupAlreadyExistsException
- A DB parameter group with the same name exists.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
createDBClusterParameterGroup
default CreateDbClusterParameterGroupResponse createDBClusterParameterGroup(Consumer<CreateDbClusterParameterGroupRequest.Builder> createDbClusterParameterGroupRequest) throws DbParameterGroupQuotaExceededException, DbParameterGroupAlreadyExistsException, AwsServiceException, SdkClientException, RdsException
Creates a new DB cluster parameter group.
Parameters in a DB cluster parameter group apply to all of the instances in a DB cluster.
A DB cluster parameter group is initially created with the default parameters for the database engine used by instances in the DB cluster. To provide custom values for any of the parameters, you must modify the group after creating it using
ModifyDBClusterParameterGroup
. Once you've created a DB cluster parameter group, you need to associate it with your DB cluster usingModifyDBCluster
.When you associate a new DB cluster parameter group with a running Aurora DB cluster, reboot the DB instances in the DB cluster without failover for the new DB cluster parameter group and associated settings to take effect.
When you associate a new DB cluster parameter group with a running Multi-AZ DB cluster, reboot the DB cluster without failover for the new DB cluster parameter group and associated settings to take effect.
After you create a DB cluster parameter group, you should wait at least 5 minutes before creating your first DB cluster that uses that DB cluster parameter group as the default parameter group. This allows Amazon RDS to fully complete the create action before the DB cluster parameter group is used as the default for a new DB cluster. This is especially important for parameters that are critical when creating the default database for a DB cluster, such as the character set for the default database defined by the
character_set_database
parameter. You can use the Parameter Groups option of the Amazon RDS console or theDescribeDBClusterParameters
operation to verify that your DB cluster parameter group has been created or modified.For more information on Amazon Aurora, see What is Amazon Aurora? in the Amazon Aurora User Guide.
For more information on Multi-AZ DB clusters, see Multi-AZ DB cluster deployments in the Amazon RDS User Guide.
This is a convenience which creates an instance of the
CreateDbClusterParameterGroupRequest.Builder
avoiding the need to create one manually viaCreateDbClusterParameterGroupRequest.builder()
- Parameters:
createDbClusterParameterGroupRequest
- AConsumer
that will call methods onCreateDbClusterParameterGroupRequest.Builder
to create a request.- Returns:
- Result of the CreateDBClusterParameterGroup operation returned by the service.
- Throws:
DbParameterGroupQuotaExceededException
- The request would result in the user exceeding the allowed number of DB parameter groups.DbParameterGroupAlreadyExistsException
- A DB parameter group with the same name exists.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
createDBClusterSnapshot
default CreateDbClusterSnapshotResponse createDBClusterSnapshot(CreateDbClusterSnapshotRequest createDbClusterSnapshotRequest) throws DbClusterSnapshotAlreadyExistsException, InvalidDbClusterStateException, DbClusterNotFoundException, SnapshotQuotaExceededException, InvalidDbClusterSnapshotStateException, AwsServiceException, SdkClientException, RdsException
Creates a snapshot of a DB cluster.
For more information on Amazon Aurora, see What is Amazon Aurora? in the Amazon Aurora User Guide.
For more information on Multi-AZ DB clusters, see Multi-AZ DB cluster deployments in the Amazon RDS User Guide.
- Parameters:
createDbClusterSnapshotRequest
-- Returns:
- Result of the CreateDBClusterSnapshot operation returned by the service.
- Throws:
DbClusterSnapshotAlreadyExistsException
- The user already has a DB cluster snapshot with the given identifier.InvalidDbClusterStateException
- The requested operation can't be performed while the cluster is in this state.DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.SnapshotQuotaExceededException
- The request would result in the user exceeding the allowed number of DB snapshots.InvalidDbClusterSnapshotStateException
- The supplied value isn't a valid DB cluster snapshot state.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
createDBClusterSnapshot
default CreateDbClusterSnapshotResponse createDBClusterSnapshot(Consumer<CreateDbClusterSnapshotRequest.Builder> createDbClusterSnapshotRequest) throws DbClusterSnapshotAlreadyExistsException, InvalidDbClusterStateException, DbClusterNotFoundException, SnapshotQuotaExceededException, InvalidDbClusterSnapshotStateException, AwsServiceException, SdkClientException, RdsException
Creates a snapshot of a DB cluster.
For more information on Amazon Aurora, see What is Amazon Aurora? in the Amazon Aurora User Guide.
For more information on Multi-AZ DB clusters, see Multi-AZ DB cluster deployments in the Amazon RDS User Guide.
This is a convenience which creates an instance of the
CreateDbClusterSnapshotRequest.Builder
avoiding the need to create one manually viaCreateDbClusterSnapshotRequest.builder()
- Parameters:
createDbClusterSnapshotRequest
- AConsumer
that will call methods onCreateDbClusterSnapshotRequest.Builder
to create a request.- Returns:
- Result of the CreateDBClusterSnapshot operation returned by the service.
- Throws:
DbClusterSnapshotAlreadyExistsException
- The user already has a DB cluster snapshot with the given identifier.InvalidDbClusterStateException
- The requested operation can't be performed while the cluster is in this state.DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.SnapshotQuotaExceededException
- The request would result in the user exceeding the allowed number of DB snapshots.InvalidDbClusterSnapshotStateException
- The supplied value isn't a valid DB cluster snapshot state.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
createDBInstance
default CreateDbInstanceResponse createDBInstance(CreateDbInstanceRequest createDbInstanceRequest) throws DbInstanceAlreadyExistsException, InsufficientDbInstanceCapacityException, DbParameterGroupNotFoundException, DbSecurityGroupNotFoundException, InstanceQuotaExceededException, StorageQuotaExceededException, DbSubnetGroupNotFoundException, DbSubnetGroupDoesNotCoverEnoughAZsException, InvalidDbClusterStateException, InvalidSubnetException, InvalidVpcNetworkStateException, ProvisionedIopsNotAvailableInAzException, OptionGroupNotFoundException, DbClusterNotFoundException, StorageTypeNotSupportedException, AuthorizationNotFoundException, KmsKeyNotAccessibleException, DomainNotFoundException, NetworkTypeNotSupportedException, CertificateNotFoundException, TenantDatabaseQuotaExceededException, AwsServiceException, SdkClientException, RdsException
Creates a new DB instance.
The new DB instance can be an RDS DB instance, or it can be a DB instance in an Aurora DB cluster. For an Aurora DB cluster, you can call this operation multiple times to add more than one DB instance to the cluster.
For more information about creating an RDS DB instance, see Creating an Amazon RDS DB instance in the Amazon RDS User Guide.
For more information about creating a DB instance in an Aurora DB cluster, see Creating an Amazon Aurora DB cluster in the Amazon Aurora User Guide.
- Parameters:
createDbInstanceRequest
-- Returns:
- Result of the CreateDBInstance operation returned by the service.
- Throws:
DbInstanceAlreadyExistsException
- The user already has a DB instance with the given identifier.InsufficientDbInstanceCapacityException
- The specified DB instance class isn't available in the specified Availability Zone.DbParameterGroupNotFoundException
-DBParameterGroupName
doesn't refer to an existing DB parameter group.DbSecurityGroupNotFoundException
-DBSecurityGroupName
doesn't refer to an existing DB security group.InstanceQuotaExceededException
- The request would result in the user exceeding the allowed number of DB instances.StorageQuotaExceededException
- The request would result in the user exceeding the allowed amount of storage available across all DB instances.DbSubnetGroupNotFoundException
-DBSubnetGroupName
doesn't refer to an existing DB subnet group.DbSubnetGroupDoesNotCoverEnoughAZsException
- Subnets in the DB subnet group should cover at least two Availability Zones unless there is only one Availability Zone.InvalidDbClusterStateException
- The requested operation can't be performed while the cluster is in this state.InvalidSubnetException
- The requested subnet is invalid, or multiple subnets were requested that are not all in a common VPC.InvalidVpcNetworkStateException
- The DB subnet group doesn't cover all Availability Zones after it's created because of users' change.ProvisionedIopsNotAvailableInAzException
- Provisioned IOPS not available in the specified Availability Zone.OptionGroupNotFoundException
- The specified option group could not be found.DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.StorageTypeNotSupportedException
- The specifiedStorageType
can't be associated with the DB instance.AuthorizationNotFoundException
- The specified CIDR IP range or Amazon EC2 security group might not be authorized for the specified DB security group.Or, RDS might not be authorized to perform necessary actions using IAM on your behalf.
KmsKeyNotAccessibleException
- An error occurred accessing an Amazon Web Services KMS key.DomainNotFoundException
-Domain
doesn't refer to an existing Active Directory domain.NetworkTypeNotSupportedException
- The network type is invalid for the DB instance. Valid nework type values areIPV4
andDUAL
.CertificateNotFoundException
-CertificateIdentifier
doesn't refer to an existing certificate.TenantDatabaseQuotaExceededException
- You attempted to create more tenant databases than are permitted in your Amazon Web Services account.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
createDBInstance
default CreateDbInstanceResponse createDBInstance(Consumer<CreateDbInstanceRequest.Builder> createDbInstanceRequest) throws DbInstanceAlreadyExistsException, InsufficientDbInstanceCapacityException, DbParameterGroupNotFoundException, DbSecurityGroupNotFoundException, InstanceQuotaExceededException, StorageQuotaExceededException, DbSubnetGroupNotFoundException, DbSubnetGroupDoesNotCoverEnoughAZsException, InvalidDbClusterStateException, InvalidSubnetException, InvalidVpcNetworkStateException, ProvisionedIopsNotAvailableInAzException, OptionGroupNotFoundException, DbClusterNotFoundException, StorageTypeNotSupportedException, AuthorizationNotFoundException, KmsKeyNotAccessibleException, DomainNotFoundException, NetworkTypeNotSupportedException, CertificateNotFoundException, TenantDatabaseQuotaExceededException, AwsServiceException, SdkClientException, RdsException
Creates a new DB instance.
The new DB instance can be an RDS DB instance, or it can be a DB instance in an Aurora DB cluster. For an Aurora DB cluster, you can call this operation multiple times to add more than one DB instance to the cluster.
For more information about creating an RDS DB instance, see Creating an Amazon RDS DB instance in the Amazon RDS User Guide.
For more information about creating a DB instance in an Aurora DB cluster, see Creating an Amazon Aurora DB cluster in the Amazon Aurora User Guide.
This is a convenience which creates an instance of the
CreateDbInstanceRequest.Builder
avoiding the need to create one manually viaCreateDbInstanceRequest.builder()
- Parameters:
createDbInstanceRequest
- AConsumer
that will call methods onCreateDbInstanceRequest.Builder
to create a request.- Returns:
- Result of the CreateDBInstance operation returned by the service.
- Throws:
DbInstanceAlreadyExistsException
- The user already has a DB instance with the given identifier.InsufficientDbInstanceCapacityException
- The specified DB instance class isn't available in the specified Availability Zone.DbParameterGroupNotFoundException
-DBParameterGroupName
doesn't refer to an existing DB parameter group.DbSecurityGroupNotFoundException
-DBSecurityGroupName
doesn't refer to an existing DB security group.InstanceQuotaExceededException
- The request would result in the user exceeding the allowed number of DB instances.StorageQuotaExceededException
- The request would result in the user exceeding the allowed amount of storage available across all DB instances.DbSubnetGroupNotFoundException
-DBSubnetGroupName
doesn't refer to an existing DB subnet group.DbSubnetGroupDoesNotCoverEnoughAZsException
- Subnets in the DB subnet group should cover at least two Availability Zones unless there is only one Availability Zone.InvalidDbClusterStateException
- The requested operation can't be performed while the cluster is in this state.InvalidSubnetException
- The requested subnet is invalid, or multiple subnets were requested that are not all in a common VPC.InvalidVpcNetworkStateException
- The DB subnet group doesn't cover all Availability Zones after it's created because of users' change.ProvisionedIopsNotAvailableInAzException
- Provisioned IOPS not available in the specified Availability Zone.OptionGroupNotFoundException
- The specified option group could not be found.DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.StorageTypeNotSupportedException
- The specifiedStorageType
can't be associated with the DB instance.AuthorizationNotFoundException
- The specified CIDR IP range or Amazon EC2 security group might not be authorized for the specified DB security group.Or, RDS might not be authorized to perform necessary actions using IAM on your behalf.
KmsKeyNotAccessibleException
- An error occurred accessing an Amazon Web Services KMS key.DomainNotFoundException
-Domain
doesn't refer to an existing Active Directory domain.NetworkTypeNotSupportedException
- The network type is invalid for the DB instance. Valid nework type values areIPV4
andDUAL
.CertificateNotFoundException
-CertificateIdentifier
doesn't refer to an existing certificate.TenantDatabaseQuotaExceededException
- You attempted to create more tenant databases than are permitted in your Amazon Web Services account.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
createDBInstanceReadReplica
default CreateDbInstanceReadReplicaResponse createDBInstanceReadReplica(CreateDbInstanceReadReplicaRequest createDbInstanceReadReplicaRequest) throws DbInstanceAlreadyExistsException, InsufficientDbInstanceCapacityException, DbParameterGroupNotFoundException, DbSecurityGroupNotFoundException, InstanceQuotaExceededException, StorageQuotaExceededException, DbInstanceNotFoundException, DbClusterNotFoundException, InvalidDbInstanceStateException, InvalidDbClusterStateException, DbSubnetGroupNotFoundException, DbSubnetGroupDoesNotCoverEnoughAZsException, InvalidSubnetException, InvalidVpcNetworkStateException, ProvisionedIopsNotAvailableInAzException, OptionGroupNotFoundException, DbSubnetGroupNotAllowedException, InvalidDbSubnetGroupException, StorageTypeNotSupportedException, KmsKeyNotAccessibleException, DomainNotFoundException, NetworkTypeNotSupportedException, TenantDatabaseQuotaExceededException, CertificateNotFoundException, AwsServiceException, SdkClientException, RdsException
Creates a new DB instance that acts as a read replica for an existing source DB instance or Multi-AZ DB cluster. You can create a read replica for a DB instance running Db2, MariaDB, MySQL, Oracle, PostgreSQL, or SQL Server. You can create a read replica for a Multi-AZ DB cluster running MySQL or PostgreSQL. For more information, see Working with read replicas and Migrating from a Multi-AZ DB cluster to a DB instance using a read replica in the Amazon RDS User Guide.
Amazon Aurora doesn't support this operation. To create a DB instance for an Aurora DB cluster, use the
CreateDBInstance
operation.All read replica DB instances are created with backups disabled. All other attributes (including DB security groups and DB parameter groups) are inherited from the source DB instance or cluster, except as specified.
Your source DB instance or cluster must have backup retention enabled.
- Parameters:
createDbInstanceReadReplicaRequest
-- Returns:
- Result of the CreateDBInstanceReadReplica operation returned by the service.
- Throws:
DbInstanceAlreadyExistsException
- The user already has a DB instance with the given identifier.InsufficientDbInstanceCapacityException
- The specified DB instance class isn't available in the specified Availability Zone.DbParameterGroupNotFoundException
-DBParameterGroupName
doesn't refer to an existing DB parameter group.DbSecurityGroupNotFoundException
-DBSecurityGroupName
doesn't refer to an existing DB security group.InstanceQuotaExceededException
- The request would result in the user exceeding the allowed number of DB instances.StorageQuotaExceededException
- The request would result in the user exceeding the allowed amount of storage available across all DB instances.DbInstanceNotFoundException
-DBInstanceIdentifier
doesn't refer to an existing DB instance.DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.InvalidDbInstanceStateException
- The DB instance isn't in a valid state.InvalidDbClusterStateException
- The requested operation can't be performed while the cluster is in this state.DbSubnetGroupNotFoundException
-DBSubnetGroupName
doesn't refer to an existing DB subnet group.DbSubnetGroupDoesNotCoverEnoughAZsException
- Subnets in the DB subnet group should cover at least two Availability Zones unless there is only one Availability Zone.InvalidSubnetException
- The requested subnet is invalid, or multiple subnets were requested that are not all in a common VPC.InvalidVpcNetworkStateException
- The DB subnet group doesn't cover all Availability Zones after it's created because of users' change.ProvisionedIopsNotAvailableInAzException
- Provisioned IOPS not available in the specified Availability Zone.OptionGroupNotFoundException
- The specified option group could not be found.DbSubnetGroupNotAllowedException
- The DBSubnetGroup shouldn't be specified while creating read replicas that lie in the same region as the source instance.InvalidDbSubnetGroupException
- The DBSubnetGroup doesn't belong to the same VPC as that of an existing cross-region read replica of the same source instance.StorageTypeNotSupportedException
- The specifiedStorageType
can't be associated with the DB instance.KmsKeyNotAccessibleException
- An error occurred accessing an Amazon Web Services KMS key.DomainNotFoundException
-Domain
doesn't refer to an existing Active Directory domain.NetworkTypeNotSupportedException
- The network type is invalid for the DB instance. Valid nework type values areIPV4
andDUAL
.TenantDatabaseQuotaExceededException
- You attempted to create more tenant databases than are permitted in your Amazon Web Services account.CertificateNotFoundException
-CertificateIdentifier
doesn't refer to an existing certificate.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
createDBInstanceReadReplica
default CreateDbInstanceReadReplicaResponse createDBInstanceReadReplica(Consumer<CreateDbInstanceReadReplicaRequest.Builder> createDbInstanceReadReplicaRequest) throws DbInstanceAlreadyExistsException, InsufficientDbInstanceCapacityException, DbParameterGroupNotFoundException, DbSecurityGroupNotFoundException, InstanceQuotaExceededException, StorageQuotaExceededException, DbInstanceNotFoundException, DbClusterNotFoundException, InvalidDbInstanceStateException, InvalidDbClusterStateException, DbSubnetGroupNotFoundException, DbSubnetGroupDoesNotCoverEnoughAZsException, InvalidSubnetException, InvalidVpcNetworkStateException, ProvisionedIopsNotAvailableInAzException, OptionGroupNotFoundException, DbSubnetGroupNotAllowedException, InvalidDbSubnetGroupException, StorageTypeNotSupportedException, KmsKeyNotAccessibleException, DomainNotFoundException, NetworkTypeNotSupportedException, TenantDatabaseQuotaExceededException, CertificateNotFoundException, AwsServiceException, SdkClientException, RdsException
Creates a new DB instance that acts as a read replica for an existing source DB instance or Multi-AZ DB cluster. You can create a read replica for a DB instance running Db2, MariaDB, MySQL, Oracle, PostgreSQL, or SQL Server. You can create a read replica for a Multi-AZ DB cluster running MySQL or PostgreSQL. For more information, see Working with read replicas and Migrating from a Multi-AZ DB cluster to a DB instance using a read replica in the Amazon RDS User Guide.
Amazon Aurora doesn't support this operation. To create a DB instance for an Aurora DB cluster, use the
CreateDBInstance
operation.All read replica DB instances are created with backups disabled. All other attributes (including DB security groups and DB parameter groups) are inherited from the source DB instance or cluster, except as specified.
Your source DB instance or cluster must have backup retention enabled.
This is a convenience which creates an instance of the
CreateDbInstanceReadReplicaRequest.Builder
avoiding the need to create one manually viaCreateDbInstanceReadReplicaRequest.builder()
- Parameters:
createDbInstanceReadReplicaRequest
- AConsumer
that will call methods onCreateDbInstanceReadReplicaRequest.Builder
to create a request.- Returns:
- Result of the CreateDBInstanceReadReplica operation returned by the service.
- Throws:
DbInstanceAlreadyExistsException
- The user already has a DB instance with the given identifier.InsufficientDbInstanceCapacityException
- The specified DB instance class isn't available in the specified Availability Zone.DbParameterGroupNotFoundException
-DBParameterGroupName
doesn't refer to an existing DB parameter group.DbSecurityGroupNotFoundException
-DBSecurityGroupName
doesn't refer to an existing DB security group.InstanceQuotaExceededException
- The request would result in the user exceeding the allowed number of DB instances.StorageQuotaExceededException
- The request would result in the user exceeding the allowed amount of storage available across all DB instances.DbInstanceNotFoundException
-DBInstanceIdentifier
doesn't refer to an existing DB instance.DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.InvalidDbInstanceStateException
- The DB instance isn't in a valid state.InvalidDbClusterStateException
- The requested operation can't be performed while the cluster is in this state.DbSubnetGroupNotFoundException
-DBSubnetGroupName
doesn't refer to an existing DB subnet group.DbSubnetGroupDoesNotCoverEnoughAZsException
- Subnets in the DB subnet group should cover at least two Availability Zones unless there is only one Availability Zone.InvalidSubnetException
- The requested subnet is invalid, or multiple subnets were requested that are not all in a common VPC.InvalidVpcNetworkStateException
- The DB subnet group doesn't cover all Availability Zones after it's created because of users' change.ProvisionedIopsNotAvailableInAzException
- Provisioned IOPS not available in the specified Availability Zone.OptionGroupNotFoundException
- The specified option group could not be found.DbSubnetGroupNotAllowedException
- The DBSubnetGroup shouldn't be specified while creating read replicas that lie in the same region as the source instance.InvalidDbSubnetGroupException
- The DBSubnetGroup doesn't belong to the same VPC as that of an existing cross-region read replica of the same source instance.StorageTypeNotSupportedException
- The specifiedStorageType
can't be associated with the DB instance.KmsKeyNotAccessibleException
- An error occurred accessing an Amazon Web Services KMS key.DomainNotFoundException
-Domain
doesn't refer to an existing Active Directory domain.NetworkTypeNotSupportedException
- The network type is invalid for the DB instance. Valid nework type values areIPV4
andDUAL
.TenantDatabaseQuotaExceededException
- You attempted to create more tenant databases than are permitted in your Amazon Web Services account.CertificateNotFoundException
-CertificateIdentifier
doesn't refer to an existing certificate.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
createDBParameterGroup
default CreateDbParameterGroupResponse createDBParameterGroup(CreateDbParameterGroupRequest createDbParameterGroupRequest) throws DbParameterGroupQuotaExceededException, DbParameterGroupAlreadyExistsException, AwsServiceException, SdkClientException, RdsException
Creates a new DB parameter group.
A DB parameter group is initially created with the default parameters for the database engine used by the DB instance. To provide custom values for any of the parameters, you must modify the group after creating it using
ModifyDBParameterGroup
. Once you've created a DB parameter group, you need to associate it with your DB instance usingModifyDBInstance
. When you associate a new DB parameter group with a running DB instance, you need to reboot the DB instance without failover for the new DB parameter group and associated settings to take effect.This command doesn't apply to RDS Custom.
After you create a DB parameter group, you should wait at least 5 minutes before creating your first DB instance that uses that DB parameter group as the default parameter group. This allows Amazon RDS to fully complete the create action before the parameter group is used as the default for a new DB instance. This is especially important for parameters that are critical when creating the default database for a DB instance, such as the character set for the default database defined by the
character_set_database
parameter. You can use the Parameter Groups option of the Amazon RDS console or the DescribeDBParameters command to verify that your DB parameter group has been created or modified.- Parameters:
createDbParameterGroupRequest
-- Returns:
- Result of the CreateDBParameterGroup operation returned by the service.
- Throws:
DbParameterGroupQuotaExceededException
- The request would result in the user exceeding the allowed number of DB parameter groups.DbParameterGroupAlreadyExistsException
- A DB parameter group with the same name exists.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
createDBParameterGroup
default CreateDbParameterGroupResponse createDBParameterGroup(Consumer<CreateDbParameterGroupRequest.Builder> createDbParameterGroupRequest) throws DbParameterGroupQuotaExceededException, DbParameterGroupAlreadyExistsException, AwsServiceException, SdkClientException, RdsException
Creates a new DB parameter group.
A DB parameter group is initially created with the default parameters for the database engine used by the DB instance. To provide custom values for any of the parameters, you must modify the group after creating it using
ModifyDBParameterGroup
. Once you've created a DB parameter group, you need to associate it with your DB instance usingModifyDBInstance
. When you associate a new DB parameter group with a running DB instance, you need to reboot the DB instance without failover for the new DB parameter group and associated settings to take effect.This command doesn't apply to RDS Custom.
After you create a DB parameter group, you should wait at least 5 minutes before creating your first DB instance that uses that DB parameter group as the default parameter group. This allows Amazon RDS to fully complete the create action before the parameter group is used as the default for a new DB instance. This is especially important for parameters that are critical when creating the default database for a DB instance, such as the character set for the default database defined by the
character_set_database
parameter. You can use the Parameter Groups option of the Amazon RDS console or the DescribeDBParameters command to verify that your DB parameter group has been created or modified.
This is a convenience which creates an instance of the
CreateDbParameterGroupRequest.Builder
avoiding the need to create one manually viaCreateDbParameterGroupRequest.builder()
- Parameters:
createDbParameterGroupRequest
- AConsumer
that will call methods onCreateDbParameterGroupRequest.Builder
to create a request.- Returns:
- Result of the CreateDBParameterGroup operation returned by the service.
- Throws:
DbParameterGroupQuotaExceededException
- The request would result in the user exceeding the allowed number of DB parameter groups.DbParameterGroupAlreadyExistsException
- A DB parameter group with the same name exists.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
createDBProxy
default CreateDbProxyResponse createDBProxy(CreateDbProxyRequest createDbProxyRequest) throws InvalidSubnetException, DbProxyAlreadyExistsException, DbProxyQuotaExceededException, AwsServiceException, SdkClientException, RdsException
Creates a new DB proxy.
- Parameters:
createDbProxyRequest
-- Returns:
- Result of the CreateDBProxy operation returned by the service.
- Throws:
InvalidSubnetException
- The requested subnet is invalid, or multiple subnets were requested that are not all in a common VPC.DbProxyAlreadyExistsException
- The specified proxy name must be unique for all proxies owned by your Amazon Web Services account in the specified Amazon Web Services Region.DbProxyQuotaExceededException
- Your Amazon Web Services account already has the maximum number of proxies in the specified Amazon Web Services Region.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
createDBProxy
default CreateDbProxyResponse createDBProxy(Consumer<CreateDbProxyRequest.Builder> createDbProxyRequest) throws InvalidSubnetException, DbProxyAlreadyExistsException, DbProxyQuotaExceededException, AwsServiceException, SdkClientException, RdsException
Creates a new DB proxy.
This is a convenience which creates an instance of the
CreateDbProxyRequest.Builder
avoiding the need to create one manually viaCreateDbProxyRequest.builder()
- Parameters:
createDbProxyRequest
- AConsumer
that will call methods onCreateDbProxyRequest.Builder
to create a request.- Returns:
- Result of the CreateDBProxy operation returned by the service.
- Throws:
InvalidSubnetException
- The requested subnet is invalid, or multiple subnets were requested that are not all in a common VPC.DbProxyAlreadyExistsException
- The specified proxy name must be unique for all proxies owned by your Amazon Web Services account in the specified Amazon Web Services Region.DbProxyQuotaExceededException
- Your Amazon Web Services account already has the maximum number of proxies in the specified Amazon Web Services Region.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
createDBProxyEndpoint
default CreateDbProxyEndpointResponse createDBProxyEndpoint(CreateDbProxyEndpointRequest createDbProxyEndpointRequest) throws InvalidSubnetException, DbProxyNotFoundException, DbProxyEndpointAlreadyExistsException, DbProxyEndpointQuotaExceededException, InvalidDbProxyStateException, AwsServiceException, SdkClientException, RdsException
Creates a
DBProxyEndpoint
. Only applies to proxies that are associated with Aurora DB clusters. You can use DB proxy endpoints to specify read/write or read-only access to the DB cluster. You can also use DB proxy endpoints to access a DB proxy through a different VPC than the proxy's default VPC.- Parameters:
createDbProxyEndpointRequest
-- Returns:
- Result of the CreateDBProxyEndpoint operation returned by the service.
- Throws:
InvalidSubnetException
- The requested subnet is invalid, or multiple subnets were requested that are not all in a common VPC.DbProxyNotFoundException
- The specified proxy name doesn't correspond to a proxy owned by your Amazon Web Services account in the specified Amazon Web Services Region.DbProxyEndpointAlreadyExistsException
- The specified DB proxy endpoint name must be unique for all DB proxy endpoints owned by your Amazon Web Services account in the specified Amazon Web Services Region.DbProxyEndpointQuotaExceededException
- The DB proxy already has the maximum number of endpoints.InvalidDbProxyStateException
- The requested operation can't be performed while the proxy is in this state.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
createDBProxyEndpoint
default CreateDbProxyEndpointResponse createDBProxyEndpoint(Consumer<CreateDbProxyEndpointRequest.Builder> createDbProxyEndpointRequest) throws InvalidSubnetException, DbProxyNotFoundException, DbProxyEndpointAlreadyExistsException, DbProxyEndpointQuotaExceededException, InvalidDbProxyStateException, AwsServiceException, SdkClientException, RdsException
Creates a
DBProxyEndpoint
. Only applies to proxies that are associated with Aurora DB clusters. You can use DB proxy endpoints to specify read/write or read-only access to the DB cluster. You can also use DB proxy endpoints to access a DB proxy through a different VPC than the proxy's default VPC.
This is a convenience which creates an instance of the
CreateDbProxyEndpointRequest.Builder
avoiding the need to create one manually viaCreateDbProxyEndpointRequest.builder()
- Parameters:
createDbProxyEndpointRequest
- AConsumer
that will call methods onCreateDbProxyEndpointRequest.Builder
to create a request.- Returns:
- Result of the CreateDBProxyEndpoint operation returned by the service.
- Throws:
InvalidSubnetException
- The requested subnet is invalid, or multiple subnets were requested that are not all in a common VPC.DbProxyNotFoundException
- The specified proxy name doesn't correspond to a proxy owned by your Amazon Web Services account in the specified Amazon Web Services Region.DbProxyEndpointAlreadyExistsException
- The specified DB proxy endpoint name must be unique for all DB proxy endpoints owned by your Amazon Web Services account in the specified Amazon Web Services Region.DbProxyEndpointQuotaExceededException
- The DB proxy already has the maximum number of endpoints.InvalidDbProxyStateException
- The requested operation can't be performed while the proxy is in this state.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
createDBSecurityGroup
default CreateDbSecurityGroupResponse createDBSecurityGroup(CreateDbSecurityGroupRequest createDbSecurityGroupRequest) throws DbSecurityGroupAlreadyExistsException, DbSecurityGroupQuotaExceededException, DbSecurityGroupNotSupportedException, AwsServiceException, SdkClientException, RdsException
Creates a new DB security group. DB security groups control access to a DB instance.
A DB security group controls access to EC2-Classic DB instances that are not in a VPC.
EC2-Classic was retired on August 15, 2022. If you haven't migrated from EC2-Classic to a VPC, we recommend that you migrate as soon as possible. For more information, see Migrate from EC2-Classic to a VPC in the Amazon EC2 User Guide, the blog EC2-Classic Networking is Retiring – Here’s How to Prepare, and Moving a DB instance not in a VPC into a VPC in the Amazon RDS User Guide.
- Parameters:
createDbSecurityGroupRequest
-- Returns:
- Result of the CreateDBSecurityGroup operation returned by the service.
- Throws:
DbSecurityGroupAlreadyExistsException
- A DB security group with the name specified inDBSecurityGroupName
already exists.DbSecurityGroupQuotaExceededException
- The request would result in the user exceeding the allowed number of DB security groups.DbSecurityGroupNotSupportedException
- A DB security group isn't allowed for this action.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
createDBSecurityGroup
default CreateDbSecurityGroupResponse createDBSecurityGroup(Consumer<CreateDbSecurityGroupRequest.Builder> createDbSecurityGroupRequest) throws DbSecurityGroupAlreadyExistsException, DbSecurityGroupQuotaExceededException, DbSecurityGroupNotSupportedException, AwsServiceException, SdkClientException, RdsException
Creates a new DB security group. DB security groups control access to a DB instance.
A DB security group controls access to EC2-Classic DB instances that are not in a VPC.
EC2-Classic was retired on August 15, 2022. If you haven't migrated from EC2-Classic to a VPC, we recommend that you migrate as soon as possible. For more information, see Migrate from EC2-Classic to a VPC in the Amazon EC2 User Guide, the blog EC2-Classic Networking is Retiring – Here’s How to Prepare, and Moving a DB instance not in a VPC into a VPC in the Amazon RDS User Guide.
This is a convenience which creates an instance of the
CreateDbSecurityGroupRequest.Builder
avoiding the need to create one manually viaCreateDbSecurityGroupRequest.builder()
- Parameters:
createDbSecurityGroupRequest
- AConsumer
that will call methods onCreateDbSecurityGroupRequest.Builder
to create a request.- Returns:
- Result of the CreateDBSecurityGroup operation returned by the service.
- Throws:
DbSecurityGroupAlreadyExistsException
- A DB security group with the name specified inDBSecurityGroupName
already exists.DbSecurityGroupQuotaExceededException
- The request would result in the user exceeding the allowed number of DB security groups.DbSecurityGroupNotSupportedException
- A DB security group isn't allowed for this action.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
createDBShardGroup
default CreateDbShardGroupResponse createDBShardGroup(CreateDbShardGroupRequest createDbShardGroupRequest) throws DbShardGroupAlreadyExistsException, DbClusterNotFoundException, MaxDbShardGroupLimitReachedException, InvalidDbClusterStateException, UnsupportedDbEngineVersionException, InvalidVpcNetworkStateException, NetworkTypeNotSupportedException, AwsServiceException, SdkClientException, RdsException
Creates a new DB shard group for Aurora Limitless Database. You must enable Aurora Limitless Database to create a DB shard group.
Valid for: Aurora DB clusters only
- Parameters:
createDbShardGroupRequest
-- Returns:
- Result of the CreateDBShardGroup operation returned by the service.
- Throws:
DbShardGroupAlreadyExistsException
- The specified DB shard group name must be unique in your Amazon Web Services account in the specified Amazon Web Services Region.DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.MaxDbShardGroupLimitReachedException
- The maximum number of DB shard groups for your Amazon Web Services account in the specified Amazon Web Services Region has been reached.InvalidDbClusterStateException
- The requested operation can't be performed while the cluster is in this state.UnsupportedDbEngineVersionException
- The specified DB engine version isn't supported for Aurora Limitless Database.InvalidVpcNetworkStateException
- The DB subnet group doesn't cover all Availability Zones after it's created because of users' change.NetworkTypeNotSupportedException
- The network type is invalid for the DB instance. Valid nework type values areIPV4
andDUAL
.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
createDBShardGroup
default CreateDbShardGroupResponse createDBShardGroup(Consumer<CreateDbShardGroupRequest.Builder> createDbShardGroupRequest) throws DbShardGroupAlreadyExistsException, DbClusterNotFoundException, MaxDbShardGroupLimitReachedException, InvalidDbClusterStateException, UnsupportedDbEngineVersionException, InvalidVpcNetworkStateException, NetworkTypeNotSupportedException, AwsServiceException, SdkClientException, RdsException
Creates a new DB shard group for Aurora Limitless Database. You must enable Aurora Limitless Database to create a DB shard group.
Valid for: Aurora DB clusters only
This is a convenience which creates an instance of the
CreateDbShardGroupRequest.Builder
avoiding the need to create one manually viaCreateDbShardGroupRequest.builder()
- Parameters:
createDbShardGroupRequest
- AConsumer
that will call methods onCreateDbShardGroupRequest.Builder
to create a request.- Returns:
- Result of the CreateDBShardGroup operation returned by the service.
- Throws:
DbShardGroupAlreadyExistsException
- The specified DB shard group name must be unique in your Amazon Web Services account in the specified Amazon Web Services Region.DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.MaxDbShardGroupLimitReachedException
- The maximum number of DB shard groups for your Amazon Web Services account in the specified Amazon Web Services Region has been reached.InvalidDbClusterStateException
- The requested operation can't be performed while the cluster is in this state.UnsupportedDbEngineVersionException
- The specified DB engine version isn't supported for Aurora Limitless Database.InvalidVpcNetworkStateException
- The DB subnet group doesn't cover all Availability Zones after it's created because of users' change.NetworkTypeNotSupportedException
- The network type is invalid for the DB instance. Valid nework type values areIPV4
andDUAL
.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
createDBSnapshot
default CreateDbSnapshotResponse createDBSnapshot(CreateDbSnapshotRequest createDbSnapshotRequest) throws DbSnapshotAlreadyExistsException, InvalidDbInstanceStateException, DbInstanceNotFoundException, SnapshotQuotaExceededException, AwsServiceException, SdkClientException, RdsException
Creates a snapshot of a DB instance. The source DB instance must be in the
available
orstorage-optimization
state.- Parameters:
createDbSnapshotRequest
-- Returns:
- Result of the CreateDBSnapshot operation returned by the service.
- Throws:
DbSnapshotAlreadyExistsException
-DBSnapshotIdentifier
is already used by an existing snapshot.InvalidDbInstanceStateException
- The DB instance isn't in a valid state.DbInstanceNotFoundException
-DBInstanceIdentifier
doesn't refer to an existing DB instance.SnapshotQuotaExceededException
- The request would result in the user exceeding the allowed number of DB snapshots.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
createDBSnapshot
default CreateDbSnapshotResponse createDBSnapshot(Consumer<CreateDbSnapshotRequest.Builder> createDbSnapshotRequest) throws DbSnapshotAlreadyExistsException, InvalidDbInstanceStateException, DbInstanceNotFoundException, SnapshotQuotaExceededException, AwsServiceException, SdkClientException, RdsException
Creates a snapshot of a DB instance. The source DB instance must be in the
available
orstorage-optimization
state.
This is a convenience which creates an instance of the
CreateDbSnapshotRequest.Builder
avoiding the need to create one manually viaCreateDbSnapshotRequest.builder()
- Parameters:
createDbSnapshotRequest
- AConsumer
that will call methods onCreateDbSnapshotRequest.Builder
to create a request.- Returns:
- Result of the CreateDBSnapshot operation returned by the service.
- Throws:
DbSnapshotAlreadyExistsException
-DBSnapshotIdentifier
is already used by an existing snapshot.InvalidDbInstanceStateException
- The DB instance isn't in a valid state.DbInstanceNotFoundException
-DBInstanceIdentifier
doesn't refer to an existing DB instance.SnapshotQuotaExceededException
- The request would result in the user exceeding the allowed number of DB snapshots.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
createDBSubnetGroup
default CreateDbSubnetGroupResponse createDBSubnetGroup(CreateDbSubnetGroupRequest createDbSubnetGroupRequest) throws DbSubnetGroupAlreadyExistsException, DbSubnetGroupQuotaExceededException, DbSubnetQuotaExceededException, DbSubnetGroupDoesNotCoverEnoughAZsException, InvalidSubnetException, AwsServiceException, SdkClientException, RdsException
Creates a new DB subnet group. DB subnet groups must contain at least one subnet in at least two AZs in the Amazon Web Services Region.
- Parameters:
createDbSubnetGroupRequest
-- Returns:
- Result of the CreateDBSubnetGroup operation returned by the service.
- Throws:
DbSubnetGroupAlreadyExistsException
-DBSubnetGroupName
is already used by an existing DB subnet group.DbSubnetGroupQuotaExceededException
- The request would result in the user exceeding the allowed number of DB subnet groups.DbSubnetQuotaExceededException
- The request would result in the user exceeding the allowed number of subnets in a DB subnet groups.DbSubnetGroupDoesNotCoverEnoughAZsException
- Subnets in the DB subnet group should cover at least two Availability Zones unless there is only one Availability Zone.InvalidSubnetException
- The requested subnet is invalid, or multiple subnets were requested that are not all in a common VPC.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
createDBSubnetGroup
default CreateDbSubnetGroupResponse createDBSubnetGroup(Consumer<CreateDbSubnetGroupRequest.Builder> createDbSubnetGroupRequest) throws DbSubnetGroupAlreadyExistsException, DbSubnetGroupQuotaExceededException, DbSubnetQuotaExceededException, DbSubnetGroupDoesNotCoverEnoughAZsException, InvalidSubnetException, AwsServiceException, SdkClientException, RdsException
Creates a new DB subnet group. DB subnet groups must contain at least one subnet in at least two AZs in the Amazon Web Services Region.
This is a convenience which creates an instance of the
CreateDbSubnetGroupRequest.Builder
avoiding the need to create one manually viaCreateDbSubnetGroupRequest.builder()
- Parameters:
createDbSubnetGroupRequest
- AConsumer
that will call methods onCreateDbSubnetGroupRequest.Builder
to create a request.- Returns:
- Result of the CreateDBSubnetGroup operation returned by the service.
- Throws:
DbSubnetGroupAlreadyExistsException
-DBSubnetGroupName
is already used by an existing DB subnet group.DbSubnetGroupQuotaExceededException
- The request would result in the user exceeding the allowed number of DB subnet groups.DbSubnetQuotaExceededException
- The request would result in the user exceeding the allowed number of subnets in a DB subnet groups.DbSubnetGroupDoesNotCoverEnoughAZsException
- Subnets in the DB subnet group should cover at least two Availability Zones unless there is only one Availability Zone.InvalidSubnetException
- The requested subnet is invalid, or multiple subnets were requested that are not all in a common VPC.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
createEventSubscription
default CreateEventSubscriptionResponse createEventSubscription(CreateEventSubscriptionRequest createEventSubscriptionRequest) throws EventSubscriptionQuotaExceededException, SubscriptionAlreadyExistException, SnsInvalidTopicException, SnsNoAuthorizationException, SnsTopicArnNotFoundException, SubscriptionCategoryNotFoundException, SourceNotFoundException, AwsServiceException, SdkClientException, RdsException
Creates an RDS event notification subscription. This operation requires a topic Amazon Resource Name (ARN) created by either the RDS console, the SNS console, or the SNS API. To obtain an ARN with SNS, you must create a topic in Amazon SNS and subscribe to the topic. The ARN is displayed in the SNS console.
You can specify the type of source (
SourceType
) that you want to be notified of and provide a list of RDS sources (SourceIds
) that triggers the events. You can also provide a list of event categories (EventCategories
) for events that you want to be notified of. For example, you can specifySourceType
=db-instance
,SourceIds
=mydbinstance1
,mydbinstance2
andEventCategories
=Availability
,Backup
.If you specify both the
SourceType
andSourceIds
, such asSourceType
=db-instance
andSourceIds
=myDBInstance1
, you are notified of all thedb-instance
events for the specified source. If you specify aSourceType
but do not specifySourceIds
, you receive notice of the events for that source type for all your RDS sources. If you don't specify either the SourceType or theSourceIds
, you are notified of events generated from all RDS sources belonging to your customer account.For more information about subscribing to an event for RDS DB engines, see Subscribing to Amazon RDS event notification in the Amazon RDS User Guide.
For more information about subscribing to an event for Aurora DB engines, see Subscribing to Amazon RDS event notification in the Amazon Aurora User Guide.
- Parameters:
createEventSubscriptionRequest
-- Returns:
- Result of the CreateEventSubscription operation returned by the service.
- Throws:
EventSubscriptionQuotaExceededException
- You have reached the maximum number of event subscriptions.SubscriptionAlreadyExistException
- The supplied subscription name already exists.SnsInvalidTopicException
- SNS has responded that there is a problem with the SNS topic specified.SnsNoAuthorizationException
- You do not have permission to publish to the SNS topic ARN.SnsTopicArnNotFoundException
- The SNS topic ARN does not exist.SubscriptionCategoryNotFoundException
- The supplied category does not exist.SourceNotFoundException
- The requested source could not be found.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
createEventSubscription
default CreateEventSubscriptionResponse createEventSubscription(Consumer<CreateEventSubscriptionRequest.Builder> createEventSubscriptionRequest) throws EventSubscriptionQuotaExceededException, SubscriptionAlreadyExistException, SnsInvalidTopicException, SnsNoAuthorizationException, SnsTopicArnNotFoundException, SubscriptionCategoryNotFoundException, SourceNotFoundException, AwsServiceException, SdkClientException, RdsException
Creates an RDS event notification subscription. This operation requires a topic Amazon Resource Name (ARN) created by either the RDS console, the SNS console, or the SNS API. To obtain an ARN with SNS, you must create a topic in Amazon SNS and subscribe to the topic. The ARN is displayed in the SNS console.
You can specify the type of source (
SourceType
) that you want to be notified of and provide a list of RDS sources (SourceIds
) that triggers the events. You can also provide a list of event categories (EventCategories
) for events that you want to be notified of. For example, you can specifySourceType
=db-instance
,SourceIds
=mydbinstance1
,mydbinstance2
andEventCategories
=Availability
,Backup
.If you specify both the
SourceType
andSourceIds
, such asSourceType
=db-instance
andSourceIds
=myDBInstance1
, you are notified of all thedb-instance
events for the specified source. If you specify aSourceType
but do not specifySourceIds
, you receive notice of the events for that source type for all your RDS sources. If you don't specify either the SourceType or theSourceIds
, you are notified of events generated from all RDS sources belonging to your customer account.For more information about subscribing to an event for RDS DB engines, see Subscribing to Amazon RDS event notification in the Amazon RDS User Guide.
For more information about subscribing to an event for Aurora DB engines, see Subscribing to Amazon RDS event notification in the Amazon Aurora User Guide.
This is a convenience which creates an instance of the
CreateEventSubscriptionRequest.Builder
avoiding the need to create one manually viaCreateEventSubscriptionRequest.builder()
- Parameters:
createEventSubscriptionRequest
- AConsumer
that will call methods onCreateEventSubscriptionRequest.Builder
to create a request.- Returns:
- Result of the CreateEventSubscription operation returned by the service.
- Throws:
EventSubscriptionQuotaExceededException
- You have reached the maximum number of event subscriptions.SubscriptionAlreadyExistException
- The supplied subscription name already exists.SnsInvalidTopicException
- SNS has responded that there is a problem with the SNS topic specified.SnsNoAuthorizationException
- You do not have permission to publish to the SNS topic ARN.SnsTopicArnNotFoundException
- The SNS topic ARN does not exist.SubscriptionCategoryNotFoundException
- The supplied category does not exist.SourceNotFoundException
- The requested source could not be found.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
createGlobalCluster
default CreateGlobalClusterResponse createGlobalCluster(CreateGlobalClusterRequest createGlobalClusterRequest) throws GlobalClusterAlreadyExistsException, GlobalClusterQuotaExceededException, InvalidDbClusterStateException, DbClusterNotFoundException, AwsServiceException, SdkClientException, RdsException
Creates an Aurora global database spread across multiple Amazon Web Services Regions. The global database contains a single primary cluster with read-write capability, and a read-only secondary cluster that receives data from the primary cluster through high-speed replication performed by the Aurora storage subsystem.
You can create a global database that is initially empty, and then create the primary and secondary DB clusters in the global database. Or you can specify an existing Aurora cluster during the create operation, and this cluster becomes the primary cluster of the global database.
This operation applies only to Aurora DB clusters.
- Parameters:
createGlobalClusterRequest
-- Returns:
- Result of the CreateGlobalCluster operation returned by the service.
- Throws:
GlobalClusterAlreadyExistsException
- TheGlobalClusterIdentifier
already exists. Specify a new global database identifier (unique name) to create a new global database cluster or to rename an existing one.GlobalClusterQuotaExceededException
- The number of global database clusters for this account is already at the maximum allowed.InvalidDbClusterStateException
- The requested operation can't be performed while the cluster is in this state.DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
createGlobalCluster
default CreateGlobalClusterResponse createGlobalCluster(Consumer<CreateGlobalClusterRequest.Builder> createGlobalClusterRequest) throws GlobalClusterAlreadyExistsException, GlobalClusterQuotaExceededException, InvalidDbClusterStateException, DbClusterNotFoundException, AwsServiceException, SdkClientException, RdsException
Creates an Aurora global database spread across multiple Amazon Web Services Regions. The global database contains a single primary cluster with read-write capability, and a read-only secondary cluster that receives data from the primary cluster through high-speed replication performed by the Aurora storage subsystem.
You can create a global database that is initially empty, and then create the primary and secondary DB clusters in the global database. Or you can specify an existing Aurora cluster during the create operation, and this cluster becomes the primary cluster of the global database.
This operation applies only to Aurora DB clusters.
This is a convenience which creates an instance of the
CreateGlobalClusterRequest.Builder
avoiding the need to create one manually viaCreateGlobalClusterRequest.builder()
- Parameters:
createGlobalClusterRequest
- AConsumer
that will call methods onCreateGlobalClusterRequest.Builder
to create a request.- Returns:
- Result of the CreateGlobalCluster operation returned by the service.
- Throws:
GlobalClusterAlreadyExistsException
- TheGlobalClusterIdentifier
already exists. Specify a new global database identifier (unique name) to create a new global database cluster or to rename an existing one.GlobalClusterQuotaExceededException
- The number of global database clusters for this account is already at the maximum allowed.InvalidDbClusterStateException
- The requested operation can't be performed while the cluster is in this state.DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
createIntegration
default CreateIntegrationResponse createIntegration(CreateIntegrationRequest createIntegrationRequest) throws DbClusterNotFoundException, DbInstanceNotFoundException, IntegrationAlreadyExistsException, IntegrationQuotaExceededException, KmsKeyNotAccessibleException, IntegrationConflictOperationException, AwsServiceException, SdkClientException, RdsException
Creates a zero-ETL integration with Amazon Redshift.
- Parameters:
createIntegrationRequest
-- Returns:
- Result of the CreateIntegration operation returned by the service.
- Throws:
DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.DbInstanceNotFoundException
-DBInstanceIdentifier
doesn't refer to an existing DB instance.IntegrationAlreadyExistsException
- The integration you are trying to create already exists.IntegrationQuotaExceededException
- You can't crate any more zero-ETL integrations because the quota has been reached.KmsKeyNotAccessibleException
- An error occurred accessing an Amazon Web Services KMS key.IntegrationConflictOperationException
- A conflicting conditional operation is currently in progress against this resource. Typically occurs when there are multiple requests being made to the same resource at the same time, and these requests conflict with each other.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
createIntegration
default CreateIntegrationResponse createIntegration(Consumer<CreateIntegrationRequest.Builder> createIntegrationRequest) throws DbClusterNotFoundException, DbInstanceNotFoundException, IntegrationAlreadyExistsException, IntegrationQuotaExceededException, KmsKeyNotAccessibleException, IntegrationConflictOperationException, AwsServiceException, SdkClientException, RdsException
Creates a zero-ETL integration with Amazon Redshift.
This is a convenience which creates an instance of the
CreateIntegrationRequest.Builder
avoiding the need to create one manually viaCreateIntegrationRequest.builder()
- Parameters:
createIntegrationRequest
- AConsumer
that will call methods onCreateIntegrationRequest.Builder
to create a request.- Returns:
- Result of the CreateIntegration operation returned by the service.
- Throws:
DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.DbInstanceNotFoundException
-DBInstanceIdentifier
doesn't refer to an existing DB instance.IntegrationAlreadyExistsException
- The integration you are trying to create already exists.IntegrationQuotaExceededException
- You can't crate any more zero-ETL integrations because the quota has been reached.KmsKeyNotAccessibleException
- An error occurred accessing an Amazon Web Services KMS key.IntegrationConflictOperationException
- A conflicting conditional operation is currently in progress against this resource. Typically occurs when there are multiple requests being made to the same resource at the same time, and these requests conflict with each other.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
createOptionGroup
default CreateOptionGroupResponse createOptionGroup(CreateOptionGroupRequest createOptionGroupRequest) throws OptionGroupAlreadyExistsException, OptionGroupQuotaExceededException, AwsServiceException, SdkClientException, RdsException
Creates a new option group. You can create up to 20 option groups.
This command doesn't apply to RDS Custom.
- Parameters:
createOptionGroupRequest
-- Returns:
- Result of the CreateOptionGroup operation returned by the service.
- Throws:
OptionGroupAlreadyExistsException
- The option group you are trying to create already exists.OptionGroupQuotaExceededException
- The quota of 20 option groups was exceeded for this Amazon Web Services account.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
createOptionGroup
default CreateOptionGroupResponse createOptionGroup(Consumer<CreateOptionGroupRequest.Builder> createOptionGroupRequest) throws OptionGroupAlreadyExistsException, OptionGroupQuotaExceededException, AwsServiceException, SdkClientException, RdsException
Creates a new option group. You can create up to 20 option groups.
This command doesn't apply to RDS Custom.
This is a convenience which creates an instance of the
CreateOptionGroupRequest.Builder
avoiding the need to create one manually viaCreateOptionGroupRequest.builder()
- Parameters:
createOptionGroupRequest
- AConsumer
that will call methods onCreateOptionGroupRequest.Builder
to create a request.- Returns:
- Result of the CreateOptionGroup operation returned by the service.
- Throws:
OptionGroupAlreadyExistsException
- The option group you are trying to create already exists.OptionGroupQuotaExceededException
- The quota of 20 option groups was exceeded for this Amazon Web Services account.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
createTenantDatabase
default CreateTenantDatabaseResponse createTenantDatabase(CreateTenantDatabaseRequest createTenantDatabaseRequest) throws DbInstanceNotFoundException, InvalidDbInstanceStateException, TenantDatabaseAlreadyExistsException, TenantDatabaseQuotaExceededException, AwsServiceException, SdkClientException, RdsException
Creates a tenant database in a DB instance that uses the multi-tenant configuration. Only RDS for Oracle container database (CDB) instances are supported.
- Parameters:
createTenantDatabaseRequest
-- Returns:
- Result of the CreateTenantDatabase operation returned by the service.
- Throws:
DbInstanceNotFoundException
-DBInstanceIdentifier
doesn't refer to an existing DB instance.InvalidDbInstanceStateException
- The DB instance isn't in a valid state.TenantDatabaseAlreadyExistsException
- You attempted to either create a tenant database that already exists or modify a tenant database to use the name of an existing tenant database.TenantDatabaseQuotaExceededException
- You attempted to create more tenant databases than are permitted in your Amazon Web Services account.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
createTenantDatabase
default CreateTenantDatabaseResponse createTenantDatabase(Consumer<CreateTenantDatabaseRequest.Builder> createTenantDatabaseRequest) throws DbInstanceNotFoundException, InvalidDbInstanceStateException, TenantDatabaseAlreadyExistsException, TenantDatabaseQuotaExceededException, AwsServiceException, SdkClientException, RdsException
Creates a tenant database in a DB instance that uses the multi-tenant configuration. Only RDS for Oracle container database (CDB) instances are supported.
This is a convenience which creates an instance of the
CreateTenantDatabaseRequest.Builder
avoiding the need to create one manually viaCreateTenantDatabaseRequest.builder()
- Parameters:
createTenantDatabaseRequest
- AConsumer
that will call methods onCreateTenantDatabaseRequest.Builder
to create a request.- Returns:
- Result of the CreateTenantDatabase operation returned by the service.
- Throws:
DbInstanceNotFoundException
-DBInstanceIdentifier
doesn't refer to an existing DB instance.InvalidDbInstanceStateException
- The DB instance isn't in a valid state.TenantDatabaseAlreadyExistsException
- You attempted to either create a tenant database that already exists or modify a tenant database to use the name of an existing tenant database.TenantDatabaseQuotaExceededException
- You attempted to create more tenant databases than are permitted in your Amazon Web Services account.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
deleteBlueGreenDeployment
default DeleteBlueGreenDeploymentResponse deleteBlueGreenDeployment(DeleteBlueGreenDeploymentRequest deleteBlueGreenDeploymentRequest) throws BlueGreenDeploymentNotFoundException, InvalidBlueGreenDeploymentStateException, AwsServiceException, SdkClientException, RdsException
Deletes a blue/green deployment.
For more information, see Using Amazon RDS Blue/Green Deployments for database updates in the Amazon RDS User Guide and Using Amazon RDS Blue/Green Deployments for database updates in the Amazon Aurora User Guide.
- Parameters:
deleteBlueGreenDeploymentRequest
-- Returns:
- Result of the DeleteBlueGreenDeployment operation returned by the service.
- Throws:
BlueGreenDeploymentNotFoundException
-BlueGreenDeploymentIdentifier
doesn't refer to an existing blue/green deployment.InvalidBlueGreenDeploymentStateException
- The blue/green deployment can't be switched over or deleted because there is an invalid configuration in the green environment.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
deleteBlueGreenDeployment
default DeleteBlueGreenDeploymentResponse deleteBlueGreenDeployment(Consumer<DeleteBlueGreenDeploymentRequest.Builder> deleteBlueGreenDeploymentRequest) throws BlueGreenDeploymentNotFoundException, InvalidBlueGreenDeploymentStateException, AwsServiceException, SdkClientException, RdsException
Deletes a blue/green deployment.
For more information, see Using Amazon RDS Blue/Green Deployments for database updates in the Amazon RDS User Guide and Using Amazon RDS Blue/Green Deployments for database updates in the Amazon Aurora User Guide.
This is a convenience which creates an instance of the
DeleteBlueGreenDeploymentRequest.Builder
avoiding the need to create one manually viaDeleteBlueGreenDeploymentRequest.builder()
- Parameters:
deleteBlueGreenDeploymentRequest
- AConsumer
that will call methods onDeleteBlueGreenDeploymentRequest.Builder
to create a request.- Returns:
- Result of the DeleteBlueGreenDeployment operation returned by the service.
- Throws:
BlueGreenDeploymentNotFoundException
-BlueGreenDeploymentIdentifier
doesn't refer to an existing blue/green deployment.InvalidBlueGreenDeploymentStateException
- The blue/green deployment can't be switched over or deleted because there is an invalid configuration in the green environment.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
deleteCustomDBEngineVersion
default DeleteCustomDbEngineVersionResponse deleteCustomDBEngineVersion(DeleteCustomDbEngineVersionRequest deleteCustomDbEngineVersionRequest) throws CustomDbEngineVersionNotFoundException, InvalidCustomDbEngineVersionStateException, AwsServiceException, SdkClientException, RdsException
Deletes a custom engine version. To run this command, make sure you meet the following prerequisites:
-
The CEV must not be the default for RDS Custom. If it is, change the default before running this command.
-
The CEV must not be associated with an RDS Custom DB instance, RDS Custom instance snapshot, or automated backup of your RDS Custom instance.
Typically, deletion takes a few minutes.
The MediaImport service that imports files from Amazon S3 to create CEVs isn't integrated with Amazon Web Services CloudTrail. If you turn on data logging for Amazon RDS in CloudTrail, calls to the
DeleteCustomDbEngineVersion
event aren't logged. However, you might see calls from the API gateway that accesses your Amazon S3 bucket. These calls originate from the MediaImport service for theDeleteCustomDbEngineVersion
event.For more information, see Deleting a CEV in the Amazon RDS User Guide.
- Parameters:
deleteCustomDbEngineVersionRequest
-- Returns:
- Result of the DeleteCustomDBEngineVersion operation returned by the service.
- Throws:
CustomDbEngineVersionNotFoundException
- The specified CEV was not found.InvalidCustomDbEngineVersionStateException
- You can't delete the CEV.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
-
deleteCustomDBEngineVersion
default DeleteCustomDbEngineVersionResponse deleteCustomDBEngineVersion(Consumer<DeleteCustomDbEngineVersionRequest.Builder> deleteCustomDbEngineVersionRequest) throws CustomDbEngineVersionNotFoundException, InvalidCustomDbEngineVersionStateException, AwsServiceException, SdkClientException, RdsException
Deletes a custom engine version. To run this command, make sure you meet the following prerequisites:
-
The CEV must not be the default for RDS Custom. If it is, change the default before running this command.
-
The CEV must not be associated with an RDS Custom DB instance, RDS Custom instance snapshot, or automated backup of your RDS Custom instance.
Typically, deletion takes a few minutes.
The MediaImport service that imports files from Amazon S3 to create CEVs isn't integrated with Amazon Web Services CloudTrail. If you turn on data logging for Amazon RDS in CloudTrail, calls to the
DeleteCustomDbEngineVersion
event aren't logged. However, you might see calls from the API gateway that accesses your Amazon S3 bucket. These calls originate from the MediaImport service for theDeleteCustomDbEngineVersion
event.For more information, see Deleting a CEV in the Amazon RDS User Guide.
This is a convenience which creates an instance of the
DeleteCustomDbEngineVersionRequest.Builder
avoiding the need to create one manually viaDeleteCustomDbEngineVersionRequest.builder()
- Parameters:
deleteCustomDbEngineVersionRequest
- AConsumer
that will call methods onDeleteCustomDbEngineVersionRequest.Builder
to create a request.- Returns:
- Result of the DeleteCustomDBEngineVersion operation returned by the service.
- Throws:
CustomDbEngineVersionNotFoundException
- The specified CEV was not found.InvalidCustomDbEngineVersionStateException
- You can't delete the CEV.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
-
deleteDBCluster
default DeleteDbClusterResponse deleteDBCluster(DeleteDbClusterRequest deleteDbClusterRequest) throws DbClusterNotFoundException, InvalidDbClusterStateException, DbClusterSnapshotAlreadyExistsException, SnapshotQuotaExceededException, InvalidDbClusterSnapshotStateException, DbClusterAutomatedBackupQuotaExceededException, AwsServiceException, SdkClientException, RdsException
The DeleteDBCluster action deletes a previously provisioned DB cluster. When you delete a DB cluster, all automated backups for that DB cluster are deleted and can't be recovered. Manual DB cluster snapshots of the specified DB cluster are not deleted.
If you're deleting a Multi-AZ DB cluster with read replicas, all cluster members are terminated and read replicas are promoted to standalone instances.
For more information on Amazon Aurora, see What is Amazon Aurora? in the Amazon Aurora User Guide.
For more information on Multi-AZ DB clusters, see Multi-AZ DB cluster deployments in the Amazon RDS User Guide.
- Parameters:
deleteDbClusterRequest
-- Returns:
- Result of the DeleteDBCluster operation returned by the service.
- Throws:
DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.InvalidDbClusterStateException
- The requested operation can't be performed while the cluster is in this state.DbClusterSnapshotAlreadyExistsException
- The user already has a DB cluster snapshot with the given identifier.SnapshotQuotaExceededException
- The request would result in the user exceeding the allowed number of DB snapshots.InvalidDbClusterSnapshotStateException
- The supplied value isn't a valid DB cluster snapshot state.DbClusterAutomatedBackupQuotaExceededException
- The quota for retained automated backups was exceeded. This prevents you from retaining any additional automated backups. The retained automated backups quota is the same as your DB cluster quota.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
deleteDBCluster
default DeleteDbClusterResponse deleteDBCluster(Consumer<DeleteDbClusterRequest.Builder> deleteDbClusterRequest) throws DbClusterNotFoundException, InvalidDbClusterStateException, DbClusterSnapshotAlreadyExistsException, SnapshotQuotaExceededException, InvalidDbClusterSnapshotStateException, DbClusterAutomatedBackupQuotaExceededException, AwsServiceException, SdkClientException, RdsException
The DeleteDBCluster action deletes a previously provisioned DB cluster. When you delete a DB cluster, all automated backups for that DB cluster are deleted and can't be recovered. Manual DB cluster snapshots of the specified DB cluster are not deleted.
If you're deleting a Multi-AZ DB cluster with read replicas, all cluster members are terminated and read replicas are promoted to standalone instances.
For more information on Amazon Aurora, see What is Amazon Aurora? in the Amazon Aurora User Guide.
For more information on Multi-AZ DB clusters, see Multi-AZ DB cluster deployments in the Amazon RDS User Guide.
This is a convenience which creates an instance of the
DeleteDbClusterRequest.Builder
avoiding the need to create one manually viaDeleteDbClusterRequest.builder()
- Parameters:
deleteDbClusterRequest
- AConsumer
that will call methods onDeleteDbClusterRequest.Builder
to create a request.- Returns:
- Result of the DeleteDBCluster operation returned by the service.
- Throws:
DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.InvalidDbClusterStateException
- The requested operation can't be performed while the cluster is in this state.DbClusterSnapshotAlreadyExistsException
- The user already has a DB cluster snapshot with the given identifier.SnapshotQuotaExceededException
- The request would result in the user exceeding the allowed number of DB snapshots.InvalidDbClusterSnapshotStateException
- The supplied value isn't a valid DB cluster snapshot state.DbClusterAutomatedBackupQuotaExceededException
- The quota for retained automated backups was exceeded. This prevents you from retaining any additional automated backups. The retained automated backups quota is the same as your DB cluster quota.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
deleteDBClusterAutomatedBackup
default DeleteDbClusterAutomatedBackupResponse deleteDBClusterAutomatedBackup(DeleteDbClusterAutomatedBackupRequest deleteDbClusterAutomatedBackupRequest) throws InvalidDbClusterAutomatedBackupStateException, DbClusterAutomatedBackupNotFoundException, AwsServiceException, SdkClientException, RdsException
Deletes automated backups using the
DbClusterResourceId
value of the source DB cluster or the Amazon Resource Name (ARN) of the automated backups.- Parameters:
deleteDbClusterAutomatedBackupRequest
-- Returns:
- Result of the DeleteDBClusterAutomatedBackup operation returned by the service.
- Throws:
InvalidDbClusterAutomatedBackupStateException
- The automated backup is in an invalid state. For example, this automated backup is associated with an active cluster.DbClusterAutomatedBackupNotFoundException
- No automated backup for this DB cluster was found.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
deleteDBClusterAutomatedBackup
default DeleteDbClusterAutomatedBackupResponse deleteDBClusterAutomatedBackup(Consumer<DeleteDbClusterAutomatedBackupRequest.Builder> deleteDbClusterAutomatedBackupRequest) throws InvalidDbClusterAutomatedBackupStateException, DbClusterAutomatedBackupNotFoundException, AwsServiceException, SdkClientException, RdsException
Deletes automated backups using the
DbClusterResourceId
value of the source DB cluster or the Amazon Resource Name (ARN) of the automated backups.
This is a convenience which creates an instance of the
DeleteDbClusterAutomatedBackupRequest.Builder
avoiding the need to create one manually viaDeleteDbClusterAutomatedBackupRequest.builder()
- Parameters:
deleteDbClusterAutomatedBackupRequest
- AConsumer
that will call methods onDeleteDbClusterAutomatedBackupRequest.Builder
to create a request.- Returns:
- Result of the DeleteDBClusterAutomatedBackup operation returned by the service.
- Throws:
InvalidDbClusterAutomatedBackupStateException
- The automated backup is in an invalid state. For example, this automated backup is associated with an active cluster.DbClusterAutomatedBackupNotFoundException
- No automated backup for this DB cluster was found.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
deleteDBClusterEndpoint
default DeleteDbClusterEndpointResponse deleteDBClusterEndpoint(DeleteDbClusterEndpointRequest deleteDbClusterEndpointRequest) throws InvalidDbClusterEndpointStateException, DbClusterEndpointNotFoundException, InvalidDbClusterStateException, AwsServiceException, SdkClientException, RdsException
Deletes a custom endpoint and removes it from an Amazon Aurora DB cluster.
This action only applies to Aurora DB clusters.
- Parameters:
deleteDbClusterEndpointRequest
-- Returns:
- Result of the DeleteDBClusterEndpoint operation returned by the service.
- Throws:
InvalidDbClusterEndpointStateException
- The requested operation can't be performed on the endpoint while the endpoint is in this state.DbClusterEndpointNotFoundException
- The specified custom endpoint doesn't exist.InvalidDbClusterStateException
- The requested operation can't be performed while the cluster is in this state.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
deleteDBClusterEndpoint
default DeleteDbClusterEndpointResponse deleteDBClusterEndpoint(Consumer<DeleteDbClusterEndpointRequest.Builder> deleteDbClusterEndpointRequest) throws InvalidDbClusterEndpointStateException, DbClusterEndpointNotFoundException, InvalidDbClusterStateException, AwsServiceException, SdkClientException, RdsException
Deletes a custom endpoint and removes it from an Amazon Aurora DB cluster.
This action only applies to Aurora DB clusters.
This is a convenience which creates an instance of the
DeleteDbClusterEndpointRequest.Builder
avoiding the need to create one manually viaDeleteDbClusterEndpointRequest.builder()
- Parameters:
deleteDbClusterEndpointRequest
- AConsumer
that will call methods onDeleteDbClusterEndpointRequest.Builder
to create a request.- Returns:
- Result of the DeleteDBClusterEndpoint operation returned by the service.
- Throws:
InvalidDbClusterEndpointStateException
- The requested operation can't be performed on the endpoint while the endpoint is in this state.DbClusterEndpointNotFoundException
- The specified custom endpoint doesn't exist.InvalidDbClusterStateException
- The requested operation can't be performed while the cluster is in this state.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
deleteDBClusterParameterGroup
default DeleteDbClusterParameterGroupResponse deleteDBClusterParameterGroup(DeleteDbClusterParameterGroupRequest deleteDbClusterParameterGroupRequest) throws InvalidDbParameterGroupStateException, DbParameterGroupNotFoundException, AwsServiceException, SdkClientException, RdsException
Deletes a specified DB cluster parameter group. The DB cluster parameter group to be deleted can't be associated with any DB clusters.
For more information on Amazon Aurora, see What is Amazon Aurora? in the Amazon Aurora User Guide.
For more information on Multi-AZ DB clusters, see Multi-AZ DB cluster deployments in the Amazon RDS User Guide.
- Parameters:
deleteDbClusterParameterGroupRequest
-- Returns:
- Result of the DeleteDBClusterParameterGroup operation returned by the service.
- Throws:
InvalidDbParameterGroupStateException
- The DB parameter group is in use or is in an invalid state. If you are attempting to delete the parameter group, you can't delete it when the parameter group is in this state.DbParameterGroupNotFoundException
-DBParameterGroupName
doesn't refer to an existing DB parameter group.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
deleteDBClusterParameterGroup
default DeleteDbClusterParameterGroupResponse deleteDBClusterParameterGroup(Consumer<DeleteDbClusterParameterGroupRequest.Builder> deleteDbClusterParameterGroupRequest) throws InvalidDbParameterGroupStateException, DbParameterGroupNotFoundException, AwsServiceException, SdkClientException, RdsException
Deletes a specified DB cluster parameter group. The DB cluster parameter group to be deleted can't be associated with any DB clusters.
For more information on Amazon Aurora, see What is Amazon Aurora? in the Amazon Aurora User Guide.
For more information on Multi-AZ DB clusters, see Multi-AZ DB cluster deployments in the Amazon RDS User Guide.
This is a convenience which creates an instance of the
DeleteDbClusterParameterGroupRequest.Builder
avoiding the need to create one manually viaDeleteDbClusterParameterGroupRequest.builder()
- Parameters:
deleteDbClusterParameterGroupRequest
- AConsumer
that will call methods onDeleteDbClusterParameterGroupRequest.Builder
to create a request.- Returns:
- Result of the DeleteDBClusterParameterGroup operation returned by the service.
- Throws:
InvalidDbParameterGroupStateException
- The DB parameter group is in use or is in an invalid state. If you are attempting to delete the parameter group, you can't delete it when the parameter group is in this state.DbParameterGroupNotFoundException
-DBParameterGroupName
doesn't refer to an existing DB parameter group.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
deleteDBClusterSnapshot
default DeleteDbClusterSnapshotResponse deleteDBClusterSnapshot(DeleteDbClusterSnapshotRequest deleteDbClusterSnapshotRequest) throws InvalidDbClusterSnapshotStateException, DbClusterSnapshotNotFoundException, AwsServiceException, SdkClientException, RdsException
Deletes a DB cluster snapshot. If the snapshot is being copied, the copy operation is terminated.
The DB cluster snapshot must be in the
available
state to be deleted.For more information on Amazon Aurora, see What is Amazon Aurora? in the Amazon Aurora User Guide.
For more information on Multi-AZ DB clusters, see Multi-AZ DB cluster deployments in the Amazon RDS User Guide.
- Parameters:
deleteDbClusterSnapshotRequest
-- Returns:
- Result of the DeleteDBClusterSnapshot operation returned by the service.
- Throws:
InvalidDbClusterSnapshotStateException
- The supplied value isn't a valid DB cluster snapshot state.DbClusterSnapshotNotFoundException
-DBClusterSnapshotIdentifier
doesn't refer to an existing DB cluster snapshot.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
deleteDBClusterSnapshot
default DeleteDbClusterSnapshotResponse deleteDBClusterSnapshot(Consumer<DeleteDbClusterSnapshotRequest.Builder> deleteDbClusterSnapshotRequest) throws InvalidDbClusterSnapshotStateException, DbClusterSnapshotNotFoundException, AwsServiceException, SdkClientException, RdsException
Deletes a DB cluster snapshot. If the snapshot is being copied, the copy operation is terminated.
The DB cluster snapshot must be in the
available
state to be deleted.For more information on Amazon Aurora, see What is Amazon Aurora? in the Amazon Aurora User Guide.
For more information on Multi-AZ DB clusters, see Multi-AZ DB cluster deployments in the Amazon RDS User Guide.
This is a convenience which creates an instance of the
DeleteDbClusterSnapshotRequest.Builder
avoiding the need to create one manually viaDeleteDbClusterSnapshotRequest.builder()
- Parameters:
deleteDbClusterSnapshotRequest
- AConsumer
that will call methods onDeleteDbClusterSnapshotRequest.Builder
to create a request.- Returns:
- Result of the DeleteDBClusterSnapshot operation returned by the service.
- Throws:
InvalidDbClusterSnapshotStateException
- The supplied value isn't a valid DB cluster snapshot state.DbClusterSnapshotNotFoundException
-DBClusterSnapshotIdentifier
doesn't refer to an existing DB cluster snapshot.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
deleteDBInstance
default DeleteDbInstanceResponse deleteDBInstance(DeleteDbInstanceRequest deleteDbInstanceRequest) throws DbInstanceNotFoundException, InvalidDbInstanceStateException, DbSnapshotAlreadyExistsException, SnapshotQuotaExceededException, InvalidDbClusterStateException, DbInstanceAutomatedBackupQuotaExceededException, AwsServiceException, SdkClientException, RdsException
Deletes a previously provisioned DB instance. When you delete a DB instance, all automated backups for that instance are deleted and can't be recovered. However, manual DB snapshots of the DB instance aren't deleted.
If you request a final DB snapshot, the status of the Amazon RDS DB instance is
deleting
until the DB snapshot is created. This operation can't be canceled or reverted after it begins. To monitor the status of this operation, useDescribeDBInstance
.When a DB instance is in a failure state and has a status of
failed
,incompatible-restore
, orincompatible-network
, you can only delete it when you skip creation of the final snapshot with theSkipFinalSnapshot
parameter.If the specified DB instance is part of an Amazon Aurora DB cluster, you can't delete the DB instance if both of the following conditions are true:
-
The DB cluster is a read replica of another Amazon Aurora DB cluster.
-
The DB instance is the only instance in the DB cluster.
To delete a DB instance in this case, first use the
PromoteReadReplicaDBCluster
operation to promote the DB cluster so that it's no longer a read replica. After the promotion completes, use theDeleteDBInstance
operation to delete the final instance in the DB cluster.For RDS Custom DB instances, deleting the DB instance permanently deletes the EC2 instance and the associated EBS volumes. Make sure that you don't terminate or delete these resources before you delete the DB instance. Otherwise, deleting the DB instance and creation of the final snapshot might fail.
- Parameters:
deleteDbInstanceRequest
-- Returns:
- Result of the DeleteDBInstance operation returned by the service.
- Throws:
DbInstanceNotFoundException
-DBInstanceIdentifier
doesn't refer to an existing DB instance.InvalidDbInstanceStateException
- The DB instance isn't in a valid state.DbSnapshotAlreadyExistsException
-DBSnapshotIdentifier
is already used by an existing snapshot.SnapshotQuotaExceededException
- The request would result in the user exceeding the allowed number of DB snapshots.InvalidDbClusterStateException
- The requested operation can't be performed while the cluster is in this state.DbInstanceAutomatedBackupQuotaExceededException
- The quota for retained automated backups was exceeded. This prevents you from retaining any additional automated backups. The retained automated backups quota is the same as your DB instance quota.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
-
deleteDBInstance
default DeleteDbInstanceResponse deleteDBInstance(Consumer<DeleteDbInstanceRequest.Builder> deleteDbInstanceRequest) throws DbInstanceNotFoundException, InvalidDbInstanceStateException, DbSnapshotAlreadyExistsException, SnapshotQuotaExceededException, InvalidDbClusterStateException, DbInstanceAutomatedBackupQuotaExceededException, AwsServiceException, SdkClientException, RdsException
Deletes a previously provisioned DB instance. When you delete a DB instance, all automated backups for that instance are deleted and can't be recovered. However, manual DB snapshots of the DB instance aren't deleted.
If you request a final DB snapshot, the status of the Amazon RDS DB instance is
deleting
until the DB snapshot is created. This operation can't be canceled or reverted after it begins. To monitor the status of this operation, useDescribeDBInstance
.When a DB instance is in a failure state and has a status of
failed
,incompatible-restore
, orincompatible-network
, you can only delete it when you skip creation of the final snapshot with theSkipFinalSnapshot
parameter.If the specified DB instance is part of an Amazon Aurora DB cluster, you can't delete the DB instance if both of the following conditions are true:
-
The DB cluster is a read replica of another Amazon Aurora DB cluster.
-
The DB instance is the only instance in the DB cluster.
To delete a DB instance in this case, first use the
PromoteReadReplicaDBCluster
operation to promote the DB cluster so that it's no longer a read replica. After the promotion completes, use theDeleteDBInstance
operation to delete the final instance in the DB cluster.For RDS Custom DB instances, deleting the DB instance permanently deletes the EC2 instance and the associated EBS volumes. Make sure that you don't terminate or delete these resources before you delete the DB instance. Otherwise, deleting the DB instance and creation of the final snapshot might fail.
This is a convenience which creates an instance of the
DeleteDbInstanceRequest.Builder
avoiding the need to create one manually viaDeleteDbInstanceRequest.builder()
- Parameters:
deleteDbInstanceRequest
- AConsumer
that will call methods onDeleteDbInstanceRequest.Builder
to create a request.- Returns:
- Result of the DeleteDBInstance operation returned by the service.
- Throws:
DbInstanceNotFoundException
-DBInstanceIdentifier
doesn't refer to an existing DB instance.InvalidDbInstanceStateException
- The DB instance isn't in a valid state.DbSnapshotAlreadyExistsException
-DBSnapshotIdentifier
is already used by an existing snapshot.SnapshotQuotaExceededException
- The request would result in the user exceeding the allowed number of DB snapshots.InvalidDbClusterStateException
- The requested operation can't be performed while the cluster is in this state.DbInstanceAutomatedBackupQuotaExceededException
- The quota for retained automated backups was exceeded. This prevents you from retaining any additional automated backups. The retained automated backups quota is the same as your DB instance quota.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
-
deleteDBInstanceAutomatedBackup
default DeleteDbInstanceAutomatedBackupResponse deleteDBInstanceAutomatedBackup(DeleteDbInstanceAutomatedBackupRequest deleteDbInstanceAutomatedBackupRequest) throws InvalidDbInstanceAutomatedBackupStateException, DbInstanceAutomatedBackupNotFoundException, AwsServiceException, SdkClientException, RdsException
Deletes automated backups using the
DbiResourceId
value of the source DB instance or the Amazon Resource Name (ARN) of the automated backups.- Parameters:
deleteDbInstanceAutomatedBackupRequest
- Parameter input for theDeleteDBInstanceAutomatedBackup
operation.- Returns:
- Result of the DeleteDBInstanceAutomatedBackup operation returned by the service.
- Throws:
InvalidDbInstanceAutomatedBackupStateException
- The automated backup is in an invalid state. For example, this automated backup is associated with an active instance.DbInstanceAutomatedBackupNotFoundException
- No automated backup for this DB instance was found.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
deleteDBInstanceAutomatedBackup
default DeleteDbInstanceAutomatedBackupResponse deleteDBInstanceAutomatedBackup(Consumer<DeleteDbInstanceAutomatedBackupRequest.Builder> deleteDbInstanceAutomatedBackupRequest) throws InvalidDbInstanceAutomatedBackupStateException, DbInstanceAutomatedBackupNotFoundException, AwsServiceException, SdkClientException, RdsException
Deletes automated backups using the
DbiResourceId
value of the source DB instance or the Amazon Resource Name (ARN) of the automated backups.
This is a convenience which creates an instance of the
DeleteDbInstanceAutomatedBackupRequest.Builder
avoiding the need to create one manually viaDeleteDbInstanceAutomatedBackupRequest.builder()
- Parameters:
deleteDbInstanceAutomatedBackupRequest
- AConsumer
that will call methods onDeleteDbInstanceAutomatedBackupRequest.Builder
to create a request. Parameter input for theDeleteDBInstanceAutomatedBackup
operation.- Returns:
- Result of the DeleteDBInstanceAutomatedBackup operation returned by the service.
- Throws:
InvalidDbInstanceAutomatedBackupStateException
- The automated backup is in an invalid state. For example, this automated backup is associated with an active instance.DbInstanceAutomatedBackupNotFoundException
- No automated backup for this DB instance was found.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
deleteDBParameterGroup
default DeleteDbParameterGroupResponse deleteDBParameterGroup(DeleteDbParameterGroupRequest deleteDbParameterGroupRequest) throws InvalidDbParameterGroupStateException, DbParameterGroupNotFoundException, AwsServiceException, SdkClientException, RdsException
Deletes a specified DB parameter group. The DB parameter group to be deleted can't be associated with any DB instances.
- Parameters:
deleteDbParameterGroupRequest
-- Returns:
- Result of the DeleteDBParameterGroup operation returned by the service.
- Throws:
InvalidDbParameterGroupStateException
- The DB parameter group is in use or is in an invalid state. If you are attempting to delete the parameter group, you can't delete it when the parameter group is in this state.DbParameterGroupNotFoundException
-DBParameterGroupName
doesn't refer to an existing DB parameter group.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
deleteDBParameterGroup
default DeleteDbParameterGroupResponse deleteDBParameterGroup(Consumer<DeleteDbParameterGroupRequest.Builder> deleteDbParameterGroupRequest) throws InvalidDbParameterGroupStateException, DbParameterGroupNotFoundException, AwsServiceException, SdkClientException, RdsException
Deletes a specified DB parameter group. The DB parameter group to be deleted can't be associated with any DB instances.
This is a convenience which creates an instance of the
DeleteDbParameterGroupRequest.Builder
avoiding the need to create one manually viaDeleteDbParameterGroupRequest.builder()
- Parameters:
deleteDbParameterGroupRequest
- AConsumer
that will call methods onDeleteDbParameterGroupRequest.Builder
to create a request.- Returns:
- Result of the DeleteDBParameterGroup operation returned by the service.
- Throws:
InvalidDbParameterGroupStateException
- The DB parameter group is in use or is in an invalid state. If you are attempting to delete the parameter group, you can't delete it when the parameter group is in this state.DbParameterGroupNotFoundException
-DBParameterGroupName
doesn't refer to an existing DB parameter group.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
deleteDBProxy
default DeleteDbProxyResponse deleteDBProxy(DeleteDbProxyRequest deleteDbProxyRequest) throws DbProxyNotFoundException, InvalidDbProxyStateException, AwsServiceException, SdkClientException, RdsException
Deletes an existing DB proxy.
- Parameters:
deleteDbProxyRequest
-- Returns:
- Result of the DeleteDBProxy operation returned by the service.
- Throws:
DbProxyNotFoundException
- The specified proxy name doesn't correspond to a proxy owned by your Amazon Web Services account in the specified Amazon Web Services Region.InvalidDbProxyStateException
- The requested operation can't be performed while the proxy is in this state.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
deleteDBProxy
default DeleteDbProxyResponse deleteDBProxy(Consumer<DeleteDbProxyRequest.Builder> deleteDbProxyRequest) throws DbProxyNotFoundException, InvalidDbProxyStateException, AwsServiceException, SdkClientException, RdsException
Deletes an existing DB proxy.
This is a convenience which creates an instance of the
DeleteDbProxyRequest.Builder
avoiding the need to create one manually viaDeleteDbProxyRequest.builder()
- Parameters:
deleteDbProxyRequest
- AConsumer
that will call methods onDeleteDbProxyRequest.Builder
to create a request.- Returns:
- Result of the DeleteDBProxy operation returned by the service.
- Throws:
DbProxyNotFoundException
- The specified proxy name doesn't correspond to a proxy owned by your Amazon Web Services account in the specified Amazon Web Services Region.InvalidDbProxyStateException
- The requested operation can't be performed while the proxy is in this state.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
deleteDBProxyEndpoint
default DeleteDbProxyEndpointResponse deleteDBProxyEndpoint(DeleteDbProxyEndpointRequest deleteDbProxyEndpointRequest) throws DbProxyEndpointNotFoundException, InvalidDbProxyEndpointStateException, AwsServiceException, SdkClientException, RdsException
Deletes a
DBProxyEndpoint
. Doing so removes the ability to access the DB proxy using the endpoint that you defined. The endpoint that you delete might have provided capabilities such as read/write or read-only operations, or using a different VPC than the DB proxy's default VPC.- Parameters:
deleteDbProxyEndpointRequest
-- Returns:
- Result of the DeleteDBProxyEndpoint operation returned by the service.
- Throws:
DbProxyEndpointNotFoundException
- The DB proxy endpoint doesn't exist.InvalidDbProxyEndpointStateException
- You can't perform this operation while the DB proxy endpoint is in a particular state.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
deleteDBProxyEndpoint
default DeleteDbProxyEndpointResponse deleteDBProxyEndpoint(Consumer<DeleteDbProxyEndpointRequest.Builder> deleteDbProxyEndpointRequest) throws DbProxyEndpointNotFoundException, InvalidDbProxyEndpointStateException, AwsServiceException, SdkClientException, RdsException
Deletes a
DBProxyEndpoint
. Doing so removes the ability to access the DB proxy using the endpoint that you defined. The endpoint that you delete might have provided capabilities such as read/write or read-only operations, or using a different VPC than the DB proxy's default VPC.
This is a convenience which creates an instance of the
DeleteDbProxyEndpointRequest.Builder
avoiding the need to create one manually viaDeleteDbProxyEndpointRequest.builder()
- Parameters:
deleteDbProxyEndpointRequest
- AConsumer
that will call methods onDeleteDbProxyEndpointRequest.Builder
to create a request.- Returns:
- Result of the DeleteDBProxyEndpoint operation returned by the service.
- Throws:
DbProxyEndpointNotFoundException
- The DB proxy endpoint doesn't exist.InvalidDbProxyEndpointStateException
- You can't perform this operation while the DB proxy endpoint is in a particular state.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
deleteDBSecurityGroup
default DeleteDbSecurityGroupResponse deleteDBSecurityGroup(DeleteDbSecurityGroupRequest deleteDbSecurityGroupRequest) throws InvalidDbSecurityGroupStateException, DbSecurityGroupNotFoundException, AwsServiceException, SdkClientException, RdsException
Deletes a DB security group.
The specified DB security group must not be associated with any DB instances.
EC2-Classic was retired on August 15, 2022. If you haven't migrated from EC2-Classic to a VPC, we recommend that you migrate as soon as possible. For more information, see Migrate from EC2-Classic to a VPC in the Amazon EC2 User Guide, the blog EC2-Classic Networking is Retiring – Here’s How to Prepare, and Moving a DB instance not in a VPC into a VPC in the Amazon RDS User Guide.
- Parameters:
deleteDbSecurityGroupRequest
-- Returns:
- Result of the DeleteDBSecurityGroup operation returned by the service.
- Throws:
InvalidDbSecurityGroupStateException
- The state of the DB security group doesn't allow deletion.DbSecurityGroupNotFoundException
-DBSecurityGroupName
doesn't refer to an existing DB security group.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
deleteDBSecurityGroup
default DeleteDbSecurityGroupResponse deleteDBSecurityGroup(Consumer<DeleteDbSecurityGroupRequest.Builder> deleteDbSecurityGroupRequest) throws InvalidDbSecurityGroupStateException, DbSecurityGroupNotFoundException, AwsServiceException, SdkClientException, RdsException
Deletes a DB security group.
The specified DB security group must not be associated with any DB instances.
EC2-Classic was retired on August 15, 2022. If you haven't migrated from EC2-Classic to a VPC, we recommend that you migrate as soon as possible. For more information, see Migrate from EC2-Classic to a VPC in the Amazon EC2 User Guide, the blog EC2-Classic Networking is Retiring – Here’s How to Prepare, and Moving a DB instance not in a VPC into a VPC in the Amazon RDS User Guide.
This is a convenience which creates an instance of the
DeleteDbSecurityGroupRequest.Builder
avoiding the need to create one manually viaDeleteDbSecurityGroupRequest.builder()
- Parameters:
deleteDbSecurityGroupRequest
- AConsumer
that will call methods onDeleteDbSecurityGroupRequest.Builder
to create a request.- Returns:
- Result of the DeleteDBSecurityGroup operation returned by the service.
- Throws:
InvalidDbSecurityGroupStateException
- The state of the DB security group doesn't allow deletion.DbSecurityGroupNotFoundException
-DBSecurityGroupName
doesn't refer to an existing DB security group.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
deleteDBShardGroup
default DeleteDbShardGroupResponse deleteDBShardGroup(DeleteDbShardGroupRequest deleteDbShardGroupRequest) throws DbShardGroupNotFoundException, InvalidDbShardGroupStateException, InvalidDbClusterStateException, AwsServiceException, SdkClientException, RdsException
Deletes an Aurora Limitless Database DB shard group.
- Parameters:
deleteDbShardGroupRequest
-- Returns:
- Result of the DeleteDBShardGroup operation returned by the service.
- Throws:
DbShardGroupNotFoundException
- The specified DB shard group name wasn't found.InvalidDbShardGroupStateException
- The DB shard group must be in the available state.InvalidDbClusterStateException
- The requested operation can't be performed while the cluster is in this state.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
deleteDBShardGroup
default DeleteDbShardGroupResponse deleteDBShardGroup(Consumer<DeleteDbShardGroupRequest.Builder> deleteDbShardGroupRequest) throws DbShardGroupNotFoundException, InvalidDbShardGroupStateException, InvalidDbClusterStateException, AwsServiceException, SdkClientException, RdsException
Deletes an Aurora Limitless Database DB shard group.
This is a convenience which creates an instance of the
DeleteDbShardGroupRequest.Builder
avoiding the need to create one manually viaDeleteDbShardGroupRequest.builder()
- Parameters:
deleteDbShardGroupRequest
- AConsumer
that will call methods onDeleteDbShardGroupRequest.Builder
to create a request.- Returns:
- Result of the DeleteDBShardGroup operation returned by the service.
- Throws:
DbShardGroupNotFoundException
- The specified DB shard group name wasn't found.InvalidDbShardGroupStateException
- The DB shard group must be in the available state.InvalidDbClusterStateException
- The requested operation can't be performed while the cluster is in this state.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
deleteDBSnapshot
default DeleteDbSnapshotResponse deleteDBSnapshot(DeleteDbSnapshotRequest deleteDbSnapshotRequest) throws InvalidDbSnapshotStateException, DbSnapshotNotFoundException, AwsServiceException, SdkClientException, RdsException
Deletes a DB snapshot. If the snapshot is being copied, the copy operation is terminated.
The DB snapshot must be in the
available
state to be deleted.- Parameters:
deleteDbSnapshotRequest
-- Returns:
- Result of the DeleteDBSnapshot operation returned by the service.
- Throws:
InvalidDbSnapshotStateException
- The state of the DB snapshot doesn't allow deletion.DbSnapshotNotFoundException
-DBSnapshotIdentifier
doesn't refer to an existing DB snapshot.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
deleteDBSnapshot
default DeleteDbSnapshotResponse deleteDBSnapshot(Consumer<DeleteDbSnapshotRequest.Builder> deleteDbSnapshotRequest) throws InvalidDbSnapshotStateException, DbSnapshotNotFoundException, AwsServiceException, SdkClientException, RdsException
Deletes a DB snapshot. If the snapshot is being copied, the copy operation is terminated.
The DB snapshot must be in the
available
state to be deleted.
This is a convenience which creates an instance of the
DeleteDbSnapshotRequest.Builder
avoiding the need to create one manually viaDeleteDbSnapshotRequest.builder()
- Parameters:
deleteDbSnapshotRequest
- AConsumer
that will call methods onDeleteDbSnapshotRequest.Builder
to create a request.- Returns:
- Result of the DeleteDBSnapshot operation returned by the service.
- Throws:
InvalidDbSnapshotStateException
- The state of the DB snapshot doesn't allow deletion.DbSnapshotNotFoundException
-DBSnapshotIdentifier
doesn't refer to an existing DB snapshot.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
deleteDBSubnetGroup
default DeleteDbSubnetGroupResponse deleteDBSubnetGroup(DeleteDbSubnetGroupRequest deleteDbSubnetGroupRequest) throws InvalidDbSubnetGroupStateException, InvalidDbSubnetStateException, DbSubnetGroupNotFoundException, AwsServiceException, SdkClientException, RdsException
Deletes a DB subnet group.
The specified database subnet group must not be associated with any DB instances.
- Parameters:
deleteDbSubnetGroupRequest
-- Returns:
- Result of the DeleteDBSubnetGroup operation returned by the service.
- Throws:
InvalidDbSubnetGroupStateException
- The DB subnet group cannot be deleted because it's in use.InvalidDbSubnetStateException
- The DB subnet isn't in the available state.DbSubnetGroupNotFoundException
-DBSubnetGroupName
doesn't refer to an existing DB subnet group.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
deleteDBSubnetGroup
default DeleteDbSubnetGroupResponse deleteDBSubnetGroup(Consumer<DeleteDbSubnetGroupRequest.Builder> deleteDbSubnetGroupRequest) throws InvalidDbSubnetGroupStateException, InvalidDbSubnetStateException, DbSubnetGroupNotFoundException, AwsServiceException, SdkClientException, RdsException
Deletes a DB subnet group.
The specified database subnet group must not be associated with any DB instances.
This is a convenience which creates an instance of the
DeleteDbSubnetGroupRequest.Builder
avoiding the need to create one manually viaDeleteDbSubnetGroupRequest.builder()
- Parameters:
deleteDbSubnetGroupRequest
- AConsumer
that will call methods onDeleteDbSubnetGroupRequest.Builder
to create a request.- Returns:
- Result of the DeleteDBSubnetGroup operation returned by the service.
- Throws:
InvalidDbSubnetGroupStateException
- The DB subnet group cannot be deleted because it's in use.InvalidDbSubnetStateException
- The DB subnet isn't in the available state.DbSubnetGroupNotFoundException
-DBSubnetGroupName
doesn't refer to an existing DB subnet group.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
deleteEventSubscription
default DeleteEventSubscriptionResponse deleteEventSubscription(DeleteEventSubscriptionRequest deleteEventSubscriptionRequest) throws SubscriptionNotFoundException, InvalidEventSubscriptionStateException, AwsServiceException, SdkClientException, RdsException
Deletes an RDS event notification subscription.
- Parameters:
deleteEventSubscriptionRequest
-- Returns:
- Result of the DeleteEventSubscription operation returned by the service.
- Throws:
SubscriptionNotFoundException
- The subscription name does not exist.InvalidEventSubscriptionStateException
- This error can occur if someone else is modifying a subscription. You should retry the action.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
deleteEventSubscription
default DeleteEventSubscriptionResponse deleteEventSubscription(Consumer<DeleteEventSubscriptionRequest.Builder> deleteEventSubscriptionRequest) throws SubscriptionNotFoundException, InvalidEventSubscriptionStateException, AwsServiceException, SdkClientException, RdsException
Deletes an RDS event notification subscription.
This is a convenience which creates an instance of the
DeleteEventSubscriptionRequest.Builder
avoiding the need to create one manually viaDeleteEventSubscriptionRequest.builder()
- Parameters:
deleteEventSubscriptionRequest
- AConsumer
that will call methods onDeleteEventSubscriptionRequest.Builder
to create a request.- Returns:
- Result of the DeleteEventSubscription operation returned by the service.
- Throws:
SubscriptionNotFoundException
- The subscription name does not exist.InvalidEventSubscriptionStateException
- This error can occur if someone else is modifying a subscription. You should retry the action.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
deleteGlobalCluster
default DeleteGlobalClusterResponse deleteGlobalCluster(DeleteGlobalClusterRequest deleteGlobalClusterRequest) throws GlobalClusterNotFoundException, InvalidGlobalClusterStateException, AwsServiceException, SdkClientException, RdsException
Deletes a global database cluster. The primary and secondary clusters must already be detached or destroyed first.
This action only applies to Aurora DB clusters.
- Parameters:
deleteGlobalClusterRequest
-- Returns:
- Result of the DeleteGlobalCluster operation returned by the service.
- Throws:
GlobalClusterNotFoundException
- TheGlobalClusterIdentifier
doesn't refer to an existing global database cluster.InvalidGlobalClusterStateException
- The global cluster is in an invalid state and can't perform the requested operation.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
deleteGlobalCluster
default DeleteGlobalClusterResponse deleteGlobalCluster(Consumer<DeleteGlobalClusterRequest.Builder> deleteGlobalClusterRequest) throws GlobalClusterNotFoundException, InvalidGlobalClusterStateException, AwsServiceException, SdkClientException, RdsException
Deletes a global database cluster. The primary and secondary clusters must already be detached or destroyed first.
This action only applies to Aurora DB clusters.
This is a convenience which creates an instance of the
DeleteGlobalClusterRequest.Builder
avoiding the need to create one manually viaDeleteGlobalClusterRequest.builder()
- Parameters:
deleteGlobalClusterRequest
- AConsumer
that will call methods onDeleteGlobalClusterRequest.Builder
to create a request.- Returns:
- Result of the DeleteGlobalCluster operation returned by the service.
- Throws:
GlobalClusterNotFoundException
- TheGlobalClusterIdentifier
doesn't refer to an existing global database cluster.InvalidGlobalClusterStateException
- The global cluster is in an invalid state and can't perform the requested operation.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
deleteIntegration
default DeleteIntegrationResponse deleteIntegration(DeleteIntegrationRequest deleteIntegrationRequest) throws IntegrationNotFoundException, IntegrationConflictOperationException, InvalidIntegrationStateException, AwsServiceException, SdkClientException, RdsException
Deletes a zero-ETL integration with Amazon Redshift.
- Parameters:
deleteIntegrationRequest
-- Returns:
- Result of the DeleteIntegration operation returned by the service.
- Throws:
IntegrationNotFoundException
- The specified integration could not be found.IntegrationConflictOperationException
- A conflicting conditional operation is currently in progress against this resource. Typically occurs when there are multiple requests being made to the same resource at the same time, and these requests conflict with each other.InvalidIntegrationStateException
- The integration is in an invalid state and can't perform the requested operation.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
deleteIntegration
default DeleteIntegrationResponse deleteIntegration(Consumer<DeleteIntegrationRequest.Builder> deleteIntegrationRequest) throws IntegrationNotFoundException, IntegrationConflictOperationException, InvalidIntegrationStateException, AwsServiceException, SdkClientException, RdsException
Deletes a zero-ETL integration with Amazon Redshift.
This is a convenience which creates an instance of the
DeleteIntegrationRequest.Builder
avoiding the need to create one manually viaDeleteIntegrationRequest.builder()
- Parameters:
deleteIntegrationRequest
- AConsumer
that will call methods onDeleteIntegrationRequest.Builder
to create a request.- Returns:
- Result of the DeleteIntegration operation returned by the service.
- Throws:
IntegrationNotFoundException
- The specified integration could not be found.IntegrationConflictOperationException
- A conflicting conditional operation is currently in progress against this resource. Typically occurs when there are multiple requests being made to the same resource at the same time, and these requests conflict with each other.InvalidIntegrationStateException
- The integration is in an invalid state and can't perform the requested operation.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
deleteOptionGroup
default DeleteOptionGroupResponse deleteOptionGroup(DeleteOptionGroupRequest deleteOptionGroupRequest) throws OptionGroupNotFoundException, InvalidOptionGroupStateException, AwsServiceException, SdkClientException, RdsException
Deletes an existing option group.
- Parameters:
deleteOptionGroupRequest
-- Returns:
- Result of the DeleteOptionGroup operation returned by the service.
- Throws:
OptionGroupNotFoundException
- The specified option group could not be found.InvalidOptionGroupStateException
- The option group isn't in the available state.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
deleteOptionGroup
default DeleteOptionGroupResponse deleteOptionGroup(Consumer<DeleteOptionGroupRequest.Builder> deleteOptionGroupRequest) throws OptionGroupNotFoundException, InvalidOptionGroupStateException, AwsServiceException, SdkClientException, RdsException
Deletes an existing option group.
This is a convenience which creates an instance of the
DeleteOptionGroupRequest.Builder
avoiding the need to create one manually viaDeleteOptionGroupRequest.builder()
- Parameters:
deleteOptionGroupRequest
- AConsumer
that will call methods onDeleteOptionGroupRequest.Builder
to create a request.- Returns:
- Result of the DeleteOptionGroup operation returned by the service.
- Throws:
OptionGroupNotFoundException
- The specified option group could not be found.InvalidOptionGroupStateException
- The option group isn't in the available state.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
deleteTenantDatabase
default DeleteTenantDatabaseResponse deleteTenantDatabase(DeleteTenantDatabaseRequest deleteTenantDatabaseRequest) throws DbInstanceNotFoundException, TenantDatabaseNotFoundException, InvalidDbInstanceStateException, AwsServiceException, SdkClientException, RdsException
Deletes a tenant database from your DB instance. This command only applies to RDS for Oracle container database (CDB) instances.
You can't delete a tenant database when it is the only tenant in the DB instance.
- Parameters:
deleteTenantDatabaseRequest
-- Returns:
- Result of the DeleteTenantDatabase operation returned by the service.
- Throws:
DbInstanceNotFoundException
-DBInstanceIdentifier
doesn't refer to an existing DB instance.TenantDatabaseNotFoundException
- The specified tenant database wasn't found in the DB instance.InvalidDbInstanceStateException
- The DB instance isn't in a valid state.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
deleteTenantDatabase
default DeleteTenantDatabaseResponse deleteTenantDatabase(Consumer<DeleteTenantDatabaseRequest.Builder> deleteTenantDatabaseRequest) throws DbInstanceNotFoundException, TenantDatabaseNotFoundException, InvalidDbInstanceStateException, AwsServiceException, SdkClientException, RdsException
Deletes a tenant database from your DB instance. This command only applies to RDS for Oracle container database (CDB) instances.
You can't delete a tenant database when it is the only tenant in the DB instance.
This is a convenience which creates an instance of the
DeleteTenantDatabaseRequest.Builder
avoiding the need to create one manually viaDeleteTenantDatabaseRequest.builder()
- Parameters:
deleteTenantDatabaseRequest
- AConsumer
that will call methods onDeleteTenantDatabaseRequest.Builder
to create a request.- Returns:
- Result of the DeleteTenantDatabase operation returned by the service.
- Throws:
DbInstanceNotFoundException
-DBInstanceIdentifier
doesn't refer to an existing DB instance.TenantDatabaseNotFoundException
- The specified tenant database wasn't found in the DB instance.InvalidDbInstanceStateException
- The DB instance isn't in a valid state.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
deregisterDBProxyTargets
default DeregisterDbProxyTargetsResponse deregisterDBProxyTargets(DeregisterDbProxyTargetsRequest deregisterDbProxyTargetsRequest) throws DbProxyTargetNotFoundException, DbProxyTargetGroupNotFoundException, DbProxyNotFoundException, InvalidDbProxyStateException, AwsServiceException, SdkClientException, RdsException
Remove the association between one or more
DBProxyTarget
data structures and aDBProxyTargetGroup
.- Parameters:
deregisterDbProxyTargetsRequest
-- Returns:
- Result of the DeregisterDBProxyTargets operation returned by the service.
- Throws:
DbProxyTargetNotFoundException
- The specified RDS DB instance or Aurora DB cluster isn't available for a proxy owned by your Amazon Web Services account in the specified Amazon Web Services Region.DbProxyTargetGroupNotFoundException
- The specified target group isn't available for a proxy owned by your Amazon Web Services account in the specified Amazon Web Services Region.DbProxyNotFoundException
- The specified proxy name doesn't correspond to a proxy owned by your Amazon Web Services account in the specified Amazon Web Services Region.InvalidDbProxyStateException
- The requested operation can't be performed while the proxy is in this state.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
deregisterDBProxyTargets
default DeregisterDbProxyTargetsResponse deregisterDBProxyTargets(Consumer<DeregisterDbProxyTargetsRequest.Builder> deregisterDbProxyTargetsRequest) throws DbProxyTargetNotFoundException, DbProxyTargetGroupNotFoundException, DbProxyNotFoundException, InvalidDbProxyStateException, AwsServiceException, SdkClientException, RdsException
Remove the association between one or more
DBProxyTarget
data structures and aDBProxyTargetGroup
.
This is a convenience which creates an instance of the
DeregisterDbProxyTargetsRequest.Builder
avoiding the need to create one manually viaDeregisterDbProxyTargetsRequest.builder()
- Parameters:
deregisterDbProxyTargetsRequest
- AConsumer
that will call methods onDeregisterDbProxyTargetsRequest.Builder
to create a request.- Returns:
- Result of the DeregisterDBProxyTargets operation returned by the service.
- Throws:
DbProxyTargetNotFoundException
- The specified RDS DB instance or Aurora DB cluster isn't available for a proxy owned by your Amazon Web Services account in the specified Amazon Web Services Region.DbProxyTargetGroupNotFoundException
- The specified target group isn't available for a proxy owned by your Amazon Web Services account in the specified Amazon Web Services Region.DbProxyNotFoundException
- The specified proxy name doesn't correspond to a proxy owned by your Amazon Web Services account in the specified Amazon Web Services Region.InvalidDbProxyStateException
- The requested operation can't be performed while the proxy is in this state.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeAccountAttributes
default DescribeAccountAttributesResponse describeAccountAttributes(DescribeAccountAttributesRequest describeAccountAttributesRequest) throws AwsServiceException, SdkClientException, RdsException
Lists all of the attributes for a customer account. The attributes include Amazon RDS quotas for the account, such as the number of DB instances allowed. The description for a quota includes the quota name, current usage toward that quota, and the quota's maximum value.
This command doesn't take any parameters.
- Parameters:
describeAccountAttributesRequest
-- Returns:
- Result of the DescribeAccountAttributes operation returned by the service.
- Throws:
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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeAccountAttributes
default DescribeAccountAttributesResponse describeAccountAttributes(Consumer<DescribeAccountAttributesRequest.Builder> describeAccountAttributesRequest) throws AwsServiceException, SdkClientException, RdsException
Lists all of the attributes for a customer account. The attributes include Amazon RDS quotas for the account, such as the number of DB instances allowed. The description for a quota includes the quota name, current usage toward that quota, and the quota's maximum value.
This command doesn't take any parameters.
This is a convenience which creates an instance of the
DescribeAccountAttributesRequest.Builder
avoiding the need to create one manually viaDescribeAccountAttributesRequest.builder()
- Parameters:
describeAccountAttributesRequest
- AConsumer
that will call methods onDescribeAccountAttributesRequest.Builder
to create a request.- Returns:
- Result of the DescribeAccountAttributes operation returned by the service.
- Throws:
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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeAccountAttributes
default DescribeAccountAttributesResponse describeAccountAttributes() throws AwsServiceException, SdkClientException, RdsException
Lists all of the attributes for a customer account. The attributes include Amazon RDS quotas for the account, such as the number of DB instances allowed. The description for a quota includes the quota name, current usage toward that quota, and the quota's maximum value.
This command doesn't take any parameters.
- Returns:
- Result of the DescribeAccountAttributes operation returned by the service.
- Throws:
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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
describeAccountAttributes(DescribeAccountAttributesRequest)
, AWS API Documentation
-
describeBlueGreenDeployments
default DescribeBlueGreenDeploymentsResponse describeBlueGreenDeployments(DescribeBlueGreenDeploymentsRequest describeBlueGreenDeploymentsRequest) throws BlueGreenDeploymentNotFoundException, AwsServiceException, SdkClientException, RdsException
Describes one or more blue/green deployments.
For more information, see Using Amazon RDS Blue/Green Deployments for database updates in the Amazon RDS User Guide and Using Amazon RDS Blue/Green Deployments for database updates in the Amazon Aurora User Guide.
- Parameters:
describeBlueGreenDeploymentsRequest
-- Returns:
- Result of the DescribeBlueGreenDeployments operation returned by the service.
- Throws:
BlueGreenDeploymentNotFoundException
-BlueGreenDeploymentIdentifier
doesn't refer to an existing blue/green deployment.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeBlueGreenDeployments
default DescribeBlueGreenDeploymentsResponse describeBlueGreenDeployments(Consumer<DescribeBlueGreenDeploymentsRequest.Builder> describeBlueGreenDeploymentsRequest) throws BlueGreenDeploymentNotFoundException, AwsServiceException, SdkClientException, RdsException
Describes one or more blue/green deployments.
For more information, see Using Amazon RDS Blue/Green Deployments for database updates in the Amazon RDS User Guide and Using Amazon RDS Blue/Green Deployments for database updates in the Amazon Aurora User Guide.
This is a convenience which creates an instance of the
DescribeBlueGreenDeploymentsRequest.Builder
avoiding the need to create one manually viaDescribeBlueGreenDeploymentsRequest.builder()
- Parameters:
describeBlueGreenDeploymentsRequest
- AConsumer
that will call methods onDescribeBlueGreenDeploymentsRequest.Builder
to create a request.- Returns:
- Result of the DescribeBlueGreenDeployments operation returned by the service.
- Throws:
BlueGreenDeploymentNotFoundException
-BlueGreenDeploymentIdentifier
doesn't refer to an existing blue/green deployment.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeBlueGreenDeploymentsPaginator
default DescribeBlueGreenDeploymentsIterable describeBlueGreenDeploymentsPaginator(DescribeBlueGreenDeploymentsRequest describeBlueGreenDeploymentsRequest) throws BlueGreenDeploymentNotFoundException, AwsServiceException, SdkClientException, RdsException
This is a variant of
describeBlueGreenDeployments(software.amazon.awssdk.services.rds.model.DescribeBlueGreenDeploymentsRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeBlueGreenDeploymentsIterable responses = client.describeBlueGreenDeploymentsPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeBlueGreenDeploymentsIterable responses = client .describeBlueGreenDeploymentsPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeBlueGreenDeploymentsResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeBlueGreenDeploymentsIterable responses = client.describeBlueGreenDeploymentsPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeBlueGreenDeployments(software.amazon.awssdk.services.rds.model.DescribeBlueGreenDeploymentsRequest)
operation.- Parameters:
describeBlueGreenDeploymentsRequest
-- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
BlueGreenDeploymentNotFoundException
-BlueGreenDeploymentIdentifier
doesn't refer to an existing blue/green deployment.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeBlueGreenDeploymentsPaginator
default DescribeBlueGreenDeploymentsIterable describeBlueGreenDeploymentsPaginator(Consumer<DescribeBlueGreenDeploymentsRequest.Builder> describeBlueGreenDeploymentsRequest) throws BlueGreenDeploymentNotFoundException, AwsServiceException, SdkClientException, RdsException
This is a variant of
describeBlueGreenDeployments(software.amazon.awssdk.services.rds.model.DescribeBlueGreenDeploymentsRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeBlueGreenDeploymentsIterable responses = client.describeBlueGreenDeploymentsPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeBlueGreenDeploymentsIterable responses = client .describeBlueGreenDeploymentsPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeBlueGreenDeploymentsResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeBlueGreenDeploymentsIterable responses = client.describeBlueGreenDeploymentsPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeBlueGreenDeployments(software.amazon.awssdk.services.rds.model.DescribeBlueGreenDeploymentsRequest)
operation.
This is a convenience which creates an instance of the
DescribeBlueGreenDeploymentsRequest.Builder
avoiding the need to create one manually viaDescribeBlueGreenDeploymentsRequest.builder()
- Parameters:
describeBlueGreenDeploymentsRequest
- AConsumer
that will call methods onDescribeBlueGreenDeploymentsRequest.Builder
to create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
BlueGreenDeploymentNotFoundException
-BlueGreenDeploymentIdentifier
doesn't refer to an existing blue/green deployment.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeCertificates
default DescribeCertificatesResponse describeCertificates(DescribeCertificatesRequest describeCertificatesRequest) throws CertificateNotFoundException, AwsServiceException, SdkClientException, RdsException
Lists the set of certificate authority (CA) certificates provided by Amazon RDS for this Amazon Web Services account.
For more information, see Using SSL/TLS to encrypt a connection to a DB instance in the Amazon RDS User Guide and Using SSL/TLS to encrypt a connection to a DB cluster in the Amazon Aurora User Guide.
- Parameters:
describeCertificatesRequest
-- Returns:
- Result of the DescribeCertificates operation returned by the service.
- Throws:
CertificateNotFoundException
-CertificateIdentifier
doesn't refer to an existing certificate.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeCertificates
default DescribeCertificatesResponse describeCertificates(Consumer<DescribeCertificatesRequest.Builder> describeCertificatesRequest) throws CertificateNotFoundException, AwsServiceException, SdkClientException, RdsException
Lists the set of certificate authority (CA) certificates provided by Amazon RDS for this Amazon Web Services account.
For more information, see Using SSL/TLS to encrypt a connection to a DB instance in the Amazon RDS User Guide and Using SSL/TLS to encrypt a connection to a DB cluster in the Amazon Aurora User Guide.
This is a convenience which creates an instance of the
DescribeCertificatesRequest.Builder
avoiding the need to create one manually viaDescribeCertificatesRequest.builder()
- Parameters:
describeCertificatesRequest
- AConsumer
that will call methods onDescribeCertificatesRequest.Builder
to create a request.- Returns:
- Result of the DescribeCertificates operation returned by the service.
- Throws:
CertificateNotFoundException
-CertificateIdentifier
doesn't refer to an existing certificate.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeCertificates
default DescribeCertificatesResponse describeCertificates() throws CertificateNotFoundException, AwsServiceException, SdkClientException, RdsException
Lists the set of certificate authority (CA) certificates provided by Amazon RDS for this Amazon Web Services account.
For more information, see Using SSL/TLS to encrypt a connection to a DB instance in the Amazon RDS User Guide and Using SSL/TLS to encrypt a connection to a DB cluster in the Amazon Aurora User Guide.
- Returns:
- Result of the DescribeCertificates operation returned by the service.
- Throws:
CertificateNotFoundException
-CertificateIdentifier
doesn't refer to an existing certificate.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
describeCertificates(DescribeCertificatesRequest)
, AWS API Documentation
-
describeCertificatesPaginator
default DescribeCertificatesIterable describeCertificatesPaginator() throws CertificateNotFoundException, AwsServiceException, SdkClientException, RdsException
This is a variant of
describeCertificates(software.amazon.awssdk.services.rds.model.DescribeCertificatesRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeCertificatesIterable responses = client.describeCertificatesPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeCertificatesIterable responses = client .describeCertificatesPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeCertificatesResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeCertificatesIterable responses = client.describeCertificatesPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeCertificates(software.amazon.awssdk.services.rds.model.DescribeCertificatesRequest)
operation.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
CertificateNotFoundException
-CertificateIdentifier
doesn't refer to an existing certificate.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
describeCertificatesPaginator(DescribeCertificatesRequest)
, AWS API Documentation
-
describeCertificatesPaginator
default DescribeCertificatesIterable describeCertificatesPaginator(DescribeCertificatesRequest describeCertificatesRequest) throws CertificateNotFoundException, AwsServiceException, SdkClientException, RdsException
This is a variant of
describeCertificates(software.amazon.awssdk.services.rds.model.DescribeCertificatesRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeCertificatesIterable responses = client.describeCertificatesPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeCertificatesIterable responses = client .describeCertificatesPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeCertificatesResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeCertificatesIterable responses = client.describeCertificatesPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeCertificates(software.amazon.awssdk.services.rds.model.DescribeCertificatesRequest)
operation.- Parameters:
describeCertificatesRequest
-- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
CertificateNotFoundException
-CertificateIdentifier
doesn't refer to an existing certificate.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeCertificatesPaginator
default DescribeCertificatesIterable describeCertificatesPaginator(Consumer<DescribeCertificatesRequest.Builder> describeCertificatesRequest) throws CertificateNotFoundException, AwsServiceException, SdkClientException, RdsException
This is a variant of
describeCertificates(software.amazon.awssdk.services.rds.model.DescribeCertificatesRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeCertificatesIterable responses = client.describeCertificatesPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeCertificatesIterable responses = client .describeCertificatesPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeCertificatesResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeCertificatesIterable responses = client.describeCertificatesPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeCertificates(software.amazon.awssdk.services.rds.model.DescribeCertificatesRequest)
operation.
This is a convenience which creates an instance of the
DescribeCertificatesRequest.Builder
avoiding the need to create one manually viaDescribeCertificatesRequest.builder()
- Parameters:
describeCertificatesRequest
- AConsumer
that will call methods onDescribeCertificatesRequest.Builder
to create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
CertificateNotFoundException
-CertificateIdentifier
doesn't refer to an existing certificate.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBClusterAutomatedBackups
default DescribeDbClusterAutomatedBackupsResponse describeDBClusterAutomatedBackups(DescribeDbClusterAutomatedBackupsRequest describeDbClusterAutomatedBackupsRequest) throws DbClusterAutomatedBackupNotFoundException, AwsServiceException, SdkClientException, RdsException
Displays backups for both current and deleted DB clusters. For example, use this operation to find details about automated backups for previously deleted clusters. Current clusters are returned for both the
DescribeDBClusterAutomatedBackups
andDescribeDBClusters
operations.All parameters are optional.
- Parameters:
describeDbClusterAutomatedBackupsRequest
-- Returns:
- Result of the DescribeDBClusterAutomatedBackups operation returned by the service.
- Throws:
DbClusterAutomatedBackupNotFoundException
- No automated backup for this DB cluster was found.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBClusterAutomatedBackups
default DescribeDbClusterAutomatedBackupsResponse describeDBClusterAutomatedBackups(Consumer<DescribeDbClusterAutomatedBackupsRequest.Builder> describeDbClusterAutomatedBackupsRequest) throws DbClusterAutomatedBackupNotFoundException, AwsServiceException, SdkClientException, RdsException
Displays backups for both current and deleted DB clusters. For example, use this operation to find details about automated backups for previously deleted clusters. Current clusters are returned for both the
DescribeDBClusterAutomatedBackups
andDescribeDBClusters
operations.All parameters are optional.
This is a convenience which creates an instance of the
DescribeDbClusterAutomatedBackupsRequest.Builder
avoiding the need to create one manually viaDescribeDbClusterAutomatedBackupsRequest.builder()
- Parameters:
describeDbClusterAutomatedBackupsRequest
- AConsumer
that will call methods onDescribeDbClusterAutomatedBackupsRequest.Builder
to create a request.- Returns:
- Result of the DescribeDBClusterAutomatedBackups operation returned by the service.
- Throws:
DbClusterAutomatedBackupNotFoundException
- No automated backup for this DB cluster was found.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBClusterAutomatedBackupsPaginator
default DescribeDBClusterAutomatedBackupsIterable describeDBClusterAutomatedBackupsPaginator(DescribeDbClusterAutomatedBackupsRequest describeDbClusterAutomatedBackupsRequest) throws DbClusterAutomatedBackupNotFoundException, AwsServiceException, SdkClientException, RdsException
This is a variant of
describeDBClusterAutomatedBackups(software.amazon.awssdk.services.rds.model.DescribeDbClusterAutomatedBackupsRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeDBClusterAutomatedBackupsIterable responses = client.describeDBClusterAutomatedBackupsPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeDBClusterAutomatedBackupsIterable responses = client .describeDBClusterAutomatedBackupsPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeDbClusterAutomatedBackupsResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeDBClusterAutomatedBackupsIterable responses = client.describeDBClusterAutomatedBackupsPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeDBClusterAutomatedBackups(software.amazon.awssdk.services.rds.model.DescribeDbClusterAutomatedBackupsRequest)
operation.- Parameters:
describeDbClusterAutomatedBackupsRequest
-- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
DbClusterAutomatedBackupNotFoundException
- No automated backup for this DB cluster was found.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBClusterAutomatedBackupsPaginator
default DescribeDBClusterAutomatedBackupsIterable describeDBClusterAutomatedBackupsPaginator(Consumer<DescribeDbClusterAutomatedBackupsRequest.Builder> describeDbClusterAutomatedBackupsRequest) throws DbClusterAutomatedBackupNotFoundException, AwsServiceException, SdkClientException, RdsException
This is a variant of
describeDBClusterAutomatedBackups(software.amazon.awssdk.services.rds.model.DescribeDbClusterAutomatedBackupsRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeDBClusterAutomatedBackupsIterable responses = client.describeDBClusterAutomatedBackupsPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeDBClusterAutomatedBackupsIterable responses = client .describeDBClusterAutomatedBackupsPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeDbClusterAutomatedBackupsResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeDBClusterAutomatedBackupsIterable responses = client.describeDBClusterAutomatedBackupsPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeDBClusterAutomatedBackups(software.amazon.awssdk.services.rds.model.DescribeDbClusterAutomatedBackupsRequest)
operation.
This is a convenience which creates an instance of the
DescribeDbClusterAutomatedBackupsRequest.Builder
avoiding the need to create one manually viaDescribeDbClusterAutomatedBackupsRequest.builder()
- Parameters:
describeDbClusterAutomatedBackupsRequest
- AConsumer
that will call methods onDescribeDbClusterAutomatedBackupsRequest.Builder
to create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
DbClusterAutomatedBackupNotFoundException
- No automated backup for this DB cluster was found.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBClusterBacktracks
default DescribeDbClusterBacktracksResponse describeDBClusterBacktracks(DescribeDbClusterBacktracksRequest describeDbClusterBacktracksRequest) throws DbClusterNotFoundException, DbClusterBacktrackNotFoundException, AwsServiceException, SdkClientException, RdsException
Returns information about backtracks for a DB cluster.
For more information on Amazon Aurora, see What is Amazon Aurora? in the Amazon Aurora User Guide.
This action only applies to Aurora MySQL DB clusters.
- Parameters:
describeDbClusterBacktracksRequest
-- Returns:
- Result of the DescribeDBClusterBacktracks operation returned by the service.
- Throws:
DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.DbClusterBacktrackNotFoundException
-BacktrackIdentifier
doesn't refer to an existing backtrack.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBClusterBacktracks
default DescribeDbClusterBacktracksResponse describeDBClusterBacktracks(Consumer<DescribeDbClusterBacktracksRequest.Builder> describeDbClusterBacktracksRequest) throws DbClusterNotFoundException, DbClusterBacktrackNotFoundException, AwsServiceException, SdkClientException, RdsException
Returns information about backtracks for a DB cluster.
For more information on Amazon Aurora, see What is Amazon Aurora? in the Amazon Aurora User Guide.
This action only applies to Aurora MySQL DB clusters.
This is a convenience which creates an instance of the
DescribeDbClusterBacktracksRequest.Builder
avoiding the need to create one manually viaDescribeDbClusterBacktracksRequest.builder()
- Parameters:
describeDbClusterBacktracksRequest
- AConsumer
that will call methods onDescribeDbClusterBacktracksRequest.Builder
to create a request.- Returns:
- Result of the DescribeDBClusterBacktracks operation returned by the service.
- Throws:
DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.DbClusterBacktrackNotFoundException
-BacktrackIdentifier
doesn't refer to an existing backtrack.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBClusterBacktracksPaginator
default DescribeDBClusterBacktracksIterable describeDBClusterBacktracksPaginator(DescribeDbClusterBacktracksRequest describeDbClusterBacktracksRequest) throws DbClusterNotFoundException, DbClusterBacktrackNotFoundException, AwsServiceException, SdkClientException, RdsException
This is a variant of
describeDBClusterBacktracks(software.amazon.awssdk.services.rds.model.DescribeDbClusterBacktracksRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeDBClusterBacktracksIterable responses = client.describeDBClusterBacktracksPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeDBClusterBacktracksIterable responses = client .describeDBClusterBacktracksPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeDbClusterBacktracksResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeDBClusterBacktracksIterable responses = client.describeDBClusterBacktracksPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeDBClusterBacktracks(software.amazon.awssdk.services.rds.model.DescribeDbClusterBacktracksRequest)
operation.- Parameters:
describeDbClusterBacktracksRequest
-- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.DbClusterBacktrackNotFoundException
-BacktrackIdentifier
doesn't refer to an existing backtrack.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBClusterBacktracksPaginator
default DescribeDBClusterBacktracksIterable describeDBClusterBacktracksPaginator(Consumer<DescribeDbClusterBacktracksRequest.Builder> describeDbClusterBacktracksRequest) throws DbClusterNotFoundException, DbClusterBacktrackNotFoundException, AwsServiceException, SdkClientException, RdsException
This is a variant of
describeDBClusterBacktracks(software.amazon.awssdk.services.rds.model.DescribeDbClusterBacktracksRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeDBClusterBacktracksIterable responses = client.describeDBClusterBacktracksPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeDBClusterBacktracksIterable responses = client .describeDBClusterBacktracksPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeDbClusterBacktracksResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeDBClusterBacktracksIterable responses = client.describeDBClusterBacktracksPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeDBClusterBacktracks(software.amazon.awssdk.services.rds.model.DescribeDbClusterBacktracksRequest)
operation.
This is a convenience which creates an instance of the
DescribeDbClusterBacktracksRequest.Builder
avoiding the need to create one manually viaDescribeDbClusterBacktracksRequest.builder()
- Parameters:
describeDbClusterBacktracksRequest
- AConsumer
that will call methods onDescribeDbClusterBacktracksRequest.Builder
to create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.DbClusterBacktrackNotFoundException
-BacktrackIdentifier
doesn't refer to an existing backtrack.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBClusterEndpoints
default DescribeDbClusterEndpointsResponse describeDBClusterEndpoints(DescribeDbClusterEndpointsRequest describeDbClusterEndpointsRequest) throws DbClusterNotFoundException, AwsServiceException, SdkClientException, RdsException
Returns information about endpoints for an Amazon Aurora DB cluster.
This action only applies to Aurora DB clusters.
- Parameters:
describeDbClusterEndpointsRequest
-- Returns:
- Result of the DescribeDBClusterEndpoints operation returned by the service.
- Throws:
DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBClusterEndpoints
default DescribeDbClusterEndpointsResponse describeDBClusterEndpoints(Consumer<DescribeDbClusterEndpointsRequest.Builder> describeDbClusterEndpointsRequest) throws DbClusterNotFoundException, AwsServiceException, SdkClientException, RdsException
Returns information about endpoints for an Amazon Aurora DB cluster.
This action only applies to Aurora DB clusters.
This is a convenience which creates an instance of the
DescribeDbClusterEndpointsRequest.Builder
avoiding the need to create one manually viaDescribeDbClusterEndpointsRequest.builder()
- Parameters:
describeDbClusterEndpointsRequest
- AConsumer
that will call methods onDescribeDbClusterEndpointsRequest.Builder
to create a request.- Returns:
- Result of the DescribeDBClusterEndpoints operation returned by the service.
- Throws:
DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBClusterEndpoints
default DescribeDbClusterEndpointsResponse describeDBClusterEndpoints() throws DbClusterNotFoundException, AwsServiceException, SdkClientException, RdsException
Returns information about endpoints for an Amazon Aurora DB cluster.
This action only applies to Aurora DB clusters.
- Returns:
- Result of the DescribeDBClusterEndpoints operation returned by the service.
- Throws:
DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
describeDBClusterEndpoints(DescribeDbClusterEndpointsRequest)
, AWS API Documentation
-
describeDBClusterEndpointsPaginator
default DescribeDBClusterEndpointsIterable describeDBClusterEndpointsPaginator() throws DbClusterNotFoundException, AwsServiceException, SdkClientException, RdsException
This is a variant of
describeDBClusterEndpoints(software.amazon.awssdk.services.rds.model.DescribeDbClusterEndpointsRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeDBClusterEndpointsIterable responses = client.describeDBClusterEndpointsPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeDBClusterEndpointsIterable responses = client .describeDBClusterEndpointsPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeDbClusterEndpointsResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeDBClusterEndpointsIterable responses = client.describeDBClusterEndpointsPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeDBClusterEndpoints(software.amazon.awssdk.services.rds.model.DescribeDbClusterEndpointsRequest)
operation.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
describeDBClusterEndpointsPaginator(DescribeDbClusterEndpointsRequest)
, AWS API Documentation
-
describeDBClusterEndpointsPaginator
default DescribeDBClusterEndpointsIterable describeDBClusterEndpointsPaginator(DescribeDbClusterEndpointsRequest describeDbClusterEndpointsRequest) throws DbClusterNotFoundException, AwsServiceException, SdkClientException, RdsException
This is a variant of
describeDBClusterEndpoints(software.amazon.awssdk.services.rds.model.DescribeDbClusterEndpointsRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeDBClusterEndpointsIterable responses = client.describeDBClusterEndpointsPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeDBClusterEndpointsIterable responses = client .describeDBClusterEndpointsPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeDbClusterEndpointsResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeDBClusterEndpointsIterable responses = client.describeDBClusterEndpointsPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeDBClusterEndpoints(software.amazon.awssdk.services.rds.model.DescribeDbClusterEndpointsRequest)
operation.- Parameters:
describeDbClusterEndpointsRequest
-- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBClusterEndpointsPaginator
default DescribeDBClusterEndpointsIterable describeDBClusterEndpointsPaginator(Consumer<DescribeDbClusterEndpointsRequest.Builder> describeDbClusterEndpointsRequest) throws DbClusterNotFoundException, AwsServiceException, SdkClientException, RdsException
This is a variant of
describeDBClusterEndpoints(software.amazon.awssdk.services.rds.model.DescribeDbClusterEndpointsRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeDBClusterEndpointsIterable responses = client.describeDBClusterEndpointsPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeDBClusterEndpointsIterable responses = client .describeDBClusterEndpointsPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeDbClusterEndpointsResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeDBClusterEndpointsIterable responses = client.describeDBClusterEndpointsPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeDBClusterEndpoints(software.amazon.awssdk.services.rds.model.DescribeDbClusterEndpointsRequest)
operation.
This is a convenience which creates an instance of the
DescribeDbClusterEndpointsRequest.Builder
avoiding the need to create one manually viaDescribeDbClusterEndpointsRequest.builder()
- Parameters:
describeDbClusterEndpointsRequest
- AConsumer
that will call methods onDescribeDbClusterEndpointsRequest.Builder
to create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBClusterParameterGroups
default DescribeDbClusterParameterGroupsResponse describeDBClusterParameterGroups(DescribeDbClusterParameterGroupsRequest describeDbClusterParameterGroupsRequest) throws DbParameterGroupNotFoundException, AwsServiceException, SdkClientException, RdsException
Returns a list of
DBClusterParameterGroup
descriptions. If aDBClusterParameterGroupName
parameter is specified, the list will contain only the description of the specified DB cluster parameter group.For more information on Amazon Aurora, see What is Amazon Aurora? in the Amazon Aurora User Guide.
For more information on Multi-AZ DB clusters, see Multi-AZ DB cluster deployments in the Amazon RDS User Guide.
- Parameters:
describeDbClusterParameterGroupsRequest
-- Returns:
- Result of the DescribeDBClusterParameterGroups operation returned by the service.
- Throws:
DbParameterGroupNotFoundException
-DBParameterGroupName
doesn't refer to an existing DB parameter group.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBClusterParameterGroups
default DescribeDbClusterParameterGroupsResponse describeDBClusterParameterGroups(Consumer<DescribeDbClusterParameterGroupsRequest.Builder> describeDbClusterParameterGroupsRequest) throws DbParameterGroupNotFoundException, AwsServiceException, SdkClientException, RdsException
Returns a list of
DBClusterParameterGroup
descriptions. If aDBClusterParameterGroupName
parameter is specified, the list will contain only the description of the specified DB cluster parameter group.For more information on Amazon Aurora, see What is Amazon Aurora? in the Amazon Aurora User Guide.
For more information on Multi-AZ DB clusters, see Multi-AZ DB cluster deployments in the Amazon RDS User Guide.
This is a convenience which creates an instance of the
DescribeDbClusterParameterGroupsRequest.Builder
avoiding the need to create one manually viaDescribeDbClusterParameterGroupsRequest.builder()
- Parameters:
describeDbClusterParameterGroupsRequest
- AConsumer
that will call methods onDescribeDbClusterParameterGroupsRequest.Builder
to create a request.- Returns:
- Result of the DescribeDBClusterParameterGroups operation returned by the service.
- Throws:
DbParameterGroupNotFoundException
-DBParameterGroupName
doesn't refer to an existing DB parameter group.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBClusterParameterGroups
default DescribeDbClusterParameterGroupsResponse describeDBClusterParameterGroups() throws DbParameterGroupNotFoundException, AwsServiceException, SdkClientException, RdsException
Returns a list of
DBClusterParameterGroup
descriptions. If aDBClusterParameterGroupName
parameter is specified, the list will contain only the description of the specified DB cluster parameter group.For more information on Amazon Aurora, see What is Amazon Aurora? in the Amazon Aurora User Guide.
For more information on Multi-AZ DB clusters, see Multi-AZ DB cluster deployments in the Amazon RDS User Guide.
- Returns:
- Result of the DescribeDBClusterParameterGroups operation returned by the service.
- Throws:
DbParameterGroupNotFoundException
-DBParameterGroupName
doesn't refer to an existing DB parameter group.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
describeDBClusterParameterGroups(DescribeDbClusterParameterGroupsRequest)
, AWS API Documentation
-
describeDBClusterParameterGroupsPaginator
default DescribeDBClusterParameterGroupsIterable describeDBClusterParameterGroupsPaginator() throws DbParameterGroupNotFoundException, AwsServiceException, SdkClientException, RdsException
This is a variant of
describeDBClusterParameterGroups(software.amazon.awssdk.services.rds.model.DescribeDbClusterParameterGroupsRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeDBClusterParameterGroupsIterable responses = client.describeDBClusterParameterGroupsPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeDBClusterParameterGroupsIterable responses = client .describeDBClusterParameterGroupsPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeDbClusterParameterGroupsResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeDBClusterParameterGroupsIterable responses = client.describeDBClusterParameterGroupsPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeDBClusterParameterGroups(software.amazon.awssdk.services.rds.model.DescribeDbClusterParameterGroupsRequest)
operation.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
DbParameterGroupNotFoundException
-DBParameterGroupName
doesn't refer to an existing DB parameter group.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
describeDBClusterParameterGroupsPaginator(DescribeDbClusterParameterGroupsRequest)
, AWS API Documentation
-
describeDBClusterParameterGroupsPaginator
default DescribeDBClusterParameterGroupsIterable describeDBClusterParameterGroupsPaginator(DescribeDbClusterParameterGroupsRequest describeDbClusterParameterGroupsRequest) throws DbParameterGroupNotFoundException, AwsServiceException, SdkClientException, RdsException
This is a variant of
describeDBClusterParameterGroups(software.amazon.awssdk.services.rds.model.DescribeDbClusterParameterGroupsRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeDBClusterParameterGroupsIterable responses = client.describeDBClusterParameterGroupsPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeDBClusterParameterGroupsIterable responses = client .describeDBClusterParameterGroupsPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeDbClusterParameterGroupsResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeDBClusterParameterGroupsIterable responses = client.describeDBClusterParameterGroupsPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeDBClusterParameterGroups(software.amazon.awssdk.services.rds.model.DescribeDbClusterParameterGroupsRequest)
operation.- Parameters:
describeDbClusterParameterGroupsRequest
-- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
DbParameterGroupNotFoundException
-DBParameterGroupName
doesn't refer to an existing DB parameter group.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBClusterParameterGroupsPaginator
default DescribeDBClusterParameterGroupsIterable describeDBClusterParameterGroupsPaginator(Consumer<DescribeDbClusterParameterGroupsRequest.Builder> describeDbClusterParameterGroupsRequest) throws DbParameterGroupNotFoundException, AwsServiceException, SdkClientException, RdsException
This is a variant of
describeDBClusterParameterGroups(software.amazon.awssdk.services.rds.model.DescribeDbClusterParameterGroupsRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeDBClusterParameterGroupsIterable responses = client.describeDBClusterParameterGroupsPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeDBClusterParameterGroupsIterable responses = client .describeDBClusterParameterGroupsPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeDbClusterParameterGroupsResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeDBClusterParameterGroupsIterable responses = client.describeDBClusterParameterGroupsPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeDBClusterParameterGroups(software.amazon.awssdk.services.rds.model.DescribeDbClusterParameterGroupsRequest)
operation.
This is a convenience which creates an instance of the
DescribeDbClusterParameterGroupsRequest.Builder
avoiding the need to create one manually viaDescribeDbClusterParameterGroupsRequest.builder()
- Parameters:
describeDbClusterParameterGroupsRequest
- AConsumer
that will call methods onDescribeDbClusterParameterGroupsRequest.Builder
to create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
DbParameterGroupNotFoundException
-DBParameterGroupName
doesn't refer to an existing DB parameter group.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBClusterParameters
default DescribeDbClusterParametersResponse describeDBClusterParameters(DescribeDbClusterParametersRequest describeDbClusterParametersRequest) throws DbParameterGroupNotFoundException, AwsServiceException, SdkClientException, RdsException
Returns the detailed parameter list for a particular DB cluster parameter group.
For more information on Amazon Aurora, see What is Amazon Aurora? in the Amazon Aurora User Guide.
For more information on Multi-AZ DB clusters, see Multi-AZ DB cluster deployments in the Amazon RDS User Guide.
- Parameters:
describeDbClusterParametersRequest
-- Returns:
- Result of the DescribeDBClusterParameters operation returned by the service.
- Throws:
DbParameterGroupNotFoundException
-DBParameterGroupName
doesn't refer to an existing DB parameter group.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBClusterParameters
default DescribeDbClusterParametersResponse describeDBClusterParameters(Consumer<DescribeDbClusterParametersRequest.Builder> describeDbClusterParametersRequest) throws DbParameterGroupNotFoundException, AwsServiceException, SdkClientException, RdsException
Returns the detailed parameter list for a particular DB cluster parameter group.
For more information on Amazon Aurora, see What is Amazon Aurora? in the Amazon Aurora User Guide.
For more information on Multi-AZ DB clusters, see Multi-AZ DB cluster deployments in the Amazon RDS User Guide.
This is a convenience which creates an instance of the
DescribeDbClusterParametersRequest.Builder
avoiding the need to create one manually viaDescribeDbClusterParametersRequest.builder()
- Parameters:
describeDbClusterParametersRequest
- AConsumer
that will call methods onDescribeDbClusterParametersRequest.Builder
to create a request.- Returns:
- Result of the DescribeDBClusterParameters operation returned by the service.
- Throws:
DbParameterGroupNotFoundException
-DBParameterGroupName
doesn't refer to an existing DB parameter group.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBClusterParametersPaginator
default DescribeDBClusterParametersIterable describeDBClusterParametersPaginator(DescribeDbClusterParametersRequest describeDbClusterParametersRequest) throws DbParameterGroupNotFoundException, AwsServiceException, SdkClientException, RdsException
This is a variant of
describeDBClusterParameters(software.amazon.awssdk.services.rds.model.DescribeDbClusterParametersRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeDBClusterParametersIterable responses = client.describeDBClusterParametersPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeDBClusterParametersIterable responses = client .describeDBClusterParametersPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeDbClusterParametersResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeDBClusterParametersIterable responses = client.describeDBClusterParametersPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeDBClusterParameters(software.amazon.awssdk.services.rds.model.DescribeDbClusterParametersRequest)
operation.- Parameters:
describeDbClusterParametersRequest
-- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
DbParameterGroupNotFoundException
-DBParameterGroupName
doesn't refer to an existing DB parameter group.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBClusterParametersPaginator
default DescribeDBClusterParametersIterable describeDBClusterParametersPaginator(Consumer<DescribeDbClusterParametersRequest.Builder> describeDbClusterParametersRequest) throws DbParameterGroupNotFoundException, AwsServiceException, SdkClientException, RdsException
This is a variant of
describeDBClusterParameters(software.amazon.awssdk.services.rds.model.DescribeDbClusterParametersRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeDBClusterParametersIterable responses = client.describeDBClusterParametersPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeDBClusterParametersIterable responses = client .describeDBClusterParametersPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeDbClusterParametersResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeDBClusterParametersIterable responses = client.describeDBClusterParametersPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeDBClusterParameters(software.amazon.awssdk.services.rds.model.DescribeDbClusterParametersRequest)
operation.
This is a convenience which creates an instance of the
DescribeDbClusterParametersRequest.Builder
avoiding the need to create one manually viaDescribeDbClusterParametersRequest.builder()
- Parameters:
describeDbClusterParametersRequest
- AConsumer
that will call methods onDescribeDbClusterParametersRequest.Builder
to create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
DbParameterGroupNotFoundException
-DBParameterGroupName
doesn't refer to an existing DB parameter group.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBClusterSnapshotAttributes
default DescribeDbClusterSnapshotAttributesResponse describeDBClusterSnapshotAttributes(DescribeDbClusterSnapshotAttributesRequest describeDbClusterSnapshotAttributesRequest) throws DbClusterSnapshotNotFoundException, AwsServiceException, SdkClientException, RdsException
Returns a list of DB cluster snapshot attribute names and values for a manual DB cluster snapshot.
When sharing snapshots with other Amazon Web Services accounts,
DescribeDBClusterSnapshotAttributes
returns therestore
attribute and a list of IDs for the Amazon Web Services accounts that are authorized to copy or restore the manual DB cluster snapshot. Ifall
is included in the list of values for therestore
attribute, then the manual DB cluster snapshot is public and can be copied or restored by all Amazon Web Services accounts.To add or remove access for an Amazon Web Services account to copy or restore a manual DB cluster snapshot, or to make the manual DB cluster snapshot public or private, use the
ModifyDBClusterSnapshotAttribute
API action.- Parameters:
describeDbClusterSnapshotAttributesRequest
-- Returns:
- Result of the DescribeDBClusterSnapshotAttributes operation returned by the service.
- Throws:
DbClusterSnapshotNotFoundException
-DBClusterSnapshotIdentifier
doesn't refer to an existing DB cluster snapshot.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBClusterSnapshotAttributes
default DescribeDbClusterSnapshotAttributesResponse describeDBClusterSnapshotAttributes(Consumer<DescribeDbClusterSnapshotAttributesRequest.Builder> describeDbClusterSnapshotAttributesRequest) throws DbClusterSnapshotNotFoundException, AwsServiceException, SdkClientException, RdsException
Returns a list of DB cluster snapshot attribute names and values for a manual DB cluster snapshot.
When sharing snapshots with other Amazon Web Services accounts,
DescribeDBClusterSnapshotAttributes
returns therestore
attribute and a list of IDs for the Amazon Web Services accounts that are authorized to copy or restore the manual DB cluster snapshot. Ifall
is included in the list of values for therestore
attribute, then the manual DB cluster snapshot is public and can be copied or restored by all Amazon Web Services accounts.To add or remove access for an Amazon Web Services account to copy or restore a manual DB cluster snapshot, or to make the manual DB cluster snapshot public or private, use the
ModifyDBClusterSnapshotAttribute
API action.
This is a convenience which creates an instance of the
DescribeDbClusterSnapshotAttributesRequest.Builder
avoiding the need to create one manually viaDescribeDbClusterSnapshotAttributesRequest.builder()
- Parameters:
describeDbClusterSnapshotAttributesRequest
- AConsumer
that will call methods onDescribeDbClusterSnapshotAttributesRequest.Builder
to create a request.- Returns:
- Result of the DescribeDBClusterSnapshotAttributes operation returned by the service.
- Throws:
DbClusterSnapshotNotFoundException
-DBClusterSnapshotIdentifier
doesn't refer to an existing DB cluster snapshot.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBClusterSnapshots
default DescribeDbClusterSnapshotsResponse describeDBClusterSnapshots(DescribeDbClusterSnapshotsRequest describeDbClusterSnapshotsRequest) throws DbClusterSnapshotNotFoundException, AwsServiceException, SdkClientException, RdsException
Returns information about DB cluster snapshots. This API action supports pagination.
For more information on Amazon Aurora DB clusters, see What is Amazon Aurora? in the Amazon Aurora User Guide.
For more information on Multi-AZ DB clusters, see Multi-AZ DB cluster deployments in the Amazon RDS User Guide.
- Parameters:
describeDbClusterSnapshotsRequest
-- Returns:
- Result of the DescribeDBClusterSnapshots operation returned by the service.
- Throws:
DbClusterSnapshotNotFoundException
-DBClusterSnapshotIdentifier
doesn't refer to an existing DB cluster snapshot.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBClusterSnapshots
default DescribeDbClusterSnapshotsResponse describeDBClusterSnapshots(Consumer<DescribeDbClusterSnapshotsRequest.Builder> describeDbClusterSnapshotsRequest) throws DbClusterSnapshotNotFoundException, AwsServiceException, SdkClientException, RdsException
Returns information about DB cluster snapshots. This API action supports pagination.
For more information on Amazon Aurora DB clusters, see What is Amazon Aurora? in the Amazon Aurora User Guide.
For more information on Multi-AZ DB clusters, see Multi-AZ DB cluster deployments in the Amazon RDS User Guide.
This is a convenience which creates an instance of the
DescribeDbClusterSnapshotsRequest.Builder
avoiding the need to create one manually viaDescribeDbClusterSnapshotsRequest.builder()
- Parameters:
describeDbClusterSnapshotsRequest
- AConsumer
that will call methods onDescribeDbClusterSnapshotsRequest.Builder
to create a request.- Returns:
- Result of the DescribeDBClusterSnapshots operation returned by the service.
- Throws:
DbClusterSnapshotNotFoundException
-DBClusterSnapshotIdentifier
doesn't refer to an existing DB cluster snapshot.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBClusterSnapshots
default DescribeDbClusterSnapshotsResponse describeDBClusterSnapshots() throws DbClusterSnapshotNotFoundException, AwsServiceException, SdkClientException, RdsException
Returns information about DB cluster snapshots. This API action supports pagination.
For more information on Amazon Aurora DB clusters, see What is Amazon Aurora? in the Amazon Aurora User Guide.
For more information on Multi-AZ DB clusters, see Multi-AZ DB cluster deployments in the Amazon RDS User Guide.
- Returns:
- Result of the DescribeDBClusterSnapshots operation returned by the service.
- Throws:
DbClusterSnapshotNotFoundException
-DBClusterSnapshotIdentifier
doesn't refer to an existing DB cluster snapshot.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
describeDBClusterSnapshots(DescribeDbClusterSnapshotsRequest)
, AWS API Documentation
-
describeDBClusterSnapshotsPaginator
default DescribeDBClusterSnapshotsIterable describeDBClusterSnapshotsPaginator() throws DbClusterSnapshotNotFoundException, AwsServiceException, SdkClientException, RdsException
This is a variant of
describeDBClusterSnapshots(software.amazon.awssdk.services.rds.model.DescribeDbClusterSnapshotsRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeDBClusterSnapshotsIterable responses = client.describeDBClusterSnapshotsPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeDBClusterSnapshotsIterable responses = client .describeDBClusterSnapshotsPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeDbClusterSnapshotsResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeDBClusterSnapshotsIterable responses = client.describeDBClusterSnapshotsPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeDBClusterSnapshots(software.amazon.awssdk.services.rds.model.DescribeDbClusterSnapshotsRequest)
operation.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
DbClusterSnapshotNotFoundException
-DBClusterSnapshotIdentifier
doesn't refer to an existing DB cluster snapshot.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
describeDBClusterSnapshotsPaginator(DescribeDbClusterSnapshotsRequest)
, AWS API Documentation
-
describeDBClusterSnapshotsPaginator
default DescribeDBClusterSnapshotsIterable describeDBClusterSnapshotsPaginator(DescribeDbClusterSnapshotsRequest describeDbClusterSnapshotsRequest) throws DbClusterSnapshotNotFoundException, AwsServiceException, SdkClientException, RdsException
This is a variant of
describeDBClusterSnapshots(software.amazon.awssdk.services.rds.model.DescribeDbClusterSnapshotsRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeDBClusterSnapshotsIterable responses = client.describeDBClusterSnapshotsPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeDBClusterSnapshotsIterable responses = client .describeDBClusterSnapshotsPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeDbClusterSnapshotsResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeDBClusterSnapshotsIterable responses = client.describeDBClusterSnapshotsPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeDBClusterSnapshots(software.amazon.awssdk.services.rds.model.DescribeDbClusterSnapshotsRequest)
operation.- Parameters:
describeDbClusterSnapshotsRequest
-- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
DbClusterSnapshotNotFoundException
-DBClusterSnapshotIdentifier
doesn't refer to an existing DB cluster snapshot.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBClusterSnapshotsPaginator
default DescribeDBClusterSnapshotsIterable describeDBClusterSnapshotsPaginator(Consumer<DescribeDbClusterSnapshotsRequest.Builder> describeDbClusterSnapshotsRequest) throws DbClusterSnapshotNotFoundException, AwsServiceException, SdkClientException, RdsException
This is a variant of
describeDBClusterSnapshots(software.amazon.awssdk.services.rds.model.DescribeDbClusterSnapshotsRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeDBClusterSnapshotsIterable responses = client.describeDBClusterSnapshotsPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeDBClusterSnapshotsIterable responses = client .describeDBClusterSnapshotsPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeDbClusterSnapshotsResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeDBClusterSnapshotsIterable responses = client.describeDBClusterSnapshotsPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeDBClusterSnapshots(software.amazon.awssdk.services.rds.model.DescribeDbClusterSnapshotsRequest)
operation.
This is a convenience which creates an instance of the
DescribeDbClusterSnapshotsRequest.Builder
avoiding the need to create one manually viaDescribeDbClusterSnapshotsRequest.builder()
- Parameters:
describeDbClusterSnapshotsRequest
- AConsumer
that will call methods onDescribeDbClusterSnapshotsRequest.Builder
to create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
DbClusterSnapshotNotFoundException
-DBClusterSnapshotIdentifier
doesn't refer to an existing DB cluster snapshot.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBClusters
default DescribeDbClustersResponse describeDBClusters(DescribeDbClustersRequest describeDbClustersRequest) throws DbClusterNotFoundException, AwsServiceException, SdkClientException, RdsException
Describes existing Amazon Aurora DB clusters and Multi-AZ DB clusters. This API supports pagination.
For more information on Amazon Aurora DB clusters, see What is Amazon Aurora? in the Amazon Aurora User Guide.
For more information on Multi-AZ DB clusters, see Multi-AZ DB cluster deployments in the Amazon RDS User Guide.
This operation can also return information for Amazon Neptune DB instances and Amazon DocumentDB instances.
- Parameters:
describeDbClustersRequest
-- Returns:
- Result of the DescribeDBClusters operation returned by the service.
- Throws:
DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBClusters
default DescribeDbClustersResponse describeDBClusters(Consumer<DescribeDbClustersRequest.Builder> describeDbClustersRequest) throws DbClusterNotFoundException, AwsServiceException, SdkClientException, RdsException
Describes existing Amazon Aurora DB clusters and Multi-AZ DB clusters. This API supports pagination.
For more information on Amazon Aurora DB clusters, see What is Amazon Aurora? in the Amazon Aurora User Guide.
For more information on Multi-AZ DB clusters, see Multi-AZ DB cluster deployments in the Amazon RDS User Guide.
This operation can also return information for Amazon Neptune DB instances and Amazon DocumentDB instances.
This is a convenience which creates an instance of the
DescribeDbClustersRequest.Builder
avoiding the need to create one manually viaDescribeDbClustersRequest.builder()
- Parameters:
describeDbClustersRequest
- AConsumer
that will call methods onDescribeDbClustersRequest.Builder
to create a request.- Returns:
- Result of the DescribeDBClusters operation returned by the service.
- Throws:
DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBClusters
default DescribeDbClustersResponse describeDBClusters() throws DbClusterNotFoundException, AwsServiceException, SdkClientException, RdsException
Describes existing Amazon Aurora DB clusters and Multi-AZ DB clusters. This API supports pagination.
For more information on Amazon Aurora DB clusters, see What is Amazon Aurora? in the Amazon Aurora User Guide.
For more information on Multi-AZ DB clusters, see Multi-AZ DB cluster deployments in the Amazon RDS User Guide.
This operation can also return information for Amazon Neptune DB instances and Amazon DocumentDB instances.
- Returns:
- Result of the DescribeDBClusters operation returned by the service.
- Throws:
DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
describeDBClusters(DescribeDbClustersRequest)
, AWS API Documentation
-
describeDBClustersPaginator
default DescribeDBClustersIterable describeDBClustersPaginator() throws DbClusterNotFoundException, AwsServiceException, SdkClientException, RdsException
This is a variant of
describeDBClusters(software.amazon.awssdk.services.rds.model.DescribeDbClustersRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeDBClustersIterable responses = client.describeDBClustersPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeDBClustersIterable responses = client .describeDBClustersPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeDbClustersResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeDBClustersIterable responses = client.describeDBClustersPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeDBClusters(software.amazon.awssdk.services.rds.model.DescribeDbClustersRequest)
operation.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
describeDBClustersPaginator(DescribeDbClustersRequest)
, AWS API Documentation
-
describeDBClustersPaginator
default DescribeDBClustersIterable describeDBClustersPaginator(DescribeDbClustersRequest describeDbClustersRequest) throws DbClusterNotFoundException, AwsServiceException, SdkClientException, RdsException
This is a variant of
describeDBClusters(software.amazon.awssdk.services.rds.model.DescribeDbClustersRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeDBClustersIterable responses = client.describeDBClustersPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeDBClustersIterable responses = client .describeDBClustersPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeDbClustersResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeDBClustersIterable responses = client.describeDBClustersPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeDBClusters(software.amazon.awssdk.services.rds.model.DescribeDbClustersRequest)
operation.- Parameters:
describeDbClustersRequest
-- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBClustersPaginator
default DescribeDBClustersIterable describeDBClustersPaginator(Consumer<DescribeDbClustersRequest.Builder> describeDbClustersRequest) throws DbClusterNotFoundException, AwsServiceException, SdkClientException, RdsException
This is a variant of
describeDBClusters(software.amazon.awssdk.services.rds.model.DescribeDbClustersRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeDBClustersIterable responses = client.describeDBClustersPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeDBClustersIterable responses = client .describeDBClustersPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeDbClustersResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeDBClustersIterable responses = client.describeDBClustersPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeDBClusters(software.amazon.awssdk.services.rds.model.DescribeDbClustersRequest)
operation.
This is a convenience which creates an instance of the
DescribeDbClustersRequest.Builder
avoiding the need to create one manually viaDescribeDbClustersRequest.builder()
- Parameters:
describeDbClustersRequest
- AConsumer
that will call methods onDescribeDbClustersRequest.Builder
to create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBEngineVersions
default DescribeDbEngineVersionsResponse describeDBEngineVersions(DescribeDbEngineVersionsRequest describeDbEngineVersionsRequest) throws AwsServiceException, SdkClientException, RdsException
Describes the properties of specific versions of DB engines.
- Parameters:
describeDbEngineVersionsRequest
-- Returns:
- Result of the DescribeDBEngineVersions operation returned by the service.
- Throws:
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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBEngineVersions
default DescribeDbEngineVersionsResponse describeDBEngineVersions(Consumer<DescribeDbEngineVersionsRequest.Builder> describeDbEngineVersionsRequest) throws AwsServiceException, SdkClientException, RdsException
Describes the properties of specific versions of DB engines.
This is a convenience which creates an instance of the
DescribeDbEngineVersionsRequest.Builder
avoiding the need to create one manually viaDescribeDbEngineVersionsRequest.builder()
- Parameters:
describeDbEngineVersionsRequest
- AConsumer
that will call methods onDescribeDbEngineVersionsRequest.Builder
to create a request.- Returns:
- Result of the DescribeDBEngineVersions operation returned by the service.
- Throws:
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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBEngineVersions
default DescribeDbEngineVersionsResponse describeDBEngineVersions() throws AwsServiceException, SdkClientException, RdsException
Describes the properties of specific versions of DB engines.
- Returns:
- Result of the DescribeDBEngineVersions operation returned by the service.
- Throws:
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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
describeDBEngineVersions(DescribeDbEngineVersionsRequest)
, AWS API Documentation
-
describeDBEngineVersionsPaginator
default DescribeDBEngineVersionsIterable describeDBEngineVersionsPaginator() throws AwsServiceException, SdkClientException, RdsException
This is a variant of
describeDBEngineVersions(software.amazon.awssdk.services.rds.model.DescribeDbEngineVersionsRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeDBEngineVersionsIterable responses = client.describeDBEngineVersionsPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeDBEngineVersionsIterable responses = client .describeDBEngineVersionsPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeDbEngineVersionsResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeDBEngineVersionsIterable responses = client.describeDBEngineVersionsPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeDBEngineVersions(software.amazon.awssdk.services.rds.model.DescribeDbEngineVersionsRequest)
operation.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
describeDBEngineVersionsPaginator(DescribeDbEngineVersionsRequest)
, AWS API Documentation
-
describeDBEngineVersionsPaginator
default DescribeDBEngineVersionsIterable describeDBEngineVersionsPaginator(DescribeDbEngineVersionsRequest describeDbEngineVersionsRequest) throws AwsServiceException, SdkClientException, RdsException
This is a variant of
describeDBEngineVersions(software.amazon.awssdk.services.rds.model.DescribeDbEngineVersionsRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeDBEngineVersionsIterable responses = client.describeDBEngineVersionsPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeDBEngineVersionsIterable responses = client .describeDBEngineVersionsPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeDbEngineVersionsResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeDBEngineVersionsIterable responses = client.describeDBEngineVersionsPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeDBEngineVersions(software.amazon.awssdk.services.rds.model.DescribeDbEngineVersionsRequest)
operation.- Parameters:
describeDbEngineVersionsRequest
-- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBEngineVersionsPaginator
default DescribeDBEngineVersionsIterable describeDBEngineVersionsPaginator(Consumer<DescribeDbEngineVersionsRequest.Builder> describeDbEngineVersionsRequest) throws AwsServiceException, SdkClientException, RdsException
This is a variant of
describeDBEngineVersions(software.amazon.awssdk.services.rds.model.DescribeDbEngineVersionsRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeDBEngineVersionsIterable responses = client.describeDBEngineVersionsPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeDBEngineVersionsIterable responses = client .describeDBEngineVersionsPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeDbEngineVersionsResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeDBEngineVersionsIterable responses = client.describeDBEngineVersionsPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeDBEngineVersions(software.amazon.awssdk.services.rds.model.DescribeDbEngineVersionsRequest)
operation.
This is a convenience which creates an instance of the
DescribeDbEngineVersionsRequest.Builder
avoiding the need to create one manually viaDescribeDbEngineVersionsRequest.builder()
- Parameters:
describeDbEngineVersionsRequest
- AConsumer
that will call methods onDescribeDbEngineVersionsRequest.Builder
to create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBInstanceAutomatedBackups
default DescribeDbInstanceAutomatedBackupsResponse describeDBInstanceAutomatedBackups(DescribeDbInstanceAutomatedBackupsRequest describeDbInstanceAutomatedBackupsRequest) throws DbInstanceAutomatedBackupNotFoundException, AwsServiceException, SdkClientException, RdsException
Displays backups for both current and deleted instances. For example, use this operation to find details about automated backups for previously deleted instances. Current instances with retention periods greater than zero (0) are returned for both the
DescribeDBInstanceAutomatedBackups
andDescribeDBInstances
operations.All parameters are optional.
- Parameters:
describeDbInstanceAutomatedBackupsRequest
- Parameter input for DescribeDBInstanceAutomatedBackups.- Returns:
- Result of the DescribeDBInstanceAutomatedBackups operation returned by the service.
- Throws:
DbInstanceAutomatedBackupNotFoundException
- No automated backup for this DB instance was found.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBInstanceAutomatedBackups
default DescribeDbInstanceAutomatedBackupsResponse describeDBInstanceAutomatedBackups(Consumer<DescribeDbInstanceAutomatedBackupsRequest.Builder> describeDbInstanceAutomatedBackupsRequest) throws DbInstanceAutomatedBackupNotFoundException, AwsServiceException, SdkClientException, RdsException
Displays backups for both current and deleted instances. For example, use this operation to find details about automated backups for previously deleted instances. Current instances with retention periods greater than zero (0) are returned for both the
DescribeDBInstanceAutomatedBackups
andDescribeDBInstances
operations.All parameters are optional.
This is a convenience which creates an instance of the
DescribeDbInstanceAutomatedBackupsRequest.Builder
avoiding the need to create one manually viaDescribeDbInstanceAutomatedBackupsRequest.builder()
- Parameters:
describeDbInstanceAutomatedBackupsRequest
- AConsumer
that will call methods onDescribeDbInstanceAutomatedBackupsRequest.Builder
to create a request. Parameter input for DescribeDBInstanceAutomatedBackups.- Returns:
- Result of the DescribeDBInstanceAutomatedBackups operation returned by the service.
- Throws:
DbInstanceAutomatedBackupNotFoundException
- No automated backup for this DB instance was found.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBInstanceAutomatedBackups
default DescribeDbInstanceAutomatedBackupsResponse describeDBInstanceAutomatedBackups() throws DbInstanceAutomatedBackupNotFoundException, AwsServiceException, SdkClientException, RdsException
Displays backups for both current and deleted instances. For example, use this operation to find details about automated backups for previously deleted instances. Current instances with retention periods greater than zero (0) are returned for both the
DescribeDBInstanceAutomatedBackups
andDescribeDBInstances
operations.All parameters are optional.
- Returns:
- Result of the DescribeDBInstanceAutomatedBackups operation returned by the service.
- Throws:
DbInstanceAutomatedBackupNotFoundException
- No automated backup for this DB instance was found.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
describeDBInstanceAutomatedBackups(DescribeDbInstanceAutomatedBackupsRequest)
, AWS API Documentation
-
describeDBInstanceAutomatedBackupsPaginator
default DescribeDBInstanceAutomatedBackupsIterable describeDBInstanceAutomatedBackupsPaginator() throws DbInstanceAutomatedBackupNotFoundException, AwsServiceException, SdkClientException, RdsException
This is a variant of
describeDBInstanceAutomatedBackups(software.amazon.awssdk.services.rds.model.DescribeDbInstanceAutomatedBackupsRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeDBInstanceAutomatedBackupsIterable responses = client.describeDBInstanceAutomatedBackupsPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeDBInstanceAutomatedBackupsIterable responses = client .describeDBInstanceAutomatedBackupsPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeDbInstanceAutomatedBackupsResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeDBInstanceAutomatedBackupsIterable responses = client.describeDBInstanceAutomatedBackupsPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeDBInstanceAutomatedBackups(software.amazon.awssdk.services.rds.model.DescribeDbInstanceAutomatedBackupsRequest)
operation.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
DbInstanceAutomatedBackupNotFoundException
- No automated backup for this DB instance was found.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
describeDBInstanceAutomatedBackupsPaginator(DescribeDbInstanceAutomatedBackupsRequest)
, AWS API Documentation
-
describeDBInstanceAutomatedBackupsPaginator
default DescribeDBInstanceAutomatedBackupsIterable describeDBInstanceAutomatedBackupsPaginator(DescribeDbInstanceAutomatedBackupsRequest describeDbInstanceAutomatedBackupsRequest) throws DbInstanceAutomatedBackupNotFoundException, AwsServiceException, SdkClientException, RdsException
This is a variant of
describeDBInstanceAutomatedBackups(software.amazon.awssdk.services.rds.model.DescribeDbInstanceAutomatedBackupsRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeDBInstanceAutomatedBackupsIterable responses = client.describeDBInstanceAutomatedBackupsPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeDBInstanceAutomatedBackupsIterable responses = client .describeDBInstanceAutomatedBackupsPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeDbInstanceAutomatedBackupsResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeDBInstanceAutomatedBackupsIterable responses = client.describeDBInstanceAutomatedBackupsPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeDBInstanceAutomatedBackups(software.amazon.awssdk.services.rds.model.DescribeDbInstanceAutomatedBackupsRequest)
operation.- Parameters:
describeDbInstanceAutomatedBackupsRequest
- Parameter input for DescribeDBInstanceAutomatedBackups.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
DbInstanceAutomatedBackupNotFoundException
- No automated backup for this DB instance was found.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBInstanceAutomatedBackupsPaginator
default DescribeDBInstanceAutomatedBackupsIterable describeDBInstanceAutomatedBackupsPaginator(Consumer<DescribeDbInstanceAutomatedBackupsRequest.Builder> describeDbInstanceAutomatedBackupsRequest) throws DbInstanceAutomatedBackupNotFoundException, AwsServiceException, SdkClientException, RdsException
This is a variant of
describeDBInstanceAutomatedBackups(software.amazon.awssdk.services.rds.model.DescribeDbInstanceAutomatedBackupsRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeDBInstanceAutomatedBackupsIterable responses = client.describeDBInstanceAutomatedBackupsPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeDBInstanceAutomatedBackupsIterable responses = client .describeDBInstanceAutomatedBackupsPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeDbInstanceAutomatedBackupsResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeDBInstanceAutomatedBackupsIterable responses = client.describeDBInstanceAutomatedBackupsPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeDBInstanceAutomatedBackups(software.amazon.awssdk.services.rds.model.DescribeDbInstanceAutomatedBackupsRequest)
operation.
This is a convenience which creates an instance of the
DescribeDbInstanceAutomatedBackupsRequest.Builder
avoiding the need to create one manually viaDescribeDbInstanceAutomatedBackupsRequest.builder()
- Parameters:
describeDbInstanceAutomatedBackupsRequest
- AConsumer
that will call methods onDescribeDbInstanceAutomatedBackupsRequest.Builder
to create a request. Parameter input for DescribeDBInstanceAutomatedBackups.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
DbInstanceAutomatedBackupNotFoundException
- No automated backup for this DB instance was found.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBInstances
default DescribeDbInstancesResponse describeDBInstances(DescribeDbInstancesRequest describeDbInstancesRequest) throws DbInstanceNotFoundException, AwsServiceException, SdkClientException, RdsException
Describes provisioned RDS instances. This API supports pagination.
This operation can also return information for Amazon Neptune DB instances and Amazon DocumentDB instances.
- Parameters:
describeDbInstancesRequest
-- Returns:
- Result of the DescribeDBInstances operation returned by the service.
- Throws:
DbInstanceNotFoundException
-DBInstanceIdentifier
doesn't refer to an existing DB instance.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBInstances
default DescribeDbInstancesResponse describeDBInstances(Consumer<DescribeDbInstancesRequest.Builder> describeDbInstancesRequest) throws DbInstanceNotFoundException, AwsServiceException, SdkClientException, RdsException
Describes provisioned RDS instances. This API supports pagination.
This operation can also return information for Amazon Neptune DB instances and Amazon DocumentDB instances.
This is a convenience which creates an instance of the
DescribeDbInstancesRequest.Builder
avoiding the need to create one manually viaDescribeDbInstancesRequest.builder()
- Parameters:
describeDbInstancesRequest
- AConsumer
that will call methods onDescribeDbInstancesRequest.Builder
to create a request.- Returns:
- Result of the DescribeDBInstances operation returned by the service.
- Throws:
DbInstanceNotFoundException
-DBInstanceIdentifier
doesn't refer to an existing DB instance.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBInstances
default DescribeDbInstancesResponse describeDBInstances() throws DbInstanceNotFoundException, AwsServiceException, SdkClientException, RdsException
Describes provisioned RDS instances. This API supports pagination.
This operation can also return information for Amazon Neptune DB instances and Amazon DocumentDB instances.
- Returns:
- Result of the DescribeDBInstances operation returned by the service.
- Throws:
DbInstanceNotFoundException
-DBInstanceIdentifier
doesn't refer to an existing DB instance.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
describeDBInstances(DescribeDbInstancesRequest)
, AWS API Documentation
-
describeDBInstancesPaginator
default DescribeDBInstancesIterable describeDBInstancesPaginator() throws DbInstanceNotFoundException, AwsServiceException, SdkClientException, RdsException
This is a variant of
describeDBInstances(software.amazon.awssdk.services.rds.model.DescribeDbInstancesRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeDBInstancesIterable responses = client.describeDBInstancesPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeDBInstancesIterable responses = client .describeDBInstancesPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeDbInstancesResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeDBInstancesIterable responses = client.describeDBInstancesPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeDBInstances(software.amazon.awssdk.services.rds.model.DescribeDbInstancesRequest)
operation.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
DbInstanceNotFoundException
-DBInstanceIdentifier
doesn't refer to an existing DB instance.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
describeDBInstancesPaginator(DescribeDbInstancesRequest)
, AWS API Documentation
-
describeDBInstancesPaginator
default DescribeDBInstancesIterable describeDBInstancesPaginator(DescribeDbInstancesRequest describeDbInstancesRequest) throws DbInstanceNotFoundException, AwsServiceException, SdkClientException, RdsException
This is a variant of
describeDBInstances(software.amazon.awssdk.services.rds.model.DescribeDbInstancesRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeDBInstancesIterable responses = client.describeDBInstancesPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeDBInstancesIterable responses = client .describeDBInstancesPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeDbInstancesResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeDBInstancesIterable responses = client.describeDBInstancesPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeDBInstances(software.amazon.awssdk.services.rds.model.DescribeDbInstancesRequest)
operation.- Parameters:
describeDbInstancesRequest
-- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
DbInstanceNotFoundException
-DBInstanceIdentifier
doesn't refer to an existing DB instance.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBInstancesPaginator
default DescribeDBInstancesIterable describeDBInstancesPaginator(Consumer<DescribeDbInstancesRequest.Builder> describeDbInstancesRequest) throws DbInstanceNotFoundException, AwsServiceException, SdkClientException, RdsException
This is a variant of
describeDBInstances(software.amazon.awssdk.services.rds.model.DescribeDbInstancesRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeDBInstancesIterable responses = client.describeDBInstancesPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeDBInstancesIterable responses = client .describeDBInstancesPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeDbInstancesResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeDBInstancesIterable responses = client.describeDBInstancesPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeDBInstances(software.amazon.awssdk.services.rds.model.DescribeDbInstancesRequest)
operation.
This is a convenience which creates an instance of the
DescribeDbInstancesRequest.Builder
avoiding the need to create one manually viaDescribeDbInstancesRequest.builder()
- Parameters:
describeDbInstancesRequest
- AConsumer
that will call methods onDescribeDbInstancesRequest.Builder
to create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
DbInstanceNotFoundException
-DBInstanceIdentifier
doesn't refer to an existing DB instance.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBLogFiles
default DescribeDbLogFilesResponse describeDBLogFiles(DescribeDbLogFilesRequest describeDbLogFilesRequest) throws DbInstanceNotFoundException, AwsServiceException, SdkClientException, RdsException
Returns a list of DB log files for the DB instance.
This command doesn't apply to RDS Custom.
- Parameters:
describeDbLogFilesRequest
-- Returns:
- Result of the DescribeDBLogFiles operation returned by the service.
- Throws:
DbInstanceNotFoundException
-DBInstanceIdentifier
doesn't refer to an existing DB instance.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBLogFiles
default DescribeDbLogFilesResponse describeDBLogFiles(Consumer<DescribeDbLogFilesRequest.Builder> describeDbLogFilesRequest) throws DbInstanceNotFoundException, AwsServiceException, SdkClientException, RdsException
Returns a list of DB log files for the DB instance.
This command doesn't apply to RDS Custom.
This is a convenience which creates an instance of the
DescribeDbLogFilesRequest.Builder
avoiding the need to create one manually viaDescribeDbLogFilesRequest.builder()
- Parameters:
describeDbLogFilesRequest
- AConsumer
that will call methods onDescribeDbLogFilesRequest.Builder
to create a request.- Returns:
- Result of the DescribeDBLogFiles operation returned by the service.
- Throws:
DbInstanceNotFoundException
-DBInstanceIdentifier
doesn't refer to an existing DB instance.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBLogFilesPaginator
default DescribeDBLogFilesIterable describeDBLogFilesPaginator(DescribeDbLogFilesRequest describeDbLogFilesRequest) throws DbInstanceNotFoundException, AwsServiceException, SdkClientException, RdsException
This is a variant of
describeDBLogFiles(software.amazon.awssdk.services.rds.model.DescribeDbLogFilesRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeDBLogFilesIterable responses = client.describeDBLogFilesPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeDBLogFilesIterable responses = client .describeDBLogFilesPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeDbLogFilesResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeDBLogFilesIterable responses = client.describeDBLogFilesPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeDBLogFiles(software.amazon.awssdk.services.rds.model.DescribeDbLogFilesRequest)
operation.- Parameters:
describeDbLogFilesRequest
-- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
DbInstanceNotFoundException
-DBInstanceIdentifier
doesn't refer to an existing DB instance.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBLogFilesPaginator
default DescribeDBLogFilesIterable describeDBLogFilesPaginator(Consumer<DescribeDbLogFilesRequest.Builder> describeDbLogFilesRequest) throws DbInstanceNotFoundException, AwsServiceException, SdkClientException, RdsException
This is a variant of
describeDBLogFiles(software.amazon.awssdk.services.rds.model.DescribeDbLogFilesRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeDBLogFilesIterable responses = client.describeDBLogFilesPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeDBLogFilesIterable responses = client .describeDBLogFilesPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeDbLogFilesResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeDBLogFilesIterable responses = client.describeDBLogFilesPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeDBLogFiles(software.amazon.awssdk.services.rds.model.DescribeDbLogFilesRequest)
operation.
This is a convenience which creates an instance of the
DescribeDbLogFilesRequest.Builder
avoiding the need to create one manually viaDescribeDbLogFilesRequest.builder()
- Parameters:
describeDbLogFilesRequest
- AConsumer
that will call methods onDescribeDbLogFilesRequest.Builder
to create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
DbInstanceNotFoundException
-DBInstanceIdentifier
doesn't refer to an existing DB instance.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBParameterGroups
default DescribeDbParameterGroupsResponse describeDBParameterGroups(DescribeDbParameterGroupsRequest describeDbParameterGroupsRequest) throws DbParameterGroupNotFoundException, AwsServiceException, SdkClientException, RdsException
Returns a list of
DBParameterGroup
descriptions. If aDBParameterGroupName
is specified, the list will contain only the description of the specified DB parameter group.- Parameters:
describeDbParameterGroupsRequest
-- Returns:
- Result of the DescribeDBParameterGroups operation returned by the service.
- Throws:
DbParameterGroupNotFoundException
-DBParameterGroupName
doesn't refer to an existing DB parameter group.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBParameterGroups
default DescribeDbParameterGroupsResponse describeDBParameterGroups(Consumer<DescribeDbParameterGroupsRequest.Builder> describeDbParameterGroupsRequest) throws DbParameterGroupNotFoundException, AwsServiceException, SdkClientException, RdsException
Returns a list of
DBParameterGroup
descriptions. If aDBParameterGroupName
is specified, the list will contain only the description of the specified DB parameter group.
This is a convenience which creates an instance of the
DescribeDbParameterGroupsRequest.Builder
avoiding the need to create one manually viaDescribeDbParameterGroupsRequest.builder()
- Parameters:
describeDbParameterGroupsRequest
- AConsumer
that will call methods onDescribeDbParameterGroupsRequest.Builder
to create a request.- Returns:
- Result of the DescribeDBParameterGroups operation returned by the service.
- Throws:
DbParameterGroupNotFoundException
-DBParameterGroupName
doesn't refer to an existing DB parameter group.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBParameterGroups
default DescribeDbParameterGroupsResponse describeDBParameterGroups() throws DbParameterGroupNotFoundException, AwsServiceException, SdkClientException, RdsException
Returns a list of
DBParameterGroup
descriptions. If aDBParameterGroupName
is specified, the list will contain only the description of the specified DB parameter group.- Returns:
- Result of the DescribeDBParameterGroups operation returned by the service.
- Throws:
DbParameterGroupNotFoundException
-DBParameterGroupName
doesn't refer to an existing DB parameter group.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
describeDBParameterGroups(DescribeDbParameterGroupsRequest)
, AWS API Documentation
-
describeDBParameterGroupsPaginator
default DescribeDBParameterGroupsIterable describeDBParameterGroupsPaginator() throws DbParameterGroupNotFoundException, AwsServiceException, SdkClientException, RdsException
This is a variant of
describeDBParameterGroups(software.amazon.awssdk.services.rds.model.DescribeDbParameterGroupsRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeDBParameterGroupsIterable responses = client.describeDBParameterGroupsPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeDBParameterGroupsIterable responses = client .describeDBParameterGroupsPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeDbParameterGroupsResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeDBParameterGroupsIterable responses = client.describeDBParameterGroupsPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeDBParameterGroups(software.amazon.awssdk.services.rds.model.DescribeDbParameterGroupsRequest)
operation.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
DbParameterGroupNotFoundException
-DBParameterGroupName
doesn't refer to an existing DB parameter group.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
describeDBParameterGroupsPaginator(DescribeDbParameterGroupsRequest)
, AWS API Documentation
-
describeDBParameterGroupsPaginator
default DescribeDBParameterGroupsIterable describeDBParameterGroupsPaginator(DescribeDbParameterGroupsRequest describeDbParameterGroupsRequest) throws DbParameterGroupNotFoundException, AwsServiceException, SdkClientException, RdsException
This is a variant of
describeDBParameterGroups(software.amazon.awssdk.services.rds.model.DescribeDbParameterGroupsRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeDBParameterGroupsIterable responses = client.describeDBParameterGroupsPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeDBParameterGroupsIterable responses = client .describeDBParameterGroupsPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeDbParameterGroupsResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeDBParameterGroupsIterable responses = client.describeDBParameterGroupsPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeDBParameterGroups(software.amazon.awssdk.services.rds.model.DescribeDbParameterGroupsRequest)
operation.- Parameters:
describeDbParameterGroupsRequest
-- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
DbParameterGroupNotFoundException
-DBParameterGroupName
doesn't refer to an existing DB parameter group.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBParameterGroupsPaginator
default DescribeDBParameterGroupsIterable describeDBParameterGroupsPaginator(Consumer<DescribeDbParameterGroupsRequest.Builder> describeDbParameterGroupsRequest) throws DbParameterGroupNotFoundException, AwsServiceException, SdkClientException, RdsException
This is a variant of
describeDBParameterGroups(software.amazon.awssdk.services.rds.model.DescribeDbParameterGroupsRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeDBParameterGroupsIterable responses = client.describeDBParameterGroupsPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeDBParameterGroupsIterable responses = client .describeDBParameterGroupsPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeDbParameterGroupsResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeDBParameterGroupsIterable responses = client.describeDBParameterGroupsPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeDBParameterGroups(software.amazon.awssdk.services.rds.model.DescribeDbParameterGroupsRequest)
operation.
This is a convenience which creates an instance of the
DescribeDbParameterGroupsRequest.Builder
avoiding the need to create one manually viaDescribeDbParameterGroupsRequest.builder()
- Parameters:
describeDbParameterGroupsRequest
- AConsumer
that will call methods onDescribeDbParameterGroupsRequest.Builder
to create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
DbParameterGroupNotFoundException
-DBParameterGroupName
doesn't refer to an existing DB parameter group.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBParameters
default DescribeDbParametersResponse describeDBParameters(DescribeDbParametersRequest describeDbParametersRequest) throws DbParameterGroupNotFoundException, AwsServiceException, SdkClientException, RdsException
Returns the detailed parameter list for a particular DB parameter group.
- Parameters:
describeDbParametersRequest
-- Returns:
- Result of the DescribeDBParameters operation returned by the service.
- Throws:
DbParameterGroupNotFoundException
-DBParameterGroupName
doesn't refer to an existing DB parameter group.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBParameters
default DescribeDbParametersResponse describeDBParameters(Consumer<DescribeDbParametersRequest.Builder> describeDbParametersRequest) throws DbParameterGroupNotFoundException, AwsServiceException, SdkClientException, RdsException
Returns the detailed parameter list for a particular DB parameter group.
This is a convenience which creates an instance of the
DescribeDbParametersRequest.Builder
avoiding the need to create one manually viaDescribeDbParametersRequest.builder()
- Parameters:
describeDbParametersRequest
- AConsumer
that will call methods onDescribeDbParametersRequest.Builder
to create a request.- Returns:
- Result of the DescribeDBParameters operation returned by the service.
- Throws:
DbParameterGroupNotFoundException
-DBParameterGroupName
doesn't refer to an existing DB parameter group.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBParametersPaginator
default DescribeDBParametersIterable describeDBParametersPaginator(DescribeDbParametersRequest describeDbParametersRequest) throws DbParameterGroupNotFoundException, AwsServiceException, SdkClientException, RdsException
This is a variant of
describeDBParameters(software.amazon.awssdk.services.rds.model.DescribeDbParametersRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeDBParametersIterable responses = client.describeDBParametersPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeDBParametersIterable responses = client .describeDBParametersPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeDbParametersResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeDBParametersIterable responses = client.describeDBParametersPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeDBParameters(software.amazon.awssdk.services.rds.model.DescribeDbParametersRequest)
operation.- Parameters:
describeDbParametersRequest
-- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
DbParameterGroupNotFoundException
-DBParameterGroupName
doesn't refer to an existing DB parameter group.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBParametersPaginator
default DescribeDBParametersIterable describeDBParametersPaginator(Consumer<DescribeDbParametersRequest.Builder> describeDbParametersRequest) throws DbParameterGroupNotFoundException, AwsServiceException, SdkClientException, RdsException
This is a variant of
describeDBParameters(software.amazon.awssdk.services.rds.model.DescribeDbParametersRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeDBParametersIterable responses = client.describeDBParametersPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeDBParametersIterable responses = client .describeDBParametersPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeDbParametersResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeDBParametersIterable responses = client.describeDBParametersPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeDBParameters(software.amazon.awssdk.services.rds.model.DescribeDbParametersRequest)
operation.
This is a convenience which creates an instance of the
DescribeDbParametersRequest.Builder
avoiding the need to create one manually viaDescribeDbParametersRequest.builder()
- Parameters:
describeDbParametersRequest
- AConsumer
that will call methods onDescribeDbParametersRequest.Builder
to create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
DbParameterGroupNotFoundException
-DBParameterGroupName
doesn't refer to an existing DB parameter group.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBProxies
default DescribeDbProxiesResponse describeDBProxies(DescribeDbProxiesRequest describeDbProxiesRequest) throws DbProxyNotFoundException, AwsServiceException, SdkClientException, RdsException
Returns information about DB proxies.
- Parameters:
describeDbProxiesRequest
-- Returns:
- Result of the DescribeDBProxies operation returned by the service.
- Throws:
DbProxyNotFoundException
- The specified proxy name doesn't correspond to a proxy owned by your Amazon Web Services account in the specified Amazon Web Services Region.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBProxies
default DescribeDbProxiesResponse describeDBProxies(Consumer<DescribeDbProxiesRequest.Builder> describeDbProxiesRequest) throws DbProxyNotFoundException, AwsServiceException, SdkClientException, RdsException
Returns information about DB proxies.
This is a convenience which creates an instance of the
DescribeDbProxiesRequest.Builder
avoiding the need to create one manually viaDescribeDbProxiesRequest.builder()
- Parameters:
describeDbProxiesRequest
- AConsumer
that will call methods onDescribeDbProxiesRequest.Builder
to create a request.- Returns:
- Result of the DescribeDBProxies operation returned by the service.
- Throws:
DbProxyNotFoundException
- The specified proxy name doesn't correspond to a proxy owned by your Amazon Web Services account in the specified Amazon Web Services Region.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBProxiesPaginator
default DescribeDBProxiesIterable describeDBProxiesPaginator(DescribeDbProxiesRequest describeDbProxiesRequest) throws DbProxyNotFoundException, AwsServiceException, SdkClientException, RdsException
This is a variant of
describeDBProxies(software.amazon.awssdk.services.rds.model.DescribeDbProxiesRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeDBProxiesIterable responses = client.describeDBProxiesPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeDBProxiesIterable responses = client .describeDBProxiesPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeDbProxiesResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeDBProxiesIterable responses = client.describeDBProxiesPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeDBProxies(software.amazon.awssdk.services.rds.model.DescribeDbProxiesRequest)
operation.- Parameters:
describeDbProxiesRequest
-- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
DbProxyNotFoundException
- The specified proxy name doesn't correspond to a proxy owned by your Amazon Web Services account in the specified Amazon Web Services Region.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBProxiesPaginator
default DescribeDBProxiesIterable describeDBProxiesPaginator(Consumer<DescribeDbProxiesRequest.Builder> describeDbProxiesRequest) throws DbProxyNotFoundException, AwsServiceException, SdkClientException, RdsException
This is a variant of
describeDBProxies(software.amazon.awssdk.services.rds.model.DescribeDbProxiesRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeDBProxiesIterable responses = client.describeDBProxiesPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeDBProxiesIterable responses = client .describeDBProxiesPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeDbProxiesResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeDBProxiesIterable responses = client.describeDBProxiesPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeDBProxies(software.amazon.awssdk.services.rds.model.DescribeDbProxiesRequest)
operation.
This is a convenience which creates an instance of the
DescribeDbProxiesRequest.Builder
avoiding the need to create one manually viaDescribeDbProxiesRequest.builder()
- Parameters:
describeDbProxiesRequest
- AConsumer
that will call methods onDescribeDbProxiesRequest.Builder
to create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
DbProxyNotFoundException
- The specified proxy name doesn't correspond to a proxy owned by your Amazon Web Services account in the specified Amazon Web Services Region.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBProxyEndpoints
default DescribeDbProxyEndpointsResponse describeDBProxyEndpoints(DescribeDbProxyEndpointsRequest describeDbProxyEndpointsRequest) throws DbProxyNotFoundException, DbProxyEndpointNotFoundException, AwsServiceException, SdkClientException, RdsException
Returns information about DB proxy endpoints.
- Parameters:
describeDbProxyEndpointsRequest
-- Returns:
- Result of the DescribeDBProxyEndpoints operation returned by the service.
- Throws:
DbProxyNotFoundException
- The specified proxy name doesn't correspond to a proxy owned by your Amazon Web Services account in the specified Amazon Web Services Region.DbProxyEndpointNotFoundException
- The DB proxy endpoint doesn't exist.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBProxyEndpoints
default DescribeDbProxyEndpointsResponse describeDBProxyEndpoints(Consumer<DescribeDbProxyEndpointsRequest.Builder> describeDbProxyEndpointsRequest) throws DbProxyNotFoundException, DbProxyEndpointNotFoundException, AwsServiceException, SdkClientException, RdsException
Returns information about DB proxy endpoints.
This is a convenience which creates an instance of the
DescribeDbProxyEndpointsRequest.Builder
avoiding the need to create one manually viaDescribeDbProxyEndpointsRequest.builder()
- Parameters:
describeDbProxyEndpointsRequest
- AConsumer
that will call methods onDescribeDbProxyEndpointsRequest.Builder
to create a request.- Returns:
- Result of the DescribeDBProxyEndpoints operation returned by the service.
- Throws:
DbProxyNotFoundException
- The specified proxy name doesn't correspond to a proxy owned by your Amazon Web Services account in the specified Amazon Web Services Region.DbProxyEndpointNotFoundException
- The DB proxy endpoint doesn't exist.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBProxyEndpointsPaginator
default DescribeDBProxyEndpointsIterable describeDBProxyEndpointsPaginator(DescribeDbProxyEndpointsRequest describeDbProxyEndpointsRequest) throws DbProxyNotFoundException, DbProxyEndpointNotFoundException, AwsServiceException, SdkClientException, RdsException
This is a variant of
describeDBProxyEndpoints(software.amazon.awssdk.services.rds.model.DescribeDbProxyEndpointsRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeDBProxyEndpointsIterable responses = client.describeDBProxyEndpointsPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeDBProxyEndpointsIterable responses = client .describeDBProxyEndpointsPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeDbProxyEndpointsResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeDBProxyEndpointsIterable responses = client.describeDBProxyEndpointsPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeDBProxyEndpoints(software.amazon.awssdk.services.rds.model.DescribeDbProxyEndpointsRequest)
operation.- Parameters:
describeDbProxyEndpointsRequest
-- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
DbProxyNotFoundException
- The specified proxy name doesn't correspond to a proxy owned by your Amazon Web Services account in the specified Amazon Web Services Region.DbProxyEndpointNotFoundException
- The DB proxy endpoint doesn't exist.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBProxyEndpointsPaginator
default DescribeDBProxyEndpointsIterable describeDBProxyEndpointsPaginator(Consumer<DescribeDbProxyEndpointsRequest.Builder> describeDbProxyEndpointsRequest) throws DbProxyNotFoundException, DbProxyEndpointNotFoundException, AwsServiceException, SdkClientException, RdsException
This is a variant of
describeDBProxyEndpoints(software.amazon.awssdk.services.rds.model.DescribeDbProxyEndpointsRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeDBProxyEndpointsIterable responses = client.describeDBProxyEndpointsPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeDBProxyEndpointsIterable responses = client .describeDBProxyEndpointsPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeDbProxyEndpointsResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeDBProxyEndpointsIterable responses = client.describeDBProxyEndpointsPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeDBProxyEndpoints(software.amazon.awssdk.services.rds.model.DescribeDbProxyEndpointsRequest)
operation.
This is a convenience which creates an instance of the
DescribeDbProxyEndpointsRequest.Builder
avoiding the need to create one manually viaDescribeDbProxyEndpointsRequest.builder()
- Parameters:
describeDbProxyEndpointsRequest
- AConsumer
that will call methods onDescribeDbProxyEndpointsRequest.Builder
to create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
DbProxyNotFoundException
- The specified proxy name doesn't correspond to a proxy owned by your Amazon Web Services account in the specified Amazon Web Services Region.DbProxyEndpointNotFoundException
- The DB proxy endpoint doesn't exist.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBProxyTargetGroups
default DescribeDbProxyTargetGroupsResponse describeDBProxyTargetGroups(DescribeDbProxyTargetGroupsRequest describeDbProxyTargetGroupsRequest) throws DbProxyNotFoundException, DbProxyTargetGroupNotFoundException, InvalidDbProxyStateException, AwsServiceException, SdkClientException, RdsException
Returns information about DB proxy target groups, represented by
DBProxyTargetGroup
data structures.- Parameters:
describeDbProxyTargetGroupsRequest
-- Returns:
- Result of the DescribeDBProxyTargetGroups operation returned by the service.
- Throws:
DbProxyNotFoundException
- The specified proxy name doesn't correspond to a proxy owned by your Amazon Web Services account in the specified Amazon Web Services Region.DbProxyTargetGroupNotFoundException
- The specified target group isn't available for a proxy owned by your Amazon Web Services account in the specified Amazon Web Services Region.InvalidDbProxyStateException
- The requested operation can't be performed while the proxy is in this state.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBProxyTargetGroups
default DescribeDbProxyTargetGroupsResponse describeDBProxyTargetGroups(Consumer<DescribeDbProxyTargetGroupsRequest.Builder> describeDbProxyTargetGroupsRequest) throws DbProxyNotFoundException, DbProxyTargetGroupNotFoundException, InvalidDbProxyStateException, AwsServiceException, SdkClientException, RdsException
Returns information about DB proxy target groups, represented by
DBProxyTargetGroup
data structures.
This is a convenience which creates an instance of the
DescribeDbProxyTargetGroupsRequest.Builder
avoiding the need to create one manually viaDescribeDbProxyTargetGroupsRequest.builder()
- Parameters:
describeDbProxyTargetGroupsRequest
- AConsumer
that will call methods onDescribeDbProxyTargetGroupsRequest.Builder
to create a request.- Returns:
- Result of the DescribeDBProxyTargetGroups operation returned by the service.
- Throws:
DbProxyNotFoundException
- The specified proxy name doesn't correspond to a proxy owned by your Amazon Web Services account in the specified Amazon Web Services Region.DbProxyTargetGroupNotFoundException
- The specified target group isn't available for a proxy owned by your Amazon Web Services account in the specified Amazon Web Services Region.InvalidDbProxyStateException
- The requested operation can't be performed while the proxy is in this state.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBProxyTargetGroupsPaginator
default DescribeDBProxyTargetGroupsIterable describeDBProxyTargetGroupsPaginator(DescribeDbProxyTargetGroupsRequest describeDbProxyTargetGroupsRequest) throws DbProxyNotFoundException, DbProxyTargetGroupNotFoundException, InvalidDbProxyStateException, AwsServiceException, SdkClientException, RdsException
This is a variant of
describeDBProxyTargetGroups(software.amazon.awssdk.services.rds.model.DescribeDbProxyTargetGroupsRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeDBProxyTargetGroupsIterable responses = client.describeDBProxyTargetGroupsPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeDBProxyTargetGroupsIterable responses = client .describeDBProxyTargetGroupsPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeDbProxyTargetGroupsResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeDBProxyTargetGroupsIterable responses = client.describeDBProxyTargetGroupsPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeDBProxyTargetGroups(software.amazon.awssdk.services.rds.model.DescribeDbProxyTargetGroupsRequest)
operation.- Parameters:
describeDbProxyTargetGroupsRequest
-- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
DbProxyNotFoundException
- The specified proxy name doesn't correspond to a proxy owned by your Amazon Web Services account in the specified Amazon Web Services Region.DbProxyTargetGroupNotFoundException
- The specified target group isn't available for a proxy owned by your Amazon Web Services account in the specified Amazon Web Services Region.InvalidDbProxyStateException
- The requested operation can't be performed while the proxy is in this state.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBProxyTargetGroupsPaginator
default DescribeDBProxyTargetGroupsIterable describeDBProxyTargetGroupsPaginator(Consumer<DescribeDbProxyTargetGroupsRequest.Builder> describeDbProxyTargetGroupsRequest) throws DbProxyNotFoundException, DbProxyTargetGroupNotFoundException, InvalidDbProxyStateException, AwsServiceException, SdkClientException, RdsException
This is a variant of
describeDBProxyTargetGroups(software.amazon.awssdk.services.rds.model.DescribeDbProxyTargetGroupsRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeDBProxyTargetGroupsIterable responses = client.describeDBProxyTargetGroupsPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeDBProxyTargetGroupsIterable responses = client .describeDBProxyTargetGroupsPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeDbProxyTargetGroupsResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeDBProxyTargetGroupsIterable responses = client.describeDBProxyTargetGroupsPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeDBProxyTargetGroups(software.amazon.awssdk.services.rds.model.DescribeDbProxyTargetGroupsRequest)
operation.
This is a convenience which creates an instance of the
DescribeDbProxyTargetGroupsRequest.Builder
avoiding the need to create one manually viaDescribeDbProxyTargetGroupsRequest.builder()
- Parameters:
describeDbProxyTargetGroupsRequest
- AConsumer
that will call methods onDescribeDbProxyTargetGroupsRequest.Builder
to create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
DbProxyNotFoundException
- The specified proxy name doesn't correspond to a proxy owned by your Amazon Web Services account in the specified Amazon Web Services Region.DbProxyTargetGroupNotFoundException
- The specified target group isn't available for a proxy owned by your Amazon Web Services account in the specified Amazon Web Services Region.InvalidDbProxyStateException
- The requested operation can't be performed while the proxy is in this state.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBProxyTargets
default DescribeDbProxyTargetsResponse describeDBProxyTargets(DescribeDbProxyTargetsRequest describeDbProxyTargetsRequest) throws DbProxyNotFoundException, DbProxyTargetNotFoundException, DbProxyTargetGroupNotFoundException, InvalidDbProxyStateException, AwsServiceException, SdkClientException, RdsException
Returns information about
DBProxyTarget
objects. This API supports pagination.- Parameters:
describeDbProxyTargetsRequest
-- Returns:
- Result of the DescribeDBProxyTargets operation returned by the service.
- Throws:
DbProxyNotFoundException
- The specified proxy name doesn't correspond to a proxy owned by your Amazon Web Services account in the specified Amazon Web Services Region.DbProxyTargetNotFoundException
- The specified RDS DB instance or Aurora DB cluster isn't available for a proxy owned by your Amazon Web Services account in the specified Amazon Web Services Region.DbProxyTargetGroupNotFoundException
- The specified target group isn't available for a proxy owned by your Amazon Web Services account in the specified Amazon Web Services Region.InvalidDbProxyStateException
- The requested operation can't be performed while the proxy is in this state.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBProxyTargets
default DescribeDbProxyTargetsResponse describeDBProxyTargets(Consumer<DescribeDbProxyTargetsRequest.Builder> describeDbProxyTargetsRequest) throws DbProxyNotFoundException, DbProxyTargetNotFoundException, DbProxyTargetGroupNotFoundException, InvalidDbProxyStateException, AwsServiceException, SdkClientException, RdsException
Returns information about
DBProxyTarget
objects. This API supports pagination.
This is a convenience which creates an instance of the
DescribeDbProxyTargetsRequest.Builder
avoiding the need to create one manually viaDescribeDbProxyTargetsRequest.builder()
- Parameters:
describeDbProxyTargetsRequest
- AConsumer
that will call methods onDescribeDbProxyTargetsRequest.Builder
to create a request.- Returns:
- Result of the DescribeDBProxyTargets operation returned by the service.
- Throws:
DbProxyNotFoundException
- The specified proxy name doesn't correspond to a proxy owned by your Amazon Web Services account in the specified Amazon Web Services Region.DbProxyTargetNotFoundException
- The specified RDS DB instance or Aurora DB cluster isn't available for a proxy owned by your Amazon Web Services account in the specified Amazon Web Services Region.DbProxyTargetGroupNotFoundException
- The specified target group isn't available for a proxy owned by your Amazon Web Services account in the specified Amazon Web Services Region.InvalidDbProxyStateException
- The requested operation can't be performed while the proxy is in this state.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBProxyTargetsPaginator
default DescribeDBProxyTargetsIterable describeDBProxyTargetsPaginator(DescribeDbProxyTargetsRequest describeDbProxyTargetsRequest) throws DbProxyNotFoundException, DbProxyTargetNotFoundException, DbProxyTargetGroupNotFoundException, InvalidDbProxyStateException, AwsServiceException, SdkClientException, RdsException
This is a variant of
describeDBProxyTargets(software.amazon.awssdk.services.rds.model.DescribeDbProxyTargetsRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeDBProxyTargetsIterable responses = client.describeDBProxyTargetsPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeDBProxyTargetsIterable responses = client .describeDBProxyTargetsPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeDbProxyTargetsResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeDBProxyTargetsIterable responses = client.describeDBProxyTargetsPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeDBProxyTargets(software.amazon.awssdk.services.rds.model.DescribeDbProxyTargetsRequest)
operation.- Parameters:
describeDbProxyTargetsRequest
-- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
DbProxyNotFoundException
- The specified proxy name doesn't correspond to a proxy owned by your Amazon Web Services account in the specified Amazon Web Services Region.DbProxyTargetNotFoundException
- The specified RDS DB instance or Aurora DB cluster isn't available for a proxy owned by your Amazon Web Services account in the specified Amazon Web Services Region.DbProxyTargetGroupNotFoundException
- The specified target group isn't available for a proxy owned by your Amazon Web Services account in the specified Amazon Web Services Region.InvalidDbProxyStateException
- The requested operation can't be performed while the proxy is in this state.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBProxyTargetsPaginator
default DescribeDBProxyTargetsIterable describeDBProxyTargetsPaginator(Consumer<DescribeDbProxyTargetsRequest.Builder> describeDbProxyTargetsRequest) throws DbProxyNotFoundException, DbProxyTargetNotFoundException, DbProxyTargetGroupNotFoundException, InvalidDbProxyStateException, AwsServiceException, SdkClientException, RdsException
This is a variant of
describeDBProxyTargets(software.amazon.awssdk.services.rds.model.DescribeDbProxyTargetsRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeDBProxyTargetsIterable responses = client.describeDBProxyTargetsPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeDBProxyTargetsIterable responses = client .describeDBProxyTargetsPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeDbProxyTargetsResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeDBProxyTargetsIterable responses = client.describeDBProxyTargetsPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeDBProxyTargets(software.amazon.awssdk.services.rds.model.DescribeDbProxyTargetsRequest)
operation.
This is a convenience which creates an instance of the
DescribeDbProxyTargetsRequest.Builder
avoiding the need to create one manually viaDescribeDbProxyTargetsRequest.builder()
- Parameters:
describeDbProxyTargetsRequest
- AConsumer
that will call methods onDescribeDbProxyTargetsRequest.Builder
to create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
DbProxyNotFoundException
- The specified proxy name doesn't correspond to a proxy owned by your Amazon Web Services account in the specified Amazon Web Services Region.DbProxyTargetNotFoundException
- The specified RDS DB instance or Aurora DB cluster isn't available for a proxy owned by your Amazon Web Services account in the specified Amazon Web Services Region.DbProxyTargetGroupNotFoundException
- The specified target group isn't available for a proxy owned by your Amazon Web Services account in the specified Amazon Web Services Region.InvalidDbProxyStateException
- The requested operation can't be performed while the proxy is in this state.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBRecommendations
default DescribeDbRecommendationsResponse describeDBRecommendations(DescribeDbRecommendationsRequest describeDbRecommendationsRequest) throws AwsServiceException, SdkClientException, RdsException
Describes the recommendations to resolve the issues for your DB instances, DB clusters, and DB parameter groups.
- Parameters:
describeDbRecommendationsRequest
-- Returns:
- Result of the DescribeDBRecommendations operation returned by the service.
- Throws:
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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBRecommendations
default DescribeDbRecommendationsResponse describeDBRecommendations(Consumer<DescribeDbRecommendationsRequest.Builder> describeDbRecommendationsRequest) throws AwsServiceException, SdkClientException, RdsException
Describes the recommendations to resolve the issues for your DB instances, DB clusters, and DB parameter groups.
This is a convenience which creates an instance of the
DescribeDbRecommendationsRequest.Builder
avoiding the need to create one manually viaDescribeDbRecommendationsRequest.builder()
- Parameters:
describeDbRecommendationsRequest
- AConsumer
that will call methods onDescribeDbRecommendationsRequest.Builder
to create a request.- Returns:
- Result of the DescribeDBRecommendations operation returned by the service.
- Throws:
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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBRecommendationsPaginator
default DescribeDBRecommendationsIterable describeDBRecommendationsPaginator(DescribeDbRecommendationsRequest describeDbRecommendationsRequest) throws AwsServiceException, SdkClientException, RdsException
This is a variant of
describeDBRecommendations(software.amazon.awssdk.services.rds.model.DescribeDbRecommendationsRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeDBRecommendationsIterable responses = client.describeDBRecommendationsPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeDBRecommendationsIterable responses = client .describeDBRecommendationsPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeDbRecommendationsResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeDBRecommendationsIterable responses = client.describeDBRecommendationsPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeDBRecommendations(software.amazon.awssdk.services.rds.model.DescribeDbRecommendationsRequest)
operation.- Parameters:
describeDbRecommendationsRequest
-- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBRecommendationsPaginator
default DescribeDBRecommendationsIterable describeDBRecommendationsPaginator(Consumer<DescribeDbRecommendationsRequest.Builder> describeDbRecommendationsRequest) throws AwsServiceException, SdkClientException, RdsException
This is a variant of
describeDBRecommendations(software.amazon.awssdk.services.rds.model.DescribeDbRecommendationsRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeDBRecommendationsIterable responses = client.describeDBRecommendationsPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeDBRecommendationsIterable responses = client .describeDBRecommendationsPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeDbRecommendationsResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeDBRecommendationsIterable responses = client.describeDBRecommendationsPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeDBRecommendations(software.amazon.awssdk.services.rds.model.DescribeDbRecommendationsRequest)
operation.
This is a convenience which creates an instance of the
DescribeDbRecommendationsRequest.Builder
avoiding the need to create one manually viaDescribeDbRecommendationsRequest.builder()
- Parameters:
describeDbRecommendationsRequest
- AConsumer
that will call methods onDescribeDbRecommendationsRequest.Builder
to create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBSecurityGroups
default DescribeDbSecurityGroupsResponse describeDBSecurityGroups(DescribeDbSecurityGroupsRequest describeDbSecurityGroupsRequest) throws DbSecurityGroupNotFoundException, AwsServiceException, SdkClientException, RdsException
Returns a list of
DBSecurityGroup
descriptions. If aDBSecurityGroupName
is specified, the list will contain only the descriptions of the specified DB security group.EC2-Classic was retired on August 15, 2022. If you haven't migrated from EC2-Classic to a VPC, we recommend that you migrate as soon as possible. For more information, see Migrate from EC2-Classic to a VPC in the Amazon EC2 User Guide, the blog EC2-Classic Networking is Retiring – Here’s How to Prepare, and Moving a DB instance not in a VPC into a VPC in the Amazon RDS User Guide.
- Parameters:
describeDbSecurityGroupsRequest
-- Returns:
- Result of the DescribeDBSecurityGroups operation returned by the service.
- Throws:
DbSecurityGroupNotFoundException
-DBSecurityGroupName
doesn't refer to an existing DB security group.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBSecurityGroups
default DescribeDbSecurityGroupsResponse describeDBSecurityGroups(Consumer<DescribeDbSecurityGroupsRequest.Builder> describeDbSecurityGroupsRequest) throws DbSecurityGroupNotFoundException, AwsServiceException, SdkClientException, RdsException
Returns a list of
DBSecurityGroup
descriptions. If aDBSecurityGroupName
is specified, the list will contain only the descriptions of the specified DB security group.EC2-Classic was retired on August 15, 2022. If you haven't migrated from EC2-Classic to a VPC, we recommend that you migrate as soon as possible. For more information, see Migrate from EC2-Classic to a VPC in the Amazon EC2 User Guide, the blog EC2-Classic Networking is Retiring – Here’s How to Prepare, and Moving a DB instance not in a VPC into a VPC in the Amazon RDS User Guide.
This is a convenience which creates an instance of the
DescribeDbSecurityGroupsRequest.Builder
avoiding the need to create one manually viaDescribeDbSecurityGroupsRequest.builder()
- Parameters:
describeDbSecurityGroupsRequest
- AConsumer
that will call methods onDescribeDbSecurityGroupsRequest.Builder
to create a request.- Returns:
- Result of the DescribeDBSecurityGroups operation returned by the service.
- Throws:
DbSecurityGroupNotFoundException
-DBSecurityGroupName
doesn't refer to an existing DB security group.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBSecurityGroups
default DescribeDbSecurityGroupsResponse describeDBSecurityGroups() throws DbSecurityGroupNotFoundException, AwsServiceException, SdkClientException, RdsException
Returns a list of
DBSecurityGroup
descriptions. If aDBSecurityGroupName
is specified, the list will contain only the descriptions of the specified DB security group.EC2-Classic was retired on August 15, 2022. If you haven't migrated from EC2-Classic to a VPC, we recommend that you migrate as soon as possible. For more information, see Migrate from EC2-Classic to a VPC in the Amazon EC2 User Guide, the blog EC2-Classic Networking is Retiring – Here’s How to Prepare, and Moving a DB instance not in a VPC into a VPC in the Amazon RDS User Guide.
- Returns:
- Result of the DescribeDBSecurityGroups operation returned by the service.
- Throws:
DbSecurityGroupNotFoundException
-DBSecurityGroupName
doesn't refer to an existing DB security group.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
describeDBSecurityGroups(DescribeDbSecurityGroupsRequest)
, AWS API Documentation
-
describeDBSecurityGroupsPaginator
default DescribeDBSecurityGroupsIterable describeDBSecurityGroupsPaginator() throws DbSecurityGroupNotFoundException, AwsServiceException, SdkClientException, RdsException
This is a variant of
describeDBSecurityGroups(software.amazon.awssdk.services.rds.model.DescribeDbSecurityGroupsRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeDBSecurityGroupsIterable responses = client.describeDBSecurityGroupsPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeDBSecurityGroupsIterable responses = client .describeDBSecurityGroupsPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeDbSecurityGroupsResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeDBSecurityGroupsIterable responses = client.describeDBSecurityGroupsPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeDBSecurityGroups(software.amazon.awssdk.services.rds.model.DescribeDbSecurityGroupsRequest)
operation.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
DbSecurityGroupNotFoundException
-DBSecurityGroupName
doesn't refer to an existing DB security group.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
describeDBSecurityGroupsPaginator(DescribeDbSecurityGroupsRequest)
, AWS API Documentation
-
describeDBSecurityGroupsPaginator
default DescribeDBSecurityGroupsIterable describeDBSecurityGroupsPaginator(DescribeDbSecurityGroupsRequest describeDbSecurityGroupsRequest) throws DbSecurityGroupNotFoundException, AwsServiceException, SdkClientException, RdsException
This is a variant of
describeDBSecurityGroups(software.amazon.awssdk.services.rds.model.DescribeDbSecurityGroupsRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeDBSecurityGroupsIterable responses = client.describeDBSecurityGroupsPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeDBSecurityGroupsIterable responses = client .describeDBSecurityGroupsPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeDbSecurityGroupsResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeDBSecurityGroupsIterable responses = client.describeDBSecurityGroupsPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeDBSecurityGroups(software.amazon.awssdk.services.rds.model.DescribeDbSecurityGroupsRequest)
operation.- Parameters:
describeDbSecurityGroupsRequest
-- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
DbSecurityGroupNotFoundException
-DBSecurityGroupName
doesn't refer to an existing DB security group.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBSecurityGroupsPaginator
default DescribeDBSecurityGroupsIterable describeDBSecurityGroupsPaginator(Consumer<DescribeDbSecurityGroupsRequest.Builder> describeDbSecurityGroupsRequest) throws DbSecurityGroupNotFoundException, AwsServiceException, SdkClientException, RdsException
This is a variant of
describeDBSecurityGroups(software.amazon.awssdk.services.rds.model.DescribeDbSecurityGroupsRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeDBSecurityGroupsIterable responses = client.describeDBSecurityGroupsPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeDBSecurityGroupsIterable responses = client .describeDBSecurityGroupsPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeDbSecurityGroupsResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeDBSecurityGroupsIterable responses = client.describeDBSecurityGroupsPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeDBSecurityGroups(software.amazon.awssdk.services.rds.model.DescribeDbSecurityGroupsRequest)
operation.
This is a convenience which creates an instance of the
DescribeDbSecurityGroupsRequest.Builder
avoiding the need to create one manually viaDescribeDbSecurityGroupsRequest.builder()
- Parameters:
describeDbSecurityGroupsRequest
- AConsumer
that will call methods onDescribeDbSecurityGroupsRequest.Builder
to create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
DbSecurityGroupNotFoundException
-DBSecurityGroupName
doesn't refer to an existing DB security group.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBShardGroups
default DescribeDbShardGroupsResponse describeDBShardGroups(DescribeDbShardGroupsRequest describeDbShardGroupsRequest) throws DbShardGroupNotFoundException, DbClusterNotFoundException, AwsServiceException, SdkClientException, RdsException
Describes existing Aurora Limitless Database DB shard groups.
- Parameters:
describeDbShardGroupsRequest
-- Returns:
- Result of the DescribeDBShardGroups operation returned by the service.
- Throws:
DbShardGroupNotFoundException
- The specified DB shard group name wasn't found.DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBShardGroups
default DescribeDbShardGroupsResponse describeDBShardGroups(Consumer<DescribeDbShardGroupsRequest.Builder> describeDbShardGroupsRequest) throws DbShardGroupNotFoundException, DbClusterNotFoundException, AwsServiceException, SdkClientException, RdsException
Describes existing Aurora Limitless Database DB shard groups.
This is a convenience which creates an instance of the
DescribeDbShardGroupsRequest.Builder
avoiding the need to create one manually viaDescribeDbShardGroupsRequest.builder()
- Parameters:
describeDbShardGroupsRequest
- AConsumer
that will call methods onDescribeDbShardGroupsRequest.Builder
to create a request.- Returns:
- Result of the DescribeDBShardGroups operation returned by the service.
- Throws:
DbShardGroupNotFoundException
- The specified DB shard group name wasn't found.DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBSnapshotAttributes
default DescribeDbSnapshotAttributesResponse describeDBSnapshotAttributes(DescribeDbSnapshotAttributesRequest describeDbSnapshotAttributesRequest) throws DbSnapshotNotFoundException, AwsServiceException, SdkClientException, RdsException
Returns a list of DB snapshot attribute names and values for a manual DB snapshot.
When sharing snapshots with other Amazon Web Services accounts,
DescribeDBSnapshotAttributes
returns therestore
attribute and a list of IDs for the Amazon Web Services accounts that are authorized to copy or restore the manual DB snapshot. Ifall
is included in the list of values for therestore
attribute, then the manual DB snapshot is public and can be copied or restored by all Amazon Web Services accounts.To add or remove access for an Amazon Web Services account to copy or restore a manual DB snapshot, or to make the manual DB snapshot public or private, use the
ModifyDBSnapshotAttribute
API action.- Parameters:
describeDbSnapshotAttributesRequest
-- Returns:
- Result of the DescribeDBSnapshotAttributes operation returned by the service.
- Throws:
DbSnapshotNotFoundException
-DBSnapshotIdentifier
doesn't refer to an existing DB snapshot.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBSnapshotAttributes
default DescribeDbSnapshotAttributesResponse describeDBSnapshotAttributes(Consumer<DescribeDbSnapshotAttributesRequest.Builder> describeDbSnapshotAttributesRequest) throws DbSnapshotNotFoundException, AwsServiceException, SdkClientException, RdsException
Returns a list of DB snapshot attribute names and values for a manual DB snapshot.
When sharing snapshots with other Amazon Web Services accounts,
DescribeDBSnapshotAttributes
returns therestore
attribute and a list of IDs for the Amazon Web Services accounts that are authorized to copy or restore the manual DB snapshot. Ifall
is included in the list of values for therestore
attribute, then the manual DB snapshot is public and can be copied or restored by all Amazon Web Services accounts.To add or remove access for an Amazon Web Services account to copy or restore a manual DB snapshot, or to make the manual DB snapshot public or private, use the
ModifyDBSnapshotAttribute
API action.
This is a convenience which creates an instance of the
DescribeDbSnapshotAttributesRequest.Builder
avoiding the need to create one manually viaDescribeDbSnapshotAttributesRequest.builder()
- Parameters:
describeDbSnapshotAttributesRequest
- AConsumer
that will call methods onDescribeDbSnapshotAttributesRequest.Builder
to create a request.- Returns:
- Result of the DescribeDBSnapshotAttributes operation returned by the service.
- Throws:
DbSnapshotNotFoundException
-DBSnapshotIdentifier
doesn't refer to an existing DB snapshot.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBSnapshotTenantDatabases
default DescribeDbSnapshotTenantDatabasesResponse describeDBSnapshotTenantDatabases(DescribeDbSnapshotTenantDatabasesRequest describeDbSnapshotTenantDatabasesRequest) throws DbSnapshotNotFoundException, AwsServiceException, SdkClientException, RdsException
Describes the tenant databases that exist in a DB snapshot. This command only applies to RDS for Oracle DB instances in the multi-tenant configuration.
You can use this command to inspect the tenant databases within a snapshot before restoring it. You can't directly interact with the tenant databases in a DB snapshot. If you restore a snapshot that was taken from DB instance using the multi-tenant configuration, you restore all its tenant databases.
- Parameters:
describeDbSnapshotTenantDatabasesRequest
-- Returns:
- Result of the DescribeDBSnapshotTenantDatabases operation returned by the service.
- Throws:
DbSnapshotNotFoundException
-DBSnapshotIdentifier
doesn't refer to an existing DB snapshot.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBSnapshotTenantDatabases
default DescribeDbSnapshotTenantDatabasesResponse describeDBSnapshotTenantDatabases(Consumer<DescribeDbSnapshotTenantDatabasesRequest.Builder> describeDbSnapshotTenantDatabasesRequest) throws DbSnapshotNotFoundException, AwsServiceException, SdkClientException, RdsException
Describes the tenant databases that exist in a DB snapshot. This command only applies to RDS for Oracle DB instances in the multi-tenant configuration.
You can use this command to inspect the tenant databases within a snapshot before restoring it. You can't directly interact with the tenant databases in a DB snapshot. If you restore a snapshot that was taken from DB instance using the multi-tenant configuration, you restore all its tenant databases.
This is a convenience which creates an instance of the
DescribeDbSnapshotTenantDatabasesRequest.Builder
avoiding the need to create one manually viaDescribeDbSnapshotTenantDatabasesRequest.builder()
- Parameters:
describeDbSnapshotTenantDatabasesRequest
- AConsumer
that will call methods onDescribeDbSnapshotTenantDatabasesRequest.Builder
to create a request.- Returns:
- Result of the DescribeDBSnapshotTenantDatabases operation returned by the service.
- Throws:
DbSnapshotNotFoundException
-DBSnapshotIdentifier
doesn't refer to an existing DB snapshot.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBSnapshotTenantDatabasesPaginator
default DescribeDBSnapshotTenantDatabasesIterable describeDBSnapshotTenantDatabasesPaginator(DescribeDbSnapshotTenantDatabasesRequest describeDbSnapshotTenantDatabasesRequest) throws DbSnapshotNotFoundException, AwsServiceException, SdkClientException, RdsException
This is a variant of
describeDBSnapshotTenantDatabases(software.amazon.awssdk.services.rds.model.DescribeDbSnapshotTenantDatabasesRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeDBSnapshotTenantDatabasesIterable responses = client.describeDBSnapshotTenantDatabasesPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeDBSnapshotTenantDatabasesIterable responses = client .describeDBSnapshotTenantDatabasesPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeDbSnapshotTenantDatabasesResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeDBSnapshotTenantDatabasesIterable responses = client.describeDBSnapshotTenantDatabasesPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeDBSnapshotTenantDatabases(software.amazon.awssdk.services.rds.model.DescribeDbSnapshotTenantDatabasesRequest)
operation.- Parameters:
describeDbSnapshotTenantDatabasesRequest
-- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
DbSnapshotNotFoundException
-DBSnapshotIdentifier
doesn't refer to an existing DB snapshot.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBSnapshotTenantDatabasesPaginator
default DescribeDBSnapshotTenantDatabasesIterable describeDBSnapshotTenantDatabasesPaginator(Consumer<DescribeDbSnapshotTenantDatabasesRequest.Builder> describeDbSnapshotTenantDatabasesRequest) throws DbSnapshotNotFoundException, AwsServiceException, SdkClientException, RdsException
This is a variant of
describeDBSnapshotTenantDatabases(software.amazon.awssdk.services.rds.model.DescribeDbSnapshotTenantDatabasesRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeDBSnapshotTenantDatabasesIterable responses = client.describeDBSnapshotTenantDatabasesPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeDBSnapshotTenantDatabasesIterable responses = client .describeDBSnapshotTenantDatabasesPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeDbSnapshotTenantDatabasesResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeDBSnapshotTenantDatabasesIterable responses = client.describeDBSnapshotTenantDatabasesPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeDBSnapshotTenantDatabases(software.amazon.awssdk.services.rds.model.DescribeDbSnapshotTenantDatabasesRequest)
operation.
This is a convenience which creates an instance of the
DescribeDbSnapshotTenantDatabasesRequest.Builder
avoiding the need to create one manually viaDescribeDbSnapshotTenantDatabasesRequest.builder()
- Parameters:
describeDbSnapshotTenantDatabasesRequest
- AConsumer
that will call methods onDescribeDbSnapshotTenantDatabasesRequest.Builder
to create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
DbSnapshotNotFoundException
-DBSnapshotIdentifier
doesn't refer to an existing DB snapshot.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBSnapshots
default DescribeDbSnapshotsResponse describeDBSnapshots(DescribeDbSnapshotsRequest describeDbSnapshotsRequest) throws DbSnapshotNotFoundException, AwsServiceException, SdkClientException, RdsException
Returns information about DB snapshots. This API action supports pagination.
- Parameters:
describeDbSnapshotsRequest
-- Returns:
- Result of the DescribeDBSnapshots operation returned by the service.
- Throws:
DbSnapshotNotFoundException
-DBSnapshotIdentifier
doesn't refer to an existing DB snapshot.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBSnapshots
default DescribeDbSnapshotsResponse describeDBSnapshots(Consumer<DescribeDbSnapshotsRequest.Builder> describeDbSnapshotsRequest) throws DbSnapshotNotFoundException, AwsServiceException, SdkClientException, RdsException
Returns information about DB snapshots. This API action supports pagination.
This is a convenience which creates an instance of the
DescribeDbSnapshotsRequest.Builder
avoiding the need to create one manually viaDescribeDbSnapshotsRequest.builder()
- Parameters:
describeDbSnapshotsRequest
- AConsumer
that will call methods onDescribeDbSnapshotsRequest.Builder
to create a request.- Returns:
- Result of the DescribeDBSnapshots operation returned by the service.
- Throws:
DbSnapshotNotFoundException
-DBSnapshotIdentifier
doesn't refer to an existing DB snapshot.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBSnapshots
default DescribeDbSnapshotsResponse describeDBSnapshots() throws DbSnapshotNotFoundException, AwsServiceException, SdkClientException, RdsException
Returns information about DB snapshots. This API action supports pagination.
- Returns:
- Result of the DescribeDBSnapshots operation returned by the service.
- Throws:
DbSnapshotNotFoundException
-DBSnapshotIdentifier
doesn't refer to an existing DB snapshot.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
describeDBSnapshots(DescribeDbSnapshotsRequest)
, AWS API Documentation
-
describeDBSnapshotsPaginator
default DescribeDBSnapshotsIterable describeDBSnapshotsPaginator() throws DbSnapshotNotFoundException, AwsServiceException, SdkClientException, RdsException
This is a variant of
describeDBSnapshots(software.amazon.awssdk.services.rds.model.DescribeDbSnapshotsRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeDBSnapshotsIterable responses = client.describeDBSnapshotsPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeDBSnapshotsIterable responses = client .describeDBSnapshotsPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeDbSnapshotsResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeDBSnapshotsIterable responses = client.describeDBSnapshotsPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeDBSnapshots(software.amazon.awssdk.services.rds.model.DescribeDbSnapshotsRequest)
operation.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
DbSnapshotNotFoundException
-DBSnapshotIdentifier
doesn't refer to an existing DB snapshot.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
describeDBSnapshotsPaginator(DescribeDbSnapshotsRequest)
, AWS API Documentation
-
describeDBSnapshotsPaginator
default DescribeDBSnapshotsIterable describeDBSnapshotsPaginator(DescribeDbSnapshotsRequest describeDbSnapshotsRequest) throws DbSnapshotNotFoundException, AwsServiceException, SdkClientException, RdsException
This is a variant of
describeDBSnapshots(software.amazon.awssdk.services.rds.model.DescribeDbSnapshotsRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeDBSnapshotsIterable responses = client.describeDBSnapshotsPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeDBSnapshotsIterable responses = client .describeDBSnapshotsPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeDbSnapshotsResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeDBSnapshotsIterable responses = client.describeDBSnapshotsPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeDBSnapshots(software.amazon.awssdk.services.rds.model.DescribeDbSnapshotsRequest)
operation.- Parameters:
describeDbSnapshotsRequest
-- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
DbSnapshotNotFoundException
-DBSnapshotIdentifier
doesn't refer to an existing DB snapshot.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBSnapshotsPaginator
default DescribeDBSnapshotsIterable describeDBSnapshotsPaginator(Consumer<DescribeDbSnapshotsRequest.Builder> describeDbSnapshotsRequest) throws DbSnapshotNotFoundException, AwsServiceException, SdkClientException, RdsException
This is a variant of
describeDBSnapshots(software.amazon.awssdk.services.rds.model.DescribeDbSnapshotsRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeDBSnapshotsIterable responses = client.describeDBSnapshotsPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeDBSnapshotsIterable responses = client .describeDBSnapshotsPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeDbSnapshotsResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeDBSnapshotsIterable responses = client.describeDBSnapshotsPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeDBSnapshots(software.amazon.awssdk.services.rds.model.DescribeDbSnapshotsRequest)
operation.
This is a convenience which creates an instance of the
DescribeDbSnapshotsRequest.Builder
avoiding the need to create one manually viaDescribeDbSnapshotsRequest.builder()
- Parameters:
describeDbSnapshotsRequest
- AConsumer
that will call methods onDescribeDbSnapshotsRequest.Builder
to create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
DbSnapshotNotFoundException
-DBSnapshotIdentifier
doesn't refer to an existing DB snapshot.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBSubnetGroups
default DescribeDbSubnetGroupsResponse describeDBSubnetGroups(DescribeDbSubnetGroupsRequest describeDbSubnetGroupsRequest) throws DbSubnetGroupNotFoundException, AwsServiceException, SdkClientException, RdsException
Returns a list of DBSubnetGroup descriptions. If a DBSubnetGroupName is specified, the list will contain only the descriptions of the specified DBSubnetGroup.
For an overview of CIDR ranges, go to the Wikipedia Tutorial.
- Parameters:
describeDbSubnetGroupsRequest
-- Returns:
- Result of the DescribeDBSubnetGroups operation returned by the service.
- Throws:
DbSubnetGroupNotFoundException
-DBSubnetGroupName
doesn't refer to an existing DB subnet group.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBSubnetGroups
default DescribeDbSubnetGroupsResponse describeDBSubnetGroups(Consumer<DescribeDbSubnetGroupsRequest.Builder> describeDbSubnetGroupsRequest) throws DbSubnetGroupNotFoundException, AwsServiceException, SdkClientException, RdsException
Returns a list of DBSubnetGroup descriptions. If a DBSubnetGroupName is specified, the list will contain only the descriptions of the specified DBSubnetGroup.
For an overview of CIDR ranges, go to the Wikipedia Tutorial.
This is a convenience which creates an instance of the
DescribeDbSubnetGroupsRequest.Builder
avoiding the need to create one manually viaDescribeDbSubnetGroupsRequest.builder()
- Parameters:
describeDbSubnetGroupsRequest
- AConsumer
that will call methods onDescribeDbSubnetGroupsRequest.Builder
to create a request.- Returns:
- Result of the DescribeDBSubnetGroups operation returned by the service.
- Throws:
DbSubnetGroupNotFoundException
-DBSubnetGroupName
doesn't refer to an existing DB subnet group.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBSubnetGroups
default DescribeDbSubnetGroupsResponse describeDBSubnetGroups() throws DbSubnetGroupNotFoundException, AwsServiceException, SdkClientException, RdsException
Returns a list of DBSubnetGroup descriptions. If a DBSubnetGroupName is specified, the list will contain only the descriptions of the specified DBSubnetGroup.
For an overview of CIDR ranges, go to the Wikipedia Tutorial.
- Returns:
- Result of the DescribeDBSubnetGroups operation returned by the service.
- Throws:
DbSubnetGroupNotFoundException
-DBSubnetGroupName
doesn't refer to an existing DB subnet group.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
describeDBSubnetGroups(DescribeDbSubnetGroupsRequest)
, AWS API Documentation
-
describeDBSubnetGroupsPaginator
default DescribeDBSubnetGroupsIterable describeDBSubnetGroupsPaginator() throws DbSubnetGroupNotFoundException, AwsServiceException, SdkClientException, RdsException
This is a variant of
describeDBSubnetGroups(software.amazon.awssdk.services.rds.model.DescribeDbSubnetGroupsRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeDBSubnetGroupsIterable responses = client.describeDBSubnetGroupsPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeDBSubnetGroupsIterable responses = client .describeDBSubnetGroupsPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeDbSubnetGroupsResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeDBSubnetGroupsIterable responses = client.describeDBSubnetGroupsPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeDBSubnetGroups(software.amazon.awssdk.services.rds.model.DescribeDbSubnetGroupsRequest)
operation.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
DbSubnetGroupNotFoundException
-DBSubnetGroupName
doesn't refer to an existing DB subnet group.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
describeDBSubnetGroupsPaginator(DescribeDbSubnetGroupsRequest)
, AWS API Documentation
-
describeDBSubnetGroupsPaginator
default DescribeDBSubnetGroupsIterable describeDBSubnetGroupsPaginator(DescribeDbSubnetGroupsRequest describeDbSubnetGroupsRequest) throws DbSubnetGroupNotFoundException, AwsServiceException, SdkClientException, RdsException
This is a variant of
describeDBSubnetGroups(software.amazon.awssdk.services.rds.model.DescribeDbSubnetGroupsRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeDBSubnetGroupsIterable responses = client.describeDBSubnetGroupsPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeDBSubnetGroupsIterable responses = client .describeDBSubnetGroupsPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeDbSubnetGroupsResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeDBSubnetGroupsIterable responses = client.describeDBSubnetGroupsPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeDBSubnetGroups(software.amazon.awssdk.services.rds.model.DescribeDbSubnetGroupsRequest)
operation.- Parameters:
describeDbSubnetGroupsRequest
-- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
DbSubnetGroupNotFoundException
-DBSubnetGroupName
doesn't refer to an existing DB subnet group.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeDBSubnetGroupsPaginator
default DescribeDBSubnetGroupsIterable describeDBSubnetGroupsPaginator(Consumer<DescribeDbSubnetGroupsRequest.Builder> describeDbSubnetGroupsRequest) throws DbSubnetGroupNotFoundException, AwsServiceException, SdkClientException, RdsException
This is a variant of
describeDBSubnetGroups(software.amazon.awssdk.services.rds.model.DescribeDbSubnetGroupsRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeDBSubnetGroupsIterable responses = client.describeDBSubnetGroupsPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeDBSubnetGroupsIterable responses = client .describeDBSubnetGroupsPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeDbSubnetGroupsResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeDBSubnetGroupsIterable responses = client.describeDBSubnetGroupsPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeDBSubnetGroups(software.amazon.awssdk.services.rds.model.DescribeDbSubnetGroupsRequest)
operation.
This is a convenience which creates an instance of the
DescribeDbSubnetGroupsRequest.Builder
avoiding the need to create one manually viaDescribeDbSubnetGroupsRequest.builder()
- Parameters:
describeDbSubnetGroupsRequest
- AConsumer
that will call methods onDescribeDbSubnetGroupsRequest.Builder
to create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
DbSubnetGroupNotFoundException
-DBSubnetGroupName
doesn't refer to an existing DB subnet group.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeEngineDefaultClusterParameters
default DescribeEngineDefaultClusterParametersResponse describeEngineDefaultClusterParameters(DescribeEngineDefaultClusterParametersRequest describeEngineDefaultClusterParametersRequest) throws AwsServiceException, SdkClientException, RdsException
Returns the default engine and system parameter information for the cluster database engine.
For more information on Amazon Aurora, see What is Amazon Aurora? in the Amazon Aurora User Guide.
- Parameters:
describeEngineDefaultClusterParametersRequest
-- Returns:
- Result of the DescribeEngineDefaultClusterParameters operation returned by the service.
- Throws:
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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeEngineDefaultClusterParameters
default DescribeEngineDefaultClusterParametersResponse describeEngineDefaultClusterParameters(Consumer<DescribeEngineDefaultClusterParametersRequest.Builder> describeEngineDefaultClusterParametersRequest) throws AwsServiceException, SdkClientException, RdsException
Returns the default engine and system parameter information for the cluster database engine.
For more information on Amazon Aurora, see What is Amazon Aurora? in the Amazon Aurora User Guide.
This is a convenience which creates an instance of the
DescribeEngineDefaultClusterParametersRequest.Builder
avoiding the need to create one manually viaDescribeEngineDefaultClusterParametersRequest.builder()
- Parameters:
describeEngineDefaultClusterParametersRequest
- AConsumer
that will call methods onDescribeEngineDefaultClusterParametersRequest.Builder
to create a request.- Returns:
- Result of the DescribeEngineDefaultClusterParameters operation returned by the service.
- Throws:
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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeEngineDefaultParameters
default DescribeEngineDefaultParametersResponse describeEngineDefaultParameters(DescribeEngineDefaultParametersRequest describeEngineDefaultParametersRequest) throws AwsServiceException, SdkClientException, RdsException
Returns the default engine and system parameter information for the specified database engine.
- Parameters:
describeEngineDefaultParametersRequest
-- Returns:
- Result of the DescribeEngineDefaultParameters operation returned by the service.
- Throws:
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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeEngineDefaultParameters
default DescribeEngineDefaultParametersResponse describeEngineDefaultParameters(Consumer<DescribeEngineDefaultParametersRequest.Builder> describeEngineDefaultParametersRequest) throws AwsServiceException, SdkClientException, RdsException
Returns the default engine and system parameter information for the specified database engine.
This is a convenience which creates an instance of the
DescribeEngineDefaultParametersRequest.Builder
avoiding the need to create one manually viaDescribeEngineDefaultParametersRequest.builder()
- Parameters:
describeEngineDefaultParametersRequest
- AConsumer
that will call methods onDescribeEngineDefaultParametersRequest.Builder
to create a request.- Returns:
- Result of the DescribeEngineDefaultParameters operation returned by the service.
- Throws:
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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeEngineDefaultParametersPaginator
default DescribeEngineDefaultParametersIterable describeEngineDefaultParametersPaginator(DescribeEngineDefaultParametersRequest describeEngineDefaultParametersRequest) throws AwsServiceException, SdkClientException, RdsException
This is a variant of
describeEngineDefaultParameters(software.amazon.awssdk.services.rds.model.DescribeEngineDefaultParametersRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeEngineDefaultParametersIterable responses = client.describeEngineDefaultParametersPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeEngineDefaultParametersIterable responses = client .describeEngineDefaultParametersPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeEngineDefaultParametersResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeEngineDefaultParametersIterable responses = client.describeEngineDefaultParametersPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeEngineDefaultParameters(software.amazon.awssdk.services.rds.model.DescribeEngineDefaultParametersRequest)
operation.- Parameters:
describeEngineDefaultParametersRequest
-- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeEngineDefaultParametersPaginator
default DescribeEngineDefaultParametersIterable describeEngineDefaultParametersPaginator(Consumer<DescribeEngineDefaultParametersRequest.Builder> describeEngineDefaultParametersRequest) throws AwsServiceException, SdkClientException, RdsException
This is a variant of
describeEngineDefaultParameters(software.amazon.awssdk.services.rds.model.DescribeEngineDefaultParametersRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeEngineDefaultParametersIterable responses = client.describeEngineDefaultParametersPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeEngineDefaultParametersIterable responses = client .describeEngineDefaultParametersPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeEngineDefaultParametersResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeEngineDefaultParametersIterable responses = client.describeEngineDefaultParametersPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeEngineDefaultParameters(software.amazon.awssdk.services.rds.model.DescribeEngineDefaultParametersRequest)
operation.
This is a convenience which creates an instance of the
DescribeEngineDefaultParametersRequest.Builder
avoiding the need to create one manually viaDescribeEngineDefaultParametersRequest.builder()
- Parameters:
describeEngineDefaultParametersRequest
- AConsumer
that will call methods onDescribeEngineDefaultParametersRequest.Builder
to create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeEventCategories
default DescribeEventCategoriesResponse describeEventCategories(DescribeEventCategoriesRequest describeEventCategoriesRequest) throws AwsServiceException, SdkClientException, RdsException
Displays a list of categories for all event source types, or, if specified, for a specified source type. You can also see this list in the "Amazon RDS event categories and event messages" section of the Amazon RDS User Guide or the Amazon Aurora User Guide .
- Parameters:
describeEventCategoriesRequest
-- Returns:
- Result of the DescribeEventCategories operation returned by the service.
- Throws:
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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeEventCategories
default DescribeEventCategoriesResponse describeEventCategories(Consumer<DescribeEventCategoriesRequest.Builder> describeEventCategoriesRequest) throws AwsServiceException, SdkClientException, RdsException
Displays a list of categories for all event source types, or, if specified, for a specified source type. You can also see this list in the "Amazon RDS event categories and event messages" section of the Amazon RDS User Guide or the Amazon Aurora User Guide .
This is a convenience which creates an instance of the
DescribeEventCategoriesRequest.Builder
avoiding the need to create one manually viaDescribeEventCategoriesRequest.builder()
- Parameters:
describeEventCategoriesRequest
- AConsumer
that will call methods onDescribeEventCategoriesRequest.Builder
to create a request.- Returns:
- Result of the DescribeEventCategories operation returned by the service.
- Throws:
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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeEventCategories
default DescribeEventCategoriesResponse describeEventCategories() throws AwsServiceException, SdkClientException, RdsException
Displays a list of categories for all event source types, or, if specified, for a specified source type. You can also see this list in the "Amazon RDS event categories and event messages" section of the Amazon RDS User Guide or the Amazon Aurora User Guide .
- Returns:
- Result of the DescribeEventCategories operation returned by the service.
- Throws:
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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
describeEventCategories(DescribeEventCategoriesRequest)
, AWS API Documentation
-
describeEventSubscriptions
default DescribeEventSubscriptionsResponse describeEventSubscriptions(DescribeEventSubscriptionsRequest describeEventSubscriptionsRequest) throws SubscriptionNotFoundException, AwsServiceException, SdkClientException, RdsException
Lists all the subscription descriptions for a customer account. The description for a subscription includes
SubscriptionName
,SNSTopicARN
,CustomerID
,SourceType
,SourceID
,CreationTime
, andStatus
.If you specify a
SubscriptionName
, lists the description for that subscription.- Parameters:
describeEventSubscriptionsRequest
-- Returns:
- Result of the DescribeEventSubscriptions operation returned by the service.
- Throws:
SubscriptionNotFoundException
- The subscription name does not exist.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeEventSubscriptions
default DescribeEventSubscriptionsResponse describeEventSubscriptions(Consumer<DescribeEventSubscriptionsRequest.Builder> describeEventSubscriptionsRequest) throws SubscriptionNotFoundException, AwsServiceException, SdkClientException, RdsException
Lists all the subscription descriptions for a customer account. The description for a subscription includes
SubscriptionName
,SNSTopicARN
,CustomerID
,SourceType
,SourceID
,CreationTime
, andStatus
.If you specify a
SubscriptionName
, lists the description for that subscription.
This is a convenience which creates an instance of the
DescribeEventSubscriptionsRequest.Builder
avoiding the need to create one manually viaDescribeEventSubscriptionsRequest.builder()
- Parameters:
describeEventSubscriptionsRequest
- AConsumer
that will call methods onDescribeEventSubscriptionsRequest.Builder
to create a request.- Returns:
- Result of the DescribeEventSubscriptions operation returned by the service.
- Throws:
SubscriptionNotFoundException
- The subscription name does not exist.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeEventSubscriptions
default DescribeEventSubscriptionsResponse describeEventSubscriptions() throws SubscriptionNotFoundException, AwsServiceException, SdkClientException, RdsException
Lists all the subscription descriptions for a customer account. The description for a subscription includes
SubscriptionName
,SNSTopicARN
,CustomerID
,SourceType
,SourceID
,CreationTime
, andStatus
.If you specify a
SubscriptionName
, lists the description for that subscription.- Returns:
- Result of the DescribeEventSubscriptions operation returned by the service.
- Throws:
SubscriptionNotFoundException
- The subscription name does not exist.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
describeEventSubscriptions(DescribeEventSubscriptionsRequest)
, AWS API Documentation
-
describeEventSubscriptionsPaginator
default DescribeEventSubscriptionsIterable describeEventSubscriptionsPaginator() throws SubscriptionNotFoundException, AwsServiceException, SdkClientException, RdsException
This is a variant of
describeEventSubscriptions(software.amazon.awssdk.services.rds.model.DescribeEventSubscriptionsRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeEventSubscriptionsIterable responses = client.describeEventSubscriptionsPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeEventSubscriptionsIterable responses = client .describeEventSubscriptionsPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeEventSubscriptionsResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeEventSubscriptionsIterable responses = client.describeEventSubscriptionsPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeEventSubscriptions(software.amazon.awssdk.services.rds.model.DescribeEventSubscriptionsRequest)
operation.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
SubscriptionNotFoundException
- The subscription name does not exist.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
describeEventSubscriptionsPaginator(DescribeEventSubscriptionsRequest)
, AWS API Documentation
-
describeEventSubscriptionsPaginator
default DescribeEventSubscriptionsIterable describeEventSubscriptionsPaginator(DescribeEventSubscriptionsRequest describeEventSubscriptionsRequest) throws SubscriptionNotFoundException, AwsServiceException, SdkClientException, RdsException
This is a variant of
describeEventSubscriptions(software.amazon.awssdk.services.rds.model.DescribeEventSubscriptionsRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeEventSubscriptionsIterable responses = client.describeEventSubscriptionsPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeEventSubscriptionsIterable responses = client .describeEventSubscriptionsPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeEventSubscriptionsResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeEventSubscriptionsIterable responses = client.describeEventSubscriptionsPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeEventSubscriptions(software.amazon.awssdk.services.rds.model.DescribeEventSubscriptionsRequest)
operation.- Parameters:
describeEventSubscriptionsRequest
-- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
SubscriptionNotFoundException
- The subscription name does not exist.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeEventSubscriptionsPaginator
default DescribeEventSubscriptionsIterable describeEventSubscriptionsPaginator(Consumer<DescribeEventSubscriptionsRequest.Builder> describeEventSubscriptionsRequest) throws SubscriptionNotFoundException, AwsServiceException, SdkClientException, RdsException
This is a variant of
describeEventSubscriptions(software.amazon.awssdk.services.rds.model.DescribeEventSubscriptionsRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeEventSubscriptionsIterable responses = client.describeEventSubscriptionsPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeEventSubscriptionsIterable responses = client .describeEventSubscriptionsPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeEventSubscriptionsResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeEventSubscriptionsIterable responses = client.describeEventSubscriptionsPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeEventSubscriptions(software.amazon.awssdk.services.rds.model.DescribeEventSubscriptionsRequest)
operation.
This is a convenience which creates an instance of the
DescribeEventSubscriptionsRequest.Builder
avoiding the need to create one manually viaDescribeEventSubscriptionsRequest.builder()
- Parameters:
describeEventSubscriptionsRequest
- AConsumer
that will call methods onDescribeEventSubscriptionsRequest.Builder
to create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
SubscriptionNotFoundException
- The subscription name does not exist.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeEvents
default DescribeEventsResponse describeEvents(DescribeEventsRequest describeEventsRequest) throws AwsServiceException, SdkClientException, RdsException
Returns events related to DB instances, DB clusters, DB parameter groups, DB security groups, DB snapshots, DB cluster snapshots, and RDS Proxies for the past 14 days. Events specific to a particular DB instance, DB cluster, DB parameter group, DB security group, DB snapshot, DB cluster snapshot group, or RDS Proxy can be obtained by providing the name as a parameter.
For more information on working with events, see Monitoring Amazon RDS events in the Amazon RDS User Guide and Monitoring Amazon Aurora events in the Amazon Aurora User Guide.
By default, RDS returns events that were generated in the past hour.
- Parameters:
describeEventsRequest
-- Returns:
- Result of the DescribeEvents operation returned by the service.
- Throws:
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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeEvents
default DescribeEventsResponse describeEvents(Consumer<DescribeEventsRequest.Builder> describeEventsRequest) throws AwsServiceException, SdkClientException, RdsException
Returns events related to DB instances, DB clusters, DB parameter groups, DB security groups, DB snapshots, DB cluster snapshots, and RDS Proxies for the past 14 days. Events specific to a particular DB instance, DB cluster, DB parameter group, DB security group, DB snapshot, DB cluster snapshot group, or RDS Proxy can be obtained by providing the name as a parameter.
For more information on working with events, see Monitoring Amazon RDS events in the Amazon RDS User Guide and Monitoring Amazon Aurora events in the Amazon Aurora User Guide.
By default, RDS returns events that were generated in the past hour.
This is a convenience which creates an instance of the
DescribeEventsRequest.Builder
avoiding the need to create one manually viaDescribeEventsRequest.builder()
- Parameters:
describeEventsRequest
- AConsumer
that will call methods onDescribeEventsRequest.Builder
to create a request.- Returns:
- Result of the DescribeEvents operation returned by the service.
- Throws:
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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeEvents
default DescribeEventsResponse describeEvents() throws AwsServiceException, SdkClientException, RdsException
Returns events related to DB instances, DB clusters, DB parameter groups, DB security groups, DB snapshots, DB cluster snapshots, and RDS Proxies for the past 14 days. Events specific to a particular DB instance, DB cluster, DB parameter group, DB security group, DB snapshot, DB cluster snapshot group, or RDS Proxy can be obtained by providing the name as a parameter.
For more information on working with events, see Monitoring Amazon RDS events in the Amazon RDS User Guide and Monitoring Amazon Aurora events in the Amazon Aurora User Guide.
By default, RDS returns events that were generated in the past hour.
- Returns:
- Result of the DescribeEvents operation returned by the service.
- Throws:
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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
describeEvents(DescribeEventsRequest)
, AWS API Documentation
-
describeEventsPaginator
default DescribeEventsIterable describeEventsPaginator() throws AwsServiceException, SdkClientException, RdsException
This is a variant of
describeEvents(software.amazon.awssdk.services.rds.model.DescribeEventsRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeEventsIterable responses = client.describeEventsPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeEventsIterable responses = client.describeEventsPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeEventsResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeEventsIterable responses = client.describeEventsPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeEvents(software.amazon.awssdk.services.rds.model.DescribeEventsRequest)
operation.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
describeEventsPaginator(DescribeEventsRequest)
, AWS API Documentation
-
describeEventsPaginator
default DescribeEventsIterable describeEventsPaginator(DescribeEventsRequest describeEventsRequest) throws AwsServiceException, SdkClientException, RdsException
This is a variant of
describeEvents(software.amazon.awssdk.services.rds.model.DescribeEventsRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeEventsIterable responses = client.describeEventsPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeEventsIterable responses = client.describeEventsPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeEventsResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeEventsIterable responses = client.describeEventsPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeEvents(software.amazon.awssdk.services.rds.model.DescribeEventsRequest)
operation.- Parameters:
describeEventsRequest
-- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeEventsPaginator
default DescribeEventsIterable describeEventsPaginator(Consumer<DescribeEventsRequest.Builder> describeEventsRequest) throws AwsServiceException, SdkClientException, RdsException
This is a variant of
describeEvents(software.amazon.awssdk.services.rds.model.DescribeEventsRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeEventsIterable responses = client.describeEventsPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeEventsIterable responses = client.describeEventsPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeEventsResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeEventsIterable responses = client.describeEventsPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeEvents(software.amazon.awssdk.services.rds.model.DescribeEventsRequest)
operation.
This is a convenience which creates an instance of the
DescribeEventsRequest.Builder
avoiding the need to create one manually viaDescribeEventsRequest.builder()
- Parameters:
describeEventsRequest
- AConsumer
that will call methods onDescribeEventsRequest.Builder
to create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeExportTasks
default DescribeExportTasksResponse describeExportTasks(DescribeExportTasksRequest describeExportTasksRequest) throws ExportTaskNotFoundException, AwsServiceException, SdkClientException, RdsException
Returns information about a snapshot or cluster export to Amazon S3. This API operation supports pagination.
- Parameters:
describeExportTasksRequest
-- Returns:
- Result of the DescribeExportTasks operation returned by the service.
- Throws:
ExportTaskNotFoundException
- The export task doesn't exist.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeExportTasks
default DescribeExportTasksResponse describeExportTasks(Consumer<DescribeExportTasksRequest.Builder> describeExportTasksRequest) throws ExportTaskNotFoundException, AwsServiceException, SdkClientException, RdsException
Returns information about a snapshot or cluster export to Amazon S3. This API operation supports pagination.
This is a convenience which creates an instance of the
DescribeExportTasksRequest.Builder
avoiding the need to create one manually viaDescribeExportTasksRequest.builder()
- Parameters:
describeExportTasksRequest
- AConsumer
that will call methods onDescribeExportTasksRequest.Builder
to create a request.- Returns:
- Result of the DescribeExportTasks operation returned by the service.
- Throws:
ExportTaskNotFoundException
- The export task doesn't exist.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeExportTasksPaginator
default DescribeExportTasksIterable describeExportTasksPaginator(DescribeExportTasksRequest describeExportTasksRequest) throws ExportTaskNotFoundException, AwsServiceException, SdkClientException, RdsException
This is a variant of
describeExportTasks(software.amazon.awssdk.services.rds.model.DescribeExportTasksRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeExportTasksIterable responses = client.describeExportTasksPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeExportTasksIterable responses = client .describeExportTasksPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeExportTasksResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeExportTasksIterable responses = client.describeExportTasksPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeExportTasks(software.amazon.awssdk.services.rds.model.DescribeExportTasksRequest)
operation.- Parameters:
describeExportTasksRequest
-- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
ExportTaskNotFoundException
- The export task doesn't exist.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeExportTasksPaginator
default DescribeExportTasksIterable describeExportTasksPaginator(Consumer<DescribeExportTasksRequest.Builder> describeExportTasksRequest) throws ExportTaskNotFoundException, AwsServiceException, SdkClientException, RdsException
This is a variant of
describeExportTasks(software.amazon.awssdk.services.rds.model.DescribeExportTasksRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeExportTasksIterable responses = client.describeExportTasksPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeExportTasksIterable responses = client .describeExportTasksPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeExportTasksResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeExportTasksIterable responses = client.describeExportTasksPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeExportTasks(software.amazon.awssdk.services.rds.model.DescribeExportTasksRequest)
operation.
This is a convenience which creates an instance of the
DescribeExportTasksRequest.Builder
avoiding the need to create one manually viaDescribeExportTasksRequest.builder()
- Parameters:
describeExportTasksRequest
- AConsumer
that will call methods onDescribeExportTasksRequest.Builder
to create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
ExportTaskNotFoundException
- The export task doesn't exist.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeGlobalClusters
default DescribeGlobalClustersResponse describeGlobalClusters(DescribeGlobalClustersRequest describeGlobalClustersRequest) throws GlobalClusterNotFoundException, AwsServiceException, SdkClientException, RdsException
Returns information about Aurora global database clusters. This API supports pagination.
For more information on Amazon Aurora, see What is Amazon Aurora? in the Amazon Aurora User Guide.
This action only applies to Aurora DB clusters.
- Parameters:
describeGlobalClustersRequest
-- Returns:
- Result of the DescribeGlobalClusters operation returned by the service.
- Throws:
GlobalClusterNotFoundException
- TheGlobalClusterIdentifier
doesn't refer to an existing global database cluster.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeGlobalClusters
default DescribeGlobalClustersResponse describeGlobalClusters(Consumer<DescribeGlobalClustersRequest.Builder> describeGlobalClustersRequest) throws GlobalClusterNotFoundException, AwsServiceException, SdkClientException, RdsException
Returns information about Aurora global database clusters. This API supports pagination.
For more information on Amazon Aurora, see What is Amazon Aurora? in the Amazon Aurora User Guide.
This action only applies to Aurora DB clusters.
This is a convenience which creates an instance of the
DescribeGlobalClustersRequest.Builder
avoiding the need to create one manually viaDescribeGlobalClustersRequest.builder()
- Parameters:
describeGlobalClustersRequest
- AConsumer
that will call methods onDescribeGlobalClustersRequest.Builder
to create a request.- Returns:
- Result of the DescribeGlobalClusters operation returned by the service.
- Throws:
GlobalClusterNotFoundException
- TheGlobalClusterIdentifier
doesn't refer to an existing global database cluster.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeGlobalClusters
default DescribeGlobalClustersResponse describeGlobalClusters() throws GlobalClusterNotFoundException, AwsServiceException, SdkClientException, RdsException
Returns information about Aurora global database clusters. This API supports pagination.
For more information on Amazon Aurora, see What is Amazon Aurora? in the Amazon Aurora User Guide.
This action only applies to Aurora DB clusters.
- Returns:
- Result of the DescribeGlobalClusters operation returned by the service.
- Throws:
GlobalClusterNotFoundException
- TheGlobalClusterIdentifier
doesn't refer to an existing global database cluster.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
describeGlobalClusters(DescribeGlobalClustersRequest)
, AWS API Documentation
-
describeGlobalClustersPaginator
default DescribeGlobalClustersIterable describeGlobalClustersPaginator() throws GlobalClusterNotFoundException, AwsServiceException, SdkClientException, RdsException
This is a variant of
describeGlobalClusters(software.amazon.awssdk.services.rds.model.DescribeGlobalClustersRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeGlobalClustersIterable responses = client.describeGlobalClustersPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeGlobalClustersIterable responses = client .describeGlobalClustersPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeGlobalClustersResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeGlobalClustersIterable responses = client.describeGlobalClustersPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeGlobalClusters(software.amazon.awssdk.services.rds.model.DescribeGlobalClustersRequest)
operation.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
GlobalClusterNotFoundException
- TheGlobalClusterIdentifier
doesn't refer to an existing global database cluster.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
describeGlobalClustersPaginator(DescribeGlobalClustersRequest)
, AWS API Documentation
-
describeGlobalClustersPaginator
default DescribeGlobalClustersIterable describeGlobalClustersPaginator(DescribeGlobalClustersRequest describeGlobalClustersRequest) throws GlobalClusterNotFoundException, AwsServiceException, SdkClientException, RdsException
This is a variant of
describeGlobalClusters(software.amazon.awssdk.services.rds.model.DescribeGlobalClustersRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeGlobalClustersIterable responses = client.describeGlobalClustersPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeGlobalClustersIterable responses = client .describeGlobalClustersPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeGlobalClustersResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeGlobalClustersIterable responses = client.describeGlobalClustersPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeGlobalClusters(software.amazon.awssdk.services.rds.model.DescribeGlobalClustersRequest)
operation.- Parameters:
describeGlobalClustersRequest
-- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
GlobalClusterNotFoundException
- TheGlobalClusterIdentifier
doesn't refer to an existing global database cluster.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeGlobalClustersPaginator
default DescribeGlobalClustersIterable describeGlobalClustersPaginator(Consumer<DescribeGlobalClustersRequest.Builder> describeGlobalClustersRequest) throws GlobalClusterNotFoundException, AwsServiceException, SdkClientException, RdsException
This is a variant of
describeGlobalClusters(software.amazon.awssdk.services.rds.model.DescribeGlobalClustersRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeGlobalClustersIterable responses = client.describeGlobalClustersPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeGlobalClustersIterable responses = client .describeGlobalClustersPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeGlobalClustersResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeGlobalClustersIterable responses = client.describeGlobalClustersPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeGlobalClusters(software.amazon.awssdk.services.rds.model.DescribeGlobalClustersRequest)
operation.
This is a convenience which creates an instance of the
DescribeGlobalClustersRequest.Builder
avoiding the need to create one manually viaDescribeGlobalClustersRequest.builder()
- Parameters:
describeGlobalClustersRequest
- AConsumer
that will call methods onDescribeGlobalClustersRequest.Builder
to create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
GlobalClusterNotFoundException
- TheGlobalClusterIdentifier
doesn't refer to an existing global database cluster.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeIntegrations
default DescribeIntegrationsResponse describeIntegrations(DescribeIntegrationsRequest describeIntegrationsRequest) throws IntegrationNotFoundException, AwsServiceException, SdkClientException, RdsException
Describe one or more zero-ETL integrations with Amazon Redshift.
- Parameters:
describeIntegrationsRequest
-- Returns:
- Result of the DescribeIntegrations operation returned by the service.
- Throws:
IntegrationNotFoundException
- The specified integration could not be found.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeIntegrations
default DescribeIntegrationsResponse describeIntegrations(Consumer<DescribeIntegrationsRequest.Builder> describeIntegrationsRequest) throws IntegrationNotFoundException, AwsServiceException, SdkClientException, RdsException
Describe one or more zero-ETL integrations with Amazon Redshift.
This is a convenience which creates an instance of the
DescribeIntegrationsRequest.Builder
avoiding the need to create one manually viaDescribeIntegrationsRequest.builder()
- Parameters:
describeIntegrationsRequest
- AConsumer
that will call methods onDescribeIntegrationsRequest.Builder
to create a request.- Returns:
- Result of the DescribeIntegrations operation returned by the service.
- Throws:
IntegrationNotFoundException
- The specified integration could not be found.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeIntegrationsPaginator
default DescribeIntegrationsIterable describeIntegrationsPaginator(DescribeIntegrationsRequest describeIntegrationsRequest) throws IntegrationNotFoundException, AwsServiceException, SdkClientException, RdsException
This is a variant of
describeIntegrations(software.amazon.awssdk.services.rds.model.DescribeIntegrationsRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeIntegrationsIterable responses = client.describeIntegrationsPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeIntegrationsIterable responses = client .describeIntegrationsPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeIntegrationsResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeIntegrationsIterable responses = client.describeIntegrationsPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeIntegrations(software.amazon.awssdk.services.rds.model.DescribeIntegrationsRequest)
operation.- Parameters:
describeIntegrationsRequest
-- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
IntegrationNotFoundException
- The specified integration could not be found.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeIntegrationsPaginator
default DescribeIntegrationsIterable describeIntegrationsPaginator(Consumer<DescribeIntegrationsRequest.Builder> describeIntegrationsRequest) throws IntegrationNotFoundException, AwsServiceException, SdkClientException, RdsException
This is a variant of
describeIntegrations(software.amazon.awssdk.services.rds.model.DescribeIntegrationsRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeIntegrationsIterable responses = client.describeIntegrationsPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeIntegrationsIterable responses = client .describeIntegrationsPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeIntegrationsResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeIntegrationsIterable responses = client.describeIntegrationsPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeIntegrations(software.amazon.awssdk.services.rds.model.DescribeIntegrationsRequest)
operation.
This is a convenience which creates an instance of the
DescribeIntegrationsRequest.Builder
avoiding the need to create one manually viaDescribeIntegrationsRequest.builder()
- Parameters:
describeIntegrationsRequest
- AConsumer
that will call methods onDescribeIntegrationsRequest.Builder
to create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
IntegrationNotFoundException
- The specified integration could not be found.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeOptionGroupOptions
default DescribeOptionGroupOptionsResponse describeOptionGroupOptions(DescribeOptionGroupOptionsRequest describeOptionGroupOptionsRequest) throws AwsServiceException, SdkClientException, RdsException
Describes all available options for the specified engine.
- Parameters:
describeOptionGroupOptionsRequest
-- Returns:
- Result of the DescribeOptionGroupOptions operation returned by the service.
- Throws:
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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeOptionGroupOptions
default DescribeOptionGroupOptionsResponse describeOptionGroupOptions(Consumer<DescribeOptionGroupOptionsRequest.Builder> describeOptionGroupOptionsRequest) throws AwsServiceException, SdkClientException, RdsException
Describes all available options for the specified engine.
This is a convenience which creates an instance of the
DescribeOptionGroupOptionsRequest.Builder
avoiding the need to create one manually viaDescribeOptionGroupOptionsRequest.builder()
- Parameters:
describeOptionGroupOptionsRequest
- AConsumer
that will call methods onDescribeOptionGroupOptionsRequest.Builder
to create a request.- Returns:
- Result of the DescribeOptionGroupOptions operation returned by the service.
- Throws:
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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeOptionGroupOptionsPaginator
default DescribeOptionGroupOptionsIterable describeOptionGroupOptionsPaginator(DescribeOptionGroupOptionsRequest describeOptionGroupOptionsRequest) throws AwsServiceException, SdkClientException, RdsException
This is a variant of
describeOptionGroupOptions(software.amazon.awssdk.services.rds.model.DescribeOptionGroupOptionsRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeOptionGroupOptionsIterable responses = client.describeOptionGroupOptionsPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeOptionGroupOptionsIterable responses = client .describeOptionGroupOptionsPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeOptionGroupOptionsResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeOptionGroupOptionsIterable responses = client.describeOptionGroupOptionsPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeOptionGroupOptions(software.amazon.awssdk.services.rds.model.DescribeOptionGroupOptionsRequest)
operation.- Parameters:
describeOptionGroupOptionsRequest
-- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeOptionGroupOptionsPaginator
default DescribeOptionGroupOptionsIterable describeOptionGroupOptionsPaginator(Consumer<DescribeOptionGroupOptionsRequest.Builder> describeOptionGroupOptionsRequest) throws AwsServiceException, SdkClientException, RdsException
This is a variant of
describeOptionGroupOptions(software.amazon.awssdk.services.rds.model.DescribeOptionGroupOptionsRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeOptionGroupOptionsIterable responses = client.describeOptionGroupOptionsPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeOptionGroupOptionsIterable responses = client .describeOptionGroupOptionsPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeOptionGroupOptionsResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeOptionGroupOptionsIterable responses = client.describeOptionGroupOptionsPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeOptionGroupOptions(software.amazon.awssdk.services.rds.model.DescribeOptionGroupOptionsRequest)
operation.
This is a convenience which creates an instance of the
DescribeOptionGroupOptionsRequest.Builder
avoiding the need to create one manually viaDescribeOptionGroupOptionsRequest.builder()
- Parameters:
describeOptionGroupOptionsRequest
- AConsumer
that will call methods onDescribeOptionGroupOptionsRequest.Builder
to create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeOptionGroups
default DescribeOptionGroupsResponse describeOptionGroups(DescribeOptionGroupsRequest describeOptionGroupsRequest) throws OptionGroupNotFoundException, AwsServiceException, SdkClientException, RdsException
Describes the available option groups.
- Parameters:
describeOptionGroupsRequest
-- Returns:
- Result of the DescribeOptionGroups operation returned by the service.
- Throws:
OptionGroupNotFoundException
- The specified option group could not be found.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeOptionGroups
default DescribeOptionGroupsResponse describeOptionGroups(Consumer<DescribeOptionGroupsRequest.Builder> describeOptionGroupsRequest) throws OptionGroupNotFoundException, AwsServiceException, SdkClientException, RdsException
Describes the available option groups.
This is a convenience which creates an instance of the
DescribeOptionGroupsRequest.Builder
avoiding the need to create one manually viaDescribeOptionGroupsRequest.builder()
- Parameters:
describeOptionGroupsRequest
- AConsumer
that will call methods onDescribeOptionGroupsRequest.Builder
to create a request.- Returns:
- Result of the DescribeOptionGroups operation returned by the service.
- Throws:
OptionGroupNotFoundException
- The specified option group could not be found.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeOptionGroups
default DescribeOptionGroupsResponse describeOptionGroups() throws OptionGroupNotFoundException, AwsServiceException, SdkClientException, RdsException
Describes the available option groups.
- Returns:
- Result of the DescribeOptionGroups operation returned by the service.
- Throws:
OptionGroupNotFoundException
- The specified option group could not be found.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
describeOptionGroups(DescribeOptionGroupsRequest)
, AWS API Documentation
-
describeOptionGroupsPaginator
default DescribeOptionGroupsIterable describeOptionGroupsPaginator() throws OptionGroupNotFoundException, AwsServiceException, SdkClientException, RdsException
This is a variant of
describeOptionGroups(software.amazon.awssdk.services.rds.model.DescribeOptionGroupsRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeOptionGroupsIterable responses = client.describeOptionGroupsPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeOptionGroupsIterable responses = client .describeOptionGroupsPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeOptionGroupsResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeOptionGroupsIterable responses = client.describeOptionGroupsPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeOptionGroups(software.amazon.awssdk.services.rds.model.DescribeOptionGroupsRequest)
operation.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
OptionGroupNotFoundException
- The specified option group could not be found.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
describeOptionGroupsPaginator(DescribeOptionGroupsRequest)
, AWS API Documentation
-
describeOptionGroupsPaginator
default DescribeOptionGroupsIterable describeOptionGroupsPaginator(DescribeOptionGroupsRequest describeOptionGroupsRequest) throws OptionGroupNotFoundException, AwsServiceException, SdkClientException, RdsException
This is a variant of
describeOptionGroups(software.amazon.awssdk.services.rds.model.DescribeOptionGroupsRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeOptionGroupsIterable responses = client.describeOptionGroupsPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeOptionGroupsIterable responses = client .describeOptionGroupsPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeOptionGroupsResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeOptionGroupsIterable responses = client.describeOptionGroupsPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeOptionGroups(software.amazon.awssdk.services.rds.model.DescribeOptionGroupsRequest)
operation.- Parameters:
describeOptionGroupsRequest
-- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
OptionGroupNotFoundException
- The specified option group could not be found.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeOptionGroupsPaginator
default DescribeOptionGroupsIterable describeOptionGroupsPaginator(Consumer<DescribeOptionGroupsRequest.Builder> describeOptionGroupsRequest) throws OptionGroupNotFoundException, AwsServiceException, SdkClientException, RdsException
This is a variant of
describeOptionGroups(software.amazon.awssdk.services.rds.model.DescribeOptionGroupsRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeOptionGroupsIterable responses = client.describeOptionGroupsPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeOptionGroupsIterable responses = client .describeOptionGroupsPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeOptionGroupsResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeOptionGroupsIterable responses = client.describeOptionGroupsPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeOptionGroups(software.amazon.awssdk.services.rds.model.DescribeOptionGroupsRequest)
operation.
This is a convenience which creates an instance of the
DescribeOptionGroupsRequest.Builder
avoiding the need to create one manually viaDescribeOptionGroupsRequest.builder()
- Parameters:
describeOptionGroupsRequest
- AConsumer
that will call methods onDescribeOptionGroupsRequest.Builder
to create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
OptionGroupNotFoundException
- The specified option group could not be found.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeOrderableDBInstanceOptions
default DescribeOrderableDbInstanceOptionsResponse describeOrderableDBInstanceOptions(DescribeOrderableDbInstanceOptionsRequest describeOrderableDbInstanceOptionsRequest) throws AwsServiceException, SdkClientException, RdsException
Describes the orderable DB instance options for a specified DB engine.
- Parameters:
describeOrderableDbInstanceOptionsRequest
-- Returns:
- Result of the DescribeOrderableDBInstanceOptions operation returned by the service.
- Throws:
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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeOrderableDBInstanceOptions
default DescribeOrderableDbInstanceOptionsResponse describeOrderableDBInstanceOptions(Consumer<DescribeOrderableDbInstanceOptionsRequest.Builder> describeOrderableDbInstanceOptionsRequest) throws AwsServiceException, SdkClientException, RdsException
Describes the orderable DB instance options for a specified DB engine.
This is a convenience which creates an instance of the
DescribeOrderableDbInstanceOptionsRequest.Builder
avoiding the need to create one manually viaDescribeOrderableDbInstanceOptionsRequest.builder()
- Parameters:
describeOrderableDbInstanceOptionsRequest
- AConsumer
that will call methods onDescribeOrderableDbInstanceOptionsRequest.Builder
to create a request.- Returns:
- Result of the DescribeOrderableDBInstanceOptions operation returned by the service.
- Throws:
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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeOrderableDBInstanceOptionsPaginator
default DescribeOrderableDBInstanceOptionsIterable describeOrderableDBInstanceOptionsPaginator(DescribeOrderableDbInstanceOptionsRequest describeOrderableDbInstanceOptionsRequest) throws AwsServiceException, SdkClientException, RdsException
This is a variant of
describeOrderableDBInstanceOptions(software.amazon.awssdk.services.rds.model.DescribeOrderableDbInstanceOptionsRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeOrderableDBInstanceOptionsIterable responses = client.describeOrderableDBInstanceOptionsPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeOrderableDBInstanceOptionsIterable responses = client .describeOrderableDBInstanceOptionsPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeOrderableDbInstanceOptionsResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeOrderableDBInstanceOptionsIterable responses = client.describeOrderableDBInstanceOptionsPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeOrderableDBInstanceOptions(software.amazon.awssdk.services.rds.model.DescribeOrderableDbInstanceOptionsRequest)
operation.- Parameters:
describeOrderableDbInstanceOptionsRequest
-- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeOrderableDBInstanceOptionsPaginator
default DescribeOrderableDBInstanceOptionsIterable describeOrderableDBInstanceOptionsPaginator(Consumer<DescribeOrderableDbInstanceOptionsRequest.Builder> describeOrderableDbInstanceOptionsRequest) throws AwsServiceException, SdkClientException, RdsException
This is a variant of
describeOrderableDBInstanceOptions(software.amazon.awssdk.services.rds.model.DescribeOrderableDbInstanceOptionsRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeOrderableDBInstanceOptionsIterable responses = client.describeOrderableDBInstanceOptionsPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeOrderableDBInstanceOptionsIterable responses = client .describeOrderableDBInstanceOptionsPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeOrderableDbInstanceOptionsResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeOrderableDBInstanceOptionsIterable responses = client.describeOrderableDBInstanceOptionsPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeOrderableDBInstanceOptions(software.amazon.awssdk.services.rds.model.DescribeOrderableDbInstanceOptionsRequest)
operation.
This is a convenience which creates an instance of the
DescribeOrderableDbInstanceOptionsRequest.Builder
avoiding the need to create one manually viaDescribeOrderableDbInstanceOptionsRequest.builder()
- Parameters:
describeOrderableDbInstanceOptionsRequest
- AConsumer
that will call methods onDescribeOrderableDbInstanceOptionsRequest.Builder
to create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describePendingMaintenanceActions
default DescribePendingMaintenanceActionsResponse describePendingMaintenanceActions(DescribePendingMaintenanceActionsRequest describePendingMaintenanceActionsRequest) throws ResourceNotFoundException, AwsServiceException, SdkClientException, RdsException
Returns a list of resources (for example, DB instances) that have at least one pending maintenance action.
This API follows an eventual consistency model. This means that the result of the
DescribePendingMaintenanceActions
command might not be immediately visible to all subsequent RDS commands. Keep this in mind when you useDescribePendingMaintenanceActions
immediately after using a previous API command such asApplyPendingMaintenanceActions
.- Parameters:
describePendingMaintenanceActionsRequest
-- Returns:
- Result of the DescribePendingMaintenanceActions operation returned by the service.
- Throws:
ResourceNotFoundException
- The specified resource ID was not found.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describePendingMaintenanceActions
default DescribePendingMaintenanceActionsResponse describePendingMaintenanceActions(Consumer<DescribePendingMaintenanceActionsRequest.Builder> describePendingMaintenanceActionsRequest) throws ResourceNotFoundException, AwsServiceException, SdkClientException, RdsException
Returns a list of resources (for example, DB instances) that have at least one pending maintenance action.
This API follows an eventual consistency model. This means that the result of the
DescribePendingMaintenanceActions
command might not be immediately visible to all subsequent RDS commands. Keep this in mind when you useDescribePendingMaintenanceActions
immediately after using a previous API command such asApplyPendingMaintenanceActions
.
This is a convenience which creates an instance of the
DescribePendingMaintenanceActionsRequest.Builder
avoiding the need to create one manually viaDescribePendingMaintenanceActionsRequest.builder()
- Parameters:
describePendingMaintenanceActionsRequest
- AConsumer
that will call methods onDescribePendingMaintenanceActionsRequest.Builder
to create a request.- Returns:
- Result of the DescribePendingMaintenanceActions operation returned by the service.
- Throws:
ResourceNotFoundException
- The specified resource ID was not found.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describePendingMaintenanceActions
default DescribePendingMaintenanceActionsResponse describePendingMaintenanceActions() throws ResourceNotFoundException, AwsServiceException, SdkClientException, RdsException
Returns a list of resources (for example, DB instances) that have at least one pending maintenance action.
This API follows an eventual consistency model. This means that the result of the
DescribePendingMaintenanceActions
command might not be immediately visible to all subsequent RDS commands. Keep this in mind when you useDescribePendingMaintenanceActions
immediately after using a previous API command such asApplyPendingMaintenanceActions
.- Returns:
- Result of the DescribePendingMaintenanceActions operation returned by the service.
- Throws:
ResourceNotFoundException
- The specified resource ID was not found.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
describePendingMaintenanceActions(DescribePendingMaintenanceActionsRequest)
, AWS API Documentation
-
describePendingMaintenanceActionsPaginator
default DescribePendingMaintenanceActionsIterable describePendingMaintenanceActionsPaginator() throws ResourceNotFoundException, AwsServiceException, SdkClientException, RdsException
This is a variant of
describePendingMaintenanceActions(software.amazon.awssdk.services.rds.model.DescribePendingMaintenanceActionsRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribePendingMaintenanceActionsIterable responses = client.describePendingMaintenanceActionsPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribePendingMaintenanceActionsIterable responses = client .describePendingMaintenanceActionsPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribePendingMaintenanceActionsResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribePendingMaintenanceActionsIterable responses = client.describePendingMaintenanceActionsPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describePendingMaintenanceActions(software.amazon.awssdk.services.rds.model.DescribePendingMaintenanceActionsRequest)
operation.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
ResourceNotFoundException
- The specified resource ID was not found.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
describePendingMaintenanceActionsPaginator(DescribePendingMaintenanceActionsRequest)
, AWS API Documentation
-
describePendingMaintenanceActionsPaginator
default DescribePendingMaintenanceActionsIterable describePendingMaintenanceActionsPaginator(DescribePendingMaintenanceActionsRequest describePendingMaintenanceActionsRequest) throws ResourceNotFoundException, AwsServiceException, SdkClientException, RdsException
This is a variant of
describePendingMaintenanceActions(software.amazon.awssdk.services.rds.model.DescribePendingMaintenanceActionsRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribePendingMaintenanceActionsIterable responses = client.describePendingMaintenanceActionsPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribePendingMaintenanceActionsIterable responses = client .describePendingMaintenanceActionsPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribePendingMaintenanceActionsResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribePendingMaintenanceActionsIterable responses = client.describePendingMaintenanceActionsPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describePendingMaintenanceActions(software.amazon.awssdk.services.rds.model.DescribePendingMaintenanceActionsRequest)
operation.- Parameters:
describePendingMaintenanceActionsRequest
-- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
ResourceNotFoundException
- The specified resource ID was not found.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describePendingMaintenanceActionsPaginator
default DescribePendingMaintenanceActionsIterable describePendingMaintenanceActionsPaginator(Consumer<DescribePendingMaintenanceActionsRequest.Builder> describePendingMaintenanceActionsRequest) throws ResourceNotFoundException, AwsServiceException, SdkClientException, RdsException
This is a variant of
describePendingMaintenanceActions(software.amazon.awssdk.services.rds.model.DescribePendingMaintenanceActionsRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribePendingMaintenanceActionsIterable responses = client.describePendingMaintenanceActionsPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribePendingMaintenanceActionsIterable responses = client .describePendingMaintenanceActionsPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribePendingMaintenanceActionsResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribePendingMaintenanceActionsIterable responses = client.describePendingMaintenanceActionsPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describePendingMaintenanceActions(software.amazon.awssdk.services.rds.model.DescribePendingMaintenanceActionsRequest)
operation.
This is a convenience which creates an instance of the
DescribePendingMaintenanceActionsRequest.Builder
avoiding the need to create one manually viaDescribePendingMaintenanceActionsRequest.builder()
- Parameters:
describePendingMaintenanceActionsRequest
- AConsumer
that will call methods onDescribePendingMaintenanceActionsRequest.Builder
to create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
ResourceNotFoundException
- The specified resource ID was not found.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeReservedDBInstances
default DescribeReservedDbInstancesResponse describeReservedDBInstances(DescribeReservedDbInstancesRequest describeReservedDbInstancesRequest) throws ReservedDbInstanceNotFoundException, AwsServiceException, SdkClientException, RdsException
Returns information about reserved DB instances for this account, or about a specified reserved DB instance.
- Parameters:
describeReservedDbInstancesRequest
-- Returns:
- Result of the DescribeReservedDBInstances operation returned by the service.
- Throws:
ReservedDbInstanceNotFoundException
- The specified reserved DB Instance not found.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeReservedDBInstances
default DescribeReservedDbInstancesResponse describeReservedDBInstances(Consumer<DescribeReservedDbInstancesRequest.Builder> describeReservedDbInstancesRequest) throws ReservedDbInstanceNotFoundException, AwsServiceException, SdkClientException, RdsException
Returns information about reserved DB instances for this account, or about a specified reserved DB instance.
This is a convenience which creates an instance of the
DescribeReservedDbInstancesRequest.Builder
avoiding the need to create one manually viaDescribeReservedDbInstancesRequest.builder()
- Parameters:
describeReservedDbInstancesRequest
- AConsumer
that will call methods onDescribeReservedDbInstancesRequest.Builder
to create a request.- Returns:
- Result of the DescribeReservedDBInstances operation returned by the service.
- Throws:
ReservedDbInstanceNotFoundException
- The specified reserved DB Instance not found.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeReservedDBInstances
default DescribeReservedDbInstancesResponse describeReservedDBInstances() throws ReservedDbInstanceNotFoundException, AwsServiceException, SdkClientException, RdsException
Returns information about reserved DB instances for this account, or about a specified reserved DB instance.
- Returns:
- Result of the DescribeReservedDBInstances operation returned by the service.
- Throws:
ReservedDbInstanceNotFoundException
- The specified reserved DB Instance not found.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
describeReservedDBInstances(DescribeReservedDbInstancesRequest)
, AWS API Documentation
-
describeReservedDBInstancesPaginator
default DescribeReservedDBInstancesIterable describeReservedDBInstancesPaginator() throws ReservedDbInstanceNotFoundException, AwsServiceException, SdkClientException, RdsException
This is a variant of
describeReservedDBInstances(software.amazon.awssdk.services.rds.model.DescribeReservedDbInstancesRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeReservedDBInstancesIterable responses = client.describeReservedDBInstancesPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeReservedDBInstancesIterable responses = client .describeReservedDBInstancesPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeReservedDbInstancesResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeReservedDBInstancesIterable responses = client.describeReservedDBInstancesPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeReservedDBInstances(software.amazon.awssdk.services.rds.model.DescribeReservedDbInstancesRequest)
operation.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
ReservedDbInstanceNotFoundException
- The specified reserved DB Instance not found.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
describeReservedDBInstancesPaginator(DescribeReservedDbInstancesRequest)
, AWS API Documentation
-
describeReservedDBInstancesPaginator
default DescribeReservedDBInstancesIterable describeReservedDBInstancesPaginator(DescribeReservedDbInstancesRequest describeReservedDbInstancesRequest) throws ReservedDbInstanceNotFoundException, AwsServiceException, SdkClientException, RdsException
This is a variant of
describeReservedDBInstances(software.amazon.awssdk.services.rds.model.DescribeReservedDbInstancesRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeReservedDBInstancesIterable responses = client.describeReservedDBInstancesPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeReservedDBInstancesIterable responses = client .describeReservedDBInstancesPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeReservedDbInstancesResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeReservedDBInstancesIterable responses = client.describeReservedDBInstancesPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeReservedDBInstances(software.amazon.awssdk.services.rds.model.DescribeReservedDbInstancesRequest)
operation.- Parameters:
describeReservedDbInstancesRequest
-- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
ReservedDbInstanceNotFoundException
- The specified reserved DB Instance not found.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeReservedDBInstancesPaginator
default DescribeReservedDBInstancesIterable describeReservedDBInstancesPaginator(Consumer<DescribeReservedDbInstancesRequest.Builder> describeReservedDbInstancesRequest) throws ReservedDbInstanceNotFoundException, AwsServiceException, SdkClientException, RdsException
This is a variant of
describeReservedDBInstances(software.amazon.awssdk.services.rds.model.DescribeReservedDbInstancesRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeReservedDBInstancesIterable responses = client.describeReservedDBInstancesPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeReservedDBInstancesIterable responses = client .describeReservedDBInstancesPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeReservedDbInstancesResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeReservedDBInstancesIterable responses = client.describeReservedDBInstancesPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeReservedDBInstances(software.amazon.awssdk.services.rds.model.DescribeReservedDbInstancesRequest)
operation.
This is a convenience which creates an instance of the
DescribeReservedDbInstancesRequest.Builder
avoiding the need to create one manually viaDescribeReservedDbInstancesRequest.builder()
- Parameters:
describeReservedDbInstancesRequest
- AConsumer
that will call methods onDescribeReservedDbInstancesRequest.Builder
to create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
ReservedDbInstanceNotFoundException
- The specified reserved DB Instance not found.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeReservedDBInstancesOfferings
default DescribeReservedDbInstancesOfferingsResponse describeReservedDBInstancesOfferings(DescribeReservedDbInstancesOfferingsRequest describeReservedDbInstancesOfferingsRequest) throws ReservedDbInstancesOfferingNotFoundException, AwsServiceException, SdkClientException, RdsException
Lists available reserved DB instance offerings.
- Parameters:
describeReservedDbInstancesOfferingsRequest
-- Returns:
- Result of the DescribeReservedDBInstancesOfferings operation returned by the service.
- Throws:
ReservedDbInstancesOfferingNotFoundException
- Specified offering does not exist.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeReservedDBInstancesOfferings
default DescribeReservedDbInstancesOfferingsResponse describeReservedDBInstancesOfferings(Consumer<DescribeReservedDbInstancesOfferingsRequest.Builder> describeReservedDbInstancesOfferingsRequest) throws ReservedDbInstancesOfferingNotFoundException, AwsServiceException, SdkClientException, RdsException
Lists available reserved DB instance offerings.
This is a convenience which creates an instance of the
DescribeReservedDbInstancesOfferingsRequest.Builder
avoiding the need to create one manually viaDescribeReservedDbInstancesOfferingsRequest.builder()
- Parameters:
describeReservedDbInstancesOfferingsRequest
- AConsumer
that will call methods onDescribeReservedDbInstancesOfferingsRequest.Builder
to create a request.- Returns:
- Result of the DescribeReservedDBInstancesOfferings operation returned by the service.
- Throws:
ReservedDbInstancesOfferingNotFoundException
- Specified offering does not exist.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeReservedDBInstancesOfferings
default DescribeReservedDbInstancesOfferingsResponse describeReservedDBInstancesOfferings() throws ReservedDbInstancesOfferingNotFoundException, AwsServiceException, SdkClientException, RdsException
Lists available reserved DB instance offerings.
- Returns:
- Result of the DescribeReservedDBInstancesOfferings operation returned by the service.
- Throws:
ReservedDbInstancesOfferingNotFoundException
- Specified offering does not exist.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
describeReservedDBInstancesOfferings(DescribeReservedDbInstancesOfferingsRequest)
, AWS API Documentation
-
describeReservedDBInstancesOfferingsPaginator
default DescribeReservedDBInstancesOfferingsIterable describeReservedDBInstancesOfferingsPaginator() throws ReservedDbInstancesOfferingNotFoundException, AwsServiceException, SdkClientException, RdsException
This is a variant of
describeReservedDBInstancesOfferings(software.amazon.awssdk.services.rds.model.DescribeReservedDbInstancesOfferingsRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeReservedDBInstancesOfferingsIterable responses = client.describeReservedDBInstancesOfferingsPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeReservedDBInstancesOfferingsIterable responses = client .describeReservedDBInstancesOfferingsPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeReservedDbInstancesOfferingsResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeReservedDBInstancesOfferingsIterable responses = client.describeReservedDBInstancesOfferingsPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeReservedDBInstancesOfferings(software.amazon.awssdk.services.rds.model.DescribeReservedDbInstancesOfferingsRequest)
operation.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
ReservedDbInstancesOfferingNotFoundException
- Specified offering does not exist.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
describeReservedDBInstancesOfferingsPaginator(DescribeReservedDbInstancesOfferingsRequest)
, AWS API Documentation
-
describeReservedDBInstancesOfferingsPaginator
default DescribeReservedDBInstancesOfferingsIterable describeReservedDBInstancesOfferingsPaginator(DescribeReservedDbInstancesOfferingsRequest describeReservedDbInstancesOfferingsRequest) throws ReservedDbInstancesOfferingNotFoundException, AwsServiceException, SdkClientException, RdsException
This is a variant of
describeReservedDBInstancesOfferings(software.amazon.awssdk.services.rds.model.DescribeReservedDbInstancesOfferingsRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeReservedDBInstancesOfferingsIterable responses = client.describeReservedDBInstancesOfferingsPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeReservedDBInstancesOfferingsIterable responses = client .describeReservedDBInstancesOfferingsPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeReservedDbInstancesOfferingsResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeReservedDBInstancesOfferingsIterable responses = client.describeReservedDBInstancesOfferingsPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeReservedDBInstancesOfferings(software.amazon.awssdk.services.rds.model.DescribeReservedDbInstancesOfferingsRequest)
operation.- Parameters:
describeReservedDbInstancesOfferingsRequest
-- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
ReservedDbInstancesOfferingNotFoundException
- Specified offering does not exist.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeReservedDBInstancesOfferingsPaginator
default DescribeReservedDBInstancesOfferingsIterable describeReservedDBInstancesOfferingsPaginator(Consumer<DescribeReservedDbInstancesOfferingsRequest.Builder> describeReservedDbInstancesOfferingsRequest) throws ReservedDbInstancesOfferingNotFoundException, AwsServiceException, SdkClientException, RdsException
This is a variant of
describeReservedDBInstancesOfferings(software.amazon.awssdk.services.rds.model.DescribeReservedDbInstancesOfferingsRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeReservedDBInstancesOfferingsIterable responses = client.describeReservedDBInstancesOfferingsPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeReservedDBInstancesOfferingsIterable responses = client .describeReservedDBInstancesOfferingsPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeReservedDbInstancesOfferingsResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeReservedDBInstancesOfferingsIterable responses = client.describeReservedDBInstancesOfferingsPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeReservedDBInstancesOfferings(software.amazon.awssdk.services.rds.model.DescribeReservedDbInstancesOfferingsRequest)
operation.
This is a convenience which creates an instance of the
DescribeReservedDbInstancesOfferingsRequest.Builder
avoiding the need to create one manually viaDescribeReservedDbInstancesOfferingsRequest.builder()
- Parameters:
describeReservedDbInstancesOfferingsRequest
- AConsumer
that will call methods onDescribeReservedDbInstancesOfferingsRequest.Builder
to create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
ReservedDbInstancesOfferingNotFoundException
- Specified offering does not exist.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeSourceRegions
default DescribeSourceRegionsResponse describeSourceRegions(DescribeSourceRegionsRequest describeSourceRegionsRequest) throws AwsServiceException, SdkClientException, RdsException
Returns a list of the source Amazon Web Services Regions where the current Amazon Web Services Region can create a read replica, copy a DB snapshot from, or replicate automated backups from.
Use this operation to determine whether cross-Region features are supported between other Regions and your current Region. This operation supports pagination.
To return information about the Regions that are enabled for your account, or all Regions, use the EC2 operation
DescribeRegions
. For more information, see DescribeRegions in the Amazon EC2 API Reference.- Parameters:
describeSourceRegionsRequest
-- Returns:
- Result of the DescribeSourceRegions operation returned by the service.
- Throws:
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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeSourceRegions
default DescribeSourceRegionsResponse describeSourceRegions(Consumer<DescribeSourceRegionsRequest.Builder> describeSourceRegionsRequest) throws AwsServiceException, SdkClientException, RdsException
Returns a list of the source Amazon Web Services Regions where the current Amazon Web Services Region can create a read replica, copy a DB snapshot from, or replicate automated backups from.
Use this operation to determine whether cross-Region features are supported between other Regions and your current Region. This operation supports pagination.
To return information about the Regions that are enabled for your account, or all Regions, use the EC2 operation
DescribeRegions
. For more information, see DescribeRegions in the Amazon EC2 API Reference.
This is a convenience which creates an instance of the
DescribeSourceRegionsRequest.Builder
avoiding the need to create one manually viaDescribeSourceRegionsRequest.builder()
- Parameters:
describeSourceRegionsRequest
- AConsumer
that will call methods onDescribeSourceRegionsRequest.Builder
to create a request.- Returns:
- Result of the DescribeSourceRegions operation returned by the service.
- Throws:
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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeSourceRegions
default DescribeSourceRegionsResponse describeSourceRegions() throws AwsServiceException, SdkClientException, RdsException
Returns a list of the source Amazon Web Services Regions where the current Amazon Web Services Region can create a read replica, copy a DB snapshot from, or replicate automated backups from.
Use this operation to determine whether cross-Region features are supported between other Regions and your current Region. This operation supports pagination.
To return information about the Regions that are enabled for your account, or all Regions, use the EC2 operation
DescribeRegions
. For more information, see DescribeRegions in the Amazon EC2 API Reference.- Returns:
- Result of the DescribeSourceRegions operation returned by the service.
- Throws:
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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
describeSourceRegions(DescribeSourceRegionsRequest)
, AWS API Documentation
-
describeSourceRegionsPaginator
default DescribeSourceRegionsIterable describeSourceRegionsPaginator() throws AwsServiceException, SdkClientException, RdsException
This is a variant of
describeSourceRegions(software.amazon.awssdk.services.rds.model.DescribeSourceRegionsRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeSourceRegionsIterable responses = client.describeSourceRegionsPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeSourceRegionsIterable responses = client .describeSourceRegionsPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeSourceRegionsResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeSourceRegionsIterable responses = client.describeSourceRegionsPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeSourceRegions(software.amazon.awssdk.services.rds.model.DescribeSourceRegionsRequest)
operation.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
describeSourceRegionsPaginator(DescribeSourceRegionsRequest)
, AWS API Documentation
-
describeSourceRegionsPaginator
default DescribeSourceRegionsIterable describeSourceRegionsPaginator(DescribeSourceRegionsRequest describeSourceRegionsRequest) throws AwsServiceException, SdkClientException, RdsException
This is a variant of
describeSourceRegions(software.amazon.awssdk.services.rds.model.DescribeSourceRegionsRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeSourceRegionsIterable responses = client.describeSourceRegionsPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeSourceRegionsIterable responses = client .describeSourceRegionsPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeSourceRegionsResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeSourceRegionsIterable responses = client.describeSourceRegionsPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeSourceRegions(software.amazon.awssdk.services.rds.model.DescribeSourceRegionsRequest)
operation.- Parameters:
describeSourceRegionsRequest
-- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeSourceRegionsPaginator
default DescribeSourceRegionsIterable describeSourceRegionsPaginator(Consumer<DescribeSourceRegionsRequest.Builder> describeSourceRegionsRequest) throws AwsServiceException, SdkClientException, RdsException
This is a variant of
describeSourceRegions(software.amazon.awssdk.services.rds.model.DescribeSourceRegionsRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeSourceRegionsIterable responses = client.describeSourceRegionsPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeSourceRegionsIterable responses = client .describeSourceRegionsPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeSourceRegionsResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeSourceRegionsIterable responses = client.describeSourceRegionsPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeSourceRegions(software.amazon.awssdk.services.rds.model.DescribeSourceRegionsRequest)
operation.
This is a convenience which creates an instance of the
DescribeSourceRegionsRequest.Builder
avoiding the need to create one manually viaDescribeSourceRegionsRequest.builder()
- Parameters:
describeSourceRegionsRequest
- AConsumer
that will call methods onDescribeSourceRegionsRequest.Builder
to create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeTenantDatabases
default DescribeTenantDatabasesResponse describeTenantDatabases(DescribeTenantDatabasesRequest describeTenantDatabasesRequest) throws DbInstanceNotFoundException, AwsServiceException, SdkClientException, RdsException
Describes the tenant databases in a DB instance that uses the multi-tenant configuration. Only RDS for Oracle CDB instances are supported.
- Parameters:
describeTenantDatabasesRequest
-- Returns:
- Result of the DescribeTenantDatabases operation returned by the service.
- Throws:
DbInstanceNotFoundException
-DBInstanceIdentifier
doesn't refer to an existing DB instance.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeTenantDatabases
default DescribeTenantDatabasesResponse describeTenantDatabases(Consumer<DescribeTenantDatabasesRequest.Builder> describeTenantDatabasesRequest) throws DbInstanceNotFoundException, AwsServiceException, SdkClientException, RdsException
Describes the tenant databases in a DB instance that uses the multi-tenant configuration. Only RDS for Oracle CDB instances are supported.
This is a convenience which creates an instance of the
DescribeTenantDatabasesRequest.Builder
avoiding the need to create one manually viaDescribeTenantDatabasesRequest.builder()
- Parameters:
describeTenantDatabasesRequest
- AConsumer
that will call methods onDescribeTenantDatabasesRequest.Builder
to create a request.- Returns:
- Result of the DescribeTenantDatabases operation returned by the service.
- Throws:
DbInstanceNotFoundException
-DBInstanceIdentifier
doesn't refer to an existing DB instance.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeTenantDatabasesPaginator
default DescribeTenantDatabasesIterable describeTenantDatabasesPaginator(DescribeTenantDatabasesRequest describeTenantDatabasesRequest) throws DbInstanceNotFoundException, AwsServiceException, SdkClientException, RdsException
This is a variant of
describeTenantDatabases(software.amazon.awssdk.services.rds.model.DescribeTenantDatabasesRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeTenantDatabasesIterable responses = client.describeTenantDatabasesPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeTenantDatabasesIterable responses = client .describeTenantDatabasesPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeTenantDatabasesResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeTenantDatabasesIterable responses = client.describeTenantDatabasesPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeTenantDatabases(software.amazon.awssdk.services.rds.model.DescribeTenantDatabasesRequest)
operation.- Parameters:
describeTenantDatabasesRequest
-- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
DbInstanceNotFoundException
-DBInstanceIdentifier
doesn't refer to an existing DB instance.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeTenantDatabasesPaginator
default DescribeTenantDatabasesIterable describeTenantDatabasesPaginator(Consumer<DescribeTenantDatabasesRequest.Builder> describeTenantDatabasesRequest) throws DbInstanceNotFoundException, AwsServiceException, SdkClientException, RdsException
This is a variant of
describeTenantDatabases(software.amazon.awssdk.services.rds.model.DescribeTenantDatabasesRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DescribeTenantDatabasesIterable responses = client.describeTenantDatabasesPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DescribeTenantDatabasesIterable responses = client .describeTenantDatabasesPaginator(request); for (software.amazon.awssdk.services.rds.model.DescribeTenantDatabasesResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DescribeTenantDatabasesIterable responses = client.describeTenantDatabasesPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of MaxRecords 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
describeTenantDatabases(software.amazon.awssdk.services.rds.model.DescribeTenantDatabasesRequest)
operation.
This is a convenience which creates an instance of the
DescribeTenantDatabasesRequest.Builder
avoiding the need to create one manually viaDescribeTenantDatabasesRequest.builder()
- Parameters:
describeTenantDatabasesRequest
- AConsumer
that will call methods onDescribeTenantDatabasesRequest.Builder
to create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
DbInstanceNotFoundException
-DBInstanceIdentifier
doesn't refer to an existing DB instance.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeValidDBInstanceModifications
default DescribeValidDbInstanceModificationsResponse describeValidDBInstanceModifications(DescribeValidDbInstanceModificationsRequest describeValidDbInstanceModificationsRequest) throws DbInstanceNotFoundException, InvalidDbInstanceStateException, AwsServiceException, SdkClientException, RdsException
You can call
DescribeValidDBInstanceModifications
to learn what modifications you can make to your DB instance. You can use this information when you callModifyDBInstance
.This command doesn't apply to RDS Custom.
- Parameters:
describeValidDbInstanceModificationsRequest
-- Returns:
- Result of the DescribeValidDBInstanceModifications operation returned by the service.
- Throws:
DbInstanceNotFoundException
-DBInstanceIdentifier
doesn't refer to an existing DB instance.InvalidDbInstanceStateException
- The DB instance isn't in a valid state.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
describeValidDBInstanceModifications
default DescribeValidDbInstanceModificationsResponse describeValidDBInstanceModifications(Consumer<DescribeValidDbInstanceModificationsRequest.Builder> describeValidDbInstanceModificationsRequest) throws DbInstanceNotFoundException, InvalidDbInstanceStateException, AwsServiceException, SdkClientException, RdsException
You can call
DescribeValidDBInstanceModifications
to learn what modifications you can make to your DB instance. You can use this information when you callModifyDBInstance
.This command doesn't apply to RDS Custom.
This is a convenience which creates an instance of the
DescribeValidDbInstanceModificationsRequest.Builder
avoiding the need to create one manually viaDescribeValidDbInstanceModificationsRequest.builder()
- Parameters:
describeValidDbInstanceModificationsRequest
- AConsumer
that will call methods onDescribeValidDbInstanceModificationsRequest.Builder
to create a request.- Returns:
- Result of the DescribeValidDBInstanceModifications operation returned by the service.
- Throws:
DbInstanceNotFoundException
-DBInstanceIdentifier
doesn't refer to an existing DB instance.InvalidDbInstanceStateException
- The DB instance isn't in a valid state.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
disableHttpEndpoint
default DisableHttpEndpointResponse disableHttpEndpoint(DisableHttpEndpointRequest disableHttpEndpointRequest) throws ResourceNotFoundException, InvalidResourceStateException, AwsServiceException, SdkClientException, RdsException
Disables the HTTP endpoint for the specified DB cluster. Disabling this endpoint disables RDS Data API.
For more information, see Using RDS Data API in the Amazon Aurora User Guide.
This operation applies only to Aurora PostgreSQL Serverless v2 and provisioned DB clusters. To disable the HTTP endpoint for Aurora Serverless v1 DB clusters, use the
EnableHttpEndpoint
parameter of theModifyDBCluster
operation.- Parameters:
disableHttpEndpointRequest
-- Returns:
- Result of the DisableHttpEndpoint operation returned by the service.
- Throws:
ResourceNotFoundException
- The specified resource ID was not found.InvalidResourceStateException
- The operation can't be performed because another operation is in progress.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
disableHttpEndpoint
default DisableHttpEndpointResponse disableHttpEndpoint(Consumer<DisableHttpEndpointRequest.Builder> disableHttpEndpointRequest) throws ResourceNotFoundException, InvalidResourceStateException, AwsServiceException, SdkClientException, RdsException
Disables the HTTP endpoint for the specified DB cluster. Disabling this endpoint disables RDS Data API.
For more information, see Using RDS Data API in the Amazon Aurora User Guide.
This operation applies only to Aurora PostgreSQL Serverless v2 and provisioned DB clusters. To disable the HTTP endpoint for Aurora Serverless v1 DB clusters, use the
EnableHttpEndpoint
parameter of theModifyDBCluster
operation.
This is a convenience which creates an instance of the
DisableHttpEndpointRequest.Builder
avoiding the need to create one manually viaDisableHttpEndpointRequest.builder()
- Parameters:
disableHttpEndpointRequest
- AConsumer
that will call methods onDisableHttpEndpointRequest.Builder
to create a request.- Returns:
- Result of the DisableHttpEndpoint operation returned by the service.
- Throws:
ResourceNotFoundException
- The specified resource ID was not found.InvalidResourceStateException
- The operation can't be performed because another operation is in progress.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
downloadDBLogFilePortion
default DownloadDbLogFilePortionResponse downloadDBLogFilePortion(DownloadDbLogFilePortionRequest downloadDbLogFilePortionRequest) throws DbInstanceNotFoundException, DbLogFileNotFoundException, AwsServiceException, SdkClientException, RdsException
Downloads all or a portion of the specified log file, up to 1 MB in size.
This command doesn't apply to RDS Custom.
- Parameters:
downloadDbLogFilePortionRequest
-- Returns:
- Result of the DownloadDBLogFilePortion operation returned by the service.
- Throws:
DbInstanceNotFoundException
-DBInstanceIdentifier
doesn't refer to an existing DB instance.DbLogFileNotFoundException
-LogFileName
doesn't refer to an existing DB log file.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
downloadDBLogFilePortion
default DownloadDbLogFilePortionResponse downloadDBLogFilePortion(Consumer<DownloadDbLogFilePortionRequest.Builder> downloadDbLogFilePortionRequest) throws DbInstanceNotFoundException, DbLogFileNotFoundException, AwsServiceException, SdkClientException, RdsException
Downloads all or a portion of the specified log file, up to 1 MB in size.
This command doesn't apply to RDS Custom.
This is a convenience which creates an instance of the
DownloadDbLogFilePortionRequest.Builder
avoiding the need to create one manually viaDownloadDbLogFilePortionRequest.builder()
- Parameters:
downloadDbLogFilePortionRequest
- AConsumer
that will call methods onDownloadDbLogFilePortionRequest.Builder
to create a request.- Returns:
- Result of the DownloadDBLogFilePortion operation returned by the service.
- Throws:
DbInstanceNotFoundException
-DBInstanceIdentifier
doesn't refer to an existing DB instance.DbLogFileNotFoundException
-LogFileName
doesn't refer to an existing DB log file.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
downloadDBLogFilePortionPaginator
default DownloadDBLogFilePortionIterable downloadDBLogFilePortionPaginator(DownloadDbLogFilePortionRequest downloadDbLogFilePortionRequest) throws DbInstanceNotFoundException, DbLogFileNotFoundException, AwsServiceException, SdkClientException, RdsException
This is a variant of
downloadDBLogFilePortion(software.amazon.awssdk.services.rds.model.DownloadDbLogFilePortionRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DownloadDBLogFilePortionIterable responses = client.downloadDBLogFilePortionPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DownloadDBLogFilePortionIterable responses = client .downloadDBLogFilePortionPaginator(request); for (software.amazon.awssdk.services.rds.model.DownloadDbLogFilePortionResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DownloadDBLogFilePortionIterable responses = client.downloadDBLogFilePortionPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of NumberOfLines 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
downloadDBLogFilePortion(software.amazon.awssdk.services.rds.model.DownloadDbLogFilePortionRequest)
operation.- Parameters:
downloadDbLogFilePortionRequest
-- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
DbInstanceNotFoundException
-DBInstanceIdentifier
doesn't refer to an existing DB instance.DbLogFileNotFoundException
-LogFileName
doesn't refer to an existing DB log file.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
downloadDBLogFilePortionPaginator
default DownloadDBLogFilePortionIterable downloadDBLogFilePortionPaginator(Consumer<DownloadDbLogFilePortionRequest.Builder> downloadDbLogFilePortionRequest) throws DbInstanceNotFoundException, DbLogFileNotFoundException, AwsServiceException, SdkClientException, RdsException
This is a variant of
downloadDBLogFilePortion(software.amazon.awssdk.services.rds.model.DownloadDbLogFilePortionRequest)
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 Streamsoftware.amazon.awssdk.services.rds.paginators.DownloadDBLogFilePortionIterable responses = client.downloadDBLogFilePortionPaginator(request); responses.stream().forEach(....);
{ @code software.amazon.awssdk.services.rds.paginators.DownloadDBLogFilePortionIterable responses = client .downloadDBLogFilePortionPaginator(request); for (software.amazon.awssdk.services.rds.model.DownloadDbLogFilePortionResponse response : responses) { // do something; } }
3) Use iterator directlysoftware.amazon.awssdk.services.rds.paginators.DownloadDBLogFilePortionIterable responses = client.downloadDBLogFilePortionPaginator(request); responses.iterator().forEachRemaining(....);
Please notice that the configuration of NumberOfLines 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
downloadDBLogFilePortion(software.amazon.awssdk.services.rds.model.DownloadDbLogFilePortionRequest)
operation.
This is a convenience which creates an instance of the
DownloadDbLogFilePortionRequest.Builder
avoiding the need to create one manually viaDownloadDbLogFilePortionRequest.builder()
- Parameters:
downloadDbLogFilePortionRequest
- AConsumer
that will call methods onDownloadDbLogFilePortionRequest.Builder
to create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
DbInstanceNotFoundException
-DBInstanceIdentifier
doesn't refer to an existing DB instance.DbLogFileNotFoundException
-LogFileName
doesn't refer to an existing DB log file.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
enableHttpEndpoint
default EnableHttpEndpointResponse enableHttpEndpoint(EnableHttpEndpointRequest enableHttpEndpointRequest) throws ResourceNotFoundException, InvalidResourceStateException, AwsServiceException, SdkClientException, RdsException
Enables the HTTP endpoint for the DB cluster. By default, the HTTP endpoint isn't enabled.
When enabled, this endpoint provides a connectionless web service API (RDS Data API) for running SQL queries on the Aurora DB cluster. You can also query your database from inside the RDS console with the RDS query editor.
For more information, see Using RDS Data API in the Amazon Aurora User Guide.
This operation applies only to Aurora PostgreSQL Serverless v2 and provisioned DB clusters. To enable the HTTP endpoint for Aurora Serverless v1 DB clusters, use the
EnableHttpEndpoint
parameter of theModifyDBCluster
operation.- Parameters:
enableHttpEndpointRequest
-- Returns:
- Result of the EnableHttpEndpoint operation returned by the service.
- Throws:
ResourceNotFoundException
- The specified resource ID was not found.InvalidResourceStateException
- The operation can't be performed because another operation is in progress.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
enableHttpEndpoint
default EnableHttpEndpointResponse enableHttpEndpoint(Consumer<EnableHttpEndpointRequest.Builder> enableHttpEndpointRequest) throws ResourceNotFoundException, InvalidResourceStateException, AwsServiceException, SdkClientException, RdsException
Enables the HTTP endpoint for the DB cluster. By default, the HTTP endpoint isn't enabled.
When enabled, this endpoint provides a connectionless web service API (RDS Data API) for running SQL queries on the Aurora DB cluster. You can also query your database from inside the RDS console with the RDS query editor.
For more information, see Using RDS Data API in the Amazon Aurora User Guide.
This operation applies only to Aurora PostgreSQL Serverless v2 and provisioned DB clusters. To enable the HTTP endpoint for Aurora Serverless v1 DB clusters, use the
EnableHttpEndpoint
parameter of theModifyDBCluster
operation.
This is a convenience which creates an instance of the
EnableHttpEndpointRequest.Builder
avoiding the need to create one manually viaEnableHttpEndpointRequest.builder()
- Parameters:
enableHttpEndpointRequest
- AConsumer
that will call methods onEnableHttpEndpointRequest.Builder
to create a request.- Returns:
- Result of the EnableHttpEndpoint operation returned by the service.
- Throws:
ResourceNotFoundException
- The specified resource ID was not found.InvalidResourceStateException
- The operation can't be performed because another operation is in progress.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
failoverDBCluster
default FailoverDbClusterResponse failoverDBCluster(FailoverDbClusterRequest failoverDbClusterRequest) throws DbClusterNotFoundException, InvalidDbClusterStateException, InvalidDbInstanceStateException, AwsServiceException, SdkClientException, RdsException
Forces a failover for a DB cluster.
For an Aurora DB cluster, failover for a DB cluster promotes one of the Aurora Replicas (read-only instances) in the DB cluster to be the primary DB instance (the cluster writer).
For a Multi-AZ DB cluster, after RDS terminates the primary DB instance, the internal monitoring system detects that the primary DB instance is unhealthy and promotes a readable standby (read-only instances) in the DB cluster to be the primary DB instance (the cluster writer). Failover times are typically less than 35 seconds.
An Amazon Aurora DB cluster automatically fails over to an Aurora Replica, if one exists, when the primary DB instance fails. A Multi-AZ DB cluster automatically fails over to a readable standby DB instance when the primary DB instance fails.
To simulate a failure of a primary instance for testing, you can force a failover. Because each instance in a DB cluster has its own endpoint address, make sure to clean up and re-establish any existing connections that use those endpoint addresses when the failover is complete.
For more information on Amazon Aurora DB clusters, see What is Amazon Aurora? in the Amazon Aurora User Guide.
For more information on Multi-AZ DB clusters, see Multi-AZ DB cluster deployments in the Amazon RDS User Guide.
- Parameters:
failoverDbClusterRequest
-- Returns:
- Result of the FailoverDBCluster operation returned by the service.
- Throws:
DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.InvalidDbClusterStateException
- The requested operation can't be performed while the cluster is in this state.InvalidDbInstanceStateException
- The DB instance isn't in a valid state.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
failoverDBCluster
default FailoverDbClusterResponse failoverDBCluster(Consumer<FailoverDbClusterRequest.Builder> failoverDbClusterRequest) throws DbClusterNotFoundException, InvalidDbClusterStateException, InvalidDbInstanceStateException, AwsServiceException, SdkClientException, RdsException
Forces a failover for a DB cluster.
For an Aurora DB cluster, failover for a DB cluster promotes one of the Aurora Replicas (read-only instances) in the DB cluster to be the primary DB instance (the cluster writer).
For a Multi-AZ DB cluster, after RDS terminates the primary DB instance, the internal monitoring system detects that the primary DB instance is unhealthy and promotes a readable standby (read-only instances) in the DB cluster to be the primary DB instance (the cluster writer). Failover times are typically less than 35 seconds.
An Amazon Aurora DB cluster automatically fails over to an Aurora Replica, if one exists, when the primary DB instance fails. A Multi-AZ DB cluster automatically fails over to a readable standby DB instance when the primary DB instance fails.
To simulate a failure of a primary instance for testing, you can force a failover. Because each instance in a DB cluster has its own endpoint address, make sure to clean up and re-establish any existing connections that use those endpoint addresses when the failover is complete.
For more information on Amazon Aurora DB clusters, see What is Amazon Aurora? in the Amazon Aurora User Guide.
For more information on Multi-AZ DB clusters, see Multi-AZ DB cluster deployments in the Amazon RDS User Guide.
This is a convenience which creates an instance of the
FailoverDbClusterRequest.Builder
avoiding the need to create one manually viaFailoverDbClusterRequest.builder()
- Parameters:
failoverDbClusterRequest
- AConsumer
that will call methods onFailoverDbClusterRequest.Builder
to create a request.- Returns:
- Result of the FailoverDBCluster operation returned by the service.
- Throws:
DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.InvalidDbClusterStateException
- The requested operation can't be performed while the cluster is in this state.InvalidDbInstanceStateException
- The DB instance isn't in a valid state.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
failoverGlobalCluster
default FailoverGlobalClusterResponse failoverGlobalCluster(FailoverGlobalClusterRequest failoverGlobalClusterRequest) throws GlobalClusterNotFoundException, InvalidGlobalClusterStateException, InvalidDbClusterStateException, DbClusterNotFoundException, AwsServiceException, SdkClientException, RdsException
Promotes the specified secondary DB cluster to be the primary DB cluster in the global database cluster to fail over or switch over a global database. Switchover operations were previously called "managed planned failovers."
Although this operation can be used either to fail over or to switch over a global database cluster, its intended use is for global database failover. To switch over a global database cluster, we recommend that you use the SwitchoverGlobalCluster operation instead.
How you use this operation depends on whether you are failing over or switching over your global database cluster:
-
Failing over - Specify the
AllowDataLoss
parameter and don't specify theSwitchover
parameter. -
Switching over - Specify the
Switchover
parameter or omit it, but don't specify theAllowDataLoss
parameter.
About failing over and switching over
While failing over and switching over a global database cluster both change the primary DB cluster, you use these operations for different reasons:
-
Failing over - Use this operation to respond to an unplanned event, such as a Regional disaster in the primary Region. Failing over can result in a loss of write transaction data that wasn't replicated to the chosen secondary before the failover event occurred. However, the recovery process that promotes a DB instance on the chosen seconday DB cluster to be the primary writer DB instance guarantees that the data is in a transactionally consistent state.
For more information about failing over an Amazon Aurora global database, see Performing managed failovers for Aurora global databases in the Amazon Aurora User Guide.
-
Switching over - Use this operation on a healthy global database cluster for planned events, such as Regional rotation or to fail back to the original primary DB cluster after a failover operation. With this operation, there is no data loss.
For more information about switching over an Amazon Aurora global database, see Performing switchovers for Aurora global databases in the Amazon Aurora User Guide.
- Parameters:
failoverGlobalClusterRequest
-- Returns:
- Result of the FailoverGlobalCluster operation returned by the service.
- Throws:
GlobalClusterNotFoundException
- TheGlobalClusterIdentifier
doesn't refer to an existing global database cluster.InvalidGlobalClusterStateException
- The global cluster is in an invalid state and can't perform the requested operation.InvalidDbClusterStateException
- The requested operation can't be performed while the cluster is in this state.DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
-
failoverGlobalCluster
default FailoverGlobalClusterResponse failoverGlobalCluster(Consumer<FailoverGlobalClusterRequest.Builder> failoverGlobalClusterRequest) throws GlobalClusterNotFoundException, InvalidGlobalClusterStateException, InvalidDbClusterStateException, DbClusterNotFoundException, AwsServiceException, SdkClientException, RdsException
Promotes the specified secondary DB cluster to be the primary DB cluster in the global database cluster to fail over or switch over a global database. Switchover operations were previously called "managed planned failovers."
Although this operation can be used either to fail over or to switch over a global database cluster, its intended use is for global database failover. To switch over a global database cluster, we recommend that you use the SwitchoverGlobalCluster operation instead.
How you use this operation depends on whether you are failing over or switching over your global database cluster:
-
Failing over - Specify the
AllowDataLoss
parameter and don't specify theSwitchover
parameter. -
Switching over - Specify the
Switchover
parameter or omit it, but don't specify theAllowDataLoss
parameter.
About failing over and switching over
While failing over and switching over a global database cluster both change the primary DB cluster, you use these operations for different reasons:
-
Failing over - Use this operation to respond to an unplanned event, such as a Regional disaster in the primary Region. Failing over can result in a loss of write transaction data that wasn't replicated to the chosen secondary before the failover event occurred. However, the recovery process that promotes a DB instance on the chosen seconday DB cluster to be the primary writer DB instance guarantees that the data is in a transactionally consistent state.
For more information about failing over an Amazon Aurora global database, see Performing managed failovers for Aurora global databases in the Amazon Aurora User Guide.
-
Switching over - Use this operation on a healthy global database cluster for planned events, such as Regional rotation or to fail back to the original primary DB cluster after a failover operation. With this operation, there is no data loss.
For more information about switching over an Amazon Aurora global database, see Performing switchovers for Aurora global databases in the Amazon Aurora User Guide.
This is a convenience which creates an instance of the
FailoverGlobalClusterRequest.Builder
avoiding the need to create one manually viaFailoverGlobalClusterRequest.builder()
- Parameters:
failoverGlobalClusterRequest
- AConsumer
that will call methods onFailoverGlobalClusterRequest.Builder
to create a request.- Returns:
- Result of the FailoverGlobalCluster operation returned by the service.
- Throws:
GlobalClusterNotFoundException
- TheGlobalClusterIdentifier
doesn't refer to an existing global database cluster.InvalidGlobalClusterStateException
- The global cluster is in an invalid state and can't perform the requested operation.InvalidDbClusterStateException
- The requested operation can't be performed while the cluster is in this state.DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
-
listTagsForResource
default ListTagsForResourceResponse listTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest) throws DbInstanceNotFoundException, DbSnapshotNotFoundException, DbClusterNotFoundException, DbProxyNotFoundException, DbProxyTargetGroupNotFoundException, BlueGreenDeploymentNotFoundException, IntegrationNotFoundException, TenantDatabaseNotFoundException, DbSnapshotTenantDatabaseNotFoundException, AwsServiceException, SdkClientException, RdsException
Lists all tags on an Amazon RDS resource.
For an overview on tagging an Amazon RDS resource, see Tagging Amazon RDS Resources in the Amazon RDS User Guide or Tagging Amazon Aurora and Amazon RDS Resources in the Amazon Aurora User Guide.
- Parameters:
listTagsForResourceRequest
-- Returns:
- Result of the ListTagsForResource operation returned by the service.
- Throws:
DbInstanceNotFoundException
-DBInstanceIdentifier
doesn't refer to an existing DB instance.DbSnapshotNotFoundException
-DBSnapshotIdentifier
doesn't refer to an existing DB snapshot.DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.DbProxyNotFoundException
- The specified proxy name doesn't correspond to a proxy owned by your Amazon Web Services account in the specified Amazon Web Services Region.DbProxyTargetGroupNotFoundException
- The specified target group isn't available for a proxy owned by your Amazon Web Services account in the specified Amazon Web Services Region.BlueGreenDeploymentNotFoundException
-BlueGreenDeploymentIdentifier
doesn't refer to an existing blue/green deployment.IntegrationNotFoundException
- The specified integration could not be found.TenantDatabaseNotFoundException
- The specified tenant database wasn't found in the DB instance.DbSnapshotTenantDatabaseNotFoundException
- The specified snapshot tenant database wasn't found.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
listTagsForResource
default ListTagsForResourceResponse listTagsForResource(Consumer<ListTagsForResourceRequest.Builder> listTagsForResourceRequest) throws DbInstanceNotFoundException, DbSnapshotNotFoundException, DbClusterNotFoundException, DbProxyNotFoundException, DbProxyTargetGroupNotFoundException, BlueGreenDeploymentNotFoundException, IntegrationNotFoundException, TenantDatabaseNotFoundException, DbSnapshotTenantDatabaseNotFoundException, AwsServiceException, SdkClientException, RdsException
Lists all tags on an Amazon RDS resource.
For an overview on tagging an Amazon RDS resource, see Tagging Amazon RDS Resources in the Amazon RDS User Guide or Tagging Amazon Aurora and Amazon RDS Resources in the Amazon Aurora User Guide.
This is a convenience which creates an instance of the
ListTagsForResourceRequest.Builder
avoiding the need to create one manually viaListTagsForResourceRequest.builder()
- Parameters:
listTagsForResourceRequest
- AConsumer
that will call methods onListTagsForResourceRequest.Builder
to create a request.- Returns:
- Result of the ListTagsForResource operation returned by the service.
- Throws:
DbInstanceNotFoundException
-DBInstanceIdentifier
doesn't refer to an existing DB instance.DbSnapshotNotFoundException
-DBSnapshotIdentifier
doesn't refer to an existing DB snapshot.DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.DbProxyNotFoundException
- The specified proxy name doesn't correspond to a proxy owned by your Amazon Web Services account in the specified Amazon Web Services Region.DbProxyTargetGroupNotFoundException
- The specified target group isn't available for a proxy owned by your Amazon Web Services account in the specified Amazon Web Services Region.BlueGreenDeploymentNotFoundException
-BlueGreenDeploymentIdentifier
doesn't refer to an existing blue/green deployment.IntegrationNotFoundException
- The specified integration could not be found.TenantDatabaseNotFoundException
- The specified tenant database wasn't found in the DB instance.DbSnapshotTenantDatabaseNotFoundException
- The specified snapshot tenant database wasn't found.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
modifyActivityStream
default ModifyActivityStreamResponse modifyActivityStream(ModifyActivityStreamRequest modifyActivityStreamRequest) throws InvalidDbInstanceStateException, ResourceNotFoundException, DbInstanceNotFoundException, AwsServiceException, SdkClientException, RdsException
Changes the audit policy state of a database activity stream to either locked (default) or unlocked. A locked policy is read-only, whereas an unlocked policy is read/write. If your activity stream is started and locked, you can unlock it, customize your audit policy, and then lock your activity stream. Restarting the activity stream isn't required. For more information, see Modifying a database activity stream in the Amazon RDS User Guide.
This operation is supported for RDS for Oracle and Microsoft SQL Server.
- Parameters:
modifyActivityStreamRequest
-- Returns:
- Result of the ModifyActivityStream operation returned by the service.
- Throws:
InvalidDbInstanceStateException
- The DB instance isn't in a valid state.ResourceNotFoundException
- The specified resource ID was not found.DbInstanceNotFoundException
-DBInstanceIdentifier
doesn't refer to an existing DB instance.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
modifyActivityStream
default ModifyActivityStreamResponse modifyActivityStream(Consumer<ModifyActivityStreamRequest.Builder> modifyActivityStreamRequest) throws InvalidDbInstanceStateException, ResourceNotFoundException, DbInstanceNotFoundException, AwsServiceException, SdkClientException, RdsException
Changes the audit policy state of a database activity stream to either locked (default) or unlocked. A locked policy is read-only, whereas an unlocked policy is read/write. If your activity stream is started and locked, you can unlock it, customize your audit policy, and then lock your activity stream. Restarting the activity stream isn't required. For more information, see Modifying a database activity stream in the Amazon RDS User Guide.
This operation is supported for RDS for Oracle and Microsoft SQL Server.
This is a convenience which creates an instance of the
ModifyActivityStreamRequest.Builder
avoiding the need to create one manually viaModifyActivityStreamRequest.builder()
- Parameters:
modifyActivityStreamRequest
- AConsumer
that will call methods onModifyActivityStreamRequest.Builder
to create a request.- Returns:
- Result of the ModifyActivityStream operation returned by the service.
- Throws:
InvalidDbInstanceStateException
- The DB instance isn't in a valid state.ResourceNotFoundException
- The specified resource ID was not found.DbInstanceNotFoundException
-DBInstanceIdentifier
doesn't refer to an existing DB instance.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
modifyCertificates
default ModifyCertificatesResponse modifyCertificates(ModifyCertificatesRequest modifyCertificatesRequest) throws CertificateNotFoundException, AwsServiceException, SdkClientException, RdsException
Override the system-default Secure Sockets Layer/Transport Layer Security (SSL/TLS) certificate for Amazon RDS for new DB instances, or remove the override.
By using this operation, you can specify an RDS-approved SSL/TLS certificate for new DB instances that is different from the default certificate provided by RDS. You can also use this operation to remove the override, so that new DB instances use the default certificate provided by RDS.
You might need to override the default certificate in the following situations:
-
You already migrated your applications to support the latest certificate authority (CA) certificate, but the new CA certificate is not yet the RDS default CA certificate for the specified Amazon Web Services Region.
-
RDS has already moved to a new default CA certificate for the specified Amazon Web Services Region, but you are still in the process of supporting the new CA certificate. In this case, you temporarily need additional time to finish your application changes.
For more information about rotating your SSL/TLS certificate for RDS DB engines, see Rotating Your SSL/TLS Certificate in the Amazon RDS User Guide.
For more information about rotating your SSL/TLS certificate for Aurora DB engines, see Rotating Your SSL/TLS Certificate in the Amazon Aurora User Guide.
- Parameters:
modifyCertificatesRequest
-- Returns:
- Result of the ModifyCertificates operation returned by the service.
- Throws:
CertificateNotFoundException
-CertificateIdentifier
doesn't refer to an existing certificate.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
-
modifyCertificates
default ModifyCertificatesResponse modifyCertificates(Consumer<ModifyCertificatesRequest.Builder> modifyCertificatesRequest) throws CertificateNotFoundException, AwsServiceException, SdkClientException, RdsException
Override the system-default Secure Sockets Layer/Transport Layer Security (SSL/TLS) certificate for Amazon RDS for new DB instances, or remove the override.
By using this operation, you can specify an RDS-approved SSL/TLS certificate for new DB instances that is different from the default certificate provided by RDS. You can also use this operation to remove the override, so that new DB instances use the default certificate provided by RDS.
You might need to override the default certificate in the following situations:
-
You already migrated your applications to support the latest certificate authority (CA) certificate, but the new CA certificate is not yet the RDS default CA certificate for the specified Amazon Web Services Region.
-
RDS has already moved to a new default CA certificate for the specified Amazon Web Services Region, but you are still in the process of supporting the new CA certificate. In this case, you temporarily need additional time to finish your application changes.
For more information about rotating your SSL/TLS certificate for RDS DB engines, see Rotating Your SSL/TLS Certificate in the Amazon RDS User Guide.
For more information about rotating your SSL/TLS certificate for Aurora DB engines, see Rotating Your SSL/TLS Certificate in the Amazon Aurora User Guide.
This is a convenience which creates an instance of the
ModifyCertificatesRequest.Builder
avoiding the need to create one manually viaModifyCertificatesRequest.builder()
- Parameters:
modifyCertificatesRequest
- AConsumer
that will call methods onModifyCertificatesRequest.Builder
to create a request.- Returns:
- Result of the ModifyCertificates operation returned by the service.
- Throws:
CertificateNotFoundException
-CertificateIdentifier
doesn't refer to an existing certificate.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
-
modifyCurrentDBClusterCapacity
default ModifyCurrentDbClusterCapacityResponse modifyCurrentDBClusterCapacity(ModifyCurrentDbClusterCapacityRequest modifyCurrentDbClusterCapacityRequest) throws DbClusterNotFoundException, InvalidDbClusterStateException, InvalidDbClusterCapacityException, AwsServiceException, SdkClientException, RdsException
Set the capacity of an Aurora Serverless v1 DB cluster to a specific value.
Aurora Serverless v1 scales seamlessly based on the workload on the DB cluster. In some cases, the capacity might not scale fast enough to meet a sudden change in workload, such as a large number of new transactions. Call
ModifyCurrentDBClusterCapacity
to set the capacity explicitly.After this call sets the DB cluster capacity, Aurora Serverless v1 can automatically scale the DB cluster based on the cooldown period for scaling up and the cooldown period for scaling down.
For more information about Aurora Serverless v1, see Using Amazon Aurora Serverless v1 in the Amazon Aurora User Guide.
If you call
ModifyCurrentDBClusterCapacity
with the defaultTimeoutAction
, connections that prevent Aurora Serverless v1 from finding a scaling point might be dropped. For more information about scaling points, see Autoscaling for Aurora Serverless v1 in the Amazon Aurora User Guide.This operation only applies to Aurora Serverless v1 DB clusters.
- Parameters:
modifyCurrentDbClusterCapacityRequest
-- Returns:
- Result of the ModifyCurrentDBClusterCapacity operation returned by the service.
- Throws:
DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.InvalidDbClusterStateException
- The requested operation can't be performed while the cluster is in this state.InvalidDbClusterCapacityException
-Capacity
isn't a valid Aurora Serverless DB cluster capacity. Valid capacity values are2
,4
,8
,16
,32
,64
,128
, and256
.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
modifyCurrentDBClusterCapacity
default ModifyCurrentDbClusterCapacityResponse modifyCurrentDBClusterCapacity(Consumer<ModifyCurrentDbClusterCapacityRequest.Builder> modifyCurrentDbClusterCapacityRequest) throws DbClusterNotFoundException, InvalidDbClusterStateException, InvalidDbClusterCapacityException, AwsServiceException, SdkClientException, RdsException
Set the capacity of an Aurora Serverless v1 DB cluster to a specific value.
Aurora Serverless v1 scales seamlessly based on the workload on the DB cluster. In some cases, the capacity might not scale fast enough to meet a sudden change in workload, such as a large number of new transactions. Call
ModifyCurrentDBClusterCapacity
to set the capacity explicitly.After this call sets the DB cluster capacity, Aurora Serverless v1 can automatically scale the DB cluster based on the cooldown period for scaling up and the cooldown period for scaling down.
For more information about Aurora Serverless v1, see Using Amazon Aurora Serverless v1 in the Amazon Aurora User Guide.
If you call
ModifyCurrentDBClusterCapacity
with the defaultTimeoutAction
, connections that prevent Aurora Serverless v1 from finding a scaling point might be dropped. For more information about scaling points, see Autoscaling for Aurora Serverless v1 in the Amazon Aurora User Guide.This operation only applies to Aurora Serverless v1 DB clusters.
This is a convenience which creates an instance of the
ModifyCurrentDbClusterCapacityRequest.Builder
avoiding the need to create one manually viaModifyCurrentDbClusterCapacityRequest.builder()
- Parameters:
modifyCurrentDbClusterCapacityRequest
- AConsumer
that will call methods onModifyCurrentDbClusterCapacityRequest.Builder
to create a request.- Returns:
- Result of the ModifyCurrentDBClusterCapacity operation returned by the service.
- Throws:
DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.InvalidDbClusterStateException
- The requested operation can't be performed while the cluster is in this state.InvalidDbClusterCapacityException
-Capacity
isn't a valid Aurora Serverless DB cluster capacity. Valid capacity values are2
,4
,8
,16
,32
,64
,128
, and256
.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
modifyCustomDBEngineVersion
default ModifyCustomDbEngineVersionResponse modifyCustomDBEngineVersion(ModifyCustomDbEngineVersionRequest modifyCustomDbEngineVersionRequest) throws CustomDbEngineVersionNotFoundException, InvalidCustomDbEngineVersionStateException, AwsServiceException, SdkClientException, RdsException
Modifies the status of a custom engine version (CEV). You can find CEVs to modify by calling
DescribeDBEngineVersions
.The MediaImport service that imports files from Amazon S3 to create CEVs isn't integrated with Amazon Web Services CloudTrail. If you turn on data logging for Amazon RDS in CloudTrail, calls to the
ModifyCustomDbEngineVersion
event aren't logged. However, you might see calls from the API gateway that accesses your Amazon S3 bucket. These calls originate from the MediaImport service for theModifyCustomDbEngineVersion
event.For more information, see Modifying CEV status in the Amazon RDS User Guide.
- Parameters:
modifyCustomDbEngineVersionRequest
-- Returns:
- Result of the ModifyCustomDBEngineVersion operation returned by the service.
- Throws:
CustomDbEngineVersionNotFoundException
- The specified CEV was not found.InvalidCustomDbEngineVersionStateException
- You can't delete the CEV.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
modifyCustomDBEngineVersion
default ModifyCustomDbEngineVersionResponse modifyCustomDBEngineVersion(Consumer<ModifyCustomDbEngineVersionRequest.Builder> modifyCustomDbEngineVersionRequest) throws CustomDbEngineVersionNotFoundException, InvalidCustomDbEngineVersionStateException, AwsServiceException, SdkClientException, RdsException
Modifies the status of a custom engine version (CEV). You can find CEVs to modify by calling
DescribeDBEngineVersions
.The MediaImport service that imports files from Amazon S3 to create CEVs isn't integrated with Amazon Web Services CloudTrail. If you turn on data logging for Amazon RDS in CloudTrail, calls to the
ModifyCustomDbEngineVersion
event aren't logged. However, you might see calls from the API gateway that accesses your Amazon S3 bucket. These calls originate from the MediaImport service for theModifyCustomDbEngineVersion
event.For more information, see Modifying CEV status in the Amazon RDS User Guide.
This is a convenience which creates an instance of the
ModifyCustomDbEngineVersionRequest.Builder
avoiding the need to create one manually viaModifyCustomDbEngineVersionRequest.builder()
- Parameters:
modifyCustomDbEngineVersionRequest
- AConsumer
that will call methods onModifyCustomDbEngineVersionRequest.Builder
to create a request.- Returns:
- Result of the ModifyCustomDBEngineVersion operation returned by the service.
- Throws:
CustomDbEngineVersionNotFoundException
- The specified CEV was not found.InvalidCustomDbEngineVersionStateException
- You can't delete the CEV.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
modifyDBCluster
default ModifyDbClusterResponse modifyDBCluster(ModifyDbClusterRequest modifyDbClusterRequest) throws DbClusterNotFoundException, InvalidDbClusterStateException, StorageQuotaExceededException, DbSubnetGroupNotFoundException, InvalidVpcNetworkStateException, InvalidDbSubnetGroupStateException, InvalidSubnetException, DbClusterParameterGroupNotFoundException, InvalidDbSecurityGroupStateException, InvalidDbInstanceStateException, DbClusterAlreadyExistsException, DbInstanceAlreadyExistsException, DomainNotFoundException, StorageTypeNotAvailableException, OptionGroupNotFoundException, AwsServiceException, SdkClientException, RdsException
Modifies the settings of an Amazon Aurora DB cluster or a Multi-AZ DB cluster. You can change one or more settings by specifying these parameters and the new values in the request.
For more information on Amazon Aurora DB clusters, see What is Amazon Aurora? in the Amazon Aurora User Guide.
For more information on Multi-AZ DB clusters, see Multi-AZ DB cluster deployments in the Amazon RDS User Guide.
- Parameters:
modifyDbClusterRequest
-- Returns:
- Result of the ModifyDBCluster operation returned by the service.
- Throws:
DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.InvalidDbClusterStateException
- The requested operation can't be performed while the cluster is in this state.StorageQuotaExceededException
- The request would result in the user exceeding the allowed amount of storage available across all DB instances.DbSubnetGroupNotFoundException
-DBSubnetGroupName
doesn't refer to an existing DB subnet group.InvalidVpcNetworkStateException
- The DB subnet group doesn't cover all Availability Zones after it's created because of users' change.InvalidDbSubnetGroupStateException
- The DB subnet group cannot be deleted because it's in use.InvalidSubnetException
- The requested subnet is invalid, or multiple subnets were requested that are not all in a common VPC.DbClusterParameterGroupNotFoundException
-DBClusterParameterGroupName
doesn't refer to an existing DB cluster parameter group.InvalidDbSecurityGroupStateException
- The state of the DB security group doesn't allow deletion.InvalidDbInstanceStateException
- The DB instance isn't in a valid state.DbClusterAlreadyExistsException
- The user already has a DB cluster with the given identifier.DbInstanceAlreadyExistsException
- The user already has a DB instance with the given identifier.DomainNotFoundException
-Domain
doesn't refer to an existing Active Directory domain.StorageTypeNotAvailableException
- Theaurora-iopt1
storage type isn't available, because you modified the DB cluster to use this storage type less than one month ago.OptionGroupNotFoundException
- The specified option group could not be found.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
modifyDBCluster
default ModifyDbClusterResponse modifyDBCluster(Consumer<ModifyDbClusterRequest.Builder> modifyDbClusterRequest) throws DbClusterNotFoundException, InvalidDbClusterStateException, StorageQuotaExceededException, DbSubnetGroupNotFoundException, InvalidVpcNetworkStateException, InvalidDbSubnetGroupStateException, InvalidSubnetException, DbClusterParameterGroupNotFoundException, InvalidDbSecurityGroupStateException, InvalidDbInstanceStateException, DbClusterAlreadyExistsException, DbInstanceAlreadyExistsException, DomainNotFoundException, StorageTypeNotAvailableException, OptionGroupNotFoundException, AwsServiceException, SdkClientException, RdsException
Modifies the settings of an Amazon Aurora DB cluster or a Multi-AZ DB cluster. You can change one or more settings by specifying these parameters and the new values in the request.
For more information on Amazon Aurora DB clusters, see What is Amazon Aurora? in the Amazon Aurora User Guide.
For more information on Multi-AZ DB clusters, see Multi-AZ DB cluster deployments in the Amazon RDS User Guide.
This is a convenience which creates an instance of the
ModifyDbClusterRequest.Builder
avoiding the need to create one manually viaModifyDbClusterRequest.builder()
- Parameters:
modifyDbClusterRequest
- AConsumer
that will call methods onModifyDbClusterRequest.Builder
to create a request.- Returns:
- Result of the ModifyDBCluster operation returned by the service.
- Throws:
DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.InvalidDbClusterStateException
- The requested operation can't be performed while the cluster is in this state.StorageQuotaExceededException
- The request would result in the user exceeding the allowed amount of storage available across all DB instances.DbSubnetGroupNotFoundException
-DBSubnetGroupName
doesn't refer to an existing DB subnet group.InvalidVpcNetworkStateException
- The DB subnet group doesn't cover all Availability Zones after it's created because of users' change.InvalidDbSubnetGroupStateException
- The DB subnet group cannot be deleted because it's in use.InvalidSubnetException
- The requested subnet is invalid, or multiple subnets were requested that are not all in a common VPC.DbClusterParameterGroupNotFoundException
-DBClusterParameterGroupName
doesn't refer to an existing DB cluster parameter group.InvalidDbSecurityGroupStateException
- The state of the DB security group doesn't allow deletion.InvalidDbInstanceStateException
- The DB instance isn't in a valid state.DbClusterAlreadyExistsException
- The user already has a DB cluster with the given identifier.DbInstanceAlreadyExistsException
- The user already has a DB instance with the given identifier.DomainNotFoundException
-Domain
doesn't refer to an existing Active Directory domain.StorageTypeNotAvailableException
- Theaurora-iopt1
storage type isn't available, because you modified the DB cluster to use this storage type less than one month ago.OptionGroupNotFoundException
- The specified option group could not be found.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
modifyDBClusterEndpoint
default ModifyDbClusterEndpointResponse modifyDBClusterEndpoint(ModifyDbClusterEndpointRequest modifyDbClusterEndpointRequest) throws InvalidDbClusterStateException, InvalidDbClusterEndpointStateException, DbClusterEndpointNotFoundException, DbInstanceNotFoundException, InvalidDbInstanceStateException, AwsServiceException, SdkClientException, RdsException
Modifies the properties of an endpoint in an Amazon Aurora DB cluster.
This operation only applies to Aurora DB clusters.
- Parameters:
modifyDbClusterEndpointRequest
-- Returns:
- Result of the ModifyDBClusterEndpoint operation returned by the service.
- Throws:
InvalidDbClusterStateException
- The requested operation can't be performed while the cluster is in this state.InvalidDbClusterEndpointStateException
- The requested operation can't be performed on the endpoint while the endpoint is in this state.DbClusterEndpointNotFoundException
- The specified custom endpoint doesn't exist.DbInstanceNotFoundException
-DBInstanceIdentifier
doesn't refer to an existing DB instance.InvalidDbInstanceStateException
- The DB instance isn't in a valid state.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
modifyDBClusterEndpoint
default ModifyDbClusterEndpointResponse modifyDBClusterEndpoint(Consumer<ModifyDbClusterEndpointRequest.Builder> modifyDbClusterEndpointRequest) throws InvalidDbClusterStateException, InvalidDbClusterEndpointStateException, DbClusterEndpointNotFoundException, DbInstanceNotFoundException, InvalidDbInstanceStateException, AwsServiceException, SdkClientException, RdsException
Modifies the properties of an endpoint in an Amazon Aurora DB cluster.
This operation only applies to Aurora DB clusters.
This is a convenience which creates an instance of the
ModifyDbClusterEndpointRequest.Builder
avoiding the need to create one manually viaModifyDbClusterEndpointRequest.builder()
- Parameters:
modifyDbClusterEndpointRequest
- AConsumer
that will call methods onModifyDbClusterEndpointRequest.Builder
to create a request.- Returns:
- Result of the ModifyDBClusterEndpoint operation returned by the service.
- Throws:
InvalidDbClusterStateException
- The requested operation can't be performed while the cluster is in this state.InvalidDbClusterEndpointStateException
- The requested operation can't be performed on the endpoint while the endpoint is in this state.DbClusterEndpointNotFoundException
- The specified custom endpoint doesn't exist.DbInstanceNotFoundException
-DBInstanceIdentifier
doesn't refer to an existing DB instance.InvalidDbInstanceStateException
- The DB instance isn't in a valid state.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
modifyDBClusterParameterGroup
default ModifyDbClusterParameterGroupResponse modifyDBClusterParameterGroup(ModifyDbClusterParameterGroupRequest modifyDbClusterParameterGroupRequest) throws DbParameterGroupNotFoundException, InvalidDbParameterGroupStateException, AwsServiceException, SdkClientException, RdsException
Modifies the parameters of a DB cluster parameter group. To modify more than one parameter, submit a list of the following:
ParameterName
,ParameterValue
, andApplyMethod
. A maximum of 20 parameters can be modified in a single request.After you create a DB cluster parameter group, you should wait at least 5 minutes before creating your first DB cluster that uses that DB cluster parameter group as the default parameter group. This allows Amazon RDS to fully complete the create operation before the parameter group is used as the default for a new DB cluster. This is especially important for parameters that are critical when creating the default database for a DB cluster, such as the character set for the default database defined by the
character_set_database
parameter. You can use the Parameter Groups option of the Amazon RDS console or theDescribeDBClusterParameters
operation to verify that your DB cluster parameter group has been created or modified.If the modified DB cluster parameter group is used by an Aurora Serverless v1 cluster, Aurora applies the update immediately. The cluster restart might interrupt your workload. In that case, your application must reopen any connections and retry any transactions that were active when the parameter changes took effect.
For more information on Amazon Aurora DB clusters, see What is Amazon Aurora? in the Amazon Aurora User Guide.
For more information on Multi-AZ DB clusters, see Multi-AZ DB cluster deployments in the Amazon RDS User Guide.
- Parameters:
modifyDbClusterParameterGroupRequest
-- Returns:
- Result of the ModifyDBClusterParameterGroup operation returned by the service.
- Throws:
DbParameterGroupNotFoundException
-DBParameterGroupName
doesn't refer to an existing DB parameter group.InvalidDbParameterGroupStateException
- The DB parameter group is in use or is in an invalid state. If you are attempting to delete the parameter group, you can't delete it when the parameter group is in this state.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
modifyDBClusterParameterGroup
default ModifyDbClusterParameterGroupResponse modifyDBClusterParameterGroup(Consumer<ModifyDbClusterParameterGroupRequest.Builder> modifyDbClusterParameterGroupRequest) throws DbParameterGroupNotFoundException, InvalidDbParameterGroupStateException, AwsServiceException, SdkClientException, RdsException
Modifies the parameters of a DB cluster parameter group. To modify more than one parameter, submit a list of the following:
ParameterName
,ParameterValue
, andApplyMethod
. A maximum of 20 parameters can be modified in a single request.After you create a DB cluster parameter group, you should wait at least 5 minutes before creating your first DB cluster that uses that DB cluster parameter group as the default parameter group. This allows Amazon RDS to fully complete the create operation before the parameter group is used as the default for a new DB cluster. This is especially important for parameters that are critical when creating the default database for a DB cluster, such as the character set for the default database defined by the
character_set_database
parameter. You can use the Parameter Groups option of the Amazon RDS console or theDescribeDBClusterParameters
operation to verify that your DB cluster parameter group has been created or modified.If the modified DB cluster parameter group is used by an Aurora Serverless v1 cluster, Aurora applies the update immediately. The cluster restart might interrupt your workload. In that case, your application must reopen any connections and retry any transactions that were active when the parameter changes took effect.
For more information on Amazon Aurora DB clusters, see What is Amazon Aurora? in the Amazon Aurora User Guide.
For more information on Multi-AZ DB clusters, see Multi-AZ DB cluster deployments in the Amazon RDS User Guide.
This is a convenience which creates an instance of the
ModifyDbClusterParameterGroupRequest.Builder
avoiding the need to create one manually viaModifyDbClusterParameterGroupRequest.builder()
- Parameters:
modifyDbClusterParameterGroupRequest
- AConsumer
that will call methods onModifyDbClusterParameterGroupRequest.Builder
to create a request.- Returns:
- Result of the ModifyDBClusterParameterGroup operation returned by the service.
- Throws:
DbParameterGroupNotFoundException
-DBParameterGroupName
doesn't refer to an existing DB parameter group.InvalidDbParameterGroupStateException
- The DB parameter group is in use or is in an invalid state. If you are attempting to delete the parameter group, you can't delete it when the parameter group is in this state.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
modifyDBClusterSnapshotAttribute
default ModifyDbClusterSnapshotAttributeResponse modifyDBClusterSnapshotAttribute(ModifyDbClusterSnapshotAttributeRequest modifyDbClusterSnapshotAttributeRequest) throws DbClusterSnapshotNotFoundException, InvalidDbClusterSnapshotStateException, SharedSnapshotQuotaExceededException, AwsServiceException, SdkClientException, RdsException
Adds an attribute and values to, or removes an attribute and values from, a manual DB cluster snapshot.
To share a manual DB cluster snapshot with other Amazon Web Services accounts, specify
restore
as theAttributeName
and use theValuesToAdd
parameter to add a list of IDs of the Amazon Web Services accounts that are authorized to restore the manual DB cluster snapshot. Use the valueall
to make the manual DB cluster snapshot public, which means that it can be copied or restored by all Amazon Web Services accounts.Don't add the
all
value for any manual DB cluster snapshots that contain private information that you don't want available to all Amazon Web Services accounts.If a manual DB cluster snapshot is encrypted, it can be shared, but only by specifying a list of authorized Amazon Web Services account IDs for the
ValuesToAdd
parameter. You can't useall
as a value for that parameter in this case.To view which Amazon Web Services accounts have access to copy or restore a manual DB cluster snapshot, or whether a manual DB cluster snapshot is public or private, use the DescribeDBClusterSnapshotAttributes API operation. The accounts are returned as values for the
restore
attribute.- Parameters:
modifyDbClusterSnapshotAttributeRequest
-- Returns:
- Result of the ModifyDBClusterSnapshotAttribute operation returned by the service.
- Throws:
DbClusterSnapshotNotFoundException
-DBClusterSnapshotIdentifier
doesn't refer to an existing DB cluster snapshot.InvalidDbClusterSnapshotStateException
- The supplied value isn't a valid DB cluster snapshot state.SharedSnapshotQuotaExceededException
- You have exceeded the maximum number of accounts that you can share a manual DB snapshot with.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
modifyDBClusterSnapshotAttribute
default ModifyDbClusterSnapshotAttributeResponse modifyDBClusterSnapshotAttribute(Consumer<ModifyDbClusterSnapshotAttributeRequest.Builder> modifyDbClusterSnapshotAttributeRequest) throws DbClusterSnapshotNotFoundException, InvalidDbClusterSnapshotStateException, SharedSnapshotQuotaExceededException, AwsServiceException, SdkClientException, RdsException
Adds an attribute and values to, or removes an attribute and values from, a manual DB cluster snapshot.
To share a manual DB cluster snapshot with other Amazon Web Services accounts, specify
restore
as theAttributeName
and use theValuesToAdd
parameter to add a list of IDs of the Amazon Web Services accounts that are authorized to restore the manual DB cluster snapshot. Use the valueall
to make the manual DB cluster snapshot public, which means that it can be copied or restored by all Amazon Web Services accounts.Don't add the
all
value for any manual DB cluster snapshots that contain private information that you don't want available to all Amazon Web Services accounts.If a manual DB cluster snapshot is encrypted, it can be shared, but only by specifying a list of authorized Amazon Web Services account IDs for the
ValuesToAdd
parameter. You can't useall
as a value for that parameter in this case.To view which Amazon Web Services accounts have access to copy or restore a manual DB cluster snapshot, or whether a manual DB cluster snapshot is public or private, use the DescribeDBClusterSnapshotAttributes API operation. The accounts are returned as values for the
restore
attribute.
This is a convenience which creates an instance of the
ModifyDbClusterSnapshotAttributeRequest.Builder
avoiding the need to create one manually viaModifyDbClusterSnapshotAttributeRequest.builder()
- Parameters:
modifyDbClusterSnapshotAttributeRequest
- AConsumer
that will call methods onModifyDbClusterSnapshotAttributeRequest.Builder
to create a request.- Returns:
- Result of the ModifyDBClusterSnapshotAttribute operation returned by the service.
- Throws:
DbClusterSnapshotNotFoundException
-DBClusterSnapshotIdentifier
doesn't refer to an existing DB cluster snapshot.InvalidDbClusterSnapshotStateException
- The supplied value isn't a valid DB cluster snapshot state.SharedSnapshotQuotaExceededException
- You have exceeded the maximum number of accounts that you can share a manual DB snapshot with.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
modifyDBInstance
default ModifyDbInstanceResponse modifyDBInstance(ModifyDbInstanceRequest modifyDbInstanceRequest) throws InvalidDbInstanceStateException, InvalidDbSecurityGroupStateException, DbInstanceAlreadyExistsException, DbInstanceNotFoundException, DbSecurityGroupNotFoundException, DbParameterGroupNotFoundException, InsufficientDbInstanceCapacityException, StorageQuotaExceededException, InvalidVpcNetworkStateException, ProvisionedIopsNotAvailableInAzException, OptionGroupNotFoundException, DbUpgradeDependencyFailureException, StorageTypeNotSupportedException, AuthorizationNotFoundException, CertificateNotFoundException, DomainNotFoundException, KmsKeyNotAccessibleException, InvalidDbClusterStateException, NetworkTypeNotSupportedException, TenantDatabaseQuotaExceededException, AwsServiceException, SdkClientException, RdsException
Modifies settings for a DB instance. You can change one or more database configuration parameters by specifying these parameters and the new values in the request. To learn what modifications you can make to your DB instance, call
DescribeValidDBInstanceModifications
before you callModifyDBInstance
.- Parameters:
modifyDbInstanceRequest
-- Returns:
- Result of the ModifyDBInstance operation returned by the service.
- Throws:
InvalidDbInstanceStateException
- The DB instance isn't in a valid state.InvalidDbSecurityGroupStateException
- The state of the DB security group doesn't allow deletion.DbInstanceAlreadyExistsException
- The user already has a DB instance with the given identifier.DbInstanceNotFoundException
-DBInstanceIdentifier
doesn't refer to an existing DB instance.DbSecurityGroupNotFoundException
-DBSecurityGroupName
doesn't refer to an existing DB security group.DbParameterGroupNotFoundException
-DBParameterGroupName
doesn't refer to an existing DB parameter group.InsufficientDbInstanceCapacityException
- The specified DB instance class isn't available in the specified Availability Zone.StorageQuotaExceededException
- The request would result in the user exceeding the allowed amount of storage available across all DB instances.InvalidVpcNetworkStateException
- The DB subnet group doesn't cover all Availability Zones after it's created because of users' change.ProvisionedIopsNotAvailableInAzException
- Provisioned IOPS not available in the specified Availability Zone.OptionGroupNotFoundException
- The specified option group could not be found.DbUpgradeDependencyFailureException
- The DB upgrade failed because a resource the DB depends on can't be modified.StorageTypeNotSupportedException
- The specifiedStorageType
can't be associated with the DB instance.AuthorizationNotFoundException
- The specified CIDR IP range or Amazon EC2 security group might not be authorized for the specified DB security group.Or, RDS might not be authorized to perform necessary actions using IAM on your behalf.
CertificateNotFoundException
-CertificateIdentifier
doesn't refer to an existing certificate.DomainNotFoundException
-Domain
doesn't refer to an existing Active Directory domain.KmsKeyNotAccessibleException
- An error occurred accessing an Amazon Web Services KMS key.InvalidDbClusterStateException
- The requested operation can't be performed while the cluster is in this state.NetworkTypeNotSupportedException
- The network type is invalid for the DB instance. Valid nework type values areIPV4
andDUAL
.TenantDatabaseQuotaExceededException
- You attempted to create more tenant databases than are permitted in your Amazon Web Services account.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
modifyDBInstance
default ModifyDbInstanceResponse modifyDBInstance(Consumer<ModifyDbInstanceRequest.Builder> modifyDbInstanceRequest) throws InvalidDbInstanceStateException, InvalidDbSecurityGroupStateException, DbInstanceAlreadyExistsException, DbInstanceNotFoundException, DbSecurityGroupNotFoundException, DbParameterGroupNotFoundException, InsufficientDbInstanceCapacityException, StorageQuotaExceededException, InvalidVpcNetworkStateException, ProvisionedIopsNotAvailableInAzException, OptionGroupNotFoundException, DbUpgradeDependencyFailureException, StorageTypeNotSupportedException, AuthorizationNotFoundException, CertificateNotFoundException, DomainNotFoundException, KmsKeyNotAccessibleException, InvalidDbClusterStateException, NetworkTypeNotSupportedException, TenantDatabaseQuotaExceededException, AwsServiceException, SdkClientException, RdsException
Modifies settings for a DB instance. You can change one or more database configuration parameters by specifying these parameters and the new values in the request. To learn what modifications you can make to your DB instance, call
DescribeValidDBInstanceModifications
before you callModifyDBInstance
.
This is a convenience which creates an instance of the
ModifyDbInstanceRequest.Builder
avoiding the need to create one manually viaModifyDbInstanceRequest.builder()
- Parameters:
modifyDbInstanceRequest
- AConsumer
that will call methods onModifyDbInstanceRequest.Builder
to create a request.- Returns:
- Result of the ModifyDBInstance operation returned by the service.
- Throws:
InvalidDbInstanceStateException
- The DB instance isn't in a valid state.InvalidDbSecurityGroupStateException
- The state of the DB security group doesn't allow deletion.DbInstanceAlreadyExistsException
- The user already has a DB instance with the given identifier.DbInstanceNotFoundException
-DBInstanceIdentifier
doesn't refer to an existing DB instance.DbSecurityGroupNotFoundException
-DBSecurityGroupName
doesn't refer to an existing DB security group.DbParameterGroupNotFoundException
-DBParameterGroupName
doesn't refer to an existing DB parameter group.InsufficientDbInstanceCapacityException
- The specified DB instance class isn't available in the specified Availability Zone.StorageQuotaExceededException
- The request would result in the user exceeding the allowed amount of storage available across all DB instances.InvalidVpcNetworkStateException
- The DB subnet group doesn't cover all Availability Zones after it's created because of users' change.ProvisionedIopsNotAvailableInAzException
- Provisioned IOPS not available in the specified Availability Zone.OptionGroupNotFoundException
- The specified option group could not be found.DbUpgradeDependencyFailureException
- The DB upgrade failed because a resource the DB depends on can't be modified.StorageTypeNotSupportedException
- The specifiedStorageType
can't be associated with the DB instance.AuthorizationNotFoundException
- The specified CIDR IP range or Amazon EC2 security group might not be authorized for the specified DB security group.Or, RDS might not be authorized to perform necessary actions using IAM on your behalf.
CertificateNotFoundException
-CertificateIdentifier
doesn't refer to an existing certificate.DomainNotFoundException
-Domain
doesn't refer to an existing Active Directory domain.KmsKeyNotAccessibleException
- An error occurred accessing an Amazon Web Services KMS key.InvalidDbClusterStateException
- The requested operation can't be performed while the cluster is in this state.NetworkTypeNotSupportedException
- The network type is invalid for the DB instance. Valid nework type values areIPV4
andDUAL
.TenantDatabaseQuotaExceededException
- You attempted to create more tenant databases than are permitted in your Amazon Web Services account.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
modifyDBParameterGroup
default ModifyDbParameterGroupResponse modifyDBParameterGroup(ModifyDbParameterGroupRequest modifyDbParameterGroupRequest) throws DbParameterGroupNotFoundException, InvalidDbParameterGroupStateException, AwsServiceException, SdkClientException, RdsException
Modifies the parameters of a DB parameter group. To modify more than one parameter, submit a list of the following:
ParameterName
,ParameterValue
, andApplyMethod
. A maximum of 20 parameters can be modified in a single request.After you modify a DB parameter group, you should wait at least 5 minutes before creating your first DB instance that uses that DB parameter group as the default parameter group. This allows Amazon RDS to fully complete the modify operation before the parameter group is used as the default for a new DB instance. This is especially important for parameters that are critical when creating the default database for a DB instance, such as the character set for the default database defined by the
character_set_database
parameter. You can use the Parameter Groups option of the Amazon RDS console or the DescribeDBParameters command to verify that your DB parameter group has been created or modified.- Parameters:
modifyDbParameterGroupRequest
-- Returns:
- Result of the ModifyDBParameterGroup operation returned by the service.
- Throws:
DbParameterGroupNotFoundException
-DBParameterGroupName
doesn't refer to an existing DB parameter group.InvalidDbParameterGroupStateException
- The DB parameter group is in use or is in an invalid state. If you are attempting to delete the parameter group, you can't delete it when the parameter group is in this state.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
modifyDBParameterGroup
default ModifyDbParameterGroupResponse modifyDBParameterGroup(Consumer<ModifyDbParameterGroupRequest.Builder> modifyDbParameterGroupRequest) throws DbParameterGroupNotFoundException, InvalidDbParameterGroupStateException, AwsServiceException, SdkClientException, RdsException
Modifies the parameters of a DB parameter group. To modify more than one parameter, submit a list of the following:
ParameterName
,ParameterValue
, andApplyMethod
. A maximum of 20 parameters can be modified in a single request.After you modify a DB parameter group, you should wait at least 5 minutes before creating your first DB instance that uses that DB parameter group as the default parameter group. This allows Amazon RDS to fully complete the modify operation before the parameter group is used as the default for a new DB instance. This is especially important for parameters that are critical when creating the default database for a DB instance, such as the character set for the default database defined by the
character_set_database
parameter. You can use the Parameter Groups option of the Amazon RDS console or the DescribeDBParameters command to verify that your DB parameter group has been created or modified.
This is a convenience which creates an instance of the
ModifyDbParameterGroupRequest.Builder
avoiding the need to create one manually viaModifyDbParameterGroupRequest.builder()
- Parameters:
modifyDbParameterGroupRequest
- AConsumer
that will call methods onModifyDbParameterGroupRequest.Builder
to create a request.- Returns:
- Result of the ModifyDBParameterGroup operation returned by the service.
- Throws:
DbParameterGroupNotFoundException
-DBParameterGroupName
doesn't refer to an existing DB parameter group.InvalidDbParameterGroupStateException
- The DB parameter group is in use or is in an invalid state. If you are attempting to delete the parameter group, you can't delete it when the parameter group is in this state.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
modifyDBProxy
default ModifyDbProxyResponse modifyDBProxy(ModifyDbProxyRequest modifyDbProxyRequest) throws DbProxyNotFoundException, DbProxyAlreadyExistsException, InvalidDbProxyStateException, AwsServiceException, SdkClientException, RdsException
Changes the settings for an existing DB proxy.
- Parameters:
modifyDbProxyRequest
-- Returns:
- Result of the ModifyDBProxy operation returned by the service.
- Throws:
DbProxyNotFoundException
- The specified proxy name doesn't correspond to a proxy owned by your Amazon Web Services account in the specified Amazon Web Services Region.DbProxyAlreadyExistsException
- The specified proxy name must be unique for all proxies owned by your Amazon Web Services account in the specified Amazon Web Services Region.InvalidDbProxyStateException
- The requested operation can't be performed while the proxy is in this state.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
modifyDBProxy
default ModifyDbProxyResponse modifyDBProxy(Consumer<ModifyDbProxyRequest.Builder> modifyDbProxyRequest) throws DbProxyNotFoundException, DbProxyAlreadyExistsException, InvalidDbProxyStateException, AwsServiceException, SdkClientException, RdsException
Changes the settings for an existing DB proxy.
This is a convenience which creates an instance of the
ModifyDbProxyRequest.Builder
avoiding the need to create one manually viaModifyDbProxyRequest.builder()
- Parameters:
modifyDbProxyRequest
- AConsumer
that will call methods onModifyDbProxyRequest.Builder
to create a request.- Returns:
- Result of the ModifyDBProxy operation returned by the service.
- Throws:
DbProxyNotFoundException
- The specified proxy name doesn't correspond to a proxy owned by your Amazon Web Services account in the specified Amazon Web Services Region.DbProxyAlreadyExistsException
- The specified proxy name must be unique for all proxies owned by your Amazon Web Services account in the specified Amazon Web Services Region.InvalidDbProxyStateException
- The requested operation can't be performed while the proxy is in this state.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
modifyDBProxyEndpoint
default ModifyDbProxyEndpointResponse modifyDBProxyEndpoint(ModifyDbProxyEndpointRequest modifyDbProxyEndpointRequest) throws DbProxyEndpointNotFoundException, DbProxyEndpointAlreadyExistsException, InvalidDbProxyEndpointStateException, InvalidDbProxyStateException, AwsServiceException, SdkClientException, RdsException
Changes the settings for an existing DB proxy endpoint.
- Parameters:
modifyDbProxyEndpointRequest
-- Returns:
- Result of the ModifyDBProxyEndpoint operation returned by the service.
- Throws:
DbProxyEndpointNotFoundException
- The DB proxy endpoint doesn't exist.DbProxyEndpointAlreadyExistsException
- The specified DB proxy endpoint name must be unique for all DB proxy endpoints owned by your Amazon Web Services account in the specified Amazon Web Services Region.InvalidDbProxyEndpointStateException
- You can't perform this operation while the DB proxy endpoint is in a particular state.InvalidDbProxyStateException
- The requested operation can't be performed while the proxy is in this state.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
modifyDBProxyEndpoint
default ModifyDbProxyEndpointResponse modifyDBProxyEndpoint(Consumer<ModifyDbProxyEndpointRequest.Builder> modifyDbProxyEndpointRequest) throws DbProxyEndpointNotFoundException, DbProxyEndpointAlreadyExistsException, InvalidDbProxyEndpointStateException, InvalidDbProxyStateException, AwsServiceException, SdkClientException, RdsException
Changes the settings for an existing DB proxy endpoint.
This is a convenience which creates an instance of the
ModifyDbProxyEndpointRequest.Builder
avoiding the need to create one manually viaModifyDbProxyEndpointRequest.builder()
- Parameters:
modifyDbProxyEndpointRequest
- AConsumer
that will call methods onModifyDbProxyEndpointRequest.Builder
to create a request.- Returns:
- Result of the ModifyDBProxyEndpoint operation returned by the service.
- Throws:
DbProxyEndpointNotFoundException
- The DB proxy endpoint doesn't exist.DbProxyEndpointAlreadyExistsException
- The specified DB proxy endpoint name must be unique for all DB proxy endpoints owned by your Amazon Web Services account in the specified Amazon Web Services Region.InvalidDbProxyEndpointStateException
- You can't perform this operation while the DB proxy endpoint is in a particular state.InvalidDbProxyStateException
- The requested operation can't be performed while the proxy is in this state.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
modifyDBProxyTargetGroup
default ModifyDbProxyTargetGroupResponse modifyDBProxyTargetGroup(ModifyDbProxyTargetGroupRequest modifyDbProxyTargetGroupRequest) throws DbProxyNotFoundException, DbProxyTargetGroupNotFoundException, InvalidDbProxyStateException, AwsServiceException, SdkClientException, RdsException
Modifies the properties of a
DBProxyTargetGroup
.- Parameters:
modifyDbProxyTargetGroupRequest
-- Returns:
- Result of the ModifyDBProxyTargetGroup operation returned by the service.
- Throws:
DbProxyNotFoundException
- The specified proxy name doesn't correspond to a proxy owned by your Amazon Web Services account in the specified Amazon Web Services Region.DbProxyTargetGroupNotFoundException
- The specified target group isn't available for a proxy owned by your Amazon Web Services account in the specified Amazon Web Services Region.InvalidDbProxyStateException
- The requested operation can't be performed while the proxy is in this state.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
modifyDBProxyTargetGroup
default ModifyDbProxyTargetGroupResponse modifyDBProxyTargetGroup(Consumer<ModifyDbProxyTargetGroupRequest.Builder> modifyDbProxyTargetGroupRequest) throws DbProxyNotFoundException, DbProxyTargetGroupNotFoundException, InvalidDbProxyStateException, AwsServiceException, SdkClientException, RdsException
Modifies the properties of a
DBProxyTargetGroup
.
This is a convenience which creates an instance of the
ModifyDbProxyTargetGroupRequest.Builder
avoiding the need to create one manually viaModifyDbProxyTargetGroupRequest.builder()
- Parameters:
modifyDbProxyTargetGroupRequest
- AConsumer
that will call methods onModifyDbProxyTargetGroupRequest.Builder
to create a request.- Returns:
- Result of the ModifyDBProxyTargetGroup operation returned by the service.
- Throws:
DbProxyNotFoundException
- The specified proxy name doesn't correspond to a proxy owned by your Amazon Web Services account in the specified Amazon Web Services Region.DbProxyTargetGroupNotFoundException
- The specified target group isn't available for a proxy owned by your Amazon Web Services account in the specified Amazon Web Services Region.InvalidDbProxyStateException
- The requested operation can't be performed while the proxy is in this state.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
modifyDBRecommendation
default ModifyDbRecommendationResponse modifyDBRecommendation(ModifyDbRecommendationRequest modifyDbRecommendationRequest) throws AwsServiceException, SdkClientException, RdsException
Updates the recommendation status and recommended action status for the specified recommendation.
- Parameters:
modifyDbRecommendationRequest
-- Returns:
- Result of the ModifyDBRecommendation operation returned by the service.
- Throws:
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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
modifyDBRecommendation
default ModifyDbRecommendationResponse modifyDBRecommendation(Consumer<ModifyDbRecommendationRequest.Builder> modifyDbRecommendationRequest) throws AwsServiceException, SdkClientException, RdsException
Updates the recommendation status and recommended action status for the specified recommendation.
This is a convenience which creates an instance of the
ModifyDbRecommendationRequest.Builder
avoiding the need to create one manually viaModifyDbRecommendationRequest.builder()
- Parameters:
modifyDbRecommendationRequest
- AConsumer
that will call methods onModifyDbRecommendationRequest.Builder
to create a request.- Returns:
- Result of the ModifyDBRecommendation operation returned by the service.
- Throws:
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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
modifyDBShardGroup
default ModifyDbShardGroupResponse modifyDBShardGroup(ModifyDbShardGroupRequest modifyDbShardGroupRequest) throws InvalidDbClusterStateException, DbShardGroupAlreadyExistsException, DbShardGroupNotFoundException, AwsServiceException, SdkClientException, RdsException
Modifies the settings of an Aurora Limitless Database DB shard group. You can change one or more settings by specifying these parameters and the new values in the request.
- Parameters:
modifyDbShardGroupRequest
-- Returns:
- Result of the ModifyDBShardGroup operation returned by the service.
- Throws:
InvalidDbClusterStateException
- The requested operation can't be performed while the cluster is in this state.DbShardGroupAlreadyExistsException
- The specified DB shard group name must be unique in your Amazon Web Services account in the specified Amazon Web Services Region.DbShardGroupNotFoundException
- The specified DB shard group name wasn't found.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
modifyDBShardGroup
default ModifyDbShardGroupResponse modifyDBShardGroup(Consumer<ModifyDbShardGroupRequest.Builder> modifyDbShardGroupRequest) throws InvalidDbClusterStateException, DbShardGroupAlreadyExistsException, DbShardGroupNotFoundException, AwsServiceException, SdkClientException, RdsException
Modifies the settings of an Aurora Limitless Database DB shard group. You can change one or more settings by specifying these parameters and the new values in the request.
This is a convenience which creates an instance of the
ModifyDbShardGroupRequest.Builder
avoiding the need to create one manually viaModifyDbShardGroupRequest.builder()
- Parameters:
modifyDbShardGroupRequest
- AConsumer
that will call methods onModifyDbShardGroupRequest.Builder
to create a request.- Returns:
- Result of the ModifyDBShardGroup operation returned by the service.
- Throws:
InvalidDbClusterStateException
- The requested operation can't be performed while the cluster is in this state.DbShardGroupAlreadyExistsException
- The specified DB shard group name must be unique in your Amazon Web Services account in the specified Amazon Web Services Region.DbShardGroupNotFoundException
- The specified DB shard group name wasn't found.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
modifyDBSnapshot
default ModifyDbSnapshotResponse modifyDBSnapshot(ModifyDbSnapshotRequest modifyDbSnapshotRequest) throws DbSnapshotNotFoundException, AwsServiceException, SdkClientException, RdsException
Updates a manual DB snapshot with a new engine version. The snapshot can be encrypted or unencrypted, but not shared or public.
Amazon RDS supports upgrading DB snapshots for MySQL, PostgreSQL, and Oracle. This operation doesn't apply to RDS Custom or RDS for Db2.
- Parameters:
modifyDbSnapshotRequest
-- Returns:
- Result of the ModifyDBSnapshot operation returned by the service.
- Throws:
DbSnapshotNotFoundException
-DBSnapshotIdentifier
doesn't refer to an existing DB snapshot.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
modifyDBSnapshot
default ModifyDbSnapshotResponse modifyDBSnapshot(Consumer<ModifyDbSnapshotRequest.Builder> modifyDbSnapshotRequest) throws DbSnapshotNotFoundException, AwsServiceException, SdkClientException, RdsException
Updates a manual DB snapshot with a new engine version. The snapshot can be encrypted or unencrypted, but not shared or public.
Amazon RDS supports upgrading DB snapshots for MySQL, PostgreSQL, and Oracle. This operation doesn't apply to RDS Custom or RDS for Db2.
This is a convenience which creates an instance of the
ModifyDbSnapshotRequest.Builder
avoiding the need to create one manually viaModifyDbSnapshotRequest.builder()
- Parameters:
modifyDbSnapshotRequest
- AConsumer
that will call methods onModifyDbSnapshotRequest.Builder
to create a request.- Returns:
- Result of the ModifyDBSnapshot operation returned by the service.
- Throws:
DbSnapshotNotFoundException
-DBSnapshotIdentifier
doesn't refer to an existing DB snapshot.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
modifyDBSnapshotAttribute
default ModifyDbSnapshotAttributeResponse modifyDBSnapshotAttribute(ModifyDbSnapshotAttributeRequest modifyDbSnapshotAttributeRequest) throws DbSnapshotNotFoundException, InvalidDbSnapshotStateException, SharedSnapshotQuotaExceededException, AwsServiceException, SdkClientException, RdsException
Adds an attribute and values to, or removes an attribute and values from, a manual DB snapshot.
To share a manual DB snapshot with other Amazon Web Services accounts, specify
restore
as theAttributeName
and use theValuesToAdd
parameter to add a list of IDs of the Amazon Web Services accounts that are authorized to restore the manual DB snapshot. Uses the valueall
to make the manual DB snapshot public, which means it can be copied or restored by all Amazon Web Services accounts.Don't add the
all
value for any manual DB snapshots that contain private information that you don't want available to all Amazon Web Services accounts.If the manual DB snapshot is encrypted, it can be shared, but only by specifying a list of authorized Amazon Web Services account IDs for the
ValuesToAdd
parameter. You can't useall
as a value for that parameter in this case.To view which Amazon Web Services accounts have access to copy or restore a manual DB snapshot, or whether a manual DB snapshot public or private, use the DescribeDBSnapshotAttributes API operation. The accounts are returned as values for the
restore
attribute.- Parameters:
modifyDbSnapshotAttributeRequest
-- Returns:
- Result of the ModifyDBSnapshotAttribute operation returned by the service.
- Throws:
DbSnapshotNotFoundException
-DBSnapshotIdentifier
doesn't refer to an existing DB snapshot.InvalidDbSnapshotStateException
- The state of the DB snapshot doesn't allow deletion.SharedSnapshotQuotaExceededException
- You have exceeded the maximum number of accounts that you can share a manual DB snapshot with.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
modifyDBSnapshotAttribute
default ModifyDbSnapshotAttributeResponse modifyDBSnapshotAttribute(Consumer<ModifyDbSnapshotAttributeRequest.Builder> modifyDbSnapshotAttributeRequest) throws DbSnapshotNotFoundException, InvalidDbSnapshotStateException, SharedSnapshotQuotaExceededException, AwsServiceException, SdkClientException, RdsException
Adds an attribute and values to, or removes an attribute and values from, a manual DB snapshot.
To share a manual DB snapshot with other Amazon Web Services accounts, specify
restore
as theAttributeName
and use theValuesToAdd
parameter to add a list of IDs of the Amazon Web Services accounts that are authorized to restore the manual DB snapshot. Uses the valueall
to make the manual DB snapshot public, which means it can be copied or restored by all Amazon Web Services accounts.Don't add the
all
value for any manual DB snapshots that contain private information that you don't want available to all Amazon Web Services accounts.If the manual DB snapshot is encrypted, it can be shared, but only by specifying a list of authorized Amazon Web Services account IDs for the
ValuesToAdd
parameter. You can't useall
as a value for that parameter in this case.To view which Amazon Web Services accounts have access to copy or restore a manual DB snapshot, or whether a manual DB snapshot public or private, use the DescribeDBSnapshotAttributes API operation. The accounts are returned as values for the
restore
attribute.
This is a convenience which creates an instance of the
ModifyDbSnapshotAttributeRequest.Builder
avoiding the need to create one manually viaModifyDbSnapshotAttributeRequest.builder()
- Parameters:
modifyDbSnapshotAttributeRequest
- AConsumer
that will call methods onModifyDbSnapshotAttributeRequest.Builder
to create a request.- Returns:
- Result of the ModifyDBSnapshotAttribute operation returned by the service.
- Throws:
DbSnapshotNotFoundException
-DBSnapshotIdentifier
doesn't refer to an existing DB snapshot.InvalidDbSnapshotStateException
- The state of the DB snapshot doesn't allow deletion.SharedSnapshotQuotaExceededException
- You have exceeded the maximum number of accounts that you can share a manual DB snapshot with.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
modifyDBSubnetGroup
default ModifyDbSubnetGroupResponse modifyDBSubnetGroup(ModifyDbSubnetGroupRequest modifyDbSubnetGroupRequest) throws DbSubnetGroupNotFoundException, DbSubnetQuotaExceededException, SubnetAlreadyInUseException, DbSubnetGroupDoesNotCoverEnoughAZsException, InvalidSubnetException, AwsServiceException, SdkClientException, RdsException
Modifies an existing DB subnet group. DB subnet groups must contain at least one subnet in at least two AZs in the Amazon Web Services Region.
- Parameters:
modifyDbSubnetGroupRequest
-- Returns:
- Result of the ModifyDBSubnetGroup operation returned by the service.
- Throws:
DbSubnetGroupNotFoundException
-DBSubnetGroupName
doesn't refer to an existing DB subnet group.DbSubnetQuotaExceededException
- The request would result in the user exceeding the allowed number of subnets in a DB subnet groups.SubnetAlreadyInUseException
- The DB subnet is already in use in the Availability Zone.DbSubnetGroupDoesNotCoverEnoughAZsException
- Subnets in the DB subnet group should cover at least two Availability Zones unless there is only one Availability Zone.InvalidSubnetException
- The requested subnet is invalid, or multiple subnets were requested that are not all in a common VPC.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
modifyDBSubnetGroup
default ModifyDbSubnetGroupResponse modifyDBSubnetGroup(Consumer<ModifyDbSubnetGroupRequest.Builder> modifyDbSubnetGroupRequest) throws DbSubnetGroupNotFoundException, DbSubnetQuotaExceededException, SubnetAlreadyInUseException, DbSubnetGroupDoesNotCoverEnoughAZsException, InvalidSubnetException, AwsServiceException, SdkClientException, RdsException
Modifies an existing DB subnet group. DB subnet groups must contain at least one subnet in at least two AZs in the Amazon Web Services Region.
This is a convenience which creates an instance of the
ModifyDbSubnetGroupRequest.Builder
avoiding the need to create one manually viaModifyDbSubnetGroupRequest.builder()
- Parameters:
modifyDbSubnetGroupRequest
- AConsumer
that will call methods onModifyDbSubnetGroupRequest.Builder
to create a request.- Returns:
- Result of the ModifyDBSubnetGroup operation returned by the service.
- Throws:
DbSubnetGroupNotFoundException
-DBSubnetGroupName
doesn't refer to an existing DB subnet group.DbSubnetQuotaExceededException
- The request would result in the user exceeding the allowed number of subnets in a DB subnet groups.SubnetAlreadyInUseException
- The DB subnet is already in use in the Availability Zone.DbSubnetGroupDoesNotCoverEnoughAZsException
- Subnets in the DB subnet group should cover at least two Availability Zones unless there is only one Availability Zone.InvalidSubnetException
- The requested subnet is invalid, or multiple subnets were requested that are not all in a common VPC.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
modifyEventSubscription
default ModifyEventSubscriptionResponse modifyEventSubscription(ModifyEventSubscriptionRequest modifyEventSubscriptionRequest) throws EventSubscriptionQuotaExceededException, SubscriptionNotFoundException, SnsInvalidTopicException, SnsNoAuthorizationException, SnsTopicArnNotFoundException, SubscriptionCategoryNotFoundException, AwsServiceException, SdkClientException, RdsException
Modifies an existing RDS event notification subscription. You can't modify the source identifiers using this call. To change source identifiers for a subscription, use the
AddSourceIdentifierToSubscription
andRemoveSourceIdentifierFromSubscription
calls.You can see a list of the event categories for a given source type (
SourceType
) in Events in the Amazon RDS User Guide or by using theDescribeEventCategories
operation.- Parameters:
modifyEventSubscriptionRequest
-- Returns:
- Result of the ModifyEventSubscription operation returned by the service.
- Throws:
EventSubscriptionQuotaExceededException
- You have reached the maximum number of event subscriptions.SubscriptionNotFoundException
- The subscription name does not exist.SnsInvalidTopicException
- SNS has responded that there is a problem with the SNS topic specified.SnsNoAuthorizationException
- You do not have permission to publish to the SNS topic ARN.SnsTopicArnNotFoundException
- The SNS topic ARN does not exist.SubscriptionCategoryNotFoundException
- The supplied category does not exist.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
modifyEventSubscription
default ModifyEventSubscriptionResponse modifyEventSubscription(Consumer<ModifyEventSubscriptionRequest.Builder> modifyEventSubscriptionRequest) throws EventSubscriptionQuotaExceededException, SubscriptionNotFoundException, SnsInvalidTopicException, SnsNoAuthorizationException, SnsTopicArnNotFoundException, SubscriptionCategoryNotFoundException, AwsServiceException, SdkClientException, RdsException
Modifies an existing RDS event notification subscription. You can't modify the source identifiers using this call. To change source identifiers for a subscription, use the
AddSourceIdentifierToSubscription
andRemoveSourceIdentifierFromSubscription
calls.You can see a list of the event categories for a given source type (
SourceType
) in Events in the Amazon RDS User Guide or by using theDescribeEventCategories
operation.
This is a convenience which creates an instance of the
ModifyEventSubscriptionRequest.Builder
avoiding the need to create one manually viaModifyEventSubscriptionRequest.builder()
- Parameters:
modifyEventSubscriptionRequest
- AConsumer
that will call methods onModifyEventSubscriptionRequest.Builder
to create a request.- Returns:
- Result of the ModifyEventSubscription operation returned by the service.
- Throws:
EventSubscriptionQuotaExceededException
- You have reached the maximum number of event subscriptions.SubscriptionNotFoundException
- The subscription name does not exist.SnsInvalidTopicException
- SNS has responded that there is a problem with the SNS topic specified.SnsNoAuthorizationException
- You do not have permission to publish to the SNS topic ARN.SnsTopicArnNotFoundException
- The SNS topic ARN does not exist.SubscriptionCategoryNotFoundException
- The supplied category does not exist.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
modifyGlobalCluster
default ModifyGlobalClusterResponse modifyGlobalCluster(ModifyGlobalClusterRequest modifyGlobalClusterRequest) throws GlobalClusterNotFoundException, GlobalClusterAlreadyExistsException, InvalidGlobalClusterStateException, InvalidDbClusterStateException, InvalidDbInstanceStateException, AwsServiceException, SdkClientException, RdsException
Modifies a setting for an Amazon Aurora global database cluster. You can change one or more database configuration parameters by specifying these parameters and the new values in the request. For more information on Amazon Aurora, see What is Amazon Aurora? in the Amazon Aurora User Guide.
This operation only applies to Aurora global database clusters.
- Parameters:
modifyGlobalClusterRequest
-- Returns:
- Result of the ModifyGlobalCluster operation returned by the service.
- Throws:
GlobalClusterNotFoundException
- TheGlobalClusterIdentifier
doesn't refer to an existing global database cluster.GlobalClusterAlreadyExistsException
- TheGlobalClusterIdentifier
already exists. Specify a new global database identifier (unique name) to create a new global database cluster or to rename an existing one.InvalidGlobalClusterStateException
- The global cluster is in an invalid state and can't perform the requested operation.InvalidDbClusterStateException
- The requested operation can't be performed while the cluster is in this state.InvalidDbInstanceStateException
- The DB instance isn't in a valid state.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
modifyGlobalCluster
default ModifyGlobalClusterResponse modifyGlobalCluster(Consumer<ModifyGlobalClusterRequest.Builder> modifyGlobalClusterRequest) throws GlobalClusterNotFoundException, GlobalClusterAlreadyExistsException, InvalidGlobalClusterStateException, InvalidDbClusterStateException, InvalidDbInstanceStateException, AwsServiceException, SdkClientException, RdsException
Modifies a setting for an Amazon Aurora global database cluster. You can change one or more database configuration parameters by specifying these parameters and the new values in the request. For more information on Amazon Aurora, see What is Amazon Aurora? in the Amazon Aurora User Guide.
This operation only applies to Aurora global database clusters.
This is a convenience which creates an instance of the
ModifyGlobalClusterRequest.Builder
avoiding the need to create one manually viaModifyGlobalClusterRequest.builder()
- Parameters:
modifyGlobalClusterRequest
- AConsumer
that will call methods onModifyGlobalClusterRequest.Builder
to create a request.- Returns:
- Result of the ModifyGlobalCluster operation returned by the service.
- Throws:
GlobalClusterNotFoundException
- TheGlobalClusterIdentifier
doesn't refer to an existing global database cluster.GlobalClusterAlreadyExistsException
- TheGlobalClusterIdentifier
already exists. Specify a new global database identifier (unique name) to create a new global database cluster or to rename an existing one.InvalidGlobalClusterStateException
- The global cluster is in an invalid state and can't perform the requested operation.InvalidDbClusterStateException
- The requested operation can't be performed while the cluster is in this state.InvalidDbInstanceStateException
- The DB instance isn't in a valid state.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
modifyIntegration
default ModifyIntegrationResponse modifyIntegration(ModifyIntegrationRequest modifyIntegrationRequest) throws IntegrationNotFoundException, InvalidIntegrationStateException, IntegrationConflictOperationException, AwsServiceException, SdkClientException, RdsException
Modifies a zero-ETL integration with Amazon Redshift.
Currently, you can only modify integrations that have Aurora MySQL source DB clusters. Integrations with Aurora PostgreSQL and RDS sources currently don't support modifying the integration.
- Parameters:
modifyIntegrationRequest
-- Returns:
- Result of the ModifyIntegration operation returned by the service.
- Throws:
IntegrationNotFoundException
- The specified integration could not be found.InvalidIntegrationStateException
- The integration is in an invalid state and can't perform the requested operation.IntegrationConflictOperationException
- A conflicting conditional operation is currently in progress against this resource. Typically occurs when there are multiple requests being made to the same resource at the same time, and these requests conflict with each other.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
modifyIntegration
default ModifyIntegrationResponse modifyIntegration(Consumer<ModifyIntegrationRequest.Builder> modifyIntegrationRequest) throws IntegrationNotFoundException, InvalidIntegrationStateException, IntegrationConflictOperationException, AwsServiceException, SdkClientException, RdsException
Modifies a zero-ETL integration with Amazon Redshift.
Currently, you can only modify integrations that have Aurora MySQL source DB clusters. Integrations with Aurora PostgreSQL and RDS sources currently don't support modifying the integration.
This is a convenience which creates an instance of the
ModifyIntegrationRequest.Builder
avoiding the need to create one manually viaModifyIntegrationRequest.builder()
- Parameters:
modifyIntegrationRequest
- AConsumer
that will call methods onModifyIntegrationRequest.Builder
to create a request.- Returns:
- Result of the ModifyIntegration operation returned by the service.
- Throws:
IntegrationNotFoundException
- The specified integration could not be found.InvalidIntegrationStateException
- The integration is in an invalid state and can't perform the requested operation.IntegrationConflictOperationException
- A conflicting conditional operation is currently in progress against this resource. Typically occurs when there are multiple requests being made to the same resource at the same time, and these requests conflict with each other.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
modifyOptionGroup
default ModifyOptionGroupResponse modifyOptionGroup(ModifyOptionGroupRequest modifyOptionGroupRequest) throws InvalidOptionGroupStateException, OptionGroupNotFoundException, AwsServiceException, SdkClientException, RdsException
Modifies an existing option group.
- Parameters:
modifyOptionGroupRequest
-- Returns:
- Result of the ModifyOptionGroup operation returned by the service.
- Throws:
InvalidOptionGroupStateException
- The option group isn't in the available state.OptionGroupNotFoundException
- The specified option group could not be found.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
modifyOptionGroup
default ModifyOptionGroupResponse modifyOptionGroup(Consumer<ModifyOptionGroupRequest.Builder> modifyOptionGroupRequest) throws InvalidOptionGroupStateException, OptionGroupNotFoundException, AwsServiceException, SdkClientException, RdsException
Modifies an existing option group.
This is a convenience which creates an instance of the
ModifyOptionGroupRequest.Builder
avoiding the need to create one manually viaModifyOptionGroupRequest.builder()
- Parameters:
modifyOptionGroupRequest
- AConsumer
that will call methods onModifyOptionGroupRequest.Builder
to create a request.- Returns:
- Result of the ModifyOptionGroup operation returned by the service.
- Throws:
InvalidOptionGroupStateException
- The option group isn't in the available state.OptionGroupNotFoundException
- The specified option group could not be found.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
modifyTenantDatabase
default ModifyTenantDatabaseResponse modifyTenantDatabase(ModifyTenantDatabaseRequest modifyTenantDatabaseRequest) throws DbInstanceNotFoundException, TenantDatabaseNotFoundException, TenantDatabaseAlreadyExistsException, InvalidDbInstanceStateException, AwsServiceException, SdkClientException, RdsException
Modifies an existing tenant database in a DB instance. You can change the tenant database name or the master user password. This operation is supported only for RDS for Oracle CDB instances using the multi-tenant configuration.
- Parameters:
modifyTenantDatabaseRequest
-- Returns:
- Result of the ModifyTenantDatabase operation returned by the service.
- Throws:
DbInstanceNotFoundException
-DBInstanceIdentifier
doesn't refer to an existing DB instance.TenantDatabaseNotFoundException
- The specified tenant database wasn't found in the DB instance.TenantDatabaseAlreadyExistsException
- You attempted to either create a tenant database that already exists or modify a tenant database to use the name of an existing tenant database.InvalidDbInstanceStateException
- The DB instance isn't in a valid state.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
modifyTenantDatabase
default ModifyTenantDatabaseResponse modifyTenantDatabase(Consumer<ModifyTenantDatabaseRequest.Builder> modifyTenantDatabaseRequest) throws DbInstanceNotFoundException, TenantDatabaseNotFoundException, TenantDatabaseAlreadyExistsException, InvalidDbInstanceStateException, AwsServiceException, SdkClientException, RdsException
Modifies an existing tenant database in a DB instance. You can change the tenant database name or the master user password. This operation is supported only for RDS for Oracle CDB instances using the multi-tenant configuration.
This is a convenience which creates an instance of the
ModifyTenantDatabaseRequest.Builder
avoiding the need to create one manually viaModifyTenantDatabaseRequest.builder()
- Parameters:
modifyTenantDatabaseRequest
- AConsumer
that will call methods onModifyTenantDatabaseRequest.Builder
to create a request.- Returns:
- Result of the ModifyTenantDatabase operation returned by the service.
- Throws:
DbInstanceNotFoundException
-DBInstanceIdentifier
doesn't refer to an existing DB instance.TenantDatabaseNotFoundException
- The specified tenant database wasn't found in the DB instance.TenantDatabaseAlreadyExistsException
- You attempted to either create a tenant database that already exists or modify a tenant database to use the name of an existing tenant database.InvalidDbInstanceStateException
- The DB instance isn't in a valid state.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
promoteReadReplica
default PromoteReadReplicaResponse promoteReadReplica(PromoteReadReplicaRequest promoteReadReplicaRequest) throws InvalidDbInstanceStateException, DbInstanceNotFoundException, AwsServiceException, SdkClientException, RdsException
Promotes a read replica DB instance to a standalone DB instance.
-
Backup duration is a function of the amount of changes to the database since the previous backup. If you plan to promote a read replica to a standalone instance, we recommend that you enable backups and complete at least one backup prior to promotion. In addition, a read replica cannot be promoted to a standalone instance when it is in the
backing-up
status. If you have enabled backups on your read replica, configure the automated backup window so that daily backups do not interfere with read replica promotion. -
This command doesn't apply to Aurora MySQL, Aurora PostgreSQL, or RDS Custom.
- Parameters:
promoteReadReplicaRequest
-- Returns:
- Result of the PromoteReadReplica operation returned by the service.
- Throws:
InvalidDbInstanceStateException
- The DB instance isn't in a valid state.DbInstanceNotFoundException
-DBInstanceIdentifier
doesn't refer to an existing DB instance.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
-
promoteReadReplica
default PromoteReadReplicaResponse promoteReadReplica(Consumer<PromoteReadReplicaRequest.Builder> promoteReadReplicaRequest) throws InvalidDbInstanceStateException, DbInstanceNotFoundException, AwsServiceException, SdkClientException, RdsException
Promotes a read replica DB instance to a standalone DB instance.
-
Backup duration is a function of the amount of changes to the database since the previous backup. If you plan to promote a read replica to a standalone instance, we recommend that you enable backups and complete at least one backup prior to promotion. In addition, a read replica cannot be promoted to a standalone instance when it is in the
backing-up
status. If you have enabled backups on your read replica, configure the automated backup window so that daily backups do not interfere with read replica promotion. -
This command doesn't apply to Aurora MySQL, Aurora PostgreSQL, or RDS Custom.
This is a convenience which creates an instance of the
PromoteReadReplicaRequest.Builder
avoiding the need to create one manually viaPromoteReadReplicaRequest.builder()
- Parameters:
promoteReadReplicaRequest
- AConsumer
that will call methods onPromoteReadReplicaRequest.Builder
to create a request.- Returns:
- Result of the PromoteReadReplica operation returned by the service.
- Throws:
InvalidDbInstanceStateException
- The DB instance isn't in a valid state.DbInstanceNotFoundException
-DBInstanceIdentifier
doesn't refer to an existing DB instance.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
-
promoteReadReplicaDBCluster
default PromoteReadReplicaDbClusterResponse promoteReadReplicaDBCluster(PromoteReadReplicaDbClusterRequest promoteReadReplicaDbClusterRequest) throws DbClusterNotFoundException, InvalidDbClusterStateException, AwsServiceException, SdkClientException, RdsException
Promotes a read replica DB cluster to a standalone DB cluster.
- Parameters:
promoteReadReplicaDbClusterRequest
-- Returns:
- Result of the PromoteReadReplicaDBCluster operation returned by the service.
- Throws:
DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.InvalidDbClusterStateException
- The requested operation can't be performed while the cluster is in this state.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
promoteReadReplicaDBCluster
default PromoteReadReplicaDbClusterResponse promoteReadReplicaDBCluster(Consumer<PromoteReadReplicaDbClusterRequest.Builder> promoteReadReplicaDbClusterRequest) throws DbClusterNotFoundException, InvalidDbClusterStateException, AwsServiceException, SdkClientException, RdsException
Promotes a read replica DB cluster to a standalone DB cluster.
This is a convenience which creates an instance of the
PromoteReadReplicaDbClusterRequest.Builder
avoiding the need to create one manually viaPromoteReadReplicaDbClusterRequest.builder()
- Parameters:
promoteReadReplicaDbClusterRequest
- AConsumer
that will call methods onPromoteReadReplicaDbClusterRequest.Builder
to create a request.- Returns:
- Result of the PromoteReadReplicaDBCluster operation returned by the service.
- Throws:
DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.InvalidDbClusterStateException
- The requested operation can't be performed while the cluster is in this state.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
purchaseReservedDBInstancesOffering
default PurchaseReservedDbInstancesOfferingResponse purchaseReservedDBInstancesOffering(PurchaseReservedDbInstancesOfferingRequest purchaseReservedDbInstancesOfferingRequest) throws ReservedDbInstancesOfferingNotFoundException, ReservedDbInstanceAlreadyExistsException, ReservedDbInstanceQuotaExceededException, AwsServiceException, SdkClientException, RdsException
Purchases a reserved DB instance offering.
- Parameters:
purchaseReservedDbInstancesOfferingRequest
-- Returns:
- Result of the PurchaseReservedDBInstancesOffering operation returned by the service.
- Throws:
ReservedDbInstancesOfferingNotFoundException
- Specified offering does not exist.ReservedDbInstanceAlreadyExistsException
- User already has a reservation with the given identifier.ReservedDbInstanceQuotaExceededException
- Request would exceed the user's DB Instance quota.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
purchaseReservedDBInstancesOffering
default PurchaseReservedDbInstancesOfferingResponse purchaseReservedDBInstancesOffering(Consumer<PurchaseReservedDbInstancesOfferingRequest.Builder> purchaseReservedDbInstancesOfferingRequest) throws ReservedDbInstancesOfferingNotFoundException, ReservedDbInstanceAlreadyExistsException, ReservedDbInstanceQuotaExceededException, AwsServiceException, SdkClientException, RdsException
Purchases a reserved DB instance offering.
This is a convenience which creates an instance of the
PurchaseReservedDbInstancesOfferingRequest.Builder
avoiding the need to create one manually viaPurchaseReservedDbInstancesOfferingRequest.builder()
- Parameters:
purchaseReservedDbInstancesOfferingRequest
- AConsumer
that will call methods onPurchaseReservedDbInstancesOfferingRequest.Builder
to create a request.- Returns:
- Result of the PurchaseReservedDBInstancesOffering operation returned by the service.
- Throws:
ReservedDbInstancesOfferingNotFoundException
- Specified offering does not exist.ReservedDbInstanceAlreadyExistsException
- User already has a reservation with the given identifier.ReservedDbInstanceQuotaExceededException
- Request would exceed the user's DB Instance quota.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
rebootDBCluster
default RebootDbClusterResponse rebootDBCluster(RebootDbClusterRequest rebootDbClusterRequest) throws DbClusterNotFoundException, InvalidDbClusterStateException, InvalidDbInstanceStateException, AwsServiceException, SdkClientException, RdsException
You might need to reboot your DB cluster, usually for maintenance reasons. For example, if you make certain modifications, or if you change the DB cluster parameter group associated with the DB cluster, reboot the DB cluster for the changes to take effect.
Rebooting a DB cluster restarts the database engine service. Rebooting a DB cluster results in a momentary outage, during which the DB cluster status is set to rebooting.
Use this operation only for a non-Aurora Multi-AZ DB cluster.
For more information on Multi-AZ DB clusters, see Multi-AZ DB cluster deployments in the Amazon RDS User Guide.
- Parameters:
rebootDbClusterRequest
-- Returns:
- Result of the RebootDBCluster operation returned by the service.
- Throws:
DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.InvalidDbClusterStateException
- The requested operation can't be performed while the cluster is in this state.InvalidDbInstanceStateException
- The DB instance isn't in a valid state.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
rebootDBCluster
default RebootDbClusterResponse rebootDBCluster(Consumer<RebootDbClusterRequest.Builder> rebootDbClusterRequest) throws DbClusterNotFoundException, InvalidDbClusterStateException, InvalidDbInstanceStateException, AwsServiceException, SdkClientException, RdsException
You might need to reboot your DB cluster, usually for maintenance reasons. For example, if you make certain modifications, or if you change the DB cluster parameter group associated with the DB cluster, reboot the DB cluster for the changes to take effect.
Rebooting a DB cluster restarts the database engine service. Rebooting a DB cluster results in a momentary outage, during which the DB cluster status is set to rebooting.
Use this operation only for a non-Aurora Multi-AZ DB cluster.
For more information on Multi-AZ DB clusters, see Multi-AZ DB cluster deployments in the Amazon RDS User Guide.
This is a convenience which creates an instance of the
RebootDbClusterRequest.Builder
avoiding the need to create one manually viaRebootDbClusterRequest.builder()
- Parameters:
rebootDbClusterRequest
- AConsumer
that will call methods onRebootDbClusterRequest.Builder
to create a request.- Returns:
- Result of the RebootDBCluster operation returned by the service.
- Throws:
DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.InvalidDbClusterStateException
- The requested operation can't be performed while the cluster is in this state.InvalidDbInstanceStateException
- The DB instance isn't in a valid state.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
rebootDBInstance
default RebootDbInstanceResponse rebootDBInstance(RebootDbInstanceRequest rebootDbInstanceRequest) throws InvalidDbInstanceStateException, DbInstanceNotFoundException, AwsServiceException, SdkClientException, RdsException
You might need to reboot your DB instance, usually for maintenance reasons. For example, if you make certain modifications, or if you change the DB parameter group associated with the DB instance, you must reboot the instance for the changes to take effect.
Rebooting a DB instance restarts the database engine service. Rebooting a DB instance results in a momentary outage, during which the DB instance status is set to rebooting.
For more information about rebooting, see Rebooting a DB Instance in the Amazon RDS User Guide.
This command doesn't apply to RDS Custom.
If your DB instance is part of a Multi-AZ DB cluster, you can reboot the DB cluster with the
RebootDBCluster
operation.- Parameters:
rebootDbInstanceRequest
-- Returns:
- Result of the RebootDBInstance operation returned by the service.
- Throws:
InvalidDbInstanceStateException
- The DB instance isn't in a valid state.DbInstanceNotFoundException
-DBInstanceIdentifier
doesn't refer to an existing DB instance.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
rebootDBInstance
default RebootDbInstanceResponse rebootDBInstance(Consumer<RebootDbInstanceRequest.Builder> rebootDbInstanceRequest) throws InvalidDbInstanceStateException, DbInstanceNotFoundException, AwsServiceException, SdkClientException, RdsException
You might need to reboot your DB instance, usually for maintenance reasons. For example, if you make certain modifications, or if you change the DB parameter group associated with the DB instance, you must reboot the instance for the changes to take effect.
Rebooting a DB instance restarts the database engine service. Rebooting a DB instance results in a momentary outage, during which the DB instance status is set to rebooting.
For more information about rebooting, see Rebooting a DB Instance in the Amazon RDS User Guide.
This command doesn't apply to RDS Custom.
If your DB instance is part of a Multi-AZ DB cluster, you can reboot the DB cluster with the
RebootDBCluster
operation.
This is a convenience which creates an instance of the
RebootDbInstanceRequest.Builder
avoiding the need to create one manually viaRebootDbInstanceRequest.builder()
- Parameters:
rebootDbInstanceRequest
- AConsumer
that will call methods onRebootDbInstanceRequest.Builder
to create a request.- Returns:
- Result of the RebootDBInstance operation returned by the service.
- Throws:
InvalidDbInstanceStateException
- The DB instance isn't in a valid state.DbInstanceNotFoundException
-DBInstanceIdentifier
doesn't refer to an existing DB instance.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
rebootDBShardGroup
default RebootDbShardGroupResponse rebootDBShardGroup(RebootDbShardGroupRequest rebootDbShardGroupRequest) throws DbShardGroupNotFoundException, InvalidDbShardGroupStateException, AwsServiceException, SdkClientException, RdsException
You might need to reboot your DB shard group, usually for maintenance reasons. For example, if you make certain modifications, reboot the DB shard group for the changes to take effect.
This operation applies only to Aurora Limitless Database DBb shard groups.
- Parameters:
rebootDbShardGroupRequest
-- Returns:
- Result of the RebootDBShardGroup operation returned by the service.
- Throws:
DbShardGroupNotFoundException
- The specified DB shard group name wasn't found.InvalidDbShardGroupStateException
- The DB shard group must be in the available state.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
rebootDBShardGroup
default RebootDbShardGroupResponse rebootDBShardGroup(Consumer<RebootDbShardGroupRequest.Builder> rebootDbShardGroupRequest) throws DbShardGroupNotFoundException, InvalidDbShardGroupStateException, AwsServiceException, SdkClientException, RdsException
You might need to reboot your DB shard group, usually for maintenance reasons. For example, if you make certain modifications, reboot the DB shard group for the changes to take effect.
This operation applies only to Aurora Limitless Database DBb shard groups.
This is a convenience which creates an instance of the
RebootDbShardGroupRequest.Builder
avoiding the need to create one manually viaRebootDbShardGroupRequest.builder()
- Parameters:
rebootDbShardGroupRequest
- AConsumer
that will call methods onRebootDbShardGroupRequest.Builder
to create a request.- Returns:
- Result of the RebootDBShardGroup operation returned by the service.
- Throws:
DbShardGroupNotFoundException
- The specified DB shard group name wasn't found.InvalidDbShardGroupStateException
- The DB shard group must be in the available state.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
registerDBProxyTargets
default RegisterDbProxyTargetsResponse registerDBProxyTargets(RegisterDbProxyTargetsRequest registerDbProxyTargetsRequest) throws DbProxyNotFoundException, DbProxyTargetGroupNotFoundException, DbClusterNotFoundException, DbInstanceNotFoundException, DbProxyTargetAlreadyRegisteredException, InvalidDbInstanceStateException, InvalidDbClusterStateException, InvalidDbProxyStateException, InsufficientAvailableIPsInSubnetException, AwsServiceException, SdkClientException, RdsException
Associate one or more
DBProxyTarget
data structures with aDBProxyTargetGroup
.- Parameters:
registerDbProxyTargetsRequest
-- Returns:
- Result of the RegisterDBProxyTargets operation returned by the service.
- Throws:
DbProxyNotFoundException
- The specified proxy name doesn't correspond to a proxy owned by your Amazon Web Services account in the specified Amazon Web Services Region.DbProxyTargetGroupNotFoundException
- The specified target group isn't available for a proxy owned by your Amazon Web Services account in the specified Amazon Web Services Region.DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.DbInstanceNotFoundException
-DBInstanceIdentifier
doesn't refer to an existing DB instance.DbProxyTargetAlreadyRegisteredException
- The proxy is already associated with the specified RDS DB instance or Aurora DB cluster.InvalidDbInstanceStateException
- The DB instance isn't in a valid state.InvalidDbClusterStateException
- The requested operation can't be performed while the cluster is in this state.InvalidDbProxyStateException
- The requested operation can't be performed while the proxy is in this state.InsufficientAvailableIPsInSubnetException
- The requested operation can't be performed because there aren't enough available IP addresses in the proxy's subnets. Add more CIDR blocks to the VPC or remove IP address that aren't required from the subnets.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
registerDBProxyTargets
default RegisterDbProxyTargetsResponse registerDBProxyTargets(Consumer<RegisterDbProxyTargetsRequest.Builder> registerDbProxyTargetsRequest) throws DbProxyNotFoundException, DbProxyTargetGroupNotFoundException, DbClusterNotFoundException, DbInstanceNotFoundException, DbProxyTargetAlreadyRegisteredException, InvalidDbInstanceStateException, InvalidDbClusterStateException, InvalidDbProxyStateException, InsufficientAvailableIPsInSubnetException, AwsServiceException, SdkClientException, RdsException
Associate one or more
DBProxyTarget
data structures with aDBProxyTargetGroup
.
This is a convenience which creates an instance of the
RegisterDbProxyTargetsRequest.Builder
avoiding the need to create one manually viaRegisterDbProxyTargetsRequest.builder()
- Parameters:
registerDbProxyTargetsRequest
- AConsumer
that will call methods onRegisterDbProxyTargetsRequest.Builder
to create a request.- Returns:
- Result of the RegisterDBProxyTargets operation returned by the service.
- Throws:
DbProxyNotFoundException
- The specified proxy name doesn't correspond to a proxy owned by your Amazon Web Services account in the specified Amazon Web Services Region.DbProxyTargetGroupNotFoundException
- The specified target group isn't available for a proxy owned by your Amazon Web Services account in the specified Amazon Web Services Region.DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.DbInstanceNotFoundException
-DBInstanceIdentifier
doesn't refer to an existing DB instance.DbProxyTargetAlreadyRegisteredException
- The proxy is already associated with the specified RDS DB instance or Aurora DB cluster.InvalidDbInstanceStateException
- The DB instance isn't in a valid state.InvalidDbClusterStateException
- The requested operation can't be performed while the cluster is in this state.InvalidDbProxyStateException
- The requested operation can't be performed while the proxy is in this state.InsufficientAvailableIPsInSubnetException
- The requested operation can't be performed because there aren't enough available IP addresses in the proxy's subnets. Add more CIDR blocks to the VPC or remove IP address that aren't required from the subnets.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
removeFromGlobalCluster
default RemoveFromGlobalClusterResponse removeFromGlobalCluster(RemoveFromGlobalClusterRequest removeFromGlobalClusterRequest) throws GlobalClusterNotFoundException, InvalidGlobalClusterStateException, DbClusterNotFoundException, AwsServiceException, SdkClientException, RdsException
Detaches an Aurora secondary cluster from an Aurora global database cluster. The cluster becomes a standalone cluster with read-write capability instead of being read-only and receiving data from a primary cluster in a different Region.
This operation only applies to Aurora DB clusters.
- Parameters:
removeFromGlobalClusterRequest
-- Returns:
- Result of the RemoveFromGlobalCluster operation returned by the service.
- Throws:
GlobalClusterNotFoundException
- TheGlobalClusterIdentifier
doesn't refer to an existing global database cluster.InvalidGlobalClusterStateException
- The global cluster is in an invalid state and can't perform the requested operation.DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
removeFromGlobalCluster
default RemoveFromGlobalClusterResponse removeFromGlobalCluster(Consumer<RemoveFromGlobalClusterRequest.Builder> removeFromGlobalClusterRequest) throws GlobalClusterNotFoundException, InvalidGlobalClusterStateException, DbClusterNotFoundException, AwsServiceException, SdkClientException, RdsException
Detaches an Aurora secondary cluster from an Aurora global database cluster. The cluster becomes a standalone cluster with read-write capability instead of being read-only and receiving data from a primary cluster in a different Region.
This operation only applies to Aurora DB clusters.
This is a convenience which creates an instance of the
RemoveFromGlobalClusterRequest.Builder
avoiding the need to create one manually viaRemoveFromGlobalClusterRequest.builder()
- Parameters:
removeFromGlobalClusterRequest
- AConsumer
that will call methods onRemoveFromGlobalClusterRequest.Builder
to create a request.- Returns:
- Result of the RemoveFromGlobalCluster operation returned by the service.
- Throws:
GlobalClusterNotFoundException
- TheGlobalClusterIdentifier
doesn't refer to an existing global database cluster.InvalidGlobalClusterStateException
- The global cluster is in an invalid state and can't perform the requested operation.DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
removeRoleFromDBCluster
default RemoveRoleFromDbClusterResponse removeRoleFromDBCluster(RemoveRoleFromDbClusterRequest removeRoleFromDbClusterRequest) throws DbClusterNotFoundException, DbClusterRoleNotFoundException, InvalidDbClusterStateException, AwsServiceException, SdkClientException, RdsException
Removes the asssociation of an Amazon Web Services Identity and Access Management (IAM) role from a DB cluster.
For more information on Amazon Aurora DB clusters, see What is Amazon Aurora? in the Amazon Aurora User Guide.
For more information on Multi-AZ DB clusters, see Multi-AZ DB cluster deployments in the Amazon RDS User Guide.
- Parameters:
removeRoleFromDbClusterRequest
-- Returns:
- Result of the RemoveRoleFromDBCluster operation returned by the service.
- Throws:
DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.DbClusterRoleNotFoundException
- The specified IAM role Amazon Resource Name (ARN) isn't associated with the specified DB cluster.InvalidDbClusterStateException
- The requested operation can't be performed while the cluster is in this state.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
removeRoleFromDBCluster
default RemoveRoleFromDbClusterResponse removeRoleFromDBCluster(Consumer<RemoveRoleFromDbClusterRequest.Builder> removeRoleFromDbClusterRequest) throws DbClusterNotFoundException, DbClusterRoleNotFoundException, InvalidDbClusterStateException, AwsServiceException, SdkClientException, RdsException
Removes the asssociation of an Amazon Web Services Identity and Access Management (IAM) role from a DB cluster.
For more information on Amazon Aurora DB clusters, see What is Amazon Aurora? in the Amazon Aurora User Guide.
For more information on Multi-AZ DB clusters, see Multi-AZ DB cluster deployments in the Amazon RDS User Guide.
This is a convenience which creates an instance of the
RemoveRoleFromDbClusterRequest.Builder
avoiding the need to create one manually viaRemoveRoleFromDbClusterRequest.builder()
- Parameters:
removeRoleFromDbClusterRequest
- AConsumer
that will call methods onRemoveRoleFromDbClusterRequest.Builder
to create a request.- Returns:
- Result of the RemoveRoleFromDBCluster operation returned by the service.
- Throws:
DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.DbClusterRoleNotFoundException
- The specified IAM role Amazon Resource Name (ARN) isn't associated with the specified DB cluster.InvalidDbClusterStateException
- The requested operation can't be performed while the cluster is in this state.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
removeRoleFromDBInstance
default RemoveRoleFromDbInstanceResponse removeRoleFromDBInstance(RemoveRoleFromDbInstanceRequest removeRoleFromDbInstanceRequest) throws DbInstanceNotFoundException, DbInstanceRoleNotFoundException, InvalidDbInstanceStateException, AwsServiceException, SdkClientException, RdsException
Disassociates an Amazon Web Services Identity and Access Management (IAM) role from a DB instance.
- Parameters:
removeRoleFromDbInstanceRequest
-- Returns:
- Result of the RemoveRoleFromDBInstance operation returned by the service.
- Throws:
DbInstanceNotFoundException
-DBInstanceIdentifier
doesn't refer to an existing DB instance.DbInstanceRoleNotFoundException
- The specifiedRoleArn
value doesn't match the specified feature for the DB instance.InvalidDbInstanceStateException
- The DB instance isn't in a valid state.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
removeRoleFromDBInstance
default RemoveRoleFromDbInstanceResponse removeRoleFromDBInstance(Consumer<RemoveRoleFromDbInstanceRequest.Builder> removeRoleFromDbInstanceRequest) throws DbInstanceNotFoundException, DbInstanceRoleNotFoundException, InvalidDbInstanceStateException, AwsServiceException, SdkClientException, RdsException
Disassociates an Amazon Web Services Identity and Access Management (IAM) role from a DB instance.
This is a convenience which creates an instance of the
RemoveRoleFromDbInstanceRequest.Builder
avoiding the need to create one manually viaRemoveRoleFromDbInstanceRequest.builder()
- Parameters:
removeRoleFromDbInstanceRequest
- AConsumer
that will call methods onRemoveRoleFromDbInstanceRequest.Builder
to create a request.- Returns:
- Result of the RemoveRoleFromDBInstance operation returned by the service.
- Throws:
DbInstanceNotFoundException
-DBInstanceIdentifier
doesn't refer to an existing DB instance.DbInstanceRoleNotFoundException
- The specifiedRoleArn
value doesn't match the specified feature for the DB instance.InvalidDbInstanceStateException
- The DB instance isn't in a valid state.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
removeSourceIdentifierFromSubscription
default RemoveSourceIdentifierFromSubscriptionResponse removeSourceIdentifierFromSubscription(RemoveSourceIdentifierFromSubscriptionRequest removeSourceIdentifierFromSubscriptionRequest) throws SubscriptionNotFoundException, SourceNotFoundException, AwsServiceException, SdkClientException, RdsException
Removes a source identifier from an existing RDS event notification subscription.
- Parameters:
removeSourceIdentifierFromSubscriptionRequest
-- Returns:
- Result of the RemoveSourceIdentifierFromSubscription operation returned by the service.
- Throws:
SubscriptionNotFoundException
- The subscription name does not exist.SourceNotFoundException
- The requested source could not be found.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
removeSourceIdentifierFromSubscription
default RemoveSourceIdentifierFromSubscriptionResponse removeSourceIdentifierFromSubscription(Consumer<RemoveSourceIdentifierFromSubscriptionRequest.Builder> removeSourceIdentifierFromSubscriptionRequest) throws SubscriptionNotFoundException, SourceNotFoundException, AwsServiceException, SdkClientException, RdsException
Removes a source identifier from an existing RDS event notification subscription.
This is a convenience which creates an instance of the
RemoveSourceIdentifierFromSubscriptionRequest.Builder
avoiding the need to create one manually viaRemoveSourceIdentifierFromSubscriptionRequest.builder()
- Parameters:
removeSourceIdentifierFromSubscriptionRequest
- AConsumer
that will call methods onRemoveSourceIdentifierFromSubscriptionRequest.Builder
to create a request.- Returns:
- Result of the RemoveSourceIdentifierFromSubscription operation returned by the service.
- Throws:
SubscriptionNotFoundException
- The subscription name does not exist.SourceNotFoundException
- The requested source could not be found.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
removeTagsFromResource
default RemoveTagsFromResourceResponse removeTagsFromResource(RemoveTagsFromResourceRequest removeTagsFromResourceRequest) throws DbInstanceNotFoundException, DbSnapshotNotFoundException, DbClusterNotFoundException, DbProxyNotFoundException, DbProxyTargetGroupNotFoundException, BlueGreenDeploymentNotFoundException, IntegrationNotFoundException, TenantDatabaseNotFoundException, DbSnapshotTenantDatabaseNotFoundException, AwsServiceException, SdkClientException, RdsException
Removes metadata tags from an Amazon RDS resource.
For an overview on tagging an Amazon RDS resource, see Tagging Amazon RDS Resources in the Amazon RDS User Guide or Tagging Amazon Aurora and Amazon RDS Resources in the Amazon Aurora User Guide.
- Parameters:
removeTagsFromResourceRequest
-- Returns:
- Result of the RemoveTagsFromResource operation returned by the service.
- Throws:
DbInstanceNotFoundException
-DBInstanceIdentifier
doesn't refer to an existing DB instance.DbSnapshotNotFoundException
-DBSnapshotIdentifier
doesn't refer to an existing DB snapshot.DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.DbProxyNotFoundException
- The specified proxy name doesn't correspond to a proxy owned by your Amazon Web Services account in the specified Amazon Web Services Region.DbProxyTargetGroupNotFoundException
- The specified target group isn't available for a proxy owned by your Amazon Web Services account in the specified Amazon Web Services Region.BlueGreenDeploymentNotFoundException
-BlueGreenDeploymentIdentifier
doesn't refer to an existing blue/green deployment.IntegrationNotFoundException
- The specified integration could not be found.TenantDatabaseNotFoundException
- The specified tenant database wasn't found in the DB instance.DbSnapshotTenantDatabaseNotFoundException
- The specified snapshot tenant database wasn't found.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
removeTagsFromResource
default RemoveTagsFromResourceResponse removeTagsFromResource(Consumer<RemoveTagsFromResourceRequest.Builder> removeTagsFromResourceRequest) throws DbInstanceNotFoundException, DbSnapshotNotFoundException, DbClusterNotFoundException, DbProxyNotFoundException, DbProxyTargetGroupNotFoundException, BlueGreenDeploymentNotFoundException, IntegrationNotFoundException, TenantDatabaseNotFoundException, DbSnapshotTenantDatabaseNotFoundException, AwsServiceException, SdkClientException, RdsException
Removes metadata tags from an Amazon RDS resource.
For an overview on tagging an Amazon RDS resource, see Tagging Amazon RDS Resources in the Amazon RDS User Guide or Tagging Amazon Aurora and Amazon RDS Resources in the Amazon Aurora User Guide.
This is a convenience which creates an instance of the
RemoveTagsFromResourceRequest.Builder
avoiding the need to create one manually viaRemoveTagsFromResourceRequest.builder()
- Parameters:
removeTagsFromResourceRequest
- AConsumer
that will call methods onRemoveTagsFromResourceRequest.Builder
to create a request.- Returns:
- Result of the RemoveTagsFromResource operation returned by the service.
- Throws:
DbInstanceNotFoundException
-DBInstanceIdentifier
doesn't refer to an existing DB instance.DbSnapshotNotFoundException
-DBSnapshotIdentifier
doesn't refer to an existing DB snapshot.DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.DbProxyNotFoundException
- The specified proxy name doesn't correspond to a proxy owned by your Amazon Web Services account in the specified Amazon Web Services Region.DbProxyTargetGroupNotFoundException
- The specified target group isn't available for a proxy owned by your Amazon Web Services account in the specified Amazon Web Services Region.BlueGreenDeploymentNotFoundException
-BlueGreenDeploymentIdentifier
doesn't refer to an existing blue/green deployment.IntegrationNotFoundException
- The specified integration could not be found.TenantDatabaseNotFoundException
- The specified tenant database wasn't found in the DB instance.DbSnapshotTenantDatabaseNotFoundException
- The specified snapshot tenant database wasn't found.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
resetDBClusterParameterGroup
default ResetDbClusterParameterGroupResponse resetDBClusterParameterGroup(ResetDbClusterParameterGroupRequest resetDbClusterParameterGroupRequest) throws InvalidDbParameterGroupStateException, DbParameterGroupNotFoundException, AwsServiceException, SdkClientException, RdsException
Modifies the parameters of a DB cluster parameter group to the default value. To reset specific parameters submit a list of the following:
ParameterName
andApplyMethod
. To reset the entire DB cluster parameter group, specify theDBClusterParameterGroupName
andResetAllParameters
parameters.When resetting the entire group, dynamic parameters are updated immediately and static parameters are set to
pending-reboot
to take effect on the next DB instance restart orRebootDBInstance
request. You must callRebootDBInstance
for every DB instance in your DB cluster that you want the updated static parameter to apply to.For more information on Amazon Aurora DB clusters, see What is Amazon Aurora? in the Amazon Aurora User Guide.
For more information on Multi-AZ DB clusters, see Multi-AZ DB cluster deployments in the Amazon RDS User Guide.
- Parameters:
resetDbClusterParameterGroupRequest
-- Returns:
- Result of the ResetDBClusterParameterGroup operation returned by the service.
- Throws:
InvalidDbParameterGroupStateException
- The DB parameter group is in use or is in an invalid state. If you are attempting to delete the parameter group, you can't delete it when the parameter group is in this state.DbParameterGroupNotFoundException
-DBParameterGroupName
doesn't refer to an existing DB parameter group.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
resetDBClusterParameterGroup
default ResetDbClusterParameterGroupResponse resetDBClusterParameterGroup(Consumer<ResetDbClusterParameterGroupRequest.Builder> resetDbClusterParameterGroupRequest) throws InvalidDbParameterGroupStateException, DbParameterGroupNotFoundException, AwsServiceException, SdkClientException, RdsException
Modifies the parameters of a DB cluster parameter group to the default value. To reset specific parameters submit a list of the following:
ParameterName
andApplyMethod
. To reset the entire DB cluster parameter group, specify theDBClusterParameterGroupName
andResetAllParameters
parameters.When resetting the entire group, dynamic parameters are updated immediately and static parameters are set to
pending-reboot
to take effect on the next DB instance restart orRebootDBInstance
request. You must callRebootDBInstance
for every DB instance in your DB cluster that you want the updated static parameter to apply to.For more information on Amazon Aurora DB clusters, see What is Amazon Aurora? in the Amazon Aurora User Guide.
For more information on Multi-AZ DB clusters, see Multi-AZ DB cluster deployments in the Amazon RDS User Guide.
This is a convenience which creates an instance of the
ResetDbClusterParameterGroupRequest.Builder
avoiding the need to create one manually viaResetDbClusterParameterGroupRequest.builder()
- Parameters:
resetDbClusterParameterGroupRequest
- AConsumer
that will call methods onResetDbClusterParameterGroupRequest.Builder
to create a request.- Returns:
- Result of the ResetDBClusterParameterGroup operation returned by the service.
- Throws:
InvalidDbParameterGroupStateException
- The DB parameter group is in use or is in an invalid state. If you are attempting to delete the parameter group, you can't delete it when the parameter group is in this state.DbParameterGroupNotFoundException
-DBParameterGroupName
doesn't refer to an existing DB parameter group.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
resetDBParameterGroup
default ResetDbParameterGroupResponse resetDBParameterGroup(ResetDbParameterGroupRequest resetDbParameterGroupRequest) throws InvalidDbParameterGroupStateException, DbParameterGroupNotFoundException, AwsServiceException, SdkClientException, RdsException
Modifies the parameters of a DB parameter group to the engine/system default value. To reset specific parameters, provide a list of the following:
ParameterName
andApplyMethod
. To reset the entire DB parameter group, specify theDBParameterGroup
name andResetAllParameters
parameters. When resetting the entire group, dynamic parameters are updated immediately and static parameters are set topending-reboot
to take effect on the next DB instance restart orRebootDBInstance
request.- Parameters:
resetDbParameterGroupRequest
-- Returns:
- Result of the ResetDBParameterGroup operation returned by the service.
- Throws:
InvalidDbParameterGroupStateException
- The DB parameter group is in use or is in an invalid state. If you are attempting to delete the parameter group, you can't delete it when the parameter group is in this state.DbParameterGroupNotFoundException
-DBParameterGroupName
doesn't refer to an existing DB parameter group.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
resetDBParameterGroup
default ResetDbParameterGroupResponse resetDBParameterGroup(Consumer<ResetDbParameterGroupRequest.Builder> resetDbParameterGroupRequest) throws InvalidDbParameterGroupStateException, DbParameterGroupNotFoundException, AwsServiceException, SdkClientException, RdsException
Modifies the parameters of a DB parameter group to the engine/system default value. To reset specific parameters, provide a list of the following:
ParameterName
andApplyMethod
. To reset the entire DB parameter group, specify theDBParameterGroup
name andResetAllParameters
parameters. When resetting the entire group, dynamic parameters are updated immediately and static parameters are set topending-reboot
to take effect on the next DB instance restart orRebootDBInstance
request.
This is a convenience which creates an instance of the
ResetDbParameterGroupRequest.Builder
avoiding the need to create one manually viaResetDbParameterGroupRequest.builder()
- Parameters:
resetDbParameterGroupRequest
- AConsumer
that will call methods onResetDbParameterGroupRequest.Builder
to create a request.- Returns:
- Result of the ResetDBParameterGroup operation returned by the service.
- Throws:
InvalidDbParameterGroupStateException
- The DB parameter group is in use or is in an invalid state. If you are attempting to delete the parameter group, you can't delete it when the parameter group is in this state.DbParameterGroupNotFoundException
-DBParameterGroupName
doesn't refer to an existing DB parameter group.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
restoreDBClusterFromS3
default RestoreDbClusterFromS3Response restoreDBClusterFromS3(RestoreDbClusterFromS3Request restoreDbClusterFromS3Request) throws DbClusterAlreadyExistsException, DbClusterQuotaExceededException, StorageQuotaExceededException, DbSubnetGroupNotFoundException, InvalidVpcNetworkStateException, InvalidDbClusterStateException, InvalidDbSubnetGroupStateException, InvalidSubnetException, InvalidS3BucketException, DbClusterParameterGroupNotFoundException, KmsKeyNotAccessibleException, DbClusterNotFoundException, DomainNotFoundException, InsufficientStorageClusterCapacityException, StorageTypeNotSupportedException, AwsServiceException, SdkClientException, RdsException
Creates an Amazon Aurora DB cluster from MySQL data stored in an Amazon S3 bucket. Amazon RDS must be authorized to access the Amazon S3 bucket and the data must be created using the Percona XtraBackup utility as described in Migrating Data from MySQL by Using an Amazon S3 Bucket in the Amazon Aurora User Guide.
This operation only restores the DB cluster, not the DB instances for that DB cluster. You must invoke the
CreateDBInstance
operation to create DB instances for the restored DB cluster, specifying the identifier of the restored DB cluster inDBClusterIdentifier
. You can create DB instances only after theRestoreDBClusterFromS3
operation has completed and the DB cluster is available.For more information on Amazon Aurora, see What is Amazon Aurora? in the Amazon Aurora User Guide.
This operation only applies to Aurora DB clusters. The source DB engine must be MySQL.
- Parameters:
restoreDbClusterFromS3Request
-- Returns:
- Result of the RestoreDBClusterFromS3 operation returned by the service.
- Throws:
DbClusterAlreadyExistsException
- The user already has a DB cluster with the given identifier.DbClusterQuotaExceededException
- The user attempted to create a new DB cluster and the user has already reached the maximum allowed DB cluster quota.StorageQuotaExceededException
- The request would result in the user exceeding the allowed amount of storage available across all DB instances.DbSubnetGroupNotFoundException
-DBSubnetGroupName
doesn't refer to an existing DB subnet group.InvalidVpcNetworkStateException
- The DB subnet group doesn't cover all Availability Zones after it's created because of users' change.InvalidDbClusterStateException
- The requested operation can't be performed while the cluster is in this state.InvalidDbSubnetGroupStateException
- The DB subnet group cannot be deleted because it's in use.InvalidSubnetException
- The requested subnet is invalid, or multiple subnets were requested that are not all in a common VPC.InvalidS3BucketException
- The specified Amazon S3 bucket name can't be found or Amazon RDS isn't authorized to access the specified Amazon S3 bucket. Verify the SourceS3BucketName and S3IngestionRoleArn values and try again.DbClusterParameterGroupNotFoundException
-DBClusterParameterGroupName
doesn't refer to an existing DB cluster parameter group.KmsKeyNotAccessibleException
- An error occurred accessing an Amazon Web Services KMS key.DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.DomainNotFoundException
-Domain
doesn't refer to an existing Active Directory domain.InsufficientStorageClusterCapacityException
- There is insufficient storage available for the current action. You might be able to resolve this error by updating your subnet group to use different Availability Zones that have more storage available.StorageTypeNotSupportedException
- The specifiedStorageType
can't be associated with the DB instance.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
restoreDBClusterFromS3
default RestoreDbClusterFromS3Response restoreDBClusterFromS3(Consumer<RestoreDbClusterFromS3Request.Builder> restoreDbClusterFromS3Request) throws DbClusterAlreadyExistsException, DbClusterQuotaExceededException, StorageQuotaExceededException, DbSubnetGroupNotFoundException, InvalidVpcNetworkStateException, InvalidDbClusterStateException, InvalidDbSubnetGroupStateException, InvalidSubnetException, InvalidS3BucketException, DbClusterParameterGroupNotFoundException, KmsKeyNotAccessibleException, DbClusterNotFoundException, DomainNotFoundException, InsufficientStorageClusterCapacityException, StorageTypeNotSupportedException, AwsServiceException, SdkClientException, RdsException
Creates an Amazon Aurora DB cluster from MySQL data stored in an Amazon S3 bucket. Amazon RDS must be authorized to access the Amazon S3 bucket and the data must be created using the Percona XtraBackup utility as described in Migrating Data from MySQL by Using an Amazon S3 Bucket in the Amazon Aurora User Guide.
This operation only restores the DB cluster, not the DB instances for that DB cluster. You must invoke the
CreateDBInstance
operation to create DB instances for the restored DB cluster, specifying the identifier of the restored DB cluster inDBClusterIdentifier
. You can create DB instances only after theRestoreDBClusterFromS3
operation has completed and the DB cluster is available.For more information on Amazon Aurora, see What is Amazon Aurora? in the Amazon Aurora User Guide.
This operation only applies to Aurora DB clusters. The source DB engine must be MySQL.
This is a convenience which creates an instance of the
RestoreDbClusterFromS3Request.Builder
avoiding the need to create one manually viaRestoreDbClusterFromS3Request.builder()
- Parameters:
restoreDbClusterFromS3Request
- AConsumer
that will call methods onRestoreDbClusterFromS3Request.Builder
to create a request.- Returns:
- Result of the RestoreDBClusterFromS3 operation returned by the service.
- Throws:
DbClusterAlreadyExistsException
- The user already has a DB cluster with the given identifier.DbClusterQuotaExceededException
- The user attempted to create a new DB cluster and the user has already reached the maximum allowed DB cluster quota.StorageQuotaExceededException
- The request would result in the user exceeding the allowed amount of storage available across all DB instances.DbSubnetGroupNotFoundException
-DBSubnetGroupName
doesn't refer to an existing DB subnet group.InvalidVpcNetworkStateException
- The DB subnet group doesn't cover all Availability Zones after it's created because of users' change.InvalidDbClusterStateException
- The requested operation can't be performed while the cluster is in this state.InvalidDbSubnetGroupStateException
- The DB subnet group cannot be deleted because it's in use.InvalidSubnetException
- The requested subnet is invalid, or multiple subnets were requested that are not all in a common VPC.InvalidS3BucketException
- The specified Amazon S3 bucket name can't be found or Amazon RDS isn't authorized to access the specified Amazon S3 bucket. Verify the SourceS3BucketName and S3IngestionRoleArn values and try again.DbClusterParameterGroupNotFoundException
-DBClusterParameterGroupName
doesn't refer to an existing DB cluster parameter group.KmsKeyNotAccessibleException
- An error occurred accessing an Amazon Web Services KMS key.DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.DomainNotFoundException
-Domain
doesn't refer to an existing Active Directory domain.InsufficientStorageClusterCapacityException
- There is insufficient storage available for the current action. You might be able to resolve this error by updating your subnet group to use different Availability Zones that have more storage available.StorageTypeNotSupportedException
- The specifiedStorageType
can't be associated with the DB instance.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
restoreDBClusterFromSnapshot
default RestoreDbClusterFromSnapshotResponse restoreDBClusterFromSnapshot(RestoreDbClusterFromSnapshotRequest restoreDbClusterFromSnapshotRequest) throws DbClusterAlreadyExistsException, DbClusterQuotaExceededException, StorageQuotaExceededException, DbSubnetGroupNotFoundException, DbSnapshotNotFoundException, DbClusterSnapshotNotFoundException, InsufficientDbClusterCapacityException, InsufficientStorageClusterCapacityException, InvalidDbSnapshotStateException, InvalidDbClusterSnapshotStateException, InvalidVpcNetworkStateException, DbSubnetGroupDoesNotCoverEnoughAZsException, InvalidRestoreException, InvalidSubnetException, OptionGroupNotFoundException, KmsKeyNotAccessibleException, DomainNotFoundException, DbClusterParameterGroupNotFoundException, InvalidDbInstanceStateException, InsufficientDbInstanceCapacityException, AwsServiceException, SdkClientException, RdsException
Creates a new DB cluster from a DB snapshot or DB cluster snapshot.
The target DB cluster is created from the source snapshot with a default configuration. If you don't specify a security group, the new DB cluster is associated with the default security group.
This operation only restores the DB cluster, not the DB instances for that DB cluster. You must invoke the
CreateDBInstance
operation to create DB instances for the restored DB cluster, specifying the identifier of the restored DB cluster inDBClusterIdentifier
. You can create DB instances only after theRestoreDBClusterFromSnapshot
operation has completed and the DB cluster is available.For more information on Amazon Aurora DB clusters, see What is Amazon Aurora? in the Amazon Aurora User Guide.
For more information on Multi-AZ DB clusters, see Multi-AZ DB cluster deployments in the Amazon RDS User Guide.
- Parameters:
restoreDbClusterFromSnapshotRequest
-- Returns:
- Result of the RestoreDBClusterFromSnapshot operation returned by the service.
- Throws:
DbClusterAlreadyExistsException
- The user already has a DB cluster with the given identifier.DbClusterQuotaExceededException
- The user attempted to create a new DB cluster and the user has already reached the maximum allowed DB cluster quota.StorageQuotaExceededException
- The request would result in the user exceeding the allowed amount of storage available across all DB instances.DbSubnetGroupNotFoundException
-DBSubnetGroupName
doesn't refer to an existing DB subnet group.DbSnapshotNotFoundException
-DBSnapshotIdentifier
doesn't refer to an existing DB snapshot.DbClusterSnapshotNotFoundException
-DBClusterSnapshotIdentifier
doesn't refer to an existing DB cluster snapshot.InsufficientDbClusterCapacityException
- The DB cluster doesn't have enough capacity for the current operation.InsufficientStorageClusterCapacityException
- There is insufficient storage available for the current action. You might be able to resolve this error by updating your subnet group to use different Availability Zones that have more storage available.InvalidDbSnapshotStateException
- The state of the DB snapshot doesn't allow deletion.InvalidDbClusterSnapshotStateException
- The supplied value isn't a valid DB cluster snapshot state.StorageQuotaExceededException
- The request would result in the user exceeding the allowed amount of storage available across all DB instances.InvalidVpcNetworkStateException
- The DB subnet group doesn't cover all Availability Zones after it's created because of users' change.DbSubnetGroupDoesNotCoverEnoughAZsException
- Subnets in the DB subnet group should cover at least two Availability Zones unless there is only one Availability Zone.InvalidRestoreException
- Cannot restore from VPC backup to non-VPC DB instance.DbSubnetGroupNotFoundException
-DBSubnetGroupName
doesn't refer to an existing DB subnet group.InvalidSubnetException
- The requested subnet is invalid, or multiple subnets were requested that are not all in a common VPC.OptionGroupNotFoundException
- The specified option group could not be found.KmsKeyNotAccessibleException
- An error occurred accessing an Amazon Web Services KMS key.DomainNotFoundException
-Domain
doesn't refer to an existing Active Directory domain.DbClusterParameterGroupNotFoundException
-DBClusterParameterGroupName
doesn't refer to an existing DB cluster parameter group.InvalidDbInstanceStateException
- The DB instance isn't in a valid state.InsufficientDbInstanceCapacityException
- The specified DB instance class isn't available in the specified Availability Zone.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
restoreDBClusterFromSnapshot
default RestoreDbClusterFromSnapshotResponse restoreDBClusterFromSnapshot(Consumer<RestoreDbClusterFromSnapshotRequest.Builder> restoreDbClusterFromSnapshotRequest) throws DbClusterAlreadyExistsException, DbClusterQuotaExceededException, StorageQuotaExceededException, DbSubnetGroupNotFoundException, DbSnapshotNotFoundException, DbClusterSnapshotNotFoundException, InsufficientDbClusterCapacityException, InsufficientStorageClusterCapacityException, InvalidDbSnapshotStateException, InvalidDbClusterSnapshotStateException, InvalidVpcNetworkStateException, DbSubnetGroupDoesNotCoverEnoughAZsException, InvalidRestoreException, InvalidSubnetException, OptionGroupNotFoundException, KmsKeyNotAccessibleException, DomainNotFoundException, DbClusterParameterGroupNotFoundException, InvalidDbInstanceStateException, InsufficientDbInstanceCapacityException, AwsServiceException, SdkClientException, RdsException
Creates a new DB cluster from a DB snapshot or DB cluster snapshot.
The target DB cluster is created from the source snapshot with a default configuration. If you don't specify a security group, the new DB cluster is associated with the default security group.
This operation only restores the DB cluster, not the DB instances for that DB cluster. You must invoke the
CreateDBInstance
operation to create DB instances for the restored DB cluster, specifying the identifier of the restored DB cluster inDBClusterIdentifier
. You can create DB instances only after theRestoreDBClusterFromSnapshot
operation has completed and the DB cluster is available.For more information on Amazon Aurora DB clusters, see What is Amazon Aurora? in the Amazon Aurora User Guide.
For more information on Multi-AZ DB clusters, see Multi-AZ DB cluster deployments in the Amazon RDS User Guide.
This is a convenience which creates an instance of the
RestoreDbClusterFromSnapshotRequest.Builder
avoiding the need to create one manually viaRestoreDbClusterFromSnapshotRequest.builder()
- Parameters:
restoreDbClusterFromSnapshotRequest
- AConsumer
that will call methods onRestoreDbClusterFromSnapshotRequest.Builder
to create a request.- Returns:
- Result of the RestoreDBClusterFromSnapshot operation returned by the service.
- Throws:
DbClusterAlreadyExistsException
- The user already has a DB cluster with the given identifier.DbClusterQuotaExceededException
- The user attempted to create a new DB cluster and the user has already reached the maximum allowed DB cluster quota.StorageQuotaExceededException
- The request would result in the user exceeding the allowed amount of storage available across all DB instances.DbSubnetGroupNotFoundException
-DBSubnetGroupName
doesn't refer to an existing DB subnet group.DbSnapshotNotFoundException
-DBSnapshotIdentifier
doesn't refer to an existing DB snapshot.DbClusterSnapshotNotFoundException
-DBClusterSnapshotIdentifier
doesn't refer to an existing DB cluster snapshot.InsufficientDbClusterCapacityException
- The DB cluster doesn't have enough capacity for the current operation.InsufficientStorageClusterCapacityException
- There is insufficient storage available for the current action. You might be able to resolve this error by updating your subnet group to use different Availability Zones that have more storage available.InvalidDbSnapshotStateException
- The state of the DB snapshot doesn't allow deletion.InvalidDbClusterSnapshotStateException
- The supplied value isn't a valid DB cluster snapshot state.StorageQuotaExceededException
- The request would result in the user exceeding the allowed amount of storage available across all DB instances.InvalidVpcNetworkStateException
- The DB subnet group doesn't cover all Availability Zones after it's created because of users' change.DbSubnetGroupDoesNotCoverEnoughAZsException
- Subnets in the DB subnet group should cover at least two Availability Zones unless there is only one Availability Zone.InvalidRestoreException
- Cannot restore from VPC backup to non-VPC DB instance.DbSubnetGroupNotFoundException
-DBSubnetGroupName
doesn't refer to an existing DB subnet group.InvalidSubnetException
- The requested subnet is invalid, or multiple subnets were requested that are not all in a common VPC.OptionGroupNotFoundException
- The specified option group could not be found.KmsKeyNotAccessibleException
- An error occurred accessing an Amazon Web Services KMS key.DomainNotFoundException
-Domain
doesn't refer to an existing Active Directory domain.DbClusterParameterGroupNotFoundException
-DBClusterParameterGroupName
doesn't refer to an existing DB cluster parameter group.InvalidDbInstanceStateException
- The DB instance isn't in a valid state.InsufficientDbInstanceCapacityException
- The specified DB instance class isn't available in the specified Availability Zone.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
restoreDBClusterToPointInTime
default RestoreDbClusterToPointInTimeResponse restoreDBClusterToPointInTime(RestoreDbClusterToPointInTimeRequest restoreDbClusterToPointInTimeRequest) throws DbClusterAlreadyExistsException, DbClusterNotFoundException, DbClusterQuotaExceededException, DbClusterSnapshotNotFoundException, DbSubnetGroupNotFoundException, InsufficientDbClusterCapacityException, InsufficientStorageClusterCapacityException, InvalidDbClusterSnapshotStateException, InvalidDbClusterStateException, InvalidDbSnapshotStateException, InvalidRestoreException, InvalidSubnetException, InvalidVpcNetworkStateException, KmsKeyNotAccessibleException, OptionGroupNotFoundException, StorageQuotaExceededException, DomainNotFoundException, DbClusterParameterGroupNotFoundException, DbClusterAutomatedBackupNotFoundException, InsufficientDbInstanceCapacityException, AwsServiceException, SdkClientException, RdsException
Restores a DB cluster to an arbitrary point in time. Users can restore to any point in time before
LatestRestorableTime
for up toBackupRetentionPeriod
days. The target DB cluster is created from the source DB cluster with the same configuration as the original DB cluster, except that the new DB cluster is created with the default DB security group.For Aurora, this operation only restores the DB cluster, not the DB instances for that DB cluster. You must invoke the
CreateDBInstance
operation to create DB instances for the restored DB cluster, specifying the identifier of the restored DB cluster inDBClusterIdentifier
. You can create DB instances only after theRestoreDBClusterToPointInTime
operation has completed and the DB cluster is available.For more information on Amazon Aurora DB clusters, see What is Amazon Aurora? in the Amazon Aurora User Guide.
For more information on Multi-AZ DB clusters, see Multi-AZ DB cluster deployments in the Amazon RDS User Guide.
- Parameters:
restoreDbClusterToPointInTimeRequest
-- Returns:
- Result of the RestoreDBClusterToPointInTime operation returned by the service.
- Throws:
DbClusterAlreadyExistsException
- The user already has a DB cluster with the given identifier.DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.DbClusterQuotaExceededException
- The user attempted to create a new DB cluster and the user has already reached the maximum allowed DB cluster quota.DbClusterSnapshotNotFoundException
-DBClusterSnapshotIdentifier
doesn't refer to an existing DB cluster snapshot.DbSubnetGroupNotFoundException
-DBSubnetGroupName
doesn't refer to an existing DB subnet group.InsufficientDbClusterCapacityException
- The DB cluster doesn't have enough capacity for the current operation.InsufficientStorageClusterCapacityException
- There is insufficient storage available for the current action. You might be able to resolve this error by updating your subnet group to use different Availability Zones that have more storage available.InvalidDbClusterSnapshotStateException
- The supplied value isn't a valid DB cluster snapshot state.InvalidDbClusterStateException
- The requested operation can't be performed while the cluster is in this state.InvalidDbSnapshotStateException
- The state of the DB snapshot doesn't allow deletion.InvalidRestoreException
- Cannot restore from VPC backup to non-VPC DB instance.InvalidSubnetException
- The requested subnet is invalid, or multiple subnets were requested that are not all in a common VPC.InvalidVpcNetworkStateException
- The DB subnet group doesn't cover all Availability Zones after it's created because of users' change.KmsKeyNotAccessibleException
- An error occurred accessing an Amazon Web Services KMS key.OptionGroupNotFoundException
- The specified option group could not be found.StorageQuotaExceededException
- The request would result in the user exceeding the allowed amount of storage available across all DB instances.DomainNotFoundException
-Domain
doesn't refer to an existing Active Directory domain.DbClusterParameterGroupNotFoundException
-DBClusterParameterGroupName
doesn't refer to an existing DB cluster parameter group.DbClusterAutomatedBackupNotFoundException
- No automated backup for this DB cluster was found.InsufficientDbInstanceCapacityException
- The specified DB instance class isn't available in the specified Availability Zone.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
restoreDBClusterToPointInTime
default RestoreDbClusterToPointInTimeResponse restoreDBClusterToPointInTime(Consumer<RestoreDbClusterToPointInTimeRequest.Builder> restoreDbClusterToPointInTimeRequest) throws DbClusterAlreadyExistsException, DbClusterNotFoundException, DbClusterQuotaExceededException, DbClusterSnapshotNotFoundException, DbSubnetGroupNotFoundException, InsufficientDbClusterCapacityException, InsufficientStorageClusterCapacityException, InvalidDbClusterSnapshotStateException, InvalidDbClusterStateException, InvalidDbSnapshotStateException, InvalidRestoreException, InvalidSubnetException, InvalidVpcNetworkStateException, KmsKeyNotAccessibleException, OptionGroupNotFoundException, StorageQuotaExceededException, DomainNotFoundException, DbClusterParameterGroupNotFoundException, DbClusterAutomatedBackupNotFoundException, InsufficientDbInstanceCapacityException, AwsServiceException, SdkClientException, RdsException
Restores a DB cluster to an arbitrary point in time. Users can restore to any point in time before
LatestRestorableTime
for up toBackupRetentionPeriod
days. The target DB cluster is created from the source DB cluster with the same configuration as the original DB cluster, except that the new DB cluster is created with the default DB security group.For Aurora, this operation only restores the DB cluster, not the DB instances for that DB cluster. You must invoke the
CreateDBInstance
operation to create DB instances for the restored DB cluster, specifying the identifier of the restored DB cluster inDBClusterIdentifier
. You can create DB instances only after theRestoreDBClusterToPointInTime
operation has completed and the DB cluster is available.For more information on Amazon Aurora DB clusters, see What is Amazon Aurora? in the Amazon Aurora User Guide.
For more information on Multi-AZ DB clusters, see Multi-AZ DB cluster deployments in the Amazon RDS User Guide.
This is a convenience which creates an instance of the
RestoreDbClusterToPointInTimeRequest.Builder
avoiding the need to create one manually viaRestoreDbClusterToPointInTimeRequest.builder()
- Parameters:
restoreDbClusterToPointInTimeRequest
- AConsumer
that will call methods onRestoreDbClusterToPointInTimeRequest.Builder
to create a request.- Returns:
- Result of the RestoreDBClusterToPointInTime operation returned by the service.
- Throws:
DbClusterAlreadyExistsException
- The user already has a DB cluster with the given identifier.DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.DbClusterQuotaExceededException
- The user attempted to create a new DB cluster and the user has already reached the maximum allowed DB cluster quota.DbClusterSnapshotNotFoundException
-DBClusterSnapshotIdentifier
doesn't refer to an existing DB cluster snapshot.DbSubnetGroupNotFoundException
-DBSubnetGroupName
doesn't refer to an existing DB subnet group.InsufficientDbClusterCapacityException
- The DB cluster doesn't have enough capacity for the current operation.InsufficientStorageClusterCapacityException
- There is insufficient storage available for the current action. You might be able to resolve this error by updating your subnet group to use different Availability Zones that have more storage available.InvalidDbClusterSnapshotStateException
- The supplied value isn't a valid DB cluster snapshot state.InvalidDbClusterStateException
- The requested operation can't be performed while the cluster is in this state.InvalidDbSnapshotStateException
- The state of the DB snapshot doesn't allow deletion.InvalidRestoreException
- Cannot restore from VPC backup to non-VPC DB instance.InvalidSubnetException
- The requested subnet is invalid, or multiple subnets were requested that are not all in a common VPC.InvalidVpcNetworkStateException
- The DB subnet group doesn't cover all Availability Zones after it's created because of users' change.KmsKeyNotAccessibleException
- An error occurred accessing an Amazon Web Services KMS key.OptionGroupNotFoundException
- The specified option group could not be found.StorageQuotaExceededException
- The request would result in the user exceeding the allowed amount of storage available across all DB instances.DomainNotFoundException
-Domain
doesn't refer to an existing Active Directory domain.DbClusterParameterGroupNotFoundException
-DBClusterParameterGroupName
doesn't refer to an existing DB cluster parameter group.DbClusterAutomatedBackupNotFoundException
- No automated backup for this DB cluster was found.InsufficientDbInstanceCapacityException
- The specified DB instance class isn't available in the specified Availability Zone.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
restoreDBInstanceFromDBSnapshot
default RestoreDbInstanceFromDbSnapshotResponse restoreDBInstanceFromDBSnapshot(RestoreDbInstanceFromDbSnapshotRequest restoreDbInstanceFromDbSnapshotRequest) throws DbInstanceAlreadyExistsException, DbSnapshotNotFoundException, InstanceQuotaExceededException, InsufficientDbInstanceCapacityException, InvalidDbSnapshotStateException, StorageQuotaExceededException, InvalidVpcNetworkStateException, InvalidRestoreException, DbSubnetGroupNotFoundException, DbSubnetGroupDoesNotCoverEnoughAZsException, InvalidSubnetException, ProvisionedIopsNotAvailableInAzException, OptionGroupNotFoundException, StorageTypeNotSupportedException, AuthorizationNotFoundException, KmsKeyNotAccessibleException, DbSecurityGroupNotFoundException, DomainNotFoundException, DbParameterGroupNotFoundException, NetworkTypeNotSupportedException, DbClusterSnapshotNotFoundException, CertificateNotFoundException, TenantDatabaseQuotaExceededException, AwsServiceException, SdkClientException, RdsException
Creates a new DB instance from a DB snapshot. The target database is created from the source database restore point with most of the source's original configuration, including the default security group and DB parameter group. By default, the new DB instance is created as a Single-AZ deployment, except when the instance is a SQL Server instance that has an option group associated with mirroring. In this case, the instance becomes a Multi-AZ deployment, not a Single-AZ deployment.
If you want to replace your original DB instance with the new, restored DB instance, then rename your original DB instance before you call the
RestoreDBInstanceFromDBSnapshot
operation. RDS doesn't allow two DB instances with the same name. After you have renamed your original DB instance with a different identifier, then you can pass the original name of the DB instance as theDBInstanceIdentifier
in the call to theRestoreDBInstanceFromDBSnapshot
operation. The result is that you replace the original DB instance with the DB instance created from the snapshot.If you are restoring from a shared manual DB snapshot, the
DBSnapshotIdentifier
must be the ARN of the shared DB snapshot.To restore from a DB snapshot with an unsupported engine version, you must first upgrade the engine version of the snapshot. For more information about upgrading a RDS for MySQL DB snapshot engine version, see Upgrading a MySQL DB snapshot engine version. For more information about upgrading a RDS for PostgreSQL DB snapshot engine version, Upgrading a PostgreSQL DB snapshot engine version.
This command doesn't apply to Aurora MySQL and Aurora PostgreSQL. For Aurora, use
RestoreDBClusterFromSnapshot
.- Parameters:
restoreDbInstanceFromDbSnapshotRequest
-- Returns:
- Result of the RestoreDBInstanceFromDBSnapshot operation returned by the service.
- Throws:
DbInstanceAlreadyExistsException
- The user already has a DB instance with the given identifier.DbSnapshotNotFoundException
-DBSnapshotIdentifier
doesn't refer to an existing DB snapshot.InstanceQuotaExceededException
- The request would result in the user exceeding the allowed number of DB instances.InsufficientDbInstanceCapacityException
- The specified DB instance class isn't available in the specified Availability Zone.InvalidDbSnapshotStateException
- The state of the DB snapshot doesn't allow deletion.StorageQuotaExceededException
- The request would result in the user exceeding the allowed amount of storage available across all DB instances.InvalidVpcNetworkStateException
- The DB subnet group doesn't cover all Availability Zones after it's created because of users' change.InvalidRestoreException
- Cannot restore from VPC backup to non-VPC DB instance.DbSubnetGroupNotFoundException
-DBSubnetGroupName
doesn't refer to an existing DB subnet group.DbSubnetGroupDoesNotCoverEnoughAZsException
- Subnets in the DB subnet group should cover at least two Availability Zones unless there is only one Availability Zone.InvalidSubnetException
- The requested subnet is invalid, or multiple subnets were requested that are not all in a common VPC.ProvisionedIopsNotAvailableInAzException
- Provisioned IOPS not available in the specified Availability Zone.OptionGroupNotFoundException
- The specified option group could not be found.StorageTypeNotSupportedException
- The specifiedStorageType
can't be associated with the DB instance.AuthorizationNotFoundException
- The specified CIDR IP range or Amazon EC2 security group might not be authorized for the specified DB security group.Or, RDS might not be authorized to perform necessary actions using IAM on your behalf.
KmsKeyNotAccessibleException
- An error occurred accessing an Amazon Web Services KMS key.DbSecurityGroupNotFoundException
-DBSecurityGroupName
doesn't refer to an existing DB security group.DomainNotFoundException
-Domain
doesn't refer to an existing Active Directory domain.DbParameterGroupNotFoundException
-DBParameterGroupName
doesn't refer to an existing DB parameter group.NetworkTypeNotSupportedException
- The network type is invalid for the DB instance. Valid nework type values areIPV4
andDUAL
.DbClusterSnapshotNotFoundException
-DBClusterSnapshotIdentifier
doesn't refer to an existing DB cluster snapshot.CertificateNotFoundException
-CertificateIdentifier
doesn't refer to an existing certificate.TenantDatabaseQuotaExceededException
- You attempted to create more tenant databases than are permitted in your Amazon Web Services account.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
restoreDBInstanceFromDBSnapshot
default RestoreDbInstanceFromDbSnapshotResponse restoreDBInstanceFromDBSnapshot(Consumer<RestoreDbInstanceFromDbSnapshotRequest.Builder> restoreDbInstanceFromDbSnapshotRequest) throws DbInstanceAlreadyExistsException, DbSnapshotNotFoundException, InstanceQuotaExceededException, InsufficientDbInstanceCapacityException, InvalidDbSnapshotStateException, StorageQuotaExceededException, InvalidVpcNetworkStateException, InvalidRestoreException, DbSubnetGroupNotFoundException, DbSubnetGroupDoesNotCoverEnoughAZsException, InvalidSubnetException, ProvisionedIopsNotAvailableInAzException, OptionGroupNotFoundException, StorageTypeNotSupportedException, AuthorizationNotFoundException, KmsKeyNotAccessibleException, DbSecurityGroupNotFoundException, DomainNotFoundException, DbParameterGroupNotFoundException, NetworkTypeNotSupportedException, DbClusterSnapshotNotFoundException, CertificateNotFoundException, TenantDatabaseQuotaExceededException, AwsServiceException, SdkClientException, RdsException
Creates a new DB instance from a DB snapshot. The target database is created from the source database restore point with most of the source's original configuration, including the default security group and DB parameter group. By default, the new DB instance is created as a Single-AZ deployment, except when the instance is a SQL Server instance that has an option group associated with mirroring. In this case, the instance becomes a Multi-AZ deployment, not a Single-AZ deployment.
If you want to replace your original DB instance with the new, restored DB instance, then rename your original DB instance before you call the
RestoreDBInstanceFromDBSnapshot
operation. RDS doesn't allow two DB instances with the same name. After you have renamed your original DB instance with a different identifier, then you can pass the original name of the DB instance as theDBInstanceIdentifier
in the call to theRestoreDBInstanceFromDBSnapshot
operation. The result is that you replace the original DB instance with the DB instance created from the snapshot.If you are restoring from a shared manual DB snapshot, the
DBSnapshotIdentifier
must be the ARN of the shared DB snapshot.To restore from a DB snapshot with an unsupported engine version, you must first upgrade the engine version of the snapshot. For more information about upgrading a RDS for MySQL DB snapshot engine version, see Upgrading a MySQL DB snapshot engine version. For more information about upgrading a RDS for PostgreSQL DB snapshot engine version, Upgrading a PostgreSQL DB snapshot engine version.
This command doesn't apply to Aurora MySQL and Aurora PostgreSQL. For Aurora, use
RestoreDBClusterFromSnapshot
.
This is a convenience which creates an instance of the
RestoreDbInstanceFromDbSnapshotRequest.Builder
avoiding the need to create one manually viaRestoreDbInstanceFromDbSnapshotRequest.builder()
- Parameters:
restoreDbInstanceFromDbSnapshotRequest
- AConsumer
that will call methods onRestoreDbInstanceFromDbSnapshotRequest.Builder
to create a request.- Returns:
- Result of the RestoreDBInstanceFromDBSnapshot operation returned by the service.
- Throws:
DbInstanceAlreadyExistsException
- The user already has a DB instance with the given identifier.DbSnapshotNotFoundException
-DBSnapshotIdentifier
doesn't refer to an existing DB snapshot.InstanceQuotaExceededException
- The request would result in the user exceeding the allowed number of DB instances.InsufficientDbInstanceCapacityException
- The specified DB instance class isn't available in the specified Availability Zone.InvalidDbSnapshotStateException
- The state of the DB snapshot doesn't allow deletion.StorageQuotaExceededException
- The request would result in the user exceeding the allowed amount of storage available across all DB instances.InvalidVpcNetworkStateException
- The DB subnet group doesn't cover all Availability Zones after it's created because of users' change.InvalidRestoreException
- Cannot restore from VPC backup to non-VPC DB instance.DbSubnetGroupNotFoundException
-DBSubnetGroupName
doesn't refer to an existing DB subnet group.DbSubnetGroupDoesNotCoverEnoughAZsException
- Subnets in the DB subnet group should cover at least two Availability Zones unless there is only one Availability Zone.InvalidSubnetException
- The requested subnet is invalid, or multiple subnets were requested that are not all in a common VPC.ProvisionedIopsNotAvailableInAzException
- Provisioned IOPS not available in the specified Availability Zone.OptionGroupNotFoundException
- The specified option group could not be found.StorageTypeNotSupportedException
- The specifiedStorageType
can't be associated with the DB instance.AuthorizationNotFoundException
- The specified CIDR IP range or Amazon EC2 security group might not be authorized for the specified DB security group.Or, RDS might not be authorized to perform necessary actions using IAM on your behalf.
KmsKeyNotAccessibleException
- An error occurred accessing an Amazon Web Services KMS key.DbSecurityGroupNotFoundException
-DBSecurityGroupName
doesn't refer to an existing DB security group.DomainNotFoundException
-Domain
doesn't refer to an existing Active Directory domain.DbParameterGroupNotFoundException
-DBParameterGroupName
doesn't refer to an existing DB parameter group.NetworkTypeNotSupportedException
- The network type is invalid for the DB instance. Valid nework type values areIPV4
andDUAL
.DbClusterSnapshotNotFoundException
-DBClusterSnapshotIdentifier
doesn't refer to an existing DB cluster snapshot.CertificateNotFoundException
-CertificateIdentifier
doesn't refer to an existing certificate.TenantDatabaseQuotaExceededException
- You attempted to create more tenant databases than are permitted in your Amazon Web Services account.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
restoreDBInstanceFromS3
default RestoreDbInstanceFromS3Response restoreDBInstanceFromS3(RestoreDbInstanceFromS3Request restoreDbInstanceFromS3Request) throws DbInstanceAlreadyExistsException, InsufficientDbInstanceCapacityException, DbParameterGroupNotFoundException, DbSecurityGroupNotFoundException, InstanceQuotaExceededException, StorageQuotaExceededException, DbSubnetGroupNotFoundException, DbSubnetGroupDoesNotCoverEnoughAZsException, InvalidSubnetException, InvalidVpcNetworkStateException, InvalidS3BucketException, ProvisionedIopsNotAvailableInAzException, OptionGroupNotFoundException, StorageTypeNotSupportedException, AuthorizationNotFoundException, KmsKeyNotAccessibleException, NetworkTypeNotSupportedException, CertificateNotFoundException, AwsServiceException, SdkClientException, RdsException
Amazon Relational Database Service (Amazon RDS) supports importing MySQL databases by using backup files. You can create a backup of your on-premises database, store it on Amazon Simple Storage Service (Amazon S3), and then restore the backup file onto a new Amazon RDS DB instance running MySQL. For more information, see Importing Data into an Amazon RDS MySQL DB Instance in the Amazon RDS User Guide.
This operation doesn't apply to RDS Custom.
- Parameters:
restoreDbInstanceFromS3Request
-- Returns:
- Result of the RestoreDBInstanceFromS3 operation returned by the service.
- Throws:
DbInstanceAlreadyExistsException
- The user already has a DB instance with the given identifier.InsufficientDbInstanceCapacityException
- The specified DB instance class isn't available in the specified Availability Zone.DbParameterGroupNotFoundException
-DBParameterGroupName
doesn't refer to an existing DB parameter group.DbSecurityGroupNotFoundException
-DBSecurityGroupName
doesn't refer to an existing DB security group.InstanceQuotaExceededException
- The request would result in the user exceeding the allowed number of DB instances.StorageQuotaExceededException
- The request would result in the user exceeding the allowed amount of storage available across all DB instances.DbSubnetGroupNotFoundException
-DBSubnetGroupName
doesn't refer to an existing DB subnet group.DbSubnetGroupDoesNotCoverEnoughAZsException
- Subnets in the DB subnet group should cover at least two Availability Zones unless there is only one Availability Zone.InvalidSubnetException
- The requested subnet is invalid, or multiple subnets were requested that are not all in a common VPC.InvalidVpcNetworkStateException
- The DB subnet group doesn't cover all Availability Zones after it's created because of users' change.InvalidS3BucketException
- The specified Amazon S3 bucket name can't be found or Amazon RDS isn't authorized to access the specified Amazon S3 bucket. Verify the SourceS3BucketName and S3IngestionRoleArn values and try again.ProvisionedIopsNotAvailableInAzException
- Provisioned IOPS not available in the specified Availability Zone.OptionGroupNotFoundException
- The specified option group could not be found.StorageTypeNotSupportedException
- The specifiedStorageType
can't be associated with the DB instance.AuthorizationNotFoundException
- The specified CIDR IP range or Amazon EC2 security group might not be authorized for the specified DB security group.Or, RDS might not be authorized to perform necessary actions using IAM on your behalf.
KmsKeyNotAccessibleException
- An error occurred accessing an Amazon Web Services KMS key.NetworkTypeNotSupportedException
- The network type is invalid for the DB instance. Valid nework type values areIPV4
andDUAL
.CertificateNotFoundException
-CertificateIdentifier
doesn't refer to an existing certificate.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
restoreDBInstanceFromS3
default RestoreDbInstanceFromS3Response restoreDBInstanceFromS3(Consumer<RestoreDbInstanceFromS3Request.Builder> restoreDbInstanceFromS3Request) throws DbInstanceAlreadyExistsException, InsufficientDbInstanceCapacityException, DbParameterGroupNotFoundException, DbSecurityGroupNotFoundException, InstanceQuotaExceededException, StorageQuotaExceededException, DbSubnetGroupNotFoundException, DbSubnetGroupDoesNotCoverEnoughAZsException, InvalidSubnetException, InvalidVpcNetworkStateException, InvalidS3BucketException, ProvisionedIopsNotAvailableInAzException, OptionGroupNotFoundException, StorageTypeNotSupportedException, AuthorizationNotFoundException, KmsKeyNotAccessibleException, NetworkTypeNotSupportedException, CertificateNotFoundException, AwsServiceException, SdkClientException, RdsException
Amazon Relational Database Service (Amazon RDS) supports importing MySQL databases by using backup files. You can create a backup of your on-premises database, store it on Amazon Simple Storage Service (Amazon S3), and then restore the backup file onto a new Amazon RDS DB instance running MySQL. For more information, see Importing Data into an Amazon RDS MySQL DB Instance in the Amazon RDS User Guide.
This operation doesn't apply to RDS Custom.
This is a convenience which creates an instance of the
RestoreDbInstanceFromS3Request.Builder
avoiding the need to create one manually viaRestoreDbInstanceFromS3Request.builder()
- Parameters:
restoreDbInstanceFromS3Request
- AConsumer
that will call methods onRestoreDbInstanceFromS3Request.Builder
to create a request.- Returns:
- Result of the RestoreDBInstanceFromS3 operation returned by the service.
- Throws:
DbInstanceAlreadyExistsException
- The user already has a DB instance with the given identifier.InsufficientDbInstanceCapacityException
- The specified DB instance class isn't available in the specified Availability Zone.DbParameterGroupNotFoundException
-DBParameterGroupName
doesn't refer to an existing DB parameter group.DbSecurityGroupNotFoundException
-DBSecurityGroupName
doesn't refer to an existing DB security group.InstanceQuotaExceededException
- The request would result in the user exceeding the allowed number of DB instances.StorageQuotaExceededException
- The request would result in the user exceeding the allowed amount of storage available across all DB instances.DbSubnetGroupNotFoundException
-DBSubnetGroupName
doesn't refer to an existing DB subnet group.DbSubnetGroupDoesNotCoverEnoughAZsException
- Subnets in the DB subnet group should cover at least two Availability Zones unless there is only one Availability Zone.InvalidSubnetException
- The requested subnet is invalid, or multiple subnets were requested that are not all in a common VPC.InvalidVpcNetworkStateException
- The DB subnet group doesn't cover all Availability Zones after it's created because of users' change.InvalidS3BucketException
- The specified Amazon S3 bucket name can't be found or Amazon RDS isn't authorized to access the specified Amazon S3 bucket. Verify the SourceS3BucketName and S3IngestionRoleArn values and try again.ProvisionedIopsNotAvailableInAzException
- Provisioned IOPS not available in the specified Availability Zone.OptionGroupNotFoundException
- The specified option group could not be found.StorageTypeNotSupportedException
- The specifiedStorageType
can't be associated with the DB instance.AuthorizationNotFoundException
- The specified CIDR IP range or Amazon EC2 security group might not be authorized for the specified DB security group.Or, RDS might not be authorized to perform necessary actions using IAM on your behalf.
KmsKeyNotAccessibleException
- An error occurred accessing an Amazon Web Services KMS key.NetworkTypeNotSupportedException
- The network type is invalid for the DB instance. Valid nework type values areIPV4
andDUAL
.CertificateNotFoundException
-CertificateIdentifier
doesn't refer to an existing certificate.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
restoreDBInstanceToPointInTime
default RestoreDbInstanceToPointInTimeResponse restoreDBInstanceToPointInTime(RestoreDbInstanceToPointInTimeRequest restoreDbInstanceToPointInTimeRequest) throws DbInstanceAlreadyExistsException, DbInstanceNotFoundException, InstanceQuotaExceededException, InsufficientDbInstanceCapacityException, InvalidDbInstanceStateException, PointInTimeRestoreNotEnabledException, StorageQuotaExceededException, InvalidVpcNetworkStateException, InvalidRestoreException, DbSubnetGroupNotFoundException, DbSubnetGroupDoesNotCoverEnoughAZsException, InvalidSubnetException, ProvisionedIopsNotAvailableInAzException, OptionGroupNotFoundException, StorageTypeNotSupportedException, AuthorizationNotFoundException, KmsKeyNotAccessibleException, DbSecurityGroupNotFoundException, DomainNotFoundException, DbParameterGroupNotFoundException, DbInstanceAutomatedBackupNotFoundException, NetworkTypeNotSupportedException, TenantDatabaseQuotaExceededException, CertificateNotFoundException, AwsServiceException, SdkClientException, RdsException
Restores a DB instance to an arbitrary point in time. You can restore to any point in time before the time identified by the
LatestRestorableTime
property. You can restore to a point up to the number of days specified by theBackupRetentionPeriod
property.The target database is created with most of the original configuration, but in a system-selected Availability Zone, with the default security group, the default subnet group, and the default DB parameter group. By default, the new DB instance is created as a single-AZ deployment except when the instance is a SQL Server instance that has an option group that is associated with mirroring; in this case, the instance becomes a mirrored deployment and not a single-AZ deployment.
This operation doesn't apply to Aurora MySQL and Aurora PostgreSQL. For Aurora, use
RestoreDBClusterToPointInTime
.- Parameters:
restoreDbInstanceToPointInTimeRequest
-- Returns:
- Result of the RestoreDBInstanceToPointInTime operation returned by the service.
- Throws:
DbInstanceAlreadyExistsException
- The user already has a DB instance with the given identifier.DbInstanceNotFoundException
-DBInstanceIdentifier
doesn't refer to an existing DB instance.InstanceQuotaExceededException
- The request would result in the user exceeding the allowed number of DB instances.InsufficientDbInstanceCapacityException
- The specified DB instance class isn't available in the specified Availability Zone.InvalidDbInstanceStateException
- The DB instance isn't in a valid state.PointInTimeRestoreNotEnabledException
-SourceDBInstanceIdentifier
refers to a DB instance withBackupRetentionPeriod
equal to 0.StorageQuotaExceededException
- The request would result in the user exceeding the allowed amount of storage available across all DB instances.InvalidVpcNetworkStateException
- The DB subnet group doesn't cover all Availability Zones after it's created because of users' change.InvalidRestoreException
- Cannot restore from VPC backup to non-VPC DB instance.DbSubnetGroupNotFoundException
-DBSubnetGroupName
doesn't refer to an existing DB subnet group.DbSubnetGroupDoesNotCoverEnoughAZsException
- Subnets in the DB subnet group should cover at least two Availability Zones unless there is only one Availability Zone.InvalidSubnetException
- The requested subnet is invalid, or multiple subnets were requested that are not all in a common VPC.ProvisionedIopsNotAvailableInAzException
- Provisioned IOPS not available in the specified Availability Zone.OptionGroupNotFoundException
- The specified option group could not be found.StorageTypeNotSupportedException
- The specifiedStorageType
can't be associated with the DB instance.AuthorizationNotFoundException
- The specified CIDR IP range or Amazon EC2 security group might not be authorized for the specified DB security group.Or, RDS might not be authorized to perform necessary actions using IAM on your behalf.
KmsKeyNotAccessibleException
- An error occurred accessing an Amazon Web Services KMS key.DbSecurityGroupNotFoundException
-DBSecurityGroupName
doesn't refer to an existing DB security group.DomainNotFoundException
-Domain
doesn't refer to an existing Active Directory domain.DbParameterGroupNotFoundException
-DBParameterGroupName
doesn't refer to an existing DB parameter group.DbInstanceAutomatedBackupNotFoundException
- No automated backup for this DB instance was found.NetworkTypeNotSupportedException
- The network type is invalid for the DB instance. Valid nework type values areIPV4
andDUAL
.TenantDatabaseQuotaExceededException
- You attempted to create more tenant databases than are permitted in your Amazon Web Services account.CertificateNotFoundException
-CertificateIdentifier
doesn't refer to an existing certificate.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
restoreDBInstanceToPointInTime
default RestoreDbInstanceToPointInTimeResponse restoreDBInstanceToPointInTime(Consumer<RestoreDbInstanceToPointInTimeRequest.Builder> restoreDbInstanceToPointInTimeRequest) throws DbInstanceAlreadyExistsException, DbInstanceNotFoundException, InstanceQuotaExceededException, InsufficientDbInstanceCapacityException, InvalidDbInstanceStateException, PointInTimeRestoreNotEnabledException, StorageQuotaExceededException, InvalidVpcNetworkStateException, InvalidRestoreException, DbSubnetGroupNotFoundException, DbSubnetGroupDoesNotCoverEnoughAZsException, InvalidSubnetException, ProvisionedIopsNotAvailableInAzException, OptionGroupNotFoundException, StorageTypeNotSupportedException, AuthorizationNotFoundException, KmsKeyNotAccessibleException, DbSecurityGroupNotFoundException, DomainNotFoundException, DbParameterGroupNotFoundException, DbInstanceAutomatedBackupNotFoundException, NetworkTypeNotSupportedException, TenantDatabaseQuotaExceededException, CertificateNotFoundException, AwsServiceException, SdkClientException, RdsException
Restores a DB instance to an arbitrary point in time. You can restore to any point in time before the time identified by the
LatestRestorableTime
property. You can restore to a point up to the number of days specified by theBackupRetentionPeriod
property.The target database is created with most of the original configuration, but in a system-selected Availability Zone, with the default security group, the default subnet group, and the default DB parameter group. By default, the new DB instance is created as a single-AZ deployment except when the instance is a SQL Server instance that has an option group that is associated with mirroring; in this case, the instance becomes a mirrored deployment and not a single-AZ deployment.
This operation doesn't apply to Aurora MySQL and Aurora PostgreSQL. For Aurora, use
RestoreDBClusterToPointInTime
.
This is a convenience which creates an instance of the
RestoreDbInstanceToPointInTimeRequest.Builder
avoiding the need to create one manually viaRestoreDbInstanceToPointInTimeRequest.builder()
- Parameters:
restoreDbInstanceToPointInTimeRequest
- AConsumer
that will call methods onRestoreDbInstanceToPointInTimeRequest.Builder
to create a request.- Returns:
- Result of the RestoreDBInstanceToPointInTime operation returned by the service.
- Throws:
DbInstanceAlreadyExistsException
- The user already has a DB instance with the given identifier.DbInstanceNotFoundException
-DBInstanceIdentifier
doesn't refer to an existing DB instance.InstanceQuotaExceededException
- The request would result in the user exceeding the allowed number of DB instances.InsufficientDbInstanceCapacityException
- The specified DB instance class isn't available in the specified Availability Zone.InvalidDbInstanceStateException
- The DB instance isn't in a valid state.PointInTimeRestoreNotEnabledException
-SourceDBInstanceIdentifier
refers to a DB instance withBackupRetentionPeriod
equal to 0.StorageQuotaExceededException
- The request would result in the user exceeding the allowed amount of storage available across all DB instances.InvalidVpcNetworkStateException
- The DB subnet group doesn't cover all Availability Zones after it's created because of users' change.InvalidRestoreException
- Cannot restore from VPC backup to non-VPC DB instance.DbSubnetGroupNotFoundException
-DBSubnetGroupName
doesn't refer to an existing DB subnet group.DbSubnetGroupDoesNotCoverEnoughAZsException
- Subnets in the DB subnet group should cover at least two Availability Zones unless there is only one Availability Zone.InvalidSubnetException
- The requested subnet is invalid, or multiple subnets were requested that are not all in a common VPC.ProvisionedIopsNotAvailableInAzException
- Provisioned IOPS not available in the specified Availability Zone.OptionGroupNotFoundException
- The specified option group could not be found.StorageTypeNotSupportedException
- The specifiedStorageType
can't be associated with the DB instance.AuthorizationNotFoundException
- The specified CIDR IP range or Amazon EC2 security group might not be authorized for the specified DB security group.Or, RDS might not be authorized to perform necessary actions using IAM on your behalf.
KmsKeyNotAccessibleException
- An error occurred accessing an Amazon Web Services KMS key.DbSecurityGroupNotFoundException
-DBSecurityGroupName
doesn't refer to an existing DB security group.DomainNotFoundException
-Domain
doesn't refer to an existing Active Directory domain.DbParameterGroupNotFoundException
-DBParameterGroupName
doesn't refer to an existing DB parameter group.DbInstanceAutomatedBackupNotFoundException
- No automated backup for this DB instance was found.NetworkTypeNotSupportedException
- The network type is invalid for the DB instance. Valid nework type values areIPV4
andDUAL
.TenantDatabaseQuotaExceededException
- You attempted to create more tenant databases than are permitted in your Amazon Web Services account.CertificateNotFoundException
-CertificateIdentifier
doesn't refer to an existing certificate.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
revokeDBSecurityGroupIngress
default RevokeDbSecurityGroupIngressResponse revokeDBSecurityGroupIngress(RevokeDbSecurityGroupIngressRequest revokeDbSecurityGroupIngressRequest) throws DbSecurityGroupNotFoundException, AuthorizationNotFoundException, InvalidDbSecurityGroupStateException, AwsServiceException, SdkClientException, RdsException
Revokes ingress from a DBSecurityGroup for previously authorized IP ranges or EC2 or VPC security groups. Required parameters for this API are one of CIDRIP, EC2SecurityGroupId for VPC, or (EC2SecurityGroupOwnerId and either EC2SecurityGroupName or EC2SecurityGroupId).
EC2-Classic was retired on August 15, 2022. If you haven't migrated from EC2-Classic to a VPC, we recommend that you migrate as soon as possible. For more information, see Migrate from EC2-Classic to a VPC in the Amazon EC2 User Guide, the blog EC2-Classic Networking is Retiring – Here’s How to Prepare, and Moving a DB instance not in a VPC into a VPC in the Amazon RDS User Guide.
- Parameters:
revokeDbSecurityGroupIngressRequest
-- Returns:
- Result of the RevokeDBSecurityGroupIngress operation returned by the service.
- Throws:
DbSecurityGroupNotFoundException
-DBSecurityGroupName
doesn't refer to an existing DB security group.AuthorizationNotFoundException
- The specified CIDR IP range or Amazon EC2 security group might not be authorized for the specified DB security group.Or, RDS might not be authorized to perform necessary actions using IAM on your behalf.
InvalidDbSecurityGroupStateException
- The state of the DB security group doesn't allow deletion.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
revokeDBSecurityGroupIngress
default RevokeDbSecurityGroupIngressResponse revokeDBSecurityGroupIngress(Consumer<RevokeDbSecurityGroupIngressRequest.Builder> revokeDbSecurityGroupIngressRequest) throws DbSecurityGroupNotFoundException, AuthorizationNotFoundException, InvalidDbSecurityGroupStateException, AwsServiceException, SdkClientException, RdsException
Revokes ingress from a DBSecurityGroup for previously authorized IP ranges or EC2 or VPC security groups. Required parameters for this API are one of CIDRIP, EC2SecurityGroupId for VPC, or (EC2SecurityGroupOwnerId and either EC2SecurityGroupName or EC2SecurityGroupId).
EC2-Classic was retired on August 15, 2022. If you haven't migrated from EC2-Classic to a VPC, we recommend that you migrate as soon as possible. For more information, see Migrate from EC2-Classic to a VPC in the Amazon EC2 User Guide, the blog EC2-Classic Networking is Retiring – Here’s How to Prepare, and Moving a DB instance not in a VPC into a VPC in the Amazon RDS User Guide.
This is a convenience which creates an instance of the
RevokeDbSecurityGroupIngressRequest.Builder
avoiding the need to create one manually viaRevokeDbSecurityGroupIngressRequest.builder()
- Parameters:
revokeDbSecurityGroupIngressRequest
- AConsumer
that will call methods onRevokeDbSecurityGroupIngressRequest.Builder
to create a request.- Returns:
- Result of the RevokeDBSecurityGroupIngress operation returned by the service.
- Throws:
DbSecurityGroupNotFoundException
-DBSecurityGroupName
doesn't refer to an existing DB security group.AuthorizationNotFoundException
- The specified CIDR IP range or Amazon EC2 security group might not be authorized for the specified DB security group.Or, RDS might not be authorized to perform necessary actions using IAM on your behalf.
InvalidDbSecurityGroupStateException
- The state of the DB security group doesn't allow deletion.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
startActivityStream
default StartActivityStreamResponse startActivityStream(StartActivityStreamRequest startActivityStreamRequest) throws InvalidDbInstanceStateException, InvalidDbClusterStateException, ResourceNotFoundException, DbClusterNotFoundException, DbInstanceNotFoundException, KmsKeyNotAccessibleException, AwsServiceException, SdkClientException, RdsException
Starts a database activity stream to monitor activity on the database. For more information, see Monitoring Amazon Aurora with Database Activity Streams in the Amazon Aurora User Guide or Monitoring Amazon RDS with Database Activity Streams in the Amazon RDS User Guide.
- Parameters:
startActivityStreamRequest
-- Returns:
- Result of the StartActivityStream operation returned by the service.
- Throws:
InvalidDbInstanceStateException
- The DB instance isn't in a valid state.InvalidDbClusterStateException
- The requested operation can't be performed while the cluster is in this state.ResourceNotFoundException
- The specified resource ID was not found.DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.DbInstanceNotFoundException
-DBInstanceIdentifier
doesn't refer to an existing DB instance.KmsKeyNotAccessibleException
- An error occurred accessing an Amazon Web Services KMS key.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
startActivityStream
default StartActivityStreamResponse startActivityStream(Consumer<StartActivityStreamRequest.Builder> startActivityStreamRequest) throws InvalidDbInstanceStateException, InvalidDbClusterStateException, ResourceNotFoundException, DbClusterNotFoundException, DbInstanceNotFoundException, KmsKeyNotAccessibleException, AwsServiceException, SdkClientException, RdsException
Starts a database activity stream to monitor activity on the database. For more information, see Monitoring Amazon Aurora with Database Activity Streams in the Amazon Aurora User Guide or Monitoring Amazon RDS with Database Activity Streams in the Amazon RDS User Guide.
This is a convenience which creates an instance of the
StartActivityStreamRequest.Builder
avoiding the need to create one manually viaStartActivityStreamRequest.builder()
- Parameters:
startActivityStreamRequest
- AConsumer
that will call methods onStartActivityStreamRequest.Builder
to create a request.- Returns:
- Result of the StartActivityStream operation returned by the service.
- Throws:
InvalidDbInstanceStateException
- The DB instance isn't in a valid state.InvalidDbClusterStateException
- The requested operation can't be performed while the cluster is in this state.ResourceNotFoundException
- The specified resource ID was not found.DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.DbInstanceNotFoundException
-DBInstanceIdentifier
doesn't refer to an existing DB instance.KmsKeyNotAccessibleException
- An error occurred accessing an Amazon Web Services KMS key.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
startDBCluster
default StartDbClusterResponse startDBCluster(StartDbClusterRequest startDbClusterRequest) throws DbClusterNotFoundException, InvalidDbClusterStateException, InvalidDbInstanceStateException, AwsServiceException, SdkClientException, RdsException
Starts an Amazon Aurora DB cluster that was stopped using the Amazon Web Services console, the stop-db-cluster CLI command, or the
StopDBCluster
operation.For more information, see Stopping and Starting an Aurora Cluster in the Amazon Aurora User Guide.
This operation only applies to Aurora DB clusters.
- Parameters:
startDbClusterRequest
-- Returns:
- Result of the StartDBCluster operation returned by the service.
- Throws:
DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.InvalidDbClusterStateException
- The requested operation can't be performed while the cluster is in this state.InvalidDbInstanceStateException
- The DB instance isn't in a valid state.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
startDBCluster
default StartDbClusterResponse startDBCluster(Consumer<StartDbClusterRequest.Builder> startDbClusterRequest) throws DbClusterNotFoundException, InvalidDbClusterStateException, InvalidDbInstanceStateException, AwsServiceException, SdkClientException, RdsException
Starts an Amazon Aurora DB cluster that was stopped using the Amazon Web Services console, the stop-db-cluster CLI command, or the
StopDBCluster
operation.For more information, see Stopping and Starting an Aurora Cluster in the Amazon Aurora User Guide.
This operation only applies to Aurora DB clusters.
This is a convenience which creates an instance of the
StartDbClusterRequest.Builder
avoiding the need to create one manually viaStartDbClusterRequest.builder()
- Parameters:
startDbClusterRequest
- AConsumer
that will call methods onStartDbClusterRequest.Builder
to create a request.- Returns:
- Result of the StartDBCluster operation returned by the service.
- Throws:
DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.InvalidDbClusterStateException
- The requested operation can't be performed while the cluster is in this state.InvalidDbInstanceStateException
- The DB instance isn't in a valid state.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
startDBInstance
default StartDbInstanceResponse startDBInstance(StartDbInstanceRequest startDbInstanceRequest) throws DbInstanceNotFoundException, InvalidDbInstanceStateException, InsufficientDbInstanceCapacityException, DbSubnetGroupNotFoundException, DbSubnetGroupDoesNotCoverEnoughAZsException, InvalidDbClusterStateException, InvalidSubnetException, InvalidVpcNetworkStateException, DbClusterNotFoundException, AuthorizationNotFoundException, KmsKeyNotAccessibleException, AwsServiceException, SdkClientException, RdsException
Starts an Amazon RDS DB instance that was stopped using the Amazon Web Services console, the stop-db-instance CLI command, or the
StopDBInstance
operation.For more information, see Starting an Amazon RDS DB instance That Was Previously Stopped in the Amazon RDS User Guide.
This command doesn't apply to RDS Custom, Aurora MySQL, and Aurora PostgreSQL. For Aurora DB clusters, use
StartDBCluster
instead.- Parameters:
startDbInstanceRequest
-- Returns:
- Result of the StartDBInstance operation returned by the service.
- Throws:
DbInstanceNotFoundException
-DBInstanceIdentifier
doesn't refer to an existing DB instance.InvalidDbInstanceStateException
- The DB instance isn't in a valid state.InsufficientDbInstanceCapacityException
- The specified DB instance class isn't available in the specified Availability Zone.DbSubnetGroupNotFoundException
-DBSubnetGroupName
doesn't refer to an existing DB subnet group.DbSubnetGroupDoesNotCoverEnoughAZsException
- Subnets in the DB subnet group should cover at least two Availability Zones unless there is only one Availability Zone.InvalidDbClusterStateException
- The requested operation can't be performed while the cluster is in this state.InvalidSubnetException
- The requested subnet is invalid, or multiple subnets were requested that are not all in a common VPC.InvalidVpcNetworkStateException
- The DB subnet group doesn't cover all Availability Zones after it's created because of users' change.DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.AuthorizationNotFoundException
- The specified CIDR IP range or Amazon EC2 security group might not be authorized for the specified DB security group.Or, RDS might not be authorized to perform necessary actions using IAM on your behalf.
KmsKeyNotAccessibleException
- An error occurred accessing an Amazon Web Services KMS key.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
startDBInstance
default StartDbInstanceResponse startDBInstance(Consumer<StartDbInstanceRequest.Builder> startDbInstanceRequest) throws DbInstanceNotFoundException, InvalidDbInstanceStateException, InsufficientDbInstanceCapacityException, DbSubnetGroupNotFoundException, DbSubnetGroupDoesNotCoverEnoughAZsException, InvalidDbClusterStateException, InvalidSubnetException, InvalidVpcNetworkStateException, DbClusterNotFoundException, AuthorizationNotFoundException, KmsKeyNotAccessibleException, AwsServiceException, SdkClientException, RdsException
Starts an Amazon RDS DB instance that was stopped using the Amazon Web Services console, the stop-db-instance CLI command, or the
StopDBInstance
operation.For more information, see Starting an Amazon RDS DB instance That Was Previously Stopped in the Amazon RDS User Guide.
This command doesn't apply to RDS Custom, Aurora MySQL, and Aurora PostgreSQL. For Aurora DB clusters, use
StartDBCluster
instead.
This is a convenience which creates an instance of the
StartDbInstanceRequest.Builder
avoiding the need to create one manually viaStartDbInstanceRequest.builder()
- Parameters:
startDbInstanceRequest
- AConsumer
that will call methods onStartDbInstanceRequest.Builder
to create a request.- Returns:
- Result of the StartDBInstance operation returned by the service.
- Throws:
DbInstanceNotFoundException
-DBInstanceIdentifier
doesn't refer to an existing DB instance.InvalidDbInstanceStateException
- The DB instance isn't in a valid state.InsufficientDbInstanceCapacityException
- The specified DB instance class isn't available in the specified Availability Zone.DbSubnetGroupNotFoundException
-DBSubnetGroupName
doesn't refer to an existing DB subnet group.DbSubnetGroupDoesNotCoverEnoughAZsException
- Subnets in the DB subnet group should cover at least two Availability Zones unless there is only one Availability Zone.InvalidDbClusterStateException
- The requested operation can't be performed while the cluster is in this state.InvalidSubnetException
- The requested subnet is invalid, or multiple subnets were requested that are not all in a common VPC.InvalidVpcNetworkStateException
- The DB subnet group doesn't cover all Availability Zones after it's created because of users' change.DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.AuthorizationNotFoundException
- The specified CIDR IP range or Amazon EC2 security group might not be authorized for the specified DB security group.Or, RDS might not be authorized to perform necessary actions using IAM on your behalf.
KmsKeyNotAccessibleException
- An error occurred accessing an Amazon Web Services KMS key.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
startDBInstanceAutomatedBackupsReplication
default StartDbInstanceAutomatedBackupsReplicationResponse startDBInstanceAutomatedBackupsReplication(StartDbInstanceAutomatedBackupsReplicationRequest startDbInstanceAutomatedBackupsReplicationRequest) throws DbInstanceNotFoundException, InvalidDbInstanceStateException, KmsKeyNotAccessibleException, DbInstanceAutomatedBackupQuotaExceededException, StorageTypeNotSupportedException, AwsServiceException, SdkClientException, RdsException
Enables replication of automated backups to a different Amazon Web Services Region.
This command doesn't apply to RDS Custom.
For more information, see Replicating Automated Backups to Another Amazon Web Services Region in the Amazon RDS User Guide.
- Parameters:
startDbInstanceAutomatedBackupsReplicationRequest
-- Returns:
- Result of the StartDBInstanceAutomatedBackupsReplication operation returned by the service.
- Throws:
DbInstanceNotFoundException
-DBInstanceIdentifier
doesn't refer to an existing DB instance.InvalidDbInstanceStateException
- The DB instance isn't in a valid state.KmsKeyNotAccessibleException
- An error occurred accessing an Amazon Web Services KMS key.DbInstanceAutomatedBackupQuotaExceededException
- The quota for retained automated backups was exceeded. This prevents you from retaining any additional automated backups. The retained automated backups quota is the same as your DB instance quota.StorageTypeNotSupportedException
- The specifiedStorageType
can't be associated with the DB instance.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
startDBInstanceAutomatedBackupsReplication
default StartDbInstanceAutomatedBackupsReplicationResponse startDBInstanceAutomatedBackupsReplication(Consumer<StartDbInstanceAutomatedBackupsReplicationRequest.Builder> startDbInstanceAutomatedBackupsReplicationRequest) throws DbInstanceNotFoundException, InvalidDbInstanceStateException, KmsKeyNotAccessibleException, DbInstanceAutomatedBackupQuotaExceededException, StorageTypeNotSupportedException, AwsServiceException, SdkClientException, RdsException
Enables replication of automated backups to a different Amazon Web Services Region.
This command doesn't apply to RDS Custom.
For more information, see Replicating Automated Backups to Another Amazon Web Services Region in the Amazon RDS User Guide.
This is a convenience which creates an instance of the
StartDbInstanceAutomatedBackupsReplicationRequest.Builder
avoiding the need to create one manually viaStartDbInstanceAutomatedBackupsReplicationRequest.builder()
- Parameters:
startDbInstanceAutomatedBackupsReplicationRequest
- AConsumer
that will call methods onStartDbInstanceAutomatedBackupsReplicationRequest.Builder
to create a request.- Returns:
- Result of the StartDBInstanceAutomatedBackupsReplication operation returned by the service.
- Throws:
DbInstanceNotFoundException
-DBInstanceIdentifier
doesn't refer to an existing DB instance.InvalidDbInstanceStateException
- The DB instance isn't in a valid state.KmsKeyNotAccessibleException
- An error occurred accessing an Amazon Web Services KMS key.DbInstanceAutomatedBackupQuotaExceededException
- The quota for retained automated backups was exceeded. This prevents you from retaining any additional automated backups. The retained automated backups quota is the same as your DB instance quota.StorageTypeNotSupportedException
- The specifiedStorageType
can't be associated with the DB instance.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
startExportTask
default StartExportTaskResponse startExportTask(StartExportTaskRequest startExportTaskRequest) throws DbSnapshotNotFoundException, DbClusterSnapshotNotFoundException, DbClusterNotFoundException, ExportTaskAlreadyExistsException, InvalidS3BucketException, IamRoleNotFoundException, IamRoleMissingPermissionsException, InvalidExportOnlyException, KmsKeyNotAccessibleException, InvalidExportSourceStateException, AwsServiceException, SdkClientException, RdsException
Starts an export of DB snapshot or DB cluster data to Amazon S3. The provided IAM role must have access to the S3 bucket.
You can't export snapshot data from Db2 or RDS Custom DB instances.
For more information on exporting DB snapshot data, see Exporting DB snapshot data to Amazon S3 in the Amazon RDS User Guide or Exporting DB cluster snapshot data to Amazon S3 in the Amazon Aurora User Guide.
For more information on exporting DB cluster data, see Exporting DB cluster data to Amazon S3 in the Amazon Aurora User Guide.
- Parameters:
startExportTaskRequest
-- Returns:
- Result of the StartExportTask operation returned by the service.
- Throws:
DbSnapshotNotFoundException
-DBSnapshotIdentifier
doesn't refer to an existing DB snapshot.DbClusterSnapshotNotFoundException
-DBClusterSnapshotIdentifier
doesn't refer to an existing DB cluster snapshot.DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.ExportTaskAlreadyExistsException
- You can't start an export task that's already running.InvalidS3BucketException
- The specified Amazon S3 bucket name can't be found or Amazon RDS isn't authorized to access the specified Amazon S3 bucket. Verify the SourceS3BucketName and S3IngestionRoleArn values and try again.IamRoleNotFoundException
- The IAM role is missing for exporting to an Amazon S3 bucket.IamRoleMissingPermissionsException
- The IAM role requires additional permissions to export to an Amazon S3 bucket.InvalidExportOnlyException
- The export is invalid for exporting to an Amazon S3 bucket.KmsKeyNotAccessibleException
- An error occurred accessing an Amazon Web Services KMS key.InvalidExportSourceStateException
- The state of the export snapshot is invalid for exporting to an Amazon S3 bucket.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
startExportTask
default StartExportTaskResponse startExportTask(Consumer<StartExportTaskRequest.Builder> startExportTaskRequest) throws DbSnapshotNotFoundException, DbClusterSnapshotNotFoundException, DbClusterNotFoundException, ExportTaskAlreadyExistsException, InvalidS3BucketException, IamRoleNotFoundException, IamRoleMissingPermissionsException, InvalidExportOnlyException, KmsKeyNotAccessibleException, InvalidExportSourceStateException, AwsServiceException, SdkClientException, RdsException
Starts an export of DB snapshot or DB cluster data to Amazon S3. The provided IAM role must have access to the S3 bucket.
You can't export snapshot data from Db2 or RDS Custom DB instances.
For more information on exporting DB snapshot data, see Exporting DB snapshot data to Amazon S3 in the Amazon RDS User Guide or Exporting DB cluster snapshot data to Amazon S3 in the Amazon Aurora User Guide.
For more information on exporting DB cluster data, see Exporting DB cluster data to Amazon S3 in the Amazon Aurora User Guide.
This is a convenience which creates an instance of the
StartExportTaskRequest.Builder
avoiding the need to create one manually viaStartExportTaskRequest.builder()
- Parameters:
startExportTaskRequest
- AConsumer
that will call methods onStartExportTaskRequest.Builder
to create a request.- Returns:
- Result of the StartExportTask operation returned by the service.
- Throws:
DbSnapshotNotFoundException
-DBSnapshotIdentifier
doesn't refer to an existing DB snapshot.DbClusterSnapshotNotFoundException
-DBClusterSnapshotIdentifier
doesn't refer to an existing DB cluster snapshot.DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.ExportTaskAlreadyExistsException
- You can't start an export task that's already running.InvalidS3BucketException
- The specified Amazon S3 bucket name can't be found or Amazon RDS isn't authorized to access the specified Amazon S3 bucket. Verify the SourceS3BucketName and S3IngestionRoleArn values and try again.IamRoleNotFoundException
- The IAM role is missing for exporting to an Amazon S3 bucket.IamRoleMissingPermissionsException
- The IAM role requires additional permissions to export to an Amazon S3 bucket.InvalidExportOnlyException
- The export is invalid for exporting to an Amazon S3 bucket.KmsKeyNotAccessibleException
- An error occurred accessing an Amazon Web Services KMS key.InvalidExportSourceStateException
- The state of the export snapshot is invalid for exporting to an Amazon S3 bucket.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
stopActivityStream
default StopActivityStreamResponse stopActivityStream(StopActivityStreamRequest stopActivityStreamRequest) throws InvalidDbInstanceStateException, InvalidDbClusterStateException, ResourceNotFoundException, DbClusterNotFoundException, DbInstanceNotFoundException, AwsServiceException, SdkClientException, RdsException
Stops a database activity stream that was started using the Amazon Web Services console, the
start-activity-stream
CLI command, or theStartActivityStream
operation.For more information, see Monitoring Amazon Aurora with Database Activity Streams in the Amazon Aurora User Guide or Monitoring Amazon RDS with Database Activity Streams in the Amazon RDS User Guide.
- Parameters:
stopActivityStreamRequest
-- Returns:
- Result of the StopActivityStream operation returned by the service.
- Throws:
InvalidDbInstanceStateException
- The DB instance isn't in a valid state.InvalidDbClusterStateException
- The requested operation can't be performed while the cluster is in this state.ResourceNotFoundException
- The specified resource ID was not found.DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.DbInstanceNotFoundException
-DBInstanceIdentifier
doesn't refer to an existing DB instance.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
stopActivityStream
default StopActivityStreamResponse stopActivityStream(Consumer<StopActivityStreamRequest.Builder> stopActivityStreamRequest) throws InvalidDbInstanceStateException, InvalidDbClusterStateException, ResourceNotFoundException, DbClusterNotFoundException, DbInstanceNotFoundException, AwsServiceException, SdkClientException, RdsException
Stops a database activity stream that was started using the Amazon Web Services console, the
start-activity-stream
CLI command, or theStartActivityStream
operation.For more information, see Monitoring Amazon Aurora with Database Activity Streams in the Amazon Aurora User Guide or Monitoring Amazon RDS with Database Activity Streams in the Amazon RDS User Guide.
This is a convenience which creates an instance of the
StopActivityStreamRequest.Builder
avoiding the need to create one manually viaStopActivityStreamRequest.builder()
- Parameters:
stopActivityStreamRequest
- AConsumer
that will call methods onStopActivityStreamRequest.Builder
to create a request.- Returns:
- Result of the StopActivityStream operation returned by the service.
- Throws:
InvalidDbInstanceStateException
- The DB instance isn't in a valid state.InvalidDbClusterStateException
- The requested operation can't be performed while the cluster is in this state.ResourceNotFoundException
- The specified resource ID was not found.DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.DbInstanceNotFoundException
-DBInstanceIdentifier
doesn't refer to an existing DB instance.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
stopDBCluster
default StopDbClusterResponse stopDBCluster(StopDbClusterRequest stopDbClusterRequest) throws DbClusterNotFoundException, InvalidDbClusterStateException, InvalidDbInstanceStateException, AwsServiceException, SdkClientException, RdsException
Stops an Amazon Aurora DB cluster. When you stop a DB cluster, Aurora retains the DB cluster's metadata, including its endpoints and DB parameter groups. Aurora also retains the transaction logs so you can do a point-in-time restore if necessary.
For more information, see Stopping and Starting an Aurora Cluster in the Amazon Aurora User Guide.
This operation only applies to Aurora DB clusters.
- Parameters:
stopDbClusterRequest
-- Returns:
- Result of the StopDBCluster operation returned by the service.
- Throws:
DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.InvalidDbClusterStateException
- The requested operation can't be performed while the cluster is in this state.InvalidDbInstanceStateException
- The DB instance isn't in a valid state.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
stopDBCluster
default StopDbClusterResponse stopDBCluster(Consumer<StopDbClusterRequest.Builder> stopDbClusterRequest) throws DbClusterNotFoundException, InvalidDbClusterStateException, InvalidDbInstanceStateException, AwsServiceException, SdkClientException, RdsException
Stops an Amazon Aurora DB cluster. When you stop a DB cluster, Aurora retains the DB cluster's metadata, including its endpoints and DB parameter groups. Aurora also retains the transaction logs so you can do a point-in-time restore if necessary.
For more information, see Stopping and Starting an Aurora Cluster in the Amazon Aurora User Guide.
This operation only applies to Aurora DB clusters.
This is a convenience which creates an instance of the
StopDbClusterRequest.Builder
avoiding the need to create one manually viaStopDbClusterRequest.builder()
- Parameters:
stopDbClusterRequest
- AConsumer
that will call methods onStopDbClusterRequest.Builder
to create a request.- Returns:
- Result of the StopDBCluster operation returned by the service.
- Throws:
DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.InvalidDbClusterStateException
- The requested operation can't be performed while the cluster is in this state.InvalidDbInstanceStateException
- The DB instance isn't in a valid state.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
stopDBInstance
default StopDbInstanceResponse stopDBInstance(StopDbInstanceRequest stopDbInstanceRequest) throws DbInstanceNotFoundException, InvalidDbInstanceStateException, DbSnapshotAlreadyExistsException, SnapshotQuotaExceededException, InvalidDbClusterStateException, AwsServiceException, SdkClientException, RdsException
Stops an Amazon RDS DB instance. When you stop a DB instance, Amazon RDS retains the DB instance's metadata, including its endpoint, DB parameter group, and option group membership. Amazon RDS also retains the transaction logs so you can do a point-in-time restore if necessary.
For more information, see Stopping an Amazon RDS DB Instance Temporarily in the Amazon RDS User Guide.
This command doesn't apply to RDS Custom, Aurora MySQL, and Aurora PostgreSQL. For Aurora clusters, use
StopDBCluster
instead.- Parameters:
stopDbInstanceRequest
-- Returns:
- Result of the StopDBInstance operation returned by the service.
- Throws:
DbInstanceNotFoundException
-DBInstanceIdentifier
doesn't refer to an existing DB instance.InvalidDbInstanceStateException
- The DB instance isn't in a valid state.DbSnapshotAlreadyExistsException
-DBSnapshotIdentifier
is already used by an existing snapshot.SnapshotQuotaExceededException
- The request would result in the user exceeding the allowed number of DB snapshots.InvalidDbClusterStateException
- The requested operation can't be performed while the cluster is in this state.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
stopDBInstance
default StopDbInstanceResponse stopDBInstance(Consumer<StopDbInstanceRequest.Builder> stopDbInstanceRequest) throws DbInstanceNotFoundException, InvalidDbInstanceStateException, DbSnapshotAlreadyExistsException, SnapshotQuotaExceededException, InvalidDbClusterStateException, AwsServiceException, SdkClientException, RdsException
Stops an Amazon RDS DB instance. When you stop a DB instance, Amazon RDS retains the DB instance's metadata, including its endpoint, DB parameter group, and option group membership. Amazon RDS also retains the transaction logs so you can do a point-in-time restore if necessary.
For more information, see Stopping an Amazon RDS DB Instance Temporarily in the Amazon RDS User Guide.
This command doesn't apply to RDS Custom, Aurora MySQL, and Aurora PostgreSQL. For Aurora clusters, use
StopDBCluster
instead.
This is a convenience which creates an instance of the
StopDbInstanceRequest.Builder
avoiding the need to create one manually viaStopDbInstanceRequest.builder()
- Parameters:
stopDbInstanceRequest
- AConsumer
that will call methods onStopDbInstanceRequest.Builder
to create a request.- Returns:
- Result of the StopDBInstance operation returned by the service.
- Throws:
DbInstanceNotFoundException
-DBInstanceIdentifier
doesn't refer to an existing DB instance.InvalidDbInstanceStateException
- The DB instance isn't in a valid state.DbSnapshotAlreadyExistsException
-DBSnapshotIdentifier
is already used by an existing snapshot.SnapshotQuotaExceededException
- The request would result in the user exceeding the allowed number of DB snapshots.InvalidDbClusterStateException
- The requested operation can't be performed while the cluster is in this state.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
stopDBInstanceAutomatedBackupsReplication
default StopDbInstanceAutomatedBackupsReplicationResponse stopDBInstanceAutomatedBackupsReplication(StopDbInstanceAutomatedBackupsReplicationRequest stopDbInstanceAutomatedBackupsReplicationRequest) throws DbInstanceNotFoundException, InvalidDbInstanceStateException, AwsServiceException, SdkClientException, RdsException
Stops automated backup replication for a DB instance.
This command doesn't apply to RDS Custom, Aurora MySQL, and Aurora PostgreSQL.
For more information, see Replicating Automated Backups to Another Amazon Web Services Region in the Amazon RDS User Guide.
- Parameters:
stopDbInstanceAutomatedBackupsReplicationRequest
-- Returns:
- Result of the StopDBInstanceAutomatedBackupsReplication operation returned by the service.
- Throws:
DbInstanceNotFoundException
-DBInstanceIdentifier
doesn't refer to an existing DB instance.InvalidDbInstanceStateException
- The DB instance isn't in a valid state.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
stopDBInstanceAutomatedBackupsReplication
default StopDbInstanceAutomatedBackupsReplicationResponse stopDBInstanceAutomatedBackupsReplication(Consumer<StopDbInstanceAutomatedBackupsReplicationRequest.Builder> stopDbInstanceAutomatedBackupsReplicationRequest) throws DbInstanceNotFoundException, InvalidDbInstanceStateException, AwsServiceException, SdkClientException, RdsException
Stops automated backup replication for a DB instance.
This command doesn't apply to RDS Custom, Aurora MySQL, and Aurora PostgreSQL.
For more information, see Replicating Automated Backups to Another Amazon Web Services Region in the Amazon RDS User Guide.
This is a convenience which creates an instance of the
StopDbInstanceAutomatedBackupsReplicationRequest.Builder
avoiding the need to create one manually viaStopDbInstanceAutomatedBackupsReplicationRequest.builder()
- Parameters:
stopDbInstanceAutomatedBackupsReplicationRequest
- AConsumer
that will call methods onStopDbInstanceAutomatedBackupsReplicationRequest.Builder
to create a request.- Returns:
- Result of the StopDBInstanceAutomatedBackupsReplication operation returned by the service.
- Throws:
DbInstanceNotFoundException
-DBInstanceIdentifier
doesn't refer to an existing DB instance.InvalidDbInstanceStateException
- The DB instance isn't in a valid state.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
switchoverBlueGreenDeployment
default SwitchoverBlueGreenDeploymentResponse switchoverBlueGreenDeployment(SwitchoverBlueGreenDeploymentRequest switchoverBlueGreenDeploymentRequest) throws BlueGreenDeploymentNotFoundException, InvalidBlueGreenDeploymentStateException, AwsServiceException, SdkClientException, RdsException
Switches over a blue/green deployment.
Before you switch over, production traffic is routed to the databases in the blue environment. After you switch over, production traffic is routed to the databases in the green environment.
For more information, see Using Amazon RDS Blue/Green Deployments for database updates in the Amazon RDS User Guide and Using Amazon RDS Blue/Green Deployments for database updates in the Amazon Aurora User Guide.
- Parameters:
switchoverBlueGreenDeploymentRequest
-- Returns:
- Result of the SwitchoverBlueGreenDeployment operation returned by the service.
- Throws:
BlueGreenDeploymentNotFoundException
-BlueGreenDeploymentIdentifier
doesn't refer to an existing blue/green deployment.InvalidBlueGreenDeploymentStateException
- The blue/green deployment can't be switched over or deleted because there is an invalid configuration in the green environment.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
switchoverBlueGreenDeployment
default SwitchoverBlueGreenDeploymentResponse switchoverBlueGreenDeployment(Consumer<SwitchoverBlueGreenDeploymentRequest.Builder> switchoverBlueGreenDeploymentRequest) throws BlueGreenDeploymentNotFoundException, InvalidBlueGreenDeploymentStateException, AwsServiceException, SdkClientException, RdsException
Switches over a blue/green deployment.
Before you switch over, production traffic is routed to the databases in the blue environment. After you switch over, production traffic is routed to the databases in the green environment.
For more information, see Using Amazon RDS Blue/Green Deployments for database updates in the Amazon RDS User Guide and Using Amazon RDS Blue/Green Deployments for database updates in the Amazon Aurora User Guide.
This is a convenience which creates an instance of the
SwitchoverBlueGreenDeploymentRequest.Builder
avoiding the need to create one manually viaSwitchoverBlueGreenDeploymentRequest.builder()
- Parameters:
switchoverBlueGreenDeploymentRequest
- AConsumer
that will call methods onSwitchoverBlueGreenDeploymentRequest.Builder
to create a request.- Returns:
- Result of the SwitchoverBlueGreenDeployment operation returned by the service.
- Throws:
BlueGreenDeploymentNotFoundException
-BlueGreenDeploymentIdentifier
doesn't refer to an existing blue/green deployment.InvalidBlueGreenDeploymentStateException
- The blue/green deployment can't be switched over or deleted because there is an invalid configuration in the green environment.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
switchoverGlobalCluster
default SwitchoverGlobalClusterResponse switchoverGlobalCluster(SwitchoverGlobalClusterRequest switchoverGlobalClusterRequest) throws GlobalClusterNotFoundException, InvalidGlobalClusterStateException, InvalidDbClusterStateException, DbClusterNotFoundException, AwsServiceException, SdkClientException, RdsException
Switches over the specified secondary DB cluster to be the new primary DB cluster in the global database cluster. Switchover operations were previously called "managed planned failovers."
Aurora promotes the specified secondary cluster to assume full read/write capabilities and demotes the current primary cluster to a secondary (read-only) cluster, maintaining the orginal replication topology. All secondary clusters are synchronized with the primary at the beginning of the process so the new primary continues operations for the Aurora global database without losing any data. Your database is unavailable for a short time while the primary and selected secondary clusters are assuming their new roles. For more information about switching over an Aurora global database, see Performing switchovers for Amazon Aurora global databases in the Amazon Aurora User Guide.
This operation is intended for controlled environments, for operations such as "regional rotation" or to fall back to the original primary after a global database failover.
- Parameters:
switchoverGlobalClusterRequest
-- Returns:
- Result of the SwitchoverGlobalCluster operation returned by the service.
- Throws:
GlobalClusterNotFoundException
- TheGlobalClusterIdentifier
doesn't refer to an existing global database cluster.InvalidGlobalClusterStateException
- The global cluster is in an invalid state and can't perform the requested operation.InvalidDbClusterStateException
- The requested operation can't be performed while the cluster is in this state.DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
switchoverGlobalCluster
default SwitchoverGlobalClusterResponse switchoverGlobalCluster(Consumer<SwitchoverGlobalClusterRequest.Builder> switchoverGlobalClusterRequest) throws GlobalClusterNotFoundException, InvalidGlobalClusterStateException, InvalidDbClusterStateException, DbClusterNotFoundException, AwsServiceException, SdkClientException, RdsException
Switches over the specified secondary DB cluster to be the new primary DB cluster in the global database cluster. Switchover operations were previously called "managed planned failovers."
Aurora promotes the specified secondary cluster to assume full read/write capabilities and demotes the current primary cluster to a secondary (read-only) cluster, maintaining the orginal replication topology. All secondary clusters are synchronized with the primary at the beginning of the process so the new primary continues operations for the Aurora global database without losing any data. Your database is unavailable for a short time while the primary and selected secondary clusters are assuming their new roles. For more information about switching over an Aurora global database, see Performing switchovers for Amazon Aurora global databases in the Amazon Aurora User Guide.
This operation is intended for controlled environments, for operations such as "regional rotation" or to fall back to the original primary after a global database failover.
This is a convenience which creates an instance of the
SwitchoverGlobalClusterRequest.Builder
avoiding the need to create one manually viaSwitchoverGlobalClusterRequest.builder()
- Parameters:
switchoverGlobalClusterRequest
- AConsumer
that will call methods onSwitchoverGlobalClusterRequest.Builder
to create a request.- Returns:
- Result of the SwitchoverGlobalCluster operation returned by the service.
- Throws:
GlobalClusterNotFoundException
- TheGlobalClusterIdentifier
doesn't refer to an existing global database cluster.InvalidGlobalClusterStateException
- The global cluster is in an invalid state and can't perform the requested operation.InvalidDbClusterStateException
- The requested operation can't be performed while the cluster is in this state.DbClusterNotFoundException
-DBClusterIdentifier
doesn't refer to an existing DB cluster.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
switchoverReadReplica
default SwitchoverReadReplicaResponse switchoverReadReplica(SwitchoverReadReplicaRequest switchoverReadReplicaRequest) throws DbInstanceNotFoundException, InvalidDbInstanceStateException, AwsServiceException, SdkClientException, RdsException
Switches over an Oracle standby database in an Oracle Data Guard environment, making it the new primary database. Issue this command in the Region that hosts the current standby database.
- Parameters:
switchoverReadReplicaRequest
-- Returns:
- Result of the SwitchoverReadReplica operation returned by the service.
- Throws:
DbInstanceNotFoundException
-DBInstanceIdentifier
doesn't refer to an existing DB instance.InvalidDbInstanceStateException
- The DB instance isn't in a valid state.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
switchoverReadReplica
default SwitchoverReadReplicaResponse switchoverReadReplica(Consumer<SwitchoverReadReplicaRequest.Builder> switchoverReadReplicaRequest) throws DbInstanceNotFoundException, InvalidDbInstanceStateException, AwsServiceException, SdkClientException, RdsException
Switches over an Oracle standby database in an Oracle Data Guard environment, making it the new primary database. Issue this command in the Region that hosts the current standby database.
This is a convenience which creates an instance of the
SwitchoverReadReplicaRequest.Builder
avoiding the need to create one manually viaSwitchoverReadReplicaRequest.builder()
- Parameters:
switchoverReadReplicaRequest
- AConsumer
that will call methods onSwitchoverReadReplicaRequest.Builder
to create a request.- Returns:
- Result of the SwitchoverReadReplica operation returned by the service.
- Throws:
DbInstanceNotFoundException
-DBInstanceIdentifier
doesn't refer to an existing DB instance.InvalidDbInstanceStateException
- The DB instance isn't in a valid state.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.RdsException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
- See Also:
- AWS API Documentation
-
utilities
default RdsUtilities utilities()
Creates an instance ofRdsUtilities
object with the configuration set on this client.
-
waiter
default RdsWaiter waiter()
Create an instance ofRdsWaiter
using this client.Waiters created via this method are managed by the SDK and resources will be released when the service client is closed.
- Returns:
- an instance of
RdsWaiter
-
create
static RdsClient create()
Create aRdsClient
with the region loaded from theDefaultAwsRegionProviderChain
and credentials loaded from theDefaultCredentialsProvider
.
-
builder
static RdsClientBuilder builder()
Create a builder that can be used to configure and create aRdsClient
.
-
serviceMetadata
static ServiceMetadata serviceMetadata()
-
serviceClientConfiguration
default RdsServiceClientConfiguration serviceClientConfiguration()
- Specified by:
serviceClientConfiguration
in interfaceAwsClient
- Specified by:
serviceClientConfiguration
in interfaceSdkClient
-
-