Struct aws_sdk_dynamodb::operation::transact_get_items::builders::TransactGetItemsFluentBuilder
source · pub struct TransactGetItemsFluentBuilder { /* 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 exceeded 4 MB.
Implementations§
source§impl TransactGetItemsFluentBuilder
impl TransactGetItemsFluentBuilder
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 async fn customize(
self
) -> Result<CustomizableOperation<TransactGetItems, AwsResponseRetryClassifier>, SdkError<TransactGetItemsError>>
pub async fn customize( self ) -> Result<CustomizableOperation<TransactGetItems, AwsResponseRetryClassifier>, SdkError<TransactGetItemsError>>
Consumes 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 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 TransactGetItemsFluentBuilder
impl Clone for TransactGetItemsFluentBuilder
source§fn clone(&self) -> TransactGetItemsFluentBuilder
fn clone(&self) -> TransactGetItemsFluentBuilder
1.0.0 · source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source
. Read more