software.amazon.awssdk.services.dynamodb.DynamoDbAsyncClient Maven / Gradle / Ivy
Show all versions of dynamodb Show documentation
/*
* Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
*
* Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with
* the License. A copy of the License is located at
*
* http://aws.amazon.com/apache2.0
*
* or in the "license" file accompanying this file. This file is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
* CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions
* and limitations under the License.
*/
package software.amazon.awssdk.services.dynamodb;
import java.util.concurrent.CompletableFuture;
import java.util.function.Consumer;
import software.amazon.awssdk.annotations.Generated;
import software.amazon.awssdk.core.SdkClient;
import software.amazon.awssdk.services.dynamodb.model.BatchExecuteStatementRequest;
import software.amazon.awssdk.services.dynamodb.model.BatchExecuteStatementResponse;
import software.amazon.awssdk.services.dynamodb.model.BatchGetItemRequest;
import software.amazon.awssdk.services.dynamodb.model.BatchGetItemResponse;
import software.amazon.awssdk.services.dynamodb.model.BatchWriteItemRequest;
import software.amazon.awssdk.services.dynamodb.model.BatchWriteItemResponse;
import software.amazon.awssdk.services.dynamodb.model.CreateBackupRequest;
import software.amazon.awssdk.services.dynamodb.model.CreateBackupResponse;
import software.amazon.awssdk.services.dynamodb.model.CreateGlobalTableRequest;
import software.amazon.awssdk.services.dynamodb.model.CreateGlobalTableResponse;
import software.amazon.awssdk.services.dynamodb.model.CreateTableRequest;
import software.amazon.awssdk.services.dynamodb.model.CreateTableResponse;
import software.amazon.awssdk.services.dynamodb.model.DeleteBackupRequest;
import software.amazon.awssdk.services.dynamodb.model.DeleteBackupResponse;
import software.amazon.awssdk.services.dynamodb.model.DeleteItemRequest;
import software.amazon.awssdk.services.dynamodb.model.DeleteItemResponse;
import software.amazon.awssdk.services.dynamodb.model.DeleteTableRequest;
import software.amazon.awssdk.services.dynamodb.model.DeleteTableResponse;
import software.amazon.awssdk.services.dynamodb.model.DescribeBackupRequest;
import software.amazon.awssdk.services.dynamodb.model.DescribeBackupResponse;
import software.amazon.awssdk.services.dynamodb.model.DescribeContinuousBackupsRequest;
import software.amazon.awssdk.services.dynamodb.model.DescribeContinuousBackupsResponse;
import software.amazon.awssdk.services.dynamodb.model.DescribeContributorInsightsRequest;
import software.amazon.awssdk.services.dynamodb.model.DescribeContributorInsightsResponse;
import software.amazon.awssdk.services.dynamodb.model.DescribeEndpointsRequest;
import software.amazon.awssdk.services.dynamodb.model.DescribeEndpointsResponse;
import software.amazon.awssdk.services.dynamodb.model.DescribeExportRequest;
import software.amazon.awssdk.services.dynamodb.model.DescribeExportResponse;
import software.amazon.awssdk.services.dynamodb.model.DescribeGlobalTableRequest;
import software.amazon.awssdk.services.dynamodb.model.DescribeGlobalTableResponse;
import software.amazon.awssdk.services.dynamodb.model.DescribeGlobalTableSettingsRequest;
import software.amazon.awssdk.services.dynamodb.model.DescribeGlobalTableSettingsResponse;
import software.amazon.awssdk.services.dynamodb.model.DescribeKinesisStreamingDestinationRequest;
import software.amazon.awssdk.services.dynamodb.model.DescribeKinesisStreamingDestinationResponse;
import software.amazon.awssdk.services.dynamodb.model.DescribeLimitsRequest;
import software.amazon.awssdk.services.dynamodb.model.DescribeLimitsResponse;
import software.amazon.awssdk.services.dynamodb.model.DescribeTableReplicaAutoScalingRequest;
import software.amazon.awssdk.services.dynamodb.model.DescribeTableReplicaAutoScalingResponse;
import software.amazon.awssdk.services.dynamodb.model.DescribeTableRequest;
import software.amazon.awssdk.services.dynamodb.model.DescribeTableResponse;
import software.amazon.awssdk.services.dynamodb.model.DescribeTimeToLiveRequest;
import software.amazon.awssdk.services.dynamodb.model.DescribeTimeToLiveResponse;
import software.amazon.awssdk.services.dynamodb.model.DisableKinesisStreamingDestinationRequest;
import software.amazon.awssdk.services.dynamodb.model.DisableKinesisStreamingDestinationResponse;
import software.amazon.awssdk.services.dynamodb.model.EnableKinesisStreamingDestinationRequest;
import software.amazon.awssdk.services.dynamodb.model.EnableKinesisStreamingDestinationResponse;
import software.amazon.awssdk.services.dynamodb.model.ExecuteStatementRequest;
import software.amazon.awssdk.services.dynamodb.model.ExecuteStatementResponse;
import software.amazon.awssdk.services.dynamodb.model.ExecuteTransactionRequest;
import software.amazon.awssdk.services.dynamodb.model.ExecuteTransactionResponse;
import software.amazon.awssdk.services.dynamodb.model.ExportTableToPointInTimeRequest;
import software.amazon.awssdk.services.dynamodb.model.ExportTableToPointInTimeResponse;
import software.amazon.awssdk.services.dynamodb.model.GetItemRequest;
import software.amazon.awssdk.services.dynamodb.model.GetItemResponse;
import software.amazon.awssdk.services.dynamodb.model.ListBackupsRequest;
import software.amazon.awssdk.services.dynamodb.model.ListBackupsResponse;
import software.amazon.awssdk.services.dynamodb.model.ListContributorInsightsRequest;
import software.amazon.awssdk.services.dynamodb.model.ListContributorInsightsResponse;
import software.amazon.awssdk.services.dynamodb.model.ListExportsRequest;
import software.amazon.awssdk.services.dynamodb.model.ListExportsResponse;
import software.amazon.awssdk.services.dynamodb.model.ListGlobalTablesRequest;
import software.amazon.awssdk.services.dynamodb.model.ListGlobalTablesResponse;
import software.amazon.awssdk.services.dynamodb.model.ListTablesRequest;
import software.amazon.awssdk.services.dynamodb.model.ListTablesResponse;
import software.amazon.awssdk.services.dynamodb.model.ListTagsOfResourceRequest;
import software.amazon.awssdk.services.dynamodb.model.ListTagsOfResourceResponse;
import software.amazon.awssdk.services.dynamodb.model.PutItemRequest;
import software.amazon.awssdk.services.dynamodb.model.PutItemResponse;
import software.amazon.awssdk.services.dynamodb.model.QueryRequest;
import software.amazon.awssdk.services.dynamodb.model.QueryResponse;
import software.amazon.awssdk.services.dynamodb.model.RestoreTableFromBackupRequest;
import software.amazon.awssdk.services.dynamodb.model.RestoreTableFromBackupResponse;
import software.amazon.awssdk.services.dynamodb.model.RestoreTableToPointInTimeRequest;
import software.amazon.awssdk.services.dynamodb.model.RestoreTableToPointInTimeResponse;
import software.amazon.awssdk.services.dynamodb.model.ScanRequest;
import software.amazon.awssdk.services.dynamodb.model.ScanResponse;
import software.amazon.awssdk.services.dynamodb.model.TagResourceRequest;
import software.amazon.awssdk.services.dynamodb.model.TagResourceResponse;
import software.amazon.awssdk.services.dynamodb.model.TransactGetItemsRequest;
import software.amazon.awssdk.services.dynamodb.model.TransactGetItemsResponse;
import software.amazon.awssdk.services.dynamodb.model.TransactWriteItemsRequest;
import software.amazon.awssdk.services.dynamodb.model.TransactWriteItemsResponse;
import software.amazon.awssdk.services.dynamodb.model.UntagResourceRequest;
import software.amazon.awssdk.services.dynamodb.model.UntagResourceResponse;
import software.amazon.awssdk.services.dynamodb.model.UpdateContinuousBackupsRequest;
import software.amazon.awssdk.services.dynamodb.model.UpdateContinuousBackupsResponse;
import software.amazon.awssdk.services.dynamodb.model.UpdateContributorInsightsRequest;
import software.amazon.awssdk.services.dynamodb.model.UpdateContributorInsightsResponse;
import software.amazon.awssdk.services.dynamodb.model.UpdateGlobalTableRequest;
import software.amazon.awssdk.services.dynamodb.model.UpdateGlobalTableResponse;
import software.amazon.awssdk.services.dynamodb.model.UpdateGlobalTableSettingsRequest;
import software.amazon.awssdk.services.dynamodb.model.UpdateGlobalTableSettingsResponse;
import software.amazon.awssdk.services.dynamodb.model.UpdateItemRequest;
import software.amazon.awssdk.services.dynamodb.model.UpdateItemResponse;
import software.amazon.awssdk.services.dynamodb.model.UpdateTableReplicaAutoScalingRequest;
import software.amazon.awssdk.services.dynamodb.model.UpdateTableReplicaAutoScalingResponse;
import software.amazon.awssdk.services.dynamodb.model.UpdateTableRequest;
import software.amazon.awssdk.services.dynamodb.model.UpdateTableResponse;
import software.amazon.awssdk.services.dynamodb.model.UpdateTimeToLiveRequest;
import software.amazon.awssdk.services.dynamodb.model.UpdateTimeToLiveResponse;
import software.amazon.awssdk.services.dynamodb.paginators.BatchGetItemPublisher;
import software.amazon.awssdk.services.dynamodb.paginators.ListContributorInsightsPublisher;
import software.amazon.awssdk.services.dynamodb.paginators.ListExportsPublisher;
import software.amazon.awssdk.services.dynamodb.paginators.ListTablesPublisher;
import software.amazon.awssdk.services.dynamodb.paginators.QueryPublisher;
import software.amazon.awssdk.services.dynamodb.paginators.ScanPublisher;
import software.amazon.awssdk.services.dynamodb.waiters.DynamoDbAsyncWaiter;
/**
* Service client for accessing DynamoDB asynchronously. This can be created using the static {@link #builder()} method.
*
* Amazon DynamoDB
*
* Amazon DynamoDB is a fully managed NoSQL database service that provides fast and predictable performance with
* seamless scalability. DynamoDB lets you offload the administrative burdens of operating and scaling a distributed
* database, so that you don't have to worry about hardware provisioning, setup and configuration, replication, software
* patching, or cluster scaling.
*
*
* With DynamoDB, you can create database tables that can store and retrieve any amount of data, and serve any level of
* request traffic. You can scale up or scale down your tables' throughput capacity without downtime or performance
* degradation, and use the AWS Management Console to monitor resource utilization and performance metrics.
*
*
* DynamoDB automatically spreads the data and traffic for your tables over a sufficient number of servers to handle
* your throughput and storage requirements, while maintaining consistent and fast performance. All of your data is
* stored on solid state disks (SSDs) and automatically replicated across multiple Availability Zones in an AWS region,
* providing built-in high availability and data durability.
*
*/
@Generated("software.amazon.awssdk:codegen")
public interface DynamoDbAsyncClient extends SdkClient {
String SERVICE_NAME = "dynamodb";
/**
* Create a {@link DynamoDbAsyncClient} with the region loaded from the
* {@link software.amazon.awssdk.regions.providers.DefaultAwsRegionProviderChain} and credentials loaded from the
* {@link software.amazon.awssdk.auth.credentials.DefaultCredentialsProvider}.
*/
static DynamoDbAsyncClient create() {
return builder().build();
}
/**
* Create a builder that can be used to configure and create a {@link DynamoDbAsyncClient}.
*/
static DynamoDbAsyncClientBuilder builder() {
return new DefaultDynamoDbAsyncClientBuilder();
}
/**
*
* This operation allows you to perform batch reads and writes on data stored in DynamoDB, using PartiQL.
*
*
* @param batchExecuteStatementRequest
* @return A Java Future containing the result of the BatchExecuteStatement operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - RequestLimitExceededException Throughput exceeds the current throughput quota for your account.
* Please contact AWS Support at AWS Support to request a quota
* increase.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.BatchExecuteStatement
* @see AWS
* API Documentation
*/
default CompletableFuture batchExecuteStatement(
BatchExecuteStatementRequest batchExecuteStatementRequest) {
throw new UnsupportedOperationException();
}
/**
*
* This operation allows you to perform batch reads and writes on data stored in DynamoDB, using PartiQL.
*
*
*
* This is a convenience which creates an instance of the {@link BatchExecuteStatementRequest.Builder} avoiding the
* need to create one manually via {@link BatchExecuteStatementRequest#builder()}
*
*
* @param batchExecuteStatementRequest
* A {@link Consumer} that will call methods on {@link BatchExecuteStatementInput.Builder} to create a
* request.
* @return A Java Future containing the result of the BatchExecuteStatement operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - RequestLimitExceededException Throughput exceeds the current throughput quota for your account.
* Please contact AWS Support at AWS Support to request a quota
* increase.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.BatchExecuteStatement
* @see AWS
* API Documentation
*/
default CompletableFuture batchExecuteStatement(
Consumer batchExecuteStatementRequest) {
return batchExecuteStatement(BatchExecuteStatementRequest.builder().applyMutation(batchExecuteStatementRequest).build());
}
/**
*
* The BatchGetItem operation returns the attributes of one or more items from one or more tables. You
* identify requested items by primary key.
*
*
* A single operation can retrieve up to 16 MB of data, which can contain as many as 100 items.
* BatchGetItem returns a partial result if the response size limit is exceeded, the table's
* provisioned throughput is exceeded, or an internal processing failure occurs. If a partial result is returned,
* the operation returns a value for UnprocessedKeys. You can use this value to retry the operation
* starting with the next item to get.
*
*
*
* If you request more than 100 items, BatchGetItem returns a ValidationException with the
* message "Too many items requested for the BatchGetItem call."
*
*
*
* For example, if you ask to retrieve 100 items, but each individual item is 300 KB in size, the system returns 52
* items (so as not to exceed the 16 MB limit). It also returns an appropriate UnprocessedKeys value so
* you can get the next page of results. If desired, your application can include its own logic to assemble the
* pages of results into one dataset.
*
*
* If none of the items can be processed due to insufficient provisioned throughput on all of the tables in
* the request, then BatchGetItem returns a ProvisionedThroughputExceededException. If
* at least one of the items is successfully processed, then BatchGetItem completes
* successfully, while returning the keys of the unread items in UnprocessedKeys.
*
*
*
* If DynamoDB returns any unprocessed items, you should retry the batch operation on those items. However, we
* strongly recommend that you use an exponential backoff algorithm. If you retry the batch operation
* immediately, the underlying read or write requests can still fail due to throttling on the individual tables. If
* you delay the batch operation using exponential backoff, the individual requests in the batch are much more
* likely to succeed.
*
*
* For more information, see Batch
* Operations and Error Handling in the Amazon DynamoDB Developer Guide.
*
*
*
* By default, BatchGetItem performs eventually consistent reads on every table in the request. If you
* want strongly consistent reads instead, you can set ConsistentRead to true for any or
* all tables.
*
*
* In order to minimize response latency, BatchGetItem retrieves items in parallel.
*
*
* When designing your application, keep in mind that DynamoDB does not return items in any particular order. To
* help parse the response by item, include the primary key values for the items in your request in the
* ProjectionExpression parameter.
*
*
* If a requested item does not exist, it is not returned in the result. Requests for nonexistent items consume the
* minimum read capacity units according to the type of read. For more information, see Working with Tables in the Amazon DynamoDB Developer Guide.
*
*
* @param batchGetItemRequest
* Represents the input of a BatchGetItem operation.
* @return A Java Future containing the result of the BatchGetItem operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ProvisionedThroughputExceededException Your request rate is too high. The AWS SDKs for DynamoDB
* automatically retry requests that receive this exception. Your request is eventually successful, unless
* your retry queue is too large to finish. Reduce the frequency of requests and use exponential backoff.
* For more information, go to Error Retries and Exponential Backoff in the Amazon DynamoDB Developer Guide.
* - ResourceNotFoundException The operation tried to access a nonexistent table or index. The resource
* might not be specified correctly, or its status might not be
ACTIVE.
* - RequestLimitExceededException Throughput exceeds the current throughput quota for your account.
* Please contact AWS Support at AWS Support to request a quota
* increase.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.BatchGetItem
* @see AWS API
* Documentation
*/
default CompletableFuture batchGetItem(BatchGetItemRequest batchGetItemRequest) {
throw new UnsupportedOperationException();
}
/**
*
* The BatchGetItem operation returns the attributes of one or more items from one or more tables. You
* identify requested items by primary key.
*
*
* A single operation can retrieve up to 16 MB of data, which can contain as many as 100 items.
* BatchGetItem returns a partial result if the response size limit is exceeded, the table's
* provisioned throughput is exceeded, or an internal processing failure occurs. If a partial result is returned,
* the operation returns a value for UnprocessedKeys. You can use this value to retry the operation
* starting with the next item to get.
*
*
*
* If you request more than 100 items, BatchGetItem returns a ValidationException with the
* message "Too many items requested for the BatchGetItem call."
*
*
*
* For example, if you ask to retrieve 100 items, but each individual item is 300 KB in size, the system returns 52
* items (so as not to exceed the 16 MB limit). It also returns an appropriate UnprocessedKeys value so
* you can get the next page of results. If desired, your application can include its own logic to assemble the
* pages of results into one dataset.
*
*
* If none of the items can be processed due to insufficient provisioned throughput on all of the tables in
* the request, then BatchGetItem returns a ProvisionedThroughputExceededException. If
* at least one of the items is successfully processed, then BatchGetItem completes
* successfully, while returning the keys of the unread items in UnprocessedKeys.
*
*
*
* If DynamoDB returns any unprocessed items, you should retry the batch operation on those items. However, we
* strongly recommend that you use an exponential backoff algorithm. If you retry the batch operation
* immediately, the underlying read or write requests can still fail due to throttling on the individual tables. If
* you delay the batch operation using exponential backoff, the individual requests in the batch are much more
* likely to succeed.
*
*
* For more information, see Batch
* Operations and Error Handling in the Amazon DynamoDB Developer Guide.
*
*
*
* By default, BatchGetItem performs eventually consistent reads on every table in the request. If you
* want strongly consistent reads instead, you can set ConsistentRead to true for any or
* all tables.
*
*
* In order to minimize response latency, BatchGetItem retrieves items in parallel.
*
*
* When designing your application, keep in mind that DynamoDB does not return items in any particular order. To
* help parse the response by item, include the primary key values for the items in your request in the
* ProjectionExpression parameter.
*
*
* If a requested item does not exist, it is not returned in the result. Requests for nonexistent items consume the
* minimum read capacity units according to the type of read. For more information, see Working with Tables in the Amazon DynamoDB Developer Guide.
*
*
*
* This is a convenience which creates an instance of the {@link BatchGetItemRequest.Builder} avoiding the need to
* create one manually via {@link BatchGetItemRequest#builder()}
*
*
* @param batchGetItemRequest
* A {@link Consumer} that will call methods on {@link BatchGetItemInput.Builder} to create a request.
* Represents the input of a BatchGetItem operation.
* @return A Java Future containing the result of the BatchGetItem operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ProvisionedThroughputExceededException Your request rate is too high. The AWS SDKs for DynamoDB
* automatically retry requests that receive this exception. Your request is eventually successful, unless
* your retry queue is too large to finish. Reduce the frequency of requests and use exponential backoff.
* For more information, go to Error Retries and Exponential Backoff in the Amazon DynamoDB Developer Guide.
* - ResourceNotFoundException The operation tried to access a nonexistent table or index. The resource
* might not be specified correctly, or its status might not be
ACTIVE.
* - RequestLimitExceededException Throughput exceeds the current throughput quota for your account.
* Please contact AWS Support at AWS Support to request a quota
* increase.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.BatchGetItem
* @see AWS API
* Documentation
*/
default CompletableFuture batchGetItem(Consumer batchGetItemRequest) {
return batchGetItem(BatchGetItemRequest.builder().applyMutation(batchGetItemRequest).build());
}
/**
*
* The BatchGetItem operation returns the attributes of one or more items from one or more tables. You
* identify requested items by primary key.
*
*
* A single operation can retrieve up to 16 MB of data, which can contain as many as 100 items.
* BatchGetItem returns a partial result if the response size limit is exceeded, the table's
* provisioned throughput is exceeded, or an internal processing failure occurs. If a partial result is returned,
* the operation returns a value for UnprocessedKeys. You can use this value to retry the operation
* starting with the next item to get.
*
*
*
* If you request more than 100 items, BatchGetItem returns a ValidationException with the
* message "Too many items requested for the BatchGetItem call."
*
*
*
* For example, if you ask to retrieve 100 items, but each individual item is 300 KB in size, the system returns 52
* items (so as not to exceed the 16 MB limit). It also returns an appropriate UnprocessedKeys value so
* you can get the next page of results. If desired, your application can include its own logic to assemble the
* pages of results into one dataset.
*
*
* If none of the items can be processed due to insufficient provisioned throughput on all of the tables in
* the request, then BatchGetItem returns a ProvisionedThroughputExceededException. If
* at least one of the items is successfully processed, then BatchGetItem completes
* successfully, while returning the keys of the unread items in UnprocessedKeys.
*
*
*
* If DynamoDB returns any unprocessed items, you should retry the batch operation on those items. However, we
* strongly recommend that you use an exponential backoff algorithm. If you retry the batch operation
* immediately, the underlying read or write requests can still fail due to throttling on the individual tables. If
* you delay the batch operation using exponential backoff, the individual requests in the batch are much more
* likely to succeed.
*
*
* For more information, see Batch
* Operations and Error Handling in the Amazon DynamoDB Developer Guide.
*
*
*
* By default, BatchGetItem performs eventually consistent reads on every table in the request. If you
* want strongly consistent reads instead, you can set ConsistentRead to true for any or
* all tables.
*
*
* In order to minimize response latency, BatchGetItem retrieves items in parallel.
*
*
* When designing your application, keep in mind that DynamoDB does not return items in any particular order. To
* help parse the response by item, include the primary key values for the items in your request in the
* ProjectionExpression parameter.
*
*
* If a requested item does not exist, it is not returned in the result. Requests for nonexistent items consume the
* minimum read capacity units according to the type of read. For more information, see Working with Tables in the Amazon DynamoDB Developer Guide.
*
*
*
* This is a variant of {@link #batchGetItem(software.amazon.awssdk.services.dynamodb.model.BatchGetItemRequest)}
* 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
* {@link org.reactivestreams.Publisher#subscribe(org.reactivestreams.Subscriber)}. Each call to the subscribe
* method will result in a new {@link org.reactivestreams.Subscription} 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 method
*
*
* {@code
* software.amazon.awssdk.services.dynamodb.paginators.BatchGetItemPublisher publisher = client.batchGetItemPaginator(request);
* CompletableFuture future = publisher.subscribe(res -> { // Do something with the response });
* future.get();
* }
*
*
* 2) Using a custom subscriber
*
*
* {@code
* software.amazon.awssdk.services.dynamodb.paginators.BatchGetItemPublisher publisher = client.batchGetItemPaginator(request);
* publisher.subscribe(new Subscriber() {
*
* public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
*
*
* public void onNext(software.amazon.awssdk.services.dynamodb.model.BatchGetItemResponse response) { //... };
* });}
*
*
* As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.
*
* Please notice that the configuration of null 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
* {@link #batchGetItem(software.amazon.awssdk.services.dynamodb.model.BatchGetItemRequest)} operation.
*
*
* @param batchGetItemRequest
* Represents the input of a BatchGetItem operation.
* @return 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.
*
* - ProvisionedThroughputExceededException Your request rate is too high. The AWS SDKs for DynamoDB
* automatically retry requests that receive this exception. Your request is eventually successful, unless
* your retry queue is too large to finish. Reduce the frequency of requests and use exponential backoff.
* For more information, go to Error Retries and Exponential Backoff in the Amazon DynamoDB Developer Guide.
* - ResourceNotFoundException The operation tried to access a nonexistent table or index. The resource
* might not be specified correctly, or its status might not be
ACTIVE.
* - RequestLimitExceededException Throughput exceeds the current throughput quota for your account.
* Please contact AWS Support at AWS Support to request a quota
* increase.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.BatchGetItem
* @see AWS API
* Documentation
*/
default BatchGetItemPublisher batchGetItemPaginator(BatchGetItemRequest batchGetItemRequest) {
throw new UnsupportedOperationException();
}
/**
*
* The BatchGetItem operation returns the attributes of one or more items from one or more tables. You
* identify requested items by primary key.
*
*
* A single operation can retrieve up to 16 MB of data, which can contain as many as 100 items.
* BatchGetItem returns a partial result if the response size limit is exceeded, the table's
* provisioned throughput is exceeded, or an internal processing failure occurs. If a partial result is returned,
* the operation returns a value for UnprocessedKeys. You can use this value to retry the operation
* starting with the next item to get.
*
*
*
* If you request more than 100 items, BatchGetItem returns a ValidationException with the
* message "Too many items requested for the BatchGetItem call."
*
*
*
* For example, if you ask to retrieve 100 items, but each individual item is 300 KB in size, the system returns 52
* items (so as not to exceed the 16 MB limit). It also returns an appropriate UnprocessedKeys value so
* you can get the next page of results. If desired, your application can include its own logic to assemble the
* pages of results into one dataset.
*
*
* If none of the items can be processed due to insufficient provisioned throughput on all of the tables in
* the request, then BatchGetItem returns a ProvisionedThroughputExceededException. If
* at least one of the items is successfully processed, then BatchGetItem completes
* successfully, while returning the keys of the unread items in UnprocessedKeys.
*
*
*
* If DynamoDB returns any unprocessed items, you should retry the batch operation on those items. However, we
* strongly recommend that you use an exponential backoff algorithm. If you retry the batch operation
* immediately, the underlying read or write requests can still fail due to throttling on the individual tables. If
* you delay the batch operation using exponential backoff, the individual requests in the batch are much more
* likely to succeed.
*
*
* For more information, see Batch
* Operations and Error Handling in the Amazon DynamoDB Developer Guide.
*
*
*
* By default, BatchGetItem performs eventually consistent reads on every table in the request. If you
* want strongly consistent reads instead, you can set ConsistentRead to true for any or
* all tables.
*
*
* In order to minimize response latency, BatchGetItem retrieves items in parallel.
*
*
* When designing your application, keep in mind that DynamoDB does not return items in any particular order. To
* help parse the response by item, include the primary key values for the items in your request in the
* ProjectionExpression parameter.
*
*
* If a requested item does not exist, it is not returned in the result. Requests for nonexistent items consume the
* minimum read capacity units according to the type of read. For more information, see Working with Tables in the Amazon DynamoDB Developer Guide.
*
*
*
* This is a variant of {@link #batchGetItem(software.amazon.awssdk.services.dynamodb.model.BatchGetItemRequest)}
* 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
* {@link org.reactivestreams.Publisher#subscribe(org.reactivestreams.Subscriber)}. Each call to the subscribe
* method will result in a new {@link org.reactivestreams.Subscription} 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 method
*
*
* {@code
* software.amazon.awssdk.services.dynamodb.paginators.BatchGetItemPublisher publisher = client.batchGetItemPaginator(request);
* CompletableFuture future = publisher.subscribe(res -> { // Do something with the response });
* future.get();
* }
*
*
* 2) Using a custom subscriber
*
*
* {@code
* software.amazon.awssdk.services.dynamodb.paginators.BatchGetItemPublisher publisher = client.batchGetItemPaginator(request);
* publisher.subscribe(new Subscriber() {
*
* public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
*
*
* public void onNext(software.amazon.awssdk.services.dynamodb.model.BatchGetItemResponse response) { //... };
* });}
*
*
* As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.
*
* Please notice that the configuration of null 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
* {@link #batchGetItem(software.amazon.awssdk.services.dynamodb.model.BatchGetItemRequest)} operation.
*
*
* This is a convenience which creates an instance of the {@link BatchGetItemRequest.Builder} avoiding the need to
* create one manually via {@link BatchGetItemRequest#builder()}
*
*
* @param batchGetItemRequest
* A {@link Consumer} that will call methods on {@link BatchGetItemInput.Builder} to create a request.
* Represents the input of a BatchGetItem operation.
* @return 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.
*
* - ProvisionedThroughputExceededException Your request rate is too high. The AWS SDKs for DynamoDB
* automatically retry requests that receive this exception. Your request is eventually successful, unless
* your retry queue is too large to finish. Reduce the frequency of requests and use exponential backoff.
* For more information, go to Error Retries and Exponential Backoff in the Amazon DynamoDB Developer Guide.
* - ResourceNotFoundException The operation tried to access a nonexistent table or index. The resource
* might not be specified correctly, or its status might not be
ACTIVE.
* - RequestLimitExceededException Throughput exceeds the current throughput quota for your account.
* Please contact AWS Support at AWS Support to request a quota
* increase.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.BatchGetItem
* @see AWS API
* Documentation
*/
default BatchGetItemPublisher batchGetItemPaginator(Consumer batchGetItemRequest) {
return batchGetItemPaginator(BatchGetItemRequest.builder().applyMutation(batchGetItemRequest).build());
}
/**
*
* The BatchWriteItem operation puts or deletes multiple items in one or more tables. A single call to
* BatchWriteItem can write up to 16 MB of data, which can comprise as many as 25 put or delete
* requests. Individual items to be written can be as large as 400 KB.
*
*
*
* BatchWriteItem cannot update items. To update items, use the UpdateItem action.
*
*
*
* The individual PutItem and DeleteItem operations specified in
* BatchWriteItem are atomic; however BatchWriteItem as a whole is not. If any requested
* operations fail because the table's provisioned throughput is exceeded or an internal processing failure occurs,
* the failed operations are returned in the UnprocessedItems response parameter. You can investigate
* and optionally resend the requests. Typically, you would call BatchWriteItem in a loop. Each
* iteration would check for unprocessed items and submit a new BatchWriteItem request with those
* unprocessed items until all items have been processed.
*
*
* If none of the items can be processed due to insufficient provisioned throughput on all of the tables in
* the request, then BatchWriteItem returns a ProvisionedThroughputExceededException.
*
*
*
* If DynamoDB returns any unprocessed items, you should retry the batch operation on those items. However, we
* strongly recommend that you use an exponential backoff algorithm. If you retry the batch operation
* immediately, the underlying read or write requests can still fail due to throttling on the individual tables. If
* you delay the batch operation using exponential backoff, the individual requests in the batch are much more
* likely to succeed.
*
*
* For more information, see Batch Operations and Error Handling in the Amazon DynamoDB Developer Guide.
*
*
*
* With BatchWriteItem, you can efficiently write or delete large amounts of data, such as from Amazon
* EMR, or copy data from another database into DynamoDB. In order to improve performance with these large-scale
* operations, BatchWriteItem does not behave in the same way as individual PutItem and
* DeleteItem calls would. For example, you cannot specify conditions on individual put and delete
* requests, and BatchWriteItem does not return deleted items in the response.
*
*
* If you use a programming language that supports concurrency, you can use threads to write items in parallel. Your
* application must include the necessary logic to manage the threads. With languages that don't support threading,
* you must update or delete the specified items one at a time. In both situations, BatchWriteItem
* performs the specified put and delete operations in parallel, giving you the power of the thread pool approach
* without having to introduce complexity into your application.
*
*
* Parallel processing reduces latency, but each specified put and delete request consumes the same number of write
* capacity units whether it is processed in parallel or not. Delete operations on nonexistent items consume one
* write capacity unit.
*
*
* If one or more of the following is true, DynamoDB rejects the entire batch write operation:
*
*
* -
*
* One or more tables specified in the BatchWriteItem request does not exist.
*
*
* -
*
* Primary key attributes specified on an item in the request do not match those in the corresponding table's
* primary key schema.
*
*
* -
*
* You try to perform multiple operations on the same item in the same BatchWriteItem request. For
* example, you cannot put and delete the same item in the same BatchWriteItem request.
*
*
* -
*
* Your request contains at least two items with identical hash and range keys (which essentially is two put
* operations).
*
*
* -
*
* There are more than 25 requests in the batch.
*
*
* -
*
* Any individual item in a batch exceeds 400 KB.
*
*
* -
*
* The total request size exceeds 16 MB.
*
*
*
*
* @param batchWriteItemRequest
* Represents the input of a BatchWriteItem operation.
* @return A Java Future containing the result of the BatchWriteItem operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ProvisionedThroughputExceededException Your request rate is too high. The AWS SDKs for DynamoDB
* automatically retry requests that receive this exception. Your request is eventually successful, unless
* your retry queue is too large to finish. Reduce the frequency of requests and use exponential backoff.
* For more information, go to Error Retries and Exponential Backoff in the Amazon DynamoDB Developer Guide.
* - ResourceNotFoundException The operation tried to access a nonexistent table or index. The resource
* might not be specified correctly, or its status might not be
ACTIVE.
* - ItemCollectionSizeLimitExceededException An item collection is too large. This exception is only
* returned for tables that have one or more local secondary indexes.
* - RequestLimitExceededException Throughput exceeds the current throughput quota for your account.
* Please contact AWS Support at AWS Support to request a quota
* increase.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.BatchWriteItem
* @see AWS API
* Documentation
*/
default CompletableFuture batchWriteItem(BatchWriteItemRequest batchWriteItemRequest) {
throw new UnsupportedOperationException();
}
/**
*
* The BatchWriteItem operation puts or deletes multiple items in one or more tables. A single call to
* BatchWriteItem can write up to 16 MB of data, which can comprise as many as 25 put or delete
* requests. Individual items to be written can be as large as 400 KB.
*
*
*
* BatchWriteItem cannot update items. To update items, use the UpdateItem action.
*
*
*
* The individual PutItem and DeleteItem operations specified in
* BatchWriteItem are atomic; however BatchWriteItem as a whole is not. If any requested
* operations fail because the table's provisioned throughput is exceeded or an internal processing failure occurs,
* the failed operations are returned in the UnprocessedItems response parameter. You can investigate
* and optionally resend the requests. Typically, you would call BatchWriteItem in a loop. Each
* iteration would check for unprocessed items and submit a new BatchWriteItem request with those
* unprocessed items until all items have been processed.
*
*
* If none of the items can be processed due to insufficient provisioned throughput on all of the tables in
* the request, then BatchWriteItem returns a ProvisionedThroughputExceededException.
*
*
*
* If DynamoDB returns any unprocessed items, you should retry the batch operation on those items. However, we
* strongly recommend that you use an exponential backoff algorithm. If you retry the batch operation
* immediately, the underlying read or write requests can still fail due to throttling on the individual tables. If
* you delay the batch operation using exponential backoff, the individual requests in the batch are much more
* likely to succeed.
*
*
* For more information, see Batch Operations and Error Handling in the Amazon DynamoDB Developer Guide.
*
*
*
* With BatchWriteItem, you can efficiently write or delete large amounts of data, such as from Amazon
* EMR, or copy data from another database into DynamoDB. In order to improve performance with these large-scale
* operations, BatchWriteItem does not behave in the same way as individual PutItem and
* DeleteItem calls would. For example, you cannot specify conditions on individual put and delete
* requests, and BatchWriteItem does not return deleted items in the response.
*
*
* If you use a programming language that supports concurrency, you can use threads to write items in parallel. Your
* application must include the necessary logic to manage the threads. With languages that don't support threading,
* you must update or delete the specified items one at a time. In both situations, BatchWriteItem
* performs the specified put and delete operations in parallel, giving you the power of the thread pool approach
* without having to introduce complexity into your application.
*
*
* Parallel processing reduces latency, but each specified put and delete request consumes the same number of write
* capacity units whether it is processed in parallel or not. Delete operations on nonexistent items consume one
* write capacity unit.
*
*
* If one or more of the following is true, DynamoDB rejects the entire batch write operation:
*
*
* -
*
* One or more tables specified in the BatchWriteItem request does not exist.
*
*
* -
*
* Primary key attributes specified on an item in the request do not match those in the corresponding table's
* primary key schema.
*
*
* -
*
* You try to perform multiple operations on the same item in the same BatchWriteItem request. For
* example, you cannot put and delete the same item in the same BatchWriteItem request.
*
*
* -
*
* Your request contains at least two items with identical hash and range keys (which essentially is two put
* operations).
*
*
* -
*
* There are more than 25 requests in the batch.
*
*
* -
*
* Any individual item in a batch exceeds 400 KB.
*
*
* -
*
* The total request size exceeds 16 MB.
*
*
*
*
*
* This is a convenience which creates an instance of the {@link BatchWriteItemRequest.Builder} avoiding the need to
* create one manually via {@link BatchWriteItemRequest#builder()}
*
*
* @param batchWriteItemRequest
* A {@link Consumer} that will call methods on {@link BatchWriteItemInput.Builder} to create a request.
* Represents the input of a BatchWriteItem operation.
* @return A Java Future containing the result of the BatchWriteItem operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ProvisionedThroughputExceededException Your request rate is too high. The AWS SDKs for DynamoDB
* automatically retry requests that receive this exception. Your request is eventually successful, unless
* your retry queue is too large to finish. Reduce the frequency of requests and use exponential backoff.
* For more information, go to Error Retries and Exponential Backoff in the Amazon DynamoDB Developer Guide.
* - ResourceNotFoundException The operation tried to access a nonexistent table or index. The resource
* might not be specified correctly, or its status might not be
ACTIVE.
* - ItemCollectionSizeLimitExceededException An item collection is too large. This exception is only
* returned for tables that have one or more local secondary indexes.
* - RequestLimitExceededException Throughput exceeds the current throughput quota for your account.
* Please contact AWS Support at AWS Support to request a quota
* increase.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.BatchWriteItem
* @see AWS API
* Documentation
*/
default CompletableFuture batchWriteItem(Consumer batchWriteItemRequest) {
return batchWriteItem(BatchWriteItemRequest.builder().applyMutation(batchWriteItemRequest).build());
}
/**
*
* Creates a backup for an existing table.
*
*
* Each time you create an on-demand backup, the entire table data is backed up. There is no limit to the number of
* on-demand backups that can be taken.
*
*
* When you create an on-demand backup, a time marker of the request is cataloged, and the backup is created
* asynchronously, by applying all changes until the time of the request to the last full table snapshot. Backup
* requests are processed instantaneously and become available for restore within minutes.
*
*
* You can call CreateBackup at a maximum rate of 50 times per second.
*
*
* All backups in DynamoDB work without consuming any provisioned throughput on the table.
*
*
* If you submit a backup request on 2018-12-14 at 14:25:00, the backup is guaranteed to contain all data committed
* to the table up to 14:24:00, and data committed after 14:26:00 will not be. The backup might contain data
* modifications made between 14:24:00 and 14:26:00. On-demand backup does not support causal consistency.
*
*
* Along with data, the following are also included on the backups:
*
*
* -
*
* Global secondary indexes (GSIs)
*
*
* -
*
* Local secondary indexes (LSIs)
*
*
* -
*
* Streams
*
*
* -
*
* Provisioned read and write capacity
*
*
*
*
* @param createBackupRequest
* @return A Java Future containing the result of the CreateBackup operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - TableNotFoundException A source table with the name
TableName does not currently exist
* within the subscriber's account.
* - TableInUseException A target table with the specified name is either being created or deleted.
* - ContinuousBackupsUnavailableException Backups have not yet been enabled for this table.
* - BackupInUseException There is another ongoing conflicting backup control plane operation on the
* table. The backup is either being created, deleted or restored to a table.
* - LimitExceededException There is no limit to the number of daily on-demand backups that can be taken.
*
*
* Up to 50 simultaneous table operations are allowed per account. These operations include
* CreateTable, UpdateTable, DeleteTable,
* UpdateTimeToLive, RestoreTableFromBackup, and
* RestoreTableToPointInTime.
*
*
* The only exception is when you are creating a table with one or more secondary indexes. You can have up
* to 25 such requests running at a time; however, if the table or index specifications are complex,
* DynamoDB might temporarily reduce the number of concurrent operations.
*
*
* There is a soft account quota of 256 tables.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.CreateBackup
* @see AWS API
* Documentation
*/
default CompletableFuture createBackup(CreateBackupRequest createBackupRequest) {
throw new UnsupportedOperationException();
}
/**
*
* Creates a backup for an existing table.
*
*
* Each time you create an on-demand backup, the entire table data is backed up. There is no limit to the number of
* on-demand backups that can be taken.
*
*
* When you create an on-demand backup, a time marker of the request is cataloged, and the backup is created
* asynchronously, by applying all changes until the time of the request to the last full table snapshot. Backup
* requests are processed instantaneously and become available for restore within minutes.
*
*
* You can call CreateBackup at a maximum rate of 50 times per second.
*
*
* All backups in DynamoDB work without consuming any provisioned throughput on the table.
*
*
* If you submit a backup request on 2018-12-14 at 14:25:00, the backup is guaranteed to contain all data committed
* to the table up to 14:24:00, and data committed after 14:26:00 will not be. The backup might contain data
* modifications made between 14:24:00 and 14:26:00. On-demand backup does not support causal consistency.
*
*
* Along with data, the following are also included on the backups:
*
*
* -
*
* Global secondary indexes (GSIs)
*
*
* -
*
* Local secondary indexes (LSIs)
*
*
* -
*
* Streams
*
*
* -
*
* Provisioned read and write capacity
*
*
*
*
*
* This is a convenience which creates an instance of the {@link CreateBackupRequest.Builder} avoiding the need to
* create one manually via {@link CreateBackupRequest#builder()}
*
*
* @param createBackupRequest
* A {@link Consumer} that will call methods on {@link CreateBackupInput.Builder} to create a request.
* @return A Java Future containing the result of the CreateBackup operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - TableNotFoundException A source table with the name
TableName does not currently exist
* within the subscriber's account.
* - TableInUseException A target table with the specified name is either being created or deleted.
* - ContinuousBackupsUnavailableException Backups have not yet been enabled for this table.
* - BackupInUseException There is another ongoing conflicting backup control plane operation on the
* table. The backup is either being created, deleted or restored to a table.
* - LimitExceededException There is no limit to the number of daily on-demand backups that can be taken.
*
*
* Up to 50 simultaneous table operations are allowed per account. These operations include
* CreateTable, UpdateTable, DeleteTable,
* UpdateTimeToLive, RestoreTableFromBackup, and
* RestoreTableToPointInTime.
*
*
* The only exception is when you are creating a table with one or more secondary indexes. You can have up
* to 25 such requests running at a time; however, if the table or index specifications are complex,
* DynamoDB might temporarily reduce the number of concurrent operations.
*
*
* There is a soft account quota of 256 tables.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.CreateBackup
* @see AWS API
* Documentation
*/
default CompletableFuture createBackup(Consumer createBackupRequest) {
return createBackup(CreateBackupRequest.builder().applyMutation(createBackupRequest).build());
}
/**
*
* Creates a global table from an existing table. A global table creates a replication relationship between two or
* more DynamoDB tables with the same table name in the provided Regions.
*
*
*
* This operation only applies to Version
* 2017.11.29 of global tables.
*
*
*
* If you want to add a new replica table to a global table, each of the following conditions must be true:
*
*
* -
*
* The table must have the same primary key as all of the other replicas.
*
*
* -
*
* The table must have the same name as all of the other replicas.
*
*
* -
*
* The table must have DynamoDB Streams enabled, with the stream containing both the new and the old images of the
* item.
*
*
* -
*
* None of the replica tables in the global table can contain any data.
*
*
*
*
* If global secondary indexes are specified, then the following conditions must also be met:
*
*
* -
*
* The global secondary indexes must have the same name.
*
*
* -
*
* The global secondary indexes must have the same hash key and sort key (if present).
*
*
*
*
* If local secondary indexes are specified, then the following conditions must also be met:
*
*
* -
*
* The local secondary indexes must have the same name.
*
*
* -
*
* The local secondary indexes must have the same hash key and sort key (if present).
*
*
*
*
*
* Write capacity settings should be set consistently across your replica tables and secondary indexes. DynamoDB
* strongly recommends enabling auto scaling to manage the write capacity settings for all of your global tables
* replicas and indexes.
*
*
* If you prefer to manage write capacity settings manually, you should provision equal replicated write capacity
* units to your replica tables. You should also provision equal replicated write capacity units to matching
* secondary indexes across your global table.
*
*
*
* @param createGlobalTableRequest
* @return A Java Future containing the result of the CreateGlobalTable operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - LimitExceededException There is no limit to the number of daily on-demand backups that can be taken.
*
*
* Up to 50 simultaneous table operations are allowed per account. These operations include
* CreateTable, UpdateTable, DeleteTable,
* UpdateTimeToLive, RestoreTableFromBackup, and
* RestoreTableToPointInTime.
*
*
* The only exception is when you are creating a table with one or more secondary indexes. You can have up
* to 25 such requests running at a time; however, if the table or index specifications are complex,
* DynamoDB might temporarily reduce the number of concurrent operations.
*
*
* There is a soft account quota of 256 tables.
* - InternalServerErrorException An error occurred on the server side.
* - GlobalTableAlreadyExistsException The specified global table already exists.
* - TableNotFoundException A source table with the name
TableName does not currently exist
* within the subscriber's account.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.CreateGlobalTable
* @see AWS API
* Documentation
*/
default CompletableFuture createGlobalTable(CreateGlobalTableRequest createGlobalTableRequest) {
throw new UnsupportedOperationException();
}
/**
*
* Creates a global table from an existing table. A global table creates a replication relationship between two or
* more DynamoDB tables with the same table name in the provided Regions.
*
*
*
* This operation only applies to Version
* 2017.11.29 of global tables.
*
*
*
* If you want to add a new replica table to a global table, each of the following conditions must be true:
*
*
* -
*
* The table must have the same primary key as all of the other replicas.
*
*
* -
*
* The table must have the same name as all of the other replicas.
*
*
* -
*
* The table must have DynamoDB Streams enabled, with the stream containing both the new and the old images of the
* item.
*
*
* -
*
* None of the replica tables in the global table can contain any data.
*
*
*
*
* If global secondary indexes are specified, then the following conditions must also be met:
*
*
* -
*
* The global secondary indexes must have the same name.
*
*
* -
*
* The global secondary indexes must have the same hash key and sort key (if present).
*
*
*
*
* If local secondary indexes are specified, then the following conditions must also be met:
*
*
* -
*
* The local secondary indexes must have the same name.
*
*
* -
*
* The local secondary indexes must have the same hash key and sort key (if present).
*
*
*
*
*
* Write capacity settings should be set consistently across your replica tables and secondary indexes. DynamoDB
* strongly recommends enabling auto scaling to manage the write capacity settings for all of your global tables
* replicas and indexes.
*
*
* If you prefer to manage write capacity settings manually, you should provision equal replicated write capacity
* units to your replica tables. You should also provision equal replicated write capacity units to matching
* secondary indexes across your global table.
*
*
*
* This is a convenience which creates an instance of the {@link CreateGlobalTableRequest.Builder} avoiding the need
* to create one manually via {@link CreateGlobalTableRequest#builder()}
*
*
* @param createGlobalTableRequest
* A {@link Consumer} that will call methods on {@link CreateGlobalTableInput.Builder} to create a request.
* @return A Java Future containing the result of the CreateGlobalTable operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - LimitExceededException There is no limit to the number of daily on-demand backups that can be taken.
*
*
* Up to 50 simultaneous table operations are allowed per account. These operations include
* CreateTable, UpdateTable, DeleteTable,
* UpdateTimeToLive, RestoreTableFromBackup, and
* RestoreTableToPointInTime.
*
*
* The only exception is when you are creating a table with one or more secondary indexes. You can have up
* to 25 such requests running at a time; however, if the table or index specifications are complex,
* DynamoDB might temporarily reduce the number of concurrent operations.
*
*
* There is a soft account quota of 256 tables.
* - InternalServerErrorException An error occurred on the server side.
* - GlobalTableAlreadyExistsException The specified global table already exists.
* - TableNotFoundException A source table with the name
TableName does not currently exist
* within the subscriber's account.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.CreateGlobalTable
* @see AWS API
* Documentation
*/
default CompletableFuture createGlobalTable(
Consumer createGlobalTableRequest) {
return createGlobalTable(CreateGlobalTableRequest.builder().applyMutation(createGlobalTableRequest).build());
}
/**
*
* The CreateTable operation adds a new table to your account. In an AWS account, table names must be
* unique within each Region. That is, you can have two tables with same name if you create the tables in different
* Regions.
*
*
* CreateTable is an asynchronous operation. Upon receiving a CreateTable request,
* DynamoDB immediately returns a response with a TableStatus of CREATING. After the table
* is created, DynamoDB sets the TableStatus to ACTIVE. You can perform read and write
* operations only on an ACTIVE table.
*
*
* You can optionally define secondary indexes on the new table, as part of the CreateTable operation.
* If you want to create multiple tables with secondary indexes on them, you must create the tables sequentially.
* Only one table with secondary indexes can be in the CREATING state at any given time.
*
*
* You can use the DescribeTable action to check the table status.
*
*
* @param createTableRequest
* Represents the input of a CreateTable operation.
* @return A Java Future containing the result of the CreateTable operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ResourceInUseException The operation conflicts with the resource's availability. For example, you
* attempted to recreate an existing table, or tried to delete a table currently in the
*
CREATING state.
* - LimitExceededException There is no limit to the number of daily on-demand backups that can be taken.
*
*
* Up to 50 simultaneous table operations are allowed per account. These operations include
* CreateTable, UpdateTable, DeleteTable,
* UpdateTimeToLive, RestoreTableFromBackup, and
* RestoreTableToPointInTime.
*
*
* The only exception is when you are creating a table with one or more secondary indexes. You can have up
* to 25 such requests running at a time; however, if the table or index specifications are complex,
* DynamoDB might temporarily reduce the number of concurrent operations.
*
*
* There is a soft account quota of 256 tables.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.CreateTable
* @see AWS API
* Documentation
*/
default CompletableFuture createTable(CreateTableRequest createTableRequest) {
throw new UnsupportedOperationException();
}
/**
*
* The CreateTable operation adds a new table to your account. In an AWS account, table names must be
* unique within each Region. That is, you can have two tables with same name if you create the tables in different
* Regions.
*
*
* CreateTable is an asynchronous operation. Upon receiving a CreateTable request,
* DynamoDB immediately returns a response with a TableStatus of CREATING. After the table
* is created, DynamoDB sets the TableStatus to ACTIVE. You can perform read and write
* operations only on an ACTIVE table.
*
*
* You can optionally define secondary indexes on the new table, as part of the CreateTable operation.
* If you want to create multiple tables with secondary indexes on them, you must create the tables sequentially.
* Only one table with secondary indexes can be in the CREATING state at any given time.
*
*
* You can use the DescribeTable action to check the table status.
*
*
*
* This is a convenience which creates an instance of the {@link CreateTableRequest.Builder} avoiding the need to
* create one manually via {@link CreateTableRequest#builder()}
*
*
* @param createTableRequest
* A {@link Consumer} that will call methods on {@link CreateTableInput.Builder} to create a request.
* Represents the input of a CreateTable operation.
* @return A Java Future containing the result of the CreateTable operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ResourceInUseException The operation conflicts with the resource's availability. For example, you
* attempted to recreate an existing table, or tried to delete a table currently in the
*
CREATING state.
* - LimitExceededException There is no limit to the number of daily on-demand backups that can be taken.
*
*
* Up to 50 simultaneous table operations are allowed per account. These operations include
* CreateTable, UpdateTable, DeleteTable,
* UpdateTimeToLive, RestoreTableFromBackup, and
* RestoreTableToPointInTime.
*
*
* The only exception is when you are creating a table with one or more secondary indexes. You can have up
* to 25 such requests running at a time; however, if the table or index specifications are complex,
* DynamoDB might temporarily reduce the number of concurrent operations.
*
*
* There is a soft account quota of 256 tables.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.CreateTable
* @see AWS API
* Documentation
*/
default CompletableFuture createTable(Consumer createTableRequest) {
return createTable(CreateTableRequest.builder().applyMutation(createTableRequest).build());
}
/**
*
* Deletes an existing backup of a table.
*
*
* You can call DeleteBackup at a maximum rate of 10 times per second.
*
*
* @param deleteBackupRequest
* @return A Java Future containing the result of the DeleteBackup operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - BackupNotFoundException Backup not found for the given BackupARN.
* - BackupInUseException There is another ongoing conflicting backup control plane operation on the
* table. The backup is either being created, deleted or restored to a table.
* - LimitExceededException There is no limit to the number of daily on-demand backups that can be taken.
*
*
* Up to 50 simultaneous table operations are allowed per account. These operations include
* CreateTable, UpdateTable, DeleteTable,
* UpdateTimeToLive, RestoreTableFromBackup, and
* RestoreTableToPointInTime.
*
*
* The only exception is when you are creating a table with one or more secondary indexes. You can have up
* to 25 such requests running at a time; however, if the table or index specifications are complex,
* DynamoDB might temporarily reduce the number of concurrent operations.
*
*
* There is a soft account quota of 256 tables.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.DeleteBackup
* @see AWS API
* Documentation
*/
default CompletableFuture deleteBackup(DeleteBackupRequest deleteBackupRequest) {
throw new UnsupportedOperationException();
}
/**
*
* Deletes an existing backup of a table.
*
*
* You can call DeleteBackup at a maximum rate of 10 times per second.
*
*
*
* This is a convenience which creates an instance of the {@link DeleteBackupRequest.Builder} avoiding the need to
* create one manually via {@link DeleteBackupRequest#builder()}
*
*
* @param deleteBackupRequest
* A {@link Consumer} that will call methods on {@link DeleteBackupInput.Builder} to create a request.
* @return A Java Future containing the result of the DeleteBackup operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - BackupNotFoundException Backup not found for the given BackupARN.
* - BackupInUseException There is another ongoing conflicting backup control plane operation on the
* table. The backup is either being created, deleted or restored to a table.
* - LimitExceededException There is no limit to the number of daily on-demand backups that can be taken.
*
*
* Up to 50 simultaneous table operations are allowed per account. These operations include
* CreateTable, UpdateTable, DeleteTable,
* UpdateTimeToLive, RestoreTableFromBackup, and
* RestoreTableToPointInTime.
*
*
* The only exception is when you are creating a table with one or more secondary indexes. You can have up
* to 25 such requests running at a time; however, if the table or index specifications are complex,
* DynamoDB might temporarily reduce the number of concurrent operations.
*
*
* There is a soft account quota of 256 tables.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.DeleteBackup
* @see AWS API
* Documentation
*/
default CompletableFuture deleteBackup(Consumer deleteBackupRequest) {
return deleteBackup(DeleteBackupRequest.builder().applyMutation(deleteBackupRequest).build());
}
/**
*
* Deletes a single item in a table by primary key. You can perform a conditional delete operation that deletes the
* item if it exists, or if it has an expected attribute value.
*
*
* In addition to deleting an item, you can also return the item's attribute values in the same operation, using the
* ReturnValues parameter.
*
*
* Unless you specify conditions, the DeleteItem is an idempotent operation; running it multiple times
* on the same item or attribute does not result in an error response.
*
*
* Conditional deletes are useful for deleting items only if specific conditions are met. If those conditions are
* met, DynamoDB performs the delete. Otherwise, the item is not deleted.
*
*
* @param deleteItemRequest
* Represents the input of a DeleteItem operation.
* @return A Java Future containing the result of the DeleteItem operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ConditionalCheckFailedException A condition specified in the operation could not be evaluated.
* - ProvisionedThroughputExceededException Your request rate is too high. The AWS SDKs for DynamoDB
* automatically retry requests that receive this exception. Your request is eventually successful, unless
* your retry queue is too large to finish. Reduce the frequency of requests and use exponential backoff.
* For more information, go to Error Retries and Exponential Backoff in the Amazon DynamoDB Developer Guide.
* - ResourceNotFoundException The operation tried to access a nonexistent table or index. The resource
* might not be specified correctly, or its status might not be
ACTIVE.
* - ItemCollectionSizeLimitExceededException An item collection is too large. This exception is only
* returned for tables that have one or more local secondary indexes.
* - TransactionConflictException Operation was rejected because there is an ongoing transaction for the
* item.
* - RequestLimitExceededException Throughput exceeds the current throughput quota for your account.
* Please contact AWS Support at AWS Support to request a quota
* increase.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.DeleteItem
* @see AWS API
* Documentation
*/
default CompletableFuture deleteItem(DeleteItemRequest deleteItemRequest) {
throw new UnsupportedOperationException();
}
/**
*
* Deletes a single item in a table by primary key. You can perform a conditional delete operation that deletes the
* item if it exists, or if it has an expected attribute value.
*
*
* In addition to deleting an item, you can also return the item's attribute values in the same operation, using the
* ReturnValues parameter.
*
*
* Unless you specify conditions, the DeleteItem is an idempotent operation; running it multiple times
* on the same item or attribute does not result in an error response.
*
*
* Conditional deletes are useful for deleting items only if specific conditions are met. If those conditions are
* met, DynamoDB performs the delete. Otherwise, the item is not deleted.
*
*
*
* This is a convenience which creates an instance of the {@link DeleteItemRequest.Builder} avoiding the need to
* create one manually via {@link DeleteItemRequest#builder()}
*
*
* @param deleteItemRequest
* A {@link Consumer} that will call methods on {@link DeleteItemInput.Builder} to create a request.
* Represents the input of a DeleteItem operation.
* @return A Java Future containing the result of the DeleteItem operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ConditionalCheckFailedException A condition specified in the operation could not be evaluated.
* - ProvisionedThroughputExceededException Your request rate is too high. The AWS SDKs for DynamoDB
* automatically retry requests that receive this exception. Your request is eventually successful, unless
* your retry queue is too large to finish. Reduce the frequency of requests and use exponential backoff.
* For more information, go to Error Retries and Exponential Backoff in the Amazon DynamoDB Developer Guide.
* - ResourceNotFoundException The operation tried to access a nonexistent table or index. The resource
* might not be specified correctly, or its status might not be
ACTIVE.
* - ItemCollectionSizeLimitExceededException An item collection is too large. This exception is only
* returned for tables that have one or more local secondary indexes.
* - TransactionConflictException Operation was rejected because there is an ongoing transaction for the
* item.
* - RequestLimitExceededException Throughput exceeds the current throughput quota for your account.
* Please contact AWS Support at AWS Support to request a quota
* increase.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.DeleteItem
* @see AWS API
* Documentation
*/
default CompletableFuture deleteItem(Consumer deleteItemRequest) {
return deleteItem(DeleteItemRequest.builder().applyMutation(deleteItemRequest).build());
}
/**
*
* The DeleteTable operation deletes a table and all of its items. After a DeleteTable
* request, the specified table is in the DELETING state until DynamoDB completes the deletion. If the
* table is in the ACTIVE state, you can delete it. If a table is in CREATING or
* UPDATING states, then DynamoDB returns a ResourceInUseException. If the specified table
* does not exist, DynamoDB returns a ResourceNotFoundException. If table is already in the
* DELETING state, no error is returned.
*
*
*
* DynamoDB might continue to accept data read and write operations, such as GetItem and
* PutItem, on a table in the DELETING state until the table deletion is complete.
*
*
*
* When you delete a table, any indexes on that table are also deleted.
*
*
* If you have DynamoDB Streams enabled on the table, then the corresponding stream on that table goes into the
* DISABLED state, and the stream is automatically deleted after 24 hours.
*
*
* Use the DescribeTable action to check the status of the table.
*
*
* @param deleteTableRequest
* Represents the input of a DeleteTable operation.
* @return A Java Future containing the result of the DeleteTable operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ResourceInUseException The operation conflicts with the resource's availability. For example, you
* attempted to recreate an existing table, or tried to delete a table currently in the
*
CREATING state.
* - ResourceNotFoundException The operation tried to access a nonexistent table or index. The resource
* might not be specified correctly, or its status might not be
ACTIVE.
* - LimitExceededException There is no limit to the number of daily on-demand backups that can be taken.
*
*
* Up to 50 simultaneous table operations are allowed per account. These operations include
* CreateTable, UpdateTable, DeleteTable,
* UpdateTimeToLive, RestoreTableFromBackup, and
* RestoreTableToPointInTime.
*
*
* The only exception is when you are creating a table with one or more secondary indexes. You can have up
* to 25 such requests running at a time; however, if the table or index specifications are complex,
* DynamoDB might temporarily reduce the number of concurrent operations.
*
*
* There is a soft account quota of 256 tables.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.DeleteTable
* @see AWS API
* Documentation
*/
default CompletableFuture deleteTable(DeleteTableRequest deleteTableRequest) {
throw new UnsupportedOperationException();
}
/**
*
* The DeleteTable operation deletes a table and all of its items. After a DeleteTable
* request, the specified table is in the DELETING state until DynamoDB completes the deletion. If the
* table is in the ACTIVE state, you can delete it. If a table is in CREATING or
* UPDATING states, then DynamoDB returns a ResourceInUseException. If the specified table
* does not exist, DynamoDB returns a ResourceNotFoundException. If table is already in the
* DELETING state, no error is returned.
*
*
*
* DynamoDB might continue to accept data read and write operations, such as GetItem and
* PutItem, on a table in the DELETING state until the table deletion is complete.
*
*
*
* When you delete a table, any indexes on that table are also deleted.
*
*
* If you have DynamoDB Streams enabled on the table, then the corresponding stream on that table goes into the
* DISABLED state, and the stream is automatically deleted after 24 hours.
*
*
* Use the DescribeTable action to check the status of the table.
*
*
*
* This is a convenience which creates an instance of the {@link DeleteTableRequest.Builder} avoiding the need to
* create one manually via {@link DeleteTableRequest#builder()}
*
*
* @param deleteTableRequest
* A {@link Consumer} that will call methods on {@link DeleteTableInput.Builder} to create a request.
* Represents the input of a DeleteTable operation.
* @return A Java Future containing the result of the DeleteTable operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ResourceInUseException The operation conflicts with the resource's availability. For example, you
* attempted to recreate an existing table, or tried to delete a table currently in the
*
CREATING state.
* - ResourceNotFoundException The operation tried to access a nonexistent table or index. The resource
* might not be specified correctly, or its status might not be
ACTIVE.
* - LimitExceededException There is no limit to the number of daily on-demand backups that can be taken.
*
*
* Up to 50 simultaneous table operations are allowed per account. These operations include
* CreateTable, UpdateTable, DeleteTable,
* UpdateTimeToLive, RestoreTableFromBackup, and
* RestoreTableToPointInTime.
*
*
* The only exception is when you are creating a table with one or more secondary indexes. You can have up
* to 25 such requests running at a time; however, if the table or index specifications are complex,
* DynamoDB might temporarily reduce the number of concurrent operations.
*
*
* There is a soft account quota of 256 tables.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.DeleteTable
* @see AWS API
* Documentation
*/
default CompletableFuture deleteTable(Consumer deleteTableRequest) {
return deleteTable(DeleteTableRequest.builder().applyMutation(deleteTableRequest).build());
}
/**
*
* Describes an existing backup of a table.
*
*
* You can call DescribeBackup at a maximum rate of 10 times per second.
*
*
* @param describeBackupRequest
* @return A Java Future containing the result of the DescribeBackup operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - BackupNotFoundException Backup not found for the given BackupARN.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.DescribeBackup
* @see AWS API
* Documentation
*/
default CompletableFuture describeBackup(DescribeBackupRequest describeBackupRequest) {
throw new UnsupportedOperationException();
}
/**
*
* Describes an existing backup of a table.
*
*
* You can call DescribeBackup at a maximum rate of 10 times per second.
*
*
*
* This is a convenience which creates an instance of the {@link DescribeBackupRequest.Builder} avoiding the need to
* create one manually via {@link DescribeBackupRequest#builder()}
*
*
* @param describeBackupRequest
* A {@link Consumer} that will call methods on {@link DescribeBackupInput.Builder} to create a request.
* @return A Java Future containing the result of the DescribeBackup operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - BackupNotFoundException Backup not found for the given BackupARN.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.DescribeBackup
* @see AWS API
* Documentation
*/
default CompletableFuture describeBackup(Consumer describeBackupRequest) {
return describeBackup(DescribeBackupRequest.builder().applyMutation(describeBackupRequest).build());
}
/**
*
* Checks the status of continuous backups and point in time recovery on the specified table. Continuous backups are
* ENABLED on all tables at table creation. If point in time recovery is enabled,
* PointInTimeRecoveryStatus will be set to ENABLED.
*
*
* After continuous backups and point in time recovery are enabled, you can restore to any point in time within
* EarliestRestorableDateTime and LatestRestorableDateTime.
*
*
* LatestRestorableDateTime is typically 5 minutes before the current time. You can restore your table
* to any point in time during the last 35 days.
*
*
* You can call DescribeContinuousBackups at a maximum rate of 10 times per second.
*
*
* @param describeContinuousBackupsRequest
* @return A Java Future containing the result of the DescribeContinuousBackups operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - TableNotFoundException A source table with the name
TableName does not currently exist
* within the subscriber's account.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.DescribeContinuousBackups
* @see AWS API Documentation
*/
default CompletableFuture describeContinuousBackups(
DescribeContinuousBackupsRequest describeContinuousBackupsRequest) {
throw new UnsupportedOperationException();
}
/**
*
* Checks the status of continuous backups and point in time recovery on the specified table. Continuous backups are
* ENABLED on all tables at table creation. If point in time recovery is enabled,
* PointInTimeRecoveryStatus will be set to ENABLED.
*
*
* After continuous backups and point in time recovery are enabled, you can restore to any point in time within
* EarliestRestorableDateTime and LatestRestorableDateTime.
*
*
* LatestRestorableDateTime is typically 5 minutes before the current time. You can restore your table
* to any point in time during the last 35 days.
*
*
* You can call DescribeContinuousBackups at a maximum rate of 10 times per second.
*
*
*
* This is a convenience which creates an instance of the {@link DescribeContinuousBackupsRequest.Builder} avoiding
* the need to create one manually via {@link DescribeContinuousBackupsRequest#builder()}
*
*
* @param describeContinuousBackupsRequest
* A {@link Consumer} that will call methods on {@link DescribeContinuousBackupsInput.Builder} to create a
* request.
* @return A Java Future containing the result of the DescribeContinuousBackups operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - TableNotFoundException A source table with the name
TableName does not currently exist
* within the subscriber's account.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.DescribeContinuousBackups
* @see AWS API Documentation
*/
default CompletableFuture describeContinuousBackups(
Consumer describeContinuousBackupsRequest) {
return describeContinuousBackups(DescribeContinuousBackupsRequest.builder()
.applyMutation(describeContinuousBackupsRequest).build());
}
/**
*
* Returns information about contributor insights, for a given table or global secondary index.
*
*
* @param describeContributorInsightsRequest
* @return A Java Future containing the result of the DescribeContributorInsights operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ResourceNotFoundException The operation tried to access a nonexistent table or index. The resource
* might not be specified correctly, or its status might not be
ACTIVE.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.DescribeContributorInsights
* @see AWS API Documentation
*/
default CompletableFuture describeContributorInsights(
DescribeContributorInsightsRequest describeContributorInsightsRequest) {
throw new UnsupportedOperationException();
}
/**
*
* Returns information about contributor insights, for a given table or global secondary index.
*
*
*
* This is a convenience which creates an instance of the {@link DescribeContributorInsightsRequest.Builder}
* avoiding the need to create one manually via {@link DescribeContributorInsightsRequest#builder()}
*
*
* @param describeContributorInsightsRequest
* A {@link Consumer} that will call methods on {@link DescribeContributorInsightsInput.Builder} to create a
* request.
* @return A Java Future containing the result of the DescribeContributorInsights operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ResourceNotFoundException The operation tried to access a nonexistent table or index. The resource
* might not be specified correctly, or its status might not be
ACTIVE.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.DescribeContributorInsights
* @see AWS API Documentation
*/
default CompletableFuture describeContributorInsights(
Consumer describeContributorInsightsRequest) {
return describeContributorInsights(DescribeContributorInsightsRequest.builder()
.applyMutation(describeContributorInsightsRequest).build());
}
/**
*
* Returns the regional endpoint information.
*
*
* @param describeEndpointsRequest
* @return A Java Future containing the result of the DescribeEndpoints operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.DescribeEndpoints
* @see AWS API
* Documentation
*/
default CompletableFuture describeEndpoints(DescribeEndpointsRequest describeEndpointsRequest) {
throw new UnsupportedOperationException();
}
/**
*
* Returns the regional endpoint information.
*
*
*
* This is a convenience which creates an instance of the {@link DescribeEndpointsRequest.Builder} avoiding the need
* to create one manually via {@link DescribeEndpointsRequest#builder()}
*
*
* @param describeEndpointsRequest
* A {@link Consumer} that will call methods on {@link DescribeEndpointsRequest.Builder} to create a request.
* @return A Java Future containing the result of the DescribeEndpoints operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.DescribeEndpoints
* @see AWS API
* Documentation
*/
default CompletableFuture describeEndpoints(
Consumer describeEndpointsRequest) {
return describeEndpoints(DescribeEndpointsRequest.builder().applyMutation(describeEndpointsRequest).build());
}
/**
*
* Returns the regional endpoint information.
*
*
* @return A Java Future containing the result of the DescribeEndpoints operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.DescribeEndpoints
* @see AWS API
* Documentation
*/
default CompletableFuture describeEndpoints() {
return describeEndpoints(DescribeEndpointsRequest.builder().build());
}
/**
*
* Describes an existing table export.
*
*
* @param describeExportRequest
* @return A Java Future containing the result of the DescribeExport operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ExportNotFoundException The specified export was not found.
* - LimitExceededException There is no limit to the number of daily on-demand backups that can be taken.
*
*
* Up to 50 simultaneous table operations are allowed per account. These operations include
* CreateTable, UpdateTable, DeleteTable,
* UpdateTimeToLive, RestoreTableFromBackup, and
* RestoreTableToPointInTime.
*
*
* The only exception is when you are creating a table with one or more secondary indexes. You can have up
* to 25 such requests running at a time; however, if the table or index specifications are complex,
* DynamoDB might temporarily reduce the number of concurrent operations.
*
*
* There is a soft account quota of 256 tables.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.DescribeExport
* @see AWS API
* Documentation
*/
default CompletableFuture describeExport(DescribeExportRequest describeExportRequest) {
throw new UnsupportedOperationException();
}
/**
*
* Describes an existing table export.
*
*
*
* This is a convenience which creates an instance of the {@link DescribeExportRequest.Builder} avoiding the need to
* create one manually via {@link DescribeExportRequest#builder()}
*
*
* @param describeExportRequest
* A {@link Consumer} that will call methods on {@link DescribeExportInput.Builder} to create a request.
* @return A Java Future containing the result of the DescribeExport operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ExportNotFoundException The specified export was not found.
* - LimitExceededException There is no limit to the number of daily on-demand backups that can be taken.
*
*
* Up to 50 simultaneous table operations are allowed per account. These operations include
* CreateTable, UpdateTable, DeleteTable,
* UpdateTimeToLive, RestoreTableFromBackup, and
* RestoreTableToPointInTime.
*
*
* The only exception is when you are creating a table with one or more secondary indexes. You can have up
* to 25 such requests running at a time; however, if the table or index specifications are complex,
* DynamoDB might temporarily reduce the number of concurrent operations.
*
*
* There is a soft account quota of 256 tables.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.DescribeExport
* @see AWS API
* Documentation
*/
default CompletableFuture describeExport(Consumer describeExportRequest) {
return describeExport(DescribeExportRequest.builder().applyMutation(describeExportRequest).build());
}
/**
*
* Returns information about the specified global table.
*
*
*
* This operation only applies to Version
* 2017.11.29 of global tables. If you are using global tables Version
* 2019.11.21 you can use DescribeTable
* instead.
*
*
*
* @param describeGlobalTableRequest
* @return A Java Future containing the result of the DescribeGlobalTable operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - InternalServerErrorException An error occurred on the server side.
* - GlobalTableNotFoundException The specified global table 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.DescribeGlobalTable
* @see AWS
* API Documentation
*/
default CompletableFuture describeGlobalTable(
DescribeGlobalTableRequest describeGlobalTableRequest) {
throw new UnsupportedOperationException();
}
/**
*
* Returns information about the specified global table.
*
*
*
* This operation only applies to Version
* 2017.11.29 of global tables. If you are using global tables Version
* 2019.11.21 you can use DescribeTable
* instead.
*
*
*
* This is a convenience which creates an instance of the {@link DescribeGlobalTableRequest.Builder} avoiding the
* need to create one manually via {@link DescribeGlobalTableRequest#builder()}
*
*
* @param describeGlobalTableRequest
* A {@link Consumer} that will call methods on {@link DescribeGlobalTableInput.Builder} to create a request.
* @return A Java Future containing the result of the DescribeGlobalTable operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - InternalServerErrorException An error occurred on the server side.
* - GlobalTableNotFoundException The specified global table 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.DescribeGlobalTable
* @see AWS
* API Documentation
*/
default CompletableFuture describeGlobalTable(
Consumer describeGlobalTableRequest) {
return describeGlobalTable(DescribeGlobalTableRequest.builder().applyMutation(describeGlobalTableRequest).build());
}
/**
*
* Describes Region-specific settings for a global table.
*
*
*
* This operation only applies to Version
* 2017.11.29 of global tables.
*
*
*
* @param describeGlobalTableSettingsRequest
* @return A Java Future containing the result of the DescribeGlobalTableSettings operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - GlobalTableNotFoundException The specified global table does not exist.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.DescribeGlobalTableSettings
* @see AWS API Documentation
*/
default CompletableFuture describeGlobalTableSettings(
DescribeGlobalTableSettingsRequest describeGlobalTableSettingsRequest) {
throw new UnsupportedOperationException();
}
/**
*
* Describes Region-specific settings for a global table.
*
*
*
* This operation only applies to Version
* 2017.11.29 of global tables.
*
*
*
* This is a convenience which creates an instance of the {@link DescribeGlobalTableSettingsRequest.Builder}
* avoiding the need to create one manually via {@link DescribeGlobalTableSettingsRequest#builder()}
*
*
* @param describeGlobalTableSettingsRequest
* A {@link Consumer} that will call methods on {@link DescribeGlobalTableSettingsInput.Builder} to create a
* request.
* @return A Java Future containing the result of the DescribeGlobalTableSettings operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - GlobalTableNotFoundException The specified global table does not exist.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.DescribeGlobalTableSettings
* @see AWS API Documentation
*/
default CompletableFuture describeGlobalTableSettings(
Consumer describeGlobalTableSettingsRequest) {
return describeGlobalTableSettings(DescribeGlobalTableSettingsRequest.builder()
.applyMutation(describeGlobalTableSettingsRequest).build());
}
/**
*
* Returns information about the status of Kinesis streaming.
*
*
* @param describeKinesisStreamingDestinationRequest
* @return A Java Future containing the result of the DescribeKinesisStreamingDestination operation returned by the
* service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ResourceNotFoundException The operation tried to access a nonexistent table or index. The resource
* might not be specified correctly, or its status might not be
ACTIVE.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.DescribeKinesisStreamingDestination
* @see AWS API Documentation
*/
default CompletableFuture describeKinesisStreamingDestination(
DescribeKinesisStreamingDestinationRequest describeKinesisStreamingDestinationRequest) {
throw new UnsupportedOperationException();
}
/**
*
* Returns information about the status of Kinesis streaming.
*
*
*
* This is a convenience which creates an instance of the {@link DescribeKinesisStreamingDestinationRequest.Builder}
* avoiding the need to create one manually via {@link DescribeKinesisStreamingDestinationRequest#builder()}
*
*
* @param describeKinesisStreamingDestinationRequest
* A {@link Consumer} that will call methods on {@link DescribeKinesisStreamingDestinationInput.Builder} to
* create a request.
* @return A Java Future containing the result of the DescribeKinesisStreamingDestination operation returned by the
* service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ResourceNotFoundException The operation tried to access a nonexistent table or index. The resource
* might not be specified correctly, or its status might not be
ACTIVE.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.DescribeKinesisStreamingDestination
* @see AWS API Documentation
*/
default CompletableFuture describeKinesisStreamingDestination(
Consumer describeKinesisStreamingDestinationRequest) {
return describeKinesisStreamingDestination(DescribeKinesisStreamingDestinationRequest.builder()
.applyMutation(describeKinesisStreamingDestinationRequest).build());
}
/**
*
* Returns the current provisioned-capacity quotas for your AWS account in a Region, both for the Region as a whole
* and for any one DynamoDB table that you create there.
*
*
* When you establish an AWS account, the account has initial quotas on the maximum read capacity units and write
* capacity units that you can provision across all of your DynamoDB tables in a given Region. Also, there are
* per-table quotas that apply when you create a table there. For more information, see Service, Account, and Table
* Quotas page in the Amazon DynamoDB Developer Guide.
*
*
* Although you can increase these quotas by filing a case at AWS Support Center, obtaining the increase is not
* instantaneous. The DescribeLimits action lets you write code to compare the capacity you are
* currently using to those quotas imposed by your account so that you have enough time to apply for an increase
* before you hit a quota.
*
*
* For example, you could use one of the AWS SDKs to do the following:
*
*
* -
*
* Call DescribeLimits for a particular Region to obtain your current account quotas on provisioned
* capacity there.
*
*
* -
*
* Create a variable to hold the aggregate read capacity units provisioned for all your tables in that Region, and
* one to hold the aggregate write capacity units. Zero them both.
*
*
* -
*
* Call ListTables to obtain a list of all your DynamoDB tables.
*
*
* -
*
* For each table name listed by ListTables, do the following:
*
*
* -
*
* Call DescribeTable with the table name.
*
*
* -
*
* Use the data returned by DescribeTable to add the read capacity units and write capacity units
* provisioned for the table itself to your variables.
*
*
* -
*
* If the table has one or more global secondary indexes (GSIs), loop over these GSIs and add their provisioned
* capacity values to your variables as well.
*
*
*
*
* -
*
* Report the account quotas for that Region returned by DescribeLimits, along with the total current
* provisioned capacity levels you have calculated.
*
*
*
*
* This will let you see whether you are getting close to your account-level quotas.
*
*
* The per-table quotas apply only when you are creating a new table. They restrict the sum of the provisioned
* capacity of the new table itself and all its global secondary indexes.
*
*
* For existing tables and their GSIs, DynamoDB doesn't let you increase provisioned capacity extremely rapidly, but
* the only quota that applies is that the aggregate provisioned capacity over all your tables and GSIs cannot
* exceed either of the per-account quotas.
*
*
*
* DescribeLimits should only be called periodically. You can expect throttling errors if you call it
* more than once in a minute.
*
*
*
* The DescribeLimits Request element has no content.
*
*
* @param describeLimitsRequest
* Represents the input of a DescribeLimits operation. Has no content.
* @return A Java Future containing the result of the DescribeLimits operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.DescribeLimits
* @see AWS API
* Documentation
*/
default CompletableFuture describeLimits(DescribeLimitsRequest describeLimitsRequest) {
throw new UnsupportedOperationException();
}
/**
*
* Returns the current provisioned-capacity quotas for your AWS account in a Region, both for the Region as a whole
* and for any one DynamoDB table that you create there.
*
*
* When you establish an AWS account, the account has initial quotas on the maximum read capacity units and write
* capacity units that you can provision across all of your DynamoDB tables in a given Region. Also, there are
* per-table quotas that apply when you create a table there. For more information, see Service, Account, and Table
* Quotas page in the Amazon DynamoDB Developer Guide.
*
*
* Although you can increase these quotas by filing a case at AWS Support Center, obtaining the increase is not
* instantaneous. The DescribeLimits action lets you write code to compare the capacity you are
* currently using to those quotas imposed by your account so that you have enough time to apply for an increase
* before you hit a quota.
*
*
* For example, you could use one of the AWS SDKs to do the following:
*
*
* -
*
* Call DescribeLimits for a particular Region to obtain your current account quotas on provisioned
* capacity there.
*
*
* -
*
* Create a variable to hold the aggregate read capacity units provisioned for all your tables in that Region, and
* one to hold the aggregate write capacity units. Zero them both.
*
*
* -
*
* Call ListTables to obtain a list of all your DynamoDB tables.
*
*
* -
*
* For each table name listed by ListTables, do the following:
*
*
* -
*
* Call DescribeTable with the table name.
*
*
* -
*
* Use the data returned by DescribeTable to add the read capacity units and write capacity units
* provisioned for the table itself to your variables.
*
*
* -
*
* If the table has one or more global secondary indexes (GSIs), loop over these GSIs and add their provisioned
* capacity values to your variables as well.
*
*
*
*
* -
*
* Report the account quotas for that Region returned by DescribeLimits, along with the total current
* provisioned capacity levels you have calculated.
*
*
*
*
* This will let you see whether you are getting close to your account-level quotas.
*
*
* The per-table quotas apply only when you are creating a new table. They restrict the sum of the provisioned
* capacity of the new table itself and all its global secondary indexes.
*
*
* For existing tables and their GSIs, DynamoDB doesn't let you increase provisioned capacity extremely rapidly, but
* the only quota that applies is that the aggregate provisioned capacity over all your tables and GSIs cannot
* exceed either of the per-account quotas.
*
*
*
* DescribeLimits should only be called periodically. You can expect throttling errors if you call it
* more than once in a minute.
*
*
*
* The DescribeLimits Request element has no content.
*
*
*
* This is a convenience which creates an instance of the {@link DescribeLimitsRequest.Builder} avoiding the need to
* create one manually via {@link DescribeLimitsRequest#builder()}
*
*
* @param describeLimitsRequest
* A {@link Consumer} that will call methods on {@link DescribeLimitsInput.Builder} to create a request.
* Represents the input of a DescribeLimits operation. Has no content.
* @return A Java Future containing the result of the DescribeLimits operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.DescribeLimits
* @see AWS API
* Documentation
*/
default CompletableFuture describeLimits(Consumer describeLimitsRequest) {
return describeLimits(DescribeLimitsRequest.builder().applyMutation(describeLimitsRequest).build());
}
/**
*
* Returns the current provisioned-capacity quotas for your AWS account in a Region, both for the Region as a whole
* and for any one DynamoDB table that you create there.
*
*
* When you establish an AWS account, the account has initial quotas on the maximum read capacity units and write
* capacity units that you can provision across all of your DynamoDB tables in a given Region. Also, there are
* per-table quotas that apply when you create a table there. For more information, see Service, Account, and Table
* Quotas page in the Amazon DynamoDB Developer Guide.
*
*
* Although you can increase these quotas by filing a case at AWS Support Center, obtaining the increase is not
* instantaneous. The DescribeLimits action lets you write code to compare the capacity you are
* currently using to those quotas imposed by your account so that you have enough time to apply for an increase
* before you hit a quota.
*
*
* For example, you could use one of the AWS SDKs to do the following:
*
*
* -
*
* Call DescribeLimits for a particular Region to obtain your current account quotas on provisioned
* capacity there.
*
*
* -
*
* Create a variable to hold the aggregate read capacity units provisioned for all your tables in that Region, and
* one to hold the aggregate write capacity units. Zero them both.
*
*
* -
*
* Call ListTables to obtain a list of all your DynamoDB tables.
*
*
* -
*
* For each table name listed by ListTables, do the following:
*
*
* -
*
* Call DescribeTable with the table name.
*
*
* -
*
* Use the data returned by DescribeTable to add the read capacity units and write capacity units
* provisioned for the table itself to your variables.
*
*
* -
*
* If the table has one or more global secondary indexes (GSIs), loop over these GSIs and add their provisioned
* capacity values to your variables as well.
*
*
*
*
* -
*
* Report the account quotas for that Region returned by DescribeLimits, along with the total current
* provisioned capacity levels you have calculated.
*
*
*
*
* This will let you see whether you are getting close to your account-level quotas.
*
*
* The per-table quotas apply only when you are creating a new table. They restrict the sum of the provisioned
* capacity of the new table itself and all its global secondary indexes.
*
*
* For existing tables and their GSIs, DynamoDB doesn't let you increase provisioned capacity extremely rapidly, but
* the only quota that applies is that the aggregate provisioned capacity over all your tables and GSIs cannot
* exceed either of the per-account quotas.
*
*
*
* DescribeLimits should only be called periodically. You can expect throttling errors if you call it
* more than once in a minute.
*
*
*
* The DescribeLimits Request element has no content.
*
*
* @return A Java Future containing the result of the DescribeLimits operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.DescribeLimits
* @see AWS API
* Documentation
*/
default CompletableFuture describeLimits() {
return describeLimits(DescribeLimitsRequest.builder().build());
}
/**
*
* Returns information about the table, including the current status of the table, when it was created, the primary
* key schema, and any indexes on the table.
*
*
*
* If you issue a DescribeTable request immediately after a CreateTable request, DynamoDB
* might return a ResourceNotFoundException. This is because DescribeTable uses an
* eventually consistent query, and the metadata for your table might not be available at that moment. Wait for a
* few seconds, and then try the DescribeTable request again.
*
*
*
* @param describeTableRequest
* Represents the input of a DescribeTable operation.
* @return A Java Future containing the result of the DescribeTable operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ResourceNotFoundException The operation tried to access a nonexistent table or index. The resource
* might not be specified correctly, or its status might not be
ACTIVE.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.DescribeTable
* @see AWS API
* Documentation
*/
default CompletableFuture describeTable(DescribeTableRequest describeTableRequest) {
throw new UnsupportedOperationException();
}
/**
*
* Returns information about the table, including the current status of the table, when it was created, the primary
* key schema, and any indexes on the table.
*
*
*
* If you issue a DescribeTable request immediately after a CreateTable request, DynamoDB
* might return a ResourceNotFoundException. This is because DescribeTable uses an
* eventually consistent query, and the metadata for your table might not be available at that moment. Wait for a
* few seconds, and then try the DescribeTable request again.
*
*
*
* This is a convenience which creates an instance of the {@link DescribeTableRequest.Builder} avoiding the need to
* create one manually via {@link DescribeTableRequest#builder()}
*
*
* @param describeTableRequest
* A {@link Consumer} that will call methods on {@link DescribeTableInput.Builder} to create a request.
* Represents the input of a DescribeTable operation.
* @return A Java Future containing the result of the DescribeTable operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ResourceNotFoundException The operation tried to access a nonexistent table or index. The resource
* might not be specified correctly, or its status might not be
ACTIVE.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.DescribeTable
* @see AWS API
* Documentation
*/
default CompletableFuture describeTable(Consumer describeTableRequest) {
return describeTable(DescribeTableRequest.builder().applyMutation(describeTableRequest).build());
}
/**
*
* Describes auto scaling settings across replicas of the global table at once.
*
*
*
* This operation only applies to Version
* 2019.11.21 of global tables.
*
*
*
* @param describeTableReplicaAutoScalingRequest
* @return A Java Future containing the result of the DescribeTableReplicaAutoScaling operation returned by the
* service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ResourceNotFoundException The operation tried to access a nonexistent table or index. The resource
* might not be specified correctly, or its status might not be
ACTIVE.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.DescribeTableReplicaAutoScaling
* @see AWS API Documentation
*/
default CompletableFuture describeTableReplicaAutoScaling(
DescribeTableReplicaAutoScalingRequest describeTableReplicaAutoScalingRequest) {
throw new UnsupportedOperationException();
}
/**
*
* Describes auto scaling settings across replicas of the global table at once.
*
*
*
* This operation only applies to Version
* 2019.11.21 of global tables.
*
*
*
* This is a convenience which creates an instance of the {@link DescribeTableReplicaAutoScalingRequest.Builder}
* avoiding the need to create one manually via {@link DescribeTableReplicaAutoScalingRequest#builder()}
*
*
* @param describeTableReplicaAutoScalingRequest
* A {@link Consumer} that will call methods on {@link DescribeTableReplicaAutoScalingInput.Builder} to
* create a request.
* @return A Java Future containing the result of the DescribeTableReplicaAutoScaling operation returned by the
* service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ResourceNotFoundException The operation tried to access a nonexistent table or index. The resource
* might not be specified correctly, or its status might not be
ACTIVE.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.DescribeTableReplicaAutoScaling
* @see AWS API Documentation
*/
default CompletableFuture describeTableReplicaAutoScaling(
Consumer describeTableReplicaAutoScalingRequest) {
return describeTableReplicaAutoScaling(DescribeTableReplicaAutoScalingRequest.builder()
.applyMutation(describeTableReplicaAutoScalingRequest).build());
}
/**
*
* Gives a description of the Time to Live (TTL) status on the specified table.
*
*
* @param describeTimeToLiveRequest
* @return A Java Future containing the result of the DescribeTimeToLive operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ResourceNotFoundException The operation tried to access a nonexistent table or index. The resource
* might not be specified correctly, or its status might not be
ACTIVE.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.DescribeTimeToLive
* @see AWS
* API Documentation
*/
default CompletableFuture describeTimeToLive(DescribeTimeToLiveRequest describeTimeToLiveRequest) {
throw new UnsupportedOperationException();
}
/**
*
* Gives a description of the Time to Live (TTL) status on the specified table.
*
*
*
* This is a convenience which creates an instance of the {@link DescribeTimeToLiveRequest.Builder} avoiding the
* need to create one manually via {@link DescribeTimeToLiveRequest#builder()}
*
*
* @param describeTimeToLiveRequest
* A {@link Consumer} that will call methods on {@link DescribeTimeToLiveInput.Builder} to create a request.
* @return A Java Future containing the result of the DescribeTimeToLive operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ResourceNotFoundException The operation tried to access a nonexistent table or index. The resource
* might not be specified correctly, or its status might not be
ACTIVE.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.DescribeTimeToLive
* @see AWS
* API Documentation
*/
default CompletableFuture describeTimeToLive(
Consumer describeTimeToLiveRequest) {
return describeTimeToLive(DescribeTimeToLiveRequest.builder().applyMutation(describeTimeToLiveRequest).build());
}
/**
*
* Stops replication from the DynamoDB table to the Kinesis data stream. This is done without deleting either of the
* resources.
*
*
* @param disableKinesisStreamingDestinationRequest
* @return A Java Future containing the result of the DisableKinesisStreamingDestination operation returned by the
* service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - InternalServerErrorException An error occurred on the server side.
* - LimitExceededException There is no limit to the number of daily on-demand backups that can be taken.
*
*
* Up to 50 simultaneous table operations are allowed per account. These operations include
* CreateTable, UpdateTable, DeleteTable,
* UpdateTimeToLive, RestoreTableFromBackup, and
* RestoreTableToPointInTime.
*
*
* The only exception is when you are creating a table with one or more secondary indexes. You can have up
* to 25 such requests running at a time; however, if the table or index specifications are complex,
* DynamoDB might temporarily reduce the number of concurrent operations.
*
*
* There is a soft account quota of 256 tables.
* - ResourceInUseException The operation conflicts with the resource's availability. For example, you
* attempted to recreate an existing table, or tried to delete a table currently in the
*
CREATING state.
* - ResourceNotFoundException The operation tried to access a nonexistent table or index. The resource
* might not be specified correctly, or its status might not be
ACTIVE.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.DisableKinesisStreamingDestination
* @see AWS API Documentation
*/
default CompletableFuture disableKinesisStreamingDestination(
DisableKinesisStreamingDestinationRequest disableKinesisStreamingDestinationRequest) {
throw new UnsupportedOperationException();
}
/**
*
* Stops replication from the DynamoDB table to the Kinesis data stream. This is done without deleting either of the
* resources.
*
*
*
* This is a convenience which creates an instance of the {@link DisableKinesisStreamingDestinationRequest.Builder}
* avoiding the need to create one manually via {@link DisableKinesisStreamingDestinationRequest#builder()}
*
*
* @param disableKinesisStreamingDestinationRequest
* A {@link Consumer} that will call methods on {@link KinesisStreamingDestinationInput.Builder} to create a
* request.
* @return A Java Future containing the result of the DisableKinesisStreamingDestination operation returned by the
* service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - InternalServerErrorException An error occurred on the server side.
* - LimitExceededException There is no limit to the number of daily on-demand backups that can be taken.
*
*
* Up to 50 simultaneous table operations are allowed per account. These operations include
* CreateTable, UpdateTable, DeleteTable,
* UpdateTimeToLive, RestoreTableFromBackup, and
* RestoreTableToPointInTime.
*
*
* The only exception is when you are creating a table with one or more secondary indexes. You can have up
* to 25 such requests running at a time; however, if the table or index specifications are complex,
* DynamoDB might temporarily reduce the number of concurrent operations.
*
*
* There is a soft account quota of 256 tables.
* - ResourceInUseException The operation conflicts with the resource's availability. For example, you
* attempted to recreate an existing table, or tried to delete a table currently in the
*
CREATING state.
* - ResourceNotFoundException The operation tried to access a nonexistent table or index. The resource
* might not be specified correctly, or its status might not be
ACTIVE.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.DisableKinesisStreamingDestination
* @see AWS API Documentation
*/
default CompletableFuture disableKinesisStreamingDestination(
Consumer disableKinesisStreamingDestinationRequest) {
return disableKinesisStreamingDestination(DisableKinesisStreamingDestinationRequest.builder()
.applyMutation(disableKinesisStreamingDestinationRequest).build());
}
/**
*
* Starts table data replication to the specified Kinesis data stream at a timestamp chosen during the enable
* workflow. If this operation doesn't return results immediately, use DescribeKinesisStreamingDestination to check
* if streaming to the Kinesis data stream is ACTIVE.
*
*
* @param enableKinesisStreamingDestinationRequest
* @return A Java Future containing the result of the EnableKinesisStreamingDestination operation returned by the
* service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - InternalServerErrorException An error occurred on the server side.
* - LimitExceededException There is no limit to the number of daily on-demand backups that can be taken.
*
*
* Up to 50 simultaneous table operations are allowed per account. These operations include
* CreateTable, UpdateTable, DeleteTable,
* UpdateTimeToLive, RestoreTableFromBackup, and
* RestoreTableToPointInTime.
*
*
* The only exception is when you are creating a table with one or more secondary indexes. You can have up
* to 25 such requests running at a time; however, if the table or index specifications are complex,
* DynamoDB might temporarily reduce the number of concurrent operations.
*
*
* There is a soft account quota of 256 tables.
* - ResourceInUseException The operation conflicts with the resource's availability. For example, you
* attempted to recreate an existing table, or tried to delete a table currently in the
*
CREATING state.
* - ResourceNotFoundException The operation tried to access a nonexistent table or index. The resource
* might not be specified correctly, or its status might not be
ACTIVE.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.EnableKinesisStreamingDestination
* @see AWS API Documentation
*/
default CompletableFuture enableKinesisStreamingDestination(
EnableKinesisStreamingDestinationRequest enableKinesisStreamingDestinationRequest) {
throw new UnsupportedOperationException();
}
/**
*
* Starts table data replication to the specified Kinesis data stream at a timestamp chosen during the enable
* workflow. If this operation doesn't return results immediately, use DescribeKinesisStreamingDestination to check
* if streaming to the Kinesis data stream is ACTIVE.
*
*
*
* This is a convenience which creates an instance of the {@link EnableKinesisStreamingDestinationRequest.Builder}
* avoiding the need to create one manually via {@link EnableKinesisStreamingDestinationRequest#builder()}
*
*
* @param enableKinesisStreamingDestinationRequest
* A {@link Consumer} that will call methods on {@link KinesisStreamingDestinationInput.Builder} to create a
* request.
* @return A Java Future containing the result of the EnableKinesisStreamingDestination operation returned by the
* service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - InternalServerErrorException An error occurred on the server side.
* - LimitExceededException There is no limit to the number of daily on-demand backups that can be taken.
*
*
* Up to 50 simultaneous table operations are allowed per account. These operations include
* CreateTable, UpdateTable, DeleteTable,
* UpdateTimeToLive, RestoreTableFromBackup, and
* RestoreTableToPointInTime.
*
*
* The only exception is when you are creating a table with one or more secondary indexes. You can have up
* to 25 such requests running at a time; however, if the table or index specifications are complex,
* DynamoDB might temporarily reduce the number of concurrent operations.
*
*
* There is a soft account quota of 256 tables.
* - ResourceInUseException The operation conflicts with the resource's availability. For example, you
* attempted to recreate an existing table, or tried to delete a table currently in the
*
CREATING state.
* - ResourceNotFoundException The operation tried to access a nonexistent table or index. The resource
* might not be specified correctly, or its status might not be
ACTIVE.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.EnableKinesisStreamingDestination
* @see AWS API Documentation
*/
default CompletableFuture enableKinesisStreamingDestination(
Consumer enableKinesisStreamingDestinationRequest) {
return enableKinesisStreamingDestination(EnableKinesisStreamingDestinationRequest.builder()
.applyMutation(enableKinesisStreamingDestinationRequest).build());
}
/**
*
* This operation allows you to perform reads and singleton writes on data stored in DynamoDB, using PartiQL.
*
*
* @param executeStatementRequest
* @return A Java Future containing the result of the ExecuteStatement operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ConditionalCheckFailedException A condition specified in the operation could not be evaluated.
* - ProvisionedThroughputExceededException Your request rate is too high. The AWS SDKs for DynamoDB
* automatically retry requests that receive this exception. Your request is eventually successful, unless
* your retry queue is too large to finish. Reduce the frequency of requests and use exponential backoff.
* For more information, go to Error Retries and Exponential Backoff in the Amazon DynamoDB Developer Guide.
* - ResourceNotFoundException The operation tried to access a nonexistent table or index. The resource
* might not be specified correctly, or its status might not be
ACTIVE.
* - ItemCollectionSizeLimitExceededException An item collection is too large. This exception is only
* returned for tables that have one or more local secondary indexes.
* - TransactionConflictException Operation was rejected because there is an ongoing transaction for the
* item.
* - RequestLimitExceededException Throughput exceeds the current throughput quota for your account.
* Please contact AWS Support at AWS Support to request a quota
* increase.
* - InternalServerErrorException An error occurred on the server side.
* - DuplicateItemException There was an attempt to insert an item with the same primary key as an item
* that already exists in the DynamoDB table.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.ExecuteStatement
* @see AWS API
* Documentation
*/
default CompletableFuture executeStatement(ExecuteStatementRequest executeStatementRequest) {
throw new UnsupportedOperationException();
}
/**
*
* This operation allows you to perform reads and singleton writes on data stored in DynamoDB, using PartiQL.
*
*
*
* This is a convenience which creates an instance of the {@link ExecuteStatementRequest.Builder} avoiding the need
* to create one manually via {@link ExecuteStatementRequest#builder()}
*
*
* @param executeStatementRequest
* A {@link Consumer} that will call methods on {@link ExecuteStatementInput.Builder} to create a request.
* @return A Java Future containing the result of the ExecuteStatement operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ConditionalCheckFailedException A condition specified in the operation could not be evaluated.
* - ProvisionedThroughputExceededException Your request rate is too high. The AWS SDKs for DynamoDB
* automatically retry requests that receive this exception. Your request is eventually successful, unless
* your retry queue is too large to finish. Reduce the frequency of requests and use exponential backoff.
* For more information, go to Error Retries and Exponential Backoff in the Amazon DynamoDB Developer Guide.
* - ResourceNotFoundException The operation tried to access a nonexistent table or index. The resource
* might not be specified correctly, or its status might not be
ACTIVE.
* - ItemCollectionSizeLimitExceededException An item collection is too large. This exception is only
* returned for tables that have one or more local secondary indexes.
* - TransactionConflictException Operation was rejected because there is an ongoing transaction for the
* item.
* - RequestLimitExceededException Throughput exceeds the current throughput quota for your account.
* Please contact AWS Support at AWS Support to request a quota
* increase.
* - InternalServerErrorException An error occurred on the server side.
* - DuplicateItemException There was an attempt to insert an item with the same primary key as an item
* that already exists in the DynamoDB table.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.ExecuteStatement
* @see AWS API
* Documentation
*/
default CompletableFuture executeStatement(
Consumer executeStatementRequest) {
return executeStatement(ExecuteStatementRequest.builder().applyMutation(executeStatementRequest).build());
}
/**
*
* This operation allows you to perform transactional reads or writes on data stored in DynamoDB, using PartiQL.
*
*
* @param executeTransactionRequest
* @return A Java Future containing the result of the ExecuteTransaction operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ResourceNotFoundException The operation tried to access a nonexistent table or index. The resource
* might not be specified correctly, or its status might not be
ACTIVE.
* - TransactionCanceledException The entire transaction request was canceled.
*
* DynamoDB cancels a TransactWriteItems request under the following circumstances:
*
*
* -
*
* A condition in one of the condition expressions is not met.
*
*
* -
*
* A table in the TransactWriteItems request is in a different account or region.
*
*
* -
*
* More than one action in the TransactWriteItems operation targets the same item.
*
*
* -
*
* There is insufficient provisioned capacity for the transaction to be completed.
*
*
* -
*
* An item size becomes too large (larger than 400 KB), or a local secondary index (LSI) becomes too large,
* or a similar validation error occurs because of changes made by the transaction.
*
*
* -
*
* There is a user error, such as an invalid data format.
*
*
*
*
* DynamoDB cancels a TransactGetItems request under the following circumstances:
*
*
* -
*
* There is an ongoing TransactGetItems operation that conflicts with a concurrent
* PutItem, UpdateItem, DeleteItem or TransactWriteItems
* request. In this case the TransactGetItems operation fails with a
* TransactionCanceledException.
*
*
* -
*
* A table in the TransactGetItems request is in a different account or region.
*
*
* -
*
* There is insufficient provisioned capacity for the transaction to be completed.
*
*
* -
*
* There is a user error, such as an invalid data format.
*
*
*
*
*
* If using Java, DynamoDB lists the cancellation reasons on the CancellationReasons property.
* This property is not set for other languages. Transaction cancellation reasons are ordered in the order
* of requested items, if an item has no error it will have NONE code and Null
* message.
*
*
*
* Cancellation reason codes and possible error messages:
*
*
* -
*
* No Errors:
*
*
* -
*
* Code: NONE
*
*
* -
*
* Message: null
*
*
*
*
* -
*
* Conditional Check Failed:
*
*
* -
*
* Code: ConditionalCheckFailed
*
*
* -
*
* Message: The conditional request failed.
*
*
*
*
* -
*
* Item Collection Size Limit Exceeded:
*
*
* -
*
* Code: ItemCollectionSizeLimitExceeded
*
*
* -
*
* Message: Collection size exceeded.
*
*
*
*
* -
*
* Transaction Conflict:
*
*
* -
*
* Code: TransactionConflict
*
*
* -
*
* Message: Transaction is ongoing for the item.
*
*
*
*
* -
*
* Provisioned Throughput Exceeded:
*
*
* -
*
* Code: ProvisionedThroughputExceeded
*
*
* -
*
* Messages:
*
*
* -
*
* The level of configured provisioned throughput for the table was exceeded. Consider increasing your
* provisioning level with the UpdateTable API.
*
*
*
* This Message is received when provisioned throughput is exceeded is on a provisioned DynamoDB table.
*
*
* -
*
* The level of configured provisioned throughput for one or more global secondary indexes of the table was
* exceeded. Consider increasing your provisioning level for the under-provisioned global secondary indexes
* with the UpdateTable API.
*
*
*
* This message is returned when provisioned throughput is exceeded is on a provisioned GSI.
*
*
*
*
*
*
* -
*
* Throttling Error:
*
*
* -
*
* Code: ThrottlingError
*
*
* -
*
* Messages:
*
*
* -
*
* Throughput exceeds the current capacity of your table or index. DynamoDB is automatically scaling your
* table or index so please try again shortly. If exceptions persist, check if you have a hot key:
* https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/bp-partition-key-design.html.
*
*
*
* This message is returned when writes get throttled on an On-Demand table as DynamoDB is automatically
* scaling the table.
*
*
* -
*
* Throughput exceeds the current capacity for one or more global secondary indexes. DynamoDB is
* automatically scaling your index so please try again shortly.
*
*
*
* This message is returned when when writes get throttled on an On-Demand GSI as DynamoDB is automatically
* scaling the GSI.
*
*
*
*
*
*
* -
*
* Validation Error:
*
*
* -
*
* Code: ValidationError
*
*
* -
*
* Messages:
*
*
* -
*
* One or more parameter values were invalid.
*
*
* -
*
* The update expression attempted to update the secondary index key beyond allowed size limits.
*
*
* -
*
* The update expression attempted to update the secondary index key to unsupported type.
*
*
* -
*
* An operand in the update expression has an incorrect data type.
*
*
* -
*
* Item size to update has exceeded the maximum allowed size.
*
*
* -
*
* Number overflow. Attempting to store a number with magnitude larger than supported range.
*
*
* -
*
* Type mismatch for attribute to update.
*
*
* -
*
* Nesting Levels have exceeded supported limits.
*
*
* -
*
* The document path provided in the update expression is invalid for update.
*
*
* -
*
* The provided expression refers to an attribute that does not exist in the item.
*
*
*
*
*
*
* - TransactionInProgressException The transaction with the given request token is already in progress.
* - IdempotentParameterMismatchException DynamoDB rejected the request because you retried a request with
* a different payload but with an idempotent token that was already used.
* - ProvisionedThroughputExceededException Your request rate is too high. The AWS SDKs for DynamoDB
* automatically retry requests that receive this exception. Your request is eventually successful, unless
* your retry queue is too large to finish. Reduce the frequency of requests and use exponential backoff.
* For more information, go to Error Retries and Exponential Backoff in the Amazon DynamoDB Developer Guide.
* - RequestLimitExceededException Throughput exceeds the current throughput quota for your account.
* Please contact AWS Support at AWS Support to request a quota
* increase.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.ExecuteTransaction
* @see AWS
* API Documentation
*/
default CompletableFuture executeTransaction(ExecuteTransactionRequest executeTransactionRequest) {
throw new UnsupportedOperationException();
}
/**
*
* This operation allows you to perform transactional reads or writes on data stored in DynamoDB, using PartiQL.
*
*
*
* This is a convenience which creates an instance of the {@link ExecuteTransactionRequest.Builder} avoiding the
* need to create one manually via {@link ExecuteTransactionRequest#builder()}
*
*
* @param executeTransactionRequest
* A {@link Consumer} that will call methods on {@link ExecuteTransactionInput.Builder} to create a request.
* @return A Java Future containing the result of the ExecuteTransaction operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ResourceNotFoundException The operation tried to access a nonexistent table or index. The resource
* might not be specified correctly, or its status might not be
ACTIVE.
* - TransactionCanceledException The entire transaction request was canceled.
*
* DynamoDB cancels a TransactWriteItems request under the following circumstances:
*
*
* -
*
* A condition in one of the condition expressions is not met.
*
*
* -
*
* A table in the TransactWriteItems request is in a different account or region.
*
*
* -
*
* More than one action in the TransactWriteItems operation targets the same item.
*
*
* -
*
* There is insufficient provisioned capacity for the transaction to be completed.
*
*
* -
*
* An item size becomes too large (larger than 400 KB), or a local secondary index (LSI) becomes too large,
* or a similar validation error occurs because of changes made by the transaction.
*
*
* -
*
* There is a user error, such as an invalid data format.
*
*
*
*
* DynamoDB cancels a TransactGetItems request under the following circumstances:
*
*
* -
*
* There is an ongoing TransactGetItems operation that conflicts with a concurrent
* PutItem, UpdateItem, DeleteItem or TransactWriteItems
* request. In this case the TransactGetItems operation fails with a
* TransactionCanceledException.
*
*
* -
*
* A table in the TransactGetItems request is in a different account or region.
*
*
* -
*
* There is insufficient provisioned capacity for the transaction to be completed.
*
*
* -
*
* There is a user error, such as an invalid data format.
*
*
*
*
*
* If using Java, DynamoDB lists the cancellation reasons on the CancellationReasons property.
* This property is not set for other languages. Transaction cancellation reasons are ordered in the order
* of requested items, if an item has no error it will have NONE code and Null
* message.
*
*
*
* Cancellation reason codes and possible error messages:
*
*
* -
*
* No Errors:
*
*
* -
*
* Code: NONE
*
*
* -
*
* Message: null
*
*
*
*
* -
*
* Conditional Check Failed:
*
*
* -
*
* Code: ConditionalCheckFailed
*
*
* -
*
* Message: The conditional request failed.
*
*
*
*
* -
*
* Item Collection Size Limit Exceeded:
*
*
* -
*
* Code: ItemCollectionSizeLimitExceeded
*
*
* -
*
* Message: Collection size exceeded.
*
*
*
*
* -
*
* Transaction Conflict:
*
*
* -
*
* Code: TransactionConflict
*
*
* -
*
* Message: Transaction is ongoing for the item.
*
*
*
*
* -
*
* Provisioned Throughput Exceeded:
*
*
* -
*
* Code: ProvisionedThroughputExceeded
*
*
* -
*
* Messages:
*
*
* -
*
* The level of configured provisioned throughput for the table was exceeded. Consider increasing your
* provisioning level with the UpdateTable API.
*
*
*
* This Message is received when provisioned throughput is exceeded is on a provisioned DynamoDB table.
*
*
* -
*
* The level of configured provisioned throughput for one or more global secondary indexes of the table was
* exceeded. Consider increasing your provisioning level for the under-provisioned global secondary indexes
* with the UpdateTable API.
*
*
*
* This message is returned when provisioned throughput is exceeded is on a provisioned GSI.
*
*
*
*
*
*
* -
*
* Throttling Error:
*
*
* -
*
* Code: ThrottlingError
*
*
* -
*
* Messages:
*
*
* -
*
* Throughput exceeds the current capacity of your table or index. DynamoDB is automatically scaling your
* table or index so please try again shortly. If exceptions persist, check if you have a hot key:
* https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/bp-partition-key-design.html.
*
*
*
* This message is returned when writes get throttled on an On-Demand table as DynamoDB is automatically
* scaling the table.
*
*
* -
*
* Throughput exceeds the current capacity for one or more global secondary indexes. DynamoDB is
* automatically scaling your index so please try again shortly.
*
*
*
* This message is returned when when writes get throttled on an On-Demand GSI as DynamoDB is automatically
* scaling the GSI.
*
*
*
*
*
*
* -
*
* Validation Error:
*
*
* -
*
* Code: ValidationError
*
*
* -
*
* Messages:
*
*
* -
*
* One or more parameter values were invalid.
*
*
* -
*
* The update expression attempted to update the secondary index key beyond allowed size limits.
*
*
* -
*
* The update expression attempted to update the secondary index key to unsupported type.
*
*
* -
*
* An operand in the update expression has an incorrect data type.
*
*
* -
*
* Item size to update has exceeded the maximum allowed size.
*
*
* -
*
* Number overflow. Attempting to store a number with magnitude larger than supported range.
*
*
* -
*
* Type mismatch for attribute to update.
*
*
* -
*
* Nesting Levels have exceeded supported limits.
*
*
* -
*
* The document path provided in the update expression is invalid for update.
*
*
* -
*
* The provided expression refers to an attribute that does not exist in the item.
*
*
*
*
*
*
* - TransactionInProgressException The transaction with the given request token is already in progress.
* - IdempotentParameterMismatchException DynamoDB rejected the request because you retried a request with
* a different payload but with an idempotent token that was already used.
* - ProvisionedThroughputExceededException Your request rate is too high. The AWS SDKs for DynamoDB
* automatically retry requests that receive this exception. Your request is eventually successful, unless
* your retry queue is too large to finish. Reduce the frequency of requests and use exponential backoff.
* For more information, go to Error Retries and Exponential Backoff in the Amazon DynamoDB Developer Guide.
* - RequestLimitExceededException Throughput exceeds the current throughput quota for your account.
* Please contact AWS Support at AWS Support to request a quota
* increase.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.ExecuteTransaction
* @see AWS
* API Documentation
*/
default CompletableFuture executeTransaction(
Consumer executeTransactionRequest) {
return executeTransaction(ExecuteTransactionRequest.builder().applyMutation(executeTransactionRequest).build());
}
/**
*
* Exports table data to an S3 bucket. The table must have point in time recovery enabled, and you can export data
* from any time within the point in time recovery window.
*
*
* @param exportTableToPointInTimeRequest
* @return A Java Future containing the result of the ExportTableToPointInTime operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - TableNotFoundException A source table with the name
TableName does not currently exist
* within the subscriber's account.
* - PointInTimeRecoveryUnavailableException Point in time recovery has not yet been enabled for this
* source table.
* - LimitExceededException There is no limit to the number of daily on-demand backups that can be taken.
*
*
* Up to 50 simultaneous table operations are allowed per account. These operations include
* CreateTable, UpdateTable, DeleteTable,
* UpdateTimeToLive, RestoreTableFromBackup, and
* RestoreTableToPointInTime.
*
*
* The only exception is when you are creating a table with one or more secondary indexes. You can have up
* to 25 such requests running at a time; however, if the table or index specifications are complex,
* DynamoDB might temporarily reduce the number of concurrent operations.
*
*
* There is a soft account quota of 256 tables.
* - InvalidExportTimeException The specified
ExportTime is outside of the point in time
* recovery window.
* - ExportConflictException There was a conflict when writing to the specified S3 bucket.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.ExportTableToPointInTime
* @see AWS API Documentation
*/
default CompletableFuture exportTableToPointInTime(
ExportTableToPointInTimeRequest exportTableToPointInTimeRequest) {
throw new UnsupportedOperationException();
}
/**
*
* Exports table data to an S3 bucket. The table must have point in time recovery enabled, and you can export data
* from any time within the point in time recovery window.
*
*
*
* This is a convenience which creates an instance of the {@link ExportTableToPointInTimeRequest.Builder} avoiding
* the need to create one manually via {@link ExportTableToPointInTimeRequest#builder()}
*
*
* @param exportTableToPointInTimeRequest
* A {@link Consumer} that will call methods on {@link ExportTableToPointInTimeInput.Builder} to create a
* request.
* @return A Java Future containing the result of the ExportTableToPointInTime operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - TableNotFoundException A source table with the name
TableName does not currently exist
* within the subscriber's account.
* - PointInTimeRecoveryUnavailableException Point in time recovery has not yet been enabled for this
* source table.
* - LimitExceededException There is no limit to the number of daily on-demand backups that can be taken.
*
*
* Up to 50 simultaneous table operations are allowed per account. These operations include
* CreateTable, UpdateTable, DeleteTable,
* UpdateTimeToLive, RestoreTableFromBackup, and
* RestoreTableToPointInTime.
*
*
* The only exception is when you are creating a table with one or more secondary indexes. You can have up
* to 25 such requests running at a time; however, if the table or index specifications are complex,
* DynamoDB might temporarily reduce the number of concurrent operations.
*
*
* There is a soft account quota of 256 tables.
* - InvalidExportTimeException The specified
ExportTime is outside of the point in time
* recovery window.
* - ExportConflictException There was a conflict when writing to the specified S3 bucket.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.ExportTableToPointInTime
* @see AWS API Documentation
*/
default CompletableFuture exportTableToPointInTime(
Consumer exportTableToPointInTimeRequest) {
return exportTableToPointInTime(ExportTableToPointInTimeRequest.builder().applyMutation(exportTableToPointInTimeRequest)
.build());
}
/**
*
* The GetItem operation returns a set of attributes for the item with the given primary key. If there
* is no matching item, GetItem does not return any data and there will be no Item element
* in the response.
*
*
* GetItem provides an eventually consistent read by default. If your application requires a strongly
* consistent read, set ConsistentRead to true. Although a strongly consistent read might
* take more time than an eventually consistent read, it always returns the last updated value.
*
*
* @param getItemRequest
* Represents the input of a GetItem operation.
* @return A Java Future containing the result of the GetItem operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ProvisionedThroughputExceededException Your request rate is too high. The AWS SDKs for DynamoDB
* automatically retry requests that receive this exception. Your request is eventually successful, unless
* your retry queue is too large to finish. Reduce the frequency of requests and use exponential backoff.
* For more information, go to Error Retries and Exponential Backoff in the Amazon DynamoDB Developer Guide.
* - ResourceNotFoundException The operation tried to access a nonexistent table or index. The resource
* might not be specified correctly, or its status might not be
ACTIVE.
* - RequestLimitExceededException Throughput exceeds the current throughput quota for your account.
* Please contact AWS Support at AWS Support to request a quota
* increase.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.GetItem
* @see AWS API
* Documentation
*/
default CompletableFuture getItem(GetItemRequest getItemRequest) {
throw new UnsupportedOperationException();
}
/**
*
* The GetItem operation returns a set of attributes for the item with the given primary key. If there
* is no matching item, GetItem does not return any data and there will be no Item element
* in the response.
*
*
* GetItem provides an eventually consistent read by default. If your application requires a strongly
* consistent read, set ConsistentRead to true. Although a strongly consistent read might
* take more time than an eventually consistent read, it always returns the last updated value.
*
*
*
* This is a convenience which creates an instance of the {@link GetItemRequest.Builder} avoiding the need to create
* one manually via {@link GetItemRequest#builder()}
*
*
* @param getItemRequest
* A {@link Consumer} that will call methods on {@link GetItemInput.Builder} to create a request. Represents
* the input of a GetItem operation.
* @return A Java Future containing the result of the GetItem operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ProvisionedThroughputExceededException Your request rate is too high. The AWS SDKs for DynamoDB
* automatically retry requests that receive this exception. Your request is eventually successful, unless
* your retry queue is too large to finish. Reduce the frequency of requests and use exponential backoff.
* For more information, go to Error Retries and Exponential Backoff in the Amazon DynamoDB Developer Guide.
* - ResourceNotFoundException The operation tried to access a nonexistent table or index. The resource
* might not be specified correctly, or its status might not be
ACTIVE.
* - RequestLimitExceededException Throughput exceeds the current throughput quota for your account.
* Please contact AWS Support at AWS Support to request a quota
* increase.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.GetItem
* @see AWS API
* Documentation
*/
default CompletableFuture getItem(Consumer getItemRequest) {
return getItem(GetItemRequest.builder().applyMutation(getItemRequest).build());
}
/**
*
* List backups associated with an AWS account. To list backups for a given table, specify TableName.
* ListBackups returns a paginated list of results with at most 1 MB worth of items in a page. You can
* also specify a maximum number of entries to be returned in a page.
*
*
* In the request, start time is inclusive, but end time is exclusive. Note that these boundaries are for the time
* at which the original backup was requested.
*
*
* You can call ListBackups a maximum of five times per second.
*
*
* @param listBackupsRequest
* @return A Java Future containing the result of the ListBackups operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.ListBackups
* @see AWS API
* Documentation
*/
default CompletableFuture listBackups(ListBackupsRequest listBackupsRequest) {
throw new UnsupportedOperationException();
}
/**
*
* List backups associated with an AWS account. To list backups for a given table, specify TableName.
* ListBackups returns a paginated list of results with at most 1 MB worth of items in a page. You can
* also specify a maximum number of entries to be returned in a page.
*
*
* In the request, start time is inclusive, but end time is exclusive. Note that these boundaries are for the time
* at which the original backup was requested.
*
*
* You can call ListBackups a maximum of five times per second.
*
*
*
* This is a convenience which creates an instance of the {@link ListBackupsRequest.Builder} avoiding the need to
* create one manually via {@link ListBackupsRequest#builder()}
*
*
* @param listBackupsRequest
* A {@link Consumer} that will call methods on {@link ListBackupsInput.Builder} to create a request.
* @return A Java Future containing the result of the ListBackups operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.ListBackups
* @see AWS API
* Documentation
*/
default CompletableFuture listBackups(Consumer listBackupsRequest) {
return listBackups(ListBackupsRequest.builder().applyMutation(listBackupsRequest).build());
}
/**
*
* List backups associated with an AWS account. To list backups for a given table, specify TableName.
* ListBackups returns a paginated list of results with at most 1 MB worth of items in a page. You can
* also specify a maximum number of entries to be returned in a page.
*
*
* In the request, start time is inclusive, but end time is exclusive. Note that these boundaries are for the time
* at which the original backup was requested.
*
*
* You can call ListBackups a maximum of five times per second.
*
*
* @return A Java Future containing the result of the ListBackups operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.ListBackups
* @see AWS API
* Documentation
*/
default CompletableFuture listBackups() {
return listBackups(ListBackupsRequest.builder().build());
}
/**
*
* Returns a list of ContributorInsightsSummary for a table and all its global secondary indexes.
*
*
* @param listContributorInsightsRequest
* @return A Java Future containing the result of the ListContributorInsights operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ResourceNotFoundException The operation tried to access a nonexistent table or index. The resource
* might not be specified correctly, or its status might not be
ACTIVE.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.ListContributorInsights
* @see AWS API Documentation
*/
default CompletableFuture listContributorInsights(
ListContributorInsightsRequest listContributorInsightsRequest) {
throw new UnsupportedOperationException();
}
/**
*
* Returns a list of ContributorInsightsSummary for a table and all its global secondary indexes.
*
*
*
* This is a convenience which creates an instance of the {@link ListContributorInsightsRequest.Builder} avoiding
* the need to create one manually via {@link ListContributorInsightsRequest#builder()}
*
*
* @param listContributorInsightsRequest
* A {@link Consumer} that will call methods on {@link ListContributorInsightsInput.Builder} to create a
* request.
* @return A Java Future containing the result of the ListContributorInsights operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ResourceNotFoundException The operation tried to access a nonexistent table or index. The resource
* might not be specified correctly, or its status might not be
ACTIVE.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.ListContributorInsights
* @see AWS API Documentation
*/
default CompletableFuture listContributorInsights(
Consumer listContributorInsightsRequest) {
return listContributorInsights(ListContributorInsightsRequest.builder().applyMutation(listContributorInsightsRequest)
.build());
}
/**
*
* Returns a list of ContributorInsightsSummary for a table and all its global secondary indexes.
*
*
*
* This is a variant of
* {@link #listContributorInsights(software.amazon.awssdk.services.dynamodb.model.ListContributorInsightsRequest)}
* 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
* {@link org.reactivestreams.Publisher#subscribe(org.reactivestreams.Subscriber)}. Each call to the subscribe
* method will result in a new {@link org.reactivestreams.Subscription} 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 method
*
*
* {@code
* software.amazon.awssdk.services.dynamodb.paginators.ListContributorInsightsPublisher publisher = client.listContributorInsightsPaginator(request);
* CompletableFuture future = publisher.subscribe(res -> { // Do something with the response });
* future.get();
* }
*
*
* 2) Using a custom subscriber
*
*
* {@code
* software.amazon.awssdk.services.dynamodb.paginators.ListContributorInsightsPublisher publisher = client.listContributorInsightsPaginator(request);
* publisher.subscribe(new Subscriber() {
*
* public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
*
*
* public void onNext(software.amazon.awssdk.services.dynamodb.model.ListContributorInsightsResponse response) { //... };
* });}
*
*
* As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.
*
* Please notice that the configuration of MaxResults won't limit the number of results you get with the
* paginator. It only limits the number of results in each page.
*
*
* Note: If you prefer to have control on service calls, use the
* {@link #listContributorInsights(software.amazon.awssdk.services.dynamodb.model.ListContributorInsightsRequest)}
* operation.
*
*
* @param listContributorInsightsRequest
* @return 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.
*
* - ResourceNotFoundException The operation tried to access a nonexistent table or index. The resource
* might not be specified correctly, or its status might not be
ACTIVE.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.ListContributorInsights
* @see AWS API Documentation
*/
default ListContributorInsightsPublisher listContributorInsightsPaginator(
ListContributorInsightsRequest listContributorInsightsRequest) {
throw new UnsupportedOperationException();
}
/**
*
* Returns a list of ContributorInsightsSummary for a table and all its global secondary indexes.
*
*
*
* This is a variant of
* {@link #listContributorInsights(software.amazon.awssdk.services.dynamodb.model.ListContributorInsightsRequest)}
* 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
* {@link org.reactivestreams.Publisher#subscribe(org.reactivestreams.Subscriber)}. Each call to the subscribe
* method will result in a new {@link org.reactivestreams.Subscription} 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 method
*
*
* {@code
* software.amazon.awssdk.services.dynamodb.paginators.ListContributorInsightsPublisher publisher = client.listContributorInsightsPaginator(request);
* CompletableFuture future = publisher.subscribe(res -> { // Do something with the response });
* future.get();
* }
*
*
* 2) Using a custom subscriber
*
*
* {@code
* software.amazon.awssdk.services.dynamodb.paginators.ListContributorInsightsPublisher publisher = client.listContributorInsightsPaginator(request);
* publisher.subscribe(new Subscriber() {
*
* public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
*
*
* public void onNext(software.amazon.awssdk.services.dynamodb.model.ListContributorInsightsResponse response) { //... };
* });}
*
*
* As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.
*
* Please notice that the configuration of MaxResults won't limit the number of results you get with the
* paginator. It only limits the number of results in each page.
*
*
* Note: If you prefer to have control on service calls, use the
* {@link #listContributorInsights(software.amazon.awssdk.services.dynamodb.model.ListContributorInsightsRequest)}
* operation.
*
*
* This is a convenience which creates an instance of the {@link ListContributorInsightsRequest.Builder} avoiding
* the need to create one manually via {@link ListContributorInsightsRequest#builder()}
*
*
* @param listContributorInsightsRequest
* A {@link Consumer} that will call methods on {@link ListContributorInsightsInput.Builder} to create a
* request.
* @return 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.
*
* - ResourceNotFoundException The operation tried to access a nonexistent table or index. The resource
* might not be specified correctly, or its status might not be
ACTIVE.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.ListContributorInsights
* @see AWS API Documentation
*/
default ListContributorInsightsPublisher listContributorInsightsPaginator(
Consumer listContributorInsightsRequest) {
return listContributorInsightsPaginator(ListContributorInsightsRequest.builder()
.applyMutation(listContributorInsightsRequest).build());
}
/**
*
* Lists completed exports within the past 90 days.
*
*
* @param listExportsRequest
* @return A Java Future containing the result of the ListExports operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - LimitExceededException There is no limit to the number of daily on-demand backups that can be taken.
*
*
* Up to 50 simultaneous table operations are allowed per account. These operations include
* CreateTable, UpdateTable, DeleteTable,
* UpdateTimeToLive, RestoreTableFromBackup, and
* RestoreTableToPointInTime.
*
*
* The only exception is when you are creating a table with one or more secondary indexes. You can have up
* to 25 such requests running at a time; however, if the table or index specifications are complex,
* DynamoDB might temporarily reduce the number of concurrent operations.
*
*
* There is a soft account quota of 256 tables.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.ListExports
* @see AWS API
* Documentation
*/
default CompletableFuture listExports(ListExportsRequest listExportsRequest) {
throw new UnsupportedOperationException();
}
/**
*
* Lists completed exports within the past 90 days.
*
*
*
* This is a convenience which creates an instance of the {@link ListExportsRequest.Builder} avoiding the need to
* create one manually via {@link ListExportsRequest#builder()}
*
*
* @param listExportsRequest
* A {@link Consumer} that will call methods on {@link ListExportsInput.Builder} to create a request.
* @return A Java Future containing the result of the ListExports operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - LimitExceededException There is no limit to the number of daily on-demand backups that can be taken.
*
*
* Up to 50 simultaneous table operations are allowed per account. These operations include
* CreateTable, UpdateTable, DeleteTable,
* UpdateTimeToLive, RestoreTableFromBackup, and
* RestoreTableToPointInTime.
*
*
* The only exception is when you are creating a table with one or more secondary indexes. You can have up
* to 25 such requests running at a time; however, if the table or index specifications are complex,
* DynamoDB might temporarily reduce the number of concurrent operations.
*
*
* There is a soft account quota of 256 tables.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.ListExports
* @see AWS API
* Documentation
*/
default CompletableFuture listExports(Consumer listExportsRequest) {
return listExports(ListExportsRequest.builder().applyMutation(listExportsRequest).build());
}
/**
*
* Lists completed exports within the past 90 days.
*
*
*
* This is a variant of {@link #listExports(software.amazon.awssdk.services.dynamodb.model.ListExportsRequest)}
* 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
* {@link org.reactivestreams.Publisher#subscribe(org.reactivestreams.Subscriber)}. Each call to the subscribe
* method will result in a new {@link org.reactivestreams.Subscription} 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 method
*
*
* {@code
* software.amazon.awssdk.services.dynamodb.paginators.ListExportsPublisher publisher = client.listExportsPaginator(request);
* CompletableFuture future = publisher.subscribe(res -> { // Do something with the response });
* future.get();
* }
*
*
* 2) Using a custom subscriber
*
*
* {@code
* software.amazon.awssdk.services.dynamodb.paginators.ListExportsPublisher publisher = client.listExportsPaginator(request);
* publisher.subscribe(new Subscriber() {
*
* public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
*
*
* public void onNext(software.amazon.awssdk.services.dynamodb.model.ListExportsResponse response) { //... };
* });}
*
*
* As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.
*
* Please notice that the configuration of MaxResults won't limit the number of results you get with the
* paginator. It only limits the number of results in each page.
*
*
* Note: If you prefer to have control on service calls, use the
* {@link #listExports(software.amazon.awssdk.services.dynamodb.model.ListExportsRequest)} operation.
*
*
* @param listExportsRequest
* @return 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.
*
* - LimitExceededException There is no limit to the number of daily on-demand backups that can be taken.
*
*
* Up to 50 simultaneous table operations are allowed per account. These operations include
* CreateTable, UpdateTable, DeleteTable,
* UpdateTimeToLive, RestoreTableFromBackup, and
* RestoreTableToPointInTime.
*
*
* The only exception is when you are creating a table with one or more secondary indexes. You can have up
* to 25 such requests running at a time; however, if the table or index specifications are complex,
* DynamoDB might temporarily reduce the number of concurrent operations.
*
*
* There is a soft account quota of 256 tables.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.ListExports
* @see AWS API
* Documentation
*/
default ListExportsPublisher listExportsPaginator(ListExportsRequest listExportsRequest) {
throw new UnsupportedOperationException();
}
/**
*
* Lists completed exports within the past 90 days.
*
*
*
* This is a variant of {@link #listExports(software.amazon.awssdk.services.dynamodb.model.ListExportsRequest)}
* 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
* {@link org.reactivestreams.Publisher#subscribe(org.reactivestreams.Subscriber)}. Each call to the subscribe
* method will result in a new {@link org.reactivestreams.Subscription} 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 method
*
*
* {@code
* software.amazon.awssdk.services.dynamodb.paginators.ListExportsPublisher publisher = client.listExportsPaginator(request);
* CompletableFuture future = publisher.subscribe(res -> { // Do something with the response });
* future.get();
* }
*
*
* 2) Using a custom subscriber
*
*
* {@code
* software.amazon.awssdk.services.dynamodb.paginators.ListExportsPublisher publisher = client.listExportsPaginator(request);
* publisher.subscribe(new Subscriber() {
*
* public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
*
*
* public void onNext(software.amazon.awssdk.services.dynamodb.model.ListExportsResponse response) { //... };
* });}
*
*
* As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.
*
* Please notice that the configuration of MaxResults won't limit the number of results you get with the
* paginator. It only limits the number of results in each page.
*
*
* Note: If you prefer to have control on service calls, use the
* {@link #listExports(software.amazon.awssdk.services.dynamodb.model.ListExportsRequest)} operation.
*
*
* This is a convenience which creates an instance of the {@link ListExportsRequest.Builder} avoiding the need to
* create one manually via {@link ListExportsRequest#builder()}
*
*
* @param listExportsRequest
* A {@link Consumer} that will call methods on {@link ListExportsInput.Builder} to create a request.
* @return 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.
*
* - LimitExceededException There is no limit to the number of daily on-demand backups that can be taken.
*
*
* Up to 50 simultaneous table operations are allowed per account. These operations include
* CreateTable, UpdateTable, DeleteTable,
* UpdateTimeToLive, RestoreTableFromBackup, and
* RestoreTableToPointInTime.
*
*
* The only exception is when you are creating a table with one or more secondary indexes. You can have up
* to 25 such requests running at a time; however, if the table or index specifications are complex,
* DynamoDB might temporarily reduce the number of concurrent operations.
*
*
* There is a soft account quota of 256 tables.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.ListExports
* @see AWS API
* Documentation
*/
default ListExportsPublisher listExportsPaginator(Consumer listExportsRequest) {
return listExportsPaginator(ListExportsRequest.builder().applyMutation(listExportsRequest).build());
}
/**
*
* Lists all global tables that have a replica in the specified Region.
*
*
*
* This operation only applies to Version
* 2017.11.29 of global tables.
*
*
*
* @param listGlobalTablesRequest
* @return A Java Future containing the result of the ListGlobalTables operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.ListGlobalTables
* @see AWS API
* Documentation
*/
default CompletableFuture listGlobalTables(ListGlobalTablesRequest listGlobalTablesRequest) {
throw new UnsupportedOperationException();
}
/**
*
* Lists all global tables that have a replica in the specified Region.
*
*
*
* This operation only applies to Version
* 2017.11.29 of global tables.
*
*
*
* This is a convenience which creates an instance of the {@link ListGlobalTablesRequest.Builder} avoiding the need
* to create one manually via {@link ListGlobalTablesRequest#builder()}
*
*
* @param listGlobalTablesRequest
* A {@link Consumer} that will call methods on {@link ListGlobalTablesInput.Builder} to create a request.
* @return A Java Future containing the result of the ListGlobalTables operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.ListGlobalTables
* @see AWS API
* Documentation
*/
default CompletableFuture listGlobalTables(
Consumer listGlobalTablesRequest) {
return listGlobalTables(ListGlobalTablesRequest.builder().applyMutation(listGlobalTablesRequest).build());
}
/**
*
* Lists all global tables that have a replica in the specified Region.
*
*
*
* This operation only applies to Version
* 2017.11.29 of global tables.
*
*
*
* @return A Java Future containing the result of the ListGlobalTables operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.ListGlobalTables
* @see AWS API
* Documentation
*/
default CompletableFuture listGlobalTables() {
return listGlobalTables(ListGlobalTablesRequest.builder().build());
}
/**
*
* Returns an array of table names associated with the current account and endpoint. The output from
* ListTables is paginated, with each page returning a maximum of 100 table names.
*
*
* @param listTablesRequest
* Represents the input of a ListTables operation.
* @return A Java Future containing the result of the ListTables operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.ListTables
* @see AWS API
* Documentation
*/
default CompletableFuture listTables(ListTablesRequest listTablesRequest) {
throw new UnsupportedOperationException();
}
/**
*
* Returns an array of table names associated with the current account and endpoint. The output from
* ListTables is paginated, with each page returning a maximum of 100 table names.
*
*
*
* This is a convenience which creates an instance of the {@link ListTablesRequest.Builder} avoiding the need to
* create one manually via {@link ListTablesRequest#builder()}
*
*
* @param listTablesRequest
* A {@link Consumer} that will call methods on {@link ListTablesInput.Builder} to create a request.
* Represents the input of a ListTables operation.
* @return A Java Future containing the result of the ListTables operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.ListTables
* @see AWS API
* Documentation
*/
default CompletableFuture listTables(Consumer listTablesRequest) {
return listTables(ListTablesRequest.builder().applyMutation(listTablesRequest).build());
}
/**
*
* Returns an array of table names associated with the current account and endpoint. The output from
* ListTables is paginated, with each page returning a maximum of 100 table names.
*
*
* @return A Java Future containing the result of the ListTables operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.ListTables
* @see AWS API
* Documentation
*/
default CompletableFuture listTables() {
return listTables(ListTablesRequest.builder().build());
}
/**
*
* Returns an array of table names associated with the current account and endpoint. The output from
* ListTables is paginated, with each page returning a maximum of 100 table names.
*
*
*
* This is a variant of {@link #listTables(software.amazon.awssdk.services.dynamodb.model.ListTablesRequest)}
* 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
* {@link org.reactivestreams.Publisher#subscribe(org.reactivestreams.Subscriber)}. Each call to the subscribe
* method will result in a new {@link org.reactivestreams.Subscription} 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 method
*
*
* {@code
* software.amazon.awssdk.services.dynamodb.paginators.ListTablesPublisher publisher = client.listTablesPaginator(request);
* CompletableFuture future = publisher.subscribe(res -> { // Do something with the response });
* future.get();
* }
*
*
* 2) Using a custom subscriber
*
*
* {@code
* software.amazon.awssdk.services.dynamodb.paginators.ListTablesPublisher publisher = client.listTablesPaginator(request);
* publisher.subscribe(new Subscriber() {
*
* public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
*
*
* public void onNext(software.amazon.awssdk.services.dynamodb.model.ListTablesResponse response) { //... };
* });}
*
*
* As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.
*
* Please notice that the configuration of Limit 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
* {@link #listTables(software.amazon.awssdk.services.dynamodb.model.ListTablesRequest)} operation.
*
*
* @return 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.
*
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.ListTables
* @see AWS API
* Documentation
*/
default ListTablesPublisher listTablesPaginator() {
return listTablesPaginator(ListTablesRequest.builder().build());
}
/**
*
* Returns an array of table names associated with the current account and endpoint. The output from
* ListTables is paginated, with each page returning a maximum of 100 table names.
*
*
*
* This is a variant of {@link #listTables(software.amazon.awssdk.services.dynamodb.model.ListTablesRequest)}
* 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
* {@link org.reactivestreams.Publisher#subscribe(org.reactivestreams.Subscriber)}. Each call to the subscribe
* method will result in a new {@link org.reactivestreams.Subscription} 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 method
*
*
* {@code
* software.amazon.awssdk.services.dynamodb.paginators.ListTablesPublisher publisher = client.listTablesPaginator(request);
* CompletableFuture future = publisher.subscribe(res -> { // Do something with the response });
* future.get();
* }
*
*
* 2) Using a custom subscriber
*
*
* {@code
* software.amazon.awssdk.services.dynamodb.paginators.ListTablesPublisher publisher = client.listTablesPaginator(request);
* publisher.subscribe(new Subscriber() {
*
* public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
*
*
* public void onNext(software.amazon.awssdk.services.dynamodb.model.ListTablesResponse response) { //... };
* });}
*
*
* As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.
*
* Please notice that the configuration of Limit 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
* {@link #listTables(software.amazon.awssdk.services.dynamodb.model.ListTablesRequest)} operation.
*
*
* @param listTablesRequest
* Represents the input of a ListTables operation.
* @return 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.
*
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.ListTables
* @see AWS API
* Documentation
*/
default ListTablesPublisher listTablesPaginator(ListTablesRequest listTablesRequest) {
throw new UnsupportedOperationException();
}
/**
*
* Returns an array of table names associated with the current account and endpoint. The output from
* ListTables is paginated, with each page returning a maximum of 100 table names.
*
*
*
* This is a variant of {@link #listTables(software.amazon.awssdk.services.dynamodb.model.ListTablesRequest)}
* 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
* {@link org.reactivestreams.Publisher#subscribe(org.reactivestreams.Subscriber)}. Each call to the subscribe
* method will result in a new {@link org.reactivestreams.Subscription} 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 method
*
*
* {@code
* software.amazon.awssdk.services.dynamodb.paginators.ListTablesPublisher publisher = client.listTablesPaginator(request);
* CompletableFuture future = publisher.subscribe(res -> { // Do something with the response });
* future.get();
* }
*
*
* 2) Using a custom subscriber
*
*
* {@code
* software.amazon.awssdk.services.dynamodb.paginators.ListTablesPublisher publisher = client.listTablesPaginator(request);
* publisher.subscribe(new Subscriber() {
*
* public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
*
*
* public void onNext(software.amazon.awssdk.services.dynamodb.model.ListTablesResponse response) { //... };
* });}
*
*
* As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.
*
* Please notice that the configuration of Limit 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
* {@link #listTables(software.amazon.awssdk.services.dynamodb.model.ListTablesRequest)} operation.
*
*
* This is a convenience which creates an instance of the {@link ListTablesRequest.Builder} avoiding the need to
* create one manually via {@link ListTablesRequest#builder()}
*
*
* @param listTablesRequest
* A {@link Consumer} that will call methods on {@link ListTablesInput.Builder} to create a request.
* Represents the input of a ListTables operation.
* @return 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.
*
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.ListTables
* @see AWS API
* Documentation
*/
default ListTablesPublisher listTablesPaginator(Consumer listTablesRequest) {
return listTablesPaginator(ListTablesRequest.builder().applyMutation(listTablesRequest).build());
}
/**
*
* List all tags on an Amazon DynamoDB resource. You can call ListTagsOfResource up to 10 times per second, per
* account.
*
*
* For an overview on tagging DynamoDB resources, see Tagging for DynamoDB in
* the Amazon DynamoDB Developer Guide.
*
*
* @param listTagsOfResourceRequest
* @return A Java Future containing the result of the ListTagsOfResource operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ResourceNotFoundException The operation tried to access a nonexistent table or index. The resource
* might not be specified correctly, or its status might not be
ACTIVE.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.ListTagsOfResource
* @see AWS
* API Documentation
*/
default CompletableFuture listTagsOfResource(ListTagsOfResourceRequest listTagsOfResourceRequest) {
throw new UnsupportedOperationException();
}
/**
*
* List all tags on an Amazon DynamoDB resource. You can call ListTagsOfResource up to 10 times per second, per
* account.
*
*
* For an overview on tagging DynamoDB resources, see Tagging for DynamoDB in
* the Amazon DynamoDB Developer Guide.
*
*
*
* This is a convenience which creates an instance of the {@link ListTagsOfResourceRequest.Builder} avoiding the
* need to create one manually via {@link ListTagsOfResourceRequest#builder()}
*
*
* @param listTagsOfResourceRequest
* A {@link Consumer} that will call methods on {@link ListTagsOfResourceInput.Builder} to create a request.
* @return A Java Future containing the result of the ListTagsOfResource operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ResourceNotFoundException The operation tried to access a nonexistent table or index. The resource
* might not be specified correctly, or its status might not be
ACTIVE.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.ListTagsOfResource
* @see AWS
* API Documentation
*/
default CompletableFuture listTagsOfResource(
Consumer listTagsOfResourceRequest) {
return listTagsOfResource(ListTagsOfResourceRequest.builder().applyMutation(listTagsOfResourceRequest).build());
}
/**
*
* Creates a new item, or replaces an old item with a new item. If an item that has the same primary key as the new
* item already exists in the specified table, the new item completely replaces the existing item. You can perform a
* conditional put operation (add a new item if one with the specified primary key doesn't exist), or replace an
* existing item if it has certain attribute values. You can return the item's attribute values in the same
* operation, using the ReturnValues parameter.
*
*
*
* This topic provides general information about the PutItem API.
*
*
* For information on how to call the PutItem API using the AWS SDK in specific languages, see the
* following:
*
*
* -
*
*
* -
*
*
* -
*
*
* -
*
*
* -
*
*
* -
*
*
* -
*
*
* -
*
*
* -
*
*
*
*
*
* When you add an item, the primary key attributes are the only required attributes. Attribute values cannot be
* null.
*
*
* Empty String and Binary attribute values are allowed. Attribute values of type String and Binary must have a
* length greater than zero if the attribute is used as a key attribute for a table or index. Set type attributes
* cannot be empty.
*
*
* Invalid Requests with empty values will be rejected with a ValidationException exception.
*
*
*
* To prevent a new item from replacing an existing item, use a conditional expression that contains the
* attribute_not_exists function with the name of the attribute being used as the partition key for the
* table. Since every record must contain that attribute, the attribute_not_exists function will only
* succeed if no matching item exists.
*
*
*
* For more information about PutItem, see Working with
* Items in the Amazon DynamoDB Developer Guide.
*
*
* @param putItemRequest
* Represents the input of a PutItem operation.
* @return A Java Future containing the result of the PutItem operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ConditionalCheckFailedException A condition specified in the operation could not be evaluated.
* - ProvisionedThroughputExceededException Your request rate is too high. The AWS SDKs for DynamoDB
* automatically retry requests that receive this exception. Your request is eventually successful, unless
* your retry queue is too large to finish. Reduce the frequency of requests and use exponential backoff.
* For more information, go to Error Retries and Exponential Backoff in the Amazon DynamoDB Developer Guide.
* - ResourceNotFoundException The operation tried to access a nonexistent table or index. The resource
* might not be specified correctly, or its status might not be
ACTIVE.
* - ItemCollectionSizeLimitExceededException An item collection is too large. This exception is only
* returned for tables that have one or more local secondary indexes.
* - TransactionConflictException Operation was rejected because there is an ongoing transaction for the
* item.
* - RequestLimitExceededException Throughput exceeds the current throughput quota for your account.
* Please contact AWS Support at AWS Support to request a quota
* increase.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.PutItem
* @see AWS API
* Documentation
*/
default CompletableFuture putItem(PutItemRequest putItemRequest) {
throw new UnsupportedOperationException();
}
/**
*
* Creates a new item, or replaces an old item with a new item. If an item that has the same primary key as the new
* item already exists in the specified table, the new item completely replaces the existing item. You can perform a
* conditional put operation (add a new item if one with the specified primary key doesn't exist), or replace an
* existing item if it has certain attribute values. You can return the item's attribute values in the same
* operation, using the ReturnValues parameter.
*
*
*
* This topic provides general information about the PutItem API.
*
*
* For information on how to call the PutItem API using the AWS SDK in specific languages, see the
* following:
*
*
* -
*
*
* -
*
*
* -
*
*
* -
*
*
* -
*
*
* -
*
*
* -
*
*
* -
*
*
* -
*
*
*
*
*
* When you add an item, the primary key attributes are the only required attributes. Attribute values cannot be
* null.
*
*
* Empty String and Binary attribute values are allowed. Attribute values of type String and Binary must have a
* length greater than zero if the attribute is used as a key attribute for a table or index. Set type attributes
* cannot be empty.
*
*
* Invalid Requests with empty values will be rejected with a ValidationException exception.
*
*
*
* To prevent a new item from replacing an existing item, use a conditional expression that contains the
* attribute_not_exists function with the name of the attribute being used as the partition key for the
* table. Since every record must contain that attribute, the attribute_not_exists function will only
* succeed if no matching item exists.
*
*
*
* For more information about PutItem, see Working with
* Items in the Amazon DynamoDB Developer Guide.
*
*
*
* This is a convenience which creates an instance of the {@link PutItemRequest.Builder} avoiding the need to create
* one manually via {@link PutItemRequest#builder()}
*
*
* @param putItemRequest
* A {@link Consumer} that will call methods on {@link PutItemInput.Builder} to create a request. Represents
* the input of a PutItem operation.
* @return A Java Future containing the result of the PutItem operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ConditionalCheckFailedException A condition specified in the operation could not be evaluated.
* - ProvisionedThroughputExceededException Your request rate is too high. The AWS SDKs for DynamoDB
* automatically retry requests that receive this exception. Your request is eventually successful, unless
* your retry queue is too large to finish. Reduce the frequency of requests and use exponential backoff.
* For more information, go to Error Retries and Exponential Backoff in the Amazon DynamoDB Developer Guide.
* - ResourceNotFoundException The operation tried to access a nonexistent table or index. The resource
* might not be specified correctly, or its status might not be
ACTIVE.
* - ItemCollectionSizeLimitExceededException An item collection is too large. This exception is only
* returned for tables that have one or more local secondary indexes.
* - TransactionConflictException Operation was rejected because there is an ongoing transaction for the
* item.
* - RequestLimitExceededException Throughput exceeds the current throughput quota for your account.
* Please contact AWS Support at AWS Support to request a quota
* increase.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.PutItem
* @see AWS API
* Documentation
*/
default CompletableFuture putItem(Consumer putItemRequest) {
return putItem(PutItemRequest.builder().applyMutation(putItemRequest).build());
}
/**
*
* The Query operation finds items based on primary key values. You can query any table or secondary
* index that has a composite primary key (a partition key and a sort key).
*
*
* Use the KeyConditionExpression parameter to provide a specific value for the partition key. The
* Query operation will return all of the items from the table or index with that partition key value.
* You can optionally narrow the scope of the Query operation by specifying a sort key value and a
* comparison operator in KeyConditionExpression. To further refine the Query results, you
* can optionally provide a FilterExpression. A FilterExpression determines which items
* within the results should be returned to you. All of the other results are discarded.
*
*
* A Query operation always returns a result set. If no matching items are found, the result set will
* be empty. Queries that do not return results consume the minimum number of read capacity units for that type of
* read operation.
*
*
*
* DynamoDB calculates the number of read capacity units consumed based on item size, not on the amount of data that
* is returned to an application. The number of capacity units consumed will be the same whether you request all of
* the attributes (the default behavior) or just some of them (using a projection expression). The number will also
* be the same whether or not you use a FilterExpression.
*
*
*
* Query results are always sorted by the sort key value. If the data type of the sort key is Number,
* the results are returned in numeric order; otherwise, the results are returned in order of UTF-8 bytes. By
* default, the sort order is ascending. To reverse the order, set the ScanIndexForward parameter to
* false.
*
*
* A single Query operation will read up to the maximum number of items set (if using the
* Limit parameter) or a maximum of 1 MB of data and then apply any filtering to the results using
* FilterExpression. If LastEvaluatedKey is present in the response, you will need to
* paginate the result set. For more information, see Paginating
* the Results in the Amazon DynamoDB Developer Guide.
*
*
* FilterExpression is applied after a Query finishes, but before the results are
* returned. A FilterExpression cannot contain partition key or sort key attributes. You need to
* specify those attributes in the KeyConditionExpression.
*
*
*
* A Query operation can return an empty result set and a LastEvaluatedKey if all the
* items read for the page of results are filtered out.
*
*
*
* You can query a table, a local secondary index, or a global secondary index. For a query on a table or on a local
* secondary index, you can set the ConsistentRead parameter to true and obtain a strongly
* consistent result. Global secondary indexes support eventually consistent reads only, so do not specify
* ConsistentRead when querying a global secondary index.
*
*
* @param queryRequest
* Represents the input of a Query operation.
* @return A Java Future containing the result of the Query operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ProvisionedThroughputExceededException Your request rate is too high. The AWS SDKs for DynamoDB
* automatically retry requests that receive this exception. Your request is eventually successful, unless
* your retry queue is too large to finish. Reduce the frequency of requests and use exponential backoff.
* For more information, go to Error Retries and Exponential Backoff in the Amazon DynamoDB Developer Guide.
* - ResourceNotFoundException The operation tried to access a nonexistent table or index. The resource
* might not be specified correctly, or its status might not be
ACTIVE.
* - RequestLimitExceededException Throughput exceeds the current throughput quota for your account.
* Please contact AWS Support at AWS Support to request a quota
* increase.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.Query
* @see AWS API
* Documentation
*/
default CompletableFuture query(QueryRequest queryRequest) {
throw new UnsupportedOperationException();
}
/**
*
* The Query operation finds items based on primary key values. You can query any table or secondary
* index that has a composite primary key (a partition key and a sort key).
*
*
* Use the KeyConditionExpression parameter to provide a specific value for the partition key. The
* Query operation will return all of the items from the table or index with that partition key value.
* You can optionally narrow the scope of the Query operation by specifying a sort key value and a
* comparison operator in KeyConditionExpression. To further refine the Query results, you
* can optionally provide a FilterExpression. A FilterExpression determines which items
* within the results should be returned to you. All of the other results are discarded.
*
*
* A Query operation always returns a result set. If no matching items are found, the result set will
* be empty. Queries that do not return results consume the minimum number of read capacity units for that type of
* read operation.
*
*
*
* DynamoDB calculates the number of read capacity units consumed based on item size, not on the amount of data that
* is returned to an application. The number of capacity units consumed will be the same whether you request all of
* the attributes (the default behavior) or just some of them (using a projection expression). The number will also
* be the same whether or not you use a FilterExpression.
*
*
*
* Query results are always sorted by the sort key value. If the data type of the sort key is Number,
* the results are returned in numeric order; otherwise, the results are returned in order of UTF-8 bytes. By
* default, the sort order is ascending. To reverse the order, set the ScanIndexForward parameter to
* false.
*
*
* A single Query operation will read up to the maximum number of items set (if using the
* Limit parameter) or a maximum of 1 MB of data and then apply any filtering to the results using
* FilterExpression. If LastEvaluatedKey is present in the response, you will need to
* paginate the result set. For more information, see Paginating
* the Results in the Amazon DynamoDB Developer Guide.
*
*
* FilterExpression is applied after a Query finishes, but before the results are
* returned. A FilterExpression cannot contain partition key or sort key attributes. You need to
* specify those attributes in the KeyConditionExpression.
*
*
*
* A Query operation can return an empty result set and a LastEvaluatedKey if all the
* items read for the page of results are filtered out.
*
*
*
* You can query a table, a local secondary index, or a global secondary index. For a query on a table or on a local
* secondary index, you can set the ConsistentRead parameter to true and obtain a strongly
* consistent result. Global secondary indexes support eventually consistent reads only, so do not specify
* ConsistentRead when querying a global secondary index.
*
*
*
* This is a convenience which creates an instance of the {@link QueryRequest.Builder} avoiding the need to create
* one manually via {@link QueryRequest#builder()}
*
*
* @param queryRequest
* A {@link Consumer} that will call methods on {@link QueryInput.Builder} to create a request. Represents
* the input of a Query operation.
* @return A Java Future containing the result of the Query operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ProvisionedThroughputExceededException Your request rate is too high. The AWS SDKs for DynamoDB
* automatically retry requests that receive this exception. Your request is eventually successful, unless
* your retry queue is too large to finish. Reduce the frequency of requests and use exponential backoff.
* For more information, go to Error Retries and Exponential Backoff in the Amazon DynamoDB Developer Guide.
* - ResourceNotFoundException The operation tried to access a nonexistent table or index. The resource
* might not be specified correctly, or its status might not be
ACTIVE.
* - RequestLimitExceededException Throughput exceeds the current throughput quota for your account.
* Please contact AWS Support at AWS Support to request a quota
* increase.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.Query
* @see AWS API
* Documentation
*/
default CompletableFuture query(Consumer queryRequest) {
return query(QueryRequest.builder().applyMutation(queryRequest).build());
}
/**
*
* The Query operation finds items based on primary key values. You can query any table or secondary
* index that has a composite primary key (a partition key and a sort key).
*
*
* Use the KeyConditionExpression parameter to provide a specific value for the partition key. The
* Query operation will return all of the items from the table or index with that partition key value.
* You can optionally narrow the scope of the Query operation by specifying a sort key value and a
* comparison operator in KeyConditionExpression. To further refine the Query results, you
* can optionally provide a FilterExpression. A FilterExpression determines which items
* within the results should be returned to you. All of the other results are discarded.
*
*
* A Query operation always returns a result set. If no matching items are found, the result set will
* be empty. Queries that do not return results consume the minimum number of read capacity units for that type of
* read operation.
*
*
*
* DynamoDB calculates the number of read capacity units consumed based on item size, not on the amount of data that
* is returned to an application. The number of capacity units consumed will be the same whether you request all of
* the attributes (the default behavior) or just some of them (using a projection expression). The number will also
* be the same whether or not you use a FilterExpression.
*
*
*
* Query results are always sorted by the sort key value. If the data type of the sort key is Number,
* the results are returned in numeric order; otherwise, the results are returned in order of UTF-8 bytes. By
* default, the sort order is ascending. To reverse the order, set the ScanIndexForward parameter to
* false.
*
*
* A single Query operation will read up to the maximum number of items set (if using the
* Limit parameter) or a maximum of 1 MB of data and then apply any filtering to the results using
* FilterExpression. If LastEvaluatedKey is present in the response, you will need to
* paginate the result set. For more information, see Paginating
* the Results in the Amazon DynamoDB Developer Guide.
*
*
* FilterExpression is applied after a Query finishes, but before the results are
* returned. A FilterExpression cannot contain partition key or sort key attributes. You need to
* specify those attributes in the KeyConditionExpression.
*
*
*
* A Query operation can return an empty result set and a LastEvaluatedKey if all the
* items read for the page of results are filtered out.
*
*
*
* You can query a table, a local secondary index, or a global secondary index. For a query on a table or on a local
* secondary index, you can set the ConsistentRead parameter to true and obtain a strongly
* consistent result. Global secondary indexes support eventually consistent reads only, so do not specify
* ConsistentRead when querying a global secondary index.
*
*
*
* This is a variant of {@link #query(software.amazon.awssdk.services.dynamodb.model.QueryRequest)} 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
* {@link org.reactivestreams.Publisher#subscribe(org.reactivestreams.Subscriber)}. Each call to the subscribe
* method will result in a new {@link org.reactivestreams.Subscription} 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 method
*
*
* {@code
* software.amazon.awssdk.services.dynamodb.paginators.QueryPublisher publisher = client.queryPaginator(request);
* CompletableFuture future = publisher.subscribe(res -> { // Do something with the response });
* future.get();
* }
*
*
* 2) Using a custom subscriber
*
*
* {@code
* software.amazon.awssdk.services.dynamodb.paginators.QueryPublisher publisher = client.queryPaginator(request);
* publisher.subscribe(new Subscriber() {
*
* public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
*
*
* public void onNext(software.amazon.awssdk.services.dynamodb.model.QueryResponse response) { //... };
* });}
*
*
* As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.
*
* Please notice that the configuration of Limit 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
* {@link #query(software.amazon.awssdk.services.dynamodb.model.QueryRequest)} operation.
*
*
* @param queryRequest
* Represents the input of a Query operation.
* @return 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.
*
* - ProvisionedThroughputExceededException Your request rate is too high. The AWS SDKs for DynamoDB
* automatically retry requests that receive this exception. Your request is eventually successful, unless
* your retry queue is too large to finish. Reduce the frequency of requests and use exponential backoff.
* For more information, go to Error Retries and Exponential Backoff in the Amazon DynamoDB Developer Guide.
* - ResourceNotFoundException The operation tried to access a nonexistent table or index. The resource
* might not be specified correctly, or its status might not be
ACTIVE.
* - RequestLimitExceededException Throughput exceeds the current throughput quota for your account.
* Please contact AWS Support at AWS Support to request a quota
* increase.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.Query
* @see AWS API
* Documentation
*/
default QueryPublisher queryPaginator(QueryRequest queryRequest) {
throw new UnsupportedOperationException();
}
/**
*
* The Query operation finds items based on primary key values. You can query any table or secondary
* index that has a composite primary key (a partition key and a sort key).
*
*
* Use the KeyConditionExpression parameter to provide a specific value for the partition key. The
* Query operation will return all of the items from the table or index with that partition key value.
* You can optionally narrow the scope of the Query operation by specifying a sort key value and a
* comparison operator in KeyConditionExpression. To further refine the Query results, you
* can optionally provide a FilterExpression. A FilterExpression determines which items
* within the results should be returned to you. All of the other results are discarded.
*
*
* A Query operation always returns a result set. If no matching items are found, the result set will
* be empty. Queries that do not return results consume the minimum number of read capacity units for that type of
* read operation.
*
*
*
* DynamoDB calculates the number of read capacity units consumed based on item size, not on the amount of data that
* is returned to an application. The number of capacity units consumed will be the same whether you request all of
* the attributes (the default behavior) or just some of them (using a projection expression). The number will also
* be the same whether or not you use a FilterExpression.
*
*
*
* Query results are always sorted by the sort key value. If the data type of the sort key is Number,
* the results are returned in numeric order; otherwise, the results are returned in order of UTF-8 bytes. By
* default, the sort order is ascending. To reverse the order, set the ScanIndexForward parameter to
* false.
*
*
* A single Query operation will read up to the maximum number of items set (if using the
* Limit parameter) or a maximum of 1 MB of data and then apply any filtering to the results using
* FilterExpression. If LastEvaluatedKey is present in the response, you will need to
* paginate the result set. For more information, see Paginating
* the Results in the Amazon DynamoDB Developer Guide.
*
*
* FilterExpression is applied after a Query finishes, but before the results are
* returned. A FilterExpression cannot contain partition key or sort key attributes. You need to
* specify those attributes in the KeyConditionExpression.
*
*
*
* A Query operation can return an empty result set and a LastEvaluatedKey if all the
* items read for the page of results are filtered out.
*
*
*
* You can query a table, a local secondary index, or a global secondary index. For a query on a table or on a local
* secondary index, you can set the ConsistentRead parameter to true and obtain a strongly
* consistent result. Global secondary indexes support eventually consistent reads only, so do not specify
* ConsistentRead when querying a global secondary index.
*
*
*
* This is a variant of {@link #query(software.amazon.awssdk.services.dynamodb.model.QueryRequest)} 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
* {@link org.reactivestreams.Publisher#subscribe(org.reactivestreams.Subscriber)}. Each call to the subscribe
* method will result in a new {@link org.reactivestreams.Subscription} 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 method
*
*
* {@code
* software.amazon.awssdk.services.dynamodb.paginators.QueryPublisher publisher = client.queryPaginator(request);
* CompletableFuture future = publisher.subscribe(res -> { // Do something with the response });
* future.get();
* }
*
*
* 2) Using a custom subscriber
*
*
* {@code
* software.amazon.awssdk.services.dynamodb.paginators.QueryPublisher publisher = client.queryPaginator(request);
* publisher.subscribe(new Subscriber() {
*
* public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
*
*
* public void onNext(software.amazon.awssdk.services.dynamodb.model.QueryResponse response) { //... };
* });}
*
*
* As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.
*
* Please notice that the configuration of Limit 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
* {@link #query(software.amazon.awssdk.services.dynamodb.model.QueryRequest)} operation.
*
*
* This is a convenience which creates an instance of the {@link QueryRequest.Builder} avoiding the need to create
* one manually via {@link QueryRequest#builder()}
*
*
* @param queryRequest
* A {@link Consumer} that will call methods on {@link QueryInput.Builder} to create a request. Represents
* the input of a Query operation.
* @return 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.
*
* - ProvisionedThroughputExceededException Your request rate is too high. The AWS SDKs for DynamoDB
* automatically retry requests that receive this exception. Your request is eventually successful, unless
* your retry queue is too large to finish. Reduce the frequency of requests and use exponential backoff.
* For more information, go to Error Retries and Exponential Backoff in the Amazon DynamoDB Developer Guide.
* - ResourceNotFoundException The operation tried to access a nonexistent table or index. The resource
* might not be specified correctly, or its status might not be
ACTIVE.
* - RequestLimitExceededException Throughput exceeds the current throughput quota for your account.
* Please contact AWS Support at AWS Support to request a quota
* increase.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.Query
* @see AWS API
* Documentation
*/
default QueryPublisher queryPaginator(Consumer queryRequest) {
return queryPaginator(QueryRequest.builder().applyMutation(queryRequest).build());
}
/**
*
* Creates a new table from an existing backup. Any number of users can execute up to 4 concurrent restores (any
* type of restore) in a given account.
*
*
* You can call RestoreTableFromBackup at a maximum rate of 10 times per second.
*
*
* You must manually set up the following on the restored table:
*
*
* -
*
* Auto scaling policies
*
*
* -
*
* IAM policies
*
*
* -
*
* Amazon CloudWatch metrics and alarms
*
*
* -
*
* Tags
*
*
* -
*
* Stream settings
*
*
* -
*
* Time to Live (TTL) settings
*
*
*
*
* @param restoreTableFromBackupRequest
* @return A Java Future containing the result of the RestoreTableFromBackup operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - TableAlreadyExistsException A target table with the specified name already exists.
* - TableInUseException A target table with the specified name is either being created or deleted.
* - BackupNotFoundException Backup not found for the given BackupARN.
* - BackupInUseException There is another ongoing conflicting backup control plane operation on the
* table. The backup is either being created, deleted or restored to a table.
* - LimitExceededException There is no limit to the number of daily on-demand backups that can be taken.
*
*
* Up to 50 simultaneous table operations are allowed per account. These operations include
* CreateTable, UpdateTable, DeleteTable,
* UpdateTimeToLive, RestoreTableFromBackup, and
* RestoreTableToPointInTime.
*
*
* The only exception is when you are creating a table with one or more secondary indexes. You can have up
* to 25 such requests running at a time; however, if the table or index specifications are complex,
* DynamoDB might temporarily reduce the number of concurrent operations.
*
*
* There is a soft account quota of 256 tables.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.RestoreTableFromBackup
* @see AWS API Documentation
*/
default CompletableFuture restoreTableFromBackup(
RestoreTableFromBackupRequest restoreTableFromBackupRequest) {
throw new UnsupportedOperationException();
}
/**
*
* Creates a new table from an existing backup. Any number of users can execute up to 4 concurrent restores (any
* type of restore) in a given account.
*
*
* You can call RestoreTableFromBackup at a maximum rate of 10 times per second.
*
*
* You must manually set up the following on the restored table:
*
*
* -
*
* Auto scaling policies
*
*
* -
*
* IAM policies
*
*
* -
*
* Amazon CloudWatch metrics and alarms
*
*
* -
*
* Tags
*
*
* -
*
* Stream settings
*
*
* -
*
* Time to Live (TTL) settings
*
*
*
*
*
* This is a convenience which creates an instance of the {@link RestoreTableFromBackupRequest.Builder} avoiding the
* need to create one manually via {@link RestoreTableFromBackupRequest#builder()}
*
*
* @param restoreTableFromBackupRequest
* A {@link Consumer} that will call methods on {@link RestoreTableFromBackupInput.Builder} to create a
* request.
* @return A Java Future containing the result of the RestoreTableFromBackup operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - TableAlreadyExistsException A target table with the specified name already exists.
* - TableInUseException A target table with the specified name is either being created or deleted.
* - BackupNotFoundException Backup not found for the given BackupARN.
* - BackupInUseException There is another ongoing conflicting backup control plane operation on the
* table. The backup is either being created, deleted or restored to a table.
* - LimitExceededException There is no limit to the number of daily on-demand backups that can be taken.
*
*
* Up to 50 simultaneous table operations are allowed per account. These operations include
* CreateTable, UpdateTable, DeleteTable,
* UpdateTimeToLive, RestoreTableFromBackup, and
* RestoreTableToPointInTime.
*
*
* The only exception is when you are creating a table with one or more secondary indexes. You can have up
* to 25 such requests running at a time; however, if the table or index specifications are complex,
* DynamoDB might temporarily reduce the number of concurrent operations.
*
*
* There is a soft account quota of 256 tables.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.RestoreTableFromBackup
* @see AWS API Documentation
*/
default CompletableFuture restoreTableFromBackup(
Consumer restoreTableFromBackupRequest) {
return restoreTableFromBackup(RestoreTableFromBackupRequest.builder().applyMutation(restoreTableFromBackupRequest)
.build());
}
/**
*
* Restores the specified table to the specified point in time within EarliestRestorableDateTime and
* LatestRestorableDateTime. You can restore your table to any point in time during the last 35 days.
* Any number of users can execute up to 4 concurrent restores (any type of restore) in a given account.
*
*
* When you restore using point in time recovery, DynamoDB restores your table data to the state based on the
* selected date and time (day:hour:minute:second) to a new table.
*
*
* Along with data, the following are also included on the new restored table using point in time recovery:
*
*
* -
*
* Global secondary indexes (GSIs)
*
*
* -
*
* Local secondary indexes (LSIs)
*
*
* -
*
* Provisioned read and write capacity
*
*
* -
*
* Encryption settings
*
*
*
* All these settings come from the current settings of the source table at the time of restore.
*
*
*
*
* You must manually set up the following on the restored table:
*
*
* -
*
* Auto scaling policies
*
*
* -
*
* IAM policies
*
*
* -
*
* Amazon CloudWatch metrics and alarms
*
*
* -
*
* Tags
*
*
* -
*
* Stream settings
*
*
* -
*
* Time to Live (TTL) settings
*
*
* -
*
* Point in time recovery settings
*
*
*
*
* @param restoreTableToPointInTimeRequest
* @return A Java Future containing the result of the RestoreTableToPointInTime operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - TableAlreadyExistsException A target table with the specified name already exists.
* - TableNotFoundException A source table with the name
TableName does not currently exist
* within the subscriber's account.
* - TableInUseException A target table with the specified name is either being created or deleted.
* - LimitExceededException There is no limit to the number of daily on-demand backups that can be taken.
*
*
* Up to 50 simultaneous table operations are allowed per account. These operations include
* CreateTable, UpdateTable, DeleteTable,
* UpdateTimeToLive, RestoreTableFromBackup, and
* RestoreTableToPointInTime.
*
*
* The only exception is when you are creating a table with one or more secondary indexes. You can have up
* to 25 such requests running at a time; however, if the table or index specifications are complex,
* DynamoDB might temporarily reduce the number of concurrent operations.
*
*
* There is a soft account quota of 256 tables.
* - InvalidRestoreTimeException An invalid restore time was specified. RestoreDateTime must be between
* EarliestRestorableDateTime and LatestRestorableDateTime.
* - PointInTimeRecoveryUnavailableException Point in time recovery has not yet been enabled for this
* source table.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.RestoreTableToPointInTime
* @see AWS API Documentation
*/
default CompletableFuture restoreTableToPointInTime(
RestoreTableToPointInTimeRequest restoreTableToPointInTimeRequest) {
throw new UnsupportedOperationException();
}
/**
*
* Restores the specified table to the specified point in time within EarliestRestorableDateTime and
* LatestRestorableDateTime. You can restore your table to any point in time during the last 35 days.
* Any number of users can execute up to 4 concurrent restores (any type of restore) in a given account.
*
*
* When you restore using point in time recovery, DynamoDB restores your table data to the state based on the
* selected date and time (day:hour:minute:second) to a new table.
*
*
* Along with data, the following are also included on the new restored table using point in time recovery:
*
*
* -
*
* Global secondary indexes (GSIs)
*
*
* -
*
* Local secondary indexes (LSIs)
*
*
* -
*
* Provisioned read and write capacity
*
*
* -
*
* Encryption settings
*
*
*
* All these settings come from the current settings of the source table at the time of restore.
*
*
*
*
* You must manually set up the following on the restored table:
*
*
* -
*
* Auto scaling policies
*
*
* -
*
* IAM policies
*
*
* -
*
* Amazon CloudWatch metrics and alarms
*
*
* -
*
* Tags
*
*
* -
*
* Stream settings
*
*
* -
*
* Time to Live (TTL) settings
*
*
* -
*
* Point in time recovery settings
*
*
*
*
*
* This is a convenience which creates an instance of the {@link RestoreTableToPointInTimeRequest.Builder} avoiding
* the need to create one manually via {@link RestoreTableToPointInTimeRequest#builder()}
*
*
* @param restoreTableToPointInTimeRequest
* A {@link Consumer} that will call methods on {@link RestoreTableToPointInTimeInput.Builder} to create a
* request.
* @return A Java Future containing the result of the RestoreTableToPointInTime operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - TableAlreadyExistsException A target table with the specified name already exists.
* - TableNotFoundException A source table with the name
TableName does not currently exist
* within the subscriber's account.
* - TableInUseException A target table with the specified name is either being created or deleted.
* - LimitExceededException There is no limit to the number of daily on-demand backups that can be taken.
*
*
* Up to 50 simultaneous table operations are allowed per account. These operations include
* CreateTable, UpdateTable, DeleteTable,
* UpdateTimeToLive, RestoreTableFromBackup, and
* RestoreTableToPointInTime.
*
*
* The only exception is when you are creating a table with one or more secondary indexes. You can have up
* to 25 such requests running at a time; however, if the table or index specifications are complex,
* DynamoDB might temporarily reduce the number of concurrent operations.
*
*
* There is a soft account quota of 256 tables.
* - InvalidRestoreTimeException An invalid restore time was specified. RestoreDateTime must be between
* EarliestRestorableDateTime and LatestRestorableDateTime.
* - PointInTimeRecoveryUnavailableException Point in time recovery has not yet been enabled for this
* source table.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.RestoreTableToPointInTime
* @see AWS API Documentation
*/
default CompletableFuture restoreTableToPointInTime(
Consumer restoreTableToPointInTimeRequest) {
return restoreTableToPointInTime(RestoreTableToPointInTimeRequest.builder()
.applyMutation(restoreTableToPointInTimeRequest).build());
}
/**
*
* The Scan operation returns one or more items and item attributes by accessing every item in a table
* or a secondary index. To have DynamoDB return fewer items, you can provide a FilterExpression
* operation.
*
*
* If the total number of scanned items exceeds the maximum dataset size limit of 1 MB, the scan stops and results
* are returned to the user as a LastEvaluatedKey value to continue the scan in a subsequent operation.
* The results also include the number of items exceeding the limit. A scan can result in no table data meeting the
* filter criteria.
*
*
* A single Scan operation reads up to the maximum number of items set (if using the Limit
* parameter) or a maximum of 1 MB of data and then apply any filtering to the results using
* FilterExpression. If LastEvaluatedKey is present in the response, you need to paginate
* the result set. For more information, see Paginating the
* Results in the Amazon DynamoDB Developer Guide.
*
*
* Scan operations proceed sequentially; however, for faster performance on a large table or secondary
* index, applications can request a parallel Scan operation by providing the Segment and
* TotalSegments parameters. For more information, see Parallel
* Scan in the Amazon DynamoDB Developer Guide.
*
*
* Scan uses eventually consistent reads when accessing the data in a table; therefore, the result set
* might not include the changes to data in the table immediately before the operation began. If you need a
* consistent copy of the data, as of the time that the Scan begins, you can set the
* ConsistentRead parameter to true.
*
*
* @param scanRequest
* Represents the input of a Scan operation.
* @return A Java Future containing the result of the Scan operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ProvisionedThroughputExceededException Your request rate is too high. The AWS SDKs for DynamoDB
* automatically retry requests that receive this exception. Your request is eventually successful, unless
* your retry queue is too large to finish. Reduce the frequency of requests and use exponential backoff.
* For more information, go to Error Retries and Exponential Backoff in the Amazon DynamoDB Developer Guide.
* - ResourceNotFoundException The operation tried to access a nonexistent table or index. The resource
* might not be specified correctly, or its status might not be
ACTIVE.
* - RequestLimitExceededException Throughput exceeds the current throughput quota for your account.
* Please contact AWS Support at AWS Support to request a quota
* increase.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.Scan
* @see AWS API
* Documentation
*/
default CompletableFuture scan(ScanRequest scanRequest) {
throw new UnsupportedOperationException();
}
/**
*
* The Scan operation returns one or more items and item attributes by accessing every item in a table
* or a secondary index. To have DynamoDB return fewer items, you can provide a FilterExpression
* operation.
*
*
* If the total number of scanned items exceeds the maximum dataset size limit of 1 MB, the scan stops and results
* are returned to the user as a LastEvaluatedKey value to continue the scan in a subsequent operation.
* The results also include the number of items exceeding the limit. A scan can result in no table data meeting the
* filter criteria.
*
*
* A single Scan operation reads up to the maximum number of items set (if using the Limit
* parameter) or a maximum of 1 MB of data and then apply any filtering to the results using
* FilterExpression. If LastEvaluatedKey is present in the response, you need to paginate
* the result set. For more information, see Paginating the
* Results in the Amazon DynamoDB Developer Guide.
*
*
* Scan operations proceed sequentially; however, for faster performance on a large table or secondary
* index, applications can request a parallel Scan operation by providing the Segment and
* TotalSegments parameters. For more information, see Parallel
* Scan in the Amazon DynamoDB Developer Guide.
*
*
* Scan uses eventually consistent reads when accessing the data in a table; therefore, the result set
* might not include the changes to data in the table immediately before the operation began. If you need a
* consistent copy of the data, as of the time that the Scan begins, you can set the
* ConsistentRead parameter to true.
*
*
*
* This is a convenience which creates an instance of the {@link ScanRequest.Builder} avoiding the need to create
* one manually via {@link ScanRequest#builder()}
*
*
* @param scanRequest
* A {@link Consumer} that will call methods on {@link ScanInput.Builder} to create a request. Represents the
* input of a Scan operation.
* @return A Java Future containing the result of the Scan operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ProvisionedThroughputExceededException Your request rate is too high. The AWS SDKs for DynamoDB
* automatically retry requests that receive this exception. Your request is eventually successful, unless
* your retry queue is too large to finish. Reduce the frequency of requests and use exponential backoff.
* For more information, go to Error Retries and Exponential Backoff in the Amazon DynamoDB Developer Guide.
* - ResourceNotFoundException The operation tried to access a nonexistent table or index. The resource
* might not be specified correctly, or its status might not be
ACTIVE.
* - RequestLimitExceededException Throughput exceeds the current throughput quota for your account.
* Please contact AWS Support at AWS Support to request a quota
* increase.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.Scan
* @see AWS API
* Documentation
*/
default CompletableFuture scan(Consumer scanRequest) {
return scan(ScanRequest.builder().applyMutation(scanRequest).build());
}
/**
*
* The Scan operation returns one or more items and item attributes by accessing every item in a table
* or a secondary index. To have DynamoDB return fewer items, you can provide a FilterExpression
* operation.
*
*
* If the total number of scanned items exceeds the maximum dataset size limit of 1 MB, the scan stops and results
* are returned to the user as a LastEvaluatedKey value to continue the scan in a subsequent operation.
* The results also include the number of items exceeding the limit. A scan can result in no table data meeting the
* filter criteria.
*
*
* A single Scan operation reads up to the maximum number of items set (if using the Limit
* parameter) or a maximum of 1 MB of data and then apply any filtering to the results using
* FilterExpression. If LastEvaluatedKey is present in the response, you need to paginate
* the result set. For more information, see Paginating the
* Results in the Amazon DynamoDB Developer Guide.
*
*
* Scan operations proceed sequentially; however, for faster performance on a large table or secondary
* index, applications can request a parallel Scan operation by providing the Segment and
* TotalSegments parameters. For more information, see Parallel
* Scan in the Amazon DynamoDB Developer Guide.
*
*
* Scan uses eventually consistent reads when accessing the data in a table; therefore, the result set
* might not include the changes to data in the table immediately before the operation began. If you need a
* consistent copy of the data, as of the time that the Scan begins, you can set the
* ConsistentRead parameter to true.
*
*
*
* This is a variant of {@link #scan(software.amazon.awssdk.services.dynamodb.model.ScanRequest)} 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
* {@link org.reactivestreams.Publisher#subscribe(org.reactivestreams.Subscriber)}. Each call to the subscribe
* method will result in a new {@link org.reactivestreams.Subscription} 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 method
*
*
* {@code
* software.amazon.awssdk.services.dynamodb.paginators.ScanPublisher publisher = client.scanPaginator(request);
* CompletableFuture future = publisher.subscribe(res -> { // Do something with the response });
* future.get();
* }
*
*
* 2) Using a custom subscriber
*
*
* {@code
* software.amazon.awssdk.services.dynamodb.paginators.ScanPublisher publisher = client.scanPaginator(request);
* publisher.subscribe(new Subscriber() {
*
* public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
*
*
* public void onNext(software.amazon.awssdk.services.dynamodb.model.ScanResponse response) { //... };
* });}
*
*
* As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.
*
* Please notice that the configuration of Limit 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
* {@link #scan(software.amazon.awssdk.services.dynamodb.model.ScanRequest)} operation.
*
*
* @param scanRequest
* Represents the input of a Scan operation.
* @return 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.
*
* - ProvisionedThroughputExceededException Your request rate is too high. The AWS SDKs for DynamoDB
* automatically retry requests that receive this exception. Your request is eventually successful, unless
* your retry queue is too large to finish. Reduce the frequency of requests and use exponential backoff.
* For more information, go to Error Retries and Exponential Backoff in the Amazon DynamoDB Developer Guide.
* - ResourceNotFoundException The operation tried to access a nonexistent table or index. The resource
* might not be specified correctly, or its status might not be
ACTIVE.
* - RequestLimitExceededException Throughput exceeds the current throughput quota for your account.
* Please contact AWS Support at AWS Support to request a quota
* increase.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.Scan
* @see AWS API
* Documentation
*/
default ScanPublisher scanPaginator(ScanRequest scanRequest) {
throw new UnsupportedOperationException();
}
/**
*
* The Scan operation returns one or more items and item attributes by accessing every item in a table
* or a secondary index. To have DynamoDB return fewer items, you can provide a FilterExpression
* operation.
*
*
* If the total number of scanned items exceeds the maximum dataset size limit of 1 MB, the scan stops and results
* are returned to the user as a LastEvaluatedKey value to continue the scan in a subsequent operation.
* The results also include the number of items exceeding the limit. A scan can result in no table data meeting the
* filter criteria.
*
*
* A single Scan operation reads up to the maximum number of items set (if using the Limit
* parameter) or a maximum of 1 MB of data and then apply any filtering to the results using
* FilterExpression. If LastEvaluatedKey is present in the response, you need to paginate
* the result set. For more information, see Paginating the
* Results in the Amazon DynamoDB Developer Guide.
*
*
* Scan operations proceed sequentially; however, for faster performance on a large table or secondary
* index, applications can request a parallel Scan operation by providing the Segment and
* TotalSegments parameters. For more information, see Parallel
* Scan in the Amazon DynamoDB Developer Guide.
*
*
* Scan uses eventually consistent reads when accessing the data in a table; therefore, the result set
* might not include the changes to data in the table immediately before the operation began. If you need a
* consistent copy of the data, as of the time that the Scan begins, you can set the
* ConsistentRead parameter to true.
*
*
*
* This is a variant of {@link #scan(software.amazon.awssdk.services.dynamodb.model.ScanRequest)} 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
* {@link org.reactivestreams.Publisher#subscribe(org.reactivestreams.Subscriber)}. Each call to the subscribe
* method will result in a new {@link org.reactivestreams.Subscription} 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 method
*
*
* {@code
* software.amazon.awssdk.services.dynamodb.paginators.ScanPublisher publisher = client.scanPaginator(request);
* CompletableFuture future = publisher.subscribe(res -> { // Do something with the response });
* future.get();
* }
*
*
* 2) Using a custom subscriber
*
*
* {@code
* software.amazon.awssdk.services.dynamodb.paginators.ScanPublisher publisher = client.scanPaginator(request);
* publisher.subscribe(new Subscriber() {
*
* public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
*
*
* public void onNext(software.amazon.awssdk.services.dynamodb.model.ScanResponse response) { //... };
* });}
*
*
* As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.
*
* Please notice that the configuration of Limit 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
* {@link #scan(software.amazon.awssdk.services.dynamodb.model.ScanRequest)} operation.
*
*
* This is a convenience which creates an instance of the {@link ScanRequest.Builder} avoiding the need to create
* one manually via {@link ScanRequest#builder()}
*
*
* @param scanRequest
* A {@link Consumer} that will call methods on {@link ScanInput.Builder} to create a request. Represents the
* input of a Scan operation.
* @return 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.
*
* - ProvisionedThroughputExceededException Your request rate is too high. The AWS SDKs for DynamoDB
* automatically retry requests that receive this exception. Your request is eventually successful, unless
* your retry queue is too large to finish. Reduce the frequency of requests and use exponential backoff.
* For more information, go to Error Retries and Exponential Backoff in the Amazon DynamoDB Developer Guide.
* - ResourceNotFoundException The operation tried to access a nonexistent table or index. The resource
* might not be specified correctly, or its status might not be
ACTIVE.
* - RequestLimitExceededException Throughput exceeds the current throughput quota for your account.
* Please contact AWS Support at AWS Support to request a quota
* increase.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.Scan
* @see AWS API
* Documentation
*/
default ScanPublisher scanPaginator(Consumer scanRequest) {
return scanPaginator(ScanRequest.builder().applyMutation(scanRequest).build());
}
/**
*
* Associate a set of tags with an Amazon DynamoDB resource. You can then activate these user-defined tags so that
* they appear on the Billing and Cost Management console for cost allocation tracking. You can call TagResource up
* to five times per second, per account.
*
*
* For an overview on tagging DynamoDB resources, see Tagging for DynamoDB in
* the Amazon DynamoDB Developer Guide.
*
*
* @param tagResourceRequest
* @return A Java Future containing the result of the TagResource operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - LimitExceededException There is no limit to the number of daily on-demand backups that can be taken.
*
*
* Up to 50 simultaneous table operations are allowed per account. These operations include
* CreateTable, UpdateTable, DeleteTable,
* UpdateTimeToLive, RestoreTableFromBackup, and
* RestoreTableToPointInTime.
*
*
* The only exception is when you are creating a table with one or more secondary indexes. You can have up
* to 25 such requests running at a time; however, if the table or index specifications are complex,
* DynamoDB might temporarily reduce the number of concurrent operations.
*
*
* There is a soft account quota of 256 tables.
* - ResourceNotFoundException The operation tried to access a nonexistent table or index. The resource
* might not be specified correctly, or its status might not be
ACTIVE.
* - InternalServerErrorException An error occurred on the server side.
* - ResourceInUseException The operation conflicts with the resource's availability. For example, you
* attempted to recreate an existing table, or tried to delete a table currently in the
*
CREATING 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.TagResource
* @see AWS API
* Documentation
*/
default CompletableFuture tagResource(TagResourceRequest tagResourceRequest) {
throw new UnsupportedOperationException();
}
/**
*
* Associate a set of tags with an Amazon DynamoDB resource. You can then activate these user-defined tags so that
* they appear on the Billing and Cost Management console for cost allocation tracking. You can call TagResource up
* to five times per second, per account.
*
*
* For an overview on tagging DynamoDB resources, see Tagging for DynamoDB in
* the Amazon DynamoDB Developer Guide.
*
*
*
* This is a convenience which creates an instance of the {@link TagResourceRequest.Builder} avoiding the need to
* create one manually via {@link TagResourceRequest#builder()}
*
*
* @param tagResourceRequest
* A {@link Consumer} that will call methods on {@link TagResourceInput.Builder} to create a request.
* @return A Java Future containing the result of the TagResource operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - LimitExceededException There is no limit to the number of daily on-demand backups that can be taken.
*
*
* Up to 50 simultaneous table operations are allowed per account. These operations include
* CreateTable, UpdateTable, DeleteTable,
* UpdateTimeToLive, RestoreTableFromBackup, and
* RestoreTableToPointInTime.
*
*
* The only exception is when you are creating a table with one or more secondary indexes. You can have up
* to 25 such requests running at a time; however, if the table or index specifications are complex,
* DynamoDB might temporarily reduce the number of concurrent operations.
*
*
* There is a soft account quota of 256 tables.
* - ResourceNotFoundException The operation tried to access a nonexistent table or index. The resource
* might not be specified correctly, or its status might not be
ACTIVE.
* - InternalServerErrorException An error occurred on the server side.
* - ResourceInUseException The operation conflicts with the resource's availability. For example, you
* attempted to recreate an existing table, or tried to delete a table currently in the
*
CREATING 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.TagResource
* @see AWS API
* Documentation
*/
default CompletableFuture tagResource(Consumer tagResourceRequest) {
return tagResource(TagResourceRequest.builder().applyMutation(tagResourceRequest).build());
}
/**
*
* TransactGetItems is a synchronous operation that atomically retrieves multiple items from one or
* more tables (but not from indexes) in a single account and Region. A TransactGetItems call can
* contain up to 25 TransactGetItem objects, each of which contains a Get structure that
* specifies an item to retrieve from a table in the account and Region. A call to TransactGetItems
* cannot retrieve items from tables in more than one AWS account or Region. The aggregate size of the items in the
* transaction cannot exceed 4 MB.
*
*
* DynamoDB rejects the entire TransactGetItems request if any of the following is true:
*
*
* -
*
* A conflicting operation is in the process of updating an item to be read.
*
*
* -
*
* There is insufficient provisioned capacity for the transaction to be completed.
*
*
* -
*
* There is a user error, such as an invalid data format.
*
*
* -
*
* The aggregate size of the items in the transaction cannot exceed 4 MB.
*
*
*
*
* @param transactGetItemsRequest
* @return A Java Future containing the result of the TransactGetItems operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ResourceNotFoundException The operation tried to access a nonexistent table or index. The resource
* might not be specified correctly, or its status might not be
ACTIVE.
* - TransactionCanceledException The entire transaction request was canceled.
*
* DynamoDB cancels a TransactWriteItems request under the following circumstances:
*
*
* -
*
* A condition in one of the condition expressions is not met.
*
*
* -
*
* A table in the TransactWriteItems request is in a different account or region.
*
*
* -
*
* More than one action in the TransactWriteItems operation targets the same item.
*
*
* -
*
* There is insufficient provisioned capacity for the transaction to be completed.
*
*
* -
*
* An item size becomes too large (larger than 400 KB), or a local secondary index (LSI) becomes too large,
* or a similar validation error occurs because of changes made by the transaction.
*
*
* -
*
* There is a user error, such as an invalid data format.
*
*
*
*
* DynamoDB cancels a TransactGetItems request under the following circumstances:
*
*
* -
*
* There is an ongoing TransactGetItems operation that conflicts with a concurrent
* PutItem, UpdateItem, DeleteItem or TransactWriteItems
* request. In this case the TransactGetItems operation fails with a
* TransactionCanceledException.
*
*
* -
*
* A table in the TransactGetItems request is in a different account or region.
*
*
* -
*
* There is insufficient provisioned capacity for the transaction to be completed.
*
*
* -
*
* There is a user error, such as an invalid data format.
*
*
*
*
*
* If using Java, DynamoDB lists the cancellation reasons on the CancellationReasons property.
* This property is not set for other languages. Transaction cancellation reasons are ordered in the order
* of requested items, if an item has no error it will have NONE code and Null
* message.
*
*
*
* Cancellation reason codes and possible error messages:
*
*
* -
*
* No Errors:
*
*
* -
*
* Code: NONE
*
*
* -
*
* Message: null
*
*
*
*
* -
*
* Conditional Check Failed:
*
*
* -
*
* Code: ConditionalCheckFailed
*
*
* -
*
* Message: The conditional request failed.
*
*
*
*
* -
*
* Item Collection Size Limit Exceeded:
*
*
* -
*
* Code: ItemCollectionSizeLimitExceeded
*
*
* -
*
* Message: Collection size exceeded.
*
*
*
*
* -
*
* Transaction Conflict:
*
*
* -
*
* Code: TransactionConflict
*
*
* -
*
* Message: Transaction is ongoing for the item.
*
*
*
*
* -
*
* Provisioned Throughput Exceeded:
*
*
* -
*
* Code: ProvisionedThroughputExceeded
*
*
* -
*
* Messages:
*
*
* -
*
* The level of configured provisioned throughput for the table was exceeded. Consider increasing your
* provisioning level with the UpdateTable API.
*
*
*
* This Message is received when provisioned throughput is exceeded is on a provisioned DynamoDB table.
*
*
* -
*
* The level of configured provisioned throughput for one or more global secondary indexes of the table was
* exceeded. Consider increasing your provisioning level for the under-provisioned global secondary indexes
* with the UpdateTable API.
*
*
*
* This message is returned when provisioned throughput is exceeded is on a provisioned GSI.
*
*
*
*
*
*
* -
*
* Throttling Error:
*
*
* -
*
* Code: ThrottlingError
*
*
* -
*
* Messages:
*
*
* -
*
* Throughput exceeds the current capacity of your table or index. DynamoDB is automatically scaling your
* table or index so please try again shortly. If exceptions persist, check if you have a hot key:
* https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/bp-partition-key-design.html.
*
*
*
* This message is returned when writes get throttled on an On-Demand table as DynamoDB is automatically
* scaling the table.
*
*
* -
*
* Throughput exceeds the current capacity for one or more global secondary indexes. DynamoDB is
* automatically scaling your index so please try again shortly.
*
*
*
* This message is returned when when writes get throttled on an On-Demand GSI as DynamoDB is automatically
* scaling the GSI.
*
*
*
*
*
*
* -
*
* Validation Error:
*
*
* -
*
* Code: ValidationError
*
*
* -
*
* Messages:
*
*
* -
*
* One or more parameter values were invalid.
*
*
* -
*
* The update expression attempted to update the secondary index key beyond allowed size limits.
*
*
* -
*
* The update expression attempted to update the secondary index key to unsupported type.
*
*
* -
*
* An operand in the update expression has an incorrect data type.
*
*
* -
*
* Item size to update has exceeded the maximum allowed size.
*
*
* -
*
* Number overflow. Attempting to store a number with magnitude larger than supported range.
*
*
* -
*
* Type mismatch for attribute to update.
*
*
* -
*
* Nesting Levels have exceeded supported limits.
*
*
* -
*
* The document path provided in the update expression is invalid for update.
*
*
* -
*
* The provided expression refers to an attribute that does not exist in the item.
*
*
*
*
*
*
* - ProvisionedThroughputExceededException Your request rate is too high. The AWS SDKs for DynamoDB
* automatically retry requests that receive this exception. Your request is eventually successful, unless
* your retry queue is too large to finish. Reduce the frequency of requests and use exponential backoff.
* For more information, go to Error Retries and Exponential Backoff in the Amazon DynamoDB Developer Guide.
* - RequestLimitExceededException Throughput exceeds the current throughput quota for your account.
* Please contact AWS Support at AWS Support to request a quota
* increase.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.TransactGetItems
* @see AWS API
* Documentation
*/
default CompletableFuture transactGetItems(TransactGetItemsRequest transactGetItemsRequest) {
throw new UnsupportedOperationException();
}
/**
*
* TransactGetItems is a synchronous operation that atomically retrieves multiple items from one or
* more tables (but not from indexes) in a single account and Region. A TransactGetItems call can
* contain up to 25 TransactGetItem objects, each of which contains a Get structure that
* specifies an item to retrieve from a table in the account and Region. A call to TransactGetItems
* cannot retrieve items from tables in more than one AWS account or Region. The aggregate size of the items in the
* transaction cannot exceed 4 MB.
*
*
* DynamoDB rejects the entire TransactGetItems request if any of the following is true:
*
*
* -
*
* A conflicting operation is in the process of updating an item to be read.
*
*
* -
*
* There is insufficient provisioned capacity for the transaction to be completed.
*
*
* -
*
* There is a user error, such as an invalid data format.
*
*
* -
*
* The aggregate size of the items in the transaction cannot exceed 4 MB.
*
*
*
*
*
* This is a convenience which creates an instance of the {@link TransactGetItemsRequest.Builder} avoiding the need
* to create one manually via {@link TransactGetItemsRequest#builder()}
*
*
* @param transactGetItemsRequest
* A {@link Consumer} that will call methods on {@link TransactGetItemsInput.Builder} to create a request.
* @return A Java Future containing the result of the TransactGetItems operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ResourceNotFoundException The operation tried to access a nonexistent table or index. The resource
* might not be specified correctly, or its status might not be
ACTIVE.
* - TransactionCanceledException The entire transaction request was canceled.
*
* DynamoDB cancels a TransactWriteItems request under the following circumstances:
*
*
* -
*
* A condition in one of the condition expressions is not met.
*
*
* -
*
* A table in the TransactWriteItems request is in a different account or region.
*
*
* -
*
* More than one action in the TransactWriteItems operation targets the same item.
*
*
* -
*
* There is insufficient provisioned capacity for the transaction to be completed.
*
*
* -
*
* An item size becomes too large (larger than 400 KB), or a local secondary index (LSI) becomes too large,
* or a similar validation error occurs because of changes made by the transaction.
*
*
* -
*
* There is a user error, such as an invalid data format.
*
*
*
*
* DynamoDB cancels a TransactGetItems request under the following circumstances:
*
*
* -
*
* There is an ongoing TransactGetItems operation that conflicts with a concurrent
* PutItem, UpdateItem, DeleteItem or TransactWriteItems
* request. In this case the TransactGetItems operation fails with a
* TransactionCanceledException.
*
*
* -
*
* A table in the TransactGetItems request is in a different account or region.
*
*
* -
*
* There is insufficient provisioned capacity for the transaction to be completed.
*
*
* -
*
* There is a user error, such as an invalid data format.
*
*
*
*
*
* If using Java, DynamoDB lists the cancellation reasons on the CancellationReasons property.
* This property is not set for other languages. Transaction cancellation reasons are ordered in the order
* of requested items, if an item has no error it will have NONE code and Null
* message.
*
*
*
* Cancellation reason codes and possible error messages:
*
*
* -
*
* No Errors:
*
*
* -
*
* Code: NONE
*
*
* -
*
* Message: null
*
*
*
*
* -
*
* Conditional Check Failed:
*
*
* -
*
* Code: ConditionalCheckFailed
*
*
* -
*
* Message: The conditional request failed.
*
*
*
*
* -
*
* Item Collection Size Limit Exceeded:
*
*
* -
*
* Code: ItemCollectionSizeLimitExceeded
*
*
* -
*
* Message: Collection size exceeded.
*
*
*
*
* -
*
* Transaction Conflict:
*
*
* -
*
* Code: TransactionConflict
*
*
* -
*
* Message: Transaction is ongoing for the item.
*
*
*
*
* -
*
* Provisioned Throughput Exceeded:
*
*
* -
*
* Code: ProvisionedThroughputExceeded
*
*
* -
*
* Messages:
*
*
* -
*
* The level of configured provisioned throughput for the table was exceeded. Consider increasing your
* provisioning level with the UpdateTable API.
*
*
*
* This Message is received when provisioned throughput is exceeded is on a provisioned DynamoDB table.
*
*
* -
*
* The level of configured provisioned throughput for one or more global secondary indexes of the table was
* exceeded. Consider increasing your provisioning level for the under-provisioned global secondary indexes
* with the UpdateTable API.
*
*
*
* This message is returned when provisioned throughput is exceeded is on a provisioned GSI.
*
*
*
*
*
*
* -
*
* Throttling Error:
*
*
* -
*
* Code: ThrottlingError
*
*
* -
*
* Messages:
*
*
* -
*
* Throughput exceeds the current capacity of your table or index. DynamoDB is automatically scaling your
* table or index so please try again shortly. If exceptions persist, check if you have a hot key:
* https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/bp-partition-key-design.html.
*
*
*
* This message is returned when writes get throttled on an On-Demand table as DynamoDB is automatically
* scaling the table.
*
*
* -
*
* Throughput exceeds the current capacity for one or more global secondary indexes. DynamoDB is
* automatically scaling your index so please try again shortly.
*
*
*
* This message is returned when when writes get throttled on an On-Demand GSI as DynamoDB is automatically
* scaling the GSI.
*
*
*
*
*
*
* -
*
* Validation Error:
*
*
* -
*
* Code: ValidationError
*
*
* -
*
* Messages:
*
*
* -
*
* One or more parameter values were invalid.
*
*
* -
*
* The update expression attempted to update the secondary index key beyond allowed size limits.
*
*
* -
*
* The update expression attempted to update the secondary index key to unsupported type.
*
*
* -
*
* An operand in the update expression has an incorrect data type.
*
*
* -
*
* Item size to update has exceeded the maximum allowed size.
*
*
* -
*
* Number overflow. Attempting to store a number with magnitude larger than supported range.
*
*
* -
*
* Type mismatch for attribute to update.
*
*
* -
*
* Nesting Levels have exceeded supported limits.
*
*
* -
*
* The document path provided in the update expression is invalid for update.
*
*
* -
*
* The provided expression refers to an attribute that does not exist in the item.
*
*
*
*
*
*
* - ProvisionedThroughputExceededException Your request rate is too high. The AWS SDKs for DynamoDB
* automatically retry requests that receive this exception. Your request is eventually successful, unless
* your retry queue is too large to finish. Reduce the frequency of requests and use exponential backoff.
* For more information, go to Error Retries and Exponential Backoff in the Amazon DynamoDB Developer Guide.
* - RequestLimitExceededException Throughput exceeds the current throughput quota for your account.
* Please contact AWS Support at AWS Support to request a quota
* increase.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.TransactGetItems
* @see AWS API
* Documentation
*/
default CompletableFuture transactGetItems(
Consumer transactGetItemsRequest) {
return transactGetItems(TransactGetItemsRequest.builder().applyMutation(transactGetItemsRequest).build());
}
/**
*
* TransactWriteItems is a synchronous write operation that groups up to 25 action requests. These
* actions can target items in different tables, but not in different AWS accounts or Regions, and no two actions
* can target the same item. For example, you cannot both ConditionCheck and Update the
* same item. The aggregate size of the items in the transaction cannot exceed 4 MB.
*
*
* The actions are completed atomically so that either all of them succeed, or all of them fail. They are defined by
* the following objects:
*
*
* -
*
* Put — Initiates a PutItem operation to write a new item. This structure
* specifies the primary key of the item to be written, the name of the table to write it in, an optional condition
* expression that must be satisfied for the write to succeed, a list of the item's attributes, and a field
* indicating whether to retrieve the item's attributes if the condition is not met.
*
*
* -
*
* Update — Initiates an UpdateItem operation to update an existing item. This
* structure specifies the primary key of the item to be updated, the name of the table where it resides, an
* optional condition expression that must be satisfied for the update to succeed, an expression that defines one or
* more attributes to be updated, and a field indicating whether to retrieve the item's attributes if the condition
* is not met.
*
*
* -
*
* Delete — Initiates a DeleteItem operation to delete an existing item. This
* structure specifies the primary key of the item to be deleted, the name of the table where it resides, an
* optional condition expression that must be satisfied for the deletion to succeed, and a field indicating whether
* to retrieve the item's attributes if the condition is not met.
*
*
* -
*
* ConditionCheck — Applies a condition to an item that is not being modified by the
* transaction. This structure specifies the primary key of the item to be checked, the name of the table where it
* resides, a condition expression that must be satisfied for the transaction to succeed, and a field indicating
* whether to retrieve the item's attributes if the condition is not met.
*
*
*
*
* DynamoDB rejects the entire TransactWriteItems request if any of the following is true:
*
*
* -
*
* A condition in one of the condition expressions is not met.
*
*
* -
*
* An ongoing operation is in the process of updating the same item.
*
*
* -
*
* There is insufficient provisioned capacity for the transaction to be completed.
*
*
* -
*
* An item size becomes too large (bigger than 400 KB), a local secondary index (LSI) becomes too large, or a
* similar validation error occurs because of changes made by the transaction.
*
*
* -
*
* The aggregate size of the items in the transaction exceeds 4 MB.
*
*
* -
*
* There is a user error, such as an invalid data format.
*
*
*
*
* @param transactWriteItemsRequest
* @return A Java Future containing the result of the TransactWriteItems operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ResourceNotFoundException The operation tried to access a nonexistent table or index. The resource
* might not be specified correctly, or its status might not be
ACTIVE.
* - TransactionCanceledException The entire transaction request was canceled.
*
* DynamoDB cancels a TransactWriteItems request under the following circumstances:
*
*
* -
*
* A condition in one of the condition expressions is not met.
*
*
* -
*
* A table in the TransactWriteItems request is in a different account or region.
*
*
* -
*
* More than one action in the TransactWriteItems operation targets the same item.
*
*
* -
*
* There is insufficient provisioned capacity for the transaction to be completed.
*
*
* -
*
* An item size becomes too large (larger than 400 KB), or a local secondary index (LSI) becomes too large,
* or a similar validation error occurs because of changes made by the transaction.
*
*
* -
*
* There is a user error, such as an invalid data format.
*
*
*
*
* DynamoDB cancels a TransactGetItems request under the following circumstances:
*
*
* -
*
* There is an ongoing TransactGetItems operation that conflicts with a concurrent
* PutItem, UpdateItem, DeleteItem or TransactWriteItems
* request. In this case the TransactGetItems operation fails with a
* TransactionCanceledException.
*
*
* -
*
* A table in the TransactGetItems request is in a different account or region.
*
*
* -
*
* There is insufficient provisioned capacity for the transaction to be completed.
*
*
* -
*
* There is a user error, such as an invalid data format.
*
*
*
*
*
* If using Java, DynamoDB lists the cancellation reasons on the CancellationReasons property.
* This property is not set for other languages. Transaction cancellation reasons are ordered in the order
* of requested items, if an item has no error it will have NONE code and Null
* message.
*
*
*
* Cancellation reason codes and possible error messages:
*
*
* -
*
* No Errors:
*
*
* -
*
* Code: NONE
*
*
* -
*
* Message: null
*
*
*
*
* -
*
* Conditional Check Failed:
*
*
* -
*
* Code: ConditionalCheckFailed
*
*
* -
*
* Message: The conditional request failed.
*
*
*
*
* -
*
* Item Collection Size Limit Exceeded:
*
*
* -
*
* Code: ItemCollectionSizeLimitExceeded
*
*
* -
*
* Message: Collection size exceeded.
*
*
*
*
* -
*
* Transaction Conflict:
*
*
* -
*
* Code: TransactionConflict
*
*
* -
*
* Message: Transaction is ongoing for the item.
*
*
*
*
* -
*
* Provisioned Throughput Exceeded:
*
*
* -
*
* Code: ProvisionedThroughputExceeded
*
*
* -
*
* Messages:
*
*
* -
*
* The level of configured provisioned throughput for the table was exceeded. Consider increasing your
* provisioning level with the UpdateTable API.
*
*
*
* This Message is received when provisioned throughput is exceeded is on a provisioned DynamoDB table.
*
*
* -
*
* The level of configured provisioned throughput for one or more global secondary indexes of the table was
* exceeded. Consider increasing your provisioning level for the under-provisioned global secondary indexes
* with the UpdateTable API.
*
*
*
* This message is returned when provisioned throughput is exceeded is on a provisioned GSI.
*
*
*
*
*
*
* -
*
* Throttling Error:
*
*
* -
*
* Code: ThrottlingError
*
*
* -
*
* Messages:
*
*
* -
*
* Throughput exceeds the current capacity of your table or index. DynamoDB is automatically scaling your
* table or index so please try again shortly. If exceptions persist, check if you have a hot key:
* https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/bp-partition-key-design.html.
*
*
*
* This message is returned when writes get throttled on an On-Demand table as DynamoDB is automatically
* scaling the table.
*
*
* -
*
* Throughput exceeds the current capacity for one or more global secondary indexes. DynamoDB is
* automatically scaling your index so please try again shortly.
*
*
*
* This message is returned when when writes get throttled on an On-Demand GSI as DynamoDB is automatically
* scaling the GSI.
*
*
*
*
*
*
* -
*
* Validation Error:
*
*
* -
*
* Code: ValidationError
*
*
* -
*
* Messages:
*
*
* -
*
* One or more parameter values were invalid.
*
*
* -
*
* The update expression attempted to update the secondary index key beyond allowed size limits.
*
*
* -
*
* The update expression attempted to update the secondary index key to unsupported type.
*
*
* -
*
* An operand in the update expression has an incorrect data type.
*
*
* -
*
* Item size to update has exceeded the maximum allowed size.
*
*
* -
*
* Number overflow. Attempting to store a number with magnitude larger than supported range.
*
*
* -
*
* Type mismatch for attribute to update.
*
*
* -
*
* Nesting Levels have exceeded supported limits.
*
*
* -
*
* The document path provided in the update expression is invalid for update.
*
*
* -
*
* The provided expression refers to an attribute that does not exist in the item.
*
*
*
*
*
*
* - TransactionInProgressException The transaction with the given request token is already in progress.
* - IdempotentParameterMismatchException DynamoDB rejected the request because you retried a request with
* a different payload but with an idempotent token that was already used.
* - ProvisionedThroughputExceededException Your request rate is too high. The AWS SDKs for DynamoDB
* automatically retry requests that receive this exception. Your request is eventually successful, unless
* your retry queue is too large to finish. Reduce the frequency of requests and use exponential backoff.
* For more information, go to Error Retries and Exponential Backoff in the Amazon DynamoDB Developer Guide.
* - RequestLimitExceededException Throughput exceeds the current throughput quota for your account.
* Please contact AWS Support at AWS Support to request a quota
* increase.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.TransactWriteItems
* @see AWS
* API Documentation
*/
default CompletableFuture transactWriteItems(TransactWriteItemsRequest transactWriteItemsRequest) {
throw new UnsupportedOperationException();
}
/**
*
* TransactWriteItems is a synchronous write operation that groups up to 25 action requests. These
* actions can target items in different tables, but not in different AWS accounts or Regions, and no two actions
* can target the same item. For example, you cannot both ConditionCheck and Update the
* same item. The aggregate size of the items in the transaction cannot exceed 4 MB.
*
*
* The actions are completed atomically so that either all of them succeed, or all of them fail. They are defined by
* the following objects:
*
*
* -
*
* Put — Initiates a PutItem operation to write a new item. This structure
* specifies the primary key of the item to be written, the name of the table to write it in, an optional condition
* expression that must be satisfied for the write to succeed, a list of the item's attributes, and a field
* indicating whether to retrieve the item's attributes if the condition is not met.
*
*
* -
*
* Update — Initiates an UpdateItem operation to update an existing item. This
* structure specifies the primary key of the item to be updated, the name of the table where it resides, an
* optional condition expression that must be satisfied for the update to succeed, an expression that defines one or
* more attributes to be updated, and a field indicating whether to retrieve the item's attributes if the condition
* is not met.
*
*
* -
*
* Delete — Initiates a DeleteItem operation to delete an existing item. This
* structure specifies the primary key of the item to be deleted, the name of the table where it resides, an
* optional condition expression that must be satisfied for the deletion to succeed, and a field indicating whether
* to retrieve the item's attributes if the condition is not met.
*
*
* -
*
* ConditionCheck — Applies a condition to an item that is not being modified by the
* transaction. This structure specifies the primary key of the item to be checked, the name of the table where it
* resides, a condition expression that must be satisfied for the transaction to succeed, and a field indicating
* whether to retrieve the item's attributes if the condition is not met.
*
*
*
*
* DynamoDB rejects the entire TransactWriteItems request if any of the following is true:
*
*
* -
*
* A condition in one of the condition expressions is not met.
*
*
* -
*
* An ongoing operation is in the process of updating the same item.
*
*
* -
*
* There is insufficient provisioned capacity for the transaction to be completed.
*
*
* -
*
* An item size becomes too large (bigger than 400 KB), a local secondary index (LSI) becomes too large, or a
* similar validation error occurs because of changes made by the transaction.
*
*
* -
*
* The aggregate size of the items in the transaction exceeds 4 MB.
*
*
* -
*
* There is a user error, such as an invalid data format.
*
*
*
*
*
* This is a convenience which creates an instance of the {@link TransactWriteItemsRequest.Builder} avoiding the
* need to create one manually via {@link TransactWriteItemsRequest#builder()}
*
*
* @param transactWriteItemsRequest
* A {@link Consumer} that will call methods on {@link TransactWriteItemsInput.Builder} to create a request.
* @return A Java Future containing the result of the TransactWriteItems operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ResourceNotFoundException The operation tried to access a nonexistent table or index. The resource
* might not be specified correctly, or its status might not be
ACTIVE.
* - TransactionCanceledException The entire transaction request was canceled.
*
* DynamoDB cancels a TransactWriteItems request under the following circumstances:
*
*
* -
*
* A condition in one of the condition expressions is not met.
*
*
* -
*
* A table in the TransactWriteItems request is in a different account or region.
*
*
* -
*
* More than one action in the TransactWriteItems operation targets the same item.
*
*
* -
*
* There is insufficient provisioned capacity for the transaction to be completed.
*
*
* -
*
* An item size becomes too large (larger than 400 KB), or a local secondary index (LSI) becomes too large,
* or a similar validation error occurs because of changes made by the transaction.
*
*
* -
*
* There is a user error, such as an invalid data format.
*
*
*
*
* DynamoDB cancels a TransactGetItems request under the following circumstances:
*
*
* -
*
* There is an ongoing TransactGetItems operation that conflicts with a concurrent
* PutItem, UpdateItem, DeleteItem or TransactWriteItems
* request. In this case the TransactGetItems operation fails with a
* TransactionCanceledException.
*
*
* -
*
* A table in the TransactGetItems request is in a different account or region.
*
*
* -
*
* There is insufficient provisioned capacity for the transaction to be completed.
*
*
* -
*
* There is a user error, such as an invalid data format.
*
*
*
*
*
* If using Java, DynamoDB lists the cancellation reasons on the CancellationReasons property.
* This property is not set for other languages. Transaction cancellation reasons are ordered in the order
* of requested items, if an item has no error it will have NONE code and Null
* message.
*
*
*
* Cancellation reason codes and possible error messages:
*
*
* -
*
* No Errors:
*
*
* -
*
* Code: NONE
*
*
* -
*
* Message: null
*
*
*
*
* -
*
* Conditional Check Failed:
*
*
* -
*
* Code: ConditionalCheckFailed
*
*
* -
*
* Message: The conditional request failed.
*
*
*
*
* -
*
* Item Collection Size Limit Exceeded:
*
*
* -
*
* Code: ItemCollectionSizeLimitExceeded
*
*
* -
*
* Message: Collection size exceeded.
*
*
*
*
* -
*
* Transaction Conflict:
*
*
* -
*
* Code: TransactionConflict
*
*
* -
*
* Message: Transaction is ongoing for the item.
*
*
*
*
* -
*
* Provisioned Throughput Exceeded:
*
*
* -
*
* Code: ProvisionedThroughputExceeded
*
*
* -
*
* Messages:
*
*
* -
*
* The level of configured provisioned throughput for the table was exceeded. Consider increasing your
* provisioning level with the UpdateTable API.
*
*
*
* This Message is received when provisioned throughput is exceeded is on a provisioned DynamoDB table.
*
*
* -
*
* The level of configured provisioned throughput for one or more global secondary indexes of the table was
* exceeded. Consider increasing your provisioning level for the under-provisioned global secondary indexes
* with the UpdateTable API.
*
*
*
* This message is returned when provisioned throughput is exceeded is on a provisioned GSI.
*
*
*
*
*
*
* -
*
* Throttling Error:
*
*
* -
*
* Code: ThrottlingError
*
*
* -
*
* Messages:
*
*
* -
*
* Throughput exceeds the current capacity of your table or index. DynamoDB is automatically scaling your
* table or index so please try again shortly. If exceptions persist, check if you have a hot key:
* https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/bp-partition-key-design.html.
*
*
*
* This message is returned when writes get throttled on an On-Demand table as DynamoDB is automatically
* scaling the table.
*
*
* -
*
* Throughput exceeds the current capacity for one or more global secondary indexes. DynamoDB is
* automatically scaling your index so please try again shortly.
*
*
*
* This message is returned when when writes get throttled on an On-Demand GSI as DynamoDB is automatically
* scaling the GSI.
*
*
*
*
*
*
* -
*
* Validation Error:
*
*
* -
*
* Code: ValidationError
*
*
* -
*
* Messages:
*
*
* -
*
* One or more parameter values were invalid.
*
*
* -
*
* The update expression attempted to update the secondary index key beyond allowed size limits.
*
*
* -
*
* The update expression attempted to update the secondary index key to unsupported type.
*
*
* -
*
* An operand in the update expression has an incorrect data type.
*
*
* -
*
* Item size to update has exceeded the maximum allowed size.
*
*
* -
*
* Number overflow. Attempting to store a number with magnitude larger than supported range.
*
*
* -
*
* Type mismatch for attribute to update.
*
*
* -
*
* Nesting Levels have exceeded supported limits.
*
*
* -
*
* The document path provided in the update expression is invalid for update.
*
*
* -
*
* The provided expression refers to an attribute that does not exist in the item.
*
*
*
*
*
*
* - TransactionInProgressException The transaction with the given request token is already in progress.
* - IdempotentParameterMismatchException DynamoDB rejected the request because you retried a request with
* a different payload but with an idempotent token that was already used.
* - ProvisionedThroughputExceededException Your request rate is too high. The AWS SDKs for DynamoDB
* automatically retry requests that receive this exception. Your request is eventually successful, unless
* your retry queue is too large to finish. Reduce the frequency of requests and use exponential backoff.
* For more information, go to Error Retries and Exponential Backoff in the Amazon DynamoDB Developer Guide.
* - RequestLimitExceededException Throughput exceeds the current throughput quota for your account.
* Please contact AWS Support at AWS Support to request a quota
* increase.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.TransactWriteItems
* @see AWS
* API Documentation
*/
default CompletableFuture transactWriteItems(
Consumer transactWriteItemsRequest) {
return transactWriteItems(TransactWriteItemsRequest.builder().applyMutation(transactWriteItemsRequest).build());
}
/**
*
* Removes the association of tags from an Amazon DynamoDB resource. You can call UntagResource up to
* five times per second, per account.
*
*
* For an overview on tagging DynamoDB resources, see Tagging for DynamoDB in
* the Amazon DynamoDB Developer Guide.
*
*
* @param untagResourceRequest
* @return A Java Future containing the result of the UntagResource operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - LimitExceededException There is no limit to the number of daily on-demand backups that can be taken.
*
*
* Up to 50 simultaneous table operations are allowed per account. These operations include
* CreateTable, UpdateTable, DeleteTable,
* UpdateTimeToLive, RestoreTableFromBackup, and
* RestoreTableToPointInTime.
*
*
* The only exception is when you are creating a table with one or more secondary indexes. You can have up
* to 25 such requests running at a time; however, if the table or index specifications are complex,
* DynamoDB might temporarily reduce the number of concurrent operations.
*
*
* There is a soft account quota of 256 tables.
* - ResourceNotFoundException The operation tried to access a nonexistent table or index. The resource
* might not be specified correctly, or its status might not be
ACTIVE.
* - InternalServerErrorException An error occurred on the server side.
* - ResourceInUseException The operation conflicts with the resource's availability. For example, you
* attempted to recreate an existing table, or tried to delete a table currently in the
*
CREATING 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.UntagResource
* @see AWS API
* Documentation
*/
default CompletableFuture untagResource(UntagResourceRequest untagResourceRequest) {
throw new UnsupportedOperationException();
}
/**
*
* Removes the association of tags from an Amazon DynamoDB resource. You can call UntagResource up to
* five times per second, per account.
*
*
* For an overview on tagging DynamoDB resources, see Tagging for DynamoDB in
* the Amazon DynamoDB Developer Guide.
*
*
*
* This is a convenience which creates an instance of the {@link UntagResourceRequest.Builder} avoiding the need to
* create one manually via {@link UntagResourceRequest#builder()}
*
*
* @param untagResourceRequest
* A {@link Consumer} that will call methods on {@link UntagResourceInput.Builder} to create a request.
* @return A Java Future containing the result of the UntagResource operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - LimitExceededException There is no limit to the number of daily on-demand backups that can be taken.
*
*
* Up to 50 simultaneous table operations are allowed per account. These operations include
* CreateTable, UpdateTable, DeleteTable,
* UpdateTimeToLive, RestoreTableFromBackup, and
* RestoreTableToPointInTime.
*
*
* The only exception is when you are creating a table with one or more secondary indexes. You can have up
* to 25 such requests running at a time; however, if the table or index specifications are complex,
* DynamoDB might temporarily reduce the number of concurrent operations.
*
*
* There is a soft account quota of 256 tables.
* - ResourceNotFoundException The operation tried to access a nonexistent table or index. The resource
* might not be specified correctly, or its status might not be
ACTIVE.
* - InternalServerErrorException An error occurred on the server side.
* - ResourceInUseException The operation conflicts with the resource's availability. For example, you
* attempted to recreate an existing table, or tried to delete a table currently in the
*
CREATING 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.UntagResource
* @see AWS API
* Documentation
*/
default CompletableFuture untagResource(Consumer untagResourceRequest) {
return untagResource(UntagResourceRequest.builder().applyMutation(untagResourceRequest).build());
}
/**
*
* UpdateContinuousBackups enables or disables point in time recovery for the specified table. A
* successful UpdateContinuousBackups call returns the current
* ContinuousBackupsDescription. Continuous backups are ENABLED on all tables at table
* creation. If point in time recovery is enabled, PointInTimeRecoveryStatus will be set to ENABLED.
*
*
* Once continuous backups and point in time recovery are enabled, you can restore to any point in time within
* EarliestRestorableDateTime and LatestRestorableDateTime.
*
*
* LatestRestorableDateTime is typically 5 minutes before the current time. You can restore your table
* to any point in time during the last 35 days.
*
*
* @param updateContinuousBackupsRequest
* @return A Java Future containing the result of the UpdateContinuousBackups operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - TableNotFoundException A source table with the name
TableName does not currently exist
* within the subscriber's account.
* - ContinuousBackupsUnavailableException Backups have not yet been enabled for this table.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.UpdateContinuousBackups
* @see AWS API Documentation
*/
default CompletableFuture updateContinuousBackups(
UpdateContinuousBackupsRequest updateContinuousBackupsRequest) {
throw new UnsupportedOperationException();
}
/**
*
* UpdateContinuousBackups enables or disables point in time recovery for the specified table. A
* successful UpdateContinuousBackups call returns the current
* ContinuousBackupsDescription. Continuous backups are ENABLED on all tables at table
* creation. If point in time recovery is enabled, PointInTimeRecoveryStatus will be set to ENABLED.
*
*
* Once continuous backups and point in time recovery are enabled, you can restore to any point in time within
* EarliestRestorableDateTime and LatestRestorableDateTime.
*
*
* LatestRestorableDateTime is typically 5 minutes before the current time. You can restore your table
* to any point in time during the last 35 days.
*
*
*
* This is a convenience which creates an instance of the {@link UpdateContinuousBackupsRequest.Builder} avoiding
* the need to create one manually via {@link UpdateContinuousBackupsRequest#builder()}
*
*
* @param updateContinuousBackupsRequest
* A {@link Consumer} that will call methods on {@link UpdateContinuousBackupsInput.Builder} to create a
* request.
* @return A Java Future containing the result of the UpdateContinuousBackups operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - TableNotFoundException A source table with the name
TableName does not currently exist
* within the subscriber's account.
* - ContinuousBackupsUnavailableException Backups have not yet been enabled for this table.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.UpdateContinuousBackups
* @see AWS API Documentation
*/
default CompletableFuture updateContinuousBackups(
Consumer updateContinuousBackupsRequest) {
return updateContinuousBackups(UpdateContinuousBackupsRequest.builder().applyMutation(updateContinuousBackupsRequest)
.build());
}
/**
*
* Updates the status for contributor insights for a specific table or index.
*
*
* @param updateContributorInsightsRequest
* @return A Java Future containing the result of the UpdateContributorInsights operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ResourceNotFoundException The operation tried to access a nonexistent table or index. The resource
* might not be specified correctly, or its status might not be
ACTIVE.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.UpdateContributorInsights
* @see AWS API Documentation
*/
default CompletableFuture updateContributorInsights(
UpdateContributorInsightsRequest updateContributorInsightsRequest) {
throw new UnsupportedOperationException();
}
/**
*
* Updates the status for contributor insights for a specific table or index.
*
*
*
* This is a convenience which creates an instance of the {@link UpdateContributorInsightsRequest.Builder} avoiding
* the need to create one manually via {@link UpdateContributorInsightsRequest#builder()}
*
*
* @param updateContributorInsightsRequest
* A {@link Consumer} that will call methods on {@link UpdateContributorInsightsInput.Builder} to create a
* request.
* @return A Java Future containing the result of the UpdateContributorInsights operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ResourceNotFoundException The operation tried to access a nonexistent table or index. The resource
* might not be specified correctly, or its status might not be
ACTIVE.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.UpdateContributorInsights
* @see AWS API Documentation
*/
default CompletableFuture updateContributorInsights(
Consumer updateContributorInsightsRequest) {
return updateContributorInsights(UpdateContributorInsightsRequest.builder()
.applyMutation(updateContributorInsightsRequest).build());
}
/**
*
* Adds or removes replicas in the specified global table. The global table must already exist to be able to use
* this operation. Any replica to be added must be empty, have the same name as the global table, have the same key
* schema, have DynamoDB Streams enabled, and have the same provisioned and maximum write capacity units.
*
*
*
* Although you can use UpdateGlobalTable to add replicas and remove replicas in a single request, for
* simplicity we recommend that you issue separate requests for adding or removing replicas.
*
*
*
* If global secondary indexes are specified, then the following conditions must also be met:
*
*
* -
*
* The global secondary indexes must have the same name.
*
*
* -
*
* The global secondary indexes must have the same hash key and sort key (if present).
*
*
* -
*
* The global secondary indexes must have the same provisioned and maximum write capacity units.
*
*
*
*
* @param updateGlobalTableRequest
* @return A Java Future containing the result of the UpdateGlobalTable operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - InternalServerErrorException An error occurred on the server side.
* - GlobalTableNotFoundException The specified global table does not exist.
* - ReplicaAlreadyExistsException The specified replica is already part of the global table.
* - ReplicaNotFoundException The specified replica is no longer part of the global table.
* - TableNotFoundException A source table with the name
TableName does not currently exist
* within the subscriber's account.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.UpdateGlobalTable
* @see AWS API
* Documentation
*/
default CompletableFuture updateGlobalTable(UpdateGlobalTableRequest updateGlobalTableRequest) {
throw new UnsupportedOperationException();
}
/**
*
* Adds or removes replicas in the specified global table. The global table must already exist to be able to use
* this operation. Any replica to be added must be empty, have the same name as the global table, have the same key
* schema, have DynamoDB Streams enabled, and have the same provisioned and maximum write capacity units.
*
*
*
* Although you can use UpdateGlobalTable to add replicas and remove replicas in a single request, for
* simplicity we recommend that you issue separate requests for adding or removing replicas.
*
*
*
* If global secondary indexes are specified, then the following conditions must also be met:
*
*
* -
*
* The global secondary indexes must have the same name.
*
*
* -
*
* The global secondary indexes must have the same hash key and sort key (if present).
*
*
* -
*
* The global secondary indexes must have the same provisioned and maximum write capacity units.
*
*
*
*
*
* This is a convenience which creates an instance of the {@link UpdateGlobalTableRequest.Builder} avoiding the need
* to create one manually via {@link UpdateGlobalTableRequest#builder()}
*
*
* @param updateGlobalTableRequest
* A {@link Consumer} that will call methods on {@link UpdateGlobalTableInput.Builder} to create a request.
* @return A Java Future containing the result of the UpdateGlobalTable operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - InternalServerErrorException An error occurred on the server side.
* - GlobalTableNotFoundException The specified global table does not exist.
* - ReplicaAlreadyExistsException The specified replica is already part of the global table.
* - ReplicaNotFoundException The specified replica is no longer part of the global table.
* - TableNotFoundException A source table with the name
TableName does not currently exist
* within the subscriber's account.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.UpdateGlobalTable
* @see AWS API
* Documentation
*/
default CompletableFuture updateGlobalTable(
Consumer updateGlobalTableRequest) {
return updateGlobalTable(UpdateGlobalTableRequest.builder().applyMutation(updateGlobalTableRequest).build());
}
/**
*
* Updates settings for a global table.
*
*
* @param updateGlobalTableSettingsRequest
* @return A Java Future containing the result of the UpdateGlobalTableSettings operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - GlobalTableNotFoundException The specified global table does not exist.
* - ReplicaNotFoundException The specified replica is no longer part of the global table.
* - IndexNotFoundException The operation tried to access a nonexistent index.
* - LimitExceededException There is no limit to the number of daily on-demand backups that can be taken.
*
*
* Up to 50 simultaneous table operations are allowed per account. These operations include
* CreateTable, UpdateTable, DeleteTable,
* UpdateTimeToLive, RestoreTableFromBackup, and
* RestoreTableToPointInTime.
*
*
* The only exception is when you are creating a table with one or more secondary indexes. You can have up
* to 25 such requests running at a time; however, if the table or index specifications are complex,
* DynamoDB might temporarily reduce the number of concurrent operations.
*
*
* There is a soft account quota of 256 tables.
* - ResourceInUseException The operation conflicts with the resource's availability. For example, you
* attempted to recreate an existing table, or tried to delete a table currently in the
*
CREATING state.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.UpdateGlobalTableSettings
* @see AWS API Documentation
*/
default CompletableFuture updateGlobalTableSettings(
UpdateGlobalTableSettingsRequest updateGlobalTableSettingsRequest) {
throw new UnsupportedOperationException();
}
/**
*
* Updates settings for a global table.
*
*
*
* This is a convenience which creates an instance of the {@link UpdateGlobalTableSettingsRequest.Builder} avoiding
* the need to create one manually via {@link UpdateGlobalTableSettingsRequest#builder()}
*
*
* @param updateGlobalTableSettingsRequest
* A {@link Consumer} that will call methods on {@link UpdateGlobalTableSettingsInput.Builder} to create a
* request.
* @return A Java Future containing the result of the UpdateGlobalTableSettings operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - GlobalTableNotFoundException The specified global table does not exist.
* - ReplicaNotFoundException The specified replica is no longer part of the global table.
* - IndexNotFoundException The operation tried to access a nonexistent index.
* - LimitExceededException There is no limit to the number of daily on-demand backups that can be taken.
*
*
* Up to 50 simultaneous table operations are allowed per account. These operations include
* CreateTable, UpdateTable, DeleteTable,
* UpdateTimeToLive, RestoreTableFromBackup, and
* RestoreTableToPointInTime.
*
*
* The only exception is when you are creating a table with one or more secondary indexes. You can have up
* to 25 such requests running at a time; however, if the table or index specifications are complex,
* DynamoDB might temporarily reduce the number of concurrent operations.
*
*
* There is a soft account quota of 256 tables.
* - ResourceInUseException The operation conflicts with the resource's availability. For example, you
* attempted to recreate an existing table, or tried to delete a table currently in the
*
CREATING state.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.UpdateGlobalTableSettings
* @see AWS API Documentation
*/
default CompletableFuture updateGlobalTableSettings(
Consumer updateGlobalTableSettingsRequest) {
return updateGlobalTableSettings(UpdateGlobalTableSettingsRequest.builder()
.applyMutation(updateGlobalTableSettingsRequest).build());
}
/**
*
* Edits an existing item's attributes, or adds a new item to the table if it does not already exist. You can put,
* delete, or add attribute values. You can also perform a conditional update on an existing item (insert a new
* attribute name-value pair if it doesn't exist, or replace an existing name-value pair if it has certain expected
* attribute values).
*
*
* You can also return the item's attribute values in the same UpdateItem operation using the
* ReturnValues parameter.
*
*
* @param updateItemRequest
* Represents the input of an UpdateItem operation.
* @return A Java Future containing the result of the UpdateItem operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ConditionalCheckFailedException A condition specified in the operation could not be evaluated.
* - ProvisionedThroughputExceededException Your request rate is too high. The AWS SDKs for DynamoDB
* automatically retry requests that receive this exception. Your request is eventually successful, unless
* your retry queue is too large to finish. Reduce the frequency of requests and use exponential backoff.
* For more information, go to Error Retries and Exponential Backoff in the Amazon DynamoDB Developer Guide.
* - ResourceNotFoundException The operation tried to access a nonexistent table or index. The resource
* might not be specified correctly, or its status might not be
ACTIVE.
* - ItemCollectionSizeLimitExceededException An item collection is too large. This exception is only
* returned for tables that have one or more local secondary indexes.
* - TransactionConflictException Operation was rejected because there is an ongoing transaction for the
* item.
* - RequestLimitExceededException Throughput exceeds the current throughput quota for your account.
* Please contact AWS Support at AWS Support to request a quota
* increase.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.UpdateItem
* @see AWS API
* Documentation
*/
default CompletableFuture updateItem(UpdateItemRequest updateItemRequest) {
throw new UnsupportedOperationException();
}
/**
*
* Edits an existing item's attributes, or adds a new item to the table if it does not already exist. You can put,
* delete, or add attribute values. You can also perform a conditional update on an existing item (insert a new
* attribute name-value pair if it doesn't exist, or replace an existing name-value pair if it has certain expected
* attribute values).
*
*
* You can also return the item's attribute values in the same UpdateItem operation using the
* ReturnValues parameter.
*
*
*
* This is a convenience which creates an instance of the {@link UpdateItemRequest.Builder} avoiding the need to
* create one manually via {@link UpdateItemRequest#builder()}
*
*
* @param updateItemRequest
* A {@link Consumer} that will call methods on {@link UpdateItemInput.Builder} to create a request.
* Represents the input of an UpdateItem operation.
* @return A Java Future containing the result of the UpdateItem operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ConditionalCheckFailedException A condition specified in the operation could not be evaluated.
* - ProvisionedThroughputExceededException Your request rate is too high. The AWS SDKs for DynamoDB
* automatically retry requests that receive this exception. Your request is eventually successful, unless
* your retry queue is too large to finish. Reduce the frequency of requests and use exponential backoff.
* For more information, go to Error Retries and Exponential Backoff in the Amazon DynamoDB Developer Guide.
* - ResourceNotFoundException The operation tried to access a nonexistent table or index. The resource
* might not be specified correctly, or its status might not be
ACTIVE.
* - ItemCollectionSizeLimitExceededException An item collection is too large. This exception is only
* returned for tables that have one or more local secondary indexes.
* - TransactionConflictException Operation was rejected because there is an ongoing transaction for the
* item.
* - RequestLimitExceededException Throughput exceeds the current throughput quota for your account.
* Please contact AWS Support at AWS Support to request a quota
* increase.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.UpdateItem
* @see AWS API
* Documentation
*/
default CompletableFuture updateItem(Consumer updateItemRequest) {
return updateItem(UpdateItemRequest.builder().applyMutation(updateItemRequest).build());
}
/**
*
* Modifies the provisioned throughput settings, global secondary indexes, or DynamoDB Streams settings for a given
* table.
*
*
* You can only perform one of the following operations at once:
*
*
* -
*
* Modify the provisioned throughput settings of the table.
*
*
* -
*
* Enable or disable DynamoDB Streams on the table.
*
*
* -
*
* Remove a global secondary index from the table.
*
*
* -
*
* Create a new global secondary index on the table. After the index begins backfilling, you can use
* UpdateTable to perform other operations.
*
*
*
*
* UpdateTable is an asynchronous operation; while it is executing, the table status changes from
* ACTIVE to UPDATING. While it is UPDATING, you cannot issue another
* UpdateTable request. When the table returns to the ACTIVE state, the
* UpdateTable operation is complete.
*
*
* @param updateTableRequest
* Represents the input of an UpdateTable operation.
* @return A Java Future containing the result of the UpdateTable operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ResourceInUseException The operation conflicts with the resource's availability. For example, you
* attempted to recreate an existing table, or tried to delete a table currently in the
*
CREATING state.
* - ResourceNotFoundException The operation tried to access a nonexistent table or index. The resource
* might not be specified correctly, or its status might not be
ACTIVE.
* - LimitExceededException There is no limit to the number of daily on-demand backups that can be taken.
*
*
* Up to 50 simultaneous table operations are allowed per account. These operations include
* CreateTable, UpdateTable, DeleteTable,
* UpdateTimeToLive, RestoreTableFromBackup, and
* RestoreTableToPointInTime.
*
*
* The only exception is when you are creating a table with one or more secondary indexes. You can have up
* to 25 such requests running at a time; however, if the table or index specifications are complex,
* DynamoDB might temporarily reduce the number of concurrent operations.
*
*
* There is a soft account quota of 256 tables.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.UpdateTable
* @see AWS API
* Documentation
*/
default CompletableFuture updateTable(UpdateTableRequest updateTableRequest) {
throw new UnsupportedOperationException();
}
/**
*
* Modifies the provisioned throughput settings, global secondary indexes, or DynamoDB Streams settings for a given
* table.
*
*
* You can only perform one of the following operations at once:
*
*
* -
*
* Modify the provisioned throughput settings of the table.
*
*
* -
*
* Enable or disable DynamoDB Streams on the table.
*
*
* -
*
* Remove a global secondary index from the table.
*
*
* -
*
* Create a new global secondary index on the table. After the index begins backfilling, you can use
* UpdateTable to perform other operations.
*
*
*
*
* UpdateTable is an asynchronous operation; while it is executing, the table status changes from
* ACTIVE to UPDATING. While it is UPDATING, you cannot issue another
* UpdateTable request. When the table returns to the ACTIVE state, the
* UpdateTable operation is complete.
*
*
*
* This is a convenience which creates an instance of the {@link UpdateTableRequest.Builder} avoiding the need to
* create one manually via {@link UpdateTableRequest#builder()}
*
*
* @param updateTableRequest
* A {@link Consumer} that will call methods on {@link UpdateTableInput.Builder} to create a request.
* Represents the input of an UpdateTable operation.
* @return A Java Future containing the result of the UpdateTable operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ResourceInUseException The operation conflicts with the resource's availability. For example, you
* attempted to recreate an existing table, or tried to delete a table currently in the
*
CREATING state.
* - ResourceNotFoundException The operation tried to access a nonexistent table or index. The resource
* might not be specified correctly, or its status might not be
ACTIVE.
* - LimitExceededException There is no limit to the number of daily on-demand backups that can be taken.
*
*
* Up to 50 simultaneous table operations are allowed per account. These operations include
* CreateTable, UpdateTable, DeleteTable,
* UpdateTimeToLive, RestoreTableFromBackup, and
* RestoreTableToPointInTime.
*
*
* The only exception is when you are creating a table with one or more secondary indexes. You can have up
* to 25 such requests running at a time; however, if the table or index specifications are complex,
* DynamoDB might temporarily reduce the number of concurrent operations.
*
*
* There is a soft account quota of 256 tables.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.UpdateTable
* @see AWS API
* Documentation
*/
default CompletableFuture updateTable(Consumer updateTableRequest) {
return updateTable(UpdateTableRequest.builder().applyMutation(updateTableRequest).build());
}
/**
*
* Updates auto scaling settings on your global tables at once.
*
*
*
* This operation only applies to Version
* 2019.11.21 of global tables.
*
*
*
* @param updateTableReplicaAutoScalingRequest
* @return A Java Future containing the result of the UpdateTableReplicaAutoScaling operation returned by the
* service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ResourceNotFoundException The operation tried to access a nonexistent table or index. The resource
* might not be specified correctly, or its status might not be
ACTIVE.
* - ResourceInUseException The operation conflicts with the resource's availability. For example, you
* attempted to recreate an existing table, or tried to delete a table currently in the
*
CREATING state.
* - LimitExceededException There is no limit to the number of daily on-demand backups that can be taken.
*
*
* Up to 50 simultaneous table operations are allowed per account. These operations include
* CreateTable, UpdateTable, DeleteTable,
* UpdateTimeToLive, RestoreTableFromBackup, and
* RestoreTableToPointInTime.
*
*
* The only exception is when you are creating a table with one or more secondary indexes. You can have up
* to 25 such requests running at a time; however, if the table or index specifications are complex,
* DynamoDB might temporarily reduce the number of concurrent operations.
*
*
* There is a soft account quota of 256 tables.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.UpdateTableReplicaAutoScaling
* @see AWS API Documentation
*/
default CompletableFuture updateTableReplicaAutoScaling(
UpdateTableReplicaAutoScalingRequest updateTableReplicaAutoScalingRequest) {
throw new UnsupportedOperationException();
}
/**
*
* Updates auto scaling settings on your global tables at once.
*
*
*
* This operation only applies to Version
* 2019.11.21 of global tables.
*
*
*
* This is a convenience which creates an instance of the {@link UpdateTableReplicaAutoScalingRequest.Builder}
* avoiding the need to create one manually via {@link UpdateTableReplicaAutoScalingRequest#builder()}
*
*
* @param updateTableReplicaAutoScalingRequest
* A {@link Consumer} that will call methods on {@link UpdateTableReplicaAutoScalingInput.Builder} to create
* a request.
* @return A Java Future containing the result of the UpdateTableReplicaAutoScaling operation returned by the
* service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ResourceNotFoundException The operation tried to access a nonexistent table or index. The resource
* might not be specified correctly, or its status might not be
ACTIVE.
* - ResourceInUseException The operation conflicts with the resource's availability. For example, you
* attempted to recreate an existing table, or tried to delete a table currently in the
*
CREATING state.
* - LimitExceededException There is no limit to the number of daily on-demand backups that can be taken.
*
*
* Up to 50 simultaneous table operations are allowed per account. These operations include
* CreateTable, UpdateTable, DeleteTable,
* UpdateTimeToLive, RestoreTableFromBackup, and
* RestoreTableToPointInTime.
*
*
* The only exception is when you are creating a table with one or more secondary indexes. You can have up
* to 25 such requests running at a time; however, if the table or index specifications are complex,
* DynamoDB might temporarily reduce the number of concurrent operations.
*
*
* There is a soft account quota of 256 tables.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.UpdateTableReplicaAutoScaling
* @see AWS API Documentation
*/
default CompletableFuture updateTableReplicaAutoScaling(
Consumer updateTableReplicaAutoScalingRequest) {
return updateTableReplicaAutoScaling(UpdateTableReplicaAutoScalingRequest.builder()
.applyMutation(updateTableReplicaAutoScalingRequest).build());
}
/**
*
* The UpdateTimeToLive method enables or disables Time to Live (TTL) for the specified table. A
* successful UpdateTimeToLive call returns the current TimeToLiveSpecification. It can
* take up to one hour for the change to fully process. Any additional UpdateTimeToLive calls for the
* same table during this one hour duration result in a ValidationException.
*
*
* TTL compares the current time in epoch time format to the time stored in the TTL attribute of an item. If the
* epoch time value stored in the attribute is less than the current time, the item is marked as expired and
* subsequently deleted.
*
*
*
* The epoch time format is the number of seconds elapsed since 12:00:00 AM January 1, 1970 UTC.
*
*
*
* DynamoDB deletes expired items on a best-effort basis to ensure availability of throughput for other data
* operations.
*
*
*
* DynamoDB typically deletes expired items within two days of expiration. The exact duration within which an item
* gets deleted after expiration is specific to the nature of the workload. Items that have expired and not been
* deleted will still show up in reads, queries, and scans.
*
*
*
* As items are deleted, they are removed from any local secondary index and global secondary index immediately in
* the same eventually consistent way as a standard delete operation.
*
*
* For more information, see Time To Live in the Amazon
* DynamoDB Developer Guide.
*
*
* @param updateTimeToLiveRequest
* Represents the input of an UpdateTimeToLive operation.
* @return A Java Future containing the result of the UpdateTimeToLive operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ResourceInUseException The operation conflicts with the resource's availability. For example, you
* attempted to recreate an existing table, or tried to delete a table currently in the
*
CREATING state.
* - ResourceNotFoundException The operation tried to access a nonexistent table or index. The resource
* might not be specified correctly, or its status might not be
ACTIVE.
* - LimitExceededException There is no limit to the number of daily on-demand backups that can be taken.
*
*
* Up to 50 simultaneous table operations are allowed per account. These operations include
* CreateTable, UpdateTable, DeleteTable,
* UpdateTimeToLive, RestoreTableFromBackup, and
* RestoreTableToPointInTime.
*
*
* The only exception is when you are creating a table with one or more secondary indexes. You can have up
* to 25 such requests running at a time; however, if the table or index specifications are complex,
* DynamoDB might temporarily reduce the number of concurrent operations.
*
*
* There is a soft account quota of 256 tables.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.UpdateTimeToLive
* @see AWS API
* Documentation
*/
default CompletableFuture updateTimeToLive(UpdateTimeToLiveRequest updateTimeToLiveRequest) {
throw new UnsupportedOperationException();
}
/**
*
* The UpdateTimeToLive method enables or disables Time to Live (TTL) for the specified table. A
* successful UpdateTimeToLive call returns the current TimeToLiveSpecification. It can
* take up to one hour for the change to fully process. Any additional UpdateTimeToLive calls for the
* same table during this one hour duration result in a ValidationException.
*
*
* TTL compares the current time in epoch time format to the time stored in the TTL attribute of an item. If the
* epoch time value stored in the attribute is less than the current time, the item is marked as expired and
* subsequently deleted.
*
*
*
* The epoch time format is the number of seconds elapsed since 12:00:00 AM January 1, 1970 UTC.
*
*
*
* DynamoDB deletes expired items on a best-effort basis to ensure availability of throughput for other data
* operations.
*
*
*
* DynamoDB typically deletes expired items within two days of expiration. The exact duration within which an item
* gets deleted after expiration is specific to the nature of the workload. Items that have expired and not been
* deleted will still show up in reads, queries, and scans.
*
*
*
* As items are deleted, they are removed from any local secondary index and global secondary index immediately in
* the same eventually consistent way as a standard delete operation.
*
*
* For more information, see Time To Live in the Amazon
* DynamoDB Developer Guide.
*
*
*
* This is a convenience which creates an instance of the {@link UpdateTimeToLiveRequest.Builder} avoiding the need
* to create one manually via {@link UpdateTimeToLiveRequest#builder()}
*
*
* @param updateTimeToLiveRequest
* A {@link Consumer} that will call methods on {@link UpdateTimeToLiveInput.Builder} to create a request.
* Represents the input of an UpdateTimeToLive operation.
* @return A Java Future containing the result of the UpdateTimeToLive operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ResourceInUseException The operation conflicts with the resource's availability. For example, you
* attempted to recreate an existing table, or tried to delete a table currently in the
*
CREATING state.
* - ResourceNotFoundException The operation tried to access a nonexistent table or index. The resource
* might not be specified correctly, or its status might not be
ACTIVE.
* - LimitExceededException There is no limit to the number of daily on-demand backups that can be taken.
*
*
* Up to 50 simultaneous table operations are allowed per account. These operations include
* CreateTable, UpdateTable, DeleteTable,
* UpdateTimeToLive, RestoreTableFromBackup, and
* RestoreTableToPointInTime.
*
*
* The only exception is when you are creating a table with one or more secondary indexes. You can have up
* to 25 such requests running at a time; however, if the table or index specifications are complex,
* DynamoDB might temporarily reduce the number of concurrent operations.
*
*
* There is a soft account quota of 256 tables.
* - InternalServerErrorException An error occurred on the server side.
* - 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.
* - DynamoDbException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample DynamoDbAsyncClient.UpdateTimeToLive
* @see AWS API
* Documentation
*/
default CompletableFuture updateTimeToLive(
Consumer updateTimeToLiveRequest) {
return updateTimeToLive(UpdateTimeToLiveRequest.builder().applyMutation(updateTimeToLiveRequest).build());
}
/**
* Create an instance of {@link DynamoDbAsyncWaiter} using this client.
*
* Waiters created via this method are managed by the SDK and resources will be released when the service client is
* closed.
*
* @return an instance of {@link DynamoDbAsyncWaiter}
*/
default DynamoDbAsyncWaiter waiter() {
throw new UnsupportedOperationException();
}
}