Struct aws_sdk_dynamodb::client::fluent_builders::TransactGetItems
source · pub struct TransactGetItems { /* private fields */ }
Expand description
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 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 cannot exceed 4 MB.
Implementations§
source§impl TransactGetItems
impl TransactGetItems
sourcepub async fn customize(
self
) -> Result<CustomizableOperation<TransactGetItems, AwsResponseRetryClassifier>, SdkError<TransactGetItemsError>>
pub async fn customize(
self
) -> Result<CustomizableOperation<TransactGetItems, AwsResponseRetryClassifier>, SdkError<TransactGetItemsError>>
Consume this builder, creating a customizable operation that can be modified before being sent. The operation’s inner http::Request can be modified as well.
sourcepub async fn send(
self
) -> Result<TransactGetItemsOutput, SdkError<TransactGetItemsError>>
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.
sourcepub fn transact_items(self, input: TransactGetItem) -> Self
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 100 TransactGetItem
objects, each of which contains a Get
structure.
sourcepub fn set_transact_items(self, input: Option<Vec<TransactGetItem>>) -> Self
pub fn set_transact_items(self, input: Option<Vec<TransactGetItem>>) -> Self
An ordered array of up to 100 TransactGetItem
objects, each of which contains a Get
structure.
sourcepub fn return_consumed_capacity(self, input: ReturnConsumedCapacity) -> Self
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.
sourcepub fn set_return_consumed_capacity(
self,
input: Option<ReturnConsumedCapacity>
) -> Self
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§
source§impl Clone for TransactGetItems
impl Clone for TransactGetItems
source§fn clone(&self) -> TransactGetItems
fn clone(&self) -> TransactGetItems
1.0.0 · source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source
. Read more