@Generated(value="software.amazon.awssdk:codegen") @ThreadSafe public interface DocDbElasticClient extends AwsClient
builder() method.
The new Amazon Elastic DocumentDB service endpoint.
| Modifier and Type | Field and Description |
|---|---|
static String |
SERVICE_METADATA_ID
Value for looking up the service's metadata from the
ServiceMetadataProvider. |
static String |
SERVICE_NAME |
| Modifier and Type | Method and Description |
|---|---|
static DocDbElasticClientBuilder |
builder()
Create a builder that can be used to configure and create a
DocDbElasticClient. |
static DocDbElasticClient |
create()
Create a
DocDbElasticClient with the region loaded from the
DefaultAwsRegionProviderChain and credentials loaded from the
DefaultCredentialsProvider. |
default CreateClusterResponse |
createCluster(Consumer<CreateClusterRequest.Builder> createClusterRequest)
Creates a new Elastic DocumentDB cluster and returns its Cluster structure.
|
default CreateClusterResponse |
createCluster(CreateClusterRequest createClusterRequest)
Creates a new Elastic DocumentDB cluster and returns its Cluster structure.
|
default CreateClusterSnapshotResponse |
createClusterSnapshot(Consumer<CreateClusterSnapshotRequest.Builder> createClusterSnapshotRequest)
Creates a snapshot of a cluster.
|
default CreateClusterSnapshotResponse |
createClusterSnapshot(CreateClusterSnapshotRequest createClusterSnapshotRequest)
Creates a snapshot of a cluster.
|
default DeleteClusterResponse |
deleteCluster(Consumer<DeleteClusterRequest.Builder> deleteClusterRequest)
Delete a Elastic DocumentDB cluster.
|
default DeleteClusterResponse |
deleteCluster(DeleteClusterRequest deleteClusterRequest)
Delete a Elastic DocumentDB cluster.
|
default DeleteClusterSnapshotResponse |
deleteClusterSnapshot(Consumer<DeleteClusterSnapshotRequest.Builder> deleteClusterSnapshotRequest)
Delete a Elastic DocumentDB snapshot.
|
default DeleteClusterSnapshotResponse |
deleteClusterSnapshot(DeleteClusterSnapshotRequest deleteClusterSnapshotRequest)
Delete a Elastic DocumentDB snapshot.
|
default GetClusterResponse |
getCluster(Consumer<GetClusterRequest.Builder> getClusterRequest)
Returns information about a specific Elastic DocumentDB cluster.
|
default GetClusterResponse |
getCluster(GetClusterRequest getClusterRequest)
Returns information about a specific Elastic DocumentDB cluster.
|
default GetClusterSnapshotResponse |
getClusterSnapshot(Consumer<GetClusterSnapshotRequest.Builder> getClusterSnapshotRequest)
Returns information about a specific Elastic DocumentDB snapshot
|
default GetClusterSnapshotResponse |
getClusterSnapshot(GetClusterSnapshotRequest getClusterSnapshotRequest)
Returns information about a specific Elastic DocumentDB snapshot
|
default ListClustersResponse |
listClusters(Consumer<ListClustersRequest.Builder> listClustersRequest)
Returns information about provisioned Elastic DocumentDB clusters.
|
default ListClustersResponse |
listClusters(ListClustersRequest listClustersRequest)
Returns information about provisioned Elastic DocumentDB clusters.
|
default ListClusterSnapshotsResponse |
listClusterSnapshots(Consumer<ListClusterSnapshotsRequest.Builder> listClusterSnapshotsRequest)
Returns information about Elastic DocumentDB snapshots for a specified cluster.
|
default ListClusterSnapshotsResponse |
listClusterSnapshots(ListClusterSnapshotsRequest listClusterSnapshotsRequest)
Returns information about Elastic DocumentDB snapshots for a specified cluster.
|
default ListClusterSnapshotsIterable |
listClusterSnapshotsPaginator(Consumer<ListClusterSnapshotsRequest.Builder> listClusterSnapshotsRequest)
Returns information about Elastic DocumentDB snapshots for a specified cluster.
|
default ListClusterSnapshotsIterable |
listClusterSnapshotsPaginator(ListClusterSnapshotsRequest listClusterSnapshotsRequest)
Returns information about Elastic DocumentDB snapshots for a specified cluster.
|
default ListClustersIterable |
listClustersPaginator(Consumer<ListClustersRequest.Builder> listClustersRequest)
Returns information about provisioned Elastic DocumentDB clusters.
|
default ListClustersIterable |
listClustersPaginator(ListClustersRequest listClustersRequest)
Returns information about provisioned Elastic DocumentDB clusters.
|
default ListTagsForResourceResponse |
listTagsForResource(Consumer<ListTagsForResourceRequest.Builder> listTagsForResourceRequest)
Lists all tags on a Elastic DocumentDB resource
|
default ListTagsForResourceResponse |
listTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest)
Lists all tags on a Elastic DocumentDB resource
|
default RestoreClusterFromSnapshotResponse |
restoreClusterFromSnapshot(Consumer<RestoreClusterFromSnapshotRequest.Builder> restoreClusterFromSnapshotRequest)
Restores a Elastic DocumentDB cluster from a snapshot.
|
default RestoreClusterFromSnapshotResponse |
restoreClusterFromSnapshot(RestoreClusterFromSnapshotRequest restoreClusterFromSnapshotRequest)
Restores a Elastic DocumentDB cluster from a snapshot.
|
default DocDbElasticServiceClientConfiguration |
serviceClientConfiguration() |
static ServiceMetadata |
serviceMetadata() |
default TagResourceResponse |
tagResource(Consumer<TagResourceRequest.Builder> tagResourceRequest)
Adds metadata tags to a Elastic DocumentDB resource
|
default TagResourceResponse |
tagResource(TagResourceRequest tagResourceRequest)
Adds metadata tags to a Elastic DocumentDB resource
|
default UntagResourceResponse |
untagResource(Consumer<UntagResourceRequest.Builder> untagResourceRequest)
Removes metadata tags to a Elastic DocumentDB resource
|
default UntagResourceResponse |
untagResource(UntagResourceRequest untagResourceRequest)
Removes metadata tags to a Elastic DocumentDB resource
|
default UpdateClusterResponse |
updateCluster(Consumer<UpdateClusterRequest.Builder> updateClusterRequest)
Modifies a Elastic DocumentDB cluster.
|
default UpdateClusterResponse |
updateCluster(UpdateClusterRequest updateClusterRequest)
Modifies a Elastic DocumentDB cluster.
|
serviceNameclosestatic final String SERVICE_NAME
static final String SERVICE_METADATA_ID
ServiceMetadataProvider.default CreateClusterResponse createCluster(CreateClusterRequest createClusterRequest) throws ThrottlingException, ValidationException, ServiceQuotaExceededException, ConflictException, InternalServerException, AccessDeniedException, AwsServiceException, SdkClientException, DocDbElasticException
Creates a new Elastic DocumentDB cluster and returns its Cluster structure.
createClusterRequest - 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.AwsServiceExceptiondefault CreateClusterResponse createCluster(Consumer<CreateClusterRequest.Builder> createClusterRequest) throws ThrottlingException, ValidationException, ServiceQuotaExceededException, ConflictException, InternalServerException, AccessDeniedException, AwsServiceException, SdkClientException, DocDbElasticException
Creates a new Elastic DocumentDB cluster and returns its Cluster structure.
This is a convenience which creates an instance of the CreateClusterRequest.Builder avoiding the need to
create one manually via CreateClusterRequest.builder()
createClusterRequest - A Consumer that will call methods on
CreateClusterRequest.Builder to create a
request.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.AwsServiceExceptiondefault CreateClusterSnapshotResponse createClusterSnapshot(CreateClusterSnapshotRequest createClusterSnapshotRequest) throws ThrottlingException, ValidationException, ServiceQuotaExceededException, ConflictException, InternalServerException, ResourceNotFoundException, AccessDeniedException, AwsServiceException, SdkClientException, DocDbElasticException
Creates a snapshot of a cluster.
createClusterSnapshotRequest - 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.AwsServiceExceptiondefault CreateClusterSnapshotResponse createClusterSnapshot(Consumer<CreateClusterSnapshotRequest.Builder> createClusterSnapshotRequest) throws ThrottlingException, ValidationException, ServiceQuotaExceededException, ConflictException, InternalServerException, ResourceNotFoundException, AccessDeniedException, AwsServiceException, SdkClientException, DocDbElasticException
Creates a snapshot of a cluster.
This is a convenience which creates an instance of the CreateClusterSnapshotRequest.Builder avoiding the
need to create one manually via CreateClusterSnapshotRequest.builder()
createClusterSnapshotRequest - A Consumer that will call methods on
CreateClusterSnapshotRequest.Builder to create
a request.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.AwsServiceExceptiondefault DeleteClusterResponse deleteCluster(DeleteClusterRequest deleteClusterRequest) throws ThrottlingException, ValidationException, ConflictException, InternalServerException, ResourceNotFoundException, AccessDeniedException, AwsServiceException, SdkClientException, DocDbElasticException
Delete a Elastic DocumentDB cluster.
deleteClusterRequest - 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.AwsServiceExceptiondefault DeleteClusterResponse deleteCluster(Consumer<DeleteClusterRequest.Builder> deleteClusterRequest) throws ThrottlingException, ValidationException, ConflictException, InternalServerException, ResourceNotFoundException, AccessDeniedException, AwsServiceException, SdkClientException, DocDbElasticException
Delete a Elastic DocumentDB cluster.
This is a convenience which creates an instance of the DeleteClusterRequest.Builder avoiding the need to
create one manually via DeleteClusterRequest.builder()
deleteClusterRequest - A Consumer that will call methods on
DeleteClusterRequest.Builder to create a
request.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.AwsServiceExceptiondefault DeleteClusterSnapshotResponse deleteClusterSnapshot(DeleteClusterSnapshotRequest deleteClusterSnapshotRequest) throws ThrottlingException, ValidationException, ConflictException, InternalServerException, ResourceNotFoundException, AccessDeniedException, AwsServiceException, SdkClientException, DocDbElasticException
Delete a Elastic DocumentDB snapshot.
deleteClusterSnapshotRequest - 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.AwsServiceExceptiondefault DeleteClusterSnapshotResponse deleteClusterSnapshot(Consumer<DeleteClusterSnapshotRequest.Builder> deleteClusterSnapshotRequest) throws ThrottlingException, ValidationException, ConflictException, InternalServerException, ResourceNotFoundException, AccessDeniedException, AwsServiceException, SdkClientException, DocDbElasticException
Delete a Elastic DocumentDB snapshot.
This is a convenience which creates an instance of the DeleteClusterSnapshotRequest.Builder avoiding the
need to create one manually via DeleteClusterSnapshotRequest.builder()
deleteClusterSnapshotRequest - A Consumer that will call methods on
DeleteClusterSnapshotRequest.Builder to create
a request.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.AwsServiceExceptiondefault GetClusterResponse getCluster(GetClusterRequest getClusterRequest) throws ThrottlingException, ValidationException, InternalServerException, ResourceNotFoundException, AccessDeniedException, AwsServiceException, SdkClientException, DocDbElasticException
Returns information about a specific Elastic DocumentDB cluster.
getClusterRequest - 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.AwsServiceExceptiondefault GetClusterResponse getCluster(Consumer<GetClusterRequest.Builder> getClusterRequest) throws ThrottlingException, ValidationException, InternalServerException, ResourceNotFoundException, AccessDeniedException, AwsServiceException, SdkClientException, DocDbElasticException
Returns information about a specific Elastic DocumentDB cluster.
This is a convenience which creates an instance of the GetClusterRequest.Builder avoiding the need to
create one manually via GetClusterRequest.builder()
getClusterRequest - A Consumer that will call methods on
GetClusterRequest.Builder to create a request.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.AwsServiceExceptiondefault GetClusterSnapshotResponse getClusterSnapshot(GetClusterSnapshotRequest getClusterSnapshotRequest) throws ThrottlingException, ValidationException, InternalServerException, ResourceNotFoundException, AccessDeniedException, AwsServiceException, SdkClientException, DocDbElasticException
Returns information about a specific Elastic DocumentDB snapshot
getClusterSnapshotRequest - 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.AwsServiceExceptiondefault GetClusterSnapshotResponse getClusterSnapshot(Consumer<GetClusterSnapshotRequest.Builder> getClusterSnapshotRequest) throws ThrottlingException, ValidationException, InternalServerException, ResourceNotFoundException, AccessDeniedException, AwsServiceException, SdkClientException, DocDbElasticException
Returns information about a specific Elastic DocumentDB snapshot
This is a convenience which creates an instance of the GetClusterSnapshotRequest.Builder avoiding the
need to create one manually via GetClusterSnapshotRequest.builder()
getClusterSnapshotRequest - A Consumer that will call methods on
GetClusterSnapshotRequest.Builder to create a
request.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.AwsServiceExceptiondefault ListClusterSnapshotsResponse listClusterSnapshots(ListClusterSnapshotsRequest listClusterSnapshotsRequest) throws ThrottlingException, ValidationException, InternalServerException, AccessDeniedException, AwsServiceException, SdkClientException, DocDbElasticException
Returns information about Elastic DocumentDB snapshots for a specified cluster.
listClusterSnapshotsRequest - 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.AwsServiceExceptiondefault ListClusterSnapshotsResponse listClusterSnapshots(Consumer<ListClusterSnapshotsRequest.Builder> listClusterSnapshotsRequest) throws ThrottlingException, ValidationException, InternalServerException, AccessDeniedException, AwsServiceException, SdkClientException, DocDbElasticException
Returns information about Elastic DocumentDB snapshots for a specified cluster.
This is a convenience which creates an instance of the ListClusterSnapshotsRequest.Builder avoiding the
need to create one manually via ListClusterSnapshotsRequest.builder()
listClusterSnapshotsRequest - A Consumer that will call methods on
ListClusterSnapshotsRequest.Builder to create a
request.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.AwsServiceExceptiondefault ListClusterSnapshotsIterable listClusterSnapshotsPaginator(ListClusterSnapshotsRequest listClusterSnapshotsRequest) throws ThrottlingException, ValidationException, InternalServerException, AccessDeniedException, AwsServiceException, SdkClientException, DocDbElasticException
Returns information about Elastic DocumentDB snapshots for a specified cluster.
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
software.amazon.awssdk.services.docdbelastic.paginators.ListClusterSnapshotsIterable responses = client.listClusterSnapshotsPaginator(request);
responses.stream().forEach(....);
2) Using For loop
{
@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 directly
software.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.
listClusterSnapshotsRequest - 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.AwsServiceExceptiondefault ListClusterSnapshotsIterable listClusterSnapshotsPaginator(Consumer<ListClusterSnapshotsRequest.Builder> listClusterSnapshotsRequest) throws ThrottlingException, ValidationException, InternalServerException, AccessDeniedException, AwsServiceException, SdkClientException, DocDbElasticException
Returns information about Elastic DocumentDB snapshots for a specified cluster.
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
software.amazon.awssdk.services.docdbelastic.paginators.ListClusterSnapshotsIterable responses = client.listClusterSnapshotsPaginator(request);
responses.stream().forEach(....);
2) Using For loop
{
@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 directly
software.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.Builder avoiding the
need to create one manually via ListClusterSnapshotsRequest.builder()
listClusterSnapshotsRequest - A Consumer that will call methods on
ListClusterSnapshotsRequest.Builder to create a
request.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.AwsServiceExceptiondefault ListClustersResponse listClusters(ListClustersRequest listClustersRequest) throws ThrottlingException, ValidationException, InternalServerException, AccessDeniedException, AwsServiceException, SdkClientException, DocDbElasticException
Returns information about provisioned Elastic DocumentDB clusters.
listClustersRequest - 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.AwsServiceExceptiondefault ListClustersResponse listClusters(Consumer<ListClustersRequest.Builder> listClustersRequest) throws ThrottlingException, ValidationException, InternalServerException, AccessDeniedException, AwsServiceException, SdkClientException, DocDbElasticException
Returns information about provisioned Elastic DocumentDB clusters.
This is a convenience which creates an instance of the ListClustersRequest.Builder avoiding the need to
create one manually via ListClustersRequest.builder()
listClustersRequest - A Consumer that will call methods on
ListClustersRequest.Builder to create a
request.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.AwsServiceExceptiondefault ListClustersIterable listClustersPaginator(ListClustersRequest listClustersRequest) throws ThrottlingException, ValidationException, InternalServerException, AccessDeniedException, AwsServiceException, SdkClientException, DocDbElasticException
Returns information about provisioned Elastic DocumentDB clusters.
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
software.amazon.awssdk.services.docdbelastic.paginators.ListClustersIterable responses = client.listClustersPaginator(request);
responses.stream().forEach(....);
2) Using For loop
{
@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 directly
software.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.
listClustersRequest - 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.AwsServiceExceptiondefault ListClustersIterable listClustersPaginator(Consumer<ListClustersRequest.Builder> listClustersRequest) throws ThrottlingException, ValidationException, InternalServerException, AccessDeniedException, AwsServiceException, SdkClientException, DocDbElasticException
Returns information about provisioned Elastic DocumentDB clusters.
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
software.amazon.awssdk.services.docdbelastic.paginators.ListClustersIterable responses = client.listClustersPaginator(request);
responses.stream().forEach(....);
2) Using For loop
{
@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 directly
software.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.Builder avoiding the need to
create one manually via ListClustersRequest.builder()
listClustersRequest - A Consumer that will call methods on
ListClustersRequest.Builder to create a
request.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.AwsServiceExceptiondefault ListTagsForResourceResponse listTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest) throws ThrottlingException, ValidationException, InternalServerException, ResourceNotFoundException, AwsServiceException, SdkClientException, DocDbElasticException
Lists all tags on a Elastic DocumentDB resource
listTagsForResourceRequest - 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.AwsServiceExceptiondefault ListTagsForResourceResponse listTagsForResource(Consumer<ListTagsForResourceRequest.Builder> listTagsForResourceRequest) throws ThrottlingException, ValidationException, InternalServerException, ResourceNotFoundException, AwsServiceException, SdkClientException, DocDbElasticException
Lists all tags on a Elastic DocumentDB resource
This is a convenience which creates an instance of the ListTagsForResourceRequest.Builder avoiding the
need to create one manually via ListTagsForResourceRequest.builder()
listTagsForResourceRequest - A Consumer that will call methods on
ListTagsForResourceRequest.Builder to create a
request.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.AwsServiceExceptiondefault RestoreClusterFromSnapshotResponse restoreClusterFromSnapshot(RestoreClusterFromSnapshotRequest restoreClusterFromSnapshotRequest) throws ThrottlingException, ValidationException, ServiceQuotaExceededException, ConflictException, InternalServerException, ResourceNotFoundException, AccessDeniedException, AwsServiceException, SdkClientException, DocDbElasticException
Restores a Elastic DocumentDB cluster from a snapshot.
restoreClusterFromSnapshotRequest - 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.AwsServiceExceptiondefault RestoreClusterFromSnapshotResponse restoreClusterFromSnapshot(Consumer<RestoreClusterFromSnapshotRequest.Builder> restoreClusterFromSnapshotRequest) throws ThrottlingException, ValidationException, ServiceQuotaExceededException, ConflictException, InternalServerException, ResourceNotFoundException, AccessDeniedException, AwsServiceException, SdkClientException, DocDbElasticException
Restores a Elastic DocumentDB cluster from a snapshot.
This is a convenience which creates an instance of the RestoreClusterFromSnapshotRequest.Builder avoiding
the need to create one manually via RestoreClusterFromSnapshotRequest.builder()
restoreClusterFromSnapshotRequest - A Consumer that will call methods on
RestoreClusterFromSnapshotRequest.Builder to
create a request.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.AwsServiceExceptiondefault TagResourceResponse tagResource(TagResourceRequest tagResourceRequest) throws ThrottlingException, ValidationException, InternalServerException, ResourceNotFoundException, AwsServiceException, SdkClientException, DocDbElasticException
Adds metadata tags to a Elastic DocumentDB resource
tagResourceRequest - 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.AwsServiceExceptiondefault TagResourceResponse tagResource(Consumer<TagResourceRequest.Builder> tagResourceRequest) throws ThrottlingException, ValidationException, InternalServerException, ResourceNotFoundException, AwsServiceException, SdkClientException, DocDbElasticException
Adds metadata tags to a Elastic DocumentDB resource
This is a convenience which creates an instance of the TagResourceRequest.Builder avoiding the need to
create one manually via TagResourceRequest.builder()
tagResourceRequest - A Consumer that will call methods on
TagResourceRequest.Builder to create a request.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.AwsServiceExceptiondefault UntagResourceResponse untagResource(UntagResourceRequest untagResourceRequest) throws ThrottlingException, ValidationException, InternalServerException, ResourceNotFoundException, AwsServiceException, SdkClientException, DocDbElasticException
Removes metadata tags to a Elastic DocumentDB resource
untagResourceRequest - 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.AwsServiceExceptiondefault UntagResourceResponse untagResource(Consumer<UntagResourceRequest.Builder> untagResourceRequest) throws ThrottlingException, ValidationException, InternalServerException, ResourceNotFoundException, AwsServiceException, SdkClientException, DocDbElasticException
Removes metadata tags to a Elastic DocumentDB resource
This is a convenience which creates an instance of the UntagResourceRequest.Builder avoiding the need to
create one manually via UntagResourceRequest.builder()
untagResourceRequest - A Consumer that will call methods on
UntagResourceRequest.Builder to create a
request.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.AwsServiceExceptiondefault UpdateClusterResponse updateCluster(UpdateClusterRequest updateClusterRequest) throws ThrottlingException, ValidationException, ConflictException, InternalServerException, ResourceNotFoundException, AccessDeniedException, AwsServiceException, SdkClientException, DocDbElasticException
Modifies a Elastic DocumentDB cluster. This includes updating admin-username/password, upgrading API version setting up a backup window and maintenance window
updateClusterRequest - 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.AwsServiceExceptiondefault UpdateClusterResponse updateCluster(Consumer<UpdateClusterRequest.Builder> updateClusterRequest) throws ThrottlingException, ValidationException, ConflictException, InternalServerException, ResourceNotFoundException, AccessDeniedException, AwsServiceException, SdkClientException, DocDbElasticException
Modifies a Elastic DocumentDB cluster. This includes updating admin-username/password, upgrading API version setting up a backup window and maintenance window
This is a convenience which creates an instance of the UpdateClusterRequest.Builder avoiding the need to
create one manually via UpdateClusterRequest.builder()
updateClusterRequest - A Consumer that will call methods on
UpdateClusterRequest.Builder to create a
request.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.AwsServiceExceptionstatic DocDbElasticClient create()
DocDbElasticClient with the region loaded from the
DefaultAwsRegionProviderChain and credentials loaded from the
DefaultCredentialsProvider.static DocDbElasticClientBuilder builder()
DocDbElasticClient.static ServiceMetadata serviceMetadata()
default DocDbElasticServiceClientConfiguration serviceClientConfiguration()
serviceClientConfiguration in interface AwsClientserviceClientConfiguration in interface SdkClientCopyright © 2023. All rights reserved.