Interface DocDbAsyncClient
- All Superinterfaces:
AutoCloseable
,AwsClient
,SdkAutoCloseable
,SdkClient
builder()
method.The asynchronous client performs non-blocking I/O when configured with any SdkAsyncHttpClient
supported in the SDK. However, full non-blocking is not guaranteed as the async client may perform blocking calls in
some cases such as credentials retrieval and endpoint discovery as part of the async API call.
Amazon DocumentDB is a fast, reliable, and fully managed database service. Amazon DocumentDB makes it easy to set up, operate, and scale MongoDB-compatible databases in the cloud. With Amazon DocumentDB, you can run the same application code and use the same drivers and tools that you use with MongoDB.
-
Field Summary
Modifier and TypeFieldDescriptionstatic final String
Value for looking up the service's metadata from theServiceMetadataProvider
.static final String
-
Method Summary
Modifier and TypeMethodDescriptionaddSourceIdentifierToSubscription
(Consumer<AddSourceIdentifierToSubscriptionRequest.Builder> addSourceIdentifierToSubscriptionRequest) Adds a source identifier to an existing event notification subscription.addSourceIdentifierToSubscription
(AddSourceIdentifierToSubscriptionRequest addSourceIdentifierToSubscriptionRequest) Adds a source identifier to an existing event notification subscription.addTagsToResource
(Consumer<AddTagsToResourceRequest.Builder> addTagsToResourceRequest) Adds metadata tags to an Amazon DocumentDB resource.addTagsToResource
(AddTagsToResourceRequest addTagsToResourceRequest) Adds metadata tags to an Amazon DocumentDB resource.applyPendingMaintenanceAction
(Consumer<ApplyPendingMaintenanceActionRequest.Builder> applyPendingMaintenanceActionRequest) Applies a pending maintenance action to a resource (for example, to an Amazon DocumentDB instance).applyPendingMaintenanceAction
(ApplyPendingMaintenanceActionRequest applyPendingMaintenanceActionRequest) Applies a pending maintenance action to a resource (for example, to an Amazon DocumentDB instance).static DocDbAsyncClientBuilder
builder()
Create a builder that can be used to configure and create aDocDbAsyncClient
.copyDBClusterParameterGroup
(Consumer<CopyDbClusterParameterGroupRequest.Builder> copyDbClusterParameterGroupRequest) Copies the specified cluster parameter group.copyDBClusterParameterGroup
(CopyDbClusterParameterGroupRequest copyDbClusterParameterGroupRequest) Copies the specified cluster parameter group.copyDBClusterSnapshot
(Consumer<CopyDbClusterSnapshotRequest.Builder> copyDbClusterSnapshotRequest) Copies a snapshot of a cluster.copyDBClusterSnapshot
(CopyDbClusterSnapshotRequest copyDbClusterSnapshotRequest) Copies a snapshot of a cluster.static DocDbAsyncClient
create()
Create aDocDbAsyncClient
with the region loaded from theDefaultAwsRegionProviderChain
and credentials loaded from theDefaultCredentialsProvider
.default CompletableFuture
<CreateDbClusterResponse> createDBCluster
(Consumer<CreateDbClusterRequest.Builder> createDbClusterRequest) Creates a new Amazon DocumentDB cluster.default CompletableFuture
<CreateDbClusterResponse> createDBCluster
(CreateDbClusterRequest createDbClusterRequest) Creates a new Amazon DocumentDB cluster.createDBClusterParameterGroup
(Consumer<CreateDbClusterParameterGroupRequest.Builder> createDbClusterParameterGroupRequest) Creates a new cluster parameter group.createDBClusterParameterGroup
(CreateDbClusterParameterGroupRequest createDbClusterParameterGroupRequest) Creates a new cluster parameter group.createDBClusterSnapshot
(Consumer<CreateDbClusterSnapshotRequest.Builder> createDbClusterSnapshotRequest) Creates a snapshot of a cluster.createDBClusterSnapshot
(CreateDbClusterSnapshotRequest createDbClusterSnapshotRequest) Creates a snapshot of a cluster.createDBInstance
(Consumer<CreateDbInstanceRequest.Builder> createDbInstanceRequest) Creates a new instance.createDBInstance
(CreateDbInstanceRequest createDbInstanceRequest) Creates a new instance.createDBSubnetGroup
(Consumer<CreateDbSubnetGroupRequest.Builder> createDbSubnetGroupRequest) Creates a new subnet group.createDBSubnetGroup
(CreateDbSubnetGroupRequest createDbSubnetGroupRequest) Creates a new subnet group.createEventSubscription
(Consumer<CreateEventSubscriptionRequest.Builder> createEventSubscriptionRequest) Creates an Amazon DocumentDB event notification subscription.createEventSubscription
(CreateEventSubscriptionRequest createEventSubscriptionRequest) Creates an Amazon DocumentDB event notification subscription.createGlobalCluster
(Consumer<CreateGlobalClusterRequest.Builder> createGlobalClusterRequest) Creates an Amazon DocumentDB global cluster that can span multiple multiple Amazon Web Services Regions.createGlobalCluster
(CreateGlobalClusterRequest createGlobalClusterRequest) Creates an Amazon DocumentDB global cluster that can span multiple multiple Amazon Web Services Regions.default CompletableFuture
<DeleteDbClusterResponse> deleteDBCluster
(Consumer<DeleteDbClusterRequest.Builder> deleteDbClusterRequest) Deletes a previously provisioned cluster.default CompletableFuture
<DeleteDbClusterResponse> deleteDBCluster
(DeleteDbClusterRequest deleteDbClusterRequest) Deletes a previously provisioned cluster.deleteDBClusterParameterGroup
(Consumer<DeleteDbClusterParameterGroupRequest.Builder> deleteDbClusterParameterGroupRequest) Deletes a specified cluster parameter group.deleteDBClusterParameterGroup
(DeleteDbClusterParameterGroupRequest deleteDbClusterParameterGroupRequest) Deletes a specified cluster parameter group.deleteDBClusterSnapshot
(Consumer<DeleteDbClusterSnapshotRequest.Builder> deleteDbClusterSnapshotRequest) Deletes a cluster snapshot.deleteDBClusterSnapshot
(DeleteDbClusterSnapshotRequest deleteDbClusterSnapshotRequest) Deletes a cluster snapshot.deleteDBInstance
(Consumer<DeleteDbInstanceRequest.Builder> deleteDbInstanceRequest) Deletes a previously provisioned instance.deleteDBInstance
(DeleteDbInstanceRequest deleteDbInstanceRequest) Deletes a previously provisioned instance.deleteDBSubnetGroup
(Consumer<DeleteDbSubnetGroupRequest.Builder> deleteDbSubnetGroupRequest) Deletes a subnet group.deleteDBSubnetGroup
(DeleteDbSubnetGroupRequest deleteDbSubnetGroupRequest) Deletes a subnet group.deleteEventSubscription
(Consumer<DeleteEventSubscriptionRequest.Builder> deleteEventSubscriptionRequest) Deletes an Amazon DocumentDB event notification subscription.deleteEventSubscription
(DeleteEventSubscriptionRequest deleteEventSubscriptionRequest) Deletes an Amazon DocumentDB event notification subscription.deleteGlobalCluster
(Consumer<DeleteGlobalClusterRequest.Builder> deleteGlobalClusterRequest) Deletes a global cluster.deleteGlobalCluster
(DeleteGlobalClusterRequest deleteGlobalClusterRequest) Deletes a global cluster.describeCertificates
(Consumer<DescribeCertificatesRequest.Builder> describeCertificatesRequest) Returns a list of certificate authority (CA) certificates provided by Amazon DocumentDB for this Amazon Web Services account.describeCertificates
(DescribeCertificatesRequest describeCertificatesRequest) Returns a list of certificate authority (CA) certificates provided by Amazon DocumentDB for this Amazon Web Services account.default DescribeCertificatesPublisher
describeCertificatesPaginator
(Consumer<DescribeCertificatesRequest.Builder> describeCertificatesRequest) This is a variant ofdescribeCertificates(software.amazon.awssdk.services.docdb.model.DescribeCertificatesRequest)
operation.default DescribeCertificatesPublisher
describeCertificatesPaginator
(DescribeCertificatesRequest describeCertificatesRequest) This is a variant ofdescribeCertificates(software.amazon.awssdk.services.docdb.model.DescribeCertificatesRequest)
operation.Returns a list ofDBClusterParameterGroup
descriptions.describeDBClusterParameterGroups
(Consumer<DescribeDbClusterParameterGroupsRequest.Builder> describeDbClusterParameterGroupsRequest) Returns a list ofDBClusterParameterGroup
descriptions.describeDBClusterParameterGroups
(DescribeDbClusterParameterGroupsRequest describeDbClusterParameterGroupsRequest) Returns a list ofDBClusterParameterGroup
descriptions.This is a variant ofdescribeDBClusterParameterGroups(software.amazon.awssdk.services.docdb.model.DescribeDbClusterParameterGroupsRequest)
operation.describeDBClusterParameterGroupsPaginator
(Consumer<DescribeDbClusterParameterGroupsRequest.Builder> describeDbClusterParameterGroupsRequest) This is a variant ofdescribeDBClusterParameterGroups(software.amazon.awssdk.services.docdb.model.DescribeDbClusterParameterGroupsRequest)
operation.describeDBClusterParameterGroupsPaginator
(DescribeDbClusterParameterGroupsRequest describeDbClusterParameterGroupsRequest) This is a variant ofdescribeDBClusterParameterGroups(software.amazon.awssdk.services.docdb.model.DescribeDbClusterParameterGroupsRequest)
operation.describeDBClusterParameters
(Consumer<DescribeDbClusterParametersRequest.Builder> describeDbClusterParametersRequest) Returns the detailed parameter list for a particular cluster parameter group.describeDBClusterParameters
(DescribeDbClusterParametersRequest describeDbClusterParametersRequest) Returns the detailed parameter list for a particular cluster parameter group.describeDBClusterParametersPaginator
(Consumer<DescribeDbClusterParametersRequest.Builder> describeDbClusterParametersRequest) This is a variant ofdescribeDBClusterParameters(software.amazon.awssdk.services.docdb.model.DescribeDbClusterParametersRequest)
operation.describeDBClusterParametersPaginator
(DescribeDbClusterParametersRequest describeDbClusterParametersRequest) This is a variant ofdescribeDBClusterParameters(software.amazon.awssdk.services.docdb.model.DescribeDbClusterParametersRequest)
operation.Returns information about provisioned Amazon DocumentDB clusters.describeDBClusters
(Consumer<DescribeDbClustersRequest.Builder> describeDbClustersRequest) Returns information about provisioned Amazon DocumentDB clusters.describeDBClusters
(DescribeDbClustersRequest describeDbClustersRequest) Returns information about provisioned Amazon DocumentDB clusters.describeDBClusterSnapshotAttributes
(Consumer<DescribeDbClusterSnapshotAttributesRequest.Builder> describeDbClusterSnapshotAttributesRequest) Returns a list of cluster snapshot attribute names and values for a manual DB cluster snapshot.describeDBClusterSnapshotAttributes
(DescribeDbClusterSnapshotAttributesRequest describeDbClusterSnapshotAttributesRequest) Returns a list of cluster snapshot attribute names and values for a manual DB cluster snapshot.Returns information about cluster snapshots.describeDBClusterSnapshots
(Consumer<DescribeDbClusterSnapshotsRequest.Builder> describeDbClusterSnapshotsRequest) Returns information about cluster snapshots.describeDBClusterSnapshots
(DescribeDbClusterSnapshotsRequest describeDbClusterSnapshotsRequest) Returns information about cluster snapshots.This is a variant ofdescribeDBClusterSnapshots(software.amazon.awssdk.services.docdb.model.DescribeDbClusterSnapshotsRequest)
operation.describeDBClusterSnapshotsPaginator
(Consumer<DescribeDbClusterSnapshotsRequest.Builder> describeDbClusterSnapshotsRequest) This is a variant ofdescribeDBClusterSnapshots(software.amazon.awssdk.services.docdb.model.DescribeDbClusterSnapshotsRequest)
operation.describeDBClusterSnapshotsPaginator
(DescribeDbClusterSnapshotsRequest describeDbClusterSnapshotsRequest) This is a variant ofdescribeDBClusterSnapshots(software.amazon.awssdk.services.docdb.model.DescribeDbClusterSnapshotsRequest)
operation.default DescribeDBClustersPublisher
This is a variant ofdescribeDBClusters(software.amazon.awssdk.services.docdb.model.DescribeDbClustersRequest)
operation.default DescribeDBClustersPublisher
describeDBClustersPaginator
(Consumer<DescribeDbClustersRequest.Builder> describeDbClustersRequest) This is a variant ofdescribeDBClusters(software.amazon.awssdk.services.docdb.model.DescribeDbClustersRequest)
operation.default DescribeDBClustersPublisher
describeDBClustersPaginator
(DescribeDbClustersRequest describeDbClustersRequest) This is a variant ofdescribeDBClusters(software.amazon.awssdk.services.docdb.model.DescribeDbClustersRequest)
operation.Returns a list of the available engines.describeDBEngineVersions
(Consumer<DescribeDbEngineVersionsRequest.Builder> describeDbEngineVersionsRequest) Returns a list of the available engines.describeDBEngineVersions
(DescribeDbEngineVersionsRequest describeDbEngineVersionsRequest) Returns a list of the available engines.This is a variant ofdescribeDBEngineVersions(software.amazon.awssdk.services.docdb.model.DescribeDbEngineVersionsRequest)
operation.describeDBEngineVersionsPaginator
(Consumer<DescribeDbEngineVersionsRequest.Builder> describeDbEngineVersionsRequest) This is a variant ofdescribeDBEngineVersions(software.amazon.awssdk.services.docdb.model.DescribeDbEngineVersionsRequest)
operation.describeDBEngineVersionsPaginator
(DescribeDbEngineVersionsRequest describeDbEngineVersionsRequest) This is a variant ofdescribeDBEngineVersions(software.amazon.awssdk.services.docdb.model.DescribeDbEngineVersionsRequest)
operation.Returns information about provisioned Amazon DocumentDB instances.describeDBInstances
(Consumer<DescribeDbInstancesRequest.Builder> describeDbInstancesRequest) Returns information about provisioned Amazon DocumentDB instances.describeDBInstances
(DescribeDbInstancesRequest describeDbInstancesRequest) Returns information about provisioned Amazon DocumentDB instances.default DescribeDBInstancesPublisher
This is a variant ofdescribeDBInstances(software.amazon.awssdk.services.docdb.model.DescribeDbInstancesRequest)
operation.default DescribeDBInstancesPublisher
describeDBInstancesPaginator
(Consumer<DescribeDbInstancesRequest.Builder> describeDbInstancesRequest) This is a variant ofdescribeDBInstances(software.amazon.awssdk.services.docdb.model.DescribeDbInstancesRequest)
operation.default DescribeDBInstancesPublisher
describeDBInstancesPaginator
(DescribeDbInstancesRequest describeDbInstancesRequest) This is a variant ofdescribeDBInstances(software.amazon.awssdk.services.docdb.model.DescribeDbInstancesRequest)
operation.Returns a list ofDBSubnetGroup
descriptions.describeDBSubnetGroups
(Consumer<DescribeDbSubnetGroupsRequest.Builder> describeDbSubnetGroupsRequest) Returns a list ofDBSubnetGroup
descriptions.describeDBSubnetGroups
(DescribeDbSubnetGroupsRequest describeDbSubnetGroupsRequest) Returns a list ofDBSubnetGroup
descriptions.default DescribeDBSubnetGroupsPublisher
This is a variant ofdescribeDBSubnetGroups(software.amazon.awssdk.services.docdb.model.DescribeDbSubnetGroupsRequest)
operation.default DescribeDBSubnetGroupsPublisher
describeDBSubnetGroupsPaginator
(Consumer<DescribeDbSubnetGroupsRequest.Builder> describeDbSubnetGroupsRequest) This is a variant ofdescribeDBSubnetGroups(software.amazon.awssdk.services.docdb.model.DescribeDbSubnetGroupsRequest)
operation.default DescribeDBSubnetGroupsPublisher
describeDBSubnetGroupsPaginator
(DescribeDbSubnetGroupsRequest describeDbSubnetGroupsRequest) This is a variant ofdescribeDBSubnetGroups(software.amazon.awssdk.services.docdb.model.DescribeDbSubnetGroupsRequest)
operation.describeEngineDefaultClusterParameters
(Consumer<DescribeEngineDefaultClusterParametersRequest.Builder> describeEngineDefaultClusterParametersRequest) Returns the default engine and system parameter information for the cluster database engine.describeEngineDefaultClusterParameters
(DescribeEngineDefaultClusterParametersRequest describeEngineDefaultClusterParametersRequest) Returns the default engine and system parameter information for the cluster database engine.Displays a list of categories for all event source types, or, if specified, for a specified source type.describeEventCategories
(Consumer<DescribeEventCategoriesRequest.Builder> describeEventCategoriesRequest) Displays a list of categories for all event source types, or, if specified, for a specified source type.describeEventCategories
(DescribeEventCategoriesRequest describeEventCategoriesRequest) Displays a list of categories for all event source types, or, if specified, for a specified source type.default CompletableFuture
<DescribeEventsResponse> Returns events related to instances, security groups, snapshots, and DB parameter groups for the past 14 days.default CompletableFuture
<DescribeEventsResponse> describeEvents
(Consumer<DescribeEventsRequest.Builder> describeEventsRequest) Returns events related to instances, security groups, snapshots, and DB parameter groups for the past 14 days.default CompletableFuture
<DescribeEventsResponse> describeEvents
(DescribeEventsRequest describeEventsRequest) Returns events related to instances, security groups, snapshots, and DB parameter groups for the past 14 days.default DescribeEventsPublisher
This is a variant ofdescribeEvents(software.amazon.awssdk.services.docdb.model.DescribeEventsRequest)
operation.default DescribeEventsPublisher
describeEventsPaginator
(Consumer<DescribeEventsRequest.Builder> describeEventsRequest) This is a variant ofdescribeEvents(software.amazon.awssdk.services.docdb.model.DescribeEventsRequest)
operation.default DescribeEventsPublisher
describeEventsPaginator
(DescribeEventsRequest describeEventsRequest) This is a variant ofdescribeEvents(software.amazon.awssdk.services.docdb.model.DescribeEventsRequest)
operation.describeEventSubscriptions
(Consumer<DescribeEventSubscriptionsRequest.Builder> describeEventSubscriptionsRequest) Lists all the subscription descriptions for a customer account.describeEventSubscriptions
(DescribeEventSubscriptionsRequest describeEventSubscriptionsRequest) Lists all the subscription descriptions for a customer account.describeEventSubscriptionsPaginator
(Consumer<DescribeEventSubscriptionsRequest.Builder> describeEventSubscriptionsRequest) This is a variant ofdescribeEventSubscriptions(software.amazon.awssdk.services.docdb.model.DescribeEventSubscriptionsRequest)
operation.describeEventSubscriptionsPaginator
(DescribeEventSubscriptionsRequest describeEventSubscriptionsRequest) This is a variant ofdescribeEventSubscriptions(software.amazon.awssdk.services.docdb.model.DescribeEventSubscriptionsRequest)
operation.describeGlobalClusters
(Consumer<DescribeGlobalClustersRequest.Builder> describeGlobalClustersRequest) Returns information about Amazon DocumentDB global clusters.describeGlobalClusters
(DescribeGlobalClustersRequest describeGlobalClustersRequest) Returns information about Amazon DocumentDB global clusters.default DescribeGlobalClustersPublisher
describeGlobalClustersPaginator
(Consumer<DescribeGlobalClustersRequest.Builder> describeGlobalClustersRequest) This is a variant ofdescribeGlobalClusters(software.amazon.awssdk.services.docdb.model.DescribeGlobalClustersRequest)
operation.default DescribeGlobalClustersPublisher
describeGlobalClustersPaginator
(DescribeGlobalClustersRequest describeGlobalClustersRequest) This is a variant ofdescribeGlobalClusters(software.amazon.awssdk.services.docdb.model.DescribeGlobalClustersRequest)
operation.describeOrderableDBInstanceOptions
(Consumer<DescribeOrderableDbInstanceOptionsRequest.Builder> describeOrderableDbInstanceOptionsRequest) Returns a list of orderable instance options for the specified engine.describeOrderableDBInstanceOptions
(DescribeOrderableDbInstanceOptionsRequest describeOrderableDbInstanceOptionsRequest) Returns a list of orderable instance options for the specified engine.describeOrderableDBInstanceOptionsPaginator
(Consumer<DescribeOrderableDbInstanceOptionsRequest.Builder> describeOrderableDbInstanceOptionsRequest) This is a variant ofdescribeOrderableDBInstanceOptions(software.amazon.awssdk.services.docdb.model.DescribeOrderableDbInstanceOptionsRequest)
operation.describeOrderableDBInstanceOptionsPaginator
(DescribeOrderableDbInstanceOptionsRequest describeOrderableDbInstanceOptionsRequest) This is a variant ofdescribeOrderableDBInstanceOptions(software.amazon.awssdk.services.docdb.model.DescribeOrderableDbInstanceOptionsRequest)
operation.Returns a list of resources (for example, instances) that have at least one pending maintenance action.describePendingMaintenanceActions
(Consumer<DescribePendingMaintenanceActionsRequest.Builder> describePendingMaintenanceActionsRequest) Returns a list of resources (for example, instances) that have at least one pending maintenance action.describePendingMaintenanceActions
(DescribePendingMaintenanceActionsRequest describePendingMaintenanceActionsRequest) Returns a list of resources (for example, instances) that have at least one pending maintenance action.This is a variant ofdescribePendingMaintenanceActions(software.amazon.awssdk.services.docdb.model.DescribePendingMaintenanceActionsRequest)
operation.describePendingMaintenanceActionsPaginator
(Consumer<DescribePendingMaintenanceActionsRequest.Builder> describePendingMaintenanceActionsRequest) This is a variant ofdescribePendingMaintenanceActions(software.amazon.awssdk.services.docdb.model.DescribePendingMaintenanceActionsRequest)
operation.describePendingMaintenanceActionsPaginator
(DescribePendingMaintenanceActionsRequest describePendingMaintenanceActionsRequest) This is a variant ofdescribePendingMaintenanceActions(software.amazon.awssdk.services.docdb.model.DescribePendingMaintenanceActionsRequest)
operation.failoverDBCluster
(Consumer<FailoverDbClusterRequest.Builder> failoverDbClusterRequest) Forces a failover for a cluster.failoverDBCluster
(FailoverDbClusterRequest failoverDbClusterRequest) Forces a failover for a cluster.listTagsForResource
(Consumer<ListTagsForResourceRequest.Builder> listTagsForResourceRequest) Lists all tags on an Amazon DocumentDB resource.listTagsForResource
(ListTagsForResourceRequest listTagsForResourceRequest) Lists all tags on an Amazon DocumentDB resource.default CompletableFuture
<ModifyDbClusterResponse> modifyDBCluster
(Consumer<ModifyDbClusterRequest.Builder> modifyDbClusterRequest) Modifies a setting for an Amazon DocumentDB cluster.default CompletableFuture
<ModifyDbClusterResponse> modifyDBCluster
(ModifyDbClusterRequest modifyDbClusterRequest) Modifies a setting for an Amazon DocumentDB cluster.modifyDBClusterParameterGroup
(Consumer<ModifyDbClusterParameterGroupRequest.Builder> modifyDbClusterParameterGroupRequest) Modifies the parameters of a cluster parameter group.modifyDBClusterParameterGroup
(ModifyDbClusterParameterGroupRequest modifyDbClusterParameterGroupRequest) Modifies the parameters of a cluster parameter group.modifyDBClusterSnapshotAttribute
(Consumer<ModifyDbClusterSnapshotAttributeRequest.Builder> modifyDbClusterSnapshotAttributeRequest) Adds an attribute and values to, or removes an attribute and values from, a manual cluster snapshot.modifyDBClusterSnapshotAttribute
(ModifyDbClusterSnapshotAttributeRequest modifyDbClusterSnapshotAttributeRequest) Adds an attribute and values to, or removes an attribute and values from, a manual cluster snapshot.modifyDBInstance
(Consumer<ModifyDbInstanceRequest.Builder> modifyDbInstanceRequest) Modifies settings for an instance.modifyDBInstance
(ModifyDbInstanceRequest modifyDbInstanceRequest) Modifies settings for an instance.modifyDBSubnetGroup
(Consumer<ModifyDbSubnetGroupRequest.Builder> modifyDbSubnetGroupRequest) Modifies an existing subnet group.modifyDBSubnetGroup
(ModifyDbSubnetGroupRequest modifyDbSubnetGroupRequest) Modifies an existing subnet group.modifyEventSubscription
(Consumer<ModifyEventSubscriptionRequest.Builder> modifyEventSubscriptionRequest) Modifies an existing Amazon DocumentDB event notification subscription.modifyEventSubscription
(ModifyEventSubscriptionRequest modifyEventSubscriptionRequest) Modifies an existing Amazon DocumentDB event notification subscription.modifyGlobalCluster
(Consumer<ModifyGlobalClusterRequest.Builder> modifyGlobalClusterRequest) Modify a setting for an Amazon DocumentDB global cluster.modifyGlobalCluster
(ModifyGlobalClusterRequest modifyGlobalClusterRequest) Modify a setting for an Amazon DocumentDB global cluster.rebootDBInstance
(Consumer<RebootDbInstanceRequest.Builder> rebootDbInstanceRequest) You might need to reboot your instance, usually for maintenance reasons.rebootDBInstance
(RebootDbInstanceRequest rebootDbInstanceRequest) You might need to reboot your instance, usually for maintenance reasons.removeFromGlobalCluster
(Consumer<RemoveFromGlobalClusterRequest.Builder> removeFromGlobalClusterRequest) Detaches an Amazon DocumentDB secondary cluster from a global cluster.removeFromGlobalCluster
(RemoveFromGlobalClusterRequest removeFromGlobalClusterRequest) Detaches an Amazon DocumentDB secondary cluster from a global cluster.removeSourceIdentifierFromSubscription
(Consumer<RemoveSourceIdentifierFromSubscriptionRequest.Builder> removeSourceIdentifierFromSubscriptionRequest) Removes a source identifier from an existing Amazon DocumentDB event notification subscription.removeSourceIdentifierFromSubscription
(RemoveSourceIdentifierFromSubscriptionRequest removeSourceIdentifierFromSubscriptionRequest) Removes a source identifier from an existing Amazon DocumentDB event notification subscription.removeTagsFromResource
(Consumer<RemoveTagsFromResourceRequest.Builder> removeTagsFromResourceRequest) Removes metadata tags from an Amazon DocumentDB resource.removeTagsFromResource
(RemoveTagsFromResourceRequest removeTagsFromResourceRequest) Removes metadata tags from an Amazon DocumentDB resource.resetDBClusterParameterGroup
(Consumer<ResetDbClusterParameterGroupRequest.Builder> resetDbClusterParameterGroupRequest) Modifies the parameters of a cluster parameter group to the default value.resetDBClusterParameterGroup
(ResetDbClusterParameterGroupRequest resetDbClusterParameterGroupRequest) Modifies the parameters of a cluster parameter group to the default value.restoreDBClusterFromSnapshot
(Consumer<RestoreDbClusterFromSnapshotRequest.Builder> restoreDbClusterFromSnapshotRequest) Creates a new cluster from a snapshot or cluster snapshot.restoreDBClusterFromSnapshot
(RestoreDbClusterFromSnapshotRequest restoreDbClusterFromSnapshotRequest) Creates a new cluster from a snapshot or cluster snapshot.restoreDBClusterToPointInTime
(Consumer<RestoreDbClusterToPointInTimeRequest.Builder> restoreDbClusterToPointInTimeRequest) Restores a cluster to an arbitrary point in time.restoreDBClusterToPointInTime
(RestoreDbClusterToPointInTimeRequest restoreDbClusterToPointInTimeRequest) Restores a cluster to an arbitrary point in time.default DocDbServiceClientConfiguration
The SDK service client configuration exposes client settings to the user, e.g., ClientOverrideConfigurationdefault CompletableFuture
<StartDbClusterResponse> startDBCluster
(Consumer<StartDbClusterRequest.Builder> startDbClusterRequest) Restarts the stopped cluster that is specified byDBClusterIdentifier
.default CompletableFuture
<StartDbClusterResponse> startDBCluster
(StartDbClusterRequest startDbClusterRequest) Restarts the stopped cluster that is specified byDBClusterIdentifier
.default CompletableFuture
<StopDbClusterResponse> stopDBCluster
(Consumer<StopDbClusterRequest.Builder> stopDbClusterRequest) Stops the running cluster that is specified byDBClusterIdentifier
.default CompletableFuture
<StopDbClusterResponse> stopDBCluster
(StopDbClusterRequest stopDbClusterRequest) Stops the running cluster that is specified byDBClusterIdentifier
.switchoverGlobalCluster
(Consumer<SwitchoverGlobalClusterRequest.Builder> switchoverGlobalClusterRequest) Switches over the specified secondary Amazon DocumentDB cluster to be the new primary Amazon DocumentDB cluster in the global database cluster.switchoverGlobalCluster
(SwitchoverGlobalClusterRequest switchoverGlobalClusterRequest) Switches over the specified secondary Amazon DocumentDB cluster to be the new primary Amazon DocumentDB cluster in the global database cluster.default DocDbAsyncWaiter
waiter()
Create an instance ofDocDbAsyncWaiter
using this client.Methods inherited from interface software.amazon.awssdk.utils.SdkAutoCloseable
close
Methods 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
-
addSourceIdentifierToSubscription
default CompletableFuture<AddSourceIdentifierToSubscriptionResponse> addSourceIdentifierToSubscription(AddSourceIdentifierToSubscriptionRequest addSourceIdentifierToSubscriptionRequest) Adds a source identifier to an existing event notification subscription.
- Parameters:
addSourceIdentifierToSubscriptionRequest
- Represents the input to AddSourceIdentifierToSubscription.- Returns:
- A Java Future containing the result of the AddSourceIdentifierToSubscription operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- SubscriptionNotFoundException The subscription name does not exist.
- SourceNotFoundException The requested source could not be found.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
addSourceIdentifierToSubscription
default CompletableFuture<AddSourceIdentifierToSubscriptionResponse> addSourceIdentifierToSubscription(Consumer<AddSourceIdentifierToSubscriptionRequest.Builder> addSourceIdentifierToSubscriptionRequest) Adds a source identifier to an existing event notification subscription.
This is a convenience which creates an instance of the
AddSourceIdentifierToSubscriptionRequest.Builder
avoiding the need to create one manually viaAddSourceIdentifierToSubscriptionRequest.builder()
- Parameters:
addSourceIdentifierToSubscriptionRequest
- AConsumer
that will call methods onAddSourceIdentifierToSubscriptionRequest.Builder
to create a request. Represents the input to AddSourceIdentifierToSubscription.- Returns:
- A Java Future containing the result of the AddSourceIdentifierToSubscription operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- SubscriptionNotFoundException The subscription name does not exist.
- SourceNotFoundException The requested source could not be found.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
addTagsToResource
default CompletableFuture<AddTagsToResourceResponse> addTagsToResource(AddTagsToResourceRequest addTagsToResourceRequest) Adds metadata tags to an Amazon DocumentDB resource. You can use these tags with cost allocation reporting to track costs that are associated with Amazon DocumentDB resources or in a
Condition
statement in an Identity and Access Management (IAM) policy for Amazon DocumentDB.- Parameters:
addTagsToResourceRequest
- Represents the input to AddTagsToResource.- Returns:
- A Java Future containing the result of the AddTagsToResource operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DbInstanceNotFoundException
DBInstanceIdentifier
doesn't refer to an existing instance. - DbSnapshotNotFoundException
DBSnapshotIdentifier
doesn't refer to an existing snapshot. - DbClusterNotFoundException
DBClusterIdentifier
doesn't refer to an existing cluster. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- DbInstanceNotFoundException
- See Also:
-
addTagsToResource
default CompletableFuture<AddTagsToResourceResponse> addTagsToResource(Consumer<AddTagsToResourceRequest.Builder> addTagsToResourceRequest) Adds metadata tags to an Amazon DocumentDB resource. You can use these tags with cost allocation reporting to track costs that are associated with Amazon DocumentDB resources or in a
Condition
statement in an Identity and Access Management (IAM) policy for Amazon DocumentDB.
This is a convenience which creates an instance of the
AddTagsToResourceRequest.Builder
avoiding the need to create one manually viaAddTagsToResourceRequest.builder()
- Parameters:
addTagsToResourceRequest
- AConsumer
that will call methods onAddTagsToResourceRequest.Builder
to create a request. Represents the input to AddTagsToResource.- Returns:
- A Java Future containing the result of the AddTagsToResource operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DbInstanceNotFoundException
DBInstanceIdentifier
doesn't refer to an existing instance. - DbSnapshotNotFoundException
DBSnapshotIdentifier
doesn't refer to an existing snapshot. - DbClusterNotFoundException
DBClusterIdentifier
doesn't refer to an existing cluster. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- DbInstanceNotFoundException
- See Also:
-
applyPendingMaintenanceAction
default CompletableFuture<ApplyPendingMaintenanceActionResponse> applyPendingMaintenanceAction(ApplyPendingMaintenanceActionRequest applyPendingMaintenanceActionRequest) Applies a pending maintenance action to a resource (for example, to an Amazon DocumentDB instance).
- Parameters:
applyPendingMaintenanceActionRequest
- Represents the input to ApplyPendingMaintenanceAction.- Returns:
- A Java Future containing the result of the ApplyPendingMaintenanceAction operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- ResourceNotFoundException The specified resource ID was not found.
- InvalidDbClusterStateException The cluster isn't in a valid state.
- InvalidDbInstanceStateException The specified instance isn't in the available state.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
applyPendingMaintenanceAction
default CompletableFuture<ApplyPendingMaintenanceActionResponse> applyPendingMaintenanceAction(Consumer<ApplyPendingMaintenanceActionRequest.Builder> applyPendingMaintenanceActionRequest) Applies a pending maintenance action to a resource (for example, to an Amazon DocumentDB instance).
This is a convenience which creates an instance of the
ApplyPendingMaintenanceActionRequest.Builder
avoiding the need to create one manually viaApplyPendingMaintenanceActionRequest.builder()
- Parameters:
applyPendingMaintenanceActionRequest
- AConsumer
that will call methods onApplyPendingMaintenanceActionRequest.Builder
to create a request. Represents the input to ApplyPendingMaintenanceAction.- Returns:
- A Java Future containing the result of the ApplyPendingMaintenanceAction operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- ResourceNotFoundException The specified resource ID was not found.
- InvalidDbClusterStateException The cluster isn't in a valid state.
- InvalidDbInstanceStateException The specified instance isn't in the available state.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
copyDBClusterParameterGroup
default CompletableFuture<CopyDbClusterParameterGroupResponse> copyDBClusterParameterGroup(CopyDbClusterParameterGroupRequest copyDbClusterParameterGroupRequest) Copies the specified cluster parameter group.
- Parameters:
copyDbClusterParameterGroupRequest
- Represents the input to CopyDBClusterParameterGroup.- Returns:
- A Java Future containing the result of the CopyDBClusterParameterGroup operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DbParameterGroupNotFoundException
DBParameterGroupName
doesn't refer to an existing parameter group. - DbParameterGroupQuotaExceededException This request would cause you to exceed the allowed number of parameter groups.
- DbParameterGroupAlreadyExistsException A parameter group with the same name already exists.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- DbParameterGroupNotFoundException
- See Also:
-
copyDBClusterParameterGroup
default CompletableFuture<CopyDbClusterParameterGroupResponse> copyDBClusterParameterGroup(Consumer<CopyDbClusterParameterGroupRequest.Builder> copyDbClusterParameterGroupRequest) Copies the specified cluster parameter group.
This is a convenience which creates an instance of the
CopyDbClusterParameterGroupRequest.Builder
avoiding the need to create one manually viaCopyDbClusterParameterGroupRequest.builder()
- Parameters:
copyDbClusterParameterGroupRequest
- AConsumer
that will call methods onCopyDbClusterParameterGroupRequest.Builder
to create a request. Represents the input to CopyDBClusterParameterGroup.- Returns:
- A Java Future containing the result of the CopyDBClusterParameterGroup operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DbParameterGroupNotFoundException
DBParameterGroupName
doesn't refer to an existing parameter group. - DbParameterGroupQuotaExceededException This request would cause you to exceed the allowed number of parameter groups.
- DbParameterGroupAlreadyExistsException A parameter group with the same name already exists.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- DbParameterGroupNotFoundException
- See Also:
-
copyDBClusterSnapshot
default CompletableFuture<CopyDbClusterSnapshotResponse> copyDBClusterSnapshot(CopyDbClusterSnapshotRequest copyDbClusterSnapshotRequest) Copies a snapshot of a cluster.
To copy a cluster snapshot from a shared manual cluster snapshot,
SourceDBClusterSnapshotIdentifier
must be the Amazon Resource Name (ARN) of the shared cluster snapshot. You can only copy a shared DB cluster snapshot, whether encrypted or not, in the same Amazon Web Services Region.To cancel the copy operation after it is in progress, delete the target cluster snapshot identified by
TargetDBClusterSnapshotIdentifier
while that cluster snapshot is in the copying status.- Parameters:
copyDbClusterSnapshotRequest
- Represents the input to CopyDBClusterSnapshot.- Returns:
- A Java Future containing the result of the CopyDBClusterSnapshot operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DbClusterSnapshotAlreadyExistsException You already have a cluster snapshot with the given identifier.
- DbClusterSnapshotNotFoundException
DBClusterSnapshotIdentifier
doesn't refer to an existing cluster snapshot. - InvalidDbClusterStateException The cluster isn't in a valid state.
- InvalidDbClusterSnapshotStateException The provided value isn't a valid cluster snapshot state.
- SnapshotQuotaExceededException The request would cause you to exceed the allowed number of snapshots.
- KmsKeyNotAccessibleException An error occurred when accessing an KMS key.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
copyDBClusterSnapshot
default CompletableFuture<CopyDbClusterSnapshotResponse> copyDBClusterSnapshot(Consumer<CopyDbClusterSnapshotRequest.Builder> copyDbClusterSnapshotRequest) Copies a snapshot of a cluster.
To copy a cluster snapshot from a shared manual cluster snapshot,
SourceDBClusterSnapshotIdentifier
must be the Amazon Resource Name (ARN) of the shared cluster snapshot. You can only copy a shared DB cluster snapshot, whether encrypted or not, in the same Amazon Web Services Region.To cancel the copy operation after it is in progress, delete the target cluster snapshot identified by
TargetDBClusterSnapshotIdentifier
while that cluster snapshot is in the copying status.
This is a convenience which creates an instance of the
CopyDbClusterSnapshotRequest.Builder
avoiding the need to create one manually viaCopyDbClusterSnapshotRequest.builder()
- Parameters:
copyDbClusterSnapshotRequest
- AConsumer
that will call methods onCopyDbClusterSnapshotRequest.Builder
to create a request. Represents the input to CopyDBClusterSnapshot.- Returns:
- A Java Future containing the result of the CopyDBClusterSnapshot operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DbClusterSnapshotAlreadyExistsException You already have a cluster snapshot with the given identifier.
- DbClusterSnapshotNotFoundException
DBClusterSnapshotIdentifier
doesn't refer to an existing cluster snapshot. - InvalidDbClusterStateException The cluster isn't in a valid state.
- InvalidDbClusterSnapshotStateException The provided value isn't a valid cluster snapshot state.
- SnapshotQuotaExceededException The request would cause you to exceed the allowed number of snapshots.
- KmsKeyNotAccessibleException An error occurred when accessing an KMS key.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
createDBCluster
default CompletableFuture<CreateDbClusterResponse> createDBCluster(CreateDbClusterRequest createDbClusterRequest) Creates a new Amazon DocumentDB cluster.
- Parameters:
createDbClusterRequest
- Represents the input to CreateDBCluster.- Returns:
- A Java Future containing the result of the CreateDBCluster operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DbClusterAlreadyExistsException You already have a cluster with the given identifier.
- InsufficientStorageClusterCapacityException There is not enough storage available for the current action. You might be able to resolve this error by updating your subnet group to use different Availability Zones that have more storage available.
- DbClusterQuotaExceededException The cluster can't be created because you have reached the maximum allowed quota of clusters.
- StorageQuotaExceededException The request would cause you to exceed the allowed amount of storage available across all instances.
- DbSubnetGroupNotFoundException
DBSubnetGroupName
doesn't refer to an existing subnet group. - InvalidVpcNetworkStateException The subnet group doesn't cover all Availability Zones after it is created because of changes that were made.
- InvalidDbClusterStateException The cluster isn't in a valid state.
- InvalidDbSubnetGroupStateException The subnet group can't be deleted because it's in use.
- InvalidSubnetException The requested subnet is not valid, or multiple subnets were requested that are not all in a common virtual private cloud (VPC).
- InvalidDbInstanceStateException The specified instance isn't in the available state.
- DbClusterParameterGroupNotFoundException
DBClusterParameterGroupName
doesn't refer to an existing cluster parameter group. - KmsKeyNotAccessibleException An error occurred when accessing an KMS key.
- DbClusterNotFoundException
DBClusterIdentifier
doesn't refer to an existing cluster. - DbInstanceNotFoundException
DBInstanceIdentifier
doesn't refer to an existing instance. - DbSubnetGroupDoesNotCoverEnoughAZsException Subnets in the subnet group should cover at least two Availability Zones unless there is only one Availability Zone.
- GlobalClusterNotFoundException The
GlobalClusterIdentifier
doesn't refer to an existing global cluster. - InvalidGlobalClusterStateException The requested operation can't be performed while the cluster is in this state.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
createDBCluster
default CompletableFuture<CreateDbClusterResponse> createDBCluster(Consumer<CreateDbClusterRequest.Builder> createDbClusterRequest) Creates a new Amazon DocumentDB cluster.
This is a convenience which creates an instance of the
CreateDbClusterRequest.Builder
avoiding the need to create one manually viaCreateDbClusterRequest.builder()
- Parameters:
createDbClusterRequest
- AConsumer
that will call methods onCreateDbClusterRequest.Builder
to create a request. Represents the input to CreateDBCluster.- Returns:
- A Java Future containing the result of the CreateDBCluster operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DbClusterAlreadyExistsException You already have a cluster with the given identifier.
- InsufficientStorageClusterCapacityException There is not enough storage available for the current action. You might be able to resolve this error by updating your subnet group to use different Availability Zones that have more storage available.
- DbClusterQuotaExceededException The cluster can't be created because you have reached the maximum allowed quota of clusters.
- StorageQuotaExceededException The request would cause you to exceed the allowed amount of storage available across all instances.
- DbSubnetGroupNotFoundException
DBSubnetGroupName
doesn't refer to an existing subnet group. - InvalidVpcNetworkStateException The subnet group doesn't cover all Availability Zones after it is created because of changes that were made.
- InvalidDbClusterStateException The cluster isn't in a valid state.
- InvalidDbSubnetGroupStateException The subnet group can't be deleted because it's in use.
- InvalidSubnetException The requested subnet is not valid, or multiple subnets were requested that are not all in a common virtual private cloud (VPC).
- InvalidDbInstanceStateException The specified instance isn't in the available state.
- DbClusterParameterGroupNotFoundException
DBClusterParameterGroupName
doesn't refer to an existing cluster parameter group. - KmsKeyNotAccessibleException An error occurred when accessing an KMS key.
- DbClusterNotFoundException
DBClusterIdentifier
doesn't refer to an existing cluster. - DbInstanceNotFoundException
DBInstanceIdentifier
doesn't refer to an existing instance. - DbSubnetGroupDoesNotCoverEnoughAZsException Subnets in the subnet group should cover at least two Availability Zones unless there is only one Availability Zone.
- GlobalClusterNotFoundException The
GlobalClusterIdentifier
doesn't refer to an existing global cluster. - InvalidGlobalClusterStateException The requested operation can't be performed while the cluster is in this state.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
createDBClusterParameterGroup
default CompletableFuture<CreateDbClusterParameterGroupResponse> createDBClusterParameterGroup(CreateDbClusterParameterGroupRequest createDbClusterParameterGroupRequest) Creates a new cluster parameter group.
Parameters in a cluster parameter group apply to all of the instances in a cluster.
A cluster parameter group is initially created with the default parameters for the database engine used by instances in the cluster. In Amazon DocumentDB, you cannot make modifications directly to the
default.docdb3.6
cluster parameter group. If your Amazon DocumentDB cluster is using the default cluster parameter group and you want to modify a value in it, you must first create a new parameter group or copy an existing parameter group, modify it, and then apply the modified parameter group to your cluster. For the new cluster parameter group and associated settings to take effect, you must then reboot the instances in the cluster without failover. For more information, see Modifying Amazon DocumentDB Cluster Parameter Groups.- Parameters:
createDbClusterParameterGroupRequest
- Represents the input of CreateDBClusterParameterGroup.- Returns:
- A Java Future containing the result of the CreateDBClusterParameterGroup operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DbParameterGroupQuotaExceededException This request would cause you to exceed the allowed number of parameter groups.
- DbParameterGroupAlreadyExistsException A parameter group with the same name already exists.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
createDBClusterParameterGroup
default CompletableFuture<CreateDbClusterParameterGroupResponse> createDBClusterParameterGroup(Consumer<CreateDbClusterParameterGroupRequest.Builder> createDbClusterParameterGroupRequest) Creates a new cluster parameter group.
Parameters in a cluster parameter group apply to all of the instances in a cluster.
A cluster parameter group is initially created with the default parameters for the database engine used by instances in the cluster. In Amazon DocumentDB, you cannot make modifications directly to the
default.docdb3.6
cluster parameter group. If your Amazon DocumentDB cluster is using the default cluster parameter group and you want to modify a value in it, you must first create a new parameter group or copy an existing parameter group, modify it, and then apply the modified parameter group to your cluster. For the new cluster parameter group and associated settings to take effect, you must then reboot the instances in the cluster without failover. For more information, see Modifying Amazon DocumentDB Cluster Parameter Groups.
This is a convenience which creates an instance of the
CreateDbClusterParameterGroupRequest.Builder
avoiding the need to create one manually viaCreateDbClusterParameterGroupRequest.builder()
- Parameters:
createDbClusterParameterGroupRequest
- AConsumer
that will call methods onCreateDbClusterParameterGroupRequest.Builder
to create a request. Represents the input of CreateDBClusterParameterGroup.- Returns:
- A Java Future containing the result of the CreateDBClusterParameterGroup operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DbParameterGroupQuotaExceededException This request would cause you to exceed the allowed number of parameter groups.
- DbParameterGroupAlreadyExistsException A parameter group with the same name already exists.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
createDBClusterSnapshot
default CompletableFuture<CreateDbClusterSnapshotResponse> createDBClusterSnapshot(CreateDbClusterSnapshotRequest createDbClusterSnapshotRequest) Creates a snapshot of a cluster.
- Parameters:
createDbClusterSnapshotRequest
- Represents the input of CreateDBClusterSnapshot.- Returns:
- A Java Future containing the result of the CreateDBClusterSnapshot operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DbClusterSnapshotAlreadyExistsException You already have a cluster snapshot with the given identifier.
- InvalidDbClusterStateException The cluster isn't in a valid state.
- DbClusterNotFoundException
DBClusterIdentifier
doesn't refer to an existing cluster. - SnapshotQuotaExceededException The request would cause you to exceed the allowed number of snapshots.
- InvalidDbClusterSnapshotStateException The provided value isn't a valid cluster snapshot state.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
createDBClusterSnapshot
default CompletableFuture<CreateDbClusterSnapshotResponse> createDBClusterSnapshot(Consumer<CreateDbClusterSnapshotRequest.Builder> createDbClusterSnapshotRequest) Creates a snapshot of a cluster.
This is a convenience which creates an instance of the
CreateDbClusterSnapshotRequest.Builder
avoiding the need to create one manually viaCreateDbClusterSnapshotRequest.builder()
- Parameters:
createDbClusterSnapshotRequest
- AConsumer
that will call methods onCreateDbClusterSnapshotRequest.Builder
to create a request. Represents the input of CreateDBClusterSnapshot.- Returns:
- A Java Future containing the result of the CreateDBClusterSnapshot operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DbClusterSnapshotAlreadyExistsException You already have a cluster snapshot with the given identifier.
- InvalidDbClusterStateException The cluster isn't in a valid state.
- DbClusterNotFoundException
DBClusterIdentifier
doesn't refer to an existing cluster. - SnapshotQuotaExceededException The request would cause you to exceed the allowed number of snapshots.
- InvalidDbClusterSnapshotStateException The provided value isn't a valid cluster snapshot state.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
createDBInstance
default CompletableFuture<CreateDbInstanceResponse> createDBInstance(CreateDbInstanceRequest createDbInstanceRequest) Creates a new instance.
- Parameters:
createDbInstanceRequest
- Represents the input to CreateDBInstance.- Returns:
- A Java Future containing the result of the CreateDBInstance operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DbInstanceAlreadyExistsException You already have a instance with the given identifier.
- InsufficientDbInstanceCapacityException The specified instance class isn't available in the specified Availability Zone.
- DbParameterGroupNotFoundException
DBParameterGroupName
doesn't refer to an existing parameter group. - DbSecurityGroupNotFoundException
DBSecurityGroupName
doesn't refer to an existing security group. - InstanceQuotaExceededException The request would cause you to exceed the allowed number of instances.
- StorageQuotaExceededException The request would cause you to exceed the allowed amount of storage available across all instances.
- DbSubnetGroupNotFoundException
DBSubnetGroupName
doesn't refer to an existing subnet group. - DbSubnetGroupDoesNotCoverEnoughAZsException Subnets in the subnet group should cover at least two Availability Zones unless there is only one Availability Zone.
- InvalidDbClusterStateException The cluster isn't in a valid state.
- InvalidSubnetException The requested subnet is not valid, or multiple subnets were requested that are not all in a common virtual private cloud (VPC).
- InvalidVpcNetworkStateException The subnet group doesn't cover all Availability Zones after it is created because of changes that were made.
- DbClusterNotFoundException
DBClusterIdentifier
doesn't refer to an existing cluster. - StorageTypeNotSupportedException Storage of the specified
StorageType
can't be associated with the DB instance. - AuthorizationNotFoundException The specified CIDR IP or Amazon EC2 security group isn't authorized
for the specified security group.
Amazon DocumentDB also might not be authorized to perform necessary actions on your behalf using IAM.
- KmsKeyNotAccessibleException An error occurred when accessing an KMS key.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
createDBInstance
default CompletableFuture<CreateDbInstanceResponse> createDBInstance(Consumer<CreateDbInstanceRequest.Builder> createDbInstanceRequest) Creates a new instance.
This is a convenience which creates an instance of the
CreateDbInstanceRequest.Builder
avoiding the need to create one manually viaCreateDbInstanceRequest.builder()
- Parameters:
createDbInstanceRequest
- AConsumer
that will call methods onCreateDbInstanceRequest.Builder
to create a request. Represents the input to CreateDBInstance.- Returns:
- A Java Future containing the result of the CreateDBInstance operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DbInstanceAlreadyExistsException You already have a instance with the given identifier.
- InsufficientDbInstanceCapacityException The specified instance class isn't available in the specified Availability Zone.
- DbParameterGroupNotFoundException
DBParameterGroupName
doesn't refer to an existing parameter group. - DbSecurityGroupNotFoundException
DBSecurityGroupName
doesn't refer to an existing security group. - InstanceQuotaExceededException The request would cause you to exceed the allowed number of instances.
- StorageQuotaExceededException The request would cause you to exceed the allowed amount of storage available across all instances.
- DbSubnetGroupNotFoundException
DBSubnetGroupName
doesn't refer to an existing subnet group. - DbSubnetGroupDoesNotCoverEnoughAZsException Subnets in the subnet group should cover at least two Availability Zones unless there is only one Availability Zone.
- InvalidDbClusterStateException The cluster isn't in a valid state.
- InvalidSubnetException The requested subnet is not valid, or multiple subnets were requested that are not all in a common virtual private cloud (VPC).
- InvalidVpcNetworkStateException The subnet group doesn't cover all Availability Zones after it is created because of changes that were made.
- DbClusterNotFoundException
DBClusterIdentifier
doesn't refer to an existing cluster. - StorageTypeNotSupportedException Storage of the specified
StorageType
can't be associated with the DB instance. - AuthorizationNotFoundException The specified CIDR IP or Amazon EC2 security group isn't authorized
for the specified security group.
Amazon DocumentDB also might not be authorized to perform necessary actions on your behalf using IAM.
- KmsKeyNotAccessibleException An error occurred when accessing an KMS key.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
createDBSubnetGroup
default CompletableFuture<CreateDbSubnetGroupResponse> createDBSubnetGroup(CreateDbSubnetGroupRequest createDbSubnetGroupRequest) Creates a new subnet group. subnet groups must contain at least one subnet in at least two Availability Zones in the Amazon Web Services Region.
- Parameters:
createDbSubnetGroupRequest
- Represents the input to CreateDBSubnetGroup.- Returns:
- A Java Future containing the result of the CreateDBSubnetGroup operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DbSubnetGroupAlreadyExistsException
DBSubnetGroupName
is already being used by an existing subnet group. - DbSubnetGroupQuotaExceededException The request would cause you to exceed the allowed number of subnet groups.
- DbSubnetQuotaExceededException The request would cause you to exceed the allowed number of subnets in a subnet group.
- DbSubnetGroupDoesNotCoverEnoughAZsException Subnets in the subnet group should cover at least two Availability Zones unless there is only one Availability Zone.
- InvalidSubnetException The requested subnet is not valid, or multiple subnets were requested that are not all in a common virtual private cloud (VPC).
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- DbSubnetGroupAlreadyExistsException
- See Also:
-
createDBSubnetGroup
default CompletableFuture<CreateDbSubnetGroupResponse> createDBSubnetGroup(Consumer<CreateDbSubnetGroupRequest.Builder> createDbSubnetGroupRequest) Creates a new subnet group. subnet groups must contain at least one subnet in at least two Availability Zones in the Amazon Web Services Region.
This is a convenience which creates an instance of the
CreateDbSubnetGroupRequest.Builder
avoiding the need to create one manually viaCreateDbSubnetGroupRequest.builder()
- Parameters:
createDbSubnetGroupRequest
- AConsumer
that will call methods onCreateDbSubnetGroupRequest.Builder
to create a request. Represents the input to CreateDBSubnetGroup.- Returns:
- A Java Future containing the result of the CreateDBSubnetGroup operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DbSubnetGroupAlreadyExistsException
DBSubnetGroupName
is already being used by an existing subnet group. - DbSubnetGroupQuotaExceededException The request would cause you to exceed the allowed number of subnet groups.
- DbSubnetQuotaExceededException The request would cause you to exceed the allowed number of subnets in a subnet group.
- DbSubnetGroupDoesNotCoverEnoughAZsException Subnets in the subnet group should cover at least two Availability Zones unless there is only one Availability Zone.
- InvalidSubnetException The requested subnet is not valid, or multiple subnets were requested that are not all in a common virtual private cloud (VPC).
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- DbSubnetGroupAlreadyExistsException
- See Also:
-
createEventSubscription
default CompletableFuture<CreateEventSubscriptionResponse> createEventSubscription(CreateEventSubscriptionRequest createEventSubscriptionRequest) Creates an Amazon DocumentDB event notification subscription. This action requires a topic Amazon Resource Name (ARN) created by using the Amazon DocumentDB console, the Amazon SNS console, or the Amazon SNS API. To obtain an ARN with Amazon SNS, you must create a topic in Amazon SNS and subscribe to the topic. The ARN is displayed in the Amazon SNS console.
You can specify the type of source (
SourceType
) that you want to be notified of. You can also provide a list of Amazon DocumentDB sources (SourceIds
) that trigger the events, and you can provide a list of event categories (EventCategories
) for events that you want to be notified of. For example, you can specifySourceType = db-instance
,SourceIds = mydbinstance1, mydbinstance2
andEventCategories = Availability, Backup
.If you specify both the
SourceType
andSourceIds
(such asSourceType = db-instance
andSourceIdentifier = myDBInstance1
), you are notified of all thedb-instance
events for the specified source. If you specify aSourceType
but do not specify aSourceIdentifier
, you receive notice of the events for that source type for all your Amazon DocumentDB sources. If you do not specify either theSourceType
or theSourceIdentifier
, you are notified of events generated from all Amazon DocumentDB sources belonging to your customer account.- Parameters:
createEventSubscriptionRequest
- Represents the input to CreateEventSubscription.- Returns:
- A Java Future containing the result of the CreateEventSubscription operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- EventSubscriptionQuotaExceededException You have reached the maximum number of event subscriptions.
- SubscriptionAlreadyExistException The provided subscription name already exists.
- SnsInvalidTopicException Amazon SNS has responded that there is a problem with the specified topic.
- SnsNoAuthorizationException You do not have permission to publish to the SNS topic Amazon Resource Name (ARN).
- SnsTopicArnNotFoundException The SNS topic Amazon Resource Name (ARN) does not exist.
- SubscriptionCategoryNotFoundException The provided category does not exist.
- SourceNotFoundException The requested source could not be found.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
createEventSubscription
default CompletableFuture<CreateEventSubscriptionResponse> createEventSubscription(Consumer<CreateEventSubscriptionRequest.Builder> createEventSubscriptionRequest) Creates an Amazon DocumentDB event notification subscription. This action requires a topic Amazon Resource Name (ARN) created by using the Amazon DocumentDB console, the Amazon SNS console, or the Amazon SNS API. To obtain an ARN with Amazon SNS, you must create a topic in Amazon SNS and subscribe to the topic. The ARN is displayed in the Amazon SNS console.
You can specify the type of source (
SourceType
) that you want to be notified of. You can also provide a list of Amazon DocumentDB sources (SourceIds
) that trigger the events, and you can provide a list of event categories (EventCategories
) for events that you want to be notified of. For example, you can specifySourceType = db-instance
,SourceIds = mydbinstance1, mydbinstance2
andEventCategories = Availability, Backup
.If you specify both the
SourceType
andSourceIds
(such asSourceType = db-instance
andSourceIdentifier = myDBInstance1
), you are notified of all thedb-instance
events for the specified source. If you specify aSourceType
but do not specify aSourceIdentifier
, you receive notice of the events for that source type for all your Amazon DocumentDB sources. If you do not specify either theSourceType
or theSourceIdentifier
, you are notified of events generated from all Amazon DocumentDB sources belonging to your customer account.
This is a convenience which creates an instance of the
CreateEventSubscriptionRequest.Builder
avoiding the need to create one manually viaCreateEventSubscriptionRequest.builder()
- Parameters:
createEventSubscriptionRequest
- AConsumer
that will call methods onCreateEventSubscriptionRequest.Builder
to create a request. Represents the input to CreateEventSubscription.- Returns:
- A Java Future containing the result of the CreateEventSubscription operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- EventSubscriptionQuotaExceededException You have reached the maximum number of event subscriptions.
- SubscriptionAlreadyExistException The provided subscription name already exists.
- SnsInvalidTopicException Amazon SNS has responded that there is a problem with the specified topic.
- SnsNoAuthorizationException You do not have permission to publish to the SNS topic Amazon Resource Name (ARN).
- SnsTopicArnNotFoundException The SNS topic Amazon Resource Name (ARN) does not exist.
- SubscriptionCategoryNotFoundException The provided category does not exist.
- SourceNotFoundException The requested source could not be found.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
createGlobalCluster
default CompletableFuture<CreateGlobalClusterResponse> createGlobalCluster(CreateGlobalClusterRequest createGlobalClusterRequest) Creates an Amazon DocumentDB global cluster that can span multiple multiple Amazon Web Services Regions. The global cluster contains one primary cluster with read-write capability, and up-to give read-only secondary clusters. Global clusters uses storage-based fast replication across regions with latencies less than one second, using dedicated infrastructure with no impact to your workload’s performance.
You can create a global cluster that is initially empty, and then add a primary and a secondary to it. Or you can specify an existing cluster during the create operation, and this cluster becomes the primary of the global cluster.
This action only applies to Amazon DocumentDB clusters.
- Parameters:
createGlobalClusterRequest
- Represents the input to CreateGlobalCluster.- Returns:
- A Java Future containing the result of the CreateGlobalCluster operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- GlobalClusterAlreadyExistsException The
GlobalClusterIdentifier
already exists. Choose a new global cluster identifier (unique name) to create a new global cluster. - GlobalClusterQuotaExceededException The number of global clusters for this account is already at the maximum allowed.
- InvalidDbClusterStateException The cluster isn't in a valid state.
- DbClusterNotFoundException
DBClusterIdentifier
doesn't refer to an existing cluster. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- GlobalClusterAlreadyExistsException The
- See Also:
-
createGlobalCluster
default CompletableFuture<CreateGlobalClusterResponse> createGlobalCluster(Consumer<CreateGlobalClusterRequest.Builder> createGlobalClusterRequest) Creates an Amazon DocumentDB global cluster that can span multiple multiple Amazon Web Services Regions. The global cluster contains one primary cluster with read-write capability, and up-to give read-only secondary clusters. Global clusters uses storage-based fast replication across regions with latencies less than one second, using dedicated infrastructure with no impact to your workload’s performance.
You can create a global cluster that is initially empty, and then add a primary and a secondary to it. Or you can specify an existing cluster during the create operation, and this cluster becomes the primary of the global cluster.
This action only applies to Amazon DocumentDB clusters.
This is a convenience which creates an instance of the
CreateGlobalClusterRequest.Builder
avoiding the need to create one manually viaCreateGlobalClusterRequest.builder()
- Parameters:
createGlobalClusterRequest
- AConsumer
that will call methods onCreateGlobalClusterRequest.Builder
to create a request. Represents the input to CreateGlobalCluster.- Returns:
- A Java Future containing the result of the CreateGlobalCluster operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- GlobalClusterAlreadyExistsException The
GlobalClusterIdentifier
already exists. Choose a new global cluster identifier (unique name) to create a new global cluster. - GlobalClusterQuotaExceededException The number of global clusters for this account is already at the maximum allowed.
- InvalidDbClusterStateException The cluster isn't in a valid state.
- DbClusterNotFoundException
DBClusterIdentifier
doesn't refer to an existing cluster. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- GlobalClusterAlreadyExistsException The
- See Also:
-
deleteDBCluster
default CompletableFuture<DeleteDbClusterResponse> deleteDBCluster(DeleteDbClusterRequest deleteDbClusterRequest) Deletes a previously provisioned cluster. When you delete a cluster, all automated backups for that cluster are deleted and can't be recovered. Manual DB cluster snapshots of the specified cluster are not deleted.
- Parameters:
deleteDbClusterRequest
- Represents the input to DeleteDBCluster.- Returns:
- A Java Future containing the result of the DeleteDBCluster operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DbClusterNotFoundException
DBClusterIdentifier
doesn't refer to an existing cluster. - InvalidDbClusterStateException The cluster isn't in a valid state.
- DbClusterSnapshotAlreadyExistsException You already have a cluster snapshot with the given identifier.
- SnapshotQuotaExceededException The request would cause you to exceed the allowed number of snapshots.
- InvalidDbClusterSnapshotStateException The provided value isn't a valid cluster snapshot state.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- DbClusterNotFoundException
- See Also:
-
deleteDBCluster
default CompletableFuture<DeleteDbClusterResponse> deleteDBCluster(Consumer<DeleteDbClusterRequest.Builder> deleteDbClusterRequest) Deletes a previously provisioned cluster. When you delete a cluster, all automated backups for that cluster are deleted and can't be recovered. Manual DB cluster snapshots of the specified cluster are not deleted.
This is a convenience which creates an instance of the
DeleteDbClusterRequest.Builder
avoiding the need to create one manually viaDeleteDbClusterRequest.builder()
- Parameters:
deleteDbClusterRequest
- AConsumer
that will call methods onDeleteDbClusterRequest.Builder
to create a request. Represents the input to DeleteDBCluster.- Returns:
- A Java Future containing the result of the DeleteDBCluster operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DbClusterNotFoundException
DBClusterIdentifier
doesn't refer to an existing cluster. - InvalidDbClusterStateException The cluster isn't in a valid state.
- DbClusterSnapshotAlreadyExistsException You already have a cluster snapshot with the given identifier.
- SnapshotQuotaExceededException The request would cause you to exceed the allowed number of snapshots.
- InvalidDbClusterSnapshotStateException The provided value isn't a valid cluster snapshot state.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- DbClusterNotFoundException
- See Also:
-
deleteDBClusterParameterGroup
default CompletableFuture<DeleteDbClusterParameterGroupResponse> deleteDBClusterParameterGroup(DeleteDbClusterParameterGroupRequest deleteDbClusterParameterGroupRequest) Deletes a specified cluster parameter group. The cluster parameter group to be deleted can't be associated with any clusters.
- Parameters:
deleteDbClusterParameterGroupRequest
- Represents the input to DeleteDBClusterParameterGroup.- Returns:
- A Java Future containing the result of the DeleteDBClusterParameterGroup operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidDbParameterGroupStateException The parameter group is in use, or it is in a state that is not valid. If you are trying to delete the parameter group, you can't delete it when the parameter group is in this state.
- DbParameterGroupNotFoundException
DBParameterGroupName
doesn't refer to an existing parameter group. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
deleteDBClusterParameterGroup
default CompletableFuture<DeleteDbClusterParameterGroupResponse> deleteDBClusterParameterGroup(Consumer<DeleteDbClusterParameterGroupRequest.Builder> deleteDbClusterParameterGroupRequest) Deletes a specified cluster parameter group. The cluster parameter group to be deleted can't be associated with any clusters.
This is a convenience which creates an instance of the
DeleteDbClusterParameterGroupRequest.Builder
avoiding the need to create one manually viaDeleteDbClusterParameterGroupRequest.builder()
- Parameters:
deleteDbClusterParameterGroupRequest
- AConsumer
that will call methods onDeleteDbClusterParameterGroupRequest.Builder
to create a request. Represents the input to DeleteDBClusterParameterGroup.- Returns:
- A Java Future containing the result of the DeleteDBClusterParameterGroup operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidDbParameterGroupStateException The parameter group is in use, or it is in a state that is not valid. If you are trying to delete the parameter group, you can't delete it when the parameter group is in this state.
- DbParameterGroupNotFoundException
DBParameterGroupName
doesn't refer to an existing parameter group. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
deleteDBClusterSnapshot
default CompletableFuture<DeleteDbClusterSnapshotResponse> deleteDBClusterSnapshot(DeleteDbClusterSnapshotRequest deleteDbClusterSnapshotRequest) Deletes a cluster snapshot. If the snapshot is being copied, the copy operation is terminated.
The cluster snapshot must be in the
available
state to be deleted.- Parameters:
deleteDbClusterSnapshotRequest
- Represents the input to DeleteDBClusterSnapshot.- Returns:
- A Java Future containing the result of the DeleteDBClusterSnapshot operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidDbClusterSnapshotStateException The provided value isn't a valid cluster snapshot state.
- DbClusterSnapshotNotFoundException
DBClusterSnapshotIdentifier
doesn't refer to an existing cluster snapshot. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
deleteDBClusterSnapshot
default CompletableFuture<DeleteDbClusterSnapshotResponse> deleteDBClusterSnapshot(Consumer<DeleteDbClusterSnapshotRequest.Builder> deleteDbClusterSnapshotRequest) Deletes a cluster snapshot. If the snapshot is being copied, the copy operation is terminated.
The cluster snapshot must be in the
available
state to be deleted.
This is a convenience which creates an instance of the
DeleteDbClusterSnapshotRequest.Builder
avoiding the need to create one manually viaDeleteDbClusterSnapshotRequest.builder()
- Parameters:
deleteDbClusterSnapshotRequest
- AConsumer
that will call methods onDeleteDbClusterSnapshotRequest.Builder
to create a request. Represents the input to DeleteDBClusterSnapshot.- Returns:
- A Java Future containing the result of the DeleteDBClusterSnapshot operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidDbClusterSnapshotStateException The provided value isn't a valid cluster snapshot state.
- DbClusterSnapshotNotFoundException
DBClusterSnapshotIdentifier
doesn't refer to an existing cluster snapshot. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
deleteDBInstance
default CompletableFuture<DeleteDbInstanceResponse> deleteDBInstance(DeleteDbInstanceRequest deleteDbInstanceRequest) Deletes a previously provisioned instance.
- Parameters:
deleteDbInstanceRequest
- Represents the input to DeleteDBInstance.- Returns:
- A Java Future containing the result of the DeleteDBInstance operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DbInstanceNotFoundException
DBInstanceIdentifier
doesn't refer to an existing instance. - InvalidDbInstanceStateException The specified instance isn't in the available state.
- DbSnapshotAlreadyExistsException
DBSnapshotIdentifier
is already being used by an existing snapshot. - SnapshotQuotaExceededException The request would cause you to exceed the allowed number of snapshots.
- InvalidDbClusterStateException The cluster isn't in a valid state.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- DbInstanceNotFoundException
- See Also:
-
deleteDBInstance
default CompletableFuture<DeleteDbInstanceResponse> deleteDBInstance(Consumer<DeleteDbInstanceRequest.Builder> deleteDbInstanceRequest) Deletes a previously provisioned instance.
This is a convenience which creates an instance of the
DeleteDbInstanceRequest.Builder
avoiding the need to create one manually viaDeleteDbInstanceRequest.builder()
- Parameters:
deleteDbInstanceRequest
- AConsumer
that will call methods onDeleteDbInstanceRequest.Builder
to create a request. Represents the input to DeleteDBInstance.- Returns:
- A Java Future containing the result of the DeleteDBInstance operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DbInstanceNotFoundException
DBInstanceIdentifier
doesn't refer to an existing instance. - InvalidDbInstanceStateException The specified instance isn't in the available state.
- DbSnapshotAlreadyExistsException
DBSnapshotIdentifier
is already being used by an existing snapshot. - SnapshotQuotaExceededException The request would cause you to exceed the allowed number of snapshots.
- InvalidDbClusterStateException The cluster isn't in a valid state.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- DbInstanceNotFoundException
- See Also:
-
deleteDBSubnetGroup
default CompletableFuture<DeleteDbSubnetGroupResponse> deleteDBSubnetGroup(DeleteDbSubnetGroupRequest deleteDbSubnetGroupRequest) Deletes a subnet group.
The specified database subnet group must not be associated with any DB instances.
- Parameters:
deleteDbSubnetGroupRequest
- Represents the input to DeleteDBSubnetGroup.- Returns:
- A Java Future containing the result of the DeleteDBSubnetGroup operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidDbSubnetGroupStateException The subnet group can't be deleted because it's in use.
- InvalidDbSubnetStateException The subnet isn't in the available state.
- DbSubnetGroupNotFoundException
DBSubnetGroupName
doesn't refer to an existing subnet group. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
deleteDBSubnetGroup
default CompletableFuture<DeleteDbSubnetGroupResponse> deleteDBSubnetGroup(Consumer<DeleteDbSubnetGroupRequest.Builder> deleteDbSubnetGroupRequest) Deletes a subnet group.
The specified database subnet group must not be associated with any DB instances.
This is a convenience which creates an instance of the
DeleteDbSubnetGroupRequest.Builder
avoiding the need to create one manually viaDeleteDbSubnetGroupRequest.builder()
- Parameters:
deleteDbSubnetGroupRequest
- AConsumer
that will call methods onDeleteDbSubnetGroupRequest.Builder
to create a request. Represents the input to DeleteDBSubnetGroup.- Returns:
- A Java Future containing the result of the DeleteDBSubnetGroup operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidDbSubnetGroupStateException The subnet group can't be deleted because it's in use.
- InvalidDbSubnetStateException The subnet isn't in the available state.
- DbSubnetGroupNotFoundException
DBSubnetGroupName
doesn't refer to an existing subnet group. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
deleteEventSubscription
default CompletableFuture<DeleteEventSubscriptionResponse> deleteEventSubscription(DeleteEventSubscriptionRequest deleteEventSubscriptionRequest) Deletes an Amazon DocumentDB event notification subscription.
- Parameters:
deleteEventSubscriptionRequest
- Represents the input to DeleteEventSubscription.- Returns:
- A Java Future containing the result of the DeleteEventSubscription operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- SubscriptionNotFoundException The subscription name does not exist.
- InvalidEventSubscriptionStateException Someone else might be modifying a subscription. Wait a few seconds, and try again.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
deleteEventSubscription
default CompletableFuture<DeleteEventSubscriptionResponse> deleteEventSubscription(Consumer<DeleteEventSubscriptionRequest.Builder> deleteEventSubscriptionRequest) Deletes an Amazon DocumentDB event notification subscription.
This is a convenience which creates an instance of the
DeleteEventSubscriptionRequest.Builder
avoiding the need to create one manually viaDeleteEventSubscriptionRequest.builder()
- Parameters:
deleteEventSubscriptionRequest
- AConsumer
that will call methods onDeleteEventSubscriptionRequest.Builder
to create a request. Represents the input to DeleteEventSubscription.- Returns:
- A Java Future containing the result of the DeleteEventSubscription operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- SubscriptionNotFoundException The subscription name does not exist.
- InvalidEventSubscriptionStateException Someone else might be modifying a subscription. Wait a few seconds, and try again.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
deleteGlobalCluster
default CompletableFuture<DeleteGlobalClusterResponse> deleteGlobalCluster(DeleteGlobalClusterRequest deleteGlobalClusterRequest) Deletes a global cluster. The primary and secondary clusters must already be detached or deleted before attempting to delete a global cluster.
This action only applies to Amazon DocumentDB clusters.
- Parameters:
deleteGlobalClusterRequest
- Represents the input to DeleteGlobalCluster.- Returns:
- A Java Future containing the result of the DeleteGlobalCluster operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- GlobalClusterNotFoundException The
GlobalClusterIdentifier
doesn't refer to an existing global cluster. - InvalidGlobalClusterStateException The requested operation can't be performed while the cluster is in this state.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- GlobalClusterNotFoundException The
- See Also:
-
deleteGlobalCluster
default CompletableFuture<DeleteGlobalClusterResponse> deleteGlobalCluster(Consumer<DeleteGlobalClusterRequest.Builder> deleteGlobalClusterRequest) Deletes a global cluster. The primary and secondary clusters must already be detached or deleted before attempting to delete a global cluster.
This action only applies to Amazon DocumentDB clusters.
This is a convenience which creates an instance of the
DeleteGlobalClusterRequest.Builder
avoiding the need to create one manually viaDeleteGlobalClusterRequest.builder()
- Parameters:
deleteGlobalClusterRequest
- AConsumer
that will call methods onDeleteGlobalClusterRequest.Builder
to create a request. Represents the input to DeleteGlobalCluster.- Returns:
- A Java Future containing the result of the DeleteGlobalCluster operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- GlobalClusterNotFoundException The
GlobalClusterIdentifier
doesn't refer to an existing global cluster. - InvalidGlobalClusterStateException The requested operation can't be performed while the cluster is in this state.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- GlobalClusterNotFoundException The
- See Also:
-
describeCertificates
default CompletableFuture<DescribeCertificatesResponse> describeCertificates(DescribeCertificatesRequest describeCertificatesRequest) Returns a list of certificate authority (CA) certificates provided by Amazon DocumentDB for this Amazon Web Services account.
- Parameters:
describeCertificatesRequest
-- Returns:
- A Java Future containing the result of the DescribeCertificates operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- CertificateNotFoundException
CertificateIdentifier
doesn't refer to an existing certificate. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- CertificateNotFoundException
- See Also:
-
describeCertificates
default CompletableFuture<DescribeCertificatesResponse> describeCertificates(Consumer<DescribeCertificatesRequest.Builder> describeCertificatesRequest) Returns a list of certificate authority (CA) certificates provided by Amazon DocumentDB for this Amazon Web Services account.
This is a convenience which creates an instance of the
DescribeCertificatesRequest.Builder
avoiding the need to create one manually viaDescribeCertificatesRequest.builder()
- Parameters:
describeCertificatesRequest
- AConsumer
that will call methods onDescribeCertificatesRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the DescribeCertificates operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- CertificateNotFoundException
CertificateIdentifier
doesn't refer to an existing certificate. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- CertificateNotFoundException
- See Also:
-
describeCertificatesPaginator
default DescribeCertificatesPublisher describeCertificatesPaginator(DescribeCertificatesRequest describeCertificatesRequest) This is a variant of
describeCertificates(software.amazon.awssdk.services.docdb.model.DescribeCertificatesRequest)
operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber)
. Each call to the subscribe method will result in a newSubscription
i.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper methodsoftware.amazon.awssdk.services.docdb.paginators.DescribeCertificatesPublisher publisher = client.describeCertificatesPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
software.amazon.awssdk.services.docdb.paginators.DescribeCertificatesPublisher publisher = client.describeCertificatesPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.docdb.model.DescribeCertificatesResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.docdb.model.DescribeCertificatesResponse response) { //... }; });
Please notice that the configuration of MaxRecords won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
describeCertificates(software.amazon.awssdk.services.docdb.model.DescribeCertificatesRequest)
operation.- Parameters:
describeCertificatesRequest
-- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- CertificateNotFoundException
CertificateIdentifier
doesn't refer to an existing certificate. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- CertificateNotFoundException
- See Also:
-
describeCertificatesPaginator
default DescribeCertificatesPublisher describeCertificatesPaginator(Consumer<DescribeCertificatesRequest.Builder> describeCertificatesRequest) This is a variant of
describeCertificates(software.amazon.awssdk.services.docdb.model.DescribeCertificatesRequest)
operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber)
. Each call to the subscribe method will result in a newSubscription
i.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper methodsoftware.amazon.awssdk.services.docdb.paginators.DescribeCertificatesPublisher publisher = client.describeCertificatesPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
software.amazon.awssdk.services.docdb.paginators.DescribeCertificatesPublisher publisher = client.describeCertificatesPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.docdb.model.DescribeCertificatesResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.docdb.model.DescribeCertificatesResponse response) { //... }; });
Please notice that the configuration of MaxRecords won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
describeCertificates(software.amazon.awssdk.services.docdb.model.DescribeCertificatesRequest)
operation.
This is a convenience which creates an instance of the
DescribeCertificatesRequest.Builder
avoiding the need to create one manually viaDescribeCertificatesRequest.builder()
- Parameters:
describeCertificatesRequest
- AConsumer
that will call methods onDescribeCertificatesRequest.Builder
to create a request.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- CertificateNotFoundException
CertificateIdentifier
doesn't refer to an existing certificate. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- CertificateNotFoundException
- See Also:
-
describeDBClusterParameterGroups
default CompletableFuture<DescribeDbClusterParameterGroupsResponse> describeDBClusterParameterGroups(DescribeDbClusterParameterGroupsRequest describeDbClusterParameterGroupsRequest) Returns a list of
DBClusterParameterGroup
descriptions. If aDBClusterParameterGroupName
parameter is specified, the list contains only the description of the specified cluster parameter group.- Parameters:
describeDbClusterParameterGroupsRequest
- Represents the input to DescribeDBClusterParameterGroups.- Returns:
- A Java Future containing the result of the DescribeDBClusterParameterGroups operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DbParameterGroupNotFoundException
DBParameterGroupName
doesn't refer to an existing parameter group. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- DbParameterGroupNotFoundException
- See Also:
-
describeDBClusterParameterGroups
default CompletableFuture<DescribeDbClusterParameterGroupsResponse> describeDBClusterParameterGroups(Consumer<DescribeDbClusterParameterGroupsRequest.Builder> describeDbClusterParameterGroupsRequest) Returns a list of
DBClusterParameterGroup
descriptions. If aDBClusterParameterGroupName
parameter is specified, the list contains only the description of the specified cluster parameter group.
This is a convenience which creates an instance of the
DescribeDbClusterParameterGroupsRequest.Builder
avoiding the need to create one manually viaDescribeDbClusterParameterGroupsRequest.builder()
- Parameters:
describeDbClusterParameterGroupsRequest
- AConsumer
that will call methods onDescribeDbClusterParameterGroupsRequest.Builder
to create a request. Represents the input to DescribeDBClusterParameterGroups.- Returns:
- A Java Future containing the result of the DescribeDBClusterParameterGroups operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DbParameterGroupNotFoundException
DBParameterGroupName
doesn't refer to an existing parameter group. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- DbParameterGroupNotFoundException
- See Also:
-
describeDBClusterParameterGroups
default CompletableFuture<DescribeDbClusterParameterGroupsResponse> describeDBClusterParameterGroups()Returns a list of
DBClusterParameterGroup
descriptions. If aDBClusterParameterGroupName
parameter is specified, the list contains only the description of the specified cluster parameter group.- Returns:
- A Java Future containing the result of the DescribeDBClusterParameterGroups operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DbParameterGroupNotFoundException
DBParameterGroupName
doesn't refer to an existing parameter group. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- DbParameterGroupNotFoundException
- See Also:
-
describeDBClusterParameterGroupsPaginator
This is a variant of
describeDBClusterParameterGroups(software.amazon.awssdk.services.docdb.model.DescribeDbClusterParameterGroupsRequest)
operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber)
. Each call to the subscribe method will result in a newSubscription
i.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper methodsoftware.amazon.awssdk.services.docdb.paginators.DescribeDBClusterParameterGroupsPublisher publisher = client.describeDBClusterParameterGroupsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
software.amazon.awssdk.services.docdb.paginators.DescribeDBClusterParameterGroupsPublisher publisher = client.describeDBClusterParameterGroupsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.docdb.model.DescribeDbClusterParameterGroupsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.docdb.model.DescribeDbClusterParameterGroupsResponse response) { //... }; });
Please notice that the configuration of MaxRecords won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
describeDBClusterParameterGroups(software.amazon.awssdk.services.docdb.model.DescribeDbClusterParameterGroupsRequest)
operation.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DbParameterGroupNotFoundException
DBParameterGroupName
doesn't refer to an existing parameter group. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- DbParameterGroupNotFoundException
- See Also:
-
describeDBClusterParameterGroupsPaginator
default DescribeDBClusterParameterGroupsPublisher describeDBClusterParameterGroupsPaginator(DescribeDbClusterParameterGroupsRequest describeDbClusterParameterGroupsRequest) This is a variant of
describeDBClusterParameterGroups(software.amazon.awssdk.services.docdb.model.DescribeDbClusterParameterGroupsRequest)
operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber)
. Each call to the subscribe method will result in a newSubscription
i.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper methodsoftware.amazon.awssdk.services.docdb.paginators.DescribeDBClusterParameterGroupsPublisher publisher = client.describeDBClusterParameterGroupsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
software.amazon.awssdk.services.docdb.paginators.DescribeDBClusterParameterGroupsPublisher publisher = client.describeDBClusterParameterGroupsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.docdb.model.DescribeDbClusterParameterGroupsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.docdb.model.DescribeDbClusterParameterGroupsResponse response) { //... }; });
Please notice that the configuration of MaxRecords won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
describeDBClusterParameterGroups(software.amazon.awssdk.services.docdb.model.DescribeDbClusterParameterGroupsRequest)
operation.- Parameters:
describeDbClusterParameterGroupsRequest
- Represents the input to DescribeDBClusterParameterGroups.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DbParameterGroupNotFoundException
DBParameterGroupName
doesn't refer to an existing parameter group. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- DbParameterGroupNotFoundException
- See Also:
-
describeDBClusterParameterGroupsPaginator
default DescribeDBClusterParameterGroupsPublisher describeDBClusterParameterGroupsPaginator(Consumer<DescribeDbClusterParameterGroupsRequest.Builder> describeDbClusterParameterGroupsRequest) This is a variant of
describeDBClusterParameterGroups(software.amazon.awssdk.services.docdb.model.DescribeDbClusterParameterGroupsRequest)
operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber)
. Each call to the subscribe method will result in a newSubscription
i.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper methodsoftware.amazon.awssdk.services.docdb.paginators.DescribeDBClusterParameterGroupsPublisher publisher = client.describeDBClusterParameterGroupsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
software.amazon.awssdk.services.docdb.paginators.DescribeDBClusterParameterGroupsPublisher publisher = client.describeDBClusterParameterGroupsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.docdb.model.DescribeDbClusterParameterGroupsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.docdb.model.DescribeDbClusterParameterGroupsResponse response) { //... }; });
Please notice that the configuration of MaxRecords won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
describeDBClusterParameterGroups(software.amazon.awssdk.services.docdb.model.DescribeDbClusterParameterGroupsRequest)
operation.
This is a convenience which creates an instance of the
DescribeDbClusterParameterGroupsRequest.Builder
avoiding the need to create one manually viaDescribeDbClusterParameterGroupsRequest.builder()
- Parameters:
describeDbClusterParameterGroupsRequest
- AConsumer
that will call methods onDescribeDbClusterParameterGroupsRequest.Builder
to create a request. Represents the input to DescribeDBClusterParameterGroups.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DbParameterGroupNotFoundException
DBParameterGroupName
doesn't refer to an existing parameter group. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- DbParameterGroupNotFoundException
- See Also:
-
describeDBClusterParameters
default CompletableFuture<DescribeDbClusterParametersResponse> describeDBClusterParameters(DescribeDbClusterParametersRequest describeDbClusterParametersRequest) Returns the detailed parameter list for a particular cluster parameter group.
- Parameters:
describeDbClusterParametersRequest
- Represents the input to DescribeDBClusterParameters.- Returns:
- A Java Future containing the result of the DescribeDBClusterParameters operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DbParameterGroupNotFoundException
DBParameterGroupName
doesn't refer to an existing parameter group. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- DbParameterGroupNotFoundException
- See Also:
-
describeDBClusterParameters
default CompletableFuture<DescribeDbClusterParametersResponse> describeDBClusterParameters(Consumer<DescribeDbClusterParametersRequest.Builder> describeDbClusterParametersRequest) Returns the detailed parameter list for a particular cluster parameter group.
This is a convenience which creates an instance of the
DescribeDbClusterParametersRequest.Builder
avoiding the need to create one manually viaDescribeDbClusterParametersRequest.builder()
- Parameters:
describeDbClusterParametersRequest
- AConsumer
that will call methods onDescribeDbClusterParametersRequest.Builder
to create a request. Represents the input to DescribeDBClusterParameters.- Returns:
- A Java Future containing the result of the DescribeDBClusterParameters operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DbParameterGroupNotFoundException
DBParameterGroupName
doesn't refer to an existing parameter group. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- DbParameterGroupNotFoundException
- See Also:
-
describeDBClusterParametersPaginator
default DescribeDBClusterParametersPublisher describeDBClusterParametersPaginator(DescribeDbClusterParametersRequest describeDbClusterParametersRequest) This is a variant of
describeDBClusterParameters(software.amazon.awssdk.services.docdb.model.DescribeDbClusterParametersRequest)
operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber)
. Each call to the subscribe method will result in a newSubscription
i.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper methodsoftware.amazon.awssdk.services.docdb.paginators.DescribeDBClusterParametersPublisher publisher = client.describeDBClusterParametersPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
software.amazon.awssdk.services.docdb.paginators.DescribeDBClusterParametersPublisher publisher = client.describeDBClusterParametersPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.docdb.model.DescribeDbClusterParametersResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.docdb.model.DescribeDbClusterParametersResponse response) { //... }; });
Please notice that the configuration of MaxRecords won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
describeDBClusterParameters(software.amazon.awssdk.services.docdb.model.DescribeDbClusterParametersRequest)
operation.- Parameters:
describeDbClusterParametersRequest
- Represents the input to DescribeDBClusterParameters.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DbParameterGroupNotFoundException
DBParameterGroupName
doesn't refer to an existing parameter group. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- DbParameterGroupNotFoundException
- See Also:
-
describeDBClusterParametersPaginator
default DescribeDBClusterParametersPublisher describeDBClusterParametersPaginator(Consumer<DescribeDbClusterParametersRequest.Builder> describeDbClusterParametersRequest) This is a variant of
describeDBClusterParameters(software.amazon.awssdk.services.docdb.model.DescribeDbClusterParametersRequest)
operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber)
. Each call to the subscribe method will result in a newSubscription
i.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper methodsoftware.amazon.awssdk.services.docdb.paginators.DescribeDBClusterParametersPublisher publisher = client.describeDBClusterParametersPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
software.amazon.awssdk.services.docdb.paginators.DescribeDBClusterParametersPublisher publisher = client.describeDBClusterParametersPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.docdb.model.DescribeDbClusterParametersResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.docdb.model.DescribeDbClusterParametersResponse response) { //... }; });
Please notice that the configuration of MaxRecords won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
describeDBClusterParameters(software.amazon.awssdk.services.docdb.model.DescribeDbClusterParametersRequest)
operation.
This is a convenience which creates an instance of the
DescribeDbClusterParametersRequest.Builder
avoiding the need to create one manually viaDescribeDbClusterParametersRequest.builder()
- Parameters:
describeDbClusterParametersRequest
- AConsumer
that will call methods onDescribeDbClusterParametersRequest.Builder
to create a request. Represents the input to DescribeDBClusterParameters.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DbParameterGroupNotFoundException
DBParameterGroupName
doesn't refer to an existing parameter group. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- DbParameterGroupNotFoundException
- See Also:
-
describeDBClusterSnapshotAttributes
default CompletableFuture<DescribeDbClusterSnapshotAttributesResponse> describeDBClusterSnapshotAttributes(DescribeDbClusterSnapshotAttributesRequest describeDbClusterSnapshotAttributesRequest) Returns a list of cluster snapshot attribute names and values for a manual DB cluster snapshot.
When you share snapshots with other Amazon Web Services accounts,
DescribeDBClusterSnapshotAttributes
returns therestore
attribute and a list of IDs for the Amazon Web Services accounts that are authorized to copy or restore the manual cluster snapshot. Ifall
is included in the list of values for therestore
attribute, then the manual cluster snapshot is public and can be copied or restored by all Amazon Web Services accounts.- Parameters:
describeDbClusterSnapshotAttributesRequest
- Represents the input to DescribeDBClusterSnapshotAttributes.- Returns:
- A Java Future containing the result of the DescribeDBClusterSnapshotAttributes operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DbClusterSnapshotNotFoundException
DBClusterSnapshotIdentifier
doesn't refer to an existing cluster snapshot. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- DbClusterSnapshotNotFoundException
- See Also:
-
describeDBClusterSnapshotAttributes
default CompletableFuture<DescribeDbClusterSnapshotAttributesResponse> describeDBClusterSnapshotAttributes(Consumer<DescribeDbClusterSnapshotAttributesRequest.Builder> describeDbClusterSnapshotAttributesRequest) Returns a list of cluster snapshot attribute names and values for a manual DB cluster snapshot.
When you share snapshots with other Amazon Web Services accounts,
DescribeDBClusterSnapshotAttributes
returns therestore
attribute and a list of IDs for the Amazon Web Services accounts that are authorized to copy or restore the manual cluster snapshot. Ifall
is included in the list of values for therestore
attribute, then the manual cluster snapshot is public and can be copied or restored by all Amazon Web Services accounts.
This is a convenience which creates an instance of the
DescribeDbClusterSnapshotAttributesRequest.Builder
avoiding the need to create one manually viaDescribeDbClusterSnapshotAttributesRequest.builder()
- Parameters:
describeDbClusterSnapshotAttributesRequest
- AConsumer
that will call methods onDescribeDbClusterSnapshotAttributesRequest.Builder
to create a request. Represents the input to DescribeDBClusterSnapshotAttributes.- Returns:
- A Java Future containing the result of the DescribeDBClusterSnapshotAttributes operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DbClusterSnapshotNotFoundException
DBClusterSnapshotIdentifier
doesn't refer to an existing cluster snapshot. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- DbClusterSnapshotNotFoundException
- See Also:
-
describeDBClusterSnapshots
default CompletableFuture<DescribeDbClusterSnapshotsResponse> describeDBClusterSnapshots(DescribeDbClusterSnapshotsRequest describeDbClusterSnapshotsRequest) Returns information about cluster snapshots. This API operation supports pagination.
- Parameters:
describeDbClusterSnapshotsRequest
- Represents the input to DescribeDBClusterSnapshots.- Returns:
- A Java Future containing the result of the DescribeDBClusterSnapshots operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DbClusterSnapshotNotFoundException
DBClusterSnapshotIdentifier
doesn't refer to an existing cluster snapshot. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- DbClusterSnapshotNotFoundException
- See Also:
-
describeDBClusterSnapshots
default CompletableFuture<DescribeDbClusterSnapshotsResponse> describeDBClusterSnapshots(Consumer<DescribeDbClusterSnapshotsRequest.Builder> describeDbClusterSnapshotsRequest) Returns information about cluster snapshots. This API operation supports pagination.
This is a convenience which creates an instance of the
DescribeDbClusterSnapshotsRequest.Builder
avoiding the need to create one manually viaDescribeDbClusterSnapshotsRequest.builder()
- Parameters:
describeDbClusterSnapshotsRequest
- AConsumer
that will call methods onDescribeDbClusterSnapshotsRequest.Builder
to create a request. Represents the input to DescribeDBClusterSnapshots.- Returns:
- A Java Future containing the result of the DescribeDBClusterSnapshots operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DbClusterSnapshotNotFoundException
DBClusterSnapshotIdentifier
doesn't refer to an existing cluster snapshot. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- DbClusterSnapshotNotFoundException
- See Also:
-
describeDBClusterSnapshots
Returns information about cluster snapshots. This API operation supports pagination.
- Returns:
- A Java Future containing the result of the DescribeDBClusterSnapshots operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DbClusterSnapshotNotFoundException
DBClusterSnapshotIdentifier
doesn't refer to an existing cluster snapshot. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- DbClusterSnapshotNotFoundException
- See Also:
-
describeDBClusterSnapshotsPaginator
This is a variant of
describeDBClusterSnapshots(software.amazon.awssdk.services.docdb.model.DescribeDbClusterSnapshotsRequest)
operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber)
. Each call to the subscribe method will result in a newSubscription
i.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper methodsoftware.amazon.awssdk.services.docdb.paginators.DescribeDBClusterSnapshotsPublisher publisher = client.describeDBClusterSnapshotsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
software.amazon.awssdk.services.docdb.paginators.DescribeDBClusterSnapshotsPublisher publisher = client.describeDBClusterSnapshotsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.docdb.model.DescribeDbClusterSnapshotsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.docdb.model.DescribeDbClusterSnapshotsResponse response) { //... }; });
Please notice that the configuration of MaxRecords won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
describeDBClusterSnapshots(software.amazon.awssdk.services.docdb.model.DescribeDbClusterSnapshotsRequest)
operation.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DbClusterSnapshotNotFoundException
DBClusterSnapshotIdentifier
doesn't refer to an existing cluster snapshot. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- DbClusterSnapshotNotFoundException
- See Also:
-
describeDBClusterSnapshotsPaginator
default DescribeDBClusterSnapshotsPublisher describeDBClusterSnapshotsPaginator(DescribeDbClusterSnapshotsRequest describeDbClusterSnapshotsRequest) This is a variant of
describeDBClusterSnapshots(software.amazon.awssdk.services.docdb.model.DescribeDbClusterSnapshotsRequest)
operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber)
. Each call to the subscribe method will result in a newSubscription
i.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper methodsoftware.amazon.awssdk.services.docdb.paginators.DescribeDBClusterSnapshotsPublisher publisher = client.describeDBClusterSnapshotsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
software.amazon.awssdk.services.docdb.paginators.DescribeDBClusterSnapshotsPublisher publisher = client.describeDBClusterSnapshotsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.docdb.model.DescribeDbClusterSnapshotsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.docdb.model.DescribeDbClusterSnapshotsResponse response) { //... }; });
Please notice that the configuration of MaxRecords won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
describeDBClusterSnapshots(software.amazon.awssdk.services.docdb.model.DescribeDbClusterSnapshotsRequest)
operation.- Parameters:
describeDbClusterSnapshotsRequest
- Represents the input to DescribeDBClusterSnapshots.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DbClusterSnapshotNotFoundException
DBClusterSnapshotIdentifier
doesn't refer to an existing cluster snapshot. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- DbClusterSnapshotNotFoundException
- See Also:
-
describeDBClusterSnapshotsPaginator
default DescribeDBClusterSnapshotsPublisher describeDBClusterSnapshotsPaginator(Consumer<DescribeDbClusterSnapshotsRequest.Builder> describeDbClusterSnapshotsRequest) This is a variant of
describeDBClusterSnapshots(software.amazon.awssdk.services.docdb.model.DescribeDbClusterSnapshotsRequest)
operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber)
. Each call to the subscribe method will result in a newSubscription
i.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper methodsoftware.amazon.awssdk.services.docdb.paginators.DescribeDBClusterSnapshotsPublisher publisher = client.describeDBClusterSnapshotsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
software.amazon.awssdk.services.docdb.paginators.DescribeDBClusterSnapshotsPublisher publisher = client.describeDBClusterSnapshotsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.docdb.model.DescribeDbClusterSnapshotsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.docdb.model.DescribeDbClusterSnapshotsResponse response) { //... }; });
Please notice that the configuration of MaxRecords won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
describeDBClusterSnapshots(software.amazon.awssdk.services.docdb.model.DescribeDbClusterSnapshotsRequest)
operation.
This is a convenience which creates an instance of the
DescribeDbClusterSnapshotsRequest.Builder
avoiding the need to create one manually viaDescribeDbClusterSnapshotsRequest.builder()
- Parameters:
describeDbClusterSnapshotsRequest
- AConsumer
that will call methods onDescribeDbClusterSnapshotsRequest.Builder
to create a request. Represents the input to DescribeDBClusterSnapshots.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DbClusterSnapshotNotFoundException
DBClusterSnapshotIdentifier
doesn't refer to an existing cluster snapshot. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- DbClusterSnapshotNotFoundException
- See Also:
-
describeDBClusters
default CompletableFuture<DescribeDbClustersResponse> describeDBClusters(DescribeDbClustersRequest describeDbClustersRequest) Returns information about provisioned Amazon DocumentDB clusters. This API operation supports pagination. For certain management features such as cluster and instance lifecycle management, Amazon DocumentDB leverages operational technology that is shared with Amazon RDS and Amazon Neptune. Use the
filterName=engine,Values=docdb
filter parameter to return only Amazon DocumentDB clusters.- Parameters:
describeDbClustersRequest
- Represents the input to DescribeDBClusters.- Returns:
- A Java Future containing the result of the DescribeDBClusters operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DbClusterNotFoundException
DBClusterIdentifier
doesn't refer to an existing cluster. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- DbClusterNotFoundException
- See Also:
-
describeDBClusters
default CompletableFuture<DescribeDbClustersResponse> describeDBClusters(Consumer<DescribeDbClustersRequest.Builder> describeDbClustersRequest) Returns information about provisioned Amazon DocumentDB clusters. This API operation supports pagination. For certain management features such as cluster and instance lifecycle management, Amazon DocumentDB leverages operational technology that is shared with Amazon RDS and Amazon Neptune. Use the
filterName=engine,Values=docdb
filter parameter to return only Amazon DocumentDB clusters.
This is a convenience which creates an instance of the
DescribeDbClustersRequest.Builder
avoiding the need to create one manually viaDescribeDbClustersRequest.builder()
- Parameters:
describeDbClustersRequest
- AConsumer
that will call methods onDescribeDbClustersRequest.Builder
to create a request. Represents the input to DescribeDBClusters.- Returns:
- A Java Future containing the result of the DescribeDBClusters operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DbClusterNotFoundException
DBClusterIdentifier
doesn't refer to an existing cluster. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- DbClusterNotFoundException
- See Also:
-
describeDBClusters
Returns information about provisioned Amazon DocumentDB clusters. This API operation supports pagination. For certain management features such as cluster and instance lifecycle management, Amazon DocumentDB leverages operational technology that is shared with Amazon RDS and Amazon Neptune. Use the
filterName=engine,Values=docdb
filter parameter to return only Amazon DocumentDB clusters.- Returns:
- A Java Future containing the result of the DescribeDBClusters operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DbClusterNotFoundException
DBClusterIdentifier
doesn't refer to an existing cluster. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- DbClusterNotFoundException
- See Also:
-
describeDBClustersPaginator
This is a variant of
describeDBClusters(software.amazon.awssdk.services.docdb.model.DescribeDbClustersRequest)
operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber)
. Each call to the subscribe method will result in a newSubscription
i.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper methodsoftware.amazon.awssdk.services.docdb.paginators.DescribeDBClustersPublisher publisher = client.describeDBClustersPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
software.amazon.awssdk.services.docdb.paginators.DescribeDBClustersPublisher publisher = client.describeDBClustersPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.docdb.model.DescribeDbClustersResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.docdb.model.DescribeDbClustersResponse response) { //... }; });
Please notice that the configuration of MaxRecords won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
describeDBClusters(software.amazon.awssdk.services.docdb.model.DescribeDbClustersRequest)
operation.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DbClusterNotFoundException
DBClusterIdentifier
doesn't refer to an existing cluster. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- DbClusterNotFoundException
- See Also:
-
describeDBClustersPaginator
default DescribeDBClustersPublisher describeDBClustersPaginator(DescribeDbClustersRequest describeDbClustersRequest) This is a variant of
describeDBClusters(software.amazon.awssdk.services.docdb.model.DescribeDbClustersRequest)
operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber)
. Each call to the subscribe method will result in a newSubscription
i.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper methodsoftware.amazon.awssdk.services.docdb.paginators.DescribeDBClustersPublisher publisher = client.describeDBClustersPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
software.amazon.awssdk.services.docdb.paginators.DescribeDBClustersPublisher publisher = client.describeDBClustersPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.docdb.model.DescribeDbClustersResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.docdb.model.DescribeDbClustersResponse response) { //... }; });
Please notice that the configuration of MaxRecords won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
describeDBClusters(software.amazon.awssdk.services.docdb.model.DescribeDbClustersRequest)
operation.- Parameters:
describeDbClustersRequest
- Represents the input to DescribeDBClusters.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DbClusterNotFoundException
DBClusterIdentifier
doesn't refer to an existing cluster. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- DbClusterNotFoundException
- See Also:
-
describeDBClustersPaginator
default DescribeDBClustersPublisher describeDBClustersPaginator(Consumer<DescribeDbClustersRequest.Builder> describeDbClustersRequest) This is a variant of
describeDBClusters(software.amazon.awssdk.services.docdb.model.DescribeDbClustersRequest)
operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber)
. Each call to the subscribe method will result in a newSubscription
i.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper methodsoftware.amazon.awssdk.services.docdb.paginators.DescribeDBClustersPublisher publisher = client.describeDBClustersPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
software.amazon.awssdk.services.docdb.paginators.DescribeDBClustersPublisher publisher = client.describeDBClustersPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.docdb.model.DescribeDbClustersResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.docdb.model.DescribeDbClustersResponse response) { //... }; });
Please notice that the configuration of MaxRecords won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
describeDBClusters(software.amazon.awssdk.services.docdb.model.DescribeDbClustersRequest)
operation.
This is a convenience which creates an instance of the
DescribeDbClustersRequest.Builder
avoiding the need to create one manually viaDescribeDbClustersRequest.builder()
- Parameters:
describeDbClustersRequest
- AConsumer
that will call methods onDescribeDbClustersRequest.Builder
to create a request. Represents the input to DescribeDBClusters.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DbClusterNotFoundException
DBClusterIdentifier
doesn't refer to an existing cluster. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- DbClusterNotFoundException
- See Also:
-
describeDBEngineVersions
default CompletableFuture<DescribeDbEngineVersionsResponse> describeDBEngineVersions(DescribeDbEngineVersionsRequest describeDbEngineVersionsRequest) Returns a list of the available engines.
- Parameters:
describeDbEngineVersionsRequest
- Represents the input to DescribeDBEngineVersions.- Returns:
- A Java Future containing the result of the DescribeDBEngineVersions operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
describeDBEngineVersions
default CompletableFuture<DescribeDbEngineVersionsResponse> describeDBEngineVersions(Consumer<DescribeDbEngineVersionsRequest.Builder> describeDbEngineVersionsRequest) Returns a list of the available engines.
This is a convenience which creates an instance of the
DescribeDbEngineVersionsRequest.Builder
avoiding the need to create one manually viaDescribeDbEngineVersionsRequest.builder()
- Parameters:
describeDbEngineVersionsRequest
- AConsumer
that will call methods onDescribeDbEngineVersionsRequest.Builder
to create a request. Represents the input to DescribeDBEngineVersions.- Returns:
- A Java Future containing the result of the DescribeDBEngineVersions operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
describeDBEngineVersions
Returns a list of the available engines.
- Returns:
- A Java Future containing the result of the DescribeDBEngineVersions operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
describeDBEngineVersionsPaginator
This is a variant of
describeDBEngineVersions(software.amazon.awssdk.services.docdb.model.DescribeDbEngineVersionsRequest)
operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber)
. Each call to the subscribe method will result in a newSubscription
i.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper methodsoftware.amazon.awssdk.services.docdb.paginators.DescribeDBEngineVersionsPublisher publisher = client.describeDBEngineVersionsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
software.amazon.awssdk.services.docdb.paginators.DescribeDBEngineVersionsPublisher publisher = client.describeDBEngineVersionsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.docdb.model.DescribeDbEngineVersionsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.docdb.model.DescribeDbEngineVersionsResponse response) { //... }; });
Please notice that the configuration of MaxRecords won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
describeDBEngineVersions(software.amazon.awssdk.services.docdb.model.DescribeDbEngineVersionsRequest)
operation.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
describeDBEngineVersionsPaginator
default DescribeDBEngineVersionsPublisher describeDBEngineVersionsPaginator(DescribeDbEngineVersionsRequest describeDbEngineVersionsRequest) This is a variant of
describeDBEngineVersions(software.amazon.awssdk.services.docdb.model.DescribeDbEngineVersionsRequest)
operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber)
. Each call to the subscribe method will result in a newSubscription
i.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper methodsoftware.amazon.awssdk.services.docdb.paginators.DescribeDBEngineVersionsPublisher publisher = client.describeDBEngineVersionsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
software.amazon.awssdk.services.docdb.paginators.DescribeDBEngineVersionsPublisher publisher = client.describeDBEngineVersionsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.docdb.model.DescribeDbEngineVersionsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.docdb.model.DescribeDbEngineVersionsResponse response) { //... }; });
Please notice that the configuration of MaxRecords won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
describeDBEngineVersions(software.amazon.awssdk.services.docdb.model.DescribeDbEngineVersionsRequest)
operation.- Parameters:
describeDbEngineVersionsRequest
- Represents the input to DescribeDBEngineVersions.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
describeDBEngineVersionsPaginator
default DescribeDBEngineVersionsPublisher describeDBEngineVersionsPaginator(Consumer<DescribeDbEngineVersionsRequest.Builder> describeDbEngineVersionsRequest) This is a variant of
describeDBEngineVersions(software.amazon.awssdk.services.docdb.model.DescribeDbEngineVersionsRequest)
operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber)
. Each call to the subscribe method will result in a newSubscription
i.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper methodsoftware.amazon.awssdk.services.docdb.paginators.DescribeDBEngineVersionsPublisher publisher = client.describeDBEngineVersionsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
software.amazon.awssdk.services.docdb.paginators.DescribeDBEngineVersionsPublisher publisher = client.describeDBEngineVersionsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.docdb.model.DescribeDbEngineVersionsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.docdb.model.DescribeDbEngineVersionsResponse response) { //... }; });
Please notice that the configuration of MaxRecords won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
describeDBEngineVersions(software.amazon.awssdk.services.docdb.model.DescribeDbEngineVersionsRequest)
operation.
This is a convenience which creates an instance of the
DescribeDbEngineVersionsRequest.Builder
avoiding the need to create one manually viaDescribeDbEngineVersionsRequest.builder()
- Parameters:
describeDbEngineVersionsRequest
- AConsumer
that will call methods onDescribeDbEngineVersionsRequest.Builder
to create a request. Represents the input to DescribeDBEngineVersions.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
describeDBInstances
default CompletableFuture<DescribeDbInstancesResponse> describeDBInstances(DescribeDbInstancesRequest describeDbInstancesRequest) Returns information about provisioned Amazon DocumentDB instances. This API supports pagination.
- Parameters:
describeDbInstancesRequest
- Represents the input to DescribeDBInstances.- Returns:
- A Java Future containing the result of the DescribeDBInstances operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DbInstanceNotFoundException
DBInstanceIdentifier
doesn't refer to an existing instance. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- DbInstanceNotFoundException
- See Also:
-
describeDBInstances
default CompletableFuture<DescribeDbInstancesResponse> describeDBInstances(Consumer<DescribeDbInstancesRequest.Builder> describeDbInstancesRequest) Returns information about provisioned Amazon DocumentDB instances. This API supports pagination.
This is a convenience which creates an instance of the
DescribeDbInstancesRequest.Builder
avoiding the need to create one manually viaDescribeDbInstancesRequest.builder()
- Parameters:
describeDbInstancesRequest
- AConsumer
that will call methods onDescribeDbInstancesRequest.Builder
to create a request. Represents the input to DescribeDBInstances.- Returns:
- A Java Future containing the result of the DescribeDBInstances operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DbInstanceNotFoundException
DBInstanceIdentifier
doesn't refer to an existing instance. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- DbInstanceNotFoundException
- See Also:
-
describeDBInstances
Returns information about provisioned Amazon DocumentDB instances. This API supports pagination.
- Returns:
- A Java Future containing the result of the DescribeDBInstances operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DbInstanceNotFoundException
DBInstanceIdentifier
doesn't refer to an existing instance. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- DbInstanceNotFoundException
- See Also:
-
describeDBInstancesPaginator
This is a variant of
describeDBInstances(software.amazon.awssdk.services.docdb.model.DescribeDbInstancesRequest)
operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber)
. Each call to the subscribe method will result in a newSubscription
i.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper methodsoftware.amazon.awssdk.services.docdb.paginators.DescribeDBInstancesPublisher publisher = client.describeDBInstancesPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
software.amazon.awssdk.services.docdb.paginators.DescribeDBInstancesPublisher publisher = client.describeDBInstancesPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.docdb.model.DescribeDbInstancesResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.docdb.model.DescribeDbInstancesResponse response) { //... }; });
Please notice that the configuration of MaxRecords won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
describeDBInstances(software.amazon.awssdk.services.docdb.model.DescribeDbInstancesRequest)
operation.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DbInstanceNotFoundException
DBInstanceIdentifier
doesn't refer to an existing instance. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- DbInstanceNotFoundException
- See Also:
-
describeDBInstancesPaginator
default DescribeDBInstancesPublisher describeDBInstancesPaginator(DescribeDbInstancesRequest describeDbInstancesRequest) This is a variant of
describeDBInstances(software.amazon.awssdk.services.docdb.model.DescribeDbInstancesRequest)
operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber)
. Each call to the subscribe method will result in a newSubscription
i.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper methodsoftware.amazon.awssdk.services.docdb.paginators.DescribeDBInstancesPublisher publisher = client.describeDBInstancesPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
software.amazon.awssdk.services.docdb.paginators.DescribeDBInstancesPublisher publisher = client.describeDBInstancesPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.docdb.model.DescribeDbInstancesResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.docdb.model.DescribeDbInstancesResponse response) { //... }; });
Please notice that the configuration of MaxRecords won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
describeDBInstances(software.amazon.awssdk.services.docdb.model.DescribeDbInstancesRequest)
operation.- Parameters:
describeDbInstancesRequest
- Represents the input to DescribeDBInstances.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DbInstanceNotFoundException
DBInstanceIdentifier
doesn't refer to an existing instance. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- DbInstanceNotFoundException
- See Also:
-
describeDBInstancesPaginator
default DescribeDBInstancesPublisher describeDBInstancesPaginator(Consumer<DescribeDbInstancesRequest.Builder> describeDbInstancesRequest) This is a variant of
describeDBInstances(software.amazon.awssdk.services.docdb.model.DescribeDbInstancesRequest)
operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber)
. Each call to the subscribe method will result in a newSubscription
i.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper methodsoftware.amazon.awssdk.services.docdb.paginators.DescribeDBInstancesPublisher publisher = client.describeDBInstancesPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
software.amazon.awssdk.services.docdb.paginators.DescribeDBInstancesPublisher publisher = client.describeDBInstancesPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.docdb.model.DescribeDbInstancesResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.docdb.model.DescribeDbInstancesResponse response) { //... }; });
Please notice that the configuration of MaxRecords won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
describeDBInstances(software.amazon.awssdk.services.docdb.model.DescribeDbInstancesRequest)
operation.
This is a convenience which creates an instance of the
DescribeDbInstancesRequest.Builder
avoiding the need to create one manually viaDescribeDbInstancesRequest.builder()
- Parameters:
describeDbInstancesRequest
- AConsumer
that will call methods onDescribeDbInstancesRequest.Builder
to create a request. Represents the input to DescribeDBInstances.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DbInstanceNotFoundException
DBInstanceIdentifier
doesn't refer to an existing instance. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- DbInstanceNotFoundException
- See Also:
-
describeDBSubnetGroups
default CompletableFuture<DescribeDbSubnetGroupsResponse> describeDBSubnetGroups(DescribeDbSubnetGroupsRequest describeDbSubnetGroupsRequest) Returns a list of
DBSubnetGroup
descriptions. If aDBSubnetGroupName
is specified, the list will contain only the descriptions of the specifiedDBSubnetGroup
.- Parameters:
describeDbSubnetGroupsRequest
- Represents the input to DescribeDBSubnetGroups.- Returns:
- A Java Future containing the result of the DescribeDBSubnetGroups operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DbSubnetGroupNotFoundException
DBSubnetGroupName
doesn't refer to an existing subnet group. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- DbSubnetGroupNotFoundException
- See Also:
-
describeDBSubnetGroups
default CompletableFuture<DescribeDbSubnetGroupsResponse> describeDBSubnetGroups(Consumer<DescribeDbSubnetGroupsRequest.Builder> describeDbSubnetGroupsRequest) Returns a list of
DBSubnetGroup
descriptions. If aDBSubnetGroupName
is specified, the list will contain only the descriptions of the specifiedDBSubnetGroup
.
This is a convenience which creates an instance of the
DescribeDbSubnetGroupsRequest.Builder
avoiding the need to create one manually viaDescribeDbSubnetGroupsRequest.builder()
- Parameters:
describeDbSubnetGroupsRequest
- AConsumer
that will call methods onDescribeDbSubnetGroupsRequest.Builder
to create a request. Represents the input to DescribeDBSubnetGroups.- Returns:
- A Java Future containing the result of the DescribeDBSubnetGroups operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DbSubnetGroupNotFoundException
DBSubnetGroupName
doesn't refer to an existing subnet group. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- DbSubnetGroupNotFoundException
- See Also:
-
describeDBSubnetGroups
Returns a list of
DBSubnetGroup
descriptions. If aDBSubnetGroupName
is specified, the list will contain only the descriptions of the specifiedDBSubnetGroup
.- Returns:
- A Java Future containing the result of the DescribeDBSubnetGroups operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DbSubnetGroupNotFoundException
DBSubnetGroupName
doesn't refer to an existing subnet group. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- DbSubnetGroupNotFoundException
- See Also:
-
describeDBSubnetGroupsPaginator
This is a variant of
describeDBSubnetGroups(software.amazon.awssdk.services.docdb.model.DescribeDbSubnetGroupsRequest)
operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber)
. Each call to the subscribe method will result in a newSubscription
i.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper methodsoftware.amazon.awssdk.services.docdb.paginators.DescribeDBSubnetGroupsPublisher publisher = client.describeDBSubnetGroupsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
software.amazon.awssdk.services.docdb.paginators.DescribeDBSubnetGroupsPublisher publisher = client.describeDBSubnetGroupsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.docdb.model.DescribeDbSubnetGroupsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.docdb.model.DescribeDbSubnetGroupsResponse response) { //... }; });
Please notice that the configuration of MaxRecords won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
describeDBSubnetGroups(software.amazon.awssdk.services.docdb.model.DescribeDbSubnetGroupsRequest)
operation.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DbSubnetGroupNotFoundException
DBSubnetGroupName
doesn't refer to an existing subnet group. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- DbSubnetGroupNotFoundException
- See Also:
-
describeDBSubnetGroupsPaginator
default DescribeDBSubnetGroupsPublisher describeDBSubnetGroupsPaginator(DescribeDbSubnetGroupsRequest describeDbSubnetGroupsRequest) This is a variant of
describeDBSubnetGroups(software.amazon.awssdk.services.docdb.model.DescribeDbSubnetGroupsRequest)
operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber)
. Each call to the subscribe method will result in a newSubscription
i.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper methodsoftware.amazon.awssdk.services.docdb.paginators.DescribeDBSubnetGroupsPublisher publisher = client.describeDBSubnetGroupsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
software.amazon.awssdk.services.docdb.paginators.DescribeDBSubnetGroupsPublisher publisher = client.describeDBSubnetGroupsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.docdb.model.DescribeDbSubnetGroupsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.docdb.model.DescribeDbSubnetGroupsResponse response) { //... }; });
Please notice that the configuration of MaxRecords won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
describeDBSubnetGroups(software.amazon.awssdk.services.docdb.model.DescribeDbSubnetGroupsRequest)
operation.- Parameters:
describeDbSubnetGroupsRequest
- Represents the input to DescribeDBSubnetGroups.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DbSubnetGroupNotFoundException
DBSubnetGroupName
doesn't refer to an existing subnet group. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- DbSubnetGroupNotFoundException
- See Also:
-
describeDBSubnetGroupsPaginator
default DescribeDBSubnetGroupsPublisher describeDBSubnetGroupsPaginator(Consumer<DescribeDbSubnetGroupsRequest.Builder> describeDbSubnetGroupsRequest) This is a variant of
describeDBSubnetGroups(software.amazon.awssdk.services.docdb.model.DescribeDbSubnetGroupsRequest)
operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber)
. Each call to the subscribe method will result in a newSubscription
i.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper methodsoftware.amazon.awssdk.services.docdb.paginators.DescribeDBSubnetGroupsPublisher publisher = client.describeDBSubnetGroupsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
software.amazon.awssdk.services.docdb.paginators.DescribeDBSubnetGroupsPublisher publisher = client.describeDBSubnetGroupsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.docdb.model.DescribeDbSubnetGroupsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.docdb.model.DescribeDbSubnetGroupsResponse response) { //... }; });
Please notice that the configuration of MaxRecords won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
describeDBSubnetGroups(software.amazon.awssdk.services.docdb.model.DescribeDbSubnetGroupsRequest)
operation.
This is a convenience which creates an instance of the
DescribeDbSubnetGroupsRequest.Builder
avoiding the need to create one manually viaDescribeDbSubnetGroupsRequest.builder()
- Parameters:
describeDbSubnetGroupsRequest
- AConsumer
that will call methods onDescribeDbSubnetGroupsRequest.Builder
to create a request. Represents the input to DescribeDBSubnetGroups.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DbSubnetGroupNotFoundException
DBSubnetGroupName
doesn't refer to an existing subnet group. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- DbSubnetGroupNotFoundException
- See Also:
-
describeEngineDefaultClusterParameters
default CompletableFuture<DescribeEngineDefaultClusterParametersResponse> describeEngineDefaultClusterParameters(DescribeEngineDefaultClusterParametersRequest describeEngineDefaultClusterParametersRequest) Returns the default engine and system parameter information for the cluster database engine.
- Parameters:
describeEngineDefaultClusterParametersRequest
- Represents the input to DescribeEngineDefaultClusterParameters.- Returns:
- A Java Future containing the result of the DescribeEngineDefaultClusterParameters operation returned by
the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
describeEngineDefaultClusterParameters
default CompletableFuture<DescribeEngineDefaultClusterParametersResponse> describeEngineDefaultClusterParameters(Consumer<DescribeEngineDefaultClusterParametersRequest.Builder> describeEngineDefaultClusterParametersRequest) Returns the default engine and system parameter information for the cluster database engine.
This is a convenience which creates an instance of the
DescribeEngineDefaultClusterParametersRequest.Builder
avoiding the need to create one manually viaDescribeEngineDefaultClusterParametersRequest.builder()
- Parameters:
describeEngineDefaultClusterParametersRequest
- AConsumer
that will call methods onDescribeEngineDefaultClusterParametersRequest.Builder
to create a request. Represents the input to DescribeEngineDefaultClusterParameters.- Returns:
- A Java Future containing the result of the DescribeEngineDefaultClusterParameters operation returned by
the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
describeEventCategories
default CompletableFuture<DescribeEventCategoriesResponse> describeEventCategories(DescribeEventCategoriesRequest describeEventCategoriesRequest) Displays a list of categories for all event source types, or, if specified, for a specified source type.
- Parameters:
describeEventCategoriesRequest
- Represents the input to DescribeEventCategories.- Returns:
- A Java Future containing the result of the DescribeEventCategories operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
describeEventCategories
default CompletableFuture<DescribeEventCategoriesResponse> describeEventCategories(Consumer<DescribeEventCategoriesRequest.Builder> describeEventCategoriesRequest) Displays a list of categories for all event source types, or, if specified, for a specified source type.
This is a convenience which creates an instance of the
DescribeEventCategoriesRequest.Builder
avoiding the need to create one manually viaDescribeEventCategoriesRequest.builder()
- Parameters:
describeEventCategoriesRequest
- AConsumer
that will call methods onDescribeEventCategoriesRequest.Builder
to create a request. Represents the input to DescribeEventCategories.- Returns:
- A Java Future containing the result of the DescribeEventCategories operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
describeEventCategories
Displays a list of categories for all event source types, or, if specified, for a specified source type.
- Returns:
- A Java Future containing the result of the DescribeEventCategories operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
describeEventSubscriptions
default CompletableFuture<DescribeEventSubscriptionsResponse> describeEventSubscriptions(DescribeEventSubscriptionsRequest describeEventSubscriptionsRequest) Lists all the subscription descriptions for a customer account. The description for a subscription includes
SubscriptionName
,SNSTopicARN
,CustomerID
,SourceType
,SourceID
,CreationTime
, andStatus
.If you specify a
SubscriptionName
, lists the description for that subscription.- Parameters:
describeEventSubscriptionsRequest
- Represents the input to DescribeEventSubscriptions.- Returns:
- A Java Future containing the result of the DescribeEventSubscriptions operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- SubscriptionNotFoundException The subscription name does not exist.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
describeEventSubscriptions
default CompletableFuture<DescribeEventSubscriptionsResponse> describeEventSubscriptions(Consumer<DescribeEventSubscriptionsRequest.Builder> describeEventSubscriptionsRequest) Lists all the subscription descriptions for a customer account. The description for a subscription includes
SubscriptionName
,SNSTopicARN
,CustomerID
,SourceType
,SourceID
,CreationTime
, andStatus
.If you specify a
SubscriptionName
, lists the description for that subscription.
This is a convenience which creates an instance of the
DescribeEventSubscriptionsRequest.Builder
avoiding the need to create one manually viaDescribeEventSubscriptionsRequest.builder()
- Parameters:
describeEventSubscriptionsRequest
- AConsumer
that will call methods onDescribeEventSubscriptionsRequest.Builder
to create a request. Represents the input to DescribeEventSubscriptions.- Returns:
- A Java Future containing the result of the DescribeEventSubscriptions operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- SubscriptionNotFoundException The subscription name does not exist.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
describeEventSubscriptionsPaginator
default DescribeEventSubscriptionsPublisher describeEventSubscriptionsPaginator(DescribeEventSubscriptionsRequest describeEventSubscriptionsRequest) This is a variant of
describeEventSubscriptions(software.amazon.awssdk.services.docdb.model.DescribeEventSubscriptionsRequest)
operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber)
. Each call to the subscribe method will result in a newSubscription
i.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper methodsoftware.amazon.awssdk.services.docdb.paginators.DescribeEventSubscriptionsPublisher publisher = client.describeEventSubscriptionsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
software.amazon.awssdk.services.docdb.paginators.DescribeEventSubscriptionsPublisher publisher = client.describeEventSubscriptionsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.docdb.model.DescribeEventSubscriptionsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.docdb.model.DescribeEventSubscriptionsResponse response) { //... }; });
Please notice that the configuration of MaxRecords won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
describeEventSubscriptions(software.amazon.awssdk.services.docdb.model.DescribeEventSubscriptionsRequest)
operation.- Parameters:
describeEventSubscriptionsRequest
- Represents the input to DescribeEventSubscriptions.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- SubscriptionNotFoundException The subscription name does not exist.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
describeEventSubscriptionsPaginator
default DescribeEventSubscriptionsPublisher describeEventSubscriptionsPaginator(Consumer<DescribeEventSubscriptionsRequest.Builder> describeEventSubscriptionsRequest) This is a variant of
describeEventSubscriptions(software.amazon.awssdk.services.docdb.model.DescribeEventSubscriptionsRequest)
operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber)
. Each call to the subscribe method will result in a newSubscription
i.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper methodsoftware.amazon.awssdk.services.docdb.paginators.DescribeEventSubscriptionsPublisher publisher = client.describeEventSubscriptionsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
software.amazon.awssdk.services.docdb.paginators.DescribeEventSubscriptionsPublisher publisher = client.describeEventSubscriptionsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.docdb.model.DescribeEventSubscriptionsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.docdb.model.DescribeEventSubscriptionsResponse response) { //... }; });
Please notice that the configuration of MaxRecords won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
describeEventSubscriptions(software.amazon.awssdk.services.docdb.model.DescribeEventSubscriptionsRequest)
operation.
This is a convenience which creates an instance of the
DescribeEventSubscriptionsRequest.Builder
avoiding the need to create one manually viaDescribeEventSubscriptionsRequest.builder()
- Parameters:
describeEventSubscriptionsRequest
- AConsumer
that will call methods onDescribeEventSubscriptionsRequest.Builder
to create a request. Represents the input to DescribeEventSubscriptions.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- SubscriptionNotFoundException The subscription name does not exist.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
describeEvents
default CompletableFuture<DescribeEventsResponse> describeEvents(DescribeEventsRequest describeEventsRequest) Returns events related to instances, security groups, snapshots, and DB parameter groups for the past 14 days. You can obtain events specific to a particular DB instance, security group, snapshot, or parameter group by providing the name as a parameter. By default, the events of the past hour are returned.
- Parameters:
describeEventsRequest
- Represents the input to DescribeEvents.- Returns:
- A Java Future containing the result of the DescribeEvents operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
describeEvents
default CompletableFuture<DescribeEventsResponse> describeEvents(Consumer<DescribeEventsRequest.Builder> describeEventsRequest) Returns events related to instances, security groups, snapshots, and DB parameter groups for the past 14 days. You can obtain events specific to a particular DB instance, security group, snapshot, or parameter group by providing the name as a parameter. By default, the events of the past hour are returned.
This is a convenience which creates an instance of the
DescribeEventsRequest.Builder
avoiding the need to create one manually viaDescribeEventsRequest.builder()
- Parameters:
describeEventsRequest
- AConsumer
that will call methods onDescribeEventsRequest.Builder
to create a request. Represents the input to DescribeEvents.- Returns:
- A Java Future containing the result of the DescribeEvents operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
describeEvents
Returns events related to instances, security groups, snapshots, and DB parameter groups for the past 14 days. You can obtain events specific to a particular DB instance, security group, snapshot, or parameter group by providing the name as a parameter. By default, the events of the past hour are returned.
- Returns:
- A Java Future containing the result of the DescribeEvents operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
describeEventsPaginator
This is a variant of
describeEvents(software.amazon.awssdk.services.docdb.model.DescribeEventsRequest)
operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber)
. Each call to the subscribe method will result in a newSubscription
i.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper methodsoftware.amazon.awssdk.services.docdb.paginators.DescribeEventsPublisher publisher = client.describeEventsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
software.amazon.awssdk.services.docdb.paginators.DescribeEventsPublisher publisher = client.describeEventsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.docdb.model.DescribeEventsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.docdb.model.DescribeEventsResponse response) { //... }; });
Please notice that the configuration of MaxRecords won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
describeEvents(software.amazon.awssdk.services.docdb.model.DescribeEventsRequest)
operation.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
describeEventsPaginator
default DescribeEventsPublisher describeEventsPaginator(DescribeEventsRequest describeEventsRequest) This is a variant of
describeEvents(software.amazon.awssdk.services.docdb.model.DescribeEventsRequest)
operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber)
. Each call to the subscribe method will result in a newSubscription
i.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper methodsoftware.amazon.awssdk.services.docdb.paginators.DescribeEventsPublisher publisher = client.describeEventsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
software.amazon.awssdk.services.docdb.paginators.DescribeEventsPublisher publisher = client.describeEventsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.docdb.model.DescribeEventsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.docdb.model.DescribeEventsResponse response) { //... }; });
Please notice that the configuration of MaxRecords won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
describeEvents(software.amazon.awssdk.services.docdb.model.DescribeEventsRequest)
operation.- Parameters:
describeEventsRequest
- Represents the input to DescribeEvents.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
describeEventsPaginator
default DescribeEventsPublisher describeEventsPaginator(Consumer<DescribeEventsRequest.Builder> describeEventsRequest) This is a variant of
describeEvents(software.amazon.awssdk.services.docdb.model.DescribeEventsRequest)
operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber)
. Each call to the subscribe method will result in a newSubscription
i.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper methodsoftware.amazon.awssdk.services.docdb.paginators.DescribeEventsPublisher publisher = client.describeEventsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
software.amazon.awssdk.services.docdb.paginators.DescribeEventsPublisher publisher = client.describeEventsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.docdb.model.DescribeEventsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.docdb.model.DescribeEventsResponse response) { //... }; });
Please notice that the configuration of MaxRecords won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
describeEvents(software.amazon.awssdk.services.docdb.model.DescribeEventsRequest)
operation.
This is a convenience which creates an instance of the
DescribeEventsRequest.Builder
avoiding the need to create one manually viaDescribeEventsRequest.builder()
- Parameters:
describeEventsRequest
- AConsumer
that will call methods onDescribeEventsRequest.Builder
to create a request. Represents the input to DescribeEvents.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
describeGlobalClusters
default CompletableFuture<DescribeGlobalClustersResponse> describeGlobalClusters(DescribeGlobalClustersRequest describeGlobalClustersRequest) Returns information about Amazon DocumentDB global clusters. This API supports pagination.
This action only applies to Amazon DocumentDB clusters.
- Parameters:
describeGlobalClustersRequest
-- Returns:
- A Java Future containing the result of the DescribeGlobalClusters operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- GlobalClusterNotFoundException The
GlobalClusterIdentifier
doesn't refer to an existing global cluster. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- GlobalClusterNotFoundException The
- See Also:
-
describeGlobalClusters
default CompletableFuture<DescribeGlobalClustersResponse> describeGlobalClusters(Consumer<DescribeGlobalClustersRequest.Builder> describeGlobalClustersRequest) Returns information about Amazon DocumentDB global clusters. This API supports pagination.
This action only applies to Amazon DocumentDB clusters.
This is a convenience which creates an instance of the
DescribeGlobalClustersRequest.Builder
avoiding the need to create one manually viaDescribeGlobalClustersRequest.builder()
- Parameters:
describeGlobalClustersRequest
- AConsumer
that will call methods onDescribeGlobalClustersRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the DescribeGlobalClusters operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- GlobalClusterNotFoundException The
GlobalClusterIdentifier
doesn't refer to an existing global cluster. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- GlobalClusterNotFoundException The
- See Also:
-
describeGlobalClustersPaginator
default DescribeGlobalClustersPublisher describeGlobalClustersPaginator(DescribeGlobalClustersRequest describeGlobalClustersRequest) This is a variant of
describeGlobalClusters(software.amazon.awssdk.services.docdb.model.DescribeGlobalClustersRequest)
operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber)
. Each call to the subscribe method will result in a newSubscription
i.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper methodsoftware.amazon.awssdk.services.docdb.paginators.DescribeGlobalClustersPublisher publisher = client.describeGlobalClustersPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
software.amazon.awssdk.services.docdb.paginators.DescribeGlobalClustersPublisher publisher = client.describeGlobalClustersPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.docdb.model.DescribeGlobalClustersResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.docdb.model.DescribeGlobalClustersResponse response) { //... }; });
Please notice that the configuration of MaxRecords won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
describeGlobalClusters(software.amazon.awssdk.services.docdb.model.DescribeGlobalClustersRequest)
operation.- Parameters:
describeGlobalClustersRequest
-- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- GlobalClusterNotFoundException The
GlobalClusterIdentifier
doesn't refer to an existing global cluster. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- GlobalClusterNotFoundException The
- See Also:
-
describeGlobalClustersPaginator
default DescribeGlobalClustersPublisher describeGlobalClustersPaginator(Consumer<DescribeGlobalClustersRequest.Builder> describeGlobalClustersRequest) This is a variant of
describeGlobalClusters(software.amazon.awssdk.services.docdb.model.DescribeGlobalClustersRequest)
operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber)
. Each call to the subscribe method will result in a newSubscription
i.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper methodsoftware.amazon.awssdk.services.docdb.paginators.DescribeGlobalClustersPublisher publisher = client.describeGlobalClustersPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
software.amazon.awssdk.services.docdb.paginators.DescribeGlobalClustersPublisher publisher = client.describeGlobalClustersPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.docdb.model.DescribeGlobalClustersResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.docdb.model.DescribeGlobalClustersResponse response) { //... }; });
Please notice that the configuration of MaxRecords won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
describeGlobalClusters(software.amazon.awssdk.services.docdb.model.DescribeGlobalClustersRequest)
operation.
This is a convenience which creates an instance of the
DescribeGlobalClustersRequest.Builder
avoiding the need to create one manually viaDescribeGlobalClustersRequest.builder()
- Parameters:
describeGlobalClustersRequest
- AConsumer
that will call methods onDescribeGlobalClustersRequest.Builder
to create a request.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- GlobalClusterNotFoundException The
GlobalClusterIdentifier
doesn't refer to an existing global cluster. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- GlobalClusterNotFoundException The
- See Also:
-
describeOrderableDBInstanceOptions
default CompletableFuture<DescribeOrderableDbInstanceOptionsResponse> describeOrderableDBInstanceOptions(DescribeOrderableDbInstanceOptionsRequest describeOrderableDbInstanceOptionsRequest) Returns a list of orderable instance options for the specified engine.
- Parameters:
describeOrderableDbInstanceOptionsRequest
- Represents the input to DescribeOrderableDBInstanceOptions.- Returns:
- A Java Future containing the result of the DescribeOrderableDBInstanceOptions operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
describeOrderableDBInstanceOptions
default CompletableFuture<DescribeOrderableDbInstanceOptionsResponse> describeOrderableDBInstanceOptions(Consumer<DescribeOrderableDbInstanceOptionsRequest.Builder> describeOrderableDbInstanceOptionsRequest) Returns a list of orderable instance options for the specified engine.
This is a convenience which creates an instance of the
DescribeOrderableDbInstanceOptionsRequest.Builder
avoiding the need to create one manually viaDescribeOrderableDbInstanceOptionsRequest.builder()
- Parameters:
describeOrderableDbInstanceOptionsRequest
- AConsumer
that will call methods onDescribeOrderableDbInstanceOptionsRequest.Builder
to create a request. Represents the input to DescribeOrderableDBInstanceOptions.- Returns:
- A Java Future containing the result of the DescribeOrderableDBInstanceOptions operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
describeOrderableDBInstanceOptionsPaginator
default DescribeOrderableDBInstanceOptionsPublisher describeOrderableDBInstanceOptionsPaginator(DescribeOrderableDbInstanceOptionsRequest describeOrderableDbInstanceOptionsRequest) This is a variant of
describeOrderableDBInstanceOptions(software.amazon.awssdk.services.docdb.model.DescribeOrderableDbInstanceOptionsRequest)
operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber)
. Each call to the subscribe method will result in a newSubscription
i.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper methodsoftware.amazon.awssdk.services.docdb.paginators.DescribeOrderableDBInstanceOptionsPublisher publisher = client.describeOrderableDBInstanceOptionsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
software.amazon.awssdk.services.docdb.paginators.DescribeOrderableDBInstanceOptionsPublisher publisher = client.describeOrderableDBInstanceOptionsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.docdb.model.DescribeOrderableDbInstanceOptionsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.docdb.model.DescribeOrderableDbInstanceOptionsResponse response) { //... }; });
Please notice that the configuration of MaxRecords won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
describeOrderableDBInstanceOptions(software.amazon.awssdk.services.docdb.model.DescribeOrderableDbInstanceOptionsRequest)
operation.- Parameters:
describeOrderableDbInstanceOptionsRequest
- Represents the input to DescribeOrderableDBInstanceOptions.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
describeOrderableDBInstanceOptionsPaginator
default DescribeOrderableDBInstanceOptionsPublisher describeOrderableDBInstanceOptionsPaginator(Consumer<DescribeOrderableDbInstanceOptionsRequest.Builder> describeOrderableDbInstanceOptionsRequest) This is a variant of
describeOrderableDBInstanceOptions(software.amazon.awssdk.services.docdb.model.DescribeOrderableDbInstanceOptionsRequest)
operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber)
. Each call to the subscribe method will result in a newSubscription
i.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper methodsoftware.amazon.awssdk.services.docdb.paginators.DescribeOrderableDBInstanceOptionsPublisher publisher = client.describeOrderableDBInstanceOptionsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
software.amazon.awssdk.services.docdb.paginators.DescribeOrderableDBInstanceOptionsPublisher publisher = client.describeOrderableDBInstanceOptionsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.docdb.model.DescribeOrderableDbInstanceOptionsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.docdb.model.DescribeOrderableDbInstanceOptionsResponse response) { //... }; });
Please notice that the configuration of MaxRecords won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
describeOrderableDBInstanceOptions(software.amazon.awssdk.services.docdb.model.DescribeOrderableDbInstanceOptionsRequest)
operation.
This is a convenience which creates an instance of the
DescribeOrderableDbInstanceOptionsRequest.Builder
avoiding the need to create one manually viaDescribeOrderableDbInstanceOptionsRequest.builder()
- Parameters:
describeOrderableDbInstanceOptionsRequest
- AConsumer
that will call methods onDescribeOrderableDbInstanceOptionsRequest.Builder
to create a request. Represents the input to DescribeOrderableDBInstanceOptions.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
describePendingMaintenanceActions
default CompletableFuture<DescribePendingMaintenanceActionsResponse> describePendingMaintenanceActions(DescribePendingMaintenanceActionsRequest describePendingMaintenanceActionsRequest) Returns a list of resources (for example, instances) that have at least one pending maintenance action.
- Parameters:
describePendingMaintenanceActionsRequest
- Represents the input to DescribePendingMaintenanceActions.- Returns:
- A Java Future containing the result of the DescribePendingMaintenanceActions operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- ResourceNotFoundException The specified resource ID was not found.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
describePendingMaintenanceActions
default CompletableFuture<DescribePendingMaintenanceActionsResponse> describePendingMaintenanceActions(Consumer<DescribePendingMaintenanceActionsRequest.Builder> describePendingMaintenanceActionsRequest) Returns a list of resources (for example, instances) that have at least one pending maintenance action.
This is a convenience which creates an instance of the
DescribePendingMaintenanceActionsRequest.Builder
avoiding the need to create one manually viaDescribePendingMaintenanceActionsRequest.builder()
- Parameters:
describePendingMaintenanceActionsRequest
- AConsumer
that will call methods onDescribePendingMaintenanceActionsRequest.Builder
to create a request. Represents the input to DescribePendingMaintenanceActions.- Returns:
- A Java Future containing the result of the DescribePendingMaintenanceActions operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- ResourceNotFoundException The specified resource ID was not found.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
describePendingMaintenanceActions
default CompletableFuture<DescribePendingMaintenanceActionsResponse> describePendingMaintenanceActions()Returns a list of resources (for example, instances) that have at least one pending maintenance action.
- Returns:
- A Java Future containing the result of the DescribePendingMaintenanceActions operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- ResourceNotFoundException The specified resource ID was not found.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
describePendingMaintenanceActionsPaginator
This is a variant of
describePendingMaintenanceActions(software.amazon.awssdk.services.docdb.model.DescribePendingMaintenanceActionsRequest)
operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber)
. Each call to the subscribe method will result in a newSubscription
i.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper methodsoftware.amazon.awssdk.services.docdb.paginators.DescribePendingMaintenanceActionsPublisher publisher = client.describePendingMaintenanceActionsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
software.amazon.awssdk.services.docdb.paginators.DescribePendingMaintenanceActionsPublisher publisher = client.describePendingMaintenanceActionsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.docdb.model.DescribePendingMaintenanceActionsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.docdb.model.DescribePendingMaintenanceActionsResponse response) { //... }; });
Please notice that the configuration of MaxRecords won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
describePendingMaintenanceActions(software.amazon.awssdk.services.docdb.model.DescribePendingMaintenanceActionsRequest)
operation.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- ResourceNotFoundException The specified resource ID was not found.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
describePendingMaintenanceActionsPaginator
default DescribePendingMaintenanceActionsPublisher describePendingMaintenanceActionsPaginator(DescribePendingMaintenanceActionsRequest describePendingMaintenanceActionsRequest) This is a variant of
describePendingMaintenanceActions(software.amazon.awssdk.services.docdb.model.DescribePendingMaintenanceActionsRequest)
operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber)
. Each call to the subscribe method will result in a newSubscription
i.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper methodsoftware.amazon.awssdk.services.docdb.paginators.DescribePendingMaintenanceActionsPublisher publisher = client.describePendingMaintenanceActionsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
software.amazon.awssdk.services.docdb.paginators.DescribePendingMaintenanceActionsPublisher publisher = client.describePendingMaintenanceActionsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.docdb.model.DescribePendingMaintenanceActionsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.docdb.model.DescribePendingMaintenanceActionsResponse response) { //... }; });
Please notice that the configuration of MaxRecords won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
describePendingMaintenanceActions(software.amazon.awssdk.services.docdb.model.DescribePendingMaintenanceActionsRequest)
operation.- Parameters:
describePendingMaintenanceActionsRequest
- Represents the input to DescribePendingMaintenanceActions.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- ResourceNotFoundException The specified resource ID was not found.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
describePendingMaintenanceActionsPaginator
default DescribePendingMaintenanceActionsPublisher describePendingMaintenanceActionsPaginator(Consumer<DescribePendingMaintenanceActionsRequest.Builder> describePendingMaintenanceActionsRequest) This is a variant of
describePendingMaintenanceActions(software.amazon.awssdk.services.docdb.model.DescribePendingMaintenanceActionsRequest)
operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber)
. Each call to the subscribe method will result in a newSubscription
i.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper methodsoftware.amazon.awssdk.services.docdb.paginators.DescribePendingMaintenanceActionsPublisher publisher = client.describePendingMaintenanceActionsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
software.amazon.awssdk.services.docdb.paginators.DescribePendingMaintenanceActionsPublisher publisher = client.describePendingMaintenanceActionsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.docdb.model.DescribePendingMaintenanceActionsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.docdb.model.DescribePendingMaintenanceActionsResponse response) { //... }; });
Please notice that the configuration of MaxRecords won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
describePendingMaintenanceActions(software.amazon.awssdk.services.docdb.model.DescribePendingMaintenanceActionsRequest)
operation.
This is a convenience which creates an instance of the
DescribePendingMaintenanceActionsRequest.Builder
avoiding the need to create one manually viaDescribePendingMaintenanceActionsRequest.builder()
- Parameters:
describePendingMaintenanceActionsRequest
- AConsumer
that will call methods onDescribePendingMaintenanceActionsRequest.Builder
to create a request. Represents the input to DescribePendingMaintenanceActions.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- ResourceNotFoundException The specified resource ID was not found.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
failoverDBCluster
default CompletableFuture<FailoverDbClusterResponse> failoverDBCluster(FailoverDbClusterRequest failoverDbClusterRequest) Forces a failover for a cluster.
A failover for a cluster promotes one of the Amazon DocumentDB replicas (read-only instances) in the cluster to be the primary instance (the cluster writer).
If the primary instance fails, Amazon DocumentDB automatically fails over to an Amazon DocumentDB replica, if one exists. You can force a failover when you want to simulate a failure of a primary instance for testing.
- Parameters:
failoverDbClusterRequest
- Represents the input to FailoverDBCluster.- Returns:
- A Java Future containing the result of the FailoverDBCluster operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DbClusterNotFoundException
DBClusterIdentifier
doesn't refer to an existing cluster. - InvalidDbClusterStateException The cluster isn't in a valid state.
- InvalidDbInstanceStateException The specified instance isn't in the available state.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- DbClusterNotFoundException
- See Also:
-
failoverDBCluster
default CompletableFuture<FailoverDbClusterResponse> failoverDBCluster(Consumer<FailoverDbClusterRequest.Builder> failoverDbClusterRequest) Forces a failover for a cluster.
A failover for a cluster promotes one of the Amazon DocumentDB replicas (read-only instances) in the cluster to be the primary instance (the cluster writer).
If the primary instance fails, Amazon DocumentDB automatically fails over to an Amazon DocumentDB replica, if one exists. You can force a failover when you want to simulate a failure of a primary instance for testing.
This is a convenience which creates an instance of the
FailoverDbClusterRequest.Builder
avoiding the need to create one manually viaFailoverDbClusterRequest.builder()
- Parameters:
failoverDbClusterRequest
- AConsumer
that will call methods onFailoverDbClusterRequest.Builder
to create a request. Represents the input to FailoverDBCluster.- Returns:
- A Java Future containing the result of the FailoverDBCluster operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DbClusterNotFoundException
DBClusterIdentifier
doesn't refer to an existing cluster. - InvalidDbClusterStateException The cluster isn't in a valid state.
- InvalidDbInstanceStateException The specified instance isn't in the available state.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- DbClusterNotFoundException
- See Also:
-
listTagsForResource
default CompletableFuture<ListTagsForResourceResponse> listTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest) Lists all tags on an Amazon DocumentDB resource.
- Parameters:
listTagsForResourceRequest
- Represents the input to ListTagsForResource.- Returns:
- A Java Future containing the result of the ListTagsForResource operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DbInstanceNotFoundException
DBInstanceIdentifier
doesn't refer to an existing instance. - DbSnapshotNotFoundException
DBSnapshotIdentifier
doesn't refer to an existing snapshot. - DbClusterNotFoundException
DBClusterIdentifier
doesn't refer to an existing cluster. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- DbInstanceNotFoundException
- See Also:
-
listTagsForResource
default CompletableFuture<ListTagsForResourceResponse> listTagsForResource(Consumer<ListTagsForResourceRequest.Builder> listTagsForResourceRequest) Lists all tags on an Amazon DocumentDB resource.
This is a convenience which creates an instance of the
ListTagsForResourceRequest.Builder
avoiding the need to create one manually viaListTagsForResourceRequest.builder()
- Parameters:
listTagsForResourceRequest
- AConsumer
that will call methods onListTagsForResourceRequest.Builder
to create a request. Represents the input to ListTagsForResource.- Returns:
- A Java Future containing the result of the ListTagsForResource operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DbInstanceNotFoundException
DBInstanceIdentifier
doesn't refer to an existing instance. - DbSnapshotNotFoundException
DBSnapshotIdentifier
doesn't refer to an existing snapshot. - DbClusterNotFoundException
DBClusterIdentifier
doesn't refer to an existing cluster. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- DbInstanceNotFoundException
- See Also:
-
modifyDBCluster
default CompletableFuture<ModifyDbClusterResponse> modifyDBCluster(ModifyDbClusterRequest modifyDbClusterRequest) Modifies a setting for an Amazon DocumentDB cluster. You can change one or more database configuration parameters by specifying these parameters and the new values in the request.
- Parameters:
modifyDbClusterRequest
- Represents the input to ModifyDBCluster.- Returns:
- A Java Future containing the result of the ModifyDBCluster operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DbClusterNotFoundException
DBClusterIdentifier
doesn't refer to an existing cluster. - InvalidDbClusterStateException The cluster isn't in a valid state.
- StorageQuotaExceededException The request would cause you to exceed the allowed amount of storage available across all instances.
- DbSubnetGroupNotFoundException
DBSubnetGroupName
doesn't refer to an existing subnet group. - InvalidVpcNetworkStateException The subnet group doesn't cover all Availability Zones after it is created because of changes that were made.
- InvalidDbSubnetGroupStateException The subnet group can't be deleted because it's in use.
- InvalidSubnetException The requested subnet is not valid, or multiple subnets were requested that are not all in a common virtual private cloud (VPC).
- DbClusterParameterGroupNotFoundException
DBClusterParameterGroupName
doesn't refer to an existing cluster parameter group. - InvalidDbSecurityGroupStateException The state of the security group doesn't allow deletion.
- InvalidDbInstanceStateException The specified instance isn't in the available state.
- DbClusterAlreadyExistsException You already have a cluster with the given identifier.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- DbClusterNotFoundException
- See Also:
-
modifyDBCluster
default CompletableFuture<ModifyDbClusterResponse> modifyDBCluster(Consumer<ModifyDbClusterRequest.Builder> modifyDbClusterRequest) Modifies a setting for an Amazon DocumentDB cluster. You can change one or more database configuration parameters by specifying these parameters and the new values in the request.
This is a convenience which creates an instance of the
ModifyDbClusterRequest.Builder
avoiding the need to create one manually viaModifyDbClusterRequest.builder()
- Parameters:
modifyDbClusterRequest
- AConsumer
that will call methods onModifyDbClusterRequest.Builder
to create a request. Represents the input to ModifyDBCluster.- Returns:
- A Java Future containing the result of the ModifyDBCluster operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DbClusterNotFoundException
DBClusterIdentifier
doesn't refer to an existing cluster. - InvalidDbClusterStateException The cluster isn't in a valid state.
- StorageQuotaExceededException The request would cause you to exceed the allowed amount of storage available across all instances.
- DbSubnetGroupNotFoundException
DBSubnetGroupName
doesn't refer to an existing subnet group. - InvalidVpcNetworkStateException The subnet group doesn't cover all Availability Zones after it is created because of changes that were made.
- InvalidDbSubnetGroupStateException The subnet group can't be deleted because it's in use.
- InvalidSubnetException The requested subnet is not valid, or multiple subnets were requested that are not all in a common virtual private cloud (VPC).
- DbClusterParameterGroupNotFoundException
DBClusterParameterGroupName
doesn't refer to an existing cluster parameter group. - InvalidDbSecurityGroupStateException The state of the security group doesn't allow deletion.
- InvalidDbInstanceStateException The specified instance isn't in the available state.
- DbClusterAlreadyExistsException You already have a cluster with the given identifier.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- DbClusterNotFoundException
- See Also:
-
modifyDBClusterParameterGroup
default CompletableFuture<ModifyDbClusterParameterGroupResponse> modifyDBClusterParameterGroup(ModifyDbClusterParameterGroupRequest modifyDbClusterParameterGroupRequest) Modifies the parameters of a cluster parameter group. To modify more than one parameter, submit a list of the following:
ParameterName
,ParameterValue
, andApplyMethod
. A maximum of 20 parameters can be modified in a single request.Changes to dynamic parameters are applied immediately. Changes to static parameters require a reboot or maintenance window before the change can take effect.
After you create a cluster parameter group, you should wait at least 5 minutes before creating your first cluster that uses that cluster parameter group as the default parameter group. This allows Amazon DocumentDB to fully complete the create action before the parameter group is used as the default for a new cluster. This step is especially important for parameters that are critical when creating the default database for a cluster, such as the character set for the default database defined by the
character_set_database
parameter.- Parameters:
modifyDbClusterParameterGroupRequest
- Represents the input to ModifyDBClusterParameterGroup.- Returns:
- A Java Future containing the result of the ModifyDBClusterParameterGroup operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DbParameterGroupNotFoundException
DBParameterGroupName
doesn't refer to an existing parameter group. - InvalidDbParameterGroupStateException The parameter group is in use, or it is in a state that is not valid. If you are trying to delete the parameter group, you can't delete it when the parameter group is in this state.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- DbParameterGroupNotFoundException
- See Also:
-
modifyDBClusterParameterGroup
default CompletableFuture<ModifyDbClusterParameterGroupResponse> modifyDBClusterParameterGroup(Consumer<ModifyDbClusterParameterGroupRequest.Builder> modifyDbClusterParameterGroupRequest) Modifies the parameters of a cluster parameter group. To modify more than one parameter, submit a list of the following:
ParameterName
,ParameterValue
, andApplyMethod
. A maximum of 20 parameters can be modified in a single request.Changes to dynamic parameters are applied immediately. Changes to static parameters require a reboot or maintenance window before the change can take effect.
After you create a cluster parameter group, you should wait at least 5 minutes before creating your first cluster that uses that cluster parameter group as the default parameter group. This allows Amazon DocumentDB to fully complete the create action before the parameter group is used as the default for a new cluster. This step is especially important for parameters that are critical when creating the default database for a cluster, such as the character set for the default database defined by the
character_set_database
parameter.
This is a convenience which creates an instance of the
ModifyDbClusterParameterGroupRequest.Builder
avoiding the need to create one manually viaModifyDbClusterParameterGroupRequest.builder()
- Parameters:
modifyDbClusterParameterGroupRequest
- AConsumer
that will call methods onModifyDbClusterParameterGroupRequest.Builder
to create a request. Represents the input to ModifyDBClusterParameterGroup.- Returns:
- A Java Future containing the result of the ModifyDBClusterParameterGroup operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DbParameterGroupNotFoundException
DBParameterGroupName
doesn't refer to an existing parameter group. - InvalidDbParameterGroupStateException The parameter group is in use, or it is in a state that is not valid. If you are trying to delete the parameter group, you can't delete it when the parameter group is in this state.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- DbParameterGroupNotFoundException
- See Also:
-
modifyDBClusterSnapshotAttribute
default CompletableFuture<ModifyDbClusterSnapshotAttributeResponse> modifyDBClusterSnapshotAttribute(ModifyDbClusterSnapshotAttributeRequest modifyDbClusterSnapshotAttributeRequest) Adds an attribute and values to, or removes an attribute and values from, a manual cluster snapshot.
To share a manual cluster snapshot with other Amazon Web Services accounts, specify
restore
as theAttributeName
, and use theValuesToAdd
parameter to add a list of IDs of the Amazon Web Services accounts that are authorized to restore the manual cluster snapshot. Use the valueall
to make the manual cluster snapshot public, which means that it can be copied or restored by all Amazon Web Services accounts. Do not add theall
value for any manual cluster snapshots that contain private information that you don't want available to all Amazon Web Services accounts. If a manual cluster snapshot is encrypted, it can be shared, but only by specifying a list of authorized Amazon Web Services account IDs for theValuesToAdd
parameter. You can't useall
as a value for that parameter in this case.- Parameters:
modifyDbClusterSnapshotAttributeRequest
- Represents the input to ModifyDBClusterSnapshotAttribute.- Returns:
- A Java Future containing the result of the ModifyDBClusterSnapshotAttribute operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DbClusterSnapshotNotFoundException
DBClusterSnapshotIdentifier
doesn't refer to an existing cluster snapshot. - InvalidDbClusterSnapshotStateException The provided value isn't a valid cluster snapshot state.
- SharedSnapshotQuotaExceededException You have exceeded the maximum number of accounts that you can share a manual DB snapshot with.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- DbClusterSnapshotNotFoundException
- See Also:
-
modifyDBClusterSnapshotAttribute
default CompletableFuture<ModifyDbClusterSnapshotAttributeResponse> modifyDBClusterSnapshotAttribute(Consumer<ModifyDbClusterSnapshotAttributeRequest.Builder> modifyDbClusterSnapshotAttributeRequest) Adds an attribute and values to, or removes an attribute and values from, a manual cluster snapshot.
To share a manual cluster snapshot with other Amazon Web Services accounts, specify
restore
as theAttributeName
, and use theValuesToAdd
parameter to add a list of IDs of the Amazon Web Services accounts that are authorized to restore the manual cluster snapshot. Use the valueall
to make the manual cluster snapshot public, which means that it can be copied or restored by all Amazon Web Services accounts. Do not add theall
value for any manual cluster snapshots that contain private information that you don't want available to all Amazon Web Services accounts. If a manual cluster snapshot is encrypted, it can be shared, but only by specifying a list of authorized Amazon Web Services account IDs for theValuesToAdd
parameter. You can't useall
as a value for that parameter in this case.
This is a convenience which creates an instance of the
ModifyDbClusterSnapshotAttributeRequest.Builder
avoiding the need to create one manually viaModifyDbClusterSnapshotAttributeRequest.builder()
- Parameters:
modifyDbClusterSnapshotAttributeRequest
- AConsumer
that will call methods onModifyDbClusterSnapshotAttributeRequest.Builder
to create a request. Represents the input to ModifyDBClusterSnapshotAttribute.- Returns:
- A Java Future containing the result of the ModifyDBClusterSnapshotAttribute operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DbClusterSnapshotNotFoundException
DBClusterSnapshotIdentifier
doesn't refer to an existing cluster snapshot. - InvalidDbClusterSnapshotStateException The provided value isn't a valid cluster snapshot state.
- SharedSnapshotQuotaExceededException You have exceeded the maximum number of accounts that you can share a manual DB snapshot with.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- DbClusterSnapshotNotFoundException
- See Also:
-
modifyDBInstance
default CompletableFuture<ModifyDbInstanceResponse> modifyDBInstance(ModifyDbInstanceRequest modifyDbInstanceRequest) Modifies settings for an instance. You can change one or more database configuration parameters by specifying these parameters and the new values in the request.
- Parameters:
modifyDbInstanceRequest
- Represents the input to ModifyDBInstance.- Returns:
- A Java Future containing the result of the ModifyDBInstance operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidDbInstanceStateException The specified instance isn't in the available state.
- InvalidDbSecurityGroupStateException The state of the security group doesn't allow deletion.
- DbInstanceAlreadyExistsException You already have a instance with the given identifier.
- DbInstanceNotFoundException
DBInstanceIdentifier
doesn't refer to an existing instance. - DbSecurityGroupNotFoundException
DBSecurityGroupName
doesn't refer to an existing security group. - DbParameterGroupNotFoundException
DBParameterGroupName
doesn't refer to an existing parameter group. - InsufficientDbInstanceCapacityException The specified instance class isn't available in the specified Availability Zone.
- StorageQuotaExceededException The request would cause you to exceed the allowed amount of storage available across all instances.
- InvalidVpcNetworkStateException The subnet group doesn't cover all Availability Zones after it is created because of changes that were made.
- DbUpgradeDependencyFailureException The upgrade failed because a resource that the depends on can't be modified.
- StorageTypeNotSupportedException Storage of the specified
StorageType
can't be associated with the DB instance. - AuthorizationNotFoundException The specified CIDR IP or Amazon EC2 security group isn't authorized
for the specified security group.
Amazon DocumentDB also might not be authorized to perform necessary actions on your behalf using IAM.
- CertificateNotFoundException
CertificateIdentifier
doesn't refer to an existing certificate. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
modifyDBInstance
default CompletableFuture<ModifyDbInstanceResponse> modifyDBInstance(Consumer<ModifyDbInstanceRequest.Builder> modifyDbInstanceRequest) Modifies settings for an instance. You can change one or more database configuration parameters by specifying these parameters and the new values in the request.
This is a convenience which creates an instance of the
ModifyDbInstanceRequest.Builder
avoiding the need to create one manually viaModifyDbInstanceRequest.builder()
- Parameters:
modifyDbInstanceRequest
- AConsumer
that will call methods onModifyDbInstanceRequest.Builder
to create a request. Represents the input to ModifyDBInstance.- Returns:
- A Java Future containing the result of the ModifyDBInstance operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidDbInstanceStateException The specified instance isn't in the available state.
- InvalidDbSecurityGroupStateException The state of the security group doesn't allow deletion.
- DbInstanceAlreadyExistsException You already have a instance with the given identifier.
- DbInstanceNotFoundException
DBInstanceIdentifier
doesn't refer to an existing instance. - DbSecurityGroupNotFoundException
DBSecurityGroupName
doesn't refer to an existing security group. - DbParameterGroupNotFoundException
DBParameterGroupName
doesn't refer to an existing parameter group. - InsufficientDbInstanceCapacityException The specified instance class isn't available in the specified Availability Zone.
- StorageQuotaExceededException The request would cause you to exceed the allowed amount of storage available across all instances.
- InvalidVpcNetworkStateException The subnet group doesn't cover all Availability Zones after it is created because of changes that were made.
- DbUpgradeDependencyFailureException The upgrade failed because a resource that the depends on can't be modified.
- StorageTypeNotSupportedException Storage of the specified
StorageType
can't be associated with the DB instance. - AuthorizationNotFoundException The specified CIDR IP or Amazon EC2 security group isn't authorized
for the specified security group.
Amazon DocumentDB also might not be authorized to perform necessary actions on your behalf using IAM.
- CertificateNotFoundException
CertificateIdentifier
doesn't refer to an existing certificate. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
modifyDBSubnetGroup
default CompletableFuture<ModifyDbSubnetGroupResponse> modifyDBSubnetGroup(ModifyDbSubnetGroupRequest modifyDbSubnetGroupRequest) Modifies an existing subnet group. subnet groups must contain at least one subnet in at least two Availability Zones in the Amazon Web Services Region.
- Parameters:
modifyDbSubnetGroupRequest
- Represents the input to ModifyDBSubnetGroup.- Returns:
- A Java Future containing the result of the ModifyDBSubnetGroup operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DbSubnetGroupNotFoundException
DBSubnetGroupName
doesn't refer to an existing subnet group. - DbSubnetQuotaExceededException The request would cause you to exceed the allowed number of subnets in a subnet group.
- SubnetAlreadyInUseException The subnet is already in use in the Availability Zone.
- DbSubnetGroupDoesNotCoverEnoughAZsException Subnets in the subnet group should cover at least two Availability Zones unless there is only one Availability Zone.
- InvalidSubnetException The requested subnet is not valid, or multiple subnets were requested that are not all in a common virtual private cloud (VPC).
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- DbSubnetGroupNotFoundException
- See Also:
-
modifyDBSubnetGroup
default CompletableFuture<ModifyDbSubnetGroupResponse> modifyDBSubnetGroup(Consumer<ModifyDbSubnetGroupRequest.Builder> modifyDbSubnetGroupRequest) Modifies an existing subnet group. subnet groups must contain at least one subnet in at least two Availability Zones in the Amazon Web Services Region.
This is a convenience which creates an instance of the
ModifyDbSubnetGroupRequest.Builder
avoiding the need to create one manually viaModifyDbSubnetGroupRequest.builder()
- Parameters:
modifyDbSubnetGroupRequest
- AConsumer
that will call methods onModifyDbSubnetGroupRequest.Builder
to create a request. Represents the input to ModifyDBSubnetGroup.- Returns:
- A Java Future containing the result of the ModifyDBSubnetGroup operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DbSubnetGroupNotFoundException
DBSubnetGroupName
doesn't refer to an existing subnet group. - DbSubnetQuotaExceededException The request would cause you to exceed the allowed number of subnets in a subnet group.
- SubnetAlreadyInUseException The subnet is already in use in the Availability Zone.
- DbSubnetGroupDoesNotCoverEnoughAZsException Subnets in the subnet group should cover at least two Availability Zones unless there is only one Availability Zone.
- InvalidSubnetException The requested subnet is not valid, or multiple subnets were requested that are not all in a common virtual private cloud (VPC).
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- DbSubnetGroupNotFoundException
- See Also:
-
modifyEventSubscription
default CompletableFuture<ModifyEventSubscriptionResponse> modifyEventSubscription(ModifyEventSubscriptionRequest modifyEventSubscriptionRequest) Modifies an existing Amazon DocumentDB event notification subscription.
- Parameters:
modifyEventSubscriptionRequest
- Represents the input to ModifyEventSubscription.- Returns:
- A Java Future containing the result of the ModifyEventSubscription operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- EventSubscriptionQuotaExceededException You have reached the maximum number of event subscriptions.
- SubscriptionNotFoundException The subscription name does not exist.
- SnsInvalidTopicException Amazon SNS has responded that there is a problem with the specified topic.
- SnsNoAuthorizationException You do not have permission to publish to the SNS topic Amazon Resource Name (ARN).
- SnsTopicArnNotFoundException The SNS topic Amazon Resource Name (ARN) does not exist.
- SubscriptionCategoryNotFoundException The provided category does not exist.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
modifyEventSubscription
default CompletableFuture<ModifyEventSubscriptionResponse> modifyEventSubscription(Consumer<ModifyEventSubscriptionRequest.Builder> modifyEventSubscriptionRequest) Modifies an existing Amazon DocumentDB event notification subscription.
This is a convenience which creates an instance of the
ModifyEventSubscriptionRequest.Builder
avoiding the need to create one manually viaModifyEventSubscriptionRequest.builder()
- Parameters:
modifyEventSubscriptionRequest
- AConsumer
that will call methods onModifyEventSubscriptionRequest.Builder
to create a request. Represents the input to ModifyEventSubscription.- Returns:
- A Java Future containing the result of the ModifyEventSubscription operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- EventSubscriptionQuotaExceededException You have reached the maximum number of event subscriptions.
- SubscriptionNotFoundException The subscription name does not exist.
- SnsInvalidTopicException Amazon SNS has responded that there is a problem with the specified topic.
- SnsNoAuthorizationException You do not have permission to publish to the SNS topic Amazon Resource Name (ARN).
- SnsTopicArnNotFoundException The SNS topic Amazon Resource Name (ARN) does not exist.
- SubscriptionCategoryNotFoundException The provided category does not exist.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
modifyGlobalCluster
default CompletableFuture<ModifyGlobalClusterResponse> modifyGlobalCluster(ModifyGlobalClusterRequest modifyGlobalClusterRequest) Modify a setting for an Amazon DocumentDB global cluster. You can change one or more configuration parameters (for example: deletion protection), or the global cluster identifier by specifying these parameters and the new values in the request.
This action only applies to Amazon DocumentDB clusters.
- Parameters:
modifyGlobalClusterRequest
- Represents the input to ModifyGlobalCluster.- Returns:
- A Java Future containing the result of the ModifyGlobalCluster operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- GlobalClusterNotFoundException The
GlobalClusterIdentifier
doesn't refer to an existing global cluster. - InvalidGlobalClusterStateException The requested operation can't be performed while the cluster is in this state.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- GlobalClusterNotFoundException The
- See Also:
-
modifyGlobalCluster
default CompletableFuture<ModifyGlobalClusterResponse> modifyGlobalCluster(Consumer<ModifyGlobalClusterRequest.Builder> modifyGlobalClusterRequest) Modify a setting for an Amazon DocumentDB global cluster. You can change one or more configuration parameters (for example: deletion protection), or the global cluster identifier by specifying these parameters and the new values in the request.
This action only applies to Amazon DocumentDB clusters.
This is a convenience which creates an instance of the
ModifyGlobalClusterRequest.Builder
avoiding the need to create one manually viaModifyGlobalClusterRequest.builder()
- Parameters:
modifyGlobalClusterRequest
- AConsumer
that will call methods onModifyGlobalClusterRequest.Builder
to create a request. Represents the input to ModifyGlobalCluster.- Returns:
- A Java Future containing the result of the ModifyGlobalCluster operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- GlobalClusterNotFoundException The
GlobalClusterIdentifier
doesn't refer to an existing global cluster. - InvalidGlobalClusterStateException The requested operation can't be performed while the cluster is in this state.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- GlobalClusterNotFoundException The
- See Also:
-
rebootDBInstance
default CompletableFuture<RebootDbInstanceResponse> rebootDBInstance(RebootDbInstanceRequest rebootDbInstanceRequest) You might need to reboot your instance, usually for maintenance reasons. For example, if you make certain changes, or if you change the cluster parameter group that is associated with the instance, you must reboot the instance for the changes to take effect.
Rebooting an instance restarts the database engine service. Rebooting an instance results in a momentary outage, during which the instance status is set to rebooting.
- Parameters:
rebootDbInstanceRequest
- Represents the input to RebootDBInstance.- Returns:
- A Java Future containing the result of the RebootDBInstance operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidDbInstanceStateException The specified instance isn't in the available state.
- DbInstanceNotFoundException
DBInstanceIdentifier
doesn't refer to an existing instance. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
rebootDBInstance
default CompletableFuture<RebootDbInstanceResponse> rebootDBInstance(Consumer<RebootDbInstanceRequest.Builder> rebootDbInstanceRequest) You might need to reboot your instance, usually for maintenance reasons. For example, if you make certain changes, or if you change the cluster parameter group that is associated with the instance, you must reboot the instance for the changes to take effect.
Rebooting an instance restarts the database engine service. Rebooting an instance results in a momentary outage, during which the instance status is set to rebooting.
This is a convenience which creates an instance of the
RebootDbInstanceRequest.Builder
avoiding the need to create one manually viaRebootDbInstanceRequest.builder()
- Parameters:
rebootDbInstanceRequest
- AConsumer
that will call methods onRebootDbInstanceRequest.Builder
to create a request. Represents the input to RebootDBInstance.- Returns:
- A Java Future containing the result of the RebootDBInstance operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidDbInstanceStateException The specified instance isn't in the available state.
- DbInstanceNotFoundException
DBInstanceIdentifier
doesn't refer to an existing instance. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
removeFromGlobalCluster
default CompletableFuture<RemoveFromGlobalClusterResponse> removeFromGlobalCluster(RemoveFromGlobalClusterRequest removeFromGlobalClusterRequest) Detaches an Amazon DocumentDB secondary cluster from a global cluster. The cluster becomes a standalone cluster with read-write capability instead of being read-only and receiving data from a primary in a different region.
This action only applies to Amazon DocumentDB clusters.
- Parameters:
removeFromGlobalClusterRequest
- Represents the input to RemoveFromGlobalCluster.- Returns:
- A Java Future containing the result of the RemoveFromGlobalCluster operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- GlobalClusterNotFoundException The
GlobalClusterIdentifier
doesn't refer to an existing global cluster. - InvalidGlobalClusterStateException The requested operation can't be performed while the cluster is in this state.
- DbClusterNotFoundException
DBClusterIdentifier
doesn't refer to an existing cluster. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- GlobalClusterNotFoundException The
- See Also:
-
removeFromGlobalCluster
default CompletableFuture<RemoveFromGlobalClusterResponse> removeFromGlobalCluster(Consumer<RemoveFromGlobalClusterRequest.Builder> removeFromGlobalClusterRequest) Detaches an Amazon DocumentDB secondary cluster from a global cluster. The cluster becomes a standalone cluster with read-write capability instead of being read-only and receiving data from a primary in a different region.
This action only applies to Amazon DocumentDB clusters.
This is a convenience which creates an instance of the
RemoveFromGlobalClusterRequest.Builder
avoiding the need to create one manually viaRemoveFromGlobalClusterRequest.builder()
- Parameters:
removeFromGlobalClusterRequest
- AConsumer
that will call methods onRemoveFromGlobalClusterRequest.Builder
to create a request. Represents the input to RemoveFromGlobalCluster.- Returns:
- A Java Future containing the result of the RemoveFromGlobalCluster operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- GlobalClusterNotFoundException The
GlobalClusterIdentifier
doesn't refer to an existing global cluster. - InvalidGlobalClusterStateException The requested operation can't be performed while the cluster is in this state.
- DbClusterNotFoundException
DBClusterIdentifier
doesn't refer to an existing cluster. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- GlobalClusterNotFoundException The
- See Also:
-
removeSourceIdentifierFromSubscription
default CompletableFuture<RemoveSourceIdentifierFromSubscriptionResponse> removeSourceIdentifierFromSubscription(RemoveSourceIdentifierFromSubscriptionRequest removeSourceIdentifierFromSubscriptionRequest) Removes a source identifier from an existing Amazon DocumentDB event notification subscription.
- Parameters:
removeSourceIdentifierFromSubscriptionRequest
- Represents the input to RemoveSourceIdentifierFromSubscription.- Returns:
- A Java Future containing the result of the RemoveSourceIdentifierFromSubscription operation returned by
the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- SubscriptionNotFoundException The subscription name does not exist.
- SourceNotFoundException The requested source could not be found.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
removeSourceIdentifierFromSubscription
default CompletableFuture<RemoveSourceIdentifierFromSubscriptionResponse> removeSourceIdentifierFromSubscription(Consumer<RemoveSourceIdentifierFromSubscriptionRequest.Builder> removeSourceIdentifierFromSubscriptionRequest) Removes a source identifier from an existing Amazon DocumentDB event notification subscription.
This is a convenience which creates an instance of the
RemoveSourceIdentifierFromSubscriptionRequest.Builder
avoiding the need to create one manually viaRemoveSourceIdentifierFromSubscriptionRequest.builder()
- Parameters:
removeSourceIdentifierFromSubscriptionRequest
- AConsumer
that will call methods onRemoveSourceIdentifierFromSubscriptionRequest.Builder
to create a request. Represents the input to RemoveSourceIdentifierFromSubscription.- Returns:
- A Java Future containing the result of the RemoveSourceIdentifierFromSubscription operation returned by
the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- SubscriptionNotFoundException The subscription name does not exist.
- SourceNotFoundException The requested source could not be found.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
removeTagsFromResource
default CompletableFuture<RemoveTagsFromResourceResponse> removeTagsFromResource(RemoveTagsFromResourceRequest removeTagsFromResourceRequest) Removes metadata tags from an Amazon DocumentDB resource.
- Parameters:
removeTagsFromResourceRequest
- Represents the input to RemoveTagsFromResource.- Returns:
- A Java Future containing the result of the RemoveTagsFromResource operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DbInstanceNotFoundException
DBInstanceIdentifier
doesn't refer to an existing instance. - DbSnapshotNotFoundException
DBSnapshotIdentifier
doesn't refer to an existing snapshot. - DbClusterNotFoundException
DBClusterIdentifier
doesn't refer to an existing cluster. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- DbInstanceNotFoundException
- See Also:
-
removeTagsFromResource
default CompletableFuture<RemoveTagsFromResourceResponse> removeTagsFromResource(Consumer<RemoveTagsFromResourceRequest.Builder> removeTagsFromResourceRequest) Removes metadata tags from an Amazon DocumentDB resource.
This is a convenience which creates an instance of the
RemoveTagsFromResourceRequest.Builder
avoiding the need to create one manually viaRemoveTagsFromResourceRequest.builder()
- Parameters:
removeTagsFromResourceRequest
- AConsumer
that will call methods onRemoveTagsFromResourceRequest.Builder
to create a request. Represents the input to RemoveTagsFromResource.- Returns:
- A Java Future containing the result of the RemoveTagsFromResource operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DbInstanceNotFoundException
DBInstanceIdentifier
doesn't refer to an existing instance. - DbSnapshotNotFoundException
DBSnapshotIdentifier
doesn't refer to an existing snapshot. - DbClusterNotFoundException
DBClusterIdentifier
doesn't refer to an existing cluster. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- DbInstanceNotFoundException
- See Also:
-
resetDBClusterParameterGroup
default CompletableFuture<ResetDbClusterParameterGroupResponse> resetDBClusterParameterGroup(ResetDbClusterParameterGroupRequest resetDbClusterParameterGroupRequest) Modifies the parameters of a cluster parameter group to the default value. To reset specific parameters, submit a list of the following:
ParameterName
andApplyMethod
. To reset the entire cluster parameter group, specify theDBClusterParameterGroupName
andResetAllParameters
parameters.When you reset the entire group, dynamic parameters are updated immediately and static parameters are set to
pending-reboot
to take effect on the next DB instance reboot.- Parameters:
resetDbClusterParameterGroupRequest
- Represents the input to ResetDBClusterParameterGroup.- Returns:
- A Java Future containing the result of the ResetDBClusterParameterGroup operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidDbParameterGroupStateException The parameter group is in use, or it is in a state that is not valid. If you are trying to delete the parameter group, you can't delete it when the parameter group is in this state.
- DbParameterGroupNotFoundException
DBParameterGroupName
doesn't refer to an existing parameter group. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
resetDBClusterParameterGroup
default CompletableFuture<ResetDbClusterParameterGroupResponse> resetDBClusterParameterGroup(Consumer<ResetDbClusterParameterGroupRequest.Builder> resetDbClusterParameterGroupRequest) Modifies the parameters of a cluster parameter group to the default value. To reset specific parameters, submit a list of the following:
ParameterName
andApplyMethod
. To reset the entire cluster parameter group, specify theDBClusterParameterGroupName
andResetAllParameters
parameters.When you reset the entire group, dynamic parameters are updated immediately and static parameters are set to
pending-reboot
to take effect on the next DB instance reboot.
This is a convenience which creates an instance of the
ResetDbClusterParameterGroupRequest.Builder
avoiding the need to create one manually viaResetDbClusterParameterGroupRequest.builder()
- Parameters:
resetDbClusterParameterGroupRequest
- AConsumer
that will call methods onResetDbClusterParameterGroupRequest.Builder
to create a request. Represents the input to ResetDBClusterParameterGroup.- Returns:
- A Java Future containing the result of the ResetDBClusterParameterGroup operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidDbParameterGroupStateException The parameter group is in use, or it is in a state that is not valid. If you are trying to delete the parameter group, you can't delete it when the parameter group is in this state.
- DbParameterGroupNotFoundException
DBParameterGroupName
doesn't refer to an existing parameter group. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
restoreDBClusterFromSnapshot
default CompletableFuture<RestoreDbClusterFromSnapshotResponse> restoreDBClusterFromSnapshot(RestoreDbClusterFromSnapshotRequest restoreDbClusterFromSnapshotRequest) Creates a new cluster from a snapshot or cluster snapshot.
If a snapshot is specified, the target cluster is created from the source DB snapshot with a default configuration and default security group.
If a cluster snapshot is specified, the target cluster is created from the source cluster restore point with the same configuration as the original source DB cluster, except that the new cluster is created with the default security group.
- Parameters:
restoreDbClusterFromSnapshotRequest
- Represents the input to RestoreDBClusterFromSnapshot.- Returns:
- A Java Future containing the result of the RestoreDBClusterFromSnapshot operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DbClusterAlreadyExistsException You already have a cluster with the given identifier.
- DbClusterQuotaExceededException The cluster can't be created because you have reached the maximum allowed quota of clusters.
- StorageQuotaExceededException The request would cause you to exceed the allowed amount of storage available across all instances.
- DbSubnetGroupNotFoundException
DBSubnetGroupName
doesn't refer to an existing subnet group. - DbSnapshotNotFoundException
DBSnapshotIdentifier
doesn't refer to an existing snapshot. - DbClusterSnapshotNotFoundException
DBClusterSnapshotIdentifier
doesn't refer to an existing cluster snapshot. - InsufficientDbClusterCapacityException The cluster doesn't have enough capacity for the current operation.
- InsufficientStorageClusterCapacityException There is not enough storage available for the current action. You might be able to resolve this error by updating your subnet group to use different Availability Zones that have more storage available.
- InvalidDbSnapshotStateException The state of the snapshot doesn't allow deletion.
- InvalidDbClusterSnapshotStateException The provided value isn't a valid cluster snapshot state.
- StorageQuotaExceededException The request would cause you to exceed the allowed amount of storage available across all instances.
- InvalidVpcNetworkStateException The subnet group doesn't cover all Availability Zones after it is created because of changes that were made.
- InvalidRestoreException You cannot restore from a virtual private cloud (VPC) backup to a non-VPC DB instance.
- DbSubnetGroupNotFoundException
DBSubnetGroupName
doesn't refer to an existing subnet group. - InvalidSubnetException The requested subnet is not valid, or multiple subnets were requested that are not all in a common virtual private cloud (VPC).
- KmsKeyNotAccessibleException An error occurred when accessing an KMS key.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
restoreDBClusterFromSnapshot
default CompletableFuture<RestoreDbClusterFromSnapshotResponse> restoreDBClusterFromSnapshot(Consumer<RestoreDbClusterFromSnapshotRequest.Builder> restoreDbClusterFromSnapshotRequest) Creates a new cluster from a snapshot or cluster snapshot.
If a snapshot is specified, the target cluster is created from the source DB snapshot with a default configuration and default security group.
If a cluster snapshot is specified, the target cluster is created from the source cluster restore point with the same configuration as the original source DB cluster, except that the new cluster is created with the default security group.
This is a convenience which creates an instance of the
RestoreDbClusterFromSnapshotRequest.Builder
avoiding the need to create one manually viaRestoreDbClusterFromSnapshotRequest.builder()
- Parameters:
restoreDbClusterFromSnapshotRequest
- AConsumer
that will call methods onRestoreDbClusterFromSnapshotRequest.Builder
to create a request. Represents the input to RestoreDBClusterFromSnapshot.- Returns:
- A Java Future containing the result of the RestoreDBClusterFromSnapshot operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DbClusterAlreadyExistsException You already have a cluster with the given identifier.
- DbClusterQuotaExceededException The cluster can't be created because you have reached the maximum allowed quota of clusters.
- StorageQuotaExceededException The request would cause you to exceed the allowed amount of storage available across all instances.
- DbSubnetGroupNotFoundException
DBSubnetGroupName
doesn't refer to an existing subnet group. - DbSnapshotNotFoundException
DBSnapshotIdentifier
doesn't refer to an existing snapshot. - DbClusterSnapshotNotFoundException
DBClusterSnapshotIdentifier
doesn't refer to an existing cluster snapshot. - InsufficientDbClusterCapacityException The cluster doesn't have enough capacity for the current operation.
- InsufficientStorageClusterCapacityException There is not enough storage available for the current action. You might be able to resolve this error by updating your subnet group to use different Availability Zones that have more storage available.
- InvalidDbSnapshotStateException The state of the snapshot doesn't allow deletion.
- InvalidDbClusterSnapshotStateException The provided value isn't a valid cluster snapshot state.
- StorageQuotaExceededException The request would cause you to exceed the allowed amount of storage available across all instances.
- InvalidVpcNetworkStateException The subnet group doesn't cover all Availability Zones after it is created because of changes that were made.
- InvalidRestoreException You cannot restore from a virtual private cloud (VPC) backup to a non-VPC DB instance.
- DbSubnetGroupNotFoundException
DBSubnetGroupName
doesn't refer to an existing subnet group. - InvalidSubnetException The requested subnet is not valid, or multiple subnets were requested that are not all in a common virtual private cloud (VPC).
- KmsKeyNotAccessibleException An error occurred when accessing an KMS key.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
restoreDBClusterToPointInTime
default CompletableFuture<RestoreDbClusterToPointInTimeResponse> restoreDBClusterToPointInTime(RestoreDbClusterToPointInTimeRequest restoreDbClusterToPointInTimeRequest) Restores a cluster to an arbitrary point in time. Users can restore to any point in time before
LatestRestorableTime
for up toBackupRetentionPeriod
days. The target cluster is created from the source cluster with the same configuration as the original cluster, except that the new cluster is created with the default security group.- Parameters:
restoreDbClusterToPointInTimeRequest
- Represents the input to RestoreDBClusterToPointInTime.- Returns:
- A Java Future containing the result of the RestoreDBClusterToPointInTime operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DbClusterAlreadyExistsException You already have a cluster with the given identifier.
- DbClusterNotFoundException
DBClusterIdentifier
doesn't refer to an existing cluster. - DbClusterQuotaExceededException The cluster can't be created because you have reached the maximum allowed quota of clusters.
- DbClusterSnapshotNotFoundException
DBClusterSnapshotIdentifier
doesn't refer to an existing cluster snapshot. - DbSubnetGroupNotFoundException
DBSubnetGroupName
doesn't refer to an existing subnet group. - InsufficientDbClusterCapacityException The cluster doesn't have enough capacity for the current operation.
- InsufficientStorageClusterCapacityException There is not enough storage available for the current action. You might be able to resolve this error by updating your subnet group to use different Availability Zones that have more storage available.
- InvalidDbClusterSnapshotStateException The provided value isn't a valid cluster snapshot state.
- InvalidDbClusterStateException The cluster isn't in a valid state.
- InvalidDbSnapshotStateException The state of the snapshot doesn't allow deletion.
- InvalidRestoreException You cannot restore from a virtual private cloud (VPC) backup to a non-VPC DB instance.
- InvalidSubnetException The requested subnet is not valid, or multiple subnets were requested that are not all in a common virtual private cloud (VPC).
- InvalidVpcNetworkStateException The subnet group doesn't cover all Availability Zones after it is created because of changes that were made.
- KmsKeyNotAccessibleException An error occurred when accessing an KMS key.
- StorageQuotaExceededException The request would cause you to exceed the allowed amount of storage available across all instances.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
restoreDBClusterToPointInTime
default CompletableFuture<RestoreDbClusterToPointInTimeResponse> restoreDBClusterToPointInTime(Consumer<RestoreDbClusterToPointInTimeRequest.Builder> restoreDbClusterToPointInTimeRequest) Restores a cluster to an arbitrary point in time. Users can restore to any point in time before
LatestRestorableTime
for up toBackupRetentionPeriod
days. The target cluster is created from the source cluster with the same configuration as the original cluster, except that the new cluster is created with the default security group.
This is a convenience which creates an instance of the
RestoreDbClusterToPointInTimeRequest.Builder
avoiding the need to create one manually viaRestoreDbClusterToPointInTimeRequest.builder()
- Parameters:
restoreDbClusterToPointInTimeRequest
- AConsumer
that will call methods onRestoreDbClusterToPointInTimeRequest.Builder
to create a request. Represents the input to RestoreDBClusterToPointInTime.- Returns:
- A Java Future containing the result of the RestoreDBClusterToPointInTime operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DbClusterAlreadyExistsException You already have a cluster with the given identifier.
- DbClusterNotFoundException
DBClusterIdentifier
doesn't refer to an existing cluster. - DbClusterQuotaExceededException The cluster can't be created because you have reached the maximum allowed quota of clusters.
- DbClusterSnapshotNotFoundException
DBClusterSnapshotIdentifier
doesn't refer to an existing cluster snapshot. - DbSubnetGroupNotFoundException
DBSubnetGroupName
doesn't refer to an existing subnet group. - InsufficientDbClusterCapacityException The cluster doesn't have enough capacity for the current operation.
- InsufficientStorageClusterCapacityException There is not enough storage available for the current action. You might be able to resolve this error by updating your subnet group to use different Availability Zones that have more storage available.
- InvalidDbClusterSnapshotStateException The provided value isn't a valid cluster snapshot state.
- InvalidDbClusterStateException The cluster isn't in a valid state.
- InvalidDbSnapshotStateException The state of the snapshot doesn't allow deletion.
- InvalidRestoreException You cannot restore from a virtual private cloud (VPC) backup to a non-VPC DB instance.
- InvalidSubnetException The requested subnet is not valid, or multiple subnets were requested that are not all in a common virtual private cloud (VPC).
- InvalidVpcNetworkStateException The subnet group doesn't cover all Availability Zones after it is created because of changes that were made.
- KmsKeyNotAccessibleException An error occurred when accessing an KMS key.
- StorageQuotaExceededException The request would cause you to exceed the allowed amount of storage available across all instances.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
startDBCluster
default CompletableFuture<StartDbClusterResponse> startDBCluster(StartDbClusterRequest startDbClusterRequest) Restarts the stopped cluster that is specified by
DBClusterIdentifier
. For more information, see Stopping and Starting an Amazon DocumentDB Cluster.- Parameters:
startDbClusterRequest
-- Returns:
- A Java Future containing the result of the StartDBCluster operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DbClusterNotFoundException
DBClusterIdentifier
doesn't refer to an existing cluster. - InvalidDbClusterStateException The cluster isn't in a valid state.
- InvalidDbInstanceStateException The specified instance isn't in the available state.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- DbClusterNotFoundException
- See Also:
-
startDBCluster
default CompletableFuture<StartDbClusterResponse> startDBCluster(Consumer<StartDbClusterRequest.Builder> startDbClusterRequest) Restarts the stopped cluster that is specified by
DBClusterIdentifier
. For more information, see Stopping and Starting an Amazon DocumentDB Cluster.
This is a convenience which creates an instance of the
StartDbClusterRequest.Builder
avoiding the need to create one manually viaStartDbClusterRequest.builder()
- Parameters:
startDbClusterRequest
- AConsumer
that will call methods onStartDbClusterRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the StartDBCluster operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DbClusterNotFoundException
DBClusterIdentifier
doesn't refer to an existing cluster. - InvalidDbClusterStateException The cluster isn't in a valid state.
- InvalidDbInstanceStateException The specified instance isn't in the available state.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- DbClusterNotFoundException
- See Also:
-
stopDBCluster
default CompletableFuture<StopDbClusterResponse> stopDBCluster(StopDbClusterRequest stopDbClusterRequest) Stops the running cluster that is specified by
DBClusterIdentifier
. The cluster must be in the available state. For more information, see Stopping and Starting an Amazon DocumentDB Cluster.- Parameters:
stopDbClusterRequest
-- Returns:
- A Java Future containing the result of the StopDBCluster operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DbClusterNotFoundException
DBClusterIdentifier
doesn't refer to an existing cluster. - InvalidDbClusterStateException The cluster isn't in a valid state.
- InvalidDbInstanceStateException The specified instance isn't in the available state.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- DbClusterNotFoundException
- See Also:
-
stopDBCluster
default CompletableFuture<StopDbClusterResponse> stopDBCluster(Consumer<StopDbClusterRequest.Builder> stopDbClusterRequest) Stops the running cluster that is specified by
DBClusterIdentifier
. The cluster must be in the available state. For more information, see Stopping and Starting an Amazon DocumentDB Cluster.
This is a convenience which creates an instance of the
StopDbClusterRequest.Builder
avoiding the need to create one manually viaStopDbClusterRequest.builder()
- Parameters:
stopDbClusterRequest
- AConsumer
that will call methods onStopDbClusterRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the StopDBCluster operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- DbClusterNotFoundException
DBClusterIdentifier
doesn't refer to an existing cluster. - InvalidDbClusterStateException The cluster isn't in a valid state.
- InvalidDbInstanceStateException The specified instance isn't in the available state.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- DbClusterNotFoundException
- See Also:
-
switchoverGlobalCluster
default CompletableFuture<SwitchoverGlobalClusterResponse> switchoverGlobalCluster(SwitchoverGlobalClusterRequest switchoverGlobalClusterRequest) Switches over the specified secondary Amazon DocumentDB cluster to be the new primary Amazon DocumentDB cluster in the global database cluster.
- Parameters:
switchoverGlobalClusterRequest
-- Returns:
- A Java Future containing the result of the SwitchoverGlobalCluster operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- GlobalClusterNotFoundException The
GlobalClusterIdentifier
doesn't refer to an existing global cluster. - InvalidGlobalClusterStateException The requested operation can't be performed while the cluster is in this state.
- DbClusterNotFoundException
DBClusterIdentifier
doesn't refer to an existing cluster. - InvalidDbClusterStateException The cluster isn't in a valid state.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- GlobalClusterNotFoundException The
- See Also:
-
switchoverGlobalCluster
default CompletableFuture<SwitchoverGlobalClusterResponse> switchoverGlobalCluster(Consumer<SwitchoverGlobalClusterRequest.Builder> switchoverGlobalClusterRequest) Switches over the specified secondary Amazon DocumentDB cluster to be the new primary Amazon DocumentDB cluster in the global database cluster.
This is a convenience which creates an instance of the
SwitchoverGlobalClusterRequest.Builder
avoiding the need to create one manually viaSwitchoverGlobalClusterRequest.builder()
- Parameters:
switchoverGlobalClusterRequest
- AConsumer
that will call methods onSwitchoverGlobalClusterRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the SwitchoverGlobalCluster operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- GlobalClusterNotFoundException The
GlobalClusterIdentifier
doesn't refer to an existing global cluster. - InvalidGlobalClusterStateException The requested operation can't be performed while the cluster is in this state.
- DbClusterNotFoundException
DBClusterIdentifier
doesn't refer to an existing cluster. - InvalidDbClusterStateException The cluster isn't in a valid state.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DocDbException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- GlobalClusterNotFoundException The
- See Also:
-
waiter
Create an instance ofDocDbAsyncWaiter
using this client.Waiters created via this method are managed by the SDK and resources will be released when the service client is closed.
- Returns:
- an instance of
DocDbAsyncWaiter
-
serviceClientConfiguration
Description copied from interface:SdkClient
The SDK service client configuration exposes client settings to the user, e.g., ClientOverrideConfiguration- Specified by:
serviceClientConfiguration
in interfaceAwsClient
- Specified by:
serviceClientConfiguration
in interfaceSdkClient
- Returns:
- SdkServiceClientConfiguration
-
create
Create aDocDbAsyncClient
with the region loaded from theDefaultAwsRegionProviderChain
and credentials loaded from theDefaultCredentialsProvider
. -
builder
Create a builder that can be used to configure and create aDocDbAsyncClient
.
-