Interface DocDbElasticClient
- All Superinterfaces:
AutoCloseable,AwsClient,SdkAutoCloseable,SdkClient
builder() method.
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 TypeMethodDescriptionapplyPendingMaintenanceAction(Consumer<ApplyPendingMaintenanceActionRequest.Builder> applyPendingMaintenanceActionRequest) The type of pending maintenance action to be applied to the resource.applyPendingMaintenanceAction(ApplyPendingMaintenanceActionRequest applyPendingMaintenanceActionRequest) The type of pending maintenance action to be applied to the resource.static DocDbElasticClientBuilderbuilder()Create a builder that can be used to configure and create aDocDbElasticClient.default CopyClusterSnapshotResponsecopyClusterSnapshot(Consumer<CopyClusterSnapshotRequest.Builder> copyClusterSnapshotRequest) Copies a snapshot of an elastic cluster.default CopyClusterSnapshotResponsecopyClusterSnapshot(CopyClusterSnapshotRequest copyClusterSnapshotRequest) Copies a snapshot of an elastic cluster.static DocDbElasticClientcreate()Create aDocDbElasticClientwith the region loaded from theDefaultAwsRegionProviderChainand credentials loaded from theDefaultCredentialsProvider.default CreateClusterResponsecreateCluster(Consumer<CreateClusterRequest.Builder> createClusterRequest) Creates a new Amazon DocumentDB elastic cluster and returns its cluster structure.default CreateClusterResponsecreateCluster(CreateClusterRequest createClusterRequest) Creates a new Amazon DocumentDB elastic cluster and returns its cluster structure.default CreateClusterSnapshotResponsecreateClusterSnapshot(Consumer<CreateClusterSnapshotRequest.Builder> createClusterSnapshotRequest) Creates a snapshot of an elastic cluster.default CreateClusterSnapshotResponsecreateClusterSnapshot(CreateClusterSnapshotRequest createClusterSnapshotRequest) Creates a snapshot of an elastic cluster.default DeleteClusterResponsedeleteCluster(Consumer<DeleteClusterRequest.Builder> deleteClusterRequest) Delete an elastic cluster.default DeleteClusterResponsedeleteCluster(DeleteClusterRequest deleteClusterRequest) Delete an elastic cluster.default DeleteClusterSnapshotResponsedeleteClusterSnapshot(Consumer<DeleteClusterSnapshotRequest.Builder> deleteClusterSnapshotRequest) Delete an elastic cluster snapshot.default DeleteClusterSnapshotResponsedeleteClusterSnapshot(DeleteClusterSnapshotRequest deleteClusterSnapshotRequest) Delete an elastic cluster snapshot.default GetClusterResponsegetCluster(Consumer<GetClusterRequest.Builder> getClusterRequest) Returns information about a specific elastic cluster.default GetClusterResponsegetCluster(GetClusterRequest getClusterRequest) Returns information about a specific elastic cluster.default GetClusterSnapshotResponsegetClusterSnapshot(Consumer<GetClusterSnapshotRequest.Builder> getClusterSnapshotRequest) Returns information about a specific elastic cluster snapshotdefault GetClusterSnapshotResponsegetClusterSnapshot(GetClusterSnapshotRequest getClusterSnapshotRequest) Returns information about a specific elastic cluster snapshotgetPendingMaintenanceAction(Consumer<GetPendingMaintenanceActionRequest.Builder> getPendingMaintenanceActionRequest) Retrieves all maintenance actions that are pending.getPendingMaintenanceAction(GetPendingMaintenanceActionRequest getPendingMaintenanceActionRequest) Retrieves all maintenance actions that are pending.default ListClustersResponselistClusters(Consumer<ListClustersRequest.Builder> listClustersRequest) Returns information about provisioned Amazon DocumentDB elastic clusters.default ListClustersResponselistClusters(ListClustersRequest listClustersRequest) Returns information about provisioned Amazon DocumentDB elastic clusters.default ListClusterSnapshotsResponselistClusterSnapshots(Consumer<ListClusterSnapshotsRequest.Builder> listClusterSnapshotsRequest) Returns information about snapshots for a specified elastic cluster.default ListClusterSnapshotsResponselistClusterSnapshots(ListClusterSnapshotsRequest listClusterSnapshotsRequest) Returns information about snapshots for a specified elastic cluster.default ListClusterSnapshotsIterablelistClusterSnapshotsPaginator(Consumer<ListClusterSnapshotsRequest.Builder> listClusterSnapshotsRequest) This is a variant oflistClusterSnapshots(software.amazon.awssdk.services.docdbelastic.model.ListClusterSnapshotsRequest)operation.default ListClusterSnapshotsIterablelistClusterSnapshotsPaginator(ListClusterSnapshotsRequest listClusterSnapshotsRequest) This is a variant oflistClusterSnapshots(software.amazon.awssdk.services.docdbelastic.model.ListClusterSnapshotsRequest)operation.default ListClustersIterablelistClustersPaginator(Consumer<ListClustersRequest.Builder> listClustersRequest) This is a variant oflistClusters(software.amazon.awssdk.services.docdbelastic.model.ListClustersRequest)operation.default ListClustersIterablelistClustersPaginator(ListClustersRequest listClustersRequest) This is a variant oflistClusters(software.amazon.awssdk.services.docdbelastic.model.ListClustersRequest)operation.listPendingMaintenanceActions(Consumer<ListPendingMaintenanceActionsRequest.Builder> listPendingMaintenanceActionsRequest) Retrieves a list of all maintenance actions that are pending.listPendingMaintenanceActions(ListPendingMaintenanceActionsRequest listPendingMaintenanceActionsRequest) Retrieves a list of all maintenance actions that are pending.listPendingMaintenanceActionsPaginator(Consumer<ListPendingMaintenanceActionsRequest.Builder> listPendingMaintenanceActionsRequest) This is a variant oflistPendingMaintenanceActions(software.amazon.awssdk.services.docdbelastic.model.ListPendingMaintenanceActionsRequest)operation.listPendingMaintenanceActionsPaginator(ListPendingMaintenanceActionsRequest listPendingMaintenanceActionsRequest) This is a variant oflistPendingMaintenanceActions(software.amazon.awssdk.services.docdbelastic.model.ListPendingMaintenanceActionsRequest)operation.default ListTagsForResourceResponselistTagsForResource(Consumer<ListTagsForResourceRequest.Builder> listTagsForResourceRequest) Lists all tags on a elastic cluster resourcedefault ListTagsForResourceResponselistTagsForResource(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., ClientOverrideConfigurationstatic ServiceMetadatadefault StartClusterResponsestartCluster(Consumer<StartClusterRequest.Builder> startClusterRequest) Restarts the stopped elastic cluster that is specified byclusterARN.default StartClusterResponsestartCluster(StartClusterRequest startClusterRequest) Restarts the stopped elastic cluster that is specified byclusterARN.default StopClusterResponsestopCluster(Consumer<StopClusterRequest.Builder> stopClusterRequest) Stops the running elastic cluster that is specified byclusterArn.default StopClusterResponsestopCluster(StopClusterRequest stopClusterRequest) Stops the running elastic cluster that is specified byclusterArn.default TagResourceResponsetagResource(Consumer<TagResourceRequest.Builder> tagResourceRequest) Adds metadata tags to an elastic cluster resourcedefault TagResourceResponsetagResource(TagResourceRequest tagResourceRequest) Adds metadata tags to an elastic cluster resourcedefault UntagResourceResponseuntagResource(Consumer<UntagResourceRequest.Builder> untagResourceRequest) Removes metadata tags from an elastic cluster resourcedefault UntagResourceResponseuntagResource(UntagResourceRequest untagResourceRequest) Removes metadata tags from an elastic cluster resourcedefault UpdateClusterResponseupdateCluster(Consumer<UpdateClusterRequest.Builder> updateClusterRequest) Modifies an elastic cluster.default UpdateClusterResponseupdateCluster(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
-
applyPendingMaintenanceAction
default ApplyPendingMaintenanceActionResponse applyPendingMaintenanceAction(ApplyPendingMaintenanceActionRequest applyPendingMaintenanceActionRequest) throws ThrottlingException, ValidationException, ConflictException, InternalServerException, ResourceNotFoundException, AccessDeniedException, AwsServiceException, SdkClientException, DocDbElasticException The type of pending maintenance action to be applied to the resource.
- Parameters:
applyPendingMaintenanceActionRequest-- Returns:
- Result of the ApplyPendingMaintenanceAction operation returned by the service.
- See Also:
-
applyPendingMaintenanceAction
default ApplyPendingMaintenanceActionResponse applyPendingMaintenanceAction(Consumer<ApplyPendingMaintenanceActionRequest.Builder> applyPendingMaintenanceActionRequest) throws ThrottlingException, ValidationException, ConflictException, InternalServerException, ResourceNotFoundException, AccessDeniedException, AwsServiceException, SdkClientException, DocDbElasticException The type of pending maintenance action to be applied to the resource.
This is a convenience which creates an instance of the
ApplyPendingMaintenanceActionRequest.Builderavoiding the need to create one manually viaApplyPendingMaintenanceActionRequest.builder()- Parameters:
applyPendingMaintenanceActionRequest- AConsumerthat will call methods onApplyPendingMaintenanceActionRequest.Builderto create a request.- Returns:
- Result of the ApplyPendingMaintenanceAction operation returned by the service.
- See Also:
-
copyClusterSnapshot
default CopyClusterSnapshotResponse copyClusterSnapshot(CopyClusterSnapshotRequest copyClusterSnapshotRequest) throws ThrottlingException, ValidationException, ServiceQuotaExceededException, ConflictException, InternalServerException, ResourceNotFoundException, AccessDeniedException, AwsServiceException, SdkClientException, DocDbElasticException Copies a snapshot of an elastic cluster.
- Parameters:
copyClusterSnapshotRequest-- Returns:
- Result of the CopyClusterSnapshot operation returned by the service.
- See Also:
-
copyClusterSnapshot
default CopyClusterSnapshotResponse copyClusterSnapshot(Consumer<CopyClusterSnapshotRequest.Builder> copyClusterSnapshotRequest) throws ThrottlingException, ValidationException, ServiceQuotaExceededException, ConflictException, InternalServerException, ResourceNotFoundException, AccessDeniedException, AwsServiceException, SdkClientException, DocDbElasticException 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:
- Result of the CopyClusterSnapshot operation returned by the service.
- See Also:
-
createCluster
default CreateClusterResponse createCluster(CreateClusterRequest createClusterRequest) throws ThrottlingException, ValidationException, ServiceQuotaExceededException, ConflictException, InternalServerException, AccessDeniedException, AwsServiceException, SdkClientException, DocDbElasticException Creates a new Amazon DocumentDB elastic cluster and returns its cluster structure.
- Parameters:
createClusterRequest-- Returns:
- Result of the CreateCluster operation returned by the service.
- See Also:
-
createCluster
default CreateClusterResponse createCluster(Consumer<CreateClusterRequest.Builder> createClusterRequest) throws ThrottlingException, ValidationException, ServiceQuotaExceededException, ConflictException, InternalServerException, AccessDeniedException, AwsServiceException, SdkClientException, DocDbElasticException 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:
- Result of the CreateCluster operation returned by the service.
- See Also:
-
createClusterSnapshot
default CreateClusterSnapshotResponse createClusterSnapshot(CreateClusterSnapshotRequest createClusterSnapshotRequest) throws ThrottlingException, ValidationException, ServiceQuotaExceededException, ConflictException, InternalServerException, ResourceNotFoundException, AccessDeniedException, AwsServiceException, SdkClientException, DocDbElasticException Creates a snapshot of an elastic cluster.
- Parameters:
createClusterSnapshotRequest-- Returns:
- Result of the CreateClusterSnapshot operation returned by the service.
- See Also:
-
createClusterSnapshot
default CreateClusterSnapshotResponse createClusterSnapshot(Consumer<CreateClusterSnapshotRequest.Builder> createClusterSnapshotRequest) throws ThrottlingException, ValidationException, ServiceQuotaExceededException, ConflictException, InternalServerException, ResourceNotFoundException, AccessDeniedException, AwsServiceException, SdkClientException, DocDbElasticException 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:
- Result of the CreateClusterSnapshot operation returned by the service.
- See Also:
-
deleteCluster
default DeleteClusterResponse deleteCluster(DeleteClusterRequest deleteClusterRequest) throws ThrottlingException, ValidationException, ConflictException, InternalServerException, ResourceNotFoundException, AccessDeniedException, AwsServiceException, SdkClientException, DocDbElasticException Delete an elastic cluster.
- Parameters:
deleteClusterRequest-- Returns:
- Result of the DeleteCluster operation returned by the service.
- See Also:
-
deleteCluster
default DeleteClusterResponse deleteCluster(Consumer<DeleteClusterRequest.Builder> deleteClusterRequest) throws ThrottlingException, ValidationException, ConflictException, InternalServerException, ResourceNotFoundException, AccessDeniedException, AwsServiceException, SdkClientException, DocDbElasticException 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:
- Result of the DeleteCluster operation returned by the service.
- See Also:
-
deleteClusterSnapshot
default DeleteClusterSnapshotResponse deleteClusterSnapshot(DeleteClusterSnapshotRequest deleteClusterSnapshotRequest) throws ThrottlingException, ValidationException, ConflictException, InternalServerException, ResourceNotFoundException, AccessDeniedException, AwsServiceException, SdkClientException, DocDbElasticException Delete an elastic cluster snapshot.
- Parameters:
deleteClusterSnapshotRequest-- Returns:
- Result of the DeleteClusterSnapshot operation returned by the service.
- See Also:
-
deleteClusterSnapshot
default DeleteClusterSnapshotResponse deleteClusterSnapshot(Consumer<DeleteClusterSnapshotRequest.Builder> deleteClusterSnapshotRequest) throws ThrottlingException, ValidationException, ConflictException, InternalServerException, ResourceNotFoundException, AccessDeniedException, AwsServiceException, SdkClientException, DocDbElasticException 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:
- Result of the DeleteClusterSnapshot operation returned by the service.
- See Also:
-
getCluster
default GetClusterResponse getCluster(GetClusterRequest getClusterRequest) throws ThrottlingException, ValidationException, InternalServerException, ResourceNotFoundException, AccessDeniedException, AwsServiceException, SdkClientException, DocDbElasticException Returns information about a specific elastic cluster.
- Parameters:
getClusterRequest-- Returns:
- Result of the GetCluster operation returned by the service.
- See Also:
-
getCluster
default GetClusterResponse getCluster(Consumer<GetClusterRequest.Builder> getClusterRequest) throws ThrottlingException, ValidationException, InternalServerException, ResourceNotFoundException, AccessDeniedException, AwsServiceException, SdkClientException, DocDbElasticException 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:
- Result of the GetCluster operation returned by the service.
- See Also:
-
getClusterSnapshot
default GetClusterSnapshotResponse getClusterSnapshot(GetClusterSnapshotRequest getClusterSnapshotRequest) throws ThrottlingException, ValidationException, InternalServerException, ResourceNotFoundException, AccessDeniedException, AwsServiceException, SdkClientException, DocDbElasticException Returns information about a specific elastic cluster snapshot
- Parameters:
getClusterSnapshotRequest-- Returns:
- Result of the GetClusterSnapshot operation returned by the service.
- See Also:
-
getClusterSnapshot
default GetClusterSnapshotResponse getClusterSnapshot(Consumer<GetClusterSnapshotRequest.Builder> getClusterSnapshotRequest) throws ThrottlingException, ValidationException, InternalServerException, ResourceNotFoundException, AccessDeniedException, AwsServiceException, SdkClientException, DocDbElasticException 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:
- Result of the GetClusterSnapshot operation returned by the service.
- See Also:
-
getPendingMaintenanceAction
default GetPendingMaintenanceActionResponse getPendingMaintenanceAction(GetPendingMaintenanceActionRequest getPendingMaintenanceActionRequest) throws ThrottlingException, ValidationException, ConflictException, InternalServerException, ResourceNotFoundException, AccessDeniedException, AwsServiceException, SdkClientException, DocDbElasticException Retrieves all maintenance actions that are pending.
- Parameters:
getPendingMaintenanceActionRequest-- Returns:
- Result of the GetPendingMaintenanceAction operation returned by the service.
- See Also:
-
getPendingMaintenanceAction
default GetPendingMaintenanceActionResponse getPendingMaintenanceAction(Consumer<GetPendingMaintenanceActionRequest.Builder> getPendingMaintenanceActionRequest) throws ThrottlingException, ValidationException, ConflictException, InternalServerException, ResourceNotFoundException, AccessDeniedException, AwsServiceException, SdkClientException, DocDbElasticException Retrieves all maintenance actions that are pending.
This is a convenience which creates an instance of the
GetPendingMaintenanceActionRequest.Builderavoiding the need to create one manually viaGetPendingMaintenanceActionRequest.builder()- Parameters:
getPendingMaintenanceActionRequest- AConsumerthat will call methods onGetPendingMaintenanceActionRequest.Builderto create a request.- Returns:
- Result of the GetPendingMaintenanceAction operation returned by the service.
- See Also:
-
listClusterSnapshots
default ListClusterSnapshotsResponse listClusterSnapshots(ListClusterSnapshotsRequest listClusterSnapshotsRequest) throws ThrottlingException, ValidationException, InternalServerException, AccessDeniedException, AwsServiceException, SdkClientException, DocDbElasticException Returns information about snapshots for a specified elastic cluster.
- Parameters:
listClusterSnapshotsRequest-- Returns:
- Result of the ListClusterSnapshots operation returned by the service.
- See Also:
-
listClusterSnapshots
default ListClusterSnapshotsResponse listClusterSnapshots(Consumer<ListClusterSnapshotsRequest.Builder> listClusterSnapshotsRequest) throws ThrottlingException, ValidationException, InternalServerException, AccessDeniedException, AwsServiceException, SdkClientException, DocDbElasticException 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:
- Result of the ListClusterSnapshots operation returned by the service.
- See Also:
-
listClusterSnapshotsPaginator
default ListClusterSnapshotsIterable listClusterSnapshotsPaginator(ListClusterSnapshotsRequest listClusterSnapshotsRequest) throws ThrottlingException, ValidationException, InternalServerException, AccessDeniedException, AwsServiceException, SdkClientException, DocDbElasticException This is a variant of
listClusterSnapshots(software.amazon.awssdk.services.docdbelastic.model.ListClusterSnapshotsRequest)operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will internally handle making service calls for you.When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
2) Using For loopsoftware.amazon.awssdk.services.docdbelastic.paginators.ListClusterSnapshotsIterable responses = client.listClusterSnapshotsPaginator(request); responses.stream().forEach(....);{ @code software.amazon.awssdk.services.docdbelastic.paginators.ListClusterSnapshotsIterable responses = client .listClusterSnapshotsPaginator(request); for (software.amazon.awssdk.services.docdbelastic.model.ListClusterSnapshotsResponse response : responses) { // do something; } }3) Use iterator directlysoftware.amazon.awssdk.services.docdbelastic.paginators.ListClusterSnapshotsIterable responses = client.listClusterSnapshotsPaginator(request); responses.iterator().forEachRemaining(....);Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listClusterSnapshots(software.amazon.awssdk.services.docdbelastic.model.ListClusterSnapshotsRequest)operation.- Parameters:
listClusterSnapshotsRequest-- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- See Also:
-
listClusterSnapshotsPaginator
default ListClusterSnapshotsIterable listClusterSnapshotsPaginator(Consumer<ListClusterSnapshotsRequest.Builder> listClusterSnapshotsRequest) throws ThrottlingException, ValidationException, InternalServerException, AccessDeniedException, AwsServiceException, SdkClientException, DocDbElasticException This is a variant of
listClusterSnapshots(software.amazon.awssdk.services.docdbelastic.model.ListClusterSnapshotsRequest)operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will internally handle making service calls for you.When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
2) Using For loopsoftware.amazon.awssdk.services.docdbelastic.paginators.ListClusterSnapshotsIterable responses = client.listClusterSnapshotsPaginator(request); responses.stream().forEach(....);{ @code software.amazon.awssdk.services.docdbelastic.paginators.ListClusterSnapshotsIterable responses = client .listClusterSnapshotsPaginator(request); for (software.amazon.awssdk.services.docdbelastic.model.ListClusterSnapshotsResponse response : responses) { // do something; } }3) Use iterator directlysoftware.amazon.awssdk.services.docdbelastic.paginators.ListClusterSnapshotsIterable responses = client.listClusterSnapshotsPaginator(request); responses.iterator().forEachRemaining(....);Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
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 iterable that can be used to iterate through all the response pages.
- See Also:
-
listClusters
default ListClustersResponse listClusters(ListClustersRequest listClustersRequest) throws ThrottlingException, ValidationException, InternalServerException, AccessDeniedException, AwsServiceException, SdkClientException, DocDbElasticException Returns information about provisioned Amazon DocumentDB elastic clusters.
- Parameters:
listClustersRequest-- Returns:
- Result of the ListClusters operation returned by the service.
- See Also:
-
listClusters
default ListClustersResponse listClusters(Consumer<ListClustersRequest.Builder> listClustersRequest) throws ThrottlingException, ValidationException, InternalServerException, AccessDeniedException, AwsServiceException, SdkClientException, DocDbElasticException 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:
- Result of the ListClusters operation returned by the service.
- See Also:
-
listClustersPaginator
default ListClustersIterable listClustersPaginator(ListClustersRequest listClustersRequest) throws ThrottlingException, ValidationException, InternalServerException, AccessDeniedException, AwsServiceException, SdkClientException, DocDbElasticException This is a variant of
listClusters(software.amazon.awssdk.services.docdbelastic.model.ListClustersRequest)operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will internally handle making service calls for you.When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
2) Using For loopsoftware.amazon.awssdk.services.docdbelastic.paginators.ListClustersIterable responses = client.listClustersPaginator(request); responses.stream().forEach(....);{ @code software.amazon.awssdk.services.docdbelastic.paginators.ListClustersIterable responses = client .listClustersPaginator(request); for (software.amazon.awssdk.services.docdbelastic.model.ListClustersResponse response : responses) { // do something; } }3) Use iterator directlysoftware.amazon.awssdk.services.docdbelastic.paginators.ListClustersIterable responses = client.listClustersPaginator(request); responses.iterator().forEachRemaining(....);Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listClusters(software.amazon.awssdk.services.docdbelastic.model.ListClustersRequest)operation.- Parameters:
listClustersRequest-- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- See Also:
-
listClustersPaginator
default ListClustersIterable listClustersPaginator(Consumer<ListClustersRequest.Builder> listClustersRequest) throws ThrottlingException, ValidationException, InternalServerException, AccessDeniedException, AwsServiceException, SdkClientException, DocDbElasticException This is a variant of
listClusters(software.amazon.awssdk.services.docdbelastic.model.ListClustersRequest)operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will internally handle making service calls for you.When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
2) Using For loopsoftware.amazon.awssdk.services.docdbelastic.paginators.ListClustersIterable responses = client.listClustersPaginator(request); responses.stream().forEach(....);{ @code software.amazon.awssdk.services.docdbelastic.paginators.ListClustersIterable responses = client .listClustersPaginator(request); for (software.amazon.awssdk.services.docdbelastic.model.ListClustersResponse response : responses) { // do something; } }3) Use iterator directlysoftware.amazon.awssdk.services.docdbelastic.paginators.ListClustersIterable responses = client.listClustersPaginator(request); responses.iterator().forEachRemaining(....);Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
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 iterable that can be used to iterate through all the response pages.
- See Also:
-
listPendingMaintenanceActions
default ListPendingMaintenanceActionsResponse listPendingMaintenanceActions(ListPendingMaintenanceActionsRequest listPendingMaintenanceActionsRequest) throws ThrottlingException, ValidationException, InternalServerException, AccessDeniedException, AwsServiceException, SdkClientException, DocDbElasticException Retrieves a list of all maintenance actions that are pending.
- Parameters:
listPendingMaintenanceActionsRequest-- Returns:
- Result of the ListPendingMaintenanceActions operation returned by the service.
- See Also:
-
listPendingMaintenanceActions
default ListPendingMaintenanceActionsResponse listPendingMaintenanceActions(Consumer<ListPendingMaintenanceActionsRequest.Builder> listPendingMaintenanceActionsRequest) throws ThrottlingException, ValidationException, InternalServerException, AccessDeniedException, AwsServiceException, SdkClientException, DocDbElasticException Retrieves a list of all maintenance actions that are pending.
This is a convenience which creates an instance of the
ListPendingMaintenanceActionsRequest.Builderavoiding the need to create one manually viaListPendingMaintenanceActionsRequest.builder()- Parameters:
listPendingMaintenanceActionsRequest- AConsumerthat will call methods onListPendingMaintenanceActionsRequest.Builderto create a request.- Returns:
- Result of the ListPendingMaintenanceActions operation returned by the service.
- See Also:
-
listPendingMaintenanceActionsPaginator
default ListPendingMaintenanceActionsIterable listPendingMaintenanceActionsPaginator(ListPendingMaintenanceActionsRequest listPendingMaintenanceActionsRequest) throws ThrottlingException, ValidationException, InternalServerException, AccessDeniedException, AwsServiceException, SdkClientException, DocDbElasticException This is a variant of
listPendingMaintenanceActions(software.amazon.awssdk.services.docdbelastic.model.ListPendingMaintenanceActionsRequest)operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will internally handle making service calls for you.When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
2) Using For loopsoftware.amazon.awssdk.services.docdbelastic.paginators.ListPendingMaintenanceActionsIterable responses = client.listPendingMaintenanceActionsPaginator(request); responses.stream().forEach(....);{ @code software.amazon.awssdk.services.docdbelastic.paginators.ListPendingMaintenanceActionsIterable responses = client .listPendingMaintenanceActionsPaginator(request); for (software.amazon.awssdk.services.docdbelastic.model.ListPendingMaintenanceActionsResponse response : responses) { // do something; } }3) Use iterator directlysoftware.amazon.awssdk.services.docdbelastic.paginators.ListPendingMaintenanceActionsIterable responses = client.listPendingMaintenanceActionsPaginator(request); responses.iterator().forEachRemaining(....);Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listPendingMaintenanceActions(software.amazon.awssdk.services.docdbelastic.model.ListPendingMaintenanceActionsRequest)operation.- Parameters:
listPendingMaintenanceActionsRequest-- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- See Also:
-
listPendingMaintenanceActionsPaginator
default ListPendingMaintenanceActionsIterable listPendingMaintenanceActionsPaginator(Consumer<ListPendingMaintenanceActionsRequest.Builder> listPendingMaintenanceActionsRequest) throws ThrottlingException, ValidationException, InternalServerException, AccessDeniedException, AwsServiceException, SdkClientException, DocDbElasticException This is a variant of
listPendingMaintenanceActions(software.amazon.awssdk.services.docdbelastic.model.ListPendingMaintenanceActionsRequest)operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will internally handle making service calls for you.When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
2) Using For loopsoftware.amazon.awssdk.services.docdbelastic.paginators.ListPendingMaintenanceActionsIterable responses = client.listPendingMaintenanceActionsPaginator(request); responses.stream().forEach(....);{ @code software.amazon.awssdk.services.docdbelastic.paginators.ListPendingMaintenanceActionsIterable responses = client .listPendingMaintenanceActionsPaginator(request); for (software.amazon.awssdk.services.docdbelastic.model.ListPendingMaintenanceActionsResponse response : responses) { // do something; } }3) Use iterator directlysoftware.amazon.awssdk.services.docdbelastic.paginators.ListPendingMaintenanceActionsIterable responses = client.listPendingMaintenanceActionsPaginator(request); responses.iterator().forEachRemaining(....);Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listPendingMaintenanceActions(software.amazon.awssdk.services.docdbelastic.model.ListPendingMaintenanceActionsRequest)operation.
This is a convenience which creates an instance of the
ListPendingMaintenanceActionsRequest.Builderavoiding the need to create one manually viaListPendingMaintenanceActionsRequest.builder()- Parameters:
listPendingMaintenanceActionsRequest- AConsumerthat will call methods onListPendingMaintenanceActionsRequest.Builderto create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- See Also:
-
listTagsForResource
default ListTagsForResourceResponse listTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest) throws ThrottlingException, ValidationException, InternalServerException, ResourceNotFoundException, AwsServiceException, SdkClientException, DocDbElasticException Lists all tags on a elastic cluster resource
- Parameters:
listTagsForResourceRequest-- Returns:
- Result of the ListTagsForResource operation returned by the service.
- See Also:
-
listTagsForResource
default ListTagsForResourceResponse listTagsForResource(Consumer<ListTagsForResourceRequest.Builder> listTagsForResourceRequest) throws ThrottlingException, ValidationException, InternalServerException, ResourceNotFoundException, AwsServiceException, SdkClientException, DocDbElasticException 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:
- Result of the ListTagsForResource operation returned by the service.
- See Also:
-
restoreClusterFromSnapshot
default RestoreClusterFromSnapshotResponse restoreClusterFromSnapshot(RestoreClusterFromSnapshotRequest restoreClusterFromSnapshotRequest) throws ThrottlingException, ValidationException, ServiceQuotaExceededException, ConflictException, InternalServerException, ResourceNotFoundException, AccessDeniedException, AwsServiceException, SdkClientException, DocDbElasticException Restores an elastic cluster from a snapshot.
- Parameters:
restoreClusterFromSnapshotRequest-- Returns:
- Result of the RestoreClusterFromSnapshot operation returned by the service.
- See Also:
-
restoreClusterFromSnapshot
default RestoreClusterFromSnapshotResponse restoreClusterFromSnapshot(Consumer<RestoreClusterFromSnapshotRequest.Builder> restoreClusterFromSnapshotRequest) throws ThrottlingException, ValidationException, ServiceQuotaExceededException, ConflictException, InternalServerException, ResourceNotFoundException, AccessDeniedException, AwsServiceException, SdkClientException, DocDbElasticException 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:
- Result of the RestoreClusterFromSnapshot operation returned by the service.
- See Also:
-
startCluster
default StartClusterResponse startCluster(StartClusterRequest startClusterRequest) throws ThrottlingException, ValidationException, InternalServerException, ResourceNotFoundException, AccessDeniedException, AwsServiceException, SdkClientException, DocDbElasticException Restarts the stopped elastic cluster that is specified by
clusterARN.- Parameters:
startClusterRequest-- Returns:
- Result of the StartCluster operation returned by the service.
- See Also:
-
startCluster
default StartClusterResponse startCluster(Consumer<StartClusterRequest.Builder> startClusterRequest) throws ThrottlingException, ValidationException, InternalServerException, ResourceNotFoundException, AccessDeniedException, AwsServiceException, SdkClientException, DocDbElasticException 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:
- Result of the StartCluster operation returned by the service.
- See Also:
-
stopCluster
default StopClusterResponse stopCluster(StopClusterRequest stopClusterRequest) throws ThrottlingException, ValidationException, InternalServerException, ResourceNotFoundException, AccessDeniedException, AwsServiceException, SdkClientException, DocDbElasticException Stops the running elastic cluster that is specified by
clusterArn. The elastic cluster must be in the available state.- Parameters:
stopClusterRequest-- Returns:
- Result of the StopCluster operation returned by the service.
- See Also:
-
stopCluster
default StopClusterResponse stopCluster(Consumer<StopClusterRequest.Builder> stopClusterRequest) throws ThrottlingException, ValidationException, InternalServerException, ResourceNotFoundException, AccessDeniedException, AwsServiceException, SdkClientException, DocDbElasticException 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:
- Result of the StopCluster operation returned by the service.
- See Also:
-
tagResource
default TagResourceResponse tagResource(TagResourceRequest tagResourceRequest) throws ThrottlingException, ValidationException, InternalServerException, ResourceNotFoundException, AwsServiceException, SdkClientException, DocDbElasticException Adds metadata tags to an elastic cluster resource
- Parameters:
tagResourceRequest-- Returns:
- Result of the TagResource operation returned by the service.
- See Also:
-
tagResource
default TagResourceResponse tagResource(Consumer<TagResourceRequest.Builder> tagResourceRequest) throws ThrottlingException, ValidationException, InternalServerException, ResourceNotFoundException, AwsServiceException, SdkClientException, DocDbElasticException 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:
- Result of the TagResource operation returned by the service.
- See Also:
-
untagResource
default UntagResourceResponse untagResource(UntagResourceRequest untagResourceRequest) throws ThrottlingException, ValidationException, InternalServerException, ResourceNotFoundException, AwsServiceException, SdkClientException, DocDbElasticException Removes metadata tags from an elastic cluster resource
- Parameters:
untagResourceRequest-- Returns:
- Result of the UntagResource operation returned by the service.
- See Also:
-
untagResource
default UntagResourceResponse untagResource(Consumer<UntagResourceRequest.Builder> untagResourceRequest) throws ThrottlingException, ValidationException, InternalServerException, ResourceNotFoundException, AwsServiceException, SdkClientException, DocDbElasticException 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:
- Result of the UntagResource operation returned by the service.
- See Also:
-
updateCluster
default UpdateClusterResponse updateCluster(UpdateClusterRequest updateClusterRequest) throws ThrottlingException, ValidationException, ConflictException, InternalServerException, ResourceNotFoundException, AccessDeniedException, AwsServiceException, SdkClientException, DocDbElasticException 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:
- Result of the UpdateCluster operation returned by the service.
- See Also:
-
updateCluster
default UpdateClusterResponse updateCluster(Consumer<UpdateClusterRequest.Builder> updateClusterRequest) throws ThrottlingException, ValidationException, ConflictException, InternalServerException, ResourceNotFoundException, AccessDeniedException, AwsServiceException, SdkClientException, DocDbElasticException 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:
- Result of the UpdateCluster operation returned by the service.
- See Also:
-
create
Create aDocDbElasticClientwith the region loaded from theDefaultAwsRegionProviderChainand credentials loaded from theDefaultCredentialsProvider. -
builder
Create a builder that can be used to configure and create aDocDbElasticClient. -
serviceMetadata
-
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
-