Find Usages Diff Raw Download HTML Widget
Start line:  
End line:  

Snippet Preview

Snippet HTML Code

Stack Overflow Questions 
1
   /*
2
    * Copyright 2010-2015 Amazon.com, Inc. or its affiliates. All Rights Reserved.
3
    * 
4
    * Licensed under the Apache License, Version 2.0 (the "License").
5
    * You may not use this file except in compliance with the License.
6
    * A copy of the License is located at
7
    * 
8
    *  http://aws.amazon.com/apache2.0
9
    * 
10
   * or in the "license" file accompanying this file. This file is distributed
11
   * on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either
12
   * express or implied. See the License for the specific language governing
13
   * permissions and limitations under the License.
14
   */
15
  package com.amazonaws.services.rds;
16
  
21
  
29
  
Asynchronous client for accessing AmazonRDS. All asynchronous calls made using this client are non-blocking. Callers could either process the result and handle the exceptions in the worker thread by providing a callback handler when making the call, or use the returned Future object to check the result of the call in the calling thread. 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, resizable 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, PostgreSQL, Microsoft SQL Server, Oracle, or Aurora database server. This means 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 database 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 is an interface reference for Amazon RDS. It contains documentation for a programming or command line interface you can use to manage Amazon RDS. Note that Amazon RDS is asynchronous, which means that some interfaces may 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. For a summary of the Amazon RDS interfaces, go to Available RDS Interfaces . 

69
  
70
  public class AmazonRDSAsyncClient extends AmazonRDSClient
71
          implements AmazonRDSAsync {

    
Executor service for executing asynchronous requests. 
75
  
76
      private ExecutorService executorService;
77
  
78
      private static final int DEFAULT_THREAD_POOL_SIZE = 50;

    
Constructs a new asynchronous client to invoke service methods on AmazonRDS. A credentials provider chain will be used that searches for credentials in this order:
  • Environment Variables - AWS_ACCESS_KEY_ID and AWS_SECRET_KEY
  • Java System Properties - aws.accessKeyId and aws.secretKey
  • Instance profile credentials delivered through the Amazon EC2 metadata service

All service calls made using this new client object are blocking, and will not return until the service call completes.

See also:
com.amazonaws.auth.DefaultAWSCredentialsProviderChain
95
  
96
      public AmazonRDSAsyncClient() {
97
          this(new DefaultAWSCredentialsProviderChain());
98
      }

    
Constructs a new asynchronous client to invoke service methods on AmazonRDS. A credentials provider chain will be used that searches for credentials in this order:
  • Environment Variables - AWS_ACCESS_KEY_ID and AWS_SECRET_KEY
  • Java System Properties - aws.accessKeyId and aws.secretKey
  • Instance profile credentials delivered through the Amazon EC2 metadata service

All service calls made using this new client object are blocking, and will not return until the service call completes.

Parameters:
clientConfiguration The client configuration options controlling how this client connects to AmazonRDS (ex: proxy settings, retry counts, etc.).
See also:
com.amazonaws.auth.DefaultAWSCredentialsProviderChain
119
 
120
     public AmazonRDSAsyncClient(ClientConfiguration clientConfiguration) {
121
         this(new DefaultAWSCredentialsProviderChain(), clientConfiguration, Executors.newFixedThreadPool(clientConfiguration.getMaxConnections()));
122
     }

    
Constructs a new asynchronous client to invoke service methods on AmazonRDS using the specified AWS account credentials. Default client settings will be used, and a fixed size thread pool will be created for executing the asynchronous tasks.

All calls made using this new client object are non-blocking, and will immediately return a Java Future object that the caller can later check to see if the service call has actually completed.

Parameters:
awsCredentials The AWS credentials (access key ID and secret key) to use when authenticating with AWS services.
137
 
138
     public AmazonRDSAsyncClient(AWSCredentials awsCredentials) {
139
         this(awsCredentials, Executors.newFixedThreadPool());
140
     }

    
Constructs a new asynchronous client to invoke service methods on AmazonRDS using the specified AWS account credentials and executor service. Default client settings will be used.

All calls made using this new client object are non-blocking, and will immediately return a Java Future object that the caller can later check to see if the service call has actually completed.

Parameters:
awsCredentials The AWS credentials (access key ID and secret key) to use when authenticating with AWS services.
executorService The executor service by which all asynchronous requests will be executed.
158
 
159
     public AmazonRDSAsyncClient(AWSCredentials awsCredentials, ExecutorService executorService) {
160
         super(awsCredentials);
161
         this. = executorService;
162
     }

    
Constructs a new asynchronous client to invoke service methods on AmazonRDS using the specified AWS account credentials, executor service, and client configuration options.

All calls made using this new client object are non-blocking, and will immediately return a Java Future object that the caller can later check to see if the service call has actually completed.

Parameters:
awsCredentials The AWS credentials (access key ID and secret key) to use when authenticating with AWS services.
clientConfiguration Client configuration options (ex: max retry limit, proxy settings, etc).
executorService The executor service by which all asynchronous requests will be executed.
183
 
184
     public AmazonRDSAsyncClient(AWSCredentials awsCredentials,
185
                 ClientConfiguration clientConfiguration, ExecutorService executorService) {
186
         super(awsCredentials, clientConfiguration);
187
         this. = executorService;
188
     }

    
Constructs a new asynchronous client to invoke service methods on AmazonRDS using the specified AWS account credentials provider. Default client settings will be used, and a fixed size thread pool will be created for executing the asynchronous tasks.

All calls made using this new client object are non-blocking, and will immediately return a Java Future object that the caller can later check to see if the service call has actually completed.

Parameters:
awsCredentialsProvider The AWS credentials provider which will provide credentials to authenticate requests with AWS services.
204
 
205
     public AmazonRDSAsyncClient(AWSCredentialsProvider awsCredentialsProvider) {
206
         this(awsCredentialsProvider, Executors.newFixedThreadPool());
207
     }

    
Constructs a new asynchronous client to invoke service methods on AmazonRDS using the specified AWS account credentials provider and executor service. Default client settings will be used.

All calls made using this new client object are non-blocking, and will immediately return a Java Future object that the caller can later check to see if the service call has actually completed.

Parameters:
awsCredentialsProvider The AWS credentials provider which will provide credentials to authenticate requests with AWS services.
executorService The executor service by which all asynchronous requests will be executed.
225
 
226
     public AmazonRDSAsyncClient(AWSCredentialsProvider awsCredentialsProvider, ExecutorService executorService) {
227
         this(awsCredentialsProvider, new ClientConfiguration(), executorService);
228
     }

    
Constructs a new asynchronous client to invoke service methods on AmazonRDS using the specified AWS account credentials provider and client configuration options.

All calls made using this new client object are non-blocking, and will immediately return a Java Future object that the caller can later check to see if the service call has actually completed.

Parameters:
awsCredentialsProvider The AWS credentials provider which will provide credentials to authenticate requests with AWS services.
clientConfiguration Client configuration options (ex: max retry limit, proxy settings, etc).
246
 
247
     public AmazonRDSAsyncClient(AWSCredentialsProvider awsCredentialsProvider,
248
                 ClientConfiguration clientConfiguration) {
249
         this(awsCredentialsProvider, clientConfiguration, Executors.newFixedThreadPool(clientConfiguration.getMaxConnections()));
250
     }

    
Constructs a new asynchronous client to invoke service methods on AmazonRDS using the specified AWS account credentials provider, executor service, and client configuration options.

All calls made using this new client object are non-blocking, and will immediately return a Java Future object that the caller can later check to see if the service call has actually completed.

Parameters:
awsCredentialsProvider The AWS credentials provider which will provide credentials to authenticate requests with AWS services.
clientConfiguration Client configuration options (ex: max retry limit, proxy settings, etc).
executorService The executor service by which all asynchronous requests will be executed.
271
 
272
     public AmazonRDSAsyncClient(AWSCredentialsProvider awsCredentialsProvider,
273
                 ClientConfiguration clientConfiguration, ExecutorService executorService) {
274
         super(awsCredentialsProvider, clientConfiguration);
275
         this. = executorService;
276
     }

    
Returns the executor service used by this async client to execute requests.

Returns:
The executor service used by this async client to execute requests.
284
 
285
     public ExecutorService getExecutorService() {
286
         return ;
287
     }

    
Shuts down the client, releasing all managed resources. This includes forcibly terminating all pending asynchronous service calls. Clients who wish to give pending asynchronous service calls time to complete should call getExecutorService().shutdown() followed by getExecutorService().awaitTermination() prior to calling this method. 
295
 
296
     @Override
297
     public void shutdown() {
298
         super.shutdown();
299
         .shutdownNow();
300
     }
            
    

Deletes a DB subnet group.

NOTE:The specified database subnet group must not be associated with any DB instances.

Parameters:
deleteDBSubnetGroupRequest Container for the necessary parameters to execute the DeleteDBSubnetGroup operation on AmazonRDS.
Returns:
A Java Future object containing the response from the DeleteDBSubnetGroup service method, as returned by AmazonRDS.
Throws:
com.amazonaws.AmazonClientException If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRDS indicating either a problem with the data in the request, or a server side issue.
325
 
326
     public Future<Void> deleteDBSubnetGroupAsync(final DeleteDBSubnetGroupRequest deleteDBSubnetGroupRequest) 
327
             throws AmazonServiceException, AmazonClientException {
328
         return .submit(new Callable<Void>() {
329
             public Void call() throws Exception {
330
                 deleteDBSubnetGroup(deleteDBSubnetGroupRequest);
331
                 return null;
332
         }
333
     });
334
     }

    

Deletes a DB subnet group.

NOTE:The specified database subnet group must not be associated with any DB instances.

Parameters:
deleteDBSubnetGroupRequest Container for the necessary parameters to execute the DeleteDBSubnetGroup operation on AmazonRDS.
asyncHandler Asynchronous callback handler for events in the life-cycle of the request. Users could provide the implementation of the four callback methods in this interface to process the operation result or handle the exception.
Returns:
A Java Future object containing the response from the DeleteDBSubnetGroup service method, as returned by AmazonRDS.
Throws:
com.amazonaws.AmazonClientException If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRDS indicating either a problem with the data in the request, or a server side issue.
363
 
365
             final DeleteDBSubnetGroupRequest deleteDBSubnetGroupRequest,
366
             final AsyncHandler<DeleteDBSubnetGroupRequest, Void> asyncHandler)
367
                     throws AmazonServiceException, AmazonClientException {
368
         return .submit(new Callable<Void>() {
369
             public Void call() throws Exception {
370
               try {
371
                 deleteDBSubnetGroup(deleteDBSubnetGroupRequest);
372
               } catch (Exception ex) {
373
                   asyncHandler.onError(ex);
374
             throw ex;
375
               }
376
               asyncHandler.onSuccess(deleteDBSubnetGroupRequest, null);
377
                  return null;
378
         }
379
     });
380
     }
    
    

Copies the specified option group.

Parameters:
copyOptionGroupRequest Container for the necessary parameters to execute the CopyOptionGroup operation on AmazonRDS.
Returns:
A Java Future object containing the response from the CopyOptionGroup service method, as returned by AmazonRDS.
Throws:
com.amazonaws.AmazonClientException If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRDS indicating either a problem with the data in the request, or a server side issue.
401
 
402
     public Future<OptionGroup> copyOptionGroupAsync(final CopyOptionGroupRequest copyOptionGroupRequest) 
403
             throws AmazonServiceException, AmazonClientException {
404
         return .submit(new Callable<OptionGroup>() {
405
             public OptionGroup call() throws Exception {
406
                 return copyOptionGroup(copyOptionGroupRequest);
407
         }
408
     });
409
     }

    

Copies the specified option group.

Parameters:
copyOptionGroupRequest Container for the necessary parameters to execute the CopyOptionGroup operation on AmazonRDS.
asyncHandler Asynchronous callback handler for events in the life-cycle of the request. Users could provide the implementation of the four callback methods in this interface to process the operation result or handle the exception.
Returns:
A Java Future object containing the response from the CopyOptionGroup service method, as returned by AmazonRDS.
Throws:
com.amazonaws.AmazonClientException If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRDS indicating either a problem with the data in the request, or a server side issue.
434
 
436
             final CopyOptionGroupRequest copyOptionGroupRequest,
437
             final AsyncHandler<CopyOptionGroupRequest, OptionGroup> asyncHandler)
438
                     throws AmazonServiceException, AmazonClientException {
439
         return .submit(new Callable<OptionGroup>() {
440
             public OptionGroup call() throws Exception {
441
               OptionGroup result;
442
                 try {
443
                 result = copyOptionGroup(copyOptionGroupRequest);
444
               } catch (Exception ex) {
445
                   asyncHandler.onError(ex);
446
             throw ex;
447
               }
448
               asyncHandler.onSuccess(copyOptionGroupRequest, result);
449
                  return result;
450
         }
451
     });
452
     }
    
    

Restores a DB instance to an arbitrary point-in-time. Users can restore to any point in time before the LatestRestorableTime for up to BackupRetentionPeriod days. The target database is created from the source database with the same configuration as the original database except that the DB instance is created with the default DB security group.

Parameters:
restoreDBInstanceToPointInTimeRequest Container for the necessary parameters to execute the RestoreDBInstanceToPointInTime operation on AmazonRDS.
Returns:
A Java Future object containing the response from the RestoreDBInstanceToPointInTime service method, as returned by AmazonRDS.
Throws:
com.amazonaws.AmazonClientException If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRDS indicating either a problem with the data in the request, or a server side issue.
480
 
481
     public Future<DBInstance> restoreDBInstanceToPointInTimeAsync(final RestoreDBInstanceToPointInTimeRequest restoreDBInstanceToPointInTimeRequest) 
482
             throws AmazonServiceException, AmazonClientException {
483
         return .submit(new Callable<DBInstance>() {
484
             public DBInstance call() throws Exception {
485
                 return restoreDBInstanceToPointInTime(restoreDBInstanceToPointInTimeRequest);
486
         }
487
     });
488
     }

    

Restores a DB instance to an arbitrary point-in-time. Users can restore to any point in time before the LatestRestorableTime for up to BackupRetentionPeriod days. The target database is created from the source database with the same configuration as the original database except that the DB instance is created with the default DB security group.

Parameters:
restoreDBInstanceToPointInTimeRequest Container for the necessary parameters to execute the RestoreDBInstanceToPointInTime operation on AmazonRDS.
asyncHandler Asynchronous callback handler for events in the life-cycle of the request. Users could provide the implementation of the four callback methods in this interface to process the operation result or handle the exception.
Returns:
A Java Future object containing the response from the RestoreDBInstanceToPointInTime service method, as returned by AmazonRDS.
Throws:
com.amazonaws.AmazonClientException If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRDS indicating either a problem with the data in the request, or a server side issue.
520
 
522
             final RestoreDBInstanceToPointInTimeRequest restoreDBInstanceToPointInTimeRequest,
523
             final AsyncHandler<RestoreDBInstanceToPointInTimeRequest, DBInstance> asyncHandler)
524
                     throws AmazonServiceException, AmazonClientException {
525
         return .submit(new Callable<DBInstance>() {
526
             public DBInstance call() throws Exception {
527
               DBInstance result;
528
                 try {
529
                 result = restoreDBInstanceToPointInTime(restoreDBInstanceToPointInTimeRequest);
530
               } catch (Exception ex) {
531
                   asyncHandler.onError(ex);
532
             throw ex;
533
               }
534
               asyncHandler.onSuccess(restoreDBInstanceToPointInTimeRequest, result);
535
                  return result;
536
         }
537
     });
538
     }
    
    

Copies the specified DBSnapshot. The source DBSnapshot must be in the "available" state.

Parameters:
copyDBSnapshotRequest Container for the necessary parameters to execute the CopyDBSnapshot operation on AmazonRDS.
Returns:
A Java Future object containing the response from the CopyDBSnapshot service method, as returned by AmazonRDS.
Throws:
com.amazonaws.AmazonClientException If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRDS indicating either a problem with the data in the request, or a server side issue.
560
 
561
     public Future<DBSnapshot> copyDBSnapshotAsync(final CopyDBSnapshotRequest copyDBSnapshotRequest) 
562
             throws AmazonServiceException, AmazonClientException {
563
         return .submit(new Callable<DBSnapshot>() {
564
             public DBSnapshot call() throws Exception {
565
                 return copyDBSnapshot(copyDBSnapshotRequest);
566
         }
567
     });
568
     }

    

Copies the specified DBSnapshot. The source DBSnapshot must be in the "available" state.

Parameters:
copyDBSnapshotRequest Container for the necessary parameters to execute the CopyDBSnapshot operation on AmazonRDS.
asyncHandler Asynchronous callback handler for events in the life-cycle of the request. Users could provide the implementation of the four callback methods in this interface to process the operation result or handle the exception.
Returns:
A Java Future object containing the response from the CopyDBSnapshot service method, as returned by AmazonRDS.
Throws:
com.amazonaws.AmazonClientException If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRDS indicating either a problem with the data in the request, or a server side issue.
594
 
596
             final CopyDBSnapshotRequest copyDBSnapshotRequest,
597
             final AsyncHandler<CopyDBSnapshotRequest, DBSnapshot> asyncHandler)
598
                     throws AmazonServiceException, AmazonClientException {
599
         return .submit(new Callable<DBSnapshot>() {
600
             public DBSnapshot call() throws Exception {
601
               DBSnapshot result;
602
                 try {
603
                 result = copyDBSnapshot(copyDBSnapshotRequest);
604
               } catch (Exception ex) {
605
                   asyncHandler.onError(ex);
606
             throw ex;
607
               }
608
               asyncHandler.onSuccess(copyDBSnapshotRequest, result);
609
                  return result;
610
         }
611
     });
612
     }
    
    

Returns a list of resources (for example, DB instances) that have at least one pending maintenance action.

Parameters:
describePendingMaintenanceActionsRequest Container for the necessary parameters to execute the DescribePendingMaintenanceActions operation on AmazonRDS.
Returns:
A Java Future object containing the response from the DescribePendingMaintenanceActions service method, as returned by AmazonRDS.
Throws:
com.amazonaws.AmazonClientException If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRDS indicating either a problem with the data in the request, or a server side issue.
636
 
638
             throws AmazonServiceException, AmazonClientException {
640
             public DescribePendingMaintenanceActionsResult call() throws Exception {
641
                 return describePendingMaintenanceActions(describePendingMaintenanceActionsRequest);
642
         }
643
     });
644
     }

    

Returns a list of resources (for example, DB instances) that have at least one pending maintenance action.

Parameters:
describePendingMaintenanceActionsRequest Container for the necessary parameters to execute the DescribePendingMaintenanceActions operation on AmazonRDS.
asyncHandler Asynchronous callback handler for events in the life-cycle of the request. Users could provide the implementation of the four callback methods in this interface to process the operation result or handle the exception.
Returns:
A Java Future object containing the response from the DescribePendingMaintenanceActions service method, as returned by AmazonRDS.
Throws:
com.amazonaws.AmazonClientException If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRDS indicating either a problem with the data in the request, or a server side issue.
672
 
674
             final DescribePendingMaintenanceActionsRequest describePendingMaintenanceActionsRequest,
676
                     throws AmazonServiceException, AmazonClientException {
678
             public DescribePendingMaintenanceActionsResult call() throws Exception {
679
               DescribePendingMaintenanceActionsResult result;
680
                 try {
681
                 result = describePendingMaintenanceActions(describePendingMaintenanceActionsRequest);
682
               } catch (Exception ex) {
683
                   asyncHandler.onError(ex);
684
             throw ex;
685
               }
686
               asyncHandler.onSuccess(describePendingMaintenanceActionsRequest, result);
687
                  return result;
688
         }
689
     });
690
     }
    
    

Creates a new DB instance.

Parameters:
createDBInstanceRequest Container for the necessary parameters to execute the CreateDBInstance operation on AmazonRDS.
Returns:
A Java Future object containing the response from the CreateDBInstance service method, as returned by AmazonRDS.
Throws:
com.amazonaws.AmazonClientException If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRDS indicating either a problem with the data in the request, or a server side issue.
711
 
712
     public Future<DBInstance> createDBInstanceAsync(final CreateDBInstanceRequest createDBInstanceRequest) 
713
             throws AmazonServiceException, AmazonClientException {
714
         return .submit(new Callable<DBInstance>() {
715
             public DBInstance call() throws Exception {
716
                 return createDBInstance(createDBInstanceRequest);
717
         }
718
     });
719
     }

    

Creates a new DB instance.

Parameters:
createDBInstanceRequest Container for the necessary parameters to execute the CreateDBInstance operation on AmazonRDS.
asyncHandler Asynchronous callback handler for events in the life-cycle of the request. Users could provide the implementation of the four callback methods in this interface to process the operation result or handle the exception.
Returns:
A Java Future object containing the response from the CreateDBInstance service method, as returned by AmazonRDS.
Throws:
com.amazonaws.AmazonClientException If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRDS indicating either a problem with the data in the request, or a server side issue.
744
 
746
             final CreateDBInstanceRequest createDBInstanceRequest,
747
             final AsyncHandler<CreateDBInstanceRequest, DBInstance> asyncHandler)
748
                     throws AmazonServiceException, AmazonClientException {
749
         return .submit(new Callable<DBInstance>() {
750
             public DBInstance call() throws Exception {
751
               DBInstance result;
752
                 try {
753
                 result = createDBInstance(createDBInstanceRequest);
754
               } catch (Exception ex) {
755
                   asyncHandler.onError(ex);
756
             throw ex;
757
               }
758
               asyncHandler.onSuccess(createDBInstanceRequest, result);
759
                  return result;
760
         }
761
     });
762
     }
    
    

Creates a new DB security group. DB security groups control access to a DB instance.

Parameters:
createDBSecurityGroupRequest Container for the necessary parameters to execute the CreateDBSecurityGroup operation on AmazonRDS.
Returns:
A Java Future object containing the response from the CreateDBSecurityGroup service method, as returned by AmazonRDS.
Throws:
com.amazonaws.AmazonClientException If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRDS indicating either a problem with the data in the request, or a server side issue.
785
 
786
     public Future<DBSecurityGroup> createDBSecurityGroupAsync(final CreateDBSecurityGroupRequest createDBSecurityGroupRequest) 
787
             throws AmazonServiceException, AmazonClientException {
788
         return .submit(new Callable<DBSecurityGroup>() {
789
             public DBSecurityGroup call() throws Exception {
790
                 return createDBSecurityGroup(createDBSecurityGroupRequest);
791
         }
792
     });
793
     }

    

Creates a new DB security group. DB security groups control access to a DB instance.

Parameters:
createDBSecurityGroupRequest Container for the necessary parameters to execute the CreateDBSecurityGroup operation on AmazonRDS.
asyncHandler Asynchronous callback handler for events in the life-cycle of the request. Users could provide the implementation of the four callback methods in this interface to process the operation result or handle the exception.
Returns:
A Java Future object containing the response from the CreateDBSecurityGroup service method, as returned by AmazonRDS.
Throws:
com.amazonaws.AmazonClientException If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRDS indicating either a problem with the data in the request, or a server side issue.
820
 
822
             final CreateDBSecurityGroupRequest createDBSecurityGroupRequest,
823
             final AsyncHandler<CreateDBSecurityGroupRequest, DBSecurityGroup> asyncHandler)
824
                     throws AmazonServiceException, AmazonClientException {
825
         return .submit(new Callable<DBSecurityGroup>() {
826
             public DBSecurityGroup call() throws Exception {
827
               DBSecurityGroup result;
828
                 try {
829
                 result = createDBSecurityGroup(createDBSecurityGroupRequest);
830
               } catch (Exception ex) {
831
                   asyncHandler.onError(ex);
832
             throw ex;
833
               }
834
               asyncHandler.onSuccess(createDBSecurityGroupRequest, result);
835
                  return result;
836
         }
837
     });
838
     }
    
    

Describes the available option groups.

Parameters:
describeOptionGroupsRequest Container for the necessary parameters to execute the DescribeOptionGroups operation on AmazonRDS.
Returns:
A Java Future object containing the response from the DescribeOptionGroups service method, as returned by AmazonRDS.
Throws:
com.amazonaws.AmazonClientException If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRDS indicating either a problem with the data in the request, or a server side issue.
859
 
860
     public Future<DescribeOptionGroupsResult> describeOptionGroupsAsync(final DescribeOptionGroupsRequest describeOptionGroupsRequest) 
861
             throws AmazonServiceException, AmazonClientException {
862
         return .submit(new Callable<DescribeOptionGroupsResult>() {
863
             public DescribeOptionGroupsResult call() throws Exception {
864
                 return describeOptionGroups(describeOptionGroupsRequest);
865
         }
866
     });
867
     }

    

Describes the available option groups.

Parameters:
describeOptionGroupsRequest Container for the necessary parameters to execute the DescribeOptionGroups operation on AmazonRDS.
asyncHandler Asynchronous callback handler for events in the life-cycle of the request. Users could provide the implementation of the four callback methods in this interface to process the operation result or handle the exception.
Returns:
A Java Future object containing the response from the DescribeOptionGroups service method, as returned by AmazonRDS.
Throws:
com.amazonaws.AmazonClientException If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRDS indicating either a problem with the data in the request, or a server side issue.
892
 
894
             final DescribeOptionGroupsRequest describeOptionGroupsRequest,
895
             final AsyncHandler<DescribeOptionGroupsRequest, DescribeOptionGroupsResult> asyncHandler)
896
                     throws AmazonServiceException, AmazonClientException {
897
         return .submit(new Callable<DescribeOptionGroupsResult>() {
898
             public DescribeOptionGroupsResult call() throws Exception {
899
               DescribeOptionGroupsResult result;
900
                 try {
901
                 result = describeOptionGroups(describeOptionGroupsRequest);
902
               } catch (Exception ex) {
903
                   asyncHandler.onError(ex);
904
             throw ex;
905
               }
906
               asyncHandler.onSuccess(describeOptionGroupsRequest, result);
907
                  return result;
908
         }
909
     });
910
     }
    
    

Returns information about provisioned RDS instances. This API supports pagination.

Parameters:
describeDBInstancesRequest Container for the necessary parameters to execute the DescribeDBInstances operation on AmazonRDS.
Returns:
A Java Future object containing the response from the DescribeDBInstances service method, as returned by AmazonRDS.
Throws:
com.amazonaws.AmazonClientException If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRDS indicating either a problem with the data in the request, or a server side issue.
932
 
933
     public Future<DescribeDBInstancesResult> describeDBInstancesAsync(final DescribeDBInstancesRequest describeDBInstancesRequest) 
934
             throws AmazonServiceException, AmazonClientException {
935
         return .submit(new Callable<DescribeDBInstancesResult>() {
936
             public DescribeDBInstancesResult call() throws Exception {
937
                 return describeDBInstances(describeDBInstancesRequest);
938
         }
939
     });
940
     }

    

Returns information about provisioned RDS instances. This API supports pagination.

Parameters:
describeDBInstancesRequest Container for the necessary parameters to execute the DescribeDBInstances operation on AmazonRDS.
asyncHandler Asynchronous callback handler for events in the life-cycle of the request. Users could provide the implementation of the four callback methods in this interface to process the operation result or handle the exception.
Returns:
A Java Future object containing the response from the DescribeDBInstances service method, as returned by AmazonRDS.
Throws:
com.amazonaws.AmazonClientException If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRDS indicating either a problem with the data in the request, or a server side issue.
966
 
968
             final DescribeDBInstancesRequest describeDBInstancesRequest,
969
             final AsyncHandler<DescribeDBInstancesRequest, DescribeDBInstancesResult> asyncHandler)
970
                     throws AmazonServiceException, AmazonClientException {
971
         return .submit(new Callable<DescribeDBInstancesResult>() {
972
             public DescribeDBInstancesResult call() throws Exception {
973
               DescribeDBInstancesResult result;
974
                 try {
975
                 result = describeDBInstances(describeDBInstancesRequest);
976
               } catch (Exception ex) {
977
                   asyncHandler.onError(ex);
978
             throw ex;
979
               }
980
               asyncHandler.onSuccess(describeDBInstancesRequest, result);
981
                  return result;
982
         }
983
     });
984
     }
    
    

Removes a source identifier from an existing RDS event notification subscription.

Parameters:
removeSourceIdentifierFromSubscriptionRequest Container for the necessary parameters to execute the RemoveSourceIdentifierFromSubscription operation on AmazonRDS.
Returns:
A Java Future object containing the response from the RemoveSourceIdentifierFromSubscription service method, as returned by AmazonRDS.
Throws:
com.amazonaws.AmazonClientException If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRDS indicating either a problem with the data in the request, or a server side issue.
1009
    public Future<EventSubscription> removeSourceIdentifierFromSubscriptionAsync(final RemoveSourceIdentifierFromSubscriptionRequest removeSourceIdentifierFromSubscriptionRequest) 
1010
            throws AmazonServiceException, AmazonClientException {
1011
        return .submit(new Callable<EventSubscription>() {
1012
            public EventSubscription call() throws Exception {
1013
                return removeSourceIdentifierFromSubscription(removeSourceIdentifierFromSubscriptionRequest);
1014
        }
1015
    });
1016
    }

    

Removes a source identifier from an existing RDS event notification subscription.

Parameters:
removeSourceIdentifierFromSubscriptionRequest Container for the necessary parameters to execute the RemoveSourceIdentifierFromSubscription operation on AmazonRDS.
asyncHandler Asynchronous callback handler for events in the life-cycle of the request. Users could provide the implementation of the four callback methods in this interface to process the operation result or handle the exception.
Returns:
A Java Future object containing the response from the RemoveSourceIdentifierFromSubscription service method, as returned by AmazonRDS.
Throws:
com.amazonaws.AmazonClientException If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRDS indicating either a problem with the data in the request, or a server side issue.
1046
            final RemoveSourceIdentifierFromSubscriptionRequest removeSourceIdentifierFromSubscriptionRequest,
1048
                    throws AmazonServiceException, AmazonClientException {
1049
        return .submit(new Callable<EventSubscription>() {
1050
            public EventSubscription call() throws Exception {
1051
              EventSubscription result;
1052
                try {
1053
                result = removeSourceIdentifierFromSubscription(removeSourceIdentifierFromSubscriptionRequest);
1054
              } catch (Exception ex) {
1055
                  asyncHandler.onError(ex);
1056
            throw ex;
1057
              }
1058
              asyncHandler.onSuccess(removeSourceIdentifierFromSubscriptionRequest, result);
1059
                 return result;
1060
        }
1061
    });
1062
    }
    
    

Deletes a DB security group.

NOTE:The specified DB security group must not be associated with any DB instances.

Parameters:
deleteDBSecurityGroupRequest Container for the necessary parameters to execute the DeleteDBSecurityGroup operation on AmazonRDS.
Returns:
A Java Future object containing the response from the DeleteDBSecurityGroup service method, as returned by AmazonRDS.
Throws:
com.amazonaws.AmazonClientException If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRDS indicating either a problem with the data in the request, or a server side issue.
1089
    public Future<Void> deleteDBSecurityGroupAsync(final DeleteDBSecurityGroupRequest deleteDBSecurityGroupRequest) 
1090
            throws AmazonServiceException, AmazonClientException {
1091
        return .submit(new Callable<Void>() {
1092
            public Void call() throws Exception {
1093
                deleteDBSecurityGroup(deleteDBSecurityGroupRequest);
1094
                return null;
1095
        }
1096
    });
1097
    }

    

Deletes a DB security group.

NOTE:The specified DB security group must not be associated with any DB instances.

Parameters:
deleteDBSecurityGroupRequest Container for the necessary parameters to execute the DeleteDBSecurityGroup operation on AmazonRDS.
asyncHandler Asynchronous callback handler for events in the life-cycle of the request. Users could provide the implementation of the four callback methods in this interface to process the operation result or handle the exception.
Returns:
A Java Future object containing the response from the DeleteDBSecurityGroup service method, as returned by AmazonRDS.
Throws:
com.amazonaws.AmazonClientException If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRDS indicating either a problem with the data in the request, or a server side issue.
1129
            final DeleteDBSecurityGroupRequest deleteDBSecurityGroupRequest,
1130
            final AsyncHandler<DeleteDBSecurityGroupRequest, Void> asyncHandler)
1131
                    throws AmazonServiceException, AmazonClientException {
1132
        return .submit(new Callable<Void>() {
1133
            public Void call() throws Exception {
1134
              try {
1135
                deleteDBSecurityGroup(deleteDBSecurityGroupRequest);
1136
              } catch (Exception ex) {
1137
                  asyncHandler.onError(ex);
1138
            throw ex;
1139
              }
1140
              asyncHandler.onSuccess(deleteDBSecurityGroupRequest, null);
1141
                 return null;
1142
        }
1143
    });
1144
    }
    
    

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

NOTE: You cannot authorize ingress from an EC2 security group in one Region to an Amazon RDS DB instance in another. You cannot 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 .

Parameters:
authorizeDBSecurityGroupIngressRequest Container for the necessary parameters to execute the AuthorizeDBSecurityGroupIngress operation on AmazonRDS.
Returns:
A Java Future object containing the response from the AuthorizeDBSecurityGroupIngress service method, as returned by AmazonRDS.
Throws:
com.amazonaws.AmazonClientException If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRDS indicating either a problem with the data in the request, or a server side issue.
1186
    public Future<DBSecurityGroup> authorizeDBSecurityGroupIngressAsync(final AuthorizeDBSecurityGroupIngressRequest authorizeDBSecurityGroupIngressRequest) 
1187
            throws AmazonServiceException, AmazonClientException {
1188
        return .submit(new Callable<DBSecurityGroup>() {
1189
            public DBSecurityGroup call() throws Exception {
1190
                return authorizeDBSecurityGroupIngress(authorizeDBSecurityGroupIngressRequest);
1191
        }
1192
    });
1193
    }

    

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

NOTE: You cannot authorize ingress from an EC2 security group in one Region to an Amazon RDS DB instance in another. You cannot 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 .

Parameters:
authorizeDBSecurityGroupIngressRequest Container for the necessary parameters to execute the AuthorizeDBSecurityGroupIngress operation on AmazonRDS.
asyncHandler Asynchronous callback handler for events in the life-cycle of the request. Users could provide the implementation of the four callback methods in this interface to process the operation result or handle the exception.
Returns:
A Java Future object containing the response from the AuthorizeDBSecurityGroupIngress service method, as returned by AmazonRDS.
Throws:
com.amazonaws.AmazonClientException If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRDS indicating either a problem with the data in the request, or a server side issue.
1240
            final AuthorizeDBSecurityGroupIngressRequest authorizeDBSecurityGroupIngressRequest,
1241
            final AsyncHandler<AuthorizeDBSecurityGroupIngressRequest, DBSecurityGroup> asyncHandler)
1242
                    throws AmazonServiceException, AmazonClientException {
1243
        return .submit(new Callable<DBSecurityGroup>() {
1244
            public DBSecurityGroup call() throws Exception {
1245
              DBSecurityGroup result;
1246
                try {
1247
                result = authorizeDBSecurityGroupIngress(authorizeDBSecurityGroupIngressRequest);
1248
              } catch (Exception ex) {
1249
                  asyncHandler.onError(ex);
1250
            throw ex;
1251
              }
1252
              asyncHandler.onSuccess(authorizeDBSecurityGroupIngressRequest, result);
1253
                 return result;
1254
        }
1255
    });
1256
    }
    
    

Applies a pending maintenance action to a resource (for example, a DB instance).

Parameters:
applyPendingMaintenanceActionRequest Container for the necessary parameters to execute the ApplyPendingMaintenanceAction operation on AmazonRDS.
Returns:
A Java Future object containing the response from the ApplyPendingMaintenanceAction service method, as returned by AmazonRDS.
Throws:
com.amazonaws.AmazonClientException If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRDS indicating either a problem with the data in the request, or a server side issue.
1282
            throws AmazonServiceException, AmazonClientException {
1284
            public ResourcePendingMaintenanceActions call() throws Exception {
1285
                return applyPendingMaintenanceAction(applyPendingMaintenanceActionRequest);
1286
        }
1287
    });
1288
    }

    

Applies a pending maintenance action to a resource (for example, a DB instance).

Parameters:
applyPendingMaintenanceActionRequest Container for the necessary parameters to execute the ApplyPendingMaintenanceAction operation on AmazonRDS.
asyncHandler Asynchronous callback handler for events in the life-cycle of the request. Users could provide the implementation of the four callback methods in this interface to process the operation result or handle the exception.
Returns:
A Java Future object containing the response from the ApplyPendingMaintenanceAction service method, as returned by AmazonRDS.
Throws:
com.amazonaws.AmazonClientException If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRDS indicating either a problem with the data in the request, or a server side issue.
1318
            final ApplyPendingMaintenanceActionRequest applyPendingMaintenanceActionRequest,
1320
                    throws AmazonServiceException, AmazonClientException {
1322
            public ResourcePendingMaintenanceActions call() throws Exception {
1323
              ResourcePendingMaintenanceActions result;
1324
                try {
1325
                result = applyPendingMaintenanceAction(applyPendingMaintenanceActionRequest);
1326
              } catch (Exception ex) {
1327
                  asyncHandler.onError(ex);
1328
            throw ex;
1329
              }
1330
              asyncHandler.onSuccess(applyPendingMaintenanceActionRequest, result);
1331
                 return result;
1332
        }
1333
    });
1334
    }
    
    

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

Parameters:
modifyDBInstanceRequest Container for the necessary parameters to execute the ModifyDBInstance operation on AmazonRDS.
Returns:
A Java Future object containing the response from the ModifyDBInstance service method, as returned by AmazonRDS.
Throws:
com.amazonaws.AmazonClientException If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRDS indicating either a problem with the data in the request, or a server side issue.
1358
    public Future<DBInstance> modifyDBInstanceAsync(final ModifyDBInstanceRequest modifyDBInstanceRequest) 
1359
            throws AmazonServiceException, AmazonClientException {
1360
        return .submit(new Callable<DBInstance>() {
1361
            public DBInstance call() throws Exception {
1362
                return modifyDBInstance(modifyDBInstanceRequest);
1363
        }
1364
    });
1365
    }

    

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

Parameters:
modifyDBInstanceRequest Container for the necessary parameters to execute the ModifyDBInstance operation on AmazonRDS.
asyncHandler Asynchronous callback handler for events in the life-cycle of the request. Users could provide the implementation of the four callback methods in this interface to process the operation result or handle the exception.
Returns:
A Java Future object containing the response from the ModifyDBInstance service method, as returned by AmazonRDS.
Throws:
com.amazonaws.AmazonClientException If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRDS indicating either a problem with the data in the request, or a server side issue.
1394
            final ModifyDBInstanceRequest modifyDBInstanceRequest,
1395
            final AsyncHandler<ModifyDBInstanceRequest, DBInstance> asyncHandler)
1396
                    throws AmazonServiceException, AmazonClientException {
1397
        return .submit(new Callable<DBInstance>() {
1398
            public DBInstance call() throws Exception {
1399
              DBInstance result;
1400
                try {
1401
                result = modifyDBInstance(modifyDBInstanceRequest);
1402
              } catch (Exception ex) {
1403
                  asyncHandler.onError(ex);
1404
            throw ex;
1405
              }
1406
              asyncHandler.onSuccess(modifyDBInstanceRequest, result);
1407
                 return result;
1408
        }
1409
    });
1410
    }
    
    

Deletes an RDS event notification subscription.

Parameters:
deleteEventSubscriptionRequest Container for the necessary parameters to execute the DeleteEventSubscription operation on AmazonRDS.
Returns:
A Java Future object containing the response from the DeleteEventSubscription service method, as returned by AmazonRDS.
Throws:
com.amazonaws.AmazonClientException If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRDS indicating either a problem with the data in the request, or a server side issue.
1433
    public Future<EventSubscription> deleteEventSubscriptionAsync(final DeleteEventSubscriptionRequest deleteEventSubscriptionRequest) 
1434
            throws AmazonServiceException, AmazonClientException {
1435
        return .submit(new Callable<EventSubscription>() {
1436
            public EventSubscription call() throws Exception {
1437
                return deleteEventSubscription(deleteEventSubscriptionRequest);
1438
        }
1439
    });
1440
    }

    

Deletes an RDS event notification subscription.

Parameters:
deleteEventSubscriptionRequest Container for the necessary parameters to execute the DeleteEventSubscription operation on AmazonRDS.
asyncHandler Asynchronous callback handler for events in the life-cycle of the request. Users could provide the implementation of the four callback methods in this interface to process the operation result or handle the exception.
Returns:
A Java Future object containing the response from the DeleteEventSubscription service method, as returned by AmazonRDS.
Throws:
com.amazonaws.AmazonClientException If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRDS indicating either a problem with the data in the request, or a server side issue.
1468
            final DeleteEventSubscriptionRequest deleteEventSubscriptionRequest,
1469
            final AsyncHandler<DeleteEventSubscriptionRequest, EventSubscription> asyncHandler)
1470
                    throws AmazonServiceException, AmazonClientException {
1471
        return .submit(new Callable<EventSubscription>() {
1472
            public EventSubscription call() throws Exception {
1473
              EventSubscription result;
1474
                try {
1475
                result = deleteEventSubscription(deleteEventSubscriptionRequest);
1476
              } catch (Exception ex) {
1477
                  asyncHandler.onError(ex);
1478
            throw ex;
1479
              }
1480
              asyncHandler.onSuccess(deleteEventSubscriptionRequest, result);
1481
                 return result;
1482
        }
1483
    });
1484
    }
    
    

Removes metadata tags from an Amazon RDS resource.

For an overview on tagging an Amazon RDS resource, see Tagging Amazon RDS Resources .

Parameters:
removeTagsFromResourceRequest Container for the necessary parameters to execute the RemoveTagsFromResource operation on AmazonRDS.
Returns:
A Java Future object containing the response from the RemoveTagsFromResource service method, as returned by AmazonRDS.
Throws:
com.amazonaws.AmazonClientException If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRDS indicating either a problem with the data in the request, or a server side issue.
1512
    public Future<Void> removeTagsFromResourceAsync(final RemoveTagsFromResourceRequest removeTagsFromResourceRequest) 
1513
            throws AmazonServiceException, AmazonClientException {
1514
        return .submit(new Callable<Void>() {
1515
            public Void call() throws Exception {
1516
                removeTagsFromResource(removeTagsFromResourceRequest);
1517
                return null;
1518
        }
1519
    });
1520
    }

    

Removes metadata tags from an Amazon RDS resource.

For an overview on tagging an Amazon RDS resource, see Tagging Amazon RDS Resources .

Parameters:
removeTagsFromResourceRequest Container for the necessary parameters to execute the RemoveTagsFromResource operation on AmazonRDS.
asyncHandler Asynchronous callback handler for events in the life-cycle of the request. Users could provide the implementation of the four callback methods in this interface to process the operation result or handle the exception.
Returns:
A Java Future object containing the response from the RemoveTagsFromResource service method, as returned by AmazonRDS.
Throws:
com.amazonaws.AmazonClientException If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRDS indicating either a problem with the data in the request, or a server side issue.
1553
            final RemoveTagsFromResourceRequest removeTagsFromResourceRequest,
1554
            final AsyncHandler<RemoveTagsFromResourceRequest, Void> asyncHandler)
1555
                    throws AmazonServiceException, AmazonClientException {
1556
        return .submit(new Callable<Void>() {
1557
            public Void call() throws Exception {
1558
              try {
1559
                removeTagsFromResource(removeTagsFromResourceRequest);
1560
              } catch (Exception ex) {
1561
                  asyncHandler.onError(ex);
1562
            throw ex;
1563
              }
1564
              asyncHandler.onSuccess(removeTagsFromResourceRequest, null);
1565
                 return null;
1566
        }
1567
    });
1568
    }
    
    

Displays a list of categories for all event source types, or, if specified, for a specified source type. You can see a list of the event categories and source types in the Events topic in the Amazon RDS User Guide.

Parameters:
describeEventCategoriesRequest Container for the necessary parameters to execute the DescribeEventCategories operation on AmazonRDS.
Returns:
A Java Future object containing the response from the DescribeEventCategories service method, as returned by AmazonRDS.
Throws:
com.amazonaws.AmazonClientException If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRDS indicating either a problem with the data in the request, or a server side issue.
1596
            throws AmazonServiceException, AmazonClientException {
1598
            public DescribeEventCategoriesResult call() throws Exception {
1599
                return describeEventCategories(describeEventCategoriesRequest);
1600
        }
1601
    });
1602
    }

    

Displays a list of categories for all event source types, or, if specified, for a specified source type. You can see a list of the event categories and source types in the Events topic in the Amazon RDS User Guide.

Parameters:
describeEventCategoriesRequest Container for the necessary parameters to execute the DescribeEventCategories operation on AmazonRDS.
asyncHandler Asynchronous callback handler for events in the life-cycle of the request. Users could provide the implementation of the four callback methods in this interface to process the operation result or handle the exception.
Returns:
A Java Future object containing the response from the DescribeEventCategories service method, as returned by AmazonRDS.
Throws:
com.amazonaws.AmazonClientException If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRDS indicating either a problem with the data in the request, or a server side issue.
1634
            final DescribeEventCategoriesRequest describeEventCategoriesRequest,
1635
            final AsyncHandler<DescribeEventCategoriesRequest, DescribeEventCategoriesResult> asyncHandler)
1636
                    throws AmazonServiceException, AmazonClientException {
1638
            public DescribeEventCategoriesResult call() throws Exception {
1639
              DescribeEventCategoriesResult result;
1640
                try {
1641
                result = describeEventCategories(describeEventCategoriesRequest);
1642
              } catch (Exception ex) {
1643
                  asyncHandler.onError(ex);
1644
            throw ex;
1645
              }
1646
              asyncHandler.onSuccess(describeEventCategoriesRequest, result);
1647
                 return result;
1648
        }
1649
    });
1650
    }
    
    

Copies the specified DB parameter group.

Parameters:
copyDBParameterGroupRequest Container for the necessary parameters to execute the CopyDBParameterGroup operation on AmazonRDS.
Returns:
A Java Future object containing the response from the CopyDBParameterGroup service method, as returned by AmazonRDS.
Throws:
com.amazonaws.AmazonClientException If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRDS indicating either a problem with the data in the request, or a server side issue.
1672
    public Future<DBParameterGroup> copyDBParameterGroupAsync(final CopyDBParameterGroupRequest copyDBParameterGroupRequest) 
1673
            throws AmazonServiceException, AmazonClientException {
1674
        return .submit(new Callable<DBParameterGroup>() {
1675
            public DBParameterGroup call() throws Exception {
1676
                return copyDBParameterGroup(copyDBParameterGroupRequest);
1677
        }
1678
    });
1679
    }

    

Copies the specified DB parameter group.

Parameters:
copyDBParameterGroupRequest Container for the necessary parameters to execute the CopyDBParameterGroup operation on AmazonRDS.
asyncHandler Asynchronous callback handler for events in the life-cycle of the request. Users could provide the implementation of the four callback methods in this interface to process the operation result or handle the exception.
Returns:
A Java Future object containing the response from the CopyDBParameterGroup service method, as returned by AmazonRDS.
Throws:
com.amazonaws.AmazonClientException If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRDS indicating either a problem with the data in the request, or a server side issue.
1706
            final CopyDBParameterGroupRequest copyDBParameterGroupRequest,
1707
            final AsyncHandler<CopyDBParameterGroupRequest, DBParameterGroup> asyncHandler)
1708
                    throws AmazonServiceException, AmazonClientException {
1709
        return .submit(new Callable<DBParameterGroup>() {
1710
            public DBParameterGroup call() throws Exception {
1711
              DBParameterGroup result;
1712
                try {
1713
                result = copyDBParameterGroup(copyDBParameterGroupRequest);
1714
              } catch (Exception ex) {
1715
                  asyncHandler.onError(ex);
1716
            throw ex;
1717
              }
1718
              asyncHandler.onSuccess(copyDBParameterGroupRequest, result);
1719
                 return result;
1720
        }
1721
    });
1722
    }
    
    

Creates a DB instance that acts as a Read Replica of a source DB instance.

All Read Replica DB instances are created as Single-AZ deployments with backups disabled. All other DB instance attributes (including DB security groups and DB parameter groups) are inherited from the source DB instance, except as specified below.

IMPORTANT: The source DB instance must have backup retention enabled.

Parameters:
createDBInstanceReadReplicaRequest Container for the necessary parameters to execute the CreateDBInstanceReadReplica operation on AmazonRDS.
Returns:
A Java Future object containing the response from the CreateDBInstanceReadReplica service method, as returned by AmazonRDS.
Throws:
com.amazonaws.AmazonClientException If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRDS indicating either a problem with the data in the request, or a server side issue.
1756
    public Future<DBInstance> createDBInstanceReadReplicaAsync(final CreateDBInstanceReadReplicaRequest createDBInstanceReadReplicaRequest) 
1757
            throws AmazonServiceException, AmazonClientException {
1758
        return .submit(new Callable<DBInstance>() {
1759
            public DBInstance call() throws Exception {
1760
                return createDBInstanceReadReplica(createDBInstanceReadReplicaRequest);
1761
        }
1762
    });
1763
    }

    

Creates a DB instance that acts as a Read Replica of a source DB instance.

All Read Replica DB instances are created as Single-AZ deployments with backups disabled. All other DB instance attributes (including DB security groups and DB parameter groups) are inherited from the source DB instance, except as specified below.

IMPORTANT: The source DB instance must have backup retention enabled.

Parameters:
createDBInstanceReadReplicaRequest Container for the necessary parameters to execute the CreateDBInstanceReadReplica operation on AmazonRDS.
asyncHandler Asynchronous callback handler for events in the life-cycle of the request. Users could provide the implementation of the four callback methods in this interface to process the operation result or handle the exception.
Returns:
A Java Future object containing the response from the CreateDBInstanceReadReplica service method, as returned by AmazonRDS.
Throws:
com.amazonaws.AmazonClientException If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRDS indicating either a problem with the data in the request, or a server side issue.
1802
            final CreateDBInstanceReadReplicaRequest createDBInstanceReadReplicaRequest,
1803
            final AsyncHandler<CreateDBInstanceReadReplicaRequest, DBInstance> asyncHandler)
1804
                    throws AmazonServiceException, AmazonClientException {
1805
        return .submit(new Callable<DBInstance>() {
1806
            public DBInstance call() throws Exception {
1807
              DBInstance result;
1808
                try {
1809
                result = createDBInstanceReadReplica(createDBInstanceReadReplicaRequest);
1810
              } catch (Exception ex) {
1811
                  asyncHandler.onError(ex);
1812
            throw ex;
1813
              }
1814
              asyncHandler.onSuccess(createDBInstanceReadReplicaRequest, result);
1815
                 return result;
1816
        }
1817
    });
1818
    }
    
    

Deletes a DBSnapshot. If the snapshot is being copied, the copy operation is terminated.

NOTE:The DBSnapshot must be in the available state to be deleted.

Parameters:
deleteDBSnapshotRequest Container for the necessary parameters to execute the DeleteDBSnapshot operation on AmazonRDS.
Returns:
A Java Future object containing the response from the DeleteDBSnapshot service method, as returned by AmazonRDS.
Throws:
com.amazonaws.AmazonClientException If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRDS indicating either a problem with the data in the request, or a server side issue.
1845
    public Future<DBSnapshot> deleteDBSnapshotAsync(final DeleteDBSnapshotRequest deleteDBSnapshotRequest) 
1846
            throws AmazonServiceException, AmazonClientException {
1847
        return .submit(new Callable<DBSnapshot>() {
1848
            public DBSnapshot call() throws Exception {
1849
                return deleteDBSnapshot(deleteDBSnapshotRequest);
1850
        }
1851
    });
1852
    }

    

Deletes a DBSnapshot. If the snapshot is being copied, the copy operation is terminated.

NOTE:The DBSnapshot must be in the available state to be deleted.

Parameters:
deleteDBSnapshotRequest Container for the necessary parameters to execute the DeleteDBSnapshot operation on AmazonRDS.
asyncHandler Asynchronous callback handler for events in the life-cycle of the request. Users could provide the implementation of the four callback methods in this interface to process the operation result or handle the exception.
Returns:
A Java Future object containing the response from the DeleteDBSnapshot service method, as returned by AmazonRDS.
Throws:
com.amazonaws.AmazonClientException If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRDS indicating either a problem with the data in the request, or a server side issue.
1884
            final DeleteDBSnapshotRequest deleteDBSnapshotRequest,
1885
            final AsyncHandler<DeleteDBSnapshotRequest, DBSnapshot> asyncHandler)
1886
                    throws AmazonServiceException, AmazonClientException {
1887
        return .submit(new Callable<DBSnapshot>() {
1888
            public DBSnapshot call() throws Exception {
1889
              DBSnapshot result;
1890
                try {
1891
                result = deleteDBSnapshot(deleteDBSnapshotRequest);
1892
              } catch (Exception ex) {
1893
                  asyncHandler.onError(ex);
1894
            throw ex;
1895
              }
1896
              asyncHandler.onSuccess(deleteDBSnapshotRequest, result);
1897
                 return result;
1898
        }
1899
    });
1900
    }
    
    

Rebooting a DB instance restarts the database engine service. A reboot also applies to the DB instance any modifications to the associated DB parameter group that were pending. Rebooting a DB instance results in a momentary outage of the instance, during which the DB instance status is set to rebooting. If the RDS instance is configured for MultiAZ, it is possible that the reboot will be conducted through a failover. An Amazon RDS event is created when the reboot is completed.

If your DB instance is deployed in multiple Availability Zones, you can force a failover from one AZ to the other during the reboot. You might force a failover to test the availability of your DB instance deployment or to restore operations to the original AZ after a failover occurs.

The time required to reboot is a function of the specific database engine's crash recovery process. To improve the reboot time, we recommend that you reduce database activities as much as possible during the reboot process to reduce rollback activity for in-transit transactions.

Parameters:
rebootDBInstanceRequest Container for the necessary parameters to execute the RebootDBInstance operation on AmazonRDS.
Returns:
A Java Future object containing the response from the RebootDBInstance service method, as returned by AmazonRDS.
Throws:
com.amazonaws.AmazonClientException If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRDS indicating either a problem with the data in the request, or a server side issue.
1943
    public Future<DBInstance> rebootDBInstanceAsync(final RebootDBInstanceRequest rebootDBInstanceRequest) 
1944
            throws AmazonServiceException, AmazonClientException {
1945
        return .submit(new Callable<DBInstance>() {
1946
            public DBInstance call() throws Exception {
1947
                return rebootDBInstance(rebootDBInstanceRequest);
1948
        }
1949
    });
1950
    }

    

Rebooting a DB instance restarts the database engine service. A reboot also applies to the DB instance any modifications to the associated DB parameter group that were pending. Rebooting a DB instance results in a momentary outage of the instance, during which the DB instance status is set to rebooting. If the RDS instance is configured for MultiAZ, it is possible that the reboot will be conducted through a failover. An Amazon RDS event is created when the reboot is completed.

If your DB instance is deployed in multiple Availability Zones, you can force a failover from one AZ to the other during the reboot. You might force a failover to test the availability of your DB instance deployment or to restore operations to the original AZ after a failover occurs.

The time required to reboot is a function of the specific database engine's crash recovery process. To improve the reboot time, we recommend that you reduce database activities as much as possible during the reboot process to reduce rollback activity for in-transit transactions.

Parameters:
rebootDBInstanceRequest Container for the necessary parameters to execute the RebootDBInstance operation on AmazonRDS.
asyncHandler Asynchronous callback handler for events in the life-cycle of the request. Users could provide the implementation of the four callback methods in this interface to process the operation result or handle the exception.
Returns:
A Java Future object containing the response from the RebootDBInstance service method, as returned by AmazonRDS.
Throws:
com.amazonaws.AmazonClientException If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRDS indicating either a problem with the data in the request, or a server side issue.
1998
            final RebootDBInstanceRequest rebootDBInstanceRequest,
1999
            final AsyncHandler<RebootDBInstanceRequest, DBInstance> asyncHandler)
2000
                    throws AmazonServiceException, AmazonClientException {
2001
        return .submit(new Callable<DBInstance>() {
2002
            public DBInstance call() throws Exception {
2003
              DBInstance result;
2004
                try {
2005
                result = rebootDBInstance(rebootDBInstanceRequest);
2006
              } catch (Exception ex) {
2007
                  asyncHandler.onError(ex);
2008
            throw ex;
2009
              }
2010
              asyncHandler.onSuccess(rebootDBInstanceRequest, result);
2011
                 return result;
2012
        }
2013
    });
2014
    }
    
    

Returns events related to DB instances, DB security groups, DB snapshots, and DB parameter groups for the past 14 days. Events specific to a particular DB instance, DB security group, database snapshot, or DB parameter group can be obtained by providing the name as a parameter. By default, the past hour of events are returned.

Parameters:
describeEventsRequest Container for the necessary parameters to execute the DescribeEvents operation on AmazonRDS.
Returns:
A Java Future object containing the response from the DescribeEvents service method, as returned by AmazonRDS.
Throws:
com.amazonaws.AmazonClientException If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRDS indicating either a problem with the data in the request, or a server side issue.
2040
    public Future<DescribeEventsResult> describeEventsAsync(final DescribeEventsRequest describeEventsRequest) 
2041
            throws AmazonServiceException, AmazonClientException {
2042
        return .submit(new Callable<DescribeEventsResult>() {
2043
            public DescribeEventsResult call() throws Exception {
2044
                return describeEvents(describeEventsRequest);
2045
        }
2046
    });
2047
    }

    

Returns events related to DB instances, DB security groups, DB snapshots, and DB parameter groups for the past 14 days. Events specific to a particular DB instance, DB security group, database snapshot, or DB parameter group can be obtained by providing the name as a parameter. By default, the past hour of events are returned.

Parameters:
describeEventsRequest Container for the necessary parameters to execute the DescribeEvents operation on AmazonRDS.
asyncHandler Asynchronous callback handler for events in the life-cycle of the request. Users could provide the implementation of the four callback methods in this interface to process the operation result or handle the exception.
Returns:
A Java Future object containing the response from the DescribeEvents service method, as returned by AmazonRDS.
Throws:
com.amazonaws.AmazonClientException If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRDS indicating either a problem with the data in the request, or a server side issue.
2078
            final DescribeEventsRequest describeEventsRequest,
2079
            final AsyncHandler<DescribeEventsRequest, DescribeEventsResult> asyncHandler)
2080
                    throws AmazonServiceException, AmazonClientException {
2081
        return .submit(new Callable<DescribeEventsResult>() {
2082
            public DescribeEventsResult call() throws Exception {
2083
              DescribeEventsResult result;
2084
                try {
2085
                result = describeEvents(describeEventsRequest);
2086
              } catch (Exception ex) {
2087
                  asyncHandler.onError(ex);
2088
            throw ex;
2089
              }
2090
              asyncHandler.onSuccess(describeEventsRequest, result);
2091
                 return result;
2092
        }
2093
    });
2094
    }
    
    

Lists all tags on an Amazon RDS resource.

For an overview on tagging an Amazon RDS resource, see Tagging Amazon RDS Resources .

Parameters:
listTagsForResourceRequest Container for the necessary parameters to execute the ListTagsForResource operation on AmazonRDS.
Returns:
A Java Future object containing the response from the ListTagsForResource service method, as returned by AmazonRDS.
Throws:
com.amazonaws.AmazonClientException If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRDS indicating either a problem with the data in the request, or a server side issue.
2121
    public Future<ListTagsForResourceResult> listTagsForResourceAsync(final ListTagsForResourceRequest listTagsForResourceRequest) 
2122
            throws AmazonServiceException, AmazonClientException {
2124
            public ListTagsForResourceResult call() throws Exception {
2125
                return listTagsForResource(listTagsForResourceRequest);
2126
        }
2127
    });
2128
    }

    

Lists all tags on an Amazon RDS resource.

For an overview on tagging an Amazon RDS resource, see Tagging Amazon RDS Resources .

Parameters:
listTagsForResourceRequest Container for the necessary parameters to execute the ListTagsForResource operation on AmazonRDS.
asyncHandler Asynchronous callback handler for events in the life-cycle of the request. Users could provide the implementation of the four callback methods in this interface to process the operation result or handle the exception.
Returns:
A Java Future object containing the response from the ListTagsForResource service method, as returned by AmazonRDS.
Throws:
com.amazonaws.AmazonClientException If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRDS indicating either a problem with the data in the request, or a server side issue.
2160
            final ListTagsForResourceRequest listTagsForResourceRequest,
2161
            final AsyncHandler<ListTagsForResourceRequest, ListTagsForResourceResult> asyncHandler)
2162
                    throws AmazonServiceException, AmazonClientException {
2164
            public ListTagsForResourceResult call() throws Exception {
2165
              ListTagsForResourceResult result;
2166
                try {
2167
                result = listTagsForResource(listTagsForResourceRequest);
2168
              } catch (Exception ex) {
2169
                  asyncHandler.onError(ex);
2170
            throw ex;
2171
              }
2172
              asyncHandler.onSuccess(listTagsForResourceRequest, result);
2173
                 return result;
2174
        }
2175
    });
2176
    }
    
    

Describes all available options.

Parameters:
describeOptionGroupOptionsRequest Container for the necessary parameters to execute the DescribeOptionGroupOptions operation on AmazonRDS.
Returns:
A Java Future object containing the response from the DescribeOptionGroupOptions service method, as returned by AmazonRDS.
Throws:
com.amazonaws.AmazonClientException If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRDS indicating either a problem with the data in the request, or a server side issue.
2200
            throws AmazonServiceException, AmazonClientException {
2202
            public DescribeOptionGroupOptionsResult call() throws Exception {
2203
                return describeOptionGroupOptions(describeOptionGroupOptionsRequest);
2204
        }
2205
    });
2206
    }

    

Describes all available options.

Parameters:
describeOptionGroupOptionsRequest Container for the necessary parameters to execute the DescribeOptionGroupOptions operation on AmazonRDS.
asyncHandler Asynchronous callback handler for events in the life-cycle of the request. Users could provide the implementation of the four callback methods in this interface to process the operation result or handle the exception.
Returns:
A Java Future object containing the response from the DescribeOptionGroupOptions service method, as returned by AmazonRDS.
Throws:
com.amazonaws.AmazonClientException If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRDS indicating either a problem with the data in the request, or a server side issue.
2234
            final DescribeOptionGroupOptionsRequest describeOptionGroupOptionsRequest,
2236
                    throws AmazonServiceException, AmazonClientException {
2238
            public DescribeOptionGroupOptionsResult call() throws Exception {
2239
              DescribeOptionGroupOptionsResult result;
2240
                try {
2241
                result = describeOptionGroupOptions(describeOptionGroupOptionsRequest);
2242
              } catch (Exception ex) {
2243
                  asyncHandler.onError(ex);
2244
            throw ex;
2245
              }
2246
              asyncHandler.onSuccess(describeOptionGroupOptionsRequest, result);
2247
                 return result;
2248
        }
2249
    });
2250
    }
    
    

Returns the detailed parameter list for a particular DB parameter group.

Parameters:
describeDBParametersRequest Container for the necessary parameters to execute the DescribeDBParameters operation on AmazonRDS.
Returns:
A Java Future object containing the response from the DescribeDBParameters service method, as returned by AmazonRDS.
Throws:
com.amazonaws.AmazonClientException If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRDS indicating either a problem with the data in the request, or a server side issue.
2273
    public Future<DescribeDBParametersResult> describeDBParametersAsync(final DescribeDBParametersRequest describeDBParametersRequest) 
2274
            throws AmazonServiceException, AmazonClientException {
2276
            public DescribeDBParametersResult call() throws Exception {
2277
                return describeDBParameters(describeDBParametersRequest);
2278
        }
2279
    });
2280
    }

    

Returns the detailed parameter list for a particular DB parameter group.

Parameters:
describeDBParametersRequest Container for the necessary parameters to execute the DescribeDBParameters operation on AmazonRDS.
asyncHandler Asynchronous callback handler for events in the life-cycle of the request. Users could provide the implementation of the four callback methods in this interface to process the operation result or handle the exception.
Returns:
A Java Future object containing the response from the DescribeDBParameters service method, as returned by AmazonRDS.
Throws:
com.amazonaws.AmazonClientException If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.
com.amazonaws.AmazonServiceException If an error response is returned by AmazonRDS indicating either a problem with the data in the request, or a server side issue.
2308
            final DescribeDBParametersRequest describeDBParametersRequest,
2309
            final AsyncHandler<DescribeDBParametersRequest, DescribeDBParametersResult> asyncHandler)
2310
                    throws AmazonServiceException, AmazonClientException {
2312
            public DescribeDBParametersResult call() throws Exception {
2313
              DescribeDBParametersResult result;
2314
                try {
2315
                result = describeDBParameters(describeDBParametersRequest);
2316
              } catch (Exception ex) {
2317
                  asyncHandler.onError(ex);