Struct Update

#[non_exhaustive]
pub struct Update {
    pub key: HashMap<String, AttributeValue>,
    pub update_expression: String,
    pub table_name: String,
    pub condition_expression: Option<String>,
    pub expression_attribute_names: Option<HashMap<String, String>>,
    pub expression_attribute_values: Option<HashMap<String, AttributeValue>>,
    pub return_values_on_condition_check_failure: Option<ReturnValuesOnConditionCheckFailure>,
}

Represents a request to perform an UpdateItem operation.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

key: HashMap<String, AttributeValue>

The primary key of the item to be updated. Each element consists of an attribute name and a value for that attribute.

update_expression: String

An expression that defines one or more attributes to be updated, the action to be performed on them, and new value(s) for them.

table_name: String

Name of the table for the UpdateItem request. You can also provide the Amazon Resource Name (ARN) of the table in this parameter.

condition_expression: Option<String>

A condition that must be satisfied in order for a conditional update to succeed.

expression_attribute_names: Option<HashMap<String, String>>

One or more substitution tokens for attribute names in an expression.

expression_attribute_values: Option<HashMap<String, AttributeValue>>

One or more values that can be substituted in an expression.

return_values_on_condition_check_failure: Option<ReturnValuesOnConditionCheckFailure>

Use ReturnValuesOnConditionCheckFailure to get the item attributes if the Update condition fails. For ReturnValuesOnConditionCheckFailure, the valid values are: NONE and ALL_OLD.

Implementations

impl Update

pub fn key(&self) -> &HashMap<String, AttributeValue>

The primary key of the item to be updated. Each element consists of an attribute name and a value for that attribute.

pub fn update_expression(&self) -> &str

An expression that defines one or more attributes to be updated, the action to be performed on them, and new value(s) for them.

pub fn table_name(&self) -> &str

Name of the table for the UpdateItem request. You can also provide the Amazon Resource Name (ARN) of the table in this parameter.

pub fn condition_expression(&self) -> Option<&str>

A condition that must be satisfied in order for a conditional update to succeed.

pub fn expression_attribute_names(&self) -> Option<&HashMap<String, String>>

One or more substitution tokens for attribute names in an expression.

pub fn expression_attribute_values( &self, ) -> Option<&HashMap<String, AttributeValue>>

One or more values that can be substituted in an expression.

pub fn return_values_on_condition_check_failure( &self, ) -> Option<&ReturnValuesOnConditionCheckFailure>

Use ReturnValuesOnConditionCheckFailure to get the item attributes if the Update condition fails. For ReturnValuesOnConditionCheckFailure, the valid values are: NONE and ALL_OLD.

impl Update

pub fn builder() -> UpdateBuilder

Creates a new builder-style object to manufacture Update.

Trait Implementations

impl Clone for Update

fn clone(&self) -> Update

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Update

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

Formats the value using the given formatter.

impl PartialEq for Update

fn eq(&self, other: &Update) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for Update