Package com.amazonaws.services.dynamodbv2

Synchronous and asynchronous client classes for accessing AmazonDynamoDBv2.

See: Description

Interface Summary

Interface	Description
AmazonDynamoDB	Interface for accessing AmazonDynamoDBv2.
AmazonDynamoDBAsync	Interface for accessing AmazonDynamoDBv2 asynchronously.

Class Summary

Class	Description
AmazonDynamoDBAsyncClient	Asynchronous client for accessing AmazonDynamoDBv2.
AmazonDynamoDBClient	Client for accessing AmazonDynamoDBv2.

Package com.amazonaws.services.dynamodbv2 Description

Synchronous and asynchronous client classes for accessing AmazonDynamoDBv2. Amazon DynamoDB Overview

This is the Amazon DynamoDB API Reference. This guide provides descriptions and samples of the DynamoDB API. For information about application development using this API, see the Amazon DynamoDB Developer Guide.

The following are short descriptions of each API action, organized by function.

Managing Tables

• CreateTable - Creates a table with user-specified provisioned throughput settings. You must designate one attribute as the hash primary key for the table; you can optionally designate a second attribute as the range primary key. DynamoDB creates indexes on these key attributes for fast data access. Optionally, you can create one or more secondary indexes, which provide fast data access using non-key attributes.

• DescribeTable - Returns metadata for a table, such as table size, status, and index information.

• UpdateTable - Modifies the provisioned throughput settings for a table. Optionally, you can modify the provisioned throughput settings for global secondary indexes on the table.

• ListTables - Returns a list of all tables associated with the current AWS account and endpoint.

• DeleteTable - Deletes a table and all of its indexes.

Reading Data

• GetItem - Returns a set of attributes for the item that has a given primary key. By default, GetItem performs an eventually consistent read; however, applications can specify a strongly consistent read instead.

• BatchGetItem - Performs multiple GetItem requests for data items using their primary keys, from one table or multiple tables. The response from BatchGetItem has a size limit of 1 MB and returns a maximum of 100 items. Both eventually consistent and strongly consistent reads can be used.

• Query - Returns one or more items from a table or a secondary index. You must provide a specific hash key value. You can narrow the scope of the query using comparison operators against a range key value, or on the index key. Query supports either eventual or strong consistency. A single response has a size limit of 1 MB.

• Scan - Reads every item in a table; the result set is eventually consistent. You can limit the number of items returned by filtering the data attributes, using conditional expressions. Scan can be used to enable ad-hoc querying of a table against non-key attributes; however, since this is a full table scan without using an index, Scan should not be used for any application query use case that requires predictable performance.

Modifying Data

• PutItem - Creates a new item, or replaces an existing item with a new item (including all the attributes). By default, if an item in the table already exists with the same primary key, the new item completely replaces the existing item. You can use conditional operators to replace an item only if its attribute values match certain conditions, or to insert a new item only if that item doesn't already exist.

• UpdateItem - Modifies the attributes of an existing item. You can also use conditional operators to perform an update only if the item's attribute values match certain conditions.

• DeleteItem - Deletes an item in a table by primary key. You can use conditional operators to perform a delete an item only if the item's attribute values match certain conditions.

• BatchWriteItem - Performs multiple PutItem and DeleteItem requests across multiple tables in a single request. A failure of any request(s) in the batch will not cause the entire BatchWriteItem operation to fail. Supports batches of up to 25 items to put or delete, with a maximum total request size of 1 MB.