# ConditionCheck
<a name="API_ConditionCheck"></a>

Represents a request to perform a check that an item exists or to check the condition of specific attributes of the item.

## Contents
<a name="API_ConditionCheck_Contents"></a>

**Note**  
In the following list, the required parameters are described first.

 ** ConditionExpression **   <a name="DDB-Type-ConditionCheck-ConditionExpression"></a>
A condition that must be satisfied in order for a conditional update to succeed. For more information, see [Condition expressions](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.ConditionExpressions.html) in the *Amazon DynamoDB Developer Guide*.  
Type: String  
Required: Yes

 ** Key **   <a name="DDB-Type-ConditionCheck-Key"></a>
The primary key of the item to be checked. Each element consists of an attribute name and a value for that attribute.  
Type: String to [AttributeValue](API_AttributeValue.md) object map  
Key Length Constraints: Maximum length of 65535.  
Required: Yes

 ** TableName **   <a name="DDB-Type-ConditionCheck-TableName"></a>
Name of the table for the check item request. 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

 ** ExpressionAttributeNames **   <a name="DDB-Type-ConditionCheck-ExpressionAttributeNames"></a>
One or more substitution tokens for attribute names in an expression. For more information, see [Expression attribute names](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.ExpressionAttributeNames.html) in the *Amazon DynamoDB Developer Guide*.  
Type: String to string map  
Value Length Constraints: Maximum length of 65535.  
Required: No

 ** ExpressionAttributeValues **   <a name="DDB-Type-ConditionCheck-ExpressionAttributeValues"></a>
One or more values that can be substituted in an expression. For more information, see [Condition expressions](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.ConditionExpressions.html) in the *Amazon DynamoDB Developer Guide*.  
Type: String to [AttributeValue](API_AttributeValue.md) object map  
Required: No

 ** ReturnValuesOnConditionCheckFailure **   <a name="DDB-Type-ConditionCheck-ReturnValuesOnConditionCheckFailure"></a>
Use `ReturnValuesOnConditionCheckFailure` to get the item attributes if the `ConditionCheck` condition fails. For `ReturnValuesOnConditionCheckFailure`, the valid values are: NONE and ALL\$1OLD.  
Type: String  
Valid Values: `ALL_OLD | NONE`   
Required: No

## See Also
<a name="API_ConditionCheck_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/dynamodb-2012-08-10/ConditionCheck) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/dynamodb-2012-08-10/ConditionCheck) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/dynamodb-2012-08-10/ConditionCheck)