TransactGetItemsRequest Class | AWS SDK for .NET Version 4

Container for the parameters to the TransactGetItems operation. 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 100 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 Amazon Web Services 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 exceeded 4 MB.

Inheritance Hierarchy

System.Object
  Amazon.Runtime.AmazonWebServiceRequest
    Amazon.DynamoDBv2.AmazonDynamoDBRequest
      Amazon.DynamoDBv2.Model.TransactGetItemsRequest

Namespace: Amazon.DynamoDBv2.Model
Assembly: AWSSDK.DynamoDBv2.dll
Version: 3.x.y.z

Syntax

public class TransactGetItemsRequest : AmazonDynamoDBRequest
         IAmazonWebServiceRequest

The TransactGetItemsRequest type exposes the following members

Constructors

	Name	Description
	TransactGetItemsRequest()

Properties

Name Type Description

	Name	Type	Description
	ReturnConsumedCapacity	Amazon.DynamoDBv2.ReturnConsumedCapacity	Gets and sets the property ReturnConsumedCapacity. 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.
	TransactItems	System.Collections.Generic.List<Amazon.DynamoDBv2.Model.TransactGetItem>	Gets and sets the property TransactItems. An ordered array of up to 100 `TransactGetItem` objects, each of which contains a `Get` structure. Starting with version 4 of the SDK this property will default to null. If no data for this property is returned from the service the property will also be null. This was changed to improve performance and allow the SDK and caller to distinguish between a property not set or a property being empty to clear out a value. To retain the previous SDK behavior set the AWSConfigs.InitializeCollections static property to true.

ReturnConsumedCapacity

Amazon.DynamoDBv2.ReturnConsumedCapacity

Gets and sets the property ReturnConsumedCapacity.

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.

TransactItems

System.Collections.Generic.List<Amazon.DynamoDBv2.Model.TransactGetItem>

Gets and sets the property TransactItems.

An ordered array of up to 100 TransactGetItem objects, each of which contains a Get structure.

Starting with version 4 of the SDK this property will default to null. If no data for this property is returned from the service the property will also be null. This was changed to improve performance and allow the SDK and caller to distinguish between a property not set or a property being empty to clear out a value. To retain the previous SDK behavior set the AWSConfigs.InitializeCollections static property to true.

Version Information

.NET:
Supported in: 8.0 and newer, Core 3.1

.NET Standard:
Supported in: 2.0

.NET Framework:
Supported in: 4.7.2 and newer