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 StringSERVICE_METADATA_IDValue for looking up the service's metadata from theServiceMetadataProvider.static StringSERVICE_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-DBClusterIdentifierdoesn'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.Builderavoiding the need to create one manually viaAddRoleToDbClusterRequest.builder()- Parameters:
addRoleToDbClusterRequest- AConsumerthat will call methods onAddRoleToDbClusterRequest.Builderto create a request.- Returns:
- Result of the AddRoleToDBCluster operation returned by the service.
- Throws:
DbClusterNotFoundException-DBClusterIdentifierdoesn'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-DBInstanceIdentifierdoesn't refer to an existing DB instance.DbInstanceRoleAlreadyExistsException- The specifiedRoleArnorFeatureNamevalue 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.Builderavoiding the need to create one manually viaAddRoleToDbInstanceRequest.builder()- Parameters:
addRoleToDbInstanceRequest- AConsumerthat will call methods onAddRoleToDbInstanceRequest.Builderto create a request.- Returns:
- Result of the AddRoleToDBInstance operation returned by the service.
- Throws:
DbInstanceNotFoundException-DBInstanceIdentifierdoesn't refer to an existing DB instance.DbInstanceRoleAlreadyExistsException- The specifiedRoleArnorFeatureNamevalue 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.Builderavoiding the need to create one manually viaAddSourceIdentifierToSubscriptionRequest.builder()- Parameters:
addSourceIdentifierToSubscriptionRequest- AConsumerthat will call methods onAddSourceIdentifierToSubscriptionRequest.Builderto 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-DBInstanceIdentifierdoesn't refer to an existing DB instance.DbClusterNotFoundException-DBClusterIdentifierdoesn't refer to an existing DB cluster.DbSnapshotNotFoundException-DBSnapshotIdentifierdoesn'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-BlueGreenDeploymentIdentifierdoesn'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.Builderavoiding the need to create one manually viaAddTagsToResourceRequest.builder()- Parameters:
addTagsToResourceRequest- AConsumerthat will call methods onAddTagsToResourceRequest.Builderto create a request.- Returns:
- Result of the AddTagsToResource operation returned by the service.
- Throws:
DbInstanceNotFoundException-DBInstanceIdentifierdoesn't refer to an existing DB instance.DbClusterNotFoundException-DBClusterIdentifierdoesn't refer to an existing DB cluster.DbSnapshotNotFoundException-DBSnapshotIdentifierdoesn'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-BlueGreenDeploymentIdentifierdoesn'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.Builderavoiding the need to create one manually viaApplyPendingMaintenanceActionRequest.builder()- Parameters:
applyPendingMaintenanceActionRequest- AConsumerthat will call methods onApplyPendingMaintenanceActionRequest.Builderto 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-DBSecurityGroupNamedoesn'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.Builderavoiding the need to create one manually viaAuthorizeDbSecurityGroupIngressRequest.builder()- Parameters:
authorizeDbSecurityGroupIngressRequest- AConsumerthat will call methods onAuthorizeDbSecurityGroupIngressRequest.Builderto create a request.- Returns:
- Result of the AuthorizeDBSecurityGroupIngress operation returned by the service.
- Throws:
DbSecurityGroupNotFoundException-DBSecurityGroupNamedoesn'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-DBClusterIdentifierdoesn'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.Builderavoiding the need to create one manually viaBacktrackDbClusterRequest.builder()- Parameters:
backtrackDbClusterRequest- AConsumerthat will call methods onBacktrackDbClusterRequest.Builderto create a request.- Returns:
- Result of the BacktrackDBCluster operation returned by the service.
- Throws:
DbClusterNotFoundException-DBClusterIdentifierdoesn'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.Builderavoiding the need to create one manually viaCancelExportTaskRequest.builder()- Parameters:
cancelExportTaskRequest- AConsumerthat will call methods onCancelExportTaskRequest.Builderto 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-DBParameterGroupNamedoesn'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.Builderavoiding the need to create one manually viaCopyDbClusterParameterGroupRequest.builder()- Parameters:
copyDbClusterParameterGroupRequest- AConsumerthat will call methods onCopyDbClusterParameterGroupRequest.Builderto create a request.- Returns:
- Result of the CopyDBClusterParameterGroup operation returned by the service.
- Throws:
DbParameterGroupNotFoundException-DBParameterGroupNamedoesn'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,
SourceDBClusterSnapshotIdentifiermust 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
CopyDBClusterSnapshotoperation 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 theSourceDBClusterSnapshotIdentifierin the presigned URL.
To cancel the copy operation once it is in progress, delete the target DB cluster snapshot identified by
TargetDBClusterSnapshotIdentifierwhile 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-DBClusterSnapshotIdentifierdoesn'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,
SourceDBClusterSnapshotIdentifiermust 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
CopyDBClusterSnapshotoperation 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 theSourceDBClusterSnapshotIdentifierin the presigned URL.
To cancel the copy operation once it is in progress, delete the target DB cluster snapshot identified by
TargetDBClusterSnapshotIdentifierwhile 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.Builderavoiding the need to create one manually viaCopyDbClusterSnapshotRequest.builder()- Parameters:
copyDbClusterSnapshotRequest- AConsumerthat will call methods onCopyDbClusterSnapshotRequest.Builderto 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-DBClusterSnapshotIdentifierdoesn'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-DBParameterGroupNamedoesn'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.Builderavoiding the need to create one manually viaCopyDbParameterGroupRequest.builder()- Parameters:
copyDbParameterGroupRequest- AConsumerthat will call methods onCopyDbParameterGroupRequest.Builderto create a request.- Returns:
- Result of the CopyDBParameterGroup operation returned by the service.
- Throws:
DbParameterGroupNotFoundException-DBParameterGroupNamedoesn'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
availablestate.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
CopyDBSnapshotoperation 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-DBSnapshotIdentifieris already used by an existing snapshot.DbSnapshotNotFoundException-DBSnapshotIdentifierdoesn'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-CustomAvailabilityZoneIddoesn'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
availablestate.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
CopyDBSnapshotoperation 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.Builderavoiding the need to create one manually viaCopyDbSnapshotRequest.builder()- Parameters:
copyDbSnapshotRequest- AConsumerthat will call methods onCopyDbSnapshotRequest.Builderto create a request.- Returns:
- Result of the CopyDBSnapshot operation returned by the service.
- Throws:
DbSnapshotAlreadyExistsException-DBSnapshotIdentifieris already used by an existing snapshot.DbSnapshotNotFoundException-DBSnapshotIdentifierdoesn'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-CustomAvailabilityZoneIddoesn'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.Builderavoiding the need to create one manually viaCopyOptionGroupRequest.builder()- Parameters:
copyOptionGroupRequest- AConsumerthat will call methods onCopyOptionGroupRequest.Builderto 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, and it stays in sync with the current production environment.
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-DBInstanceIdentifierdoesn't refer to an existing DB instance.DbClusterNotFoundException-DBClusterIdentifierdoesn'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-DBParameterGroupNamedoesn't refer to an existing DB parameter group.DbClusterParameterGroupNotFoundException-DBClusterParameterGroupNamedoesn'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, and it stays in sync with the current production environment.
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.Builderavoiding the need to create one manually viaCreateBlueGreenDeploymentRequest.builder()- Parameters:
createBlueGreenDeploymentRequest- AConsumerthat will call methods onCreateBlueGreenDeploymentRequest.Builderto create a request.- Returns:
- Result of the CreateBlueGreenDeployment operation returned by the service.
- Throws:
DbInstanceNotFoundException-DBInstanceIdentifierdoesn't refer to an existing DB instance.DbClusterNotFoundException-DBClusterIdentifierdoesn'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-DBParameterGroupNamedoesn't refer to an existing DB parameter group.DbClusterParameterGroupNotFoundException-DBClusterParameterGroupNamedoesn'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.Builderavoiding the need to create one manually viaCreateCustomDbEngineVersionRequest.builder()- Parameters:
createCustomDbEngineVersionRequest- AConsumerthat will call methods onCreateCustomDbEngineVersionRequest.Builderto 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
ReplicationSourceIdentifierparameter 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
ReplicationSourceIdentifierparameter 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-DBSubnetGroupNamedoesn'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-DBClusterParameterGroupNamedoesn't refer to an existing DB cluster parameter group.KmsKeyNotAccessibleException- An error occurred accessing an Amazon Web Services KMS key.DbClusterNotFoundException-DBClusterIdentifierdoesn't refer to an existing DB cluster.DbInstanceNotFoundException-DBInstanceIdentifierdoesn'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- TheGlobalClusterIdentifierdoesn'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-Domaindoesn'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
ReplicationSourceIdentifierparameter 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
ReplicationSourceIdentifierparameter 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.Builderavoiding the need to create one manually viaCreateDbClusterRequest.builder()- Parameters:
createDbClusterRequest- AConsumerthat will call methods onCreateDbClusterRequest.Builderto 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-DBSubnetGroupNamedoesn'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-DBClusterParameterGroupNamedoesn't refer to an existing DB cluster parameter group.KmsKeyNotAccessibleException- An error occurred accessing an Amazon Web Services KMS key.DbClusterNotFoundException-DBClusterIdentifierdoesn't refer to an existing DB cluster.DbInstanceNotFoundException-DBInstanceIdentifierdoesn'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- TheGlobalClusterIdentifierdoesn'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-Domaindoesn'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-DBClusterIdentifierdoesn't refer to an existing DB cluster.InvalidDbClusterStateException- The requested operation can't be performed while the cluster is in this state.DbInstanceNotFoundException-DBInstanceIdentifierdoesn'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.Builderavoiding the need to create one manually viaCreateDbClusterEndpointRequest.builder()- Parameters:
createDbClusterEndpointRequest- AConsumerthat will call methods onCreateDbClusterEndpointRequest.Builderto 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-DBClusterIdentifierdoesn't refer to an existing DB cluster.InvalidDbClusterStateException- The requested operation can't be performed while the cluster is in this state.DbInstanceNotFoundException-DBInstanceIdentifierdoesn'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_databaseparameter. You can use the Parameter Groups option of the Amazon RDS console or theDescribeDBClusterParametersoperation 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_databaseparameter. You can use the Parameter Groups option of the Amazon RDS console or theDescribeDBClusterParametersoperation 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.Builderavoiding the need to create one manually viaCreateDbClusterParameterGroupRequest.builder()- Parameters:
createDbClusterParameterGroupRequest- AConsumerthat will call methods onCreateDbClusterParameterGroupRequest.Builderto 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-DBClusterIdentifierdoesn'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.Builderavoiding the need to create one manually viaCreateDbClusterSnapshotRequest.builder()- Parameters:
createDbClusterSnapshotRequest- AConsumerthat will call methods onCreateDbClusterSnapshotRequest.Builderto 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-DBClusterIdentifierdoesn'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-DBParameterGroupNamedoesn't refer to an existing DB parameter group.DbSecurityGroupNotFoundException-DBSecurityGroupNamedoesn'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-DBSubnetGroupNamedoesn'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-DBClusterIdentifierdoesn't refer to an existing DB cluster.StorageTypeNotSupportedException- The specifiedStorageTypecan'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-Domaindoesn't refer to an existing Active Directory domain.NetworkTypeNotSupportedException- The network type is invalid for the DB instance. Valid nework type values areIPV4andDUAL.CertificateNotFoundException-CertificateIdentifierdoesn'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.Builderavoiding the need to create one manually viaCreateDbInstanceRequest.builder()- Parameters:
createDbInstanceRequest- AConsumerthat will call methods onCreateDbInstanceRequest.Builderto 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-DBParameterGroupNamedoesn't refer to an existing DB parameter group.DbSecurityGroupNotFoundException-DBSecurityGroupNamedoesn'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-DBSubnetGroupNamedoesn'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-DBClusterIdentifierdoesn't refer to an existing DB cluster.StorageTypeNotSupportedException- The specifiedStorageTypecan'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-Domaindoesn't refer to an existing Active Directory domain.NetworkTypeNotSupportedException- The network type is invalid for the DB instance. Valid nework type values areIPV4andDUAL.CertificateNotFoundException-CertificateIdentifierdoesn'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
CreateDBInstanceoperation.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-DBParameterGroupNamedoesn't refer to an existing DB parameter group.DbSecurityGroupNotFoundException-DBSecurityGroupNamedoesn'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-DBInstanceIdentifierdoesn't refer to an existing DB instance.DbClusterNotFoundException-DBClusterIdentifierdoesn'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-DBSubnetGroupNamedoesn'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 specifiedStorageTypecan't be associated with the DB instance.KmsKeyNotAccessibleException- An error occurred accessing an Amazon Web Services KMS key.DomainNotFoundException-Domaindoesn't refer to an existing Active Directory domain.NetworkTypeNotSupportedException- The network type is invalid for the DB instance. Valid nework type values areIPV4andDUAL.TenantDatabaseQuotaExceededException- You attempted to create more tenant databases than are permitted in your Amazon Web Services account.CertificateNotFoundException-CertificateIdentifierdoesn'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
CreateDBInstanceoperation.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.Builderavoiding the need to create one manually viaCreateDbInstanceReadReplicaRequest.builder()- Parameters:
createDbInstanceReadReplicaRequest- AConsumerthat will call methods onCreateDbInstanceReadReplicaRequest.Builderto 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-DBParameterGroupNamedoesn't refer to an existing DB parameter group.DbSecurityGroupNotFoundException-DBSecurityGroupNamedoesn'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-DBInstanceIdentifierdoesn't refer to an existing DB instance.DbClusterNotFoundException-DBClusterIdentifierdoesn'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-DBSubnetGroupNamedoesn'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 specifiedStorageTypecan't be associated with the DB instance.KmsKeyNotAccessibleException- An error occurred accessing an Amazon Web Services KMS key.DomainNotFoundException-Domaindoesn't refer to an existing Active Directory domain.NetworkTypeNotSupportedException- The network type is invalid for the DB instance. Valid nework type values areIPV4andDUAL.TenantDatabaseQuotaExceededException- You attempted to create more tenant databases than are permitted in your Amazon Web Services account.CertificateNotFoundException-CertificateIdentifierdoesn'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.
- 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.
This is a convenience which creates an instance of the
CreateDbParameterGroupRequest.Builderavoiding the need to create one manually viaCreateDbParameterGroupRequest.builder()- Parameters:
createDbParameterGroupRequest- AConsumerthat will call methods onCreateDbParameterGroupRequest.Builderto 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.Builderavoiding the need to create one manually viaCreateDbProxyRequest.builder()- Parameters:
createDbProxyRequest- AConsumerthat will call methods onCreateDbProxyRequest.Builderto 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.Builderavoiding the need to create one manually viaCreateDbProxyEndpointRequest.builder()- Parameters:
createDbProxyEndpointRequest- AConsumerthat will call methods onCreateDbProxyEndpointRequest.Builderto 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 inDBSecurityGroupNamealready 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.Builderavoiding the need to create one manually viaCreateDbSecurityGroupRequest.builder()- Parameters:
createDbSecurityGroupRequest- AConsumerthat will call methods onCreateDbSecurityGroupRequest.Builderto create a request.- Returns:
- Result of the CreateDBSecurityGroup operation returned by the service.
- Throws:
DbSecurityGroupAlreadyExistsException- A DB security group with the name specified inDBSecurityGroupNamealready 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-DBClusterIdentifierdoesn'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 areIPV4andDUAL.SdkException- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.SdkClientException- If any client side error occurs such as an IO related failure, failure to get credentials, etc.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.Builderavoiding the need to create one manually viaCreateDbShardGroupRequest.builder()- Parameters:
createDbShardGroupRequest- AConsumerthat will call methods onCreateDbShardGroupRequest.Builderto 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-DBClusterIdentifierdoesn'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 areIPV4andDUAL.SdkException- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.SdkClientException- If any client side error occurs such as an IO related failure, failure to get credentials, etc.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
availableorstorage-optimizationstate.- Parameters:
createDbSnapshotRequest-- Returns:
- Result of the CreateDBSnapshot operation returned by the service.
- Throws:
DbSnapshotAlreadyExistsException-DBSnapshotIdentifieris already used by an existing snapshot.InvalidDbInstanceStateException- The DB instance isn't in a valid state.DbInstanceNotFoundException-DBInstanceIdentifierdoesn'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
availableorstorage-optimizationstate.
This is a convenience which creates an instance of the
CreateDbSnapshotRequest.Builderavoiding the need to create one manually viaCreateDbSnapshotRequest.builder()- Parameters:
createDbSnapshotRequest- AConsumerthat will call methods onCreateDbSnapshotRequest.Builderto create a request.- Returns:
- Result of the CreateDBSnapshot operation returned by the service.
- Throws:
DbSnapshotAlreadyExistsException-DBSnapshotIdentifieris already used by an existing snapshot.InvalidDbInstanceStateException- The DB instance isn't in a valid state.DbInstanceNotFoundException-DBInstanceIdentifierdoesn'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-DBSubnetGroupNameis 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.Builderavoiding the need to create one manually viaCreateDbSubnetGroupRequest.builder()- Parameters:
createDbSubnetGroupRequest- AConsumerthat will call methods onCreateDbSubnetGroupRequest.Builderto create a request.- Returns:
- Result of the CreateDBSubnetGroup operation returned by the service.
- Throws:
DbSubnetGroupAlreadyExistsException-DBSubnetGroupNameis 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,mydbinstance2andEventCategories=Availability,Backup.If you specify both the
SourceTypeandSourceIds, such asSourceType=db-instanceandSourceIds=myDBInstance1, you are notified of all thedb-instanceevents for the specified source. If you specify aSourceTypebut 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,mydbinstance2andEventCategories=Availability,Backup.If you specify both the
SourceTypeandSourceIds, such asSourceType=db-instanceandSourceIds=myDBInstance1, you are notified of all thedb-instanceevents for the specified source. If you specify aSourceTypebut 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.Builderavoiding the need to create one manually viaCreateEventSubscriptionRequest.builder()- Parameters:
createEventSubscriptionRequest- AConsumerthat will call methods onCreateEventSubscriptionRequest.Builderto 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- TheGlobalClusterIdentifieralready 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-DBClusterIdentifierdoesn'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.Builderavoiding the need to create one manually viaCreateGlobalClusterRequest.builder()- Parameters:
createGlobalClusterRequest- AConsumerthat will call methods onCreateGlobalClusterRequest.Builderto create a request.- Returns:
- Result of the CreateGlobalCluster operation returned by the service.
- Throws:
GlobalClusterAlreadyExistsException- TheGlobalClusterIdentifieralready 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-DBClusterIdentifierdoesn'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-DBClusterIdentifierdoesn't refer to an existing DB cluster.DbInstanceNotFoundException-DBInstanceIdentifierdoesn'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.Builderavoiding the need to create one manually viaCreateIntegrationRequest.builder()- Parameters:
createIntegrationRequest- AConsumerthat will call methods onCreateIntegrationRequest.Builderto create a request.- Returns:
- Result of the CreateIntegration operation returned by the service.
- Throws:
DbClusterNotFoundException-DBClusterIdentifierdoesn't refer to an existing DB cluster.DbInstanceNotFoundException-DBInstanceIdentifierdoesn'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.Builderavoiding the need to create one manually viaCreateOptionGroupRequest.builder()- Parameters:
createOptionGroupRequest- AConsumerthat will call methods onCreateOptionGroupRequest.Builderto 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-DBInstanceIdentifierdoesn'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.Builderavoiding the need to create one manually viaCreateTenantDatabaseRequest.builder()- Parameters:
createTenantDatabaseRequest- AConsumerthat will call methods onCreateTenantDatabaseRequest.Builderto create a request.- Returns:
- Result of the CreateTenantDatabase operation returned by the service.
- Throws:
DbInstanceNotFoundException-DBInstanceIdentifierdoesn'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-BlueGreenDeploymentIdentifierdoesn'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.Builderavoiding the need to create one manually viaDeleteBlueGreenDeploymentRequest.builder()- Parameters:
deleteBlueGreenDeploymentRequest- AConsumerthat will call methods onDeleteBlueGreenDeploymentRequest.Builderto create a request.- Returns:
- Result of the DeleteBlueGreenDeployment operation returned by the service.
- Throws:
BlueGreenDeploymentNotFoundException-BlueGreenDeploymentIdentifierdoesn'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
DeleteCustomDbEngineVersionevent 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 theDeleteCustomDbEngineVersionevent.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
DeleteCustomDbEngineVersionevent 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 theDeleteCustomDbEngineVersionevent.For more information, see Deleting a CEV in the Amazon RDS User Guide.
This is a convenience which creates an instance of the
DeleteCustomDbEngineVersionRequest.Builderavoiding the need to create one manually viaDeleteCustomDbEngineVersionRequest.builder()- Parameters:
deleteCustomDbEngineVersionRequest- AConsumerthat will call methods onDeleteCustomDbEngineVersionRequest.Builderto 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-DBClusterIdentifierdoesn'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.Builderavoiding the need to create one manually viaDeleteDbClusterRequest.builder()- Parameters:
deleteDbClusterRequest- AConsumerthat will call methods onDeleteDbClusterRequest.Builderto create a request.- Returns:
- Result of the DeleteDBCluster operation returned by the service.
- Throws:
DbClusterNotFoundException-DBClusterIdentifierdoesn'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
DbClusterResourceIdvalue 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
DbClusterResourceIdvalue 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.Builderavoiding the need to create one manually viaDeleteDbClusterAutomatedBackupRequest.builder()- Parameters:
deleteDbClusterAutomatedBackupRequest- AConsumerthat will call methods onDeleteDbClusterAutomatedBackupRequest.Builderto 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.Builderavoiding the need to create one manually viaDeleteDbClusterEndpointRequest.builder()- Parameters:
deleteDbClusterEndpointRequest- AConsumerthat will call methods onDeleteDbClusterEndpointRequest.Builderto 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-DBParameterGroupNamedoesn'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.Builderavoiding the need to create one manually viaDeleteDbClusterParameterGroupRequest.builder()- Parameters:
deleteDbClusterParameterGroupRequest- AConsumerthat will call methods onDeleteDbClusterParameterGroupRequest.Builderto 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-DBParameterGroupNamedoesn'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
availablestate 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-DBClusterSnapshotIdentifierdoesn'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
availablestate 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.Builderavoiding the need to create one manually viaDeleteDbClusterSnapshotRequest.builder()- Parameters:
deleteDbClusterSnapshotRequest- AConsumerthat will call methods onDeleteDbClusterSnapshotRequest.Builderto 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-DBClusterSnapshotIdentifierdoesn'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
deletinguntil 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 theSkipFinalSnapshotparameter.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
PromoteReadReplicaDBClusteroperation to promote the DB cluster so that it's no longer a read replica. After the promotion completes, use theDeleteDBInstanceoperation 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-DBInstanceIdentifierdoesn't refer to an existing DB instance.InvalidDbInstanceStateException- The DB instance isn't in a valid state.DbSnapshotAlreadyExistsException-DBSnapshotIdentifieris 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
deletinguntil 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 theSkipFinalSnapshotparameter.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
PromoteReadReplicaDBClusteroperation to promote the DB cluster so that it's no longer a read replica. After the promotion completes, use theDeleteDBInstanceoperation 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.Builderavoiding the need to create one manually viaDeleteDbInstanceRequest.builder()- Parameters:
deleteDbInstanceRequest- AConsumerthat will call methods onDeleteDbInstanceRequest.Builderto create a request.- Returns:
- Result of the DeleteDBInstance operation returned by the service.
- Throws:
DbInstanceNotFoundException-DBInstanceIdentifierdoesn't refer to an existing DB instance.InvalidDbInstanceStateException- The DB instance isn't in a valid state.DbSnapshotAlreadyExistsException-DBSnapshotIdentifieris 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
DbiResourceIdvalue of the source DB instance or the Amazon Resource Name (ARN) of the automated backups.- Parameters:
deleteDbInstanceAutomatedBackupRequest- Parameter input for theDeleteDBInstanceAutomatedBackupoperation.- 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
DbiResourceIdvalue 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.Builderavoiding the need to create one manually viaDeleteDbInstanceAutomatedBackupRequest.builder()- Parameters:
deleteDbInstanceAutomatedBackupRequest- AConsumerthat will call methods onDeleteDbInstanceAutomatedBackupRequest.Builderto create a request. Parameter input for theDeleteDBInstanceAutomatedBackupoperation.- 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-DBParameterGroupNamedoesn'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.Builderavoiding the need to create one manually viaDeleteDbParameterGroupRequest.builder()- Parameters:
deleteDbParameterGroupRequest- AConsumerthat will call methods onDeleteDbParameterGroupRequest.Builderto 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-DBParameterGroupNamedoesn'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.Builderavoiding the need to create one manually viaDeleteDbProxyRequest.builder()- Parameters:
deleteDbProxyRequest- AConsumerthat will call methods onDeleteDbProxyRequest.Builderto 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.Builderavoiding the need to create one manually viaDeleteDbProxyEndpointRequest.builder()- Parameters:
deleteDbProxyEndpointRequest- AConsumerthat will call methods onDeleteDbProxyEndpointRequest.Builderto 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-DBSecurityGroupNamedoesn'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.Builderavoiding the need to create one manually viaDeleteDbSecurityGroupRequest.builder()- Parameters:
deleteDbSecurityGroupRequest- AConsumerthat will call methods onDeleteDbSecurityGroupRequest.Builderto 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-DBSecurityGroupNamedoesn'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.Builderavoiding the need to create one manually viaDeleteDbShardGroupRequest.builder()- Parameters:
deleteDbShardGroupRequest- AConsumerthat will call methods onDeleteDbShardGroupRequest.Builderto 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
availablestate 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-DBSnapshotIdentifierdoesn'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
availablestate to be deleted.
This is a convenience which creates an instance of the
DeleteDbSnapshotRequest.Builderavoiding the need to create one manually viaDeleteDbSnapshotRequest.builder()- Parameters:
deleteDbSnapshotRequest- AConsumerthat will call methods onDeleteDbSnapshotRequest.Builderto 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-DBSnapshotIdentifierdoesn'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-DBSubnetGroupNamedoesn'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.Builderavoiding the need to create one manually viaDeleteDbSubnetGroupRequest.builder()- Parameters:
deleteDbSubnetGroupRequest- AConsumerthat will call methods onDeleteDbSubnetGroupRequest.Builderto 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-DBSubnetGroupNamedoesn'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.Builderavoiding the need to create one manually viaDeleteEventSubscriptionRequest.builder()- Parameters:
deleteEventSubscriptionRequest- AConsumerthat will call methods onDeleteEventSubscriptionRequest.Builderto 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- TheGlobalClusterIdentifierdoesn'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.Builderavoiding the need to create one manually viaDeleteGlobalClusterRequest.builder()- Parameters:
deleteGlobalClusterRequest- AConsumerthat will call methods onDeleteGlobalClusterRequest.Builderto create a request.- Returns:
- Result of the DeleteGlobalCluster operation returned by the service.
- Throws:
GlobalClusterNotFoundException- TheGlobalClusterIdentifierdoesn'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.Builderavoiding the need to create one manually viaDeleteIntegrationRequest.builder()- Parameters:
deleteIntegrationRequest- AConsumerthat will call methods onDeleteIntegrationRequest.Builderto 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.Builderavoiding the need to create one manually viaDeleteOptionGroupRequest.builder()- Parameters:
deleteOptionGroupRequest- AConsumerthat will call methods onDeleteOptionGroupRequest.Builderto 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-DBInstanceIdentifierdoesn'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.Builderavoiding the need to create one manually viaDeleteTenantDatabaseRequest.builder()- Parameters:
deleteTenantDatabaseRequest- AConsumerthat will call methods onDeleteTenantDatabaseRequest.Builderto create a request.- Returns:
- Result of the DeleteTenantDatabase operation returned by the service.
- Throws:
DbInstanceNotFoundException-DBInstanceIdentifierdoesn'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
DBProxyTargetdata 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
DBProxyTargetdata structures and aDBProxyTargetGroup.
This is a convenience which creates an instance of the
DeregisterDbProxyTargetsRequest.Builderavoiding the need to create one manually viaDeregisterDbProxyTargetsRequest.builder()- Parameters:
deregisterDbProxyTargetsRequest- AConsumerthat will call methods onDeregisterDbProxyTargetsRequest.Builderto 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.Builderavoiding the need to create one manually viaDescribeAccountAttributesRequest.builder()- Parameters:
describeAccountAttributesRequest- AConsumerthat will call methods onDescribeAccountAttributesRequest.Builderto 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-BlueGreenDeploymentIdentifierdoesn'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.Builderavoiding the need to create one manually viaDescribeBlueGreenDeploymentsRequest.builder()- Parameters:
describeBlueGreenDeploymentsRequest- AConsumerthat will call methods onDescribeBlueGreenDeploymentsRequest.Builderto create a request.- Returns:
- Result of the DescribeBlueGreenDeployments operation returned by the service.
- Throws:
BlueGreenDeploymentNotFoundException-BlueGreenDeploymentIdentifierdoesn'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 Stream
2) Using For loopsoftware.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-BlueGreenDeploymentIdentifierdoesn'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 Stream
2) Using For loopsoftware.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.Builderavoiding the need to create one manually viaDescribeBlueGreenDeploymentsRequest.builder()- Parameters:
describeBlueGreenDeploymentsRequest- AConsumerthat will call methods onDescribeBlueGreenDeploymentsRequest.Builderto create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
BlueGreenDeploymentNotFoundException-BlueGreenDeploymentIdentifierdoesn'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-CertificateIdentifierdoesn'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.Builderavoiding the need to create one manually viaDescribeCertificatesRequest.builder()- Parameters:
describeCertificatesRequest- AConsumerthat will call methods onDescribeCertificatesRequest.Builderto create a request.- Returns:
- Result of the DescribeCertificates operation returned by the service.
- Throws:
CertificateNotFoundException-CertificateIdentifierdoesn'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-CertificateIdentifierdoesn'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 Stream
2) Using For loopsoftware.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-CertificateIdentifierdoesn'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 Stream
2) Using For loopsoftware.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-CertificateIdentifierdoesn'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 Stream
2) Using For loopsoftware.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.Builderavoiding the need to create one manually viaDescribeCertificatesRequest.builder()- Parameters:
describeCertificatesRequest- AConsumerthat will call methods onDescribeCertificatesRequest.Builderto create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
CertificateNotFoundException-CertificateIdentifierdoesn'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
DescribeDBClusterAutomatedBackupsandDescribeDBClustersoperations.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
DescribeDBClusterAutomatedBackupsandDescribeDBClustersoperations.All parameters are optional.
This is a convenience which creates an instance of the
DescribeDbClusterAutomatedBackupsRequest.Builderavoiding the need to create one manually viaDescribeDbClusterAutomatedBackupsRequest.builder()- Parameters:
describeDbClusterAutomatedBackupsRequest- AConsumerthat will call methods onDescribeDbClusterAutomatedBackupsRequest.Builderto 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 Stream
2) Using For loopsoftware.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 Stream
2) Using For loopsoftware.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.Builderavoiding the need to create one manually viaDescribeDbClusterAutomatedBackupsRequest.builder()- Parameters:
describeDbClusterAutomatedBackupsRequest- AConsumerthat will call methods onDescribeDbClusterAutomatedBackupsRequest.Builderto 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-DBClusterIdentifierdoesn't refer to an existing DB cluster.DbClusterBacktrackNotFoundException-BacktrackIdentifierdoesn'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.Builderavoiding the need to create one manually viaDescribeDbClusterBacktracksRequest.builder()- Parameters:
describeDbClusterBacktracksRequest- AConsumerthat will call methods onDescribeDbClusterBacktracksRequest.Builderto create a request.- Returns:
- Result of the DescribeDBClusterBacktracks operation returned by the service.
- Throws:
DbClusterNotFoundException-DBClusterIdentifierdoesn't refer to an existing DB cluster.DbClusterBacktrackNotFoundException-BacktrackIdentifierdoesn'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 Stream
2) Using For loopsoftware.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-DBClusterIdentifierdoesn't refer to an existing DB cluster.DbClusterBacktrackNotFoundException-BacktrackIdentifierdoesn'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 Stream
2) Using For loopsoftware.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.Builderavoiding the need to create one manually viaDescribeDbClusterBacktracksRequest.builder()- Parameters:
describeDbClusterBacktracksRequest- AConsumerthat will call methods onDescribeDbClusterBacktracksRequest.Builderto create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
DbClusterNotFoundException-DBClusterIdentifierdoesn't refer to an existing DB cluster.DbClusterBacktrackNotFoundException-BacktrackIdentifierdoesn'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-DBClusterIdentifierdoesn'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.Builderavoiding the need to create one manually viaDescribeDbClusterEndpointsRequest.builder()- Parameters:
describeDbClusterEndpointsRequest- AConsumerthat will call methods onDescribeDbClusterEndpointsRequest.Builderto create a request.- Returns:
- Result of the DescribeDBClusterEndpoints operation returned by the service.
- Throws:
DbClusterNotFoundException-DBClusterIdentifierdoesn'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-DBClusterIdentifierdoesn'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 Stream
2) Using For loopsoftware.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-DBClusterIdentifierdoesn'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 Stream
2) Using For loopsoftware.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-DBClusterIdentifierdoesn'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 Stream
2) Using For loopsoftware.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.Builderavoiding the need to create one manually viaDescribeDbClusterEndpointsRequest.builder()- Parameters:
describeDbClusterEndpointsRequest- AConsumerthat will call methods onDescribeDbClusterEndpointsRequest.Builderto create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
DbClusterNotFoundException-DBClusterIdentifierdoesn'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
DBClusterParameterGroupdescriptions. If aDBClusterParameterGroupNameparameter 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-DBParameterGroupNamedoesn'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
DBClusterParameterGroupdescriptions. If aDBClusterParameterGroupNameparameter 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.Builderavoiding the need to create one manually viaDescribeDbClusterParameterGroupsRequest.builder()- Parameters:
describeDbClusterParameterGroupsRequest- AConsumerthat will call methods onDescribeDbClusterParameterGroupsRequest.Builderto create a request.- Returns:
- Result of the DescribeDBClusterParameterGroups operation returned by the service.
- Throws:
DbParameterGroupNotFoundException-DBParameterGroupNamedoesn'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
DBClusterParameterGroupdescriptions. If aDBClusterParameterGroupNameparameter 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-DBParameterGroupNamedoesn'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 Stream
2) Using For loopsoftware.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-DBParameterGroupNamedoesn'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 Stream
2) Using For loopsoftware.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-DBParameterGroupNamedoesn'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 Stream
2) Using For loopsoftware.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.Builderavoiding the need to create one manually viaDescribeDbClusterParameterGroupsRequest.builder()- Parameters:
describeDbClusterParameterGroupsRequest- AConsumerthat will call methods onDescribeDbClusterParameterGroupsRequest.Builderto create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
DbParameterGroupNotFoundException-DBParameterGroupNamedoesn'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-DBParameterGroupNamedoesn'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.Builderavoiding the need to create one manually viaDescribeDbClusterParametersRequest.builder()- Parameters:
describeDbClusterParametersRequest- AConsumerthat will call methods onDescribeDbClusterParametersRequest.Builderto create a request.- Returns:
- Result of the DescribeDBClusterParameters operation returned by the service.
- Throws:
DbParameterGroupNotFoundException-DBParameterGroupNamedoesn'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 Stream
2) Using For loopsoftware.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-DBParameterGroupNamedoesn'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 Stream
2) Using For loopsoftware.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.Builderavoiding the need to create one manually viaDescribeDbClusterParametersRequest.builder()- Parameters:
describeDbClusterParametersRequest- AConsumerthat will call methods onDescribeDbClusterParametersRequest.Builderto create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
DbParameterGroupNotFoundException-DBParameterGroupNamedoesn'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,
DescribeDBClusterSnapshotAttributesreturns therestoreattribute and a list of IDs for the Amazon Web Services accounts that are authorized to copy or restore the manual DB cluster snapshot. Ifallis included in the list of values for therestoreattribute, 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
ModifyDBClusterSnapshotAttributeAPI action.- Parameters:
describeDbClusterSnapshotAttributesRequest-- Returns:
- Result of the DescribeDBClusterSnapshotAttributes operation returned by the service.
- Throws:
DbClusterSnapshotNotFoundException-DBClusterSnapshotIdentifierdoesn'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,
DescribeDBClusterSnapshotAttributesreturns therestoreattribute and a list of IDs for the Amazon Web Services accounts that are authorized to copy or restore the manual DB cluster snapshot. Ifallis included in the list of values for therestoreattribute, 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
ModifyDBClusterSnapshotAttributeAPI action.
This is a convenience which creates an instance of the
DescribeDbClusterSnapshotAttributesRequest.Builderavoiding the need to create one manually viaDescribeDbClusterSnapshotAttributesRequest.builder()- Parameters:
describeDbClusterSnapshotAttributesRequest- AConsumerthat will call methods onDescribeDbClusterSnapshotAttributesRequest.Builderto create a request.- Returns:
- Result of the DescribeDBClusterSnapshotAttributes operation returned by the service.
- Throws:
DbClusterSnapshotNotFoundException-DBClusterSnapshotIdentifierdoesn'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-DBClusterSnapshotIdentifierdoesn'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.Builderavoiding the need to create one manually viaDescribeDbClusterSnapshotsRequest.builder()- Parameters:
describeDbClusterSnapshotsRequest- AConsumerthat will call methods onDescribeDbClusterSnapshotsRequest.Builderto create a request.- Returns:
- Result of the DescribeDBClusterSnapshots operation returned by the service.
- Throws:
DbClusterSnapshotNotFoundException-DBClusterSnapshotIdentifierdoesn'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-DBClusterSnapshotIdentifierdoesn'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 Stream
2) Using For loopsoftware.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-DBClusterSnapshotIdentifierdoesn'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 Stream
2) Using For loopsoftware.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-DBClusterSnapshotIdentifierdoesn'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 Stream
2) Using For loopsoftware.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.Builderavoiding the need to create one manually viaDescribeDbClusterSnapshotsRequest.builder()- Parameters:
describeDbClusterSnapshotsRequest- AConsumerthat will call methods onDescribeDbClusterSnapshotsRequest.Builderto create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
DbClusterSnapshotNotFoundException-DBClusterSnapshotIdentifierdoesn'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-DBClusterIdentifierdoesn'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.Builderavoiding the need to create one manually viaDescribeDbClustersRequest.builder()- Parameters:
describeDbClustersRequest- AConsumerthat will call methods onDescribeDbClustersRequest.Builderto create a request.- Returns:
- Result of the DescribeDBClusters operation returned by the service.
- Throws:
DbClusterNotFoundException-DBClusterIdentifierdoesn'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-DBClusterIdentifierdoesn'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 Stream
2) Using For loopsoftware.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-DBClusterIdentifierdoesn'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 Stream
2) Using For loopsoftware.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-DBClusterIdentifierdoesn'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 Stream
2) Using For loopsoftware.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.Builderavoiding the need to create one manually viaDescribeDbClustersRequest.builder()- Parameters:
describeDbClustersRequest- AConsumerthat will call methods onDescribeDbClustersRequest.Builderto create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
DbClusterNotFoundException-DBClusterIdentifierdoesn'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.Builderavoiding the need to create one manually viaDescribeDbEngineVersionsRequest.builder()- Parameters:
describeDbEngineVersionsRequest- AConsumerthat will call methods onDescribeDbEngineVersionsRequest.Builderto 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 Stream
2) Using For loopsoftware.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 Stream
2) Using For loopsoftware.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 Stream
2) Using For loopsoftware.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.Builderavoiding the need to create one manually viaDescribeDbEngineVersionsRequest.builder()- Parameters:
describeDbEngineVersionsRequest- AConsumerthat will call methods onDescribeDbEngineVersionsRequest.Builderto 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
DescribeDBInstanceAutomatedBackupsandDescribeDBInstancesoperations.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
DescribeDBInstanceAutomatedBackupsandDescribeDBInstancesoperations.All parameters are optional.
This is a convenience which creates an instance of the
DescribeDbInstanceAutomatedBackupsRequest.Builderavoiding the need to create one manually viaDescribeDbInstanceAutomatedBackupsRequest.builder()- Parameters:
describeDbInstanceAutomatedBackupsRequest- AConsumerthat will call methods onDescribeDbInstanceAutomatedBackupsRequest.Builderto 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
DescribeDBInstanceAutomatedBackupsandDescribeDBInstancesoperations.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 Stream
2) Using For loopsoftware.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 Stream
2) Using For loopsoftware.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 Stream
2) Using For loopsoftware.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.Builderavoiding the need to create one manually viaDescribeDbInstanceAutomatedBackupsRequest.builder()- Parameters:
describeDbInstanceAutomatedBackupsRequest- AConsumerthat will call methods onDescribeDbInstanceAutomatedBackupsRequest.Builderto 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-DBInstanceIdentifierdoesn'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.Builderavoiding the need to create one manually viaDescribeDbInstancesRequest.builder()- Parameters:
describeDbInstancesRequest- AConsumerthat will call methods onDescribeDbInstancesRequest.Builderto create a request.- Returns:
- Result of the DescribeDBInstances operation returned by the service.
- Throws:
DbInstanceNotFoundException-DBInstanceIdentifierdoesn'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-DBInstanceIdentifierdoesn'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 Stream
2) Using For loopsoftware.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-DBInstanceIdentifierdoesn'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 Stream
2) Using For loopsoftware.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-DBInstanceIdentifierdoesn'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 Stream
2) Using For loopsoftware.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.Builderavoiding the need to create one manually viaDescribeDbInstancesRequest.builder()- Parameters:
describeDbInstancesRequest- AConsumerthat will call methods onDescribeDbInstancesRequest.Builderto create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
DbInstanceNotFoundException-DBInstanceIdentifierdoesn'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, DbInstanceNotReadyException, 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-DBInstanceIdentifierdoesn't refer to an existing DB instance.DbInstanceNotReadyException- An attempt to download or examine log files didn't succeed because an Aurora Serverless v2 instance was paused.SdkException- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.SdkClientException- If any client side error occurs such as an IO related failure, failure to get credentials, etc.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, DbInstanceNotReadyException, 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.Builderavoiding the need to create one manually viaDescribeDbLogFilesRequest.builder()- Parameters:
describeDbLogFilesRequest- AConsumerthat will call methods onDescribeDbLogFilesRequest.Builderto create a request.- Returns:
- Result of the DescribeDBLogFiles operation returned by the service.
- Throws:
DbInstanceNotFoundException-DBInstanceIdentifierdoesn't refer to an existing DB instance.DbInstanceNotReadyException- An attempt to download or examine log files didn't succeed because an Aurora Serverless v2 instance was paused.SdkException- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.SdkClientException- If any client side error occurs such as an IO related failure, failure to get credentials, etc.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, DbInstanceNotReadyException, 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 Stream
2) Using For loopsoftware.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-DBInstanceIdentifierdoesn't refer to an existing DB instance.DbInstanceNotReadyException- An attempt to download or examine log files didn't succeed because an Aurora Serverless v2 instance was paused.SdkException- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.SdkClientException- If any client side error occurs such as an IO related failure, failure to get credentials, etc.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, DbInstanceNotReadyException, 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 Stream
2) Using For loopsoftware.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.Builderavoiding the need to create one manually viaDescribeDbLogFilesRequest.builder()- Parameters:
describeDbLogFilesRequest- AConsumerthat will call methods onDescribeDbLogFilesRequest.Builderto create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
DbInstanceNotFoundException-DBInstanceIdentifierdoesn't refer to an existing DB instance.DbInstanceNotReadyException- An attempt to download or examine log files didn't succeed because an Aurora Serverless v2 instance was paused.SdkException- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.SdkClientException- If any client side error occurs such as an IO related failure, failure to get credentials, etc.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
DBParameterGroupdescriptions. If aDBParameterGroupNameis 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-DBParameterGroupNamedoesn'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
DBParameterGroupdescriptions. If aDBParameterGroupNameis 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.Builderavoiding the need to create one manually viaDescribeDbParameterGroupsRequest.builder()- Parameters:
describeDbParameterGroupsRequest- AConsumerthat will call methods onDescribeDbParameterGroupsRequest.Builderto create a request.- Returns:
- Result of the DescribeDBParameterGroups operation returned by the service.
- Throws:
DbParameterGroupNotFoundException-DBParameterGroupNamedoesn'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
DBParameterGroupdescriptions. If aDBParameterGroupNameis 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-DBParameterGroupNamedoesn'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 Stream
2) Using For loopsoftware.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-DBParameterGroupNamedoesn'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 Stream
2) Using For loopsoftware.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-DBParameterGroupNamedoesn'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 Stream
2) Using For loopsoftware.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.Builderavoiding the need to create one manually viaDescribeDbParameterGroupsRequest.builder()- Parameters:
describeDbParameterGroupsRequest- AConsumerthat will call methods onDescribeDbParameterGroupsRequest.Builderto create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
DbParameterGroupNotFoundException-DBParameterGroupNamedoesn'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-DBParameterGroupNamedoesn'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.Builderavoiding the need to create one manually viaDescribeDbParametersRequest.builder()- Parameters:
describeDbParametersRequest- AConsumerthat will call methods onDescribeDbParametersRequest.Builderto create a request.- Returns:
- Result of the DescribeDBParameters operation returned by the service.
- Throws:
DbParameterGroupNotFoundException-DBParameterGroupNamedoesn'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 Stream
2) Using For loopsoftware.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-DBParameterGroupNamedoesn'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 Stream
2) Using For loopsoftware.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.Builderavoiding the need to create one manually viaDescribeDbParametersRequest.builder()- Parameters:
describeDbParametersRequest- AConsumerthat will call methods onDescribeDbParametersRequest.Builderto create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
DbParameterGroupNotFoundException-DBParameterGroupNamedoesn'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.Builderavoiding the need to create one manually viaDescribeDbProxiesRequest.builder()- Parameters:
describeDbProxiesRequest- AConsumerthat will call methods onDescribeDbProxiesRequest.Builderto 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 Stream
2) Using For loopsoftware.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 Stream
2) Using For loopsoftware.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.Builderavoiding the need to create one manually viaDescribeDbProxiesRequest.builder()- Parameters:
describeDbProxiesRequest- AConsumerthat will call methods onDescribeDbProxiesRequest.Builderto 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.Builderavoiding the need to create one manually viaDescribeDbProxyEndpointsRequest.builder()- Parameters:
describeDbProxyEndpointsRequest- AConsumerthat will call methods onDescribeDbProxyEndpointsRequest.Builderto 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 Stream
2) Using For loopsoftware.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 Stream
2) Using For loopsoftware.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.Builderavoiding the need to create one manually viaDescribeDbProxyEndpointsRequest.builder()- Parameters:
describeDbProxyEndpointsRequest- AConsumerthat will call methods onDescribeDbProxyEndpointsRequest.Builderto 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
DBProxyTargetGroupdata 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
DBProxyTargetGroupdata structures.
This is a convenience which creates an instance of the
DescribeDbProxyTargetGroupsRequest.Builderavoiding the need to create one manually viaDescribeDbProxyTargetGroupsRequest.builder()- Parameters:
describeDbProxyTargetGroupsRequest- AConsumerthat will call methods onDescribeDbProxyTargetGroupsRequest.Builderto 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 Stream
2) Using For loopsoftware.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 Stream
2) Using For loopsoftware.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.Builderavoiding the need to create one manually viaDescribeDbProxyTargetGroupsRequest.builder()- Parameters:
describeDbProxyTargetGroupsRequest- AConsumerthat will call methods onDescribeDbProxyTargetGroupsRequest.Builderto 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
DBProxyTargetobjects. 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
DBProxyTargetobjects. This API supports pagination.
This is a convenience which creates an instance of the
DescribeDbProxyTargetsRequest.Builderavoiding the need to create one manually viaDescribeDbProxyTargetsRequest.builder()- Parameters:
describeDbProxyTargetsRequest- AConsumerthat will call methods onDescribeDbProxyTargetsRequest.Builderto 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 Stream
2) Using For loopsoftware.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 Stream
2) Using For loopsoftware.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.Builderavoiding the need to create one manually viaDescribeDbProxyTargetsRequest.builder()- Parameters:
describeDbProxyTargetsRequest- AConsumerthat will call methods onDescribeDbProxyTargetsRequest.Builderto 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.Builderavoiding the need to create one manually viaDescribeDbRecommendationsRequest.builder()- Parameters:
describeDbRecommendationsRequest- AConsumerthat will call methods onDescribeDbRecommendationsRequest.Builderto 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 Stream
2) Using For loopsoftware.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 Stream
2) Using For loopsoftware.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.Builderavoiding the need to create one manually viaDescribeDbRecommendationsRequest.builder()- Parameters:
describeDbRecommendationsRequest- AConsumerthat will call methods onDescribeDbRecommendationsRequest.Builderto 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
DBSecurityGroupdescriptions. If aDBSecurityGroupNameis 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-DBSecurityGroupNamedoesn'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
DBSecurityGroupdescriptions. If aDBSecurityGroupNameis 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.Builderavoiding the need to create one manually viaDescribeDbSecurityGroupsRequest.builder()- Parameters:
describeDbSecurityGroupsRequest- AConsumerthat will call methods onDescribeDbSecurityGroupsRequest.Builderto create a request.- Returns:
- Result of the DescribeDBSecurityGroups operation returned by the service.
- Throws:
DbSecurityGroupNotFoundException-DBSecurityGroupNamedoesn'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
DBSecurityGroupdescriptions. If aDBSecurityGroupNameis 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-DBSecurityGroupNamedoesn'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 Stream
2) Using For loopsoftware.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-DBSecurityGroupNamedoesn'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 Stream
2) Using For loopsoftware.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-DBSecurityGroupNamedoesn'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 Stream
2) Using For loopsoftware.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.Builderavoiding the need to create one manually viaDescribeDbSecurityGroupsRequest.builder()- Parameters:
describeDbSecurityGroupsRequest- AConsumerthat will call methods onDescribeDbSecurityGroupsRequest.Builderto create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
DbSecurityGroupNotFoundException-DBSecurityGroupNamedoesn'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-DBClusterIdentifierdoesn'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.Builderavoiding the need to create one manually viaDescribeDbShardGroupsRequest.builder()- Parameters:
describeDbShardGroupsRequest- AConsumerthat will call methods onDescribeDbShardGroupsRequest.Builderto 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-DBClusterIdentifierdoesn'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,
DescribeDBSnapshotAttributesreturns therestoreattribute and a list of IDs for the Amazon Web Services accounts that are authorized to copy or restore the manual DB snapshot. Ifallis included in the list of values for therestoreattribute, 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
ModifyDBSnapshotAttributeAPI action.- Parameters:
describeDbSnapshotAttributesRequest-- Returns:
- Result of the DescribeDBSnapshotAttributes operation returned by the service.
- Throws:
DbSnapshotNotFoundException-DBSnapshotIdentifierdoesn'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,
DescribeDBSnapshotAttributesreturns therestoreattribute and a list of IDs for the Amazon Web Services accounts that are authorized to copy or restore the manual DB snapshot. Ifallis included in the list of values for therestoreattribute, 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
ModifyDBSnapshotAttributeAPI action.
This is a convenience which creates an instance of the
DescribeDbSnapshotAttributesRequest.Builderavoiding the need to create one manually viaDescribeDbSnapshotAttributesRequest.builder()- Parameters:
describeDbSnapshotAttributesRequest- AConsumerthat will call methods onDescribeDbSnapshotAttributesRequest.Builderto create a request.- Returns:
- Result of the DescribeDBSnapshotAttributes operation returned by the service.
- Throws:
DbSnapshotNotFoundException-DBSnapshotIdentifierdoesn'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-DBSnapshotIdentifierdoesn'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.Builderavoiding the need to create one manually viaDescribeDbSnapshotTenantDatabasesRequest.builder()- Parameters:
describeDbSnapshotTenantDatabasesRequest- AConsumerthat will call methods onDescribeDbSnapshotTenantDatabasesRequest.Builderto create a request.- Returns:
- Result of the DescribeDBSnapshotTenantDatabases operation returned by the service.
- Throws:
DbSnapshotNotFoundException-DBSnapshotIdentifierdoesn'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 Stream
2) Using For loopsoftware.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-DBSnapshotIdentifierdoesn'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 Stream
2) Using For loopsoftware.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.Builderavoiding the need to create one manually viaDescribeDbSnapshotTenantDatabasesRequest.builder()- Parameters:
describeDbSnapshotTenantDatabasesRequest- AConsumerthat will call methods onDescribeDbSnapshotTenantDatabasesRequest.Builderto create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
DbSnapshotNotFoundException-DBSnapshotIdentifierdoesn'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-DBSnapshotIdentifierdoesn'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.Builderavoiding the need to create one manually viaDescribeDbSnapshotsRequest.builder()- Parameters:
describeDbSnapshotsRequest- AConsumerthat will call methods onDescribeDbSnapshotsRequest.Builderto create a request.- Returns:
- Result of the DescribeDBSnapshots operation returned by the service.
- Throws:
DbSnapshotNotFoundException-DBSnapshotIdentifierdoesn'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-DBSnapshotIdentifierdoesn'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 Stream
2) Using For loopsoftware.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-DBSnapshotIdentifierdoesn'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 Stream
2) Using For loopsoftware.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-DBSnapshotIdentifierdoesn'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 Stream
2) Using For loopsoftware.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.Builderavoiding the need to create one manually viaDescribeDbSnapshotsRequest.builder()- Parameters:
describeDbSnapshotsRequest- AConsumerthat will call methods onDescribeDbSnapshotsRequest.Builderto create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
DbSnapshotNotFoundException-DBSnapshotIdentifierdoesn'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-DBSubnetGroupNamedoesn'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.Builderavoiding the need to create one manually viaDescribeDbSubnetGroupsRequest.builder()- Parameters:
describeDbSubnetGroupsRequest- AConsumerthat will call methods onDescribeDbSubnetGroupsRequest.Builderto create a request.- Returns:
- Result of the DescribeDBSubnetGroups operation returned by the service.
- Throws:
DbSubnetGroupNotFoundException-DBSubnetGroupNamedoesn'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-DBSubnetGroupNamedoesn'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 Stream
2) Using For loopsoftware.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-DBSubnetGroupNamedoesn'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 Stream
2) Using For loopsoftware.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-DBSubnetGroupNamedoesn'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 Stream
2) Using For loopsoftware.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.Builderavoiding the need to create one manually viaDescribeDbSubnetGroupsRequest.builder()- Parameters:
describeDbSubnetGroupsRequest- AConsumerthat will call methods onDescribeDbSubnetGroupsRequest.Builderto create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
DbSubnetGroupNotFoundException-DBSubnetGroupNamedoesn'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.Builderavoiding the need to create one manually viaDescribeEngineDefaultClusterParametersRequest.builder()- Parameters:
describeEngineDefaultClusterParametersRequest- AConsumerthat will call methods onDescribeEngineDefaultClusterParametersRequest.Builderto 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.Builderavoiding the need to create one manually viaDescribeEngineDefaultParametersRequest.builder()- Parameters:
describeEngineDefaultParametersRequest- AConsumerthat will call methods onDescribeEngineDefaultParametersRequest.Builderto 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 Stream
2) Using For loopsoftware.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 Stream
2) Using For loopsoftware.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.Builderavoiding the need to create one manually viaDescribeEngineDefaultParametersRequest.builder()- Parameters:
describeEngineDefaultParametersRequest- AConsumerthat will call methods onDescribeEngineDefaultParametersRequest.Builderto 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.Builderavoiding the need to create one manually viaDescribeEventCategoriesRequest.builder()- Parameters:
describeEventCategoriesRequest- AConsumerthat will call methods onDescribeEventCategoriesRequest.Builderto 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.Builderavoiding the need to create one manually viaDescribeEventSubscriptionsRequest.builder()- Parameters:
describeEventSubscriptionsRequest- AConsumerthat will call methods onDescribeEventSubscriptionsRequest.Builderto 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 Stream
2) Using For loopsoftware.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 Stream
2) Using For loopsoftware.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 Stream
2) Using For loopsoftware.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.Builderavoiding the need to create one manually viaDescribeEventSubscriptionsRequest.builder()- Parameters:
describeEventSubscriptionsRequest- AConsumerthat will call methods onDescribeEventSubscriptionsRequest.Builderto 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.Builderavoiding the need to create one manually viaDescribeEventsRequest.builder()- Parameters:
describeEventsRequest- AConsumerthat will call methods onDescribeEventsRequest.Builderto 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 Stream
2) Using For loopsoftware.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 Stream
2) Using For loopsoftware.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 Stream
2) Using For loopsoftware.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.Builderavoiding the need to create one manually viaDescribeEventsRequest.builder()- Parameters:
describeEventsRequest- AConsumerthat will call methods onDescribeEventsRequest.Builderto 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.Builderavoiding the need to create one manually viaDescribeExportTasksRequest.builder()- Parameters:
describeExportTasksRequest- AConsumerthat will call methods onDescribeExportTasksRequest.Builderto 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 Stream
2) Using For loopsoftware.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 Stream
2) Using For loopsoftware.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.Builderavoiding the need to create one manually viaDescribeExportTasksRequest.builder()- Parameters:
describeExportTasksRequest- AConsumerthat will call methods onDescribeExportTasksRequest.Builderto 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- TheGlobalClusterIdentifierdoesn'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.Builderavoiding the need to create one manually viaDescribeGlobalClustersRequest.builder()- Parameters:
describeGlobalClustersRequest- AConsumerthat will call methods onDescribeGlobalClustersRequest.Builderto create a request.- Returns:
- Result of the DescribeGlobalClusters operation returned by the service.
- Throws:
GlobalClusterNotFoundException- TheGlobalClusterIdentifierdoesn'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- TheGlobalClusterIdentifierdoesn'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 Stream
2) Using For loopsoftware.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- TheGlobalClusterIdentifierdoesn'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 Stream
2) Using For loopsoftware.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- TheGlobalClusterIdentifierdoesn'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 Stream
2) Using For loopsoftware.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.Builderavoiding the need to create one manually viaDescribeGlobalClustersRequest.builder()- Parameters:
describeGlobalClustersRequest- AConsumerthat will call methods onDescribeGlobalClustersRequest.Builderto create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
GlobalClusterNotFoundException- TheGlobalClusterIdentifierdoesn'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.Builderavoiding the need to create one manually viaDescribeIntegrationsRequest.builder()- Parameters:
describeIntegrationsRequest- AConsumerthat will call methods onDescribeIntegrationsRequest.Builderto 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 Stream
2) Using For loopsoftware.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 Stream
2) Using For loopsoftware.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.Builderavoiding the need to create one manually viaDescribeIntegrationsRequest.builder()- Parameters:
describeIntegrationsRequest- AConsumerthat will call methods onDescribeIntegrationsRequest.Builderto 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.Builderavoiding the need to create one manually viaDescribeOptionGroupOptionsRequest.builder()- Parameters:
describeOptionGroupOptionsRequest- AConsumerthat will call methods onDescribeOptionGroupOptionsRequest.Builderto 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 Stream
2) Using For loopsoftware.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 Stream
2) Using For loopsoftware.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.Builderavoiding the need to create one manually viaDescribeOptionGroupOptionsRequest.builder()- Parameters:
describeOptionGroupOptionsRequest- AConsumerthat will call methods onDescribeOptionGroupOptionsRequest.Builderto 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.Builderavoiding the need to create one manually viaDescribeOptionGroupsRequest.builder()- Parameters:
describeOptionGroupsRequest- AConsumerthat will call methods onDescribeOptionGroupsRequest.Builderto 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 Stream
2) Using For loopsoftware.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 Stream
2) Using For loopsoftware.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 Stream
2) Using For loopsoftware.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.Builderavoiding the need to create one manually viaDescribeOptionGroupsRequest.builder()- Parameters:
describeOptionGroupsRequest- AConsumerthat will call methods onDescribeOptionGroupsRequest.Builderto 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.Builderavoiding the need to create one manually viaDescribeOrderableDbInstanceOptionsRequest.builder()- Parameters:
describeOrderableDbInstanceOptionsRequest- AConsumerthat will call methods onDescribeOrderableDbInstanceOptionsRequest.Builderto 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 Stream
2) Using For loopsoftware.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 Stream
2) Using For loopsoftware.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.Builderavoiding the need to create one manually viaDescribeOrderableDbInstanceOptionsRequest.builder()- Parameters:
describeOrderableDbInstanceOptionsRequest- AConsumerthat will call methods onDescribeOrderableDbInstanceOptionsRequest.Builderto 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
DescribePendingMaintenanceActionscommand might not be immediately visible to all subsequent RDS commands. Keep this in mind when you useDescribePendingMaintenanceActionsimmediately 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
DescribePendingMaintenanceActionscommand might not be immediately visible to all subsequent RDS commands. Keep this in mind when you useDescribePendingMaintenanceActionsimmediately after using a previous API command such asApplyPendingMaintenanceActions.
This is a convenience which creates an instance of the
DescribePendingMaintenanceActionsRequest.Builderavoiding the need to create one manually viaDescribePendingMaintenanceActionsRequest.builder()- Parameters:
describePendingMaintenanceActionsRequest- AConsumerthat will call methods onDescribePendingMaintenanceActionsRequest.Builderto 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
DescribePendingMaintenanceActionscommand might not be immediately visible to all subsequent RDS commands. Keep this in mind when you useDescribePendingMaintenanceActionsimmediately 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 Stream
2) Using For loopsoftware.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 Stream
2) Using For loopsoftware.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 Stream
2) Using For loopsoftware.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.Builderavoiding the need to create one manually viaDescribePendingMaintenanceActionsRequest.builder()- Parameters:
describePendingMaintenanceActionsRequest- AConsumerthat will call methods onDescribePendingMaintenanceActionsRequest.Builderto 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.Builderavoiding the need to create one manually viaDescribeReservedDbInstancesRequest.builder()- Parameters:
describeReservedDbInstancesRequest- AConsumerthat will call methods onDescribeReservedDbInstancesRequest.Builderto 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 Stream
2) Using For loopsoftware.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 Stream
2) Using For loopsoftware.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 Stream
2) Using For loopsoftware.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.Builderavoiding the need to create one manually viaDescribeReservedDbInstancesRequest.builder()- Parameters:
describeReservedDbInstancesRequest- AConsumerthat will call methods onDescribeReservedDbInstancesRequest.Builderto 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.Builderavoiding the need to create one manually viaDescribeReservedDbInstancesOfferingsRequest.builder()- Parameters:
describeReservedDbInstancesOfferingsRequest- AConsumerthat will call methods onDescribeReservedDbInstancesOfferingsRequest.Builderto 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 Stream
2) Using For loopsoftware.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 Stream
2) Using For loopsoftware.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 Stream
2) Using For loopsoftware.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.Builderavoiding the need to create one manually viaDescribeReservedDbInstancesOfferingsRequest.builder()- Parameters:
describeReservedDbInstancesOfferingsRequest- AConsumerthat will call methods onDescribeReservedDbInstancesOfferingsRequest.Builderto 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.Builderavoiding the need to create one manually viaDescribeSourceRegionsRequest.builder()- Parameters:
describeSourceRegionsRequest- AConsumerthat will call methods onDescribeSourceRegionsRequest.Builderto 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 Stream
2) Using For loopsoftware.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 Stream
2) Using For loopsoftware.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 Stream
2) Using For loopsoftware.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.Builderavoiding the need to create one manually viaDescribeSourceRegionsRequest.builder()- Parameters:
describeSourceRegionsRequest- AConsumerthat will call methods onDescribeSourceRegionsRequest.Builderto 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-DBInstanceIdentifierdoesn'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.Builderavoiding the need to create one manually viaDescribeTenantDatabasesRequest.builder()- Parameters:
describeTenantDatabasesRequest- AConsumerthat will call methods onDescribeTenantDatabasesRequest.Builderto create a request.- Returns:
- Result of the DescribeTenantDatabases operation returned by the service.
- Throws:
DbInstanceNotFoundException-DBInstanceIdentifierdoesn'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 Stream
2) Using For loopsoftware.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-DBInstanceIdentifierdoesn'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 Stream
2) Using For loopsoftware.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.Builderavoiding the need to create one manually viaDescribeTenantDatabasesRequest.builder()- Parameters:
describeTenantDatabasesRequest- AConsumerthat will call methods onDescribeTenantDatabasesRequest.Builderto create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
DbInstanceNotFoundException-DBInstanceIdentifierdoesn'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
DescribeValidDBInstanceModificationsto 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-DBInstanceIdentifierdoesn'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
DescribeValidDBInstanceModificationsto 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.Builderavoiding the need to create one manually viaDescribeValidDbInstanceModificationsRequest.builder()- Parameters:
describeValidDbInstanceModificationsRequest- AConsumerthat will call methods onDescribeValidDbInstanceModificationsRequest.Builderto create a request.- Returns:
- Result of the DescribeValidDBInstanceModifications operation returned by the service.
- Throws:
DbInstanceNotFoundException-DBInstanceIdentifierdoesn'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 Serverless v2 and provisioned DB clusters. To disable the HTTP endpoint for Aurora Serverless v1 DB clusters, use the
EnableHttpEndpointparameter of theModifyDBClusteroperation.- 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 Serverless v2 and provisioned DB clusters. To disable the HTTP endpoint for Aurora Serverless v1 DB clusters, use the
EnableHttpEndpointparameter of theModifyDBClusteroperation.
This is a convenience which creates an instance of the
DisableHttpEndpointRequest.Builderavoiding the need to create one manually viaDisableHttpEndpointRequest.builder()- Parameters:
disableHttpEndpointRequest- AConsumerthat will call methods onDisableHttpEndpointRequest.Builderto 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, DbInstanceNotReadyException, 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-DBInstanceIdentifierdoesn't refer to an existing DB instance.DbInstanceNotReadyException- An attempt to download or examine log files didn't succeed because an Aurora Serverless v2 instance was paused.DbLogFileNotFoundException-LogFileNamedoesn'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, DbInstanceNotReadyException, 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.Builderavoiding the need to create one manually viaDownloadDbLogFilePortionRequest.builder()- Parameters:
downloadDbLogFilePortionRequest- AConsumerthat will call methods onDownloadDbLogFilePortionRequest.Builderto create a request.- Returns:
- Result of the DownloadDBLogFilePortion operation returned by the service.
- Throws:
DbInstanceNotFoundException-DBInstanceIdentifierdoesn't refer to an existing DB instance.DbInstanceNotReadyException- An attempt to download or examine log files didn't succeed because an Aurora Serverless v2 instance was paused.DbLogFileNotFoundException-LogFileNamedoesn'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, DbInstanceNotReadyException, 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 Stream
2) Using For loopsoftware.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-DBInstanceIdentifierdoesn't refer to an existing DB instance.DbInstanceNotReadyException- An attempt to download or examine log files didn't succeed because an Aurora Serverless v2 instance was paused.DbLogFileNotFoundException-LogFileNamedoesn'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, DbInstanceNotReadyException, 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 Stream
2) Using For loopsoftware.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.Builderavoiding the need to create one manually viaDownloadDbLogFilePortionRequest.builder()- Parameters:
downloadDbLogFilePortionRequest- AConsumerthat will call methods onDownloadDbLogFilePortionRequest.Builderto create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
DbInstanceNotFoundException-DBInstanceIdentifierdoesn't refer to an existing DB instance.DbInstanceNotReadyException- An attempt to download or examine log files didn't succeed because an Aurora Serverless v2 instance was paused.DbLogFileNotFoundException-LogFileNamedoesn'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 Serverless v2 and provisioned DB clusters. To enable the HTTP endpoint for Aurora Serverless v1 DB clusters, use the
EnableHttpEndpointparameter of theModifyDBClusteroperation.- 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 Serverless v2 and provisioned DB clusters. To enable the HTTP endpoint for Aurora Serverless v1 DB clusters, use the
EnableHttpEndpointparameter of theModifyDBClusteroperation.
This is a convenience which creates an instance of the
EnableHttpEndpointRequest.Builderavoiding the need to create one manually viaEnableHttpEndpointRequest.builder()- Parameters:
enableHttpEndpointRequest- AConsumerthat will call methods onEnableHttpEndpointRequest.Builderto 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-DBClusterIdentifierdoesn'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.Builderavoiding the need to create one manually viaFailoverDbClusterRequest.builder()- Parameters:
failoverDbClusterRequest- AConsumerthat will call methods onFailoverDbClusterRequest.Builderto create a request.- Returns:
- Result of the FailoverDBCluster operation returned by the service.
- Throws:
DbClusterNotFoundException-DBClusterIdentifierdoesn'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
AllowDataLossparameter and don't specify theSwitchoverparameter. -
Switching over - Specify the
Switchoverparameter or omit it, but don't specify theAllowDataLossparameter.
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- TheGlobalClusterIdentifierdoesn'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-DBClusterIdentifierdoesn'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
AllowDataLossparameter and don't specify theSwitchoverparameter. -
Switching over - Specify the
Switchoverparameter or omit it, but don't specify theAllowDataLossparameter.
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.Builderavoiding the need to create one manually viaFailoverGlobalClusterRequest.builder()- Parameters:
failoverGlobalClusterRequest- AConsumerthat will call methods onFailoverGlobalClusterRequest.Builderto create a request.- Returns:
- Result of the FailoverGlobalCluster operation returned by the service.
- Throws:
GlobalClusterNotFoundException- TheGlobalClusterIdentifierdoesn'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-DBClusterIdentifierdoesn'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-DBInstanceIdentifierdoesn't refer to an existing DB instance.DbSnapshotNotFoundException-DBSnapshotIdentifierdoesn't refer to an existing DB snapshot.DbClusterNotFoundException-DBClusterIdentifierdoesn'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-BlueGreenDeploymentIdentifierdoesn'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.Builderavoiding the need to create one manually viaListTagsForResourceRequest.builder()- Parameters:
listTagsForResourceRequest- AConsumerthat will call methods onListTagsForResourceRequest.Builderto create a request.- Returns:
- Result of the ListTagsForResource operation returned by the service.
- Throws:
DbInstanceNotFoundException-DBInstanceIdentifierdoesn't refer to an existing DB instance.DbSnapshotNotFoundException-DBSnapshotIdentifierdoesn't refer to an existing DB snapshot.DbClusterNotFoundException-DBClusterIdentifierdoesn'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-BlueGreenDeploymentIdentifierdoesn'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-DBInstanceIdentifierdoesn'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.Builderavoiding the need to create one manually viaModifyActivityStreamRequest.builder()- Parameters:
modifyActivityStreamRequest- AConsumerthat will call methods onModifyActivityStreamRequest.Builderto 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-DBInstanceIdentifierdoesn'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-CertificateIdentifierdoesn'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.Builderavoiding the need to create one manually viaModifyCertificatesRequest.builder()- Parameters:
modifyCertificatesRequest- AConsumerthat will call methods onModifyCertificatesRequest.Builderto create a request.- Returns:
- Result of the ModifyCertificates operation returned by the service.
- Throws:
CertificateNotFoundException-CertificateIdentifierdoesn'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
ModifyCurrentDBClusterCapacityto 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
ModifyCurrentDBClusterCapacitywith 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-DBClusterIdentifierdoesn't refer to an existing DB cluster.InvalidDbClusterStateException- The requested operation can't be performed while the cluster is in this state.InvalidDbClusterCapacityException-Capacityisn'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
ModifyCurrentDBClusterCapacityto 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
ModifyCurrentDBClusterCapacitywith 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.Builderavoiding the need to create one manually viaModifyCurrentDbClusterCapacityRequest.builder()- Parameters:
modifyCurrentDbClusterCapacityRequest- AConsumerthat will call methods onModifyCurrentDbClusterCapacityRequest.Builderto create a request.- Returns:
- Result of the ModifyCurrentDBClusterCapacity operation returned by the service.
- Throws:
DbClusterNotFoundException-DBClusterIdentifierdoesn't refer to an existing DB cluster.InvalidDbClusterStateException- The requested operation can't be performed while the cluster is in this state.InvalidDbClusterCapacityException-Capacityisn'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
ModifyCustomDbEngineVersionevent 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 theModifyCustomDbEngineVersionevent.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
ModifyCustomDbEngineVersionevent 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 theModifyCustomDbEngineVersionevent.For more information, see Modifying CEV status in the Amazon RDS User Guide.
This is a convenience which creates an instance of the
ModifyCustomDbEngineVersionRequest.Builderavoiding the need to create one manually viaModifyCustomDbEngineVersionRequest.builder()- Parameters:
modifyCustomDbEngineVersionRequest- AConsumerthat will call methods onModifyCustomDbEngineVersionRequest.Builderto 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-DBClusterIdentifierdoesn'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-DBSubnetGroupNamedoesn'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-DBClusterParameterGroupNamedoesn'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-Domaindoesn't refer to an existing Active Directory domain.StorageTypeNotAvailableException- Theaurora-iopt1storage 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.Builderavoiding the need to create one manually viaModifyDbClusterRequest.builder()- Parameters:
modifyDbClusterRequest- AConsumerthat will call methods onModifyDbClusterRequest.Builderto create a request.- Returns:
- Result of the ModifyDBCluster operation returned by the service.
- Throws:
DbClusterNotFoundException-DBClusterIdentifierdoesn'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-DBSubnetGroupNamedoesn'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-DBClusterParameterGroupNamedoesn'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-Domaindoesn't refer to an existing Active Directory domain.StorageTypeNotAvailableException- Theaurora-iopt1storage 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-DBInstanceIdentifierdoesn'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.Builderavoiding the need to create one manually viaModifyDbClusterEndpointRequest.builder()- Parameters:
modifyDbClusterEndpointRequest- AConsumerthat will call methods onModifyDbClusterEndpointRequest.Builderto 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-DBInstanceIdentifierdoesn'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_databaseparameter. You can use the Parameter Groups option of the Amazon RDS console or theDescribeDBClusterParametersoperation 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-DBParameterGroupNamedoesn'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_databaseparameter. You can use the Parameter Groups option of the Amazon RDS console or theDescribeDBClusterParametersoperation 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.Builderavoiding the need to create one manually viaModifyDbClusterParameterGroupRequest.builder()- Parameters:
modifyDbClusterParameterGroupRequest- AConsumerthat will call methods onModifyDbClusterParameterGroupRequest.Builderto create a request.- Returns:
- Result of the ModifyDBClusterParameterGroup operation returned by the service.
- Throws:
DbParameterGroupNotFoundException-DBParameterGroupNamedoesn'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
restoreas theAttributeNameand use theValuesToAddparameter to add a list of IDs of the Amazon Web Services accounts that are authorized to restore the manual DB cluster snapshot. Use the valueallto 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
allvalue 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
ValuesToAddparameter. You can't useallas 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
restoreattribute.- Parameters:
modifyDbClusterSnapshotAttributeRequest-- Returns:
- Result of the ModifyDBClusterSnapshotAttribute operation returned by the service.
- Throws:
DbClusterSnapshotNotFoundException-DBClusterSnapshotIdentifierdoesn'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
restoreas theAttributeNameand use theValuesToAddparameter to add a list of IDs of the Amazon Web Services accounts that are authorized to restore the manual DB cluster snapshot. Use the valueallto 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
allvalue 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
ValuesToAddparameter. You can't useallas 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
restoreattribute.
This is a convenience which creates an instance of the
ModifyDbClusterSnapshotAttributeRequest.Builderavoiding the need to create one manually viaModifyDbClusterSnapshotAttributeRequest.builder()- Parameters:
modifyDbClusterSnapshotAttributeRequest- AConsumerthat will call methods onModifyDbClusterSnapshotAttributeRequest.Builderto create a request.- Returns:
- Result of the ModifyDBClusterSnapshotAttribute operation returned by the service.
- Throws:
DbClusterSnapshotNotFoundException-DBClusterSnapshotIdentifierdoesn'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
DescribeValidDBInstanceModificationsbefore 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-DBInstanceIdentifierdoesn't refer to an existing DB instance.DbSecurityGroupNotFoundException-DBSecurityGroupNamedoesn't refer to an existing DB security group.DbParameterGroupNotFoundException-DBParameterGroupNamedoesn'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 specifiedStorageTypecan'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-CertificateIdentifierdoesn't refer to an existing certificate.DomainNotFoundException-Domaindoesn'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 areIPV4andDUAL.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
DescribeValidDBInstanceModificationsbefore you callModifyDBInstance.
This is a convenience which creates an instance of the
ModifyDbInstanceRequest.Builderavoiding the need to create one manually viaModifyDbInstanceRequest.builder()- Parameters:
modifyDbInstanceRequest- AConsumerthat will call methods onModifyDbInstanceRequest.Builderto 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-DBInstanceIdentifierdoesn't refer to an existing DB instance.DbSecurityGroupNotFoundException-DBSecurityGroupNamedoesn't refer to an existing DB security group.DbParameterGroupNotFoundException-DBParameterGroupNamedoesn'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 specifiedStorageTypecan'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-CertificateIdentifierdoesn't refer to an existing certificate.DomainNotFoundException-Domaindoesn'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 areIPV4andDUAL.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_databaseparameter. 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-DBParameterGroupNamedoesn'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_databaseparameter. 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.Builderavoiding the need to create one manually viaModifyDbParameterGroupRequest.builder()- Parameters:
modifyDbParameterGroupRequest- AConsumerthat will call methods onModifyDbParameterGroupRequest.Builderto create a request.- Returns:
- Result of the ModifyDBParameterGroup operation returned by the service.
- Throws:
DbParameterGroupNotFoundException-DBParameterGroupNamedoesn'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.Builderavoiding the need to create one manually viaModifyDbProxyRequest.builder()- Parameters:
modifyDbProxyRequest- AConsumerthat will call methods onModifyDbProxyRequest.Builderto 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.Builderavoiding the need to create one manually viaModifyDbProxyEndpointRequest.builder()- Parameters:
modifyDbProxyEndpointRequest- AConsumerthat will call methods onModifyDbProxyEndpointRequest.Builderto 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.Builderavoiding the need to create one manually viaModifyDbProxyTargetGroupRequest.builder()- Parameters:
modifyDbProxyTargetGroupRequest- AConsumerthat will call methods onModifyDbProxyTargetGroupRequest.Builderto 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.Builderavoiding the need to create one manually viaModifyDbRecommendationRequest.builder()- Parameters:
modifyDbRecommendationRequest- AConsumerthat will call methods onModifyDbRecommendationRequest.Builderto 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.Builderavoiding the need to create one manually viaModifyDbShardGroupRequest.builder()- Parameters:
modifyDbShardGroupRequest- AConsumerthat will call methods onModifyDbShardGroupRequest.Builderto 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-DBSnapshotIdentifierdoesn'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.Builderavoiding the need to create one manually viaModifyDbSnapshotRequest.builder()- Parameters:
modifyDbSnapshotRequest- AConsumerthat will call methods onModifyDbSnapshotRequest.Builderto create a request.- Returns:
- Result of the ModifyDBSnapshot operation returned by the service.
- Throws:
DbSnapshotNotFoundException-DBSnapshotIdentifierdoesn'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
restoreas theAttributeNameand use theValuesToAddparameter to add a list of IDs of the Amazon Web Services accounts that are authorized to restore the manual DB snapshot. Uses the valueallto make the manual DB snapshot public, which means it can be copied or restored by all Amazon Web Services accounts.Don't add the
allvalue 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
ValuesToAddparameter. You can't useallas 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
restoreattribute.- Parameters:
modifyDbSnapshotAttributeRequest-- Returns:
- Result of the ModifyDBSnapshotAttribute operation returned by the service.
- Throws:
DbSnapshotNotFoundException-DBSnapshotIdentifierdoesn'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
restoreas theAttributeNameand use theValuesToAddparameter to add a list of IDs of the Amazon Web Services accounts that are authorized to restore the manual DB snapshot. Uses the valueallto make the manual DB snapshot public, which means it can be copied or restored by all Amazon Web Services accounts.Don't add the
allvalue 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
ValuesToAddparameter. You can't useallas 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
restoreattribute.
This is a convenience which creates an instance of the
ModifyDbSnapshotAttributeRequest.Builderavoiding the need to create one manually viaModifyDbSnapshotAttributeRequest.builder()- Parameters:
modifyDbSnapshotAttributeRequest- AConsumerthat will call methods onModifyDbSnapshotAttributeRequest.Builderto create a request.- Returns:
- Result of the ModifyDBSnapshotAttribute operation returned by the service.
- Throws:
DbSnapshotNotFoundException-DBSnapshotIdentifierdoesn'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-DBSubnetGroupNamedoesn'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.Builderavoiding the need to create one manually viaModifyDbSubnetGroupRequest.builder()- Parameters:
modifyDbSubnetGroupRequest- AConsumerthat will call methods onModifyDbSubnetGroupRequest.Builderto create a request.- Returns:
- Result of the ModifyDBSubnetGroup operation returned by the service.
- Throws:
DbSubnetGroupNotFoundException-DBSubnetGroupNamedoesn'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
AddSourceIdentifierToSubscriptionandRemoveSourceIdentifierFromSubscriptioncalls.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 theDescribeEventCategoriesoperation.- 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
AddSourceIdentifierToSubscriptionandRemoveSourceIdentifierFromSubscriptioncalls.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 theDescribeEventCategoriesoperation.
This is a convenience which creates an instance of the
ModifyEventSubscriptionRequest.Builderavoiding the need to create one manually viaModifyEventSubscriptionRequest.builder()- Parameters:
modifyEventSubscriptionRequest- AConsumerthat will call methods onModifyEventSubscriptionRequest.Builderto 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- TheGlobalClusterIdentifierdoesn't refer to an existing global database cluster.GlobalClusterAlreadyExistsException- TheGlobalClusterIdentifieralready 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.Builderavoiding the need to create one manually viaModifyGlobalClusterRequest.builder()- Parameters:
modifyGlobalClusterRequest- AConsumerthat will call methods onModifyGlobalClusterRequest.Builderto create a request.- Returns:
- Result of the ModifyGlobalCluster operation returned by the service.
- Throws:
GlobalClusterNotFoundException- TheGlobalClusterIdentifierdoesn't refer to an existing global database cluster.GlobalClusterAlreadyExistsException- TheGlobalClusterIdentifieralready 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.
- 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.
This is a convenience which creates an instance of the
ModifyIntegrationRequest.Builderavoiding the need to create one manually viaModifyIntegrationRequest.builder()- Parameters:
modifyIntegrationRequest- AConsumerthat will call methods onModifyIntegrationRequest.Builderto 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.Builderavoiding the need to create one manually viaModifyOptionGroupRequest.builder()- Parameters:
modifyOptionGroupRequest- AConsumerthat will call methods onModifyOptionGroupRequest.Builderto 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-DBInstanceIdentifierdoesn'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.Builderavoiding the need to create one manually viaModifyTenantDatabaseRequest.builder()- Parameters:
modifyTenantDatabaseRequest- AConsumerthat will call methods onModifyTenantDatabaseRequest.Builderto create a request.- Returns:
- Result of the ModifyTenantDatabase operation returned by the service.
- Throws:
DbInstanceNotFoundException-DBInstanceIdentifierdoesn'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-upstatus. 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-DBInstanceIdentifierdoesn'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-upstatus. 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.Builderavoiding the need to create one manually viaPromoteReadReplicaRequest.builder()- Parameters:
promoteReadReplicaRequest- AConsumerthat will call methods onPromoteReadReplicaRequest.Builderto 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-DBInstanceIdentifierdoesn'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-DBClusterIdentifierdoesn'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.Builderavoiding the need to create one manually viaPromoteReadReplicaDbClusterRequest.builder()- Parameters:
promoteReadReplicaDbClusterRequest- AConsumerthat will call methods onPromoteReadReplicaDbClusterRequest.Builderto create a request.- Returns:
- Result of the PromoteReadReplicaDBCluster operation returned by the service.
- Throws:
DbClusterNotFoundException-DBClusterIdentifierdoesn'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.Builderavoiding the need to create one manually viaPurchaseReservedDbInstancesOfferingRequest.builder()- Parameters:
purchaseReservedDbInstancesOfferingRequest- AConsumerthat will call methods onPurchaseReservedDbInstancesOfferingRequest.Builderto 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-DBClusterIdentifierdoesn'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.Builderavoiding the need to create one manually viaRebootDbClusterRequest.builder()- Parameters:
rebootDbClusterRequest- AConsumerthat will call methods onRebootDbClusterRequest.Builderto create a request.- Returns:
- Result of the RebootDBCluster operation returned by the service.
- Throws:
DbClusterNotFoundException-DBClusterIdentifierdoesn'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
RebootDBClusteroperation.- Parameters:
rebootDbInstanceRequest-- Returns:
- Result of the RebootDBInstance operation returned by the service.
- Throws:
InvalidDbInstanceStateException- The DB instance isn't in a valid state.DbInstanceNotFoundException-DBInstanceIdentifierdoesn'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
RebootDBClusteroperation.
This is a convenience which creates an instance of the
RebootDbInstanceRequest.Builderavoiding the need to create one manually viaRebootDbInstanceRequest.builder()- Parameters:
rebootDbInstanceRequest- AConsumerthat will call methods onRebootDbInstanceRequest.Builderto 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-DBInstanceIdentifierdoesn'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.Builderavoiding the need to create one manually viaRebootDbShardGroupRequest.builder()- Parameters:
rebootDbShardGroupRequest- AConsumerthat will call methods onRebootDbShardGroupRequest.Builderto 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
DBProxyTargetdata 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-DBClusterIdentifierdoesn't refer to an existing DB cluster.DbInstanceNotFoundException-DBInstanceIdentifierdoesn'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
DBProxyTargetdata structures with aDBProxyTargetGroup.
This is a convenience which creates an instance of the
RegisterDbProxyTargetsRequest.Builderavoiding the need to create one manually viaRegisterDbProxyTargetsRequest.builder()- Parameters:
registerDbProxyTargetsRequest- AConsumerthat will call methods onRegisterDbProxyTargetsRequest.Builderto 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-DBClusterIdentifierdoesn't refer to an existing DB cluster.DbInstanceNotFoundException-DBInstanceIdentifierdoesn'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- TheGlobalClusterIdentifierdoesn'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-DBClusterIdentifierdoesn'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.Builderavoiding the need to create one manually viaRemoveFromGlobalClusterRequest.builder()- Parameters:
removeFromGlobalClusterRequest- AConsumerthat will call methods onRemoveFromGlobalClusterRequest.Builderto create a request.- Returns:
- Result of the RemoveFromGlobalCluster operation returned by the service.
- Throws:
GlobalClusterNotFoundException- TheGlobalClusterIdentifierdoesn'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-DBClusterIdentifierdoesn'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-DBClusterIdentifierdoesn'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.Builderavoiding the need to create one manually viaRemoveRoleFromDbClusterRequest.builder()- Parameters:
removeRoleFromDbClusterRequest- AConsumerthat will call methods onRemoveRoleFromDbClusterRequest.Builderto create a request.- Returns:
- Result of the RemoveRoleFromDBCluster operation returned by the service.
- Throws:
DbClusterNotFoundException-DBClusterIdentifierdoesn'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-DBInstanceIdentifierdoesn't refer to an existing DB instance.DbInstanceRoleNotFoundException- The specifiedRoleArnvalue 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.Builderavoiding the need to create one manually viaRemoveRoleFromDbInstanceRequest.builder()- Parameters:
removeRoleFromDbInstanceRequest- AConsumerthat will call methods onRemoveRoleFromDbInstanceRequest.Builderto create a request.- Returns:
- Result of the RemoveRoleFromDBInstance operation returned by the service.
- Throws:
DbInstanceNotFoundException-DBInstanceIdentifierdoesn't refer to an existing DB instance.DbInstanceRoleNotFoundException- The specifiedRoleArnvalue 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.Builderavoiding the need to create one manually viaRemoveSourceIdentifierFromSubscriptionRequest.builder()- Parameters:
removeSourceIdentifierFromSubscriptionRequest- AConsumerthat will call methods onRemoveSourceIdentifierFromSubscriptionRequest.Builderto 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-DBInstanceIdentifierdoesn't refer to an existing DB instance.DbSnapshotNotFoundException-DBSnapshotIdentifierdoesn't refer to an existing DB snapshot.DbClusterNotFoundException-DBClusterIdentifierdoesn'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-BlueGreenDeploymentIdentifierdoesn'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.Builderavoiding the need to create one manually viaRemoveTagsFromResourceRequest.builder()- Parameters:
removeTagsFromResourceRequest- AConsumerthat will call methods onRemoveTagsFromResourceRequest.Builderto create a request.- Returns:
- Result of the RemoveTagsFromResource operation returned by the service.
- Throws:
DbInstanceNotFoundException-DBInstanceIdentifierdoesn't refer to an existing DB instance.DbSnapshotNotFoundException-DBSnapshotIdentifierdoesn't refer to an existing DB snapshot.DbClusterNotFoundException-DBClusterIdentifierdoesn'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-BlueGreenDeploymentIdentifierdoesn'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:
ParameterNameandApplyMethod. To reset the entire DB cluster parameter group, specify theDBClusterParameterGroupNameandResetAllParametersparameters.When resetting the entire group, dynamic parameters are updated immediately and static parameters are set to
pending-rebootto take effect on the next DB instance restart orRebootDBInstancerequest. You must callRebootDBInstancefor 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-DBParameterGroupNamedoesn'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:
ParameterNameandApplyMethod. To reset the entire DB cluster parameter group, specify theDBClusterParameterGroupNameandResetAllParametersparameters.When resetting the entire group, dynamic parameters are updated immediately and static parameters are set to
pending-rebootto take effect on the next DB instance restart orRebootDBInstancerequest. You must callRebootDBInstancefor 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.Builderavoiding the need to create one manually viaResetDbClusterParameterGroupRequest.builder()- Parameters:
resetDbClusterParameterGroupRequest- AConsumerthat will call methods onResetDbClusterParameterGroupRequest.Builderto 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-DBParameterGroupNamedoesn'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:
ParameterNameandApplyMethod. To reset the entire DB parameter group, specify theDBParameterGroupname andResetAllParametersparameters. When resetting the entire group, dynamic parameters are updated immediately and static parameters are set topending-rebootto take effect on the next DB instance restart orRebootDBInstancerequest.- 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-DBParameterGroupNamedoesn'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:
ParameterNameandApplyMethod. To reset the entire DB parameter group, specify theDBParameterGroupname andResetAllParametersparameters. When resetting the entire group, dynamic parameters are updated immediately and static parameters are set topending-rebootto take effect on the next DB instance restart orRebootDBInstancerequest.
This is a convenience which creates an instance of the
ResetDbParameterGroupRequest.Builderavoiding the need to create one manually viaResetDbParameterGroupRequest.builder()- Parameters:
resetDbParameterGroupRequest- AConsumerthat will call methods onResetDbParameterGroupRequest.Builderto 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-DBParameterGroupNamedoesn'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
CreateDBInstanceoperation 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 theRestoreDBClusterFromS3operation 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-DBSubnetGroupNamedoesn'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-DBClusterParameterGroupNamedoesn't refer to an existing DB cluster parameter group.KmsKeyNotAccessibleException- An error occurred accessing an Amazon Web Services KMS key.DbClusterNotFoundException-DBClusterIdentifierdoesn't refer to an existing DB cluster.DomainNotFoundException-Domaindoesn'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 specifiedStorageTypecan'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
CreateDBInstanceoperation 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 theRestoreDBClusterFromS3operation 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.Builderavoiding the need to create one manually viaRestoreDbClusterFromS3Request.builder()- Parameters:
restoreDbClusterFromS3Request- AConsumerthat will call methods onRestoreDbClusterFromS3Request.Builderto 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-DBSubnetGroupNamedoesn'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-DBClusterParameterGroupNamedoesn't refer to an existing DB cluster parameter group.KmsKeyNotAccessibleException- An error occurred accessing an Amazon Web Services KMS key.DbClusterNotFoundException-DBClusterIdentifierdoesn't refer to an existing DB cluster.DomainNotFoundException-Domaindoesn'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 specifiedStorageTypecan'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
CreateDBInstanceoperation 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 theRestoreDBClusterFromSnapshotoperation 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-DBSubnetGroupNamedoesn't refer to an existing DB subnet group.DbSnapshotNotFoundException-DBSnapshotIdentifierdoesn't refer to an existing DB snapshot.DbClusterSnapshotNotFoundException-DBClusterSnapshotIdentifierdoesn'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-DBSubnetGroupNamedoesn'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-Domaindoesn't refer to an existing Active Directory domain.DbClusterParameterGroupNotFoundException-DBClusterParameterGroupNamedoesn'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
CreateDBInstanceoperation 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 theRestoreDBClusterFromSnapshotoperation 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.Builderavoiding the need to create one manually viaRestoreDbClusterFromSnapshotRequest.builder()- Parameters:
restoreDbClusterFromSnapshotRequest- AConsumerthat will call methods onRestoreDbClusterFromSnapshotRequest.Builderto 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-DBSubnetGroupNamedoesn't refer to an existing DB subnet group.DbSnapshotNotFoundException-DBSnapshotIdentifierdoesn't refer to an existing DB snapshot.DbClusterSnapshotNotFoundException-DBClusterSnapshotIdentifierdoesn'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-DBSubnetGroupNamedoesn'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-Domaindoesn't refer to an existing Active Directory domain.DbClusterParameterGroupNotFoundException-DBClusterParameterGroupNamedoesn'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
LatestRestorableTimefor up toBackupRetentionPerioddays. 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
CreateDBInstanceoperation 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 theRestoreDBClusterToPointInTimeoperation 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-DBClusterIdentifierdoesn'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-DBClusterSnapshotIdentifierdoesn't refer to an existing DB cluster snapshot.DbSubnetGroupNotFoundException-DBSubnetGroupNamedoesn'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-Domaindoesn't refer to an existing Active Directory domain.DbClusterParameterGroupNotFoundException-DBClusterParameterGroupNamedoesn'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
LatestRestorableTimefor up toBackupRetentionPerioddays. 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
CreateDBInstanceoperation 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 theRestoreDBClusterToPointInTimeoperation 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.Builderavoiding the need to create one manually viaRestoreDbClusterToPointInTimeRequest.builder()- Parameters:
restoreDbClusterToPointInTimeRequest- AConsumerthat will call methods onRestoreDbClusterToPointInTimeRequest.Builderto 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-DBClusterIdentifierdoesn'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-DBClusterSnapshotIdentifierdoesn't refer to an existing DB cluster snapshot.DbSubnetGroupNotFoundException-DBSubnetGroupNamedoesn'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-Domaindoesn't refer to an existing Active Directory domain.DbClusterParameterGroupNotFoundException-DBClusterParameterGroupNamedoesn'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
RestoreDBInstanceFromDBSnapshotoperation. 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 theDBInstanceIdentifierin the call to theRestoreDBInstanceFromDBSnapshotoperation. 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
DBSnapshotIdentifiermust 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-DBSnapshotIdentifierdoesn'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-DBSubnetGroupNamedoesn'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 specifiedStorageTypecan'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-DBSecurityGroupNamedoesn't refer to an existing DB security group.DomainNotFoundException-Domaindoesn't refer to an existing Active Directory domain.DbParameterGroupNotFoundException-DBParameterGroupNamedoesn't refer to an existing DB parameter group.NetworkTypeNotSupportedException- The network type is invalid for the DB instance. Valid nework type values areIPV4andDUAL.DbClusterSnapshotNotFoundException-DBClusterSnapshotIdentifierdoesn't refer to an existing DB cluster snapshot.CertificateNotFoundException-CertificateIdentifierdoesn'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
RestoreDBInstanceFromDBSnapshotoperation. 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 theDBInstanceIdentifierin the call to theRestoreDBInstanceFromDBSnapshotoperation. 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
DBSnapshotIdentifiermust 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.Builderavoiding the need to create one manually viaRestoreDbInstanceFromDbSnapshotRequest.builder()- Parameters:
restoreDbInstanceFromDbSnapshotRequest- AConsumerthat will call methods onRestoreDbInstanceFromDbSnapshotRequest.Builderto 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-DBSnapshotIdentifierdoesn'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-DBSubnetGroupNamedoesn'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 specifiedStorageTypecan'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-DBSecurityGroupNamedoesn't refer to an existing DB security group.DomainNotFoundException-Domaindoesn't refer to an existing Active Directory domain.DbParameterGroupNotFoundException-DBParameterGroupNamedoesn't refer to an existing DB parameter group.NetworkTypeNotSupportedException- The network type is invalid for the DB instance. Valid nework type values areIPV4andDUAL.DbClusterSnapshotNotFoundException-DBClusterSnapshotIdentifierdoesn't refer to an existing DB cluster snapshot.CertificateNotFoundException-CertificateIdentifierdoesn'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-DBParameterGroupNamedoesn't refer to an existing DB parameter group.DbSecurityGroupNotFoundException-DBSecurityGroupNamedoesn'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-DBSubnetGroupNamedoesn'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 specifiedStorageTypecan'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 areIPV4andDUAL.CertificateNotFoundException-CertificateIdentifierdoesn'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.Builderavoiding the need to create one manually viaRestoreDbInstanceFromS3Request.builder()- Parameters:
restoreDbInstanceFromS3Request- AConsumerthat will call methods onRestoreDbInstanceFromS3Request.Builderto 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-DBParameterGroupNamedoesn't refer to an existing DB parameter group.DbSecurityGroupNotFoundException-DBSecurityGroupNamedoesn'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-DBSubnetGroupNamedoesn'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 specifiedStorageTypecan'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 areIPV4andDUAL.CertificateNotFoundException-CertificateIdentifierdoesn'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
LatestRestorableTimeproperty. You can restore to a point up to the number of days specified by theBackupRetentionPeriodproperty.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-DBInstanceIdentifierdoesn'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-SourceDBInstanceIdentifierrefers to a DB instance withBackupRetentionPeriodequal 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-DBSubnetGroupNamedoesn'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 specifiedStorageTypecan'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-DBSecurityGroupNamedoesn't refer to an existing DB security group.DomainNotFoundException-Domaindoesn't refer to an existing Active Directory domain.DbParameterGroupNotFoundException-DBParameterGroupNamedoesn'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 areIPV4andDUAL.TenantDatabaseQuotaExceededException- You attempted to create more tenant databases than are permitted in your Amazon Web Services account.CertificateNotFoundException-CertificateIdentifierdoesn'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
LatestRestorableTimeproperty. You can restore to a point up to the number of days specified by theBackupRetentionPeriodproperty.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.Builderavoiding the need to create one manually viaRestoreDbInstanceToPointInTimeRequest.builder()- Parameters:
restoreDbInstanceToPointInTimeRequest- AConsumerthat will call methods onRestoreDbInstanceToPointInTimeRequest.Builderto 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-DBInstanceIdentifierdoesn'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-SourceDBInstanceIdentifierrefers to a DB instance withBackupRetentionPeriodequal 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-DBSubnetGroupNamedoesn'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 specifiedStorageTypecan'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-DBSecurityGroupNamedoesn't refer to an existing DB security group.DomainNotFoundException-Domaindoesn't refer to an existing Active Directory domain.DbParameterGroupNotFoundException-DBParameterGroupNamedoesn'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 areIPV4andDUAL.TenantDatabaseQuotaExceededException- You attempted to create more tenant databases than are permitted in your Amazon Web Services account.CertificateNotFoundException-CertificateIdentifierdoesn'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-DBSecurityGroupNamedoesn'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.Builderavoiding the need to create one manually viaRevokeDbSecurityGroupIngressRequest.builder()- Parameters:
revokeDbSecurityGroupIngressRequest- AConsumerthat will call methods onRevokeDbSecurityGroupIngressRequest.Builderto create a request.- Returns:
- Result of the RevokeDBSecurityGroupIngress operation returned by the service.
- Throws:
DbSecurityGroupNotFoundException-DBSecurityGroupNamedoesn'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-DBClusterIdentifierdoesn't refer to an existing DB cluster.DbInstanceNotFoundException-DBInstanceIdentifierdoesn'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.Builderavoiding the need to create one manually viaStartActivityStreamRequest.builder()- Parameters:
startActivityStreamRequest- AConsumerthat will call methods onStartActivityStreamRequest.Builderto 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-DBClusterIdentifierdoesn't refer to an existing DB cluster.DbInstanceNotFoundException-DBInstanceIdentifierdoesn'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
StopDBClusteroperation.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-DBClusterIdentifierdoesn'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
StopDBClusteroperation.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.Builderavoiding the need to create one manually viaStartDbClusterRequest.builder()- Parameters:
startDbClusterRequest- AConsumerthat will call methods onStartDbClusterRequest.Builderto create a request.- Returns:
- Result of the StartDBCluster operation returned by the service.
- Throws:
DbClusterNotFoundException-DBClusterIdentifierdoesn'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
StopDBInstanceoperation.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
StartDBClusterinstead.- Parameters:
startDbInstanceRequest-- Returns:
- Result of the StartDBInstance operation returned by the service.
- Throws:
DbInstanceNotFoundException-DBInstanceIdentifierdoesn'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-DBSubnetGroupNamedoesn'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-DBClusterIdentifierdoesn'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
StopDBInstanceoperation.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
StartDBClusterinstead.
This is a convenience which creates an instance of the
StartDbInstanceRequest.Builderavoiding the need to create one manually viaStartDbInstanceRequest.builder()- Parameters:
startDbInstanceRequest- AConsumerthat will call methods onStartDbInstanceRequest.Builderto create a request.- Returns:
- Result of the StartDBInstance operation returned by the service.
- Throws:
DbInstanceNotFoundException-DBInstanceIdentifierdoesn'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-DBSubnetGroupNamedoesn'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-DBClusterIdentifierdoesn'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-DBInstanceIdentifierdoesn'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 specifiedStorageTypecan'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.Builderavoiding the need to create one manually viaStartDbInstanceAutomatedBackupsReplicationRequest.builder()- Parameters:
startDbInstanceAutomatedBackupsReplicationRequest- AConsumerthat will call methods onStartDbInstanceAutomatedBackupsReplicationRequest.Builderto create a request.- Returns:
- Result of the StartDBInstanceAutomatedBackupsReplication operation returned by the service.
- Throws:
DbInstanceNotFoundException-DBInstanceIdentifierdoesn'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 specifiedStorageTypecan'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 RDS Custom DB instances. For more information, see Supported Regions and DB engines for exporting snapshots to S3 in Amazon RDS.
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-DBSnapshotIdentifierdoesn't refer to an existing DB snapshot.DbClusterSnapshotNotFoundException-DBClusterSnapshotIdentifierdoesn't refer to an existing DB cluster snapshot.DbClusterNotFoundException-DBClusterIdentifierdoesn'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 RDS Custom DB instances. For more information, see Supported Regions and DB engines for exporting snapshots to S3 in Amazon RDS.
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.Builderavoiding the need to create one manually viaStartExportTaskRequest.builder()- Parameters:
startExportTaskRequest- AConsumerthat will call methods onStartExportTaskRequest.Builderto create a request.- Returns:
- Result of the StartExportTask operation returned by the service.
- Throws:
DbSnapshotNotFoundException-DBSnapshotIdentifierdoesn't refer to an existing DB snapshot.DbClusterSnapshotNotFoundException-DBClusterSnapshotIdentifierdoesn't refer to an existing DB cluster snapshot.DbClusterNotFoundException-DBClusterIdentifierdoesn'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-streamCLI command, or theStartActivityStreamoperation.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-DBClusterIdentifierdoesn't refer to an existing DB cluster.DbInstanceNotFoundException-DBInstanceIdentifierdoesn'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-streamCLI command, or theStartActivityStreamoperation.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.Builderavoiding the need to create one manually viaStopActivityStreamRequest.builder()- Parameters:
stopActivityStreamRequest- AConsumerthat will call methods onStopActivityStreamRequest.Builderto 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-DBClusterIdentifierdoesn't refer to an existing DB cluster.DbInstanceNotFoundException-DBInstanceIdentifierdoesn'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-DBClusterIdentifierdoesn'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.Builderavoiding the need to create one manually viaStopDbClusterRequest.builder()- Parameters:
stopDbClusterRequest- AConsumerthat will call methods onStopDbClusterRequest.Builderto create a request.- Returns:
- Result of the StopDBCluster operation returned by the service.
- Throws:
DbClusterNotFoundException-DBClusterIdentifierdoesn'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 temporarily. 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. The instance restarts automatically after 7 days.
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
StopDBClusterinstead.- Parameters:
stopDbInstanceRequest-- Returns:
- Result of the StopDBInstance operation returned by the service.
- Throws:
DbInstanceNotFoundException-DBInstanceIdentifierdoesn't refer to an existing DB instance.InvalidDbInstanceStateException- The DB instance isn't in a valid state.DbSnapshotAlreadyExistsException-DBSnapshotIdentifieris 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 temporarily. 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. The instance restarts automatically after 7 days.
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
StopDBClusterinstead.
This is a convenience which creates an instance of the
StopDbInstanceRequest.Builderavoiding the need to create one manually viaStopDbInstanceRequest.builder()- Parameters:
stopDbInstanceRequest- AConsumerthat will call methods onStopDbInstanceRequest.Builderto create a request.- Returns:
- Result of the StopDBInstance operation returned by the service.
- Throws:
DbInstanceNotFoundException-DBInstanceIdentifierdoesn't refer to an existing DB instance.InvalidDbInstanceStateException- The DB instance isn't in a valid state.DbSnapshotAlreadyExistsException-DBSnapshotIdentifieris 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-DBInstanceIdentifierdoesn'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.Builderavoiding the need to create one manually viaStopDbInstanceAutomatedBackupsReplicationRequest.builder()- Parameters:
stopDbInstanceAutomatedBackupsReplicationRequest- AConsumerthat will call methods onStopDbInstanceAutomatedBackupsReplicationRequest.Builderto create a request.- Returns:
- Result of the StopDBInstanceAutomatedBackupsReplication operation returned by the service.
- Throws:
DbInstanceNotFoundException-DBInstanceIdentifierdoesn'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-BlueGreenDeploymentIdentifierdoesn'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.Builderavoiding the need to create one manually viaSwitchoverBlueGreenDeploymentRequest.builder()- Parameters:
switchoverBlueGreenDeploymentRequest- AConsumerthat will call methods onSwitchoverBlueGreenDeploymentRequest.Builderto create a request.- Returns:
- Result of the SwitchoverBlueGreenDeployment operation returned by the service.
- Throws:
BlueGreenDeploymentNotFoundException-BlueGreenDeploymentIdentifierdoesn'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- TheGlobalClusterIdentifierdoesn'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-DBClusterIdentifierdoesn'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.Builderavoiding the need to create one manually viaSwitchoverGlobalClusterRequest.builder()- Parameters:
switchoverGlobalClusterRequest- AConsumerthat will call methods onSwitchoverGlobalClusterRequest.Builderto create a request.- Returns:
- Result of the SwitchoverGlobalCluster operation returned by the service.
- Throws:
GlobalClusterNotFoundException- TheGlobalClusterIdentifierdoesn'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-DBClusterIdentifierdoesn'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-DBInstanceIdentifierdoesn'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.Builderavoiding the need to create one manually viaSwitchoverReadReplicaRequest.builder()- Parameters:
switchoverReadReplicaRequest- AConsumerthat will call methods onSwitchoverReadReplicaRequest.Builderto create a request.- Returns:
- Result of the SwitchoverReadReplica operation returned by the service.
- Throws:
DbInstanceNotFoundException-DBInstanceIdentifierdoesn'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 ofRdsUtilitiesobject with the configuration set on this client.
-
waiter
default RdsWaiter waiter()
Create an instance ofRdsWaiterusing 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 aRdsClientwith the region loaded from theDefaultAwsRegionProviderChainand 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:
serviceClientConfigurationin interfaceAwsClient- Specified by:
serviceClientConfigurationin interfaceSdkClient
-
-