Update
Represents a request to perform an UpdateItem operation.
Contents
Note
In the following list, the required parameters are described first.
- Key
-
The primary key of the item to be updated. Each element consists of an attribute name and a value for that attribute.
Type: String to AttributeValue object map
Key Length Constraints: Maximum length of 65535.
Required: Yes
- TableName
-
Name of the table for the
UpdateItemrequest. You can also provide the Amazon Resource Name (ARN) of the table in this parameter.Type: String
Length Constraints: Minimum length of 1. Maximum length of 1024.
Required: Yes
- UpdateExpression
-
An expression that defines one or more attributes to be updated, the action to be performed on them, and new value(s) for them.
Type: String
Required: Yes
- ConditionExpression
-
A condition that must be satisfied in order for a conditional update to succeed.
Type: String
Required: No
- ExpressionAttributeNames
-
One or more substitution tokens for attribute names in an expression.
Type: String to string map
Value Length Constraints: Maximum length of 65535.
Required: No
- ExpressionAttributeValues
-
One or more values that can be substituted in an expression.
Type: String to AttributeValue object map
Required: No
- ReturnValuesOnConditionCheckFailure
-
Use
ReturnValuesOnConditionCheckFailureto get the item attributes if theUpdatecondition fails. ForReturnValuesOnConditionCheckFailure, the valid values are: NONE and ALL_OLD.Type: String
Valid Values:
ALL_OLD | NONERequired: No
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following:
