Struct aws_sdk_dynamodb::client::fluent_builders::TransactGetItems

pub struct TransactGetItems { /* private fields */ }

Fluent builder constructing a request to TransactGetItems.

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 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 cannot exceed 4 MB.

Implementations

impl TransactGetItems

pub async fn send(
    self
) -> Result<TransactGetItemsOutput, SdkError<TransactGetItemsError>>

Sends the request and returns the response.

If an error occurs, an SdkError will be returned with additional details that can be matched against.

By default, any retryable failures will be retried twice. Retry behavior is configurable with the RetryConfig, which can be set when configuring the client.

pub fn transact_items(self, input: TransactGetItem) -> Self

Appends an item to TransactItems.

To override the contents of this collection use set_transact_items.

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

pub fn set_transact_items(self, input: Option<Vec<TransactGetItem>>) -> Self

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

pub fn return_consumed_capacity(self, input: ReturnConsumedCapacity) -> Self

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.

pub fn set_return_consumed_capacity(
    self,
    input: Option<ReturnConsumedCapacity>
) -> Self

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.

Trait Implementations

impl Clone for TransactGetItems

fn clone(&self) -> TransactGetItems

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for TransactGetItems

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.