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_transact_get_items(TransactItems, ReturnConsumedCapacity)
[required] An ordered array of up to 25 TransactGetItem
objects, each of which
contains a Get
structure.
A value of TOTAL
causes consumed capacity information to be returned,
and a value of NONE
prevents that information from being returned. No
other value is valid.
svc$transact_get_items( TransactItems = list( list( Get = list( Key = list( list( S = "string", N = "string", B = raw, SS = list( "string" ), NS = list( "string" ), BS = list( raw ), M = list( list() ), L = list( list() ), NULL = TRUE|FALSE, BOOL = TRUE|FALSE ) ), TableName = "string", ProjectionExpression = "string", ExpressionAttributeNames = list( "string" ) ) ) ), ReturnConsumedCapacity = "INDEXES"|"TOTAL"|"NONE" )
All AWS Regions and AWS GovCloud (US) support up to 25 items per transaction with up to 4 MB of data, except the following AWS Regions:
China (Beijing)
China (Ningxia)
The China (Beijing) and China (Ningxia) Regions support up to 10 items per transaction with up to 4 MB of data.
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.