Interface DocDbElasticAsyncClient
- All Superinterfaces:
AutoCloseable,AwsClient,SdkAutoCloseable,SdkClient
builder()
method.The asynchronous client performs non-blocking I/O when configured with any SdkAsyncHttpClient
supported in the SDK. However, full non-blocking is not guaranteed as the async client may perform blocking calls in
some cases such as credentials retrieval and endpoint discovery as part of the async API call.
Amazon DocumentDB elastic-clusters support workloads with millions of reads/writes per second and petabytes of storage capacity. Amazon DocumentDB elastic clusters also simplify how developers interact with Amazon DocumentDB elastic-clusters by eliminating the need to choose, manage or upgrade instances.
Amazon DocumentDB elastic-clusters were created to:
-
provide a solution for customers looking for a database that provides virtually limitless scale with rich query capabilities and MongoDB API compatibility.
-
give customers higher connection limits, and to reduce downtime from patching.
-
continue investing in a cloud-native, elastic, and class leading architecture for JSON workloads.
-
Field Summary
FieldsModifier and TypeFieldDescriptionstatic final StringValue for looking up the service's metadata from theServiceMetadataProvider.static final String -
Method Summary
Modifier and TypeMethodDescriptionbuilder()Create a builder that can be used to configure and create aDocDbElasticAsyncClient.copyClusterSnapshot(Consumer<CopyClusterSnapshotRequest.Builder> copyClusterSnapshotRequest) Copies a snapshot of an elastic cluster.copyClusterSnapshot(CopyClusterSnapshotRequest copyClusterSnapshotRequest) Copies a snapshot of an elastic cluster.static DocDbElasticAsyncClientcreate()Create aDocDbElasticAsyncClientwith the region loaded from theDefaultAwsRegionProviderChainand credentials loaded from theDefaultCredentialsProvider.default CompletableFuture<CreateClusterResponse> createCluster(Consumer<CreateClusterRequest.Builder> createClusterRequest) Creates a new Amazon DocumentDB elastic cluster and returns its cluster structure.default CompletableFuture<CreateClusterResponse> createCluster(CreateClusterRequest createClusterRequest) Creates a new Amazon DocumentDB elastic cluster and returns its cluster structure.createClusterSnapshot(Consumer<CreateClusterSnapshotRequest.Builder> createClusterSnapshotRequest) Creates a snapshot of an elastic cluster.createClusterSnapshot(CreateClusterSnapshotRequest createClusterSnapshotRequest) Creates a snapshot of an elastic cluster.default CompletableFuture<DeleteClusterResponse> deleteCluster(Consumer<DeleteClusterRequest.Builder> deleteClusterRequest) Delete an elastic cluster.default CompletableFuture<DeleteClusterResponse> deleteCluster(DeleteClusterRequest deleteClusterRequest) Delete an elastic cluster.deleteClusterSnapshot(Consumer<DeleteClusterSnapshotRequest.Builder> deleteClusterSnapshotRequest) Delete an elastic cluster snapshot.deleteClusterSnapshot(DeleteClusterSnapshotRequest deleteClusterSnapshotRequest) Delete an elastic cluster snapshot.default CompletableFuture<GetClusterResponse> getCluster(Consumer<GetClusterRequest.Builder> getClusterRequest) Returns information about a specific elastic cluster.default CompletableFuture<GetClusterResponse> getCluster(GetClusterRequest getClusterRequest) Returns information about a specific elastic cluster.getClusterSnapshot(Consumer<GetClusterSnapshotRequest.Builder> getClusterSnapshotRequest) Returns information about a specific elastic cluster snapshotgetClusterSnapshot(GetClusterSnapshotRequest getClusterSnapshotRequest) Returns information about a specific elastic cluster snapshotdefault CompletableFuture<ListClustersResponse> listClusters(Consumer<ListClustersRequest.Builder> listClustersRequest) Returns information about provisioned Amazon DocumentDB elastic clusters.default CompletableFuture<ListClustersResponse> listClusters(ListClustersRequest listClustersRequest) Returns information about provisioned Amazon DocumentDB elastic clusters.listClusterSnapshots(Consumer<ListClusterSnapshotsRequest.Builder> listClusterSnapshotsRequest) Returns information about snapshots for a specified elastic cluster.listClusterSnapshots(ListClusterSnapshotsRequest listClusterSnapshotsRequest) Returns information about snapshots for a specified elastic cluster.default ListClusterSnapshotsPublisherlistClusterSnapshotsPaginator(Consumer<ListClusterSnapshotsRequest.Builder> listClusterSnapshotsRequest) This is a variant oflistClusterSnapshots(software.amazon.awssdk.services.docdbelastic.model.ListClusterSnapshotsRequest)operation.default ListClusterSnapshotsPublisherlistClusterSnapshotsPaginator(ListClusterSnapshotsRequest listClusterSnapshotsRequest) This is a variant oflistClusterSnapshots(software.amazon.awssdk.services.docdbelastic.model.ListClusterSnapshotsRequest)operation.default ListClustersPublisherlistClustersPaginator(Consumer<ListClustersRequest.Builder> listClustersRequest) This is a variant oflistClusters(software.amazon.awssdk.services.docdbelastic.model.ListClustersRequest)operation.default ListClustersPublisherlistClustersPaginator(ListClustersRequest listClustersRequest) This is a variant oflistClusters(software.amazon.awssdk.services.docdbelastic.model.ListClustersRequest)operation.listTagsForResource(Consumer<ListTagsForResourceRequest.Builder> listTagsForResourceRequest) Lists all tags on a elastic cluster resourcelistTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest) Lists all tags on a elastic cluster resourcerestoreClusterFromSnapshot(Consumer<RestoreClusterFromSnapshotRequest.Builder> restoreClusterFromSnapshotRequest) Restores an elastic cluster from a snapshot.restoreClusterFromSnapshot(RestoreClusterFromSnapshotRequest restoreClusterFromSnapshotRequest) Restores an elastic cluster from a snapshot.The SDK service client configuration exposes client settings to the user, e.g., ClientOverrideConfigurationdefault CompletableFuture<StartClusterResponse> startCluster(Consumer<StartClusterRequest.Builder> startClusterRequest) Restarts the stopped elastic cluster that is specified byclusterARN.default CompletableFuture<StartClusterResponse> startCluster(StartClusterRequest startClusterRequest) Restarts the stopped elastic cluster that is specified byclusterARN.default CompletableFuture<StopClusterResponse> stopCluster(Consumer<StopClusterRequest.Builder> stopClusterRequest) Stops the running elastic cluster that is specified byclusterArn.default CompletableFuture<StopClusterResponse> stopCluster(StopClusterRequest stopClusterRequest) Stops the running elastic cluster that is specified byclusterArn.default CompletableFuture<TagResourceResponse> tagResource(Consumer<TagResourceRequest.Builder> tagResourceRequest) Adds metadata tags to an elastic cluster resourcedefault CompletableFuture<TagResourceResponse> tagResource(TagResourceRequest tagResourceRequest) Adds metadata tags to an elastic cluster resourcedefault CompletableFuture<UntagResourceResponse> untagResource(Consumer<UntagResourceRequest.Builder> untagResourceRequest) Removes metadata tags from an elastic cluster resourcedefault CompletableFuture<UntagResourceResponse> untagResource(UntagResourceRequest untagResourceRequest) Removes metadata tags from an elastic cluster resourcedefault CompletableFuture<UpdateClusterResponse> updateCluster(Consumer<UpdateClusterRequest.Builder> updateClusterRequest) Modifies an elastic cluster.default CompletableFuture<UpdateClusterResponse> updateCluster(UpdateClusterRequest updateClusterRequest) Modifies an elastic cluster.Methods inherited from interface software.amazon.awssdk.utils.SdkAutoCloseable
closeMethods inherited from interface software.amazon.awssdk.core.SdkClient
serviceName
-
Field Details
-
SERVICE_NAME
- See Also:
-
SERVICE_METADATA_ID
Value for looking up the service's metadata from theServiceMetadataProvider.- See Also:
-
-
Method Details
-
copyClusterSnapshot
default CompletableFuture<CopyClusterSnapshotResponse> copyClusterSnapshot(CopyClusterSnapshotRequest copyClusterSnapshotRequest) Copies a snapshot of an elastic cluster.
- Parameters:
copyClusterSnapshotRequest-- Returns:
- A Java Future containing the result of the CopyClusterSnapshot operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ThrottlingException ThrottlingException will be thrown when request was denied due to request throttling.
- ValidationException A structure defining a validation exception.
- ServiceQuotaExceededException The service quota for the action was exceeded.
- ConflictException There was an access conflict.
- InternalServerException There was an internal server error.
- ResourceNotFoundException The specified resource could not be located.
- AccessDeniedException An exception that occurs when there are not sufficient permissions to perform an 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.
- DocDbElasticException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
copyClusterSnapshot
default CompletableFuture<CopyClusterSnapshotResponse> copyClusterSnapshot(Consumer<CopyClusterSnapshotRequest.Builder> copyClusterSnapshotRequest) Copies a snapshot of an elastic cluster.
This is a convenience which creates an instance of the
CopyClusterSnapshotRequest.Builderavoiding the need to create one manually viaCopyClusterSnapshotRequest.builder()- Parameters:
copyClusterSnapshotRequest- AConsumerthat will call methods onCopyClusterSnapshotRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the CopyClusterSnapshot operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ThrottlingException ThrottlingException will be thrown when request was denied due to request throttling.
- ValidationException A structure defining a validation exception.
- ServiceQuotaExceededException The service quota for the action was exceeded.
- ConflictException There was an access conflict.
- InternalServerException There was an internal server error.
- ResourceNotFoundException The specified resource could not be located.
- AccessDeniedException An exception that occurs when there are not sufficient permissions to perform an 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.
- DocDbElasticException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
createCluster
default CompletableFuture<CreateClusterResponse> createCluster(CreateClusterRequest createClusterRequest) Creates a new Amazon DocumentDB elastic cluster and returns its cluster structure.
- Parameters:
createClusterRequest-- Returns:
- A Java Future containing the result of the CreateCluster operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ThrottlingException ThrottlingException will be thrown when request was denied due to request throttling.
- ValidationException A structure defining a validation exception.
- ServiceQuotaExceededException The service quota for the action was exceeded.
- ConflictException There was an access conflict.
- InternalServerException There was an internal server error.
- AccessDeniedException An exception that occurs when there are not sufficient permissions to perform an 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.
- DocDbElasticException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
createCluster
default CompletableFuture<CreateClusterResponse> createCluster(Consumer<CreateClusterRequest.Builder> createClusterRequest) Creates a new Amazon DocumentDB elastic cluster and returns its cluster structure.
This is a convenience which creates an instance of the
CreateClusterRequest.Builderavoiding the need to create one manually viaCreateClusterRequest.builder()- Parameters:
createClusterRequest- AConsumerthat will call methods onCreateClusterRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the CreateCluster operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ThrottlingException ThrottlingException will be thrown when request was denied due to request throttling.
- ValidationException A structure defining a validation exception.
- ServiceQuotaExceededException The service quota for the action was exceeded.
- ConflictException There was an access conflict.
- InternalServerException There was an internal server error.
- AccessDeniedException An exception that occurs when there are not sufficient permissions to perform an 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.
- DocDbElasticException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
createClusterSnapshot
default CompletableFuture<CreateClusterSnapshotResponse> createClusterSnapshot(CreateClusterSnapshotRequest createClusterSnapshotRequest) Creates a snapshot of an elastic cluster.
- Parameters:
createClusterSnapshotRequest-- Returns:
- A Java Future containing the result of the CreateClusterSnapshot operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ThrottlingException ThrottlingException will be thrown when request was denied due to request throttling.
- ValidationException A structure defining a validation exception.
- ServiceQuotaExceededException The service quota for the action was exceeded.
- ConflictException There was an access conflict.
- InternalServerException There was an internal server error.
- ResourceNotFoundException The specified resource could not be located.
- AccessDeniedException An exception that occurs when there are not sufficient permissions to perform an 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.
- DocDbElasticException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
createClusterSnapshot
default CompletableFuture<CreateClusterSnapshotResponse> createClusterSnapshot(Consumer<CreateClusterSnapshotRequest.Builder> createClusterSnapshotRequest) Creates a snapshot of an elastic cluster.
This is a convenience which creates an instance of the
CreateClusterSnapshotRequest.Builderavoiding the need to create one manually viaCreateClusterSnapshotRequest.builder()- Parameters:
createClusterSnapshotRequest- AConsumerthat will call methods onCreateClusterSnapshotRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the CreateClusterSnapshot operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ThrottlingException ThrottlingException will be thrown when request was denied due to request throttling.
- ValidationException A structure defining a validation exception.
- ServiceQuotaExceededException The service quota for the action was exceeded.
- ConflictException There was an access conflict.
- InternalServerException There was an internal server error.
- ResourceNotFoundException The specified resource could not be located.
- AccessDeniedException An exception that occurs when there are not sufficient permissions to perform an 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.
- DocDbElasticException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
deleteCluster
default CompletableFuture<DeleteClusterResponse> deleteCluster(DeleteClusterRequest deleteClusterRequest) Delete an elastic cluster.
- Parameters:
deleteClusterRequest-- Returns:
- A Java Future containing the result of the DeleteCluster operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ThrottlingException ThrottlingException will be thrown when request was denied due to request throttling.
- ValidationException A structure defining a validation exception.
- ConflictException There was an access conflict.
- InternalServerException There was an internal server error.
- ResourceNotFoundException The specified resource could not be located.
- AccessDeniedException An exception that occurs when there are not sufficient permissions to perform an 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.
- DocDbElasticException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
deleteCluster
default CompletableFuture<DeleteClusterResponse> deleteCluster(Consumer<DeleteClusterRequest.Builder> deleteClusterRequest) Delete an elastic cluster.
This is a convenience which creates an instance of the
DeleteClusterRequest.Builderavoiding the need to create one manually viaDeleteClusterRequest.builder()- Parameters:
deleteClusterRequest- AConsumerthat will call methods onDeleteClusterRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the DeleteCluster operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ThrottlingException ThrottlingException will be thrown when request was denied due to request throttling.
- ValidationException A structure defining a validation exception.
- ConflictException There was an access conflict.
- InternalServerException There was an internal server error.
- ResourceNotFoundException The specified resource could not be located.
- AccessDeniedException An exception that occurs when there are not sufficient permissions to perform an 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.
- DocDbElasticException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
deleteClusterSnapshot
default CompletableFuture<DeleteClusterSnapshotResponse> deleteClusterSnapshot(DeleteClusterSnapshotRequest deleteClusterSnapshotRequest) Delete an elastic cluster snapshot.
- Parameters:
deleteClusterSnapshotRequest-- Returns:
- A Java Future containing the result of the DeleteClusterSnapshot operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ThrottlingException ThrottlingException will be thrown when request was denied due to request throttling.
- ValidationException A structure defining a validation exception.
- ConflictException There was an access conflict.
- InternalServerException There was an internal server error.
- ResourceNotFoundException The specified resource could not be located.
- AccessDeniedException An exception that occurs when there are not sufficient permissions to perform an 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.
- DocDbElasticException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
deleteClusterSnapshot
default CompletableFuture<DeleteClusterSnapshotResponse> deleteClusterSnapshot(Consumer<DeleteClusterSnapshotRequest.Builder> deleteClusterSnapshotRequest) Delete an elastic cluster snapshot.
This is a convenience which creates an instance of the
DeleteClusterSnapshotRequest.Builderavoiding the need to create one manually viaDeleteClusterSnapshotRequest.builder()- Parameters:
deleteClusterSnapshotRequest- AConsumerthat will call methods onDeleteClusterSnapshotRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the DeleteClusterSnapshot operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ThrottlingException ThrottlingException will be thrown when request was denied due to request throttling.
- ValidationException A structure defining a validation exception.
- ConflictException There was an access conflict.
- InternalServerException There was an internal server error.
- ResourceNotFoundException The specified resource could not be located.
- AccessDeniedException An exception that occurs when there are not sufficient permissions to perform an 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.
- DocDbElasticException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
getCluster
Returns information about a specific elastic cluster.
- Parameters:
getClusterRequest-- Returns:
- A Java Future containing the result of the GetCluster operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ThrottlingException ThrottlingException will be thrown when request was denied due to request throttling.
- ValidationException A structure defining a validation exception.
- InternalServerException There was an internal server error.
- ResourceNotFoundException The specified resource could not be located.
- AccessDeniedException An exception that occurs when there are not sufficient permissions to perform an 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.
- DocDbElasticException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
getCluster
default CompletableFuture<GetClusterResponse> getCluster(Consumer<GetClusterRequest.Builder> getClusterRequest) Returns information about a specific elastic cluster.
This is a convenience which creates an instance of the
GetClusterRequest.Builderavoiding the need to create one manually viaGetClusterRequest.builder()- Parameters:
getClusterRequest- AConsumerthat will call methods onGetClusterRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the GetCluster operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ThrottlingException ThrottlingException will be thrown when request was denied due to request throttling.
- ValidationException A structure defining a validation exception.
- InternalServerException There was an internal server error.
- ResourceNotFoundException The specified resource could not be located.
- AccessDeniedException An exception that occurs when there are not sufficient permissions to perform an 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.
- DocDbElasticException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
getClusterSnapshot
default CompletableFuture<GetClusterSnapshotResponse> getClusterSnapshot(GetClusterSnapshotRequest getClusterSnapshotRequest) Returns information about a specific elastic cluster snapshot
- Parameters:
getClusterSnapshotRequest-- Returns:
- A Java Future containing the result of the GetClusterSnapshot operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ThrottlingException ThrottlingException will be thrown when request was denied due to request throttling.
- ValidationException A structure defining a validation exception.
- InternalServerException There was an internal server error.
- ResourceNotFoundException The specified resource could not be located.
- AccessDeniedException An exception that occurs when there are not sufficient permissions to perform an 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.
- DocDbElasticException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
getClusterSnapshot
default CompletableFuture<GetClusterSnapshotResponse> getClusterSnapshot(Consumer<GetClusterSnapshotRequest.Builder> getClusterSnapshotRequest) Returns information about a specific elastic cluster snapshot
This is a convenience which creates an instance of the
GetClusterSnapshotRequest.Builderavoiding the need to create one manually viaGetClusterSnapshotRequest.builder()- Parameters:
getClusterSnapshotRequest- AConsumerthat will call methods onGetClusterSnapshotRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the GetClusterSnapshot operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ThrottlingException ThrottlingException will be thrown when request was denied due to request throttling.
- ValidationException A structure defining a validation exception.
- InternalServerException There was an internal server error.
- ResourceNotFoundException The specified resource could not be located.
- AccessDeniedException An exception that occurs when there are not sufficient permissions to perform an 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.
- DocDbElasticException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listClusterSnapshots
default CompletableFuture<ListClusterSnapshotsResponse> listClusterSnapshots(ListClusterSnapshotsRequest listClusterSnapshotsRequest) Returns information about snapshots for a specified elastic cluster.
- Parameters:
listClusterSnapshotsRequest-- Returns:
- A Java Future containing the result of the ListClusterSnapshots operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ThrottlingException ThrottlingException will be thrown when request was denied due to request throttling.
- ValidationException A structure defining a validation exception.
- InternalServerException There was an internal server error.
- AccessDeniedException An exception that occurs when there are not sufficient permissions to perform an 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.
- DocDbElasticException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listClusterSnapshots
default CompletableFuture<ListClusterSnapshotsResponse> listClusterSnapshots(Consumer<ListClusterSnapshotsRequest.Builder> listClusterSnapshotsRequest) Returns information about snapshots for a specified elastic cluster.
This is a convenience which creates an instance of the
ListClusterSnapshotsRequest.Builderavoiding the need to create one manually viaListClusterSnapshotsRequest.builder()- Parameters:
listClusterSnapshotsRequest- AConsumerthat will call methods onListClusterSnapshotsRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the ListClusterSnapshots operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ThrottlingException ThrottlingException will be thrown when request was denied due to request throttling.
- ValidationException A structure defining a validation exception.
- InternalServerException There was an internal server error.
- AccessDeniedException An exception that occurs when there are not sufficient permissions to perform an 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.
- DocDbElasticException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listClusterSnapshotsPaginator
default ListClusterSnapshotsPublisher listClusterSnapshotsPaginator(ListClusterSnapshotsRequest listClusterSnapshotsRequest) This is a variant of
listClusterSnapshots(software.amazon.awssdk.services.docdbelastic.model.ListClusterSnapshotsRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.docdbelastic.paginators.ListClusterSnapshotsPublisher publisher = client.listClusterSnapshotsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.docdbelastic.paginators.ListClusterSnapshotsPublisher publisher = client.listClusterSnapshotsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.docdbelastic.model.ListClusterSnapshotsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.docdbelastic.model.ListClusterSnapshotsResponse response) { //... }; });Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listClusterSnapshots(software.amazon.awssdk.services.docdbelastic.model.ListClusterSnapshotsRequest)operation.- Parameters:
listClusterSnapshotsRequest-- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ThrottlingException ThrottlingException will be thrown when request was denied due to request throttling.
- ValidationException A structure defining a validation exception.
- InternalServerException There was an internal server error.
- AccessDeniedException An exception that occurs when there are not sufficient permissions to perform an 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.
- DocDbElasticException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listClusterSnapshotsPaginator
default ListClusterSnapshotsPublisher listClusterSnapshotsPaginator(Consumer<ListClusterSnapshotsRequest.Builder> listClusterSnapshotsRequest) This is a variant of
listClusterSnapshots(software.amazon.awssdk.services.docdbelastic.model.ListClusterSnapshotsRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.docdbelastic.paginators.ListClusterSnapshotsPublisher publisher = client.listClusterSnapshotsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.docdbelastic.paginators.ListClusterSnapshotsPublisher publisher = client.listClusterSnapshotsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.docdbelastic.model.ListClusterSnapshotsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.docdbelastic.model.ListClusterSnapshotsResponse response) { //... }; });Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listClusterSnapshots(software.amazon.awssdk.services.docdbelastic.model.ListClusterSnapshotsRequest)operation.
This is a convenience which creates an instance of the
ListClusterSnapshotsRequest.Builderavoiding the need to create one manually viaListClusterSnapshotsRequest.builder()- Parameters:
listClusterSnapshotsRequest- AConsumerthat will call methods onListClusterSnapshotsRequest.Builderto create a request.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ThrottlingException ThrottlingException will be thrown when request was denied due to request throttling.
- ValidationException A structure defining a validation exception.
- InternalServerException There was an internal server error.
- AccessDeniedException An exception that occurs when there are not sufficient permissions to perform an 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.
- DocDbElasticException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listClusters
default CompletableFuture<ListClustersResponse> listClusters(ListClustersRequest listClustersRequest) Returns information about provisioned Amazon DocumentDB elastic clusters.
- Parameters:
listClustersRequest-- Returns:
- A Java Future containing the result of the ListClusters operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ThrottlingException ThrottlingException will be thrown when request was denied due to request throttling.
- ValidationException A structure defining a validation exception.
- InternalServerException There was an internal server error.
- AccessDeniedException An exception that occurs when there are not sufficient permissions to perform an 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.
- DocDbElasticException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listClusters
default CompletableFuture<ListClustersResponse> listClusters(Consumer<ListClustersRequest.Builder> listClustersRequest) Returns information about provisioned Amazon DocumentDB elastic clusters.
This is a convenience which creates an instance of the
ListClustersRequest.Builderavoiding the need to create one manually viaListClustersRequest.builder()- Parameters:
listClustersRequest- AConsumerthat will call methods onListClustersRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the ListClusters operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ThrottlingException ThrottlingException will be thrown when request was denied due to request throttling.
- ValidationException A structure defining a validation exception.
- InternalServerException There was an internal server error.
- AccessDeniedException An exception that occurs when there are not sufficient permissions to perform an 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.
- DocDbElasticException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listClustersPaginator
This is a variant of
listClusters(software.amazon.awssdk.services.docdbelastic.model.ListClustersRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.docdbelastic.paginators.ListClustersPublisher publisher = client.listClustersPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.docdbelastic.paginators.ListClustersPublisher publisher = client.listClustersPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.docdbelastic.model.ListClustersResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.docdbelastic.model.ListClustersResponse response) { //... }; });Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listClusters(software.amazon.awssdk.services.docdbelastic.model.ListClustersRequest)operation.- Parameters:
listClustersRequest-- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ThrottlingException ThrottlingException will be thrown when request was denied due to request throttling.
- ValidationException A structure defining a validation exception.
- InternalServerException There was an internal server error.
- AccessDeniedException An exception that occurs when there are not sufficient permissions to perform an 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.
- DocDbElasticException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listClustersPaginator
default ListClustersPublisher listClustersPaginator(Consumer<ListClustersRequest.Builder> listClustersRequest) This is a variant of
listClusters(software.amazon.awssdk.services.docdbelastic.model.ListClustersRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.docdbelastic.paginators.ListClustersPublisher publisher = client.listClustersPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.docdbelastic.paginators.ListClustersPublisher publisher = client.listClustersPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.docdbelastic.model.ListClustersResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.docdbelastic.model.ListClustersResponse response) { //... }; });Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listClusters(software.amazon.awssdk.services.docdbelastic.model.ListClustersRequest)operation.
This is a convenience which creates an instance of the
ListClustersRequest.Builderavoiding the need to create one manually viaListClustersRequest.builder()- Parameters:
listClustersRequest- AConsumerthat will call methods onListClustersRequest.Builderto create a request.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ThrottlingException ThrottlingException will be thrown when request was denied due to request throttling.
- ValidationException A structure defining a validation exception.
- InternalServerException There was an internal server error.
- AccessDeniedException An exception that occurs when there are not sufficient permissions to perform an 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.
- DocDbElasticException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listTagsForResource
default CompletableFuture<ListTagsForResourceResponse> listTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest) Lists all tags on a elastic cluster resource
- Parameters:
listTagsForResourceRequest-- Returns:
- A Java Future containing the result of the ListTagsForResource operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ThrottlingException ThrottlingException will be thrown when request was denied due to request throttling.
- ValidationException A structure defining a validation exception.
- InternalServerException There was an internal server error.
- ResourceNotFoundException The specified resource could not be located.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbElasticException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listTagsForResource
default CompletableFuture<ListTagsForResourceResponse> listTagsForResource(Consumer<ListTagsForResourceRequest.Builder> listTagsForResourceRequest) Lists all tags on a elastic cluster resource
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:
- A Java Future containing the result of the ListTagsForResource operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ThrottlingException ThrottlingException will be thrown when request was denied due to request throttling.
- ValidationException A structure defining a validation exception.
- InternalServerException There was an internal server error.
- ResourceNotFoundException The specified resource could not be located.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbElasticException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
restoreClusterFromSnapshot
default CompletableFuture<RestoreClusterFromSnapshotResponse> restoreClusterFromSnapshot(RestoreClusterFromSnapshotRequest restoreClusterFromSnapshotRequest) Restores an elastic cluster from a snapshot.
- Parameters:
restoreClusterFromSnapshotRequest-- Returns:
- A Java Future containing the result of the RestoreClusterFromSnapshot operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ThrottlingException ThrottlingException will be thrown when request was denied due to request throttling.
- ValidationException A structure defining a validation exception.
- ServiceQuotaExceededException The service quota for the action was exceeded.
- ConflictException There was an access conflict.
- InternalServerException There was an internal server error.
- ResourceNotFoundException The specified resource could not be located.
- AccessDeniedException An exception that occurs when there are not sufficient permissions to perform an 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.
- DocDbElasticException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
restoreClusterFromSnapshot
default CompletableFuture<RestoreClusterFromSnapshotResponse> restoreClusterFromSnapshot(Consumer<RestoreClusterFromSnapshotRequest.Builder> restoreClusterFromSnapshotRequest) Restores an elastic cluster from a snapshot.
This is a convenience which creates an instance of the
RestoreClusterFromSnapshotRequest.Builderavoiding the need to create one manually viaRestoreClusterFromSnapshotRequest.builder()- Parameters:
restoreClusterFromSnapshotRequest- AConsumerthat will call methods onRestoreClusterFromSnapshotRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the RestoreClusterFromSnapshot operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ThrottlingException ThrottlingException will be thrown when request was denied due to request throttling.
- ValidationException A structure defining a validation exception.
- ServiceQuotaExceededException The service quota for the action was exceeded.
- ConflictException There was an access conflict.
- InternalServerException There was an internal server error.
- ResourceNotFoundException The specified resource could not be located.
- AccessDeniedException An exception that occurs when there are not sufficient permissions to perform an 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.
- DocDbElasticException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
startCluster
default CompletableFuture<StartClusterResponse> startCluster(StartClusterRequest startClusterRequest) Restarts the stopped elastic cluster that is specified by
clusterARN.- Parameters:
startClusterRequest-- Returns:
- A Java Future containing the result of the StartCluster operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ThrottlingException ThrottlingException will be thrown when request was denied due to request throttling.
- ValidationException A structure defining a validation exception.
- InternalServerException There was an internal server error.
- ResourceNotFoundException The specified resource could not be located.
- AccessDeniedException An exception that occurs when there are not sufficient permissions to perform an 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.
- DocDbElasticException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
startCluster
default CompletableFuture<StartClusterResponse> startCluster(Consumer<StartClusterRequest.Builder> startClusterRequest) Restarts the stopped elastic cluster that is specified by
clusterARN.
This is a convenience which creates an instance of the
StartClusterRequest.Builderavoiding the need to create one manually viaStartClusterRequest.builder()- Parameters:
startClusterRequest- AConsumerthat will call methods onStartClusterRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the StartCluster operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ThrottlingException ThrottlingException will be thrown when request was denied due to request throttling.
- ValidationException A structure defining a validation exception.
- InternalServerException There was an internal server error.
- ResourceNotFoundException The specified resource could not be located.
- AccessDeniedException An exception that occurs when there are not sufficient permissions to perform an 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.
- DocDbElasticException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
stopCluster
Stops the running elastic cluster that is specified by
clusterArn. The elastic cluster must be in the available state.- Parameters:
stopClusterRequest-- Returns:
- A Java Future containing the result of the StopCluster operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ThrottlingException ThrottlingException will be thrown when request was denied due to request throttling.
- ValidationException A structure defining a validation exception.
- InternalServerException There was an internal server error.
- ResourceNotFoundException The specified resource could not be located.
- AccessDeniedException An exception that occurs when there are not sufficient permissions to perform an 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.
- DocDbElasticException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
stopCluster
default CompletableFuture<StopClusterResponse> stopCluster(Consumer<StopClusterRequest.Builder> stopClusterRequest) Stops the running elastic cluster that is specified by
clusterArn. The elastic cluster must be in the available state.
This is a convenience which creates an instance of the
StopClusterRequest.Builderavoiding the need to create one manually viaStopClusterRequest.builder()- Parameters:
stopClusterRequest- AConsumerthat will call methods onStopClusterRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the StopCluster operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ThrottlingException ThrottlingException will be thrown when request was denied due to request throttling.
- ValidationException A structure defining a validation exception.
- InternalServerException There was an internal server error.
- ResourceNotFoundException The specified resource could not be located.
- AccessDeniedException An exception that occurs when there are not sufficient permissions to perform an 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.
- DocDbElasticException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
tagResource
Adds metadata tags to an elastic cluster resource
- Parameters:
tagResourceRequest-- Returns:
- A Java Future containing the result of the TagResource operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ThrottlingException ThrottlingException will be thrown when request was denied due to request throttling.
- ValidationException A structure defining a validation exception.
- InternalServerException There was an internal server error.
- ResourceNotFoundException The specified resource could not be located.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbElasticException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
tagResource
default CompletableFuture<TagResourceResponse> tagResource(Consumer<TagResourceRequest.Builder> tagResourceRequest) Adds metadata tags to an elastic cluster resource
This is a convenience which creates an instance of the
TagResourceRequest.Builderavoiding the need to create one manually viaTagResourceRequest.builder()- Parameters:
tagResourceRequest- AConsumerthat will call methods onTagResourceRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the TagResource operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ThrottlingException ThrottlingException will be thrown when request was denied due to request throttling.
- ValidationException A structure defining a validation exception.
- InternalServerException There was an internal server error.
- ResourceNotFoundException The specified resource could not be located.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbElasticException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
untagResource
default CompletableFuture<UntagResourceResponse> untagResource(UntagResourceRequest untagResourceRequest) Removes metadata tags from an elastic cluster resource
- Parameters:
untagResourceRequest-- Returns:
- A Java Future containing the result of the UntagResource operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ThrottlingException ThrottlingException will be thrown when request was denied due to request throttling.
- ValidationException A structure defining a validation exception.
- InternalServerException There was an internal server error.
- ResourceNotFoundException The specified resource could not be located.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbElasticException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
untagResource
default CompletableFuture<UntagResourceResponse> untagResource(Consumer<UntagResourceRequest.Builder> untagResourceRequest) Removes metadata tags from an elastic cluster resource
This is a convenience which creates an instance of the
UntagResourceRequest.Builderavoiding the need to create one manually viaUntagResourceRequest.builder()- Parameters:
untagResourceRequest- AConsumerthat will call methods onUntagResourceRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the UntagResource operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ThrottlingException ThrottlingException will be thrown when request was denied due to request throttling.
- ValidationException A structure defining a validation exception.
- InternalServerException There was an internal server error.
- ResourceNotFoundException The specified resource could not be located.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbElasticException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
updateCluster
default CompletableFuture<UpdateClusterResponse> updateCluster(UpdateClusterRequest updateClusterRequest) Modifies an elastic cluster. This includes updating admin-username/password, upgrading the API version, and setting up a backup window and maintenance window
- Parameters:
updateClusterRequest-- Returns:
- A Java Future containing the result of the UpdateCluster operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ThrottlingException ThrottlingException will be thrown when request was denied due to request throttling.
- ValidationException A structure defining a validation exception.
- ConflictException There was an access conflict.
- InternalServerException There was an internal server error.
- ResourceNotFoundException The specified resource could not be located.
- AccessDeniedException An exception that occurs when there are not sufficient permissions to perform an 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.
- DocDbElasticException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
updateCluster
default CompletableFuture<UpdateClusterResponse> updateCluster(Consumer<UpdateClusterRequest.Builder> updateClusterRequest) Modifies an elastic cluster. This includes updating admin-username/password, upgrading the API version, and setting up a backup window and maintenance window
This is a convenience which creates an instance of the
UpdateClusterRequest.Builderavoiding the need to create one manually viaUpdateClusterRequest.builder()- Parameters:
updateClusterRequest- AConsumerthat will call methods onUpdateClusterRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the UpdateCluster operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ThrottlingException ThrottlingException will be thrown when request was denied due to request throttling.
- ValidationException A structure defining a validation exception.
- ConflictException There was an access conflict.
- InternalServerException There was an internal server error.
- ResourceNotFoundException The specified resource could not be located.
- AccessDeniedException An exception that occurs when there are not sufficient permissions to perform an 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.
- DocDbElasticException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
serviceClientConfiguration
Description copied from interface:SdkClientThe SDK service client configuration exposes client settings to the user, e.g., ClientOverrideConfiguration- Specified by:
serviceClientConfigurationin interfaceAwsClient- Specified by:
serviceClientConfigurationin interfaceSdkClient- Returns:
- SdkServiceClientConfiguration
-
create
Create aDocDbElasticAsyncClientwith the region loaded from theDefaultAwsRegionProviderChainand credentials loaded from theDefaultCredentialsProvider. -
builder
Create a builder that can be used to configure and create aDocDbElasticAsyncClient.
-