feat(client-dynamodb): This release adds ReturnValuesOnConditionCheck…

…Failure parameter to PutItem, UpdateItem, DeleteItem, ExecuteStatement, BatchExecuteStatement and ExecuteTransaction APIs. When set to ALL_OLD, API returns a copy of the item as it was when a conditional write failed

clients/client-dynamodb/src/commands/BatchExecuteStatementCommand.ts

@@ -105,6 +105,7 @@ export interface BatchExecuteStatementCommandOutput extends BatchExecuteStatemen
  * },
  * ],
  * ConsistentRead: true || false,
+ * ReturnValuesOnConditionCheckFailure: "ALL_OLD" || "NONE",
  * },
  * ],
  * ReturnConsumedCapacity: "INDEXES" || "TOTAL" || "NONE",
@@ -117,53 +118,56 @@ export interface BatchExecuteStatementCommandOutput extends BatchExecuteStatemen
  * // Error: { // BatchStatementError
  * // Code: "ConditionalCheckFailed" || "ItemCollectionSizeLimitExceeded" || "RequestLimitExceeded" || "ValidationError" || "ProvisionedThroughputExceeded" || "TransactionConflict" || "ThrottlingError" || "InternalServerError" || "ResourceNotFound" || "AccessDenied" || "DuplicateItem",
  * // Message: "STRING_VALUE",
- * // },
- * // TableName: "STRING_VALUE",
- * // Item: { // AttributeMap
- * // "<keys>": { // AttributeValue Union: only one key present
- * // S: "STRING_VALUE",
- * // N: "STRING_VALUE",
- * // B: "BLOB_VALUE",
- * // SS: [ // StringSetAttributeValue
- * // "STRING_VALUE",
- * // ],
- * // NS: [ // NumberSetAttributeValue
- * // "STRING_VALUE",
- * // ],
- * // BS: [ // BinarySetAttributeValue
- * // "BLOB_VALUE",
- * // ],
- * // M: { // MapAttributeValue
- * // "<keys>": {// Union: only one key present
- * // S: "STRING_VALUE",
- * // N: "STRING_VALUE",
- * // B: "BLOB_VALUE",
- * // SS: [
- * // "STRING_VALUE",
- * // ],
- * // NS: [
- * // "STRING_VALUE",
- * // ],
- * // BS: [
- * // "BLOB_VALUE",
- * // ],
- * // M: {
- * // "<keys>": "<AttributeValue>",
+ * // Item: { // AttributeMap
+ * // "<keys>": { // AttributeValue Union: only one key present
+ * // S: "STRING_VALUE",
+ * // N: "STRING_VALUE",
+ * // B: "BLOB_VALUE",
+ * // SS: [ // StringSetAttributeValue
+ * // "STRING_VALUE",
+ * // ],
+ * // NS: [ // NumberSetAttributeValue
+ * // "STRING_VALUE",
+ * // ],
+ * // BS: [ // BinarySetAttributeValue
+ * // "BLOB_VALUE",
+ * // ],
+ * // M: { // MapAttributeValue
+ * // "<keys>": {// Union: only one key present
+ * // S: "STRING_VALUE",
+ * // N: "STRING_VALUE",
+ * // B: "BLOB_VALUE",
+ * // SS: [
+ * // "STRING_VALUE",
+ * // ],
+ * // NS: [
+ * // "STRING_VALUE",
+ * // ],
+ * // BS: [
+ * // "BLOB_VALUE",
+ * // ],
+ * // M: {
+ * // "<keys>": "<AttributeValue>",
+ * // },
+ * // L: [ // ListAttributeValue
+ * // "<AttributeValue>",
+ * // ],
+ * // NULL: true || false,
+ * // BOOL: true || false,
  * // },
- * // L: [ // ListAttributeValue
- * // "<AttributeValue>",
- * // ],
- * // NULL: true || false,
- * // BOOL: true || false,
  * // },
+ * // L: [
+ * // "<AttributeValue>",
+ * // ],
+ * // NULL: true || false,
+ * // BOOL: true || false,
  * // },
- * // L: [
- * // "<AttributeValue>",
- * // ],
- * // NULL: true || false,
- * // BOOL: true || false,
  * // },
  * // },
+ * // TableName: "STRING_VALUE",
+ * // Item: {
+ * // "<keys>": "<AttributeValue>",
+ * // },
  * // },
  * // ],
  * // ConsumedCapacity: [ // ConsumedCapacityMultiple

clients/client-dynamodb/src/commands/BatchWriteItemCommand.ts

@@ -44,10 +44,10 @@ export interface BatchWriteItemCommandOutput extends BatchWriteItemOutput, __Met
  * for the API call. For more details on this distinction, see <a href="https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/HowItWorks.NamingRulesDataTypes.html">Naming Rules and Data Types</a>.</p>
  * <note>
  * <p>
- * <code>BatchWriteItem</code> cannot update items. If you perform a <code>BatchWriteItem</code>
- * operation on an existing item, that item's values will be overwritten by the
- * operation and it will appear like it was updated. To update items, we recommend you
- * use the <code>UpdateItem</code> action.</p>
+ * <code>BatchWriteItem</code> cannot update items. If you perform a
+ *  <code>BatchWriteItem</code> operation on an existing item, that item's values
+ * will be overwritten by the operation and it will appear like it was updated. To
+ * update items, we recommend you use the <code>UpdateItem</code> action.</p>
  * </note>
  * <p>The individual <code>PutItem</code> and <code>DeleteItem</code> operations specified
  * in <code>BatchWriteItem</code> are atomic; however <code>BatchWriteItem</code> as a

clients/client-dynamodb/src/commands/DeleteItemCommand.ts

@@ -121,6 +121,7 @@ export interface DeleteItemCommandOutput extends DeleteItemOutput, __MetadataBea
  * ExpressionAttributeValues: { // ExpressionAttributeValueMap
  * "<keys>": "<AttributeValue>",
  * },
+ * ReturnValuesOnConditionCheckFailure: "ALL_OLD" || "NONE",
  * };
  * const command = new DeleteItemCommand(input);
  * const response = await client.send(command);

clients/client-dynamodb/src/commands/ExecuteStatementCommand.ts

@@ -106,6 +106,7 @@ export interface ExecuteStatementCommandOutput extends ExecuteStatementOutput, _
  * NextToken: "STRING_VALUE",
  * ReturnConsumedCapacity: "INDEXES" || "TOTAL" || "NONE",
  * Limit: Number("int"),
+ * ReturnValuesOnConditionCheckFailure: "ALL_OLD" || "NONE",
  * };
  * const command = new ExecuteStatementCommand(input);
  * const response = await client.send(command);

clients/client-dynamodb/src/commands/ExecuteTransactionCommand.ts

@@ -99,6 +99,7 @@ export interface ExecuteTransactionCommandOutput extends ExecuteTransactionOutpu
  * BOOL: true || false,
  * },
  * ],
+ * ReturnValuesOnConditionCheckFailure: "ALL_OLD" || "NONE",
  * },
  * ],
  * ClientRequestToken: "STRING_VALUE",

clients/client-dynamodb/src/commands/PutItemCommand.ts

@@ -42,8 +42,7 @@ export interface PutItemCommandOutput extends PutItemOutput, __MetadataBearer {}
  * a new item if one with the specified primary key doesn't exist), or replace an existing
  * item if it has certain attribute values. You can return the item's attribute values in
  * the same operation, using the <code>ReturnValues</code> parameter.</p>
- * <p>When you add an item, the primary key attributes are the only required attributes.
- * </p>
+ * <p>When you add an item, the primary key attributes are the only required attributes. </p>
  * <p>Empty String and Binary attribute values are allowed. Attribute values of type String
  * and Binary must have a length greater than zero if the attribute is used as a key
  * attribute for a table or index. Set type attributes cannot be empty. </p>
@@ -132,6 +131,7 @@ export interface PutItemCommandOutput extends PutItemOutput, __MetadataBearer {}
  * ExpressionAttributeValues: { // ExpressionAttributeValueMap
  * "<keys>": "<AttributeValue>",
  * },
+ * ReturnValuesOnConditionCheckFailure: "ALL_OLD" || "NONE",
  * };
  * const command = new PutItemCommand(input);
  * const response = await client.send(command);

clients/client-dynamodb/src/commands/UpdateItemCommand.ts

@@ -124,6 +124,7 @@ export interface UpdateItemCommandOutput extends UpdateItemOutput, __MetadataBea
  * ExpressionAttributeValues: { // ExpressionAttributeValueMap
  * "<keys>": "<AttributeValue>",
  * },
+ * ReturnValuesOnConditionCheckFailure: "ALL_OLD" || "NONE",
  * };
  * const command = new UpdateItemCommand(input);
  * const response = await client.send(command);