/* * Copyright 2010-2019 Amazon.com, Inc. or its affiliates. All Rights Reserved. * * Licensed under the Apache License, Version 2.0 (the "License"). * You may not use this file except in compliance with the License. * A copy of the License is located at * * http://aws.amazon.com/apache2.0 * * or in the "license" file accompanying this file. This file is distributed * on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either * express or implied. See the License for the specific language governing * permissions and limitations under the License. */ package com.amazonaws.services.dynamodbv2.model; import java.io.Serializable; import com.amazonaws.AmazonWebServiceRequest; /** *
* Creates a new item, or replaces an old item with a new item. If an item that
* has the same primary key as the new item already exists in the specified
* table, the new item completely replaces the existing item. You can perform a
* conditional put operation (add 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 ReturnValues
parameter.
*
* This topic provides general information about the PutItem
API.
*
* For information on how to call the PutItem
API using the AWS SDK
* in specific languages, see the following:
*
* When you add an item, the primary key attribute(s) are the only required
* attributes. Attribute values cannot be null. String and Binary type
* attributes must have lengths greater than zero. Set type attributes cannot be
* empty. Requests with empty values will be rejected with a
* ValidationException
exception.
*
* To prevent a new item from replacing an existing item, use a conditional
* expression that contains the attribute_not_exists
function with
* the name of the attribute being used as the partition key for the table.
* Since every record must contain that attribute, the
* attribute_not_exists
function will only succeed if no matching
* item exists.
*
* For more information about PutItem
, see Working with Items in the Amazon DynamoDB Developer Guide.
*
* The name of the table to contain the item. *
*
* Constraints:
* Length: 3 - 255
* Pattern: [a-zA-Z0-9_.-]+
*/
private String tableName;
/**
*
* A map of attribute name/value pairs, one for each attribute. Only the * primary key attributes are required; you can optionally provide other * attribute name-value pairs for the item. *
** You must provide all of the attributes for the primary key. For example, * with a simple primary key, you only need to provide a value for the * partition key. For a composite primary key, you must provide both values * for both the partition key and the sort key. *
** If you specify any attributes that are part of an index key, then the * data types for those attributes must match those of the schema in the * table's attribute definition. *
** For more information about primary keys, see Primary Key in the Amazon DynamoDB Developer Guide. *
*
* Each element in the Item
map is an
* AttributeValue
object.
*
* This is a legacy parameter. Use ConditionExpression
instead.
* For more information, see Expected in the Amazon DynamoDB Developer Guide.
*
* Use ReturnValues
if you want to get the item attributes as
* they appeared before they were updated with the PutItem
* request. For PutItem
, the valid values are:
*
* NONE
- If ReturnValues
is not specified, or if
* its value is NONE
, then nothing is returned. (This setting
* is the default for ReturnValues
.)
*
* ALL_OLD
- If PutItem
overwrote an attribute
* name-value pair, then the content of the old item is returned.
*
* The ReturnValues
parameter is used by several DynamoDB
* operations; however, PutItem
does not recognize any values
* other than NONE
or ALL_OLD
.
*
* Constraints:
* Allowed Values: NONE, ALL_OLD, UPDATED_OLD, ALL_NEW, UPDATED_NEW
*/
private String returnValues;
/**
*
* Determines the level of detail about provisioned throughput consumption * that is returned in the response: *
*
* INDEXES
- The response includes the aggregate
* ConsumedCapacity
for the operation, together with
* ConsumedCapacity
for each table and secondary index that was
* accessed.
*
* Note that some operations, such as GetItem
and
* BatchGetItem
, do not access any indexes at all. In these
* cases, specifying INDEXES
will only return
* ConsumedCapacity
information for table(s).
*
* TOTAL
- The response includes only the aggregate
* ConsumedCapacity
for the operation.
*
* NONE
- No ConsumedCapacity
details are included
* in the response.
*
* Constraints:
* Allowed Values: INDEXES, TOTAL, NONE
*/
private String returnConsumedCapacity;
/**
*
* Determines whether item collection metrics are returned. If set to
* SIZE
, the response includes statistics about item
* collections, if any, that were modified during the operation are returned
* in the response. If set to NONE
(the default), no statistics
* are returned.
*
* Constraints:
* Allowed Values: SIZE, NONE
*/
private String returnItemCollectionMetrics;
/**
*
* This is a legacy parameter. Use ConditionExpression
instead.
* For more information, see ConditionalOperator in the Amazon DynamoDB Developer Guide.
*
* Constraints:
* Allowed Values: AND, OR
*/
private String conditionalOperator;
/**
*
* A condition that must be satisfied in order for a conditional
* PutItem
operation to succeed.
*
* An expression can contain any of the following: *
*
* Functions:
* attribute_exists | attribute_not_exists | attribute_type | contains | begins_with | size
*
* These function names are case-sensitive. *
*
* Comparison operators:
* = | <> | < | > | <= | >= | BETWEEN | IN
*
* Logical operators: AND | OR | NOT
*
* For more information on condition expressions, see Specifying Conditions in the Amazon DynamoDB Developer Guide. *
*/ private String conditionExpression; /** *
* One or more substitution tokens for attribute names in an expression. The
* following are some use cases for using
* ExpressionAttributeNames
:
*
* To access an attribute whose name conflicts with a DynamoDB reserved * word. *
** To create a placeholder for repeating occurrences of an attribute name in * an expression. *
** To prevent special characters in an attribute name from being * misinterpreted in an expression. *
** Use the # character in an expression to dereference an attribute * name. For example, consider the following attribute name: *
*
* Percentile
*
* The name of this attribute conflicts with a reserved word, so it cannot
* be used directly in an expression. (For the complete list of reserved
* words, see Reserved Words in the Amazon DynamoDB Developer Guide). To
* work around this, you could specify the following for
* ExpressionAttributeNames
:
*
* {"#P":"Percentile"}
*
* You could then use this substitution in an expression, as in this * example: *
*
* #P = :val
*
* Tokens that begin with the : character are expression attribute * values, which are placeholders for the actual value at runtime. *
** For more information on expression attribute names, see Accessing Item Attributes in the Amazon DynamoDB Developer * Guide. *
*/ private java.util.Map* One or more values that can be substituted in an expression. *
** Use the : (colon) character in an expression to dereference an * attribute value. For example, suppose that you wanted to check whether * the value of the ProductStatus attribute was one of the following: *
*
* Available | Backordered | Discontinued
*
* You would first need to specify ExpressionAttributeValues
as
* follows:
*
* { ":avail":{"S":"Available"}, ":back":{"S":"Backordered"}, ":disc":{"S":"Discontinued"} }
*
* You could then use these values in an expression, such as this: *
*
* ProductStatus IN (:avail, :back, :disc)
*
* For more information on expression attribute values, see Specifying Conditions in the Amazon DynamoDB Developer Guide. *
*/ private java.util.Map* The name of the table to contain the item. *
* @param item* A map of attribute name/value pairs, one for each attribute. * Only the primary key attributes are required; you can * optionally provide other attribute name-value pairs for the * item. *
** You must provide all of the attributes for the primary key. * For example, with a simple primary key, you only need to * provide a value for the partition key. For a composite primary * key, you must provide both values for both the partition key * and the sort key. *
** If you specify any attributes that are part of an index key, * then the data types for those attributes must match those of * the schema in the table's attribute definition. *
** For more information about primary keys, see Primary Key in the Amazon DynamoDB Developer * Guide. *
*
* Each element in the Item
map is an
* AttributeValue
object.
*
* The name of the table to contain the item. *
* @param item* A map of attribute name/value pairs, one for each attribute. * Only the primary key attributes are required; you can * optionally provide other attribute name-value pairs for the * item. *
** You must provide all of the attributes for the primary key. * For example, with a simple primary key, you only need to * provide a value for the partition key. For a composite primary * key, you must provide both values for both the partition key * and the sort key. *
** If you specify any attributes that are part of an index key, * then the data types for those attributes must match those of * the schema in the table's attribute definition. *
** For more information about primary keys, see Primary Key in the Amazon DynamoDB Developer * Guide. *
*
* Each element in the Item
map is an
* AttributeValue
object.
*
* Use ReturnValues
if you want to get the item
* attributes as they appeared before they were updated with the
* PutItem
request. For PutItem
, the
* valid values are:
*
* NONE
- If ReturnValues
is not
* specified, or if its value is NONE
, then nothing
* is returned. (This setting is the default for
* ReturnValues
.)
*
* ALL_OLD
- If PutItem
overwrote an
* attribute name-value pair, then the content of the old item is
* returned.
*
* The ReturnValues
parameter is used by several
* DynamoDB operations; however, PutItem
does not
* recognize any values other than NONE
or
* ALL_OLD
.
*
* The name of the table to contain the item. *
* @param item* A map of attribute name/value pairs, one for each attribute. * Only the primary key attributes are required; you can * optionally provide other attribute name-value pairs for the * item. *
** You must provide all of the attributes for the primary key. * For example, with a simple primary key, you only need to * provide a value for the partition key. For a composite primary * key, you must provide both values for both the partition key * and the sort key. *
** If you specify any attributes that are part of an index key, * then the data types for those attributes must match those of * the schema in the table's attribute definition. *
** For more information about primary keys, see Primary Key in the Amazon DynamoDB Developer * Guide. *
*
* Each element in the Item
map is an
* AttributeValue
object.
*
* Use ReturnValues
if you want to get the item
* attributes as they appeared before they were updated with the
* PutItem
request. For PutItem
, the
* valid values are:
*
* NONE
- If ReturnValues
is not
* specified, or if its value is NONE
, then nothing
* is returned. (This setting is the default for
* ReturnValues
.)
*
* ALL_OLD
- If PutItem
overwrote an
* attribute name-value pair, then the content of the old item is
* returned.
*
* The ReturnValues
parameter is used by several
* DynamoDB operations; however, PutItem
does not
* recognize any values other than NONE
or
* ALL_OLD
.
*
* The name of the table to contain the item. *
*
* Constraints:
* Length: 3 - 255
* Pattern: [a-zA-Z0-9_.-]+
*
* @return
* The name of the table to contain the item. *
*/ public String getTableName() { return tableName; } /** ** The name of the table to contain the item. *
*
* Constraints:
* Length: 3 - 255
* Pattern: [a-zA-Z0-9_.-]+
*
* @param tableName
* The name of the table to contain the item. *
*/ public void setTableName(String tableName) { this.tableName = tableName; } /** ** The name of the table to contain the item. *
** Returns a reference to this object so that method calls can be chained * together. *
* Constraints:
* Length: 3 - 255
* Pattern: [a-zA-Z0-9_.-]+
*
* @param tableName
* The name of the table to contain the item. *
* @return A reference to this updated object so that method calls can be * chained together. */ public PutItemRequest withTableName(String tableName) { this.tableName = tableName; return this; } /** ** A map of attribute name/value pairs, one for each attribute. Only the * primary key attributes are required; you can optionally provide other * attribute name-value pairs for the item. *
** You must provide all of the attributes for the primary key. For example, * with a simple primary key, you only need to provide a value for the * partition key. For a composite primary key, you must provide both values * for both the partition key and the sort key. *
** If you specify any attributes that are part of an index key, then the * data types for those attributes must match those of the schema in the * table's attribute definition. *
** For more information about primary keys, see Primary Key in the Amazon DynamoDB Developer Guide. *
*
* Each element in the Item
map is an
* AttributeValue
object.
*
* A map of attribute name/value pairs, one for each attribute. Only * the primary key attributes are required; you can optionally * provide other attribute name-value pairs for the item. *
** You must provide all of the attributes for the primary key. For * example, with a simple primary key, you only need to provide a * value for the partition key. For a composite primary key, you * must provide both values for both the partition key and the sort * key. *
** If you specify any attributes that are part of an index key, then * the data types for those attributes must match those of the * schema in the table's attribute definition. *
** For more information about primary keys, see Primary Key in the Amazon DynamoDB Developer Guide. *
*
* Each element in the Item
map is an
* AttributeValue
object.
*
* A map of attribute name/value pairs, one for each attribute. Only the * primary key attributes are required; you can optionally provide other * attribute name-value pairs for the item. *
** You must provide all of the attributes for the primary key. For example, * with a simple primary key, you only need to provide a value for the * partition key. For a composite primary key, you must provide both values * for both the partition key and the sort key. *
** If you specify any attributes that are part of an index key, then the * data types for those attributes must match those of the schema in the * table's attribute definition. *
** For more information about primary keys, see Primary Key in the Amazon DynamoDB Developer Guide. *
*
* Each element in the Item
map is an
* AttributeValue
object.
*
* A map of attribute name/value pairs, one for each attribute. * Only the primary key attributes are required; you can * optionally provide other attribute name-value pairs for the * item. *
** You must provide all of the attributes for the primary key. * For example, with a simple primary key, you only need to * provide a value for the partition key. For a composite primary * key, you must provide both values for both the partition key * and the sort key. *
** If you specify any attributes that are part of an index key, * then the data types for those attributes must match those of * the schema in the table's attribute definition. *
** For more information about primary keys, see Primary Key in the Amazon DynamoDB Developer * Guide. *
*
* Each element in the Item
map is an
* AttributeValue
object.
*
* A map of attribute name/value pairs, one for each attribute. Only the * primary key attributes are required; you can optionally provide other * attribute name-value pairs for the item. *
** You must provide all of the attributes for the primary key. For example, * with a simple primary key, you only need to provide a value for the * partition key. For a composite primary key, you must provide both values * for both the partition key and the sort key. *
** If you specify any attributes that are part of an index key, then the * data types for those attributes must match those of the schema in the * table's attribute definition. *
** For more information about primary keys, see Primary Key in the Amazon DynamoDB Developer Guide. *
*
* Each element in the Item
map is an
* AttributeValue
object.
*
* Returns a reference to this object so that method calls can be chained * together. * * @param item
* A map of attribute name/value pairs, one for each attribute. * Only the primary key attributes are required; you can * optionally provide other attribute name-value pairs for the * item. *
** You must provide all of the attributes for the primary key. * For example, with a simple primary key, you only need to * provide a value for the partition key. For a composite primary * key, you must provide both values for both the partition key * and the sort key. *
** If you specify any attributes that are part of an index key, * then the data types for those attributes must match those of * the schema in the table's attribute definition. *
** For more information about primary keys, see Primary Key in the Amazon DynamoDB Developer * Guide. *
*
* Each element in the Item
map is an
* AttributeValue
object.
*
* A map of attribute name/value pairs, one for each attribute. Only the * primary key attributes are required; you can optionally provide other * attribute name-value pairs for the item. *
** You must provide all of the attributes for the primary key. For example, * with a simple primary key, you only need to provide a value for the * partition key. For a composite primary key, you must provide both values * for both the partition key and the sort key. *
** If you specify any attributes that are part of an index key, then the * data types for those attributes must match those of the schema in the * table's attribute definition. *
** For more information about primary keys, see Primary Key in the Amazon DynamoDB Developer Guide. *
*
* Each element in the Item
map is an
* AttributeValue
object.
*
* The method adds a new key-value pair into Item parameter, and returns a
* reference to this object so that method calls can be chained together.
*
* @param key The key of the entry to be added into Item.
* @param value The corresponding value of the entry to be added into Item.
* @return A reference to this updated object so that method calls can be
* chained together.
*/
public PutItemRequest addItemEntry(String key, AttributeValue value) {
if (null == this.item) {
this.item = new java.util.HashMap
* Returns a reference to this object so that method calls can be chained
* together.
*/
public PutItemRequest clearItemEntries() {
this.item = null;
return this;
}
/**
*
* This is a legacy parameter. Use
* This is a legacy parameter. Use
* This is a legacy parameter. Use
* This is a legacy parameter. Use
*
* This is a legacy parameter. Use
* Returns a reference to this object so that method calls can be chained
* together.
*
* @param expected
* This is a legacy parameter. Use
*
* This is a legacy parameter. Use
* The method adds a new key-value pair into Expected parameter, and returns
* a reference to this object so that method calls can be chained together.
*
* @param key The key of the entry to be added into Expected.
* @param value The corresponding value of the entry to be added into
* Expected.
* @return A reference to this updated object so that method calls can be
* chained together.
*/
public PutItemRequest addExpectedEntry(String key, ExpectedAttributeValue value) {
if (null == this.expected) {
this.expected = new java.util.HashMap
* Returns a reference to this object so that method calls can be chained
* together.
*/
public PutItemRequest clearExpectedEntries() {
this.expected = null;
return this;
}
/**
*
* Use
*
*
* The
* Constraints:
* Use
*
*
* The
* Use
*
*
* The
* Constraints:
* Use
*
*
* The
* Use
*
*
* The
* Returns a reference to this object so that method calls can be chained
* together.
*
* Constraints:
* Use
*
*
* The
* Use
*
*
* The
* Constraints:
* Use
*
*
* The
* Use
*
*
* The
* Returns a reference to this object so that method calls can be chained
* together.
*
* Constraints:
* Use
*
*
* The
* Determines the level of detail about provisioned throughput consumption
* that is returned in the response:
*
*
* Note that some operations, such as
*
*
* Constraints:
* Determines the level of detail about provisioned throughput
* consumption that is returned in the response:
*
*
* Note that some operations, such as
*
*
* Determines the level of detail about provisioned throughput consumption
* that is returned in the response:
*
*
* Note that some operations, such as
*
*
* Constraints:
* Determines the level of detail about provisioned throughput
* consumption that is returned in the response:
*
*
* Note that some operations, such as
*
*
* Determines the level of detail about provisioned throughput consumption
* that is returned in the response:
*
*
* Note that some operations, such as
*
*
* Returns a reference to this object so that method calls can be chained
* together.
*
* Constraints:
* Determines the level of detail about provisioned throughput
* consumption that is returned in the response:
*
*
* Note that some operations, such as
*
*
* Determines the level of detail about provisioned throughput consumption
* that is returned in the response:
*
*
* Note that some operations, such as
*
*
* Constraints:
* Determines the level of detail about provisioned throughput
* consumption that is returned in the response:
*
*
* Note that some operations, such as
*
*
* Determines the level of detail about provisioned throughput consumption
* that is returned in the response:
*
*
* Note that some operations, such as
*
*
* Returns a reference to this object so that method calls can be chained
* together.
*
* Constraints:
* Determines the level of detail about provisioned throughput
* consumption that is returned in the response:
*
*
* Note that some operations, such as
*
*
* Determines whether item collection metrics are returned. If set to
*
* Constraints:
* Determines whether item collection metrics are returned. If set
* to
* Determines whether item collection metrics are returned. If set to
*
* Constraints:
* Determines whether item collection metrics are returned. If
* set to
* Determines whether item collection metrics are returned. If set to
*
* Returns a reference to this object so that method calls can be chained
* together.
*
* Constraints:
* Determines whether item collection metrics are returned. If
* set to
* Determines whether item collection metrics are returned. If set to
*
* Constraints:
* Determines whether item collection metrics are returned. If
* set to
* Determines whether item collection metrics are returned. If set to
*
* Returns a reference to this object so that method calls can be chained
* together.
*
* Constraints:
* Determines whether item collection metrics are returned. If
* set to
* This is a legacy parameter. Use
* Constraints:
* This is a legacy parameter. Use
* This is a legacy parameter. Use
* Constraints:
* This is a legacy parameter. Use
*
* This is a legacy parameter. Use
* Returns a reference to this object so that method calls can be chained
* together.
*
* Constraints:
* This is a legacy parameter. Use
*
* This is a legacy parameter. Use
* Constraints:
* This is a legacy parameter. Use
*
* This is a legacy parameter. Use
* Returns a reference to this object so that method calls can be chained
* together.
*
* Constraints:
* This is a legacy parameter. Use
*
* A condition that must be satisfied in order for a conditional
*
* An expression can contain any of the following:
*
* Functions:
*
* These function names are case-sensitive.
*
* Comparison operators:
*
* Logical operators:
* For more information on condition expressions, see Specifying Conditions in the Amazon DynamoDB Developer Guide.
*
* A condition that must be satisfied in order for a conditional
*
* An expression can contain any of the following:
*
* Functions:
*
* These function names are case-sensitive.
*
* Comparison operators:
*
* Logical operators:
* For more information on condition expressions, see Specifying Conditions in the Amazon DynamoDB Developer
* Guide.
*
* A condition that must be satisfied in order for a conditional
*
* An expression can contain any of the following:
*
* Functions:
*
* These function names are case-sensitive.
*
* Comparison operators:
*
* Logical operators:
* For more information on condition expressions, see Specifying Conditions in the Amazon DynamoDB Developer Guide.
*
* A condition that must be satisfied in order for a conditional
*
* An expression can contain any of the following:
*
* Functions:
*
* These function names are case-sensitive.
*
* Comparison operators:
*
* Logical operators:
* For more information on condition expressions, see Specifying Conditions in the Amazon DynamoDB Developer
* Guide.
*
* A condition that must be satisfied in order for a conditional
*
* An expression can contain any of the following:
*
* Functions:
*
* These function names are case-sensitive.
*
* Comparison operators:
*
* Logical operators:
* For more information on condition expressions, see Specifying Conditions in the Amazon DynamoDB Developer Guide.
*
* Returns a reference to this object so that method calls can be chained
* together.
*
* @param conditionExpression
* A condition that must be satisfied in order for a conditional
*
* An expression can contain any of the following:
*
* Functions:
*
* These function names are case-sensitive.
*
* Comparison operators:
*
* Logical operators:
* For more information on condition expressions, see Specifying Conditions in the Amazon DynamoDB Developer
* Guide.
*
* One or more substitution tokens for attribute names in an expression. The
* following are some use cases for using
*
* To access an attribute whose name conflicts with a DynamoDB reserved
* word.
*
* To create a placeholder for repeating occurrences of an attribute name in
* an expression.
*
* To prevent special characters in an attribute name from being
* misinterpreted in an expression.
*
* Use the # character in an expression to dereference an attribute
* name. For example, consider the following attribute name:
*
*
* The name of this attribute conflicts with a reserved word, so it cannot
* be used directly in an expression. (For the complete list of reserved
* words, see Reserved Words in the Amazon DynamoDB Developer Guide). To
* work around this, you could specify the following for
*
*
* You could then use this substitution in an expression, as in this
* example:
*
*
* Tokens that begin with the : character are expression attribute
* values, which are placeholders for the actual value at runtime.
*
* For more information on expression attribute names, see Accessing Item Attributes in the Amazon DynamoDB Developer
* Guide.
*
* One or more substitution tokens for attribute names in an
* expression. The following are some use cases for using
*
* To access an attribute whose name conflicts with a DynamoDB
* reserved word.
*
* To create a placeholder for repeating occurrences of an attribute
* name in an expression.
*
* To prevent special characters in an attribute name from being
* misinterpreted in an expression.
*
* Use the # character in an expression to dereference an
* attribute name. For example, consider the following attribute
* name:
*
*
* The name of this attribute conflicts with a reserved word, so it
* cannot be used directly in an expression. (For the complete list
* of reserved words, see Reserved Words in the Amazon DynamoDB Developer
* Guide). To work around this, you could specify the following
* for
*
* You could then use this substitution in an expression, as in this
* example:
*
*
* Tokens that begin with the : character are expression
* attribute values, which are placeholders for the actual value
* at runtime.
*
* For more information on expression attribute names, see Accessing Item Attributes in the Amazon DynamoDB
* Developer Guide.
*
* One or more substitution tokens for attribute names in an expression. The
* following are some use cases for using
*
* To access an attribute whose name conflicts with a DynamoDB reserved
* word.
*
* To create a placeholder for repeating occurrences of an attribute name in
* an expression.
*
* To prevent special characters in an attribute name from being
* misinterpreted in an expression.
*
* Use the # character in an expression to dereference an attribute
* name. For example, consider the following attribute name:
*
*
* The name of this attribute conflicts with a reserved word, so it cannot
* be used directly in an expression. (For the complete list of reserved
* words, see Reserved Words in the Amazon DynamoDB Developer Guide). To
* work around this, you could specify the following for
*
*
* You could then use this substitution in an expression, as in this
* example:
*
*
* Tokens that begin with the : character are expression attribute
* values, which are placeholders for the actual value at runtime.
*
* For more information on expression attribute names, see Accessing Item Attributes in the Amazon DynamoDB Developer
* Guide.
*
* One or more substitution tokens for attribute names in an
* expression. The following are some use cases for using
*
* To access an attribute whose name conflicts with a DynamoDB
* reserved word.
*
* To create a placeholder for repeating occurrences of an
* attribute name in an expression.
*
* To prevent special characters in an attribute name from being
* misinterpreted in an expression.
*
* Use the # character in an expression to dereference an
* attribute name. For example, consider the following attribute
* name:
*
*
* The name of this attribute conflicts with a reserved word, so
* it cannot be used directly in an expression. (For the complete
* list of reserved words, see Reserved Words in the Amazon DynamoDB Developer
* Guide). To work around this, you could specify the
* following for
*
* You could then use this substitution in an expression, as in
* this example:
*
*
* Tokens that begin with the : character are
* expression attribute values, which are placeholders for
* the actual value at runtime.
*
* For more information on expression attribute names, see Accessing Item Attributes in the Amazon DynamoDB
* Developer Guide.
*
* One or more substitution tokens for attribute names in an expression. The
* following are some use cases for using
*
* To access an attribute whose name conflicts with a DynamoDB reserved
* word.
*
* To create a placeholder for repeating occurrences of an attribute name in
* an expression.
*
* To prevent special characters in an attribute name from being
* misinterpreted in an expression.
*
* Use the # character in an expression to dereference an attribute
* name. For example, consider the following attribute name:
*
*
* The name of this attribute conflicts with a reserved word, so it cannot
* be used directly in an expression. (For the complete list of reserved
* words, see Reserved Words in the Amazon DynamoDB Developer Guide). To
* work around this, you could specify the following for
*
*
* You could then use this substitution in an expression, as in this
* example:
*
*
* Tokens that begin with the : character are expression attribute
* values, which are placeholders for the actual value at runtime.
*
* For more information on expression attribute names, see Accessing Item Attributes in the Amazon DynamoDB Developer
* Guide.
*
* Returns a reference to this object so that method calls can be chained
* together.
*
* @param expressionAttributeNames
* One or more substitution tokens for attribute names in an
* expression. The following are some use cases for using
*
* To access an attribute whose name conflicts with a DynamoDB
* reserved word.
*
* To create a placeholder for repeating occurrences of an
* attribute name in an expression.
*
* To prevent special characters in an attribute name from being
* misinterpreted in an expression.
*
* Use the # character in an expression to dereference an
* attribute name. For example, consider the following attribute
* name:
*
*
* The name of this attribute conflicts with a reserved word, so
* it cannot be used directly in an expression. (For the complete
* list of reserved words, see Reserved Words in the Amazon DynamoDB Developer
* Guide). To work around this, you could specify the
* following for
*
* You could then use this substitution in an expression, as in
* this example:
*
*
* Tokens that begin with the : character are
* expression attribute values, which are placeholders for
* the actual value at runtime.
*
* For more information on expression attribute names, see Accessing Item Attributes in the Amazon DynamoDB
* Developer Guide.
*
* One or more substitution tokens for attribute names in an expression. The
* following are some use cases for using
*
* To access an attribute whose name conflicts with a DynamoDB reserved
* word.
*
* To create a placeholder for repeating occurrences of an attribute name in
* an expression.
*
* To prevent special characters in an attribute name from being
* misinterpreted in an expression.
*
* Use the # character in an expression to dereference an attribute
* name. For example, consider the following attribute name:
*
*
* The name of this attribute conflicts with a reserved word, so it cannot
* be used directly in an expression. (For the complete list of reserved
* words, see Reserved Words in the Amazon DynamoDB Developer Guide). To
* work around this, you could specify the following for
*
*
* You could then use this substitution in an expression, as in this
* example:
*
*
* Tokens that begin with the : character are expression attribute
* values, which are placeholders for the actual value at runtime.
*
* For more information on expression attribute names, see Accessing Item Attributes in the Amazon DynamoDB Developer
* Guide.
*
* The method adds a new key-value pair into ExpressionAttributeNames
* parameter, and returns a reference to this object so that method calls
* can be chained together.
*
* @param key The key of the entry to be added into
* ExpressionAttributeNames.
* @param value The corresponding value of the entry to be added into
* ExpressionAttributeNames.
* @return A reference to this updated object so that method calls can be
* chained together.
*/
public PutItemRequest addExpressionAttributeNamesEntry(String key, String value) {
if (null == this.expressionAttributeNames) {
this.expressionAttributeNames = new java.util.HashMap
* Returns a reference to this object so that method calls can be chained
* together.
*/
public PutItemRequest clearExpressionAttributeNamesEntries() {
this.expressionAttributeNames = null;
return this;
}
/**
*
* One or more values that can be substituted in an expression.
*
* Use the : (colon) character in an expression to dereference an
* attribute value. For example, suppose that you wanted to check whether
* the value of the ProductStatus attribute was one of the following:
*
*
* You would first need to specify
*
* You could then use these values in an expression, such as this:
*
*
* For more information on expression attribute values, see Specifying Conditions in the Amazon DynamoDB Developer Guide.
*
* One or more values that can be substituted in an expression.
*
* Use the : (colon) character in an expression to
* dereference an attribute value. For example, suppose that you
* wanted to check whether the value of the ProductStatus
* attribute was one of the following:
*
*
* You would first need to specify
*
*
* You could then use these values in an expression, such as this:
*
*
* For more information on expression attribute values, see Specifying Conditions in the Amazon DynamoDB Developer
* Guide.
*
* One or more values that can be substituted in an expression.
*
* Use the : (colon) character in an expression to dereference an
* attribute value. For example, suppose that you wanted to check whether
* the value of the ProductStatus attribute was one of the following:
*
*
* You would first need to specify
*
* You could then use these values in an expression, such as this:
*
*
* For more information on expression attribute values, see Specifying Conditions in the Amazon DynamoDB Developer Guide.
*
* One or more values that can be substituted in an expression.
*
* Use the : (colon) character in an expression to
* dereference an attribute value. For example, suppose that you
* wanted to check whether the value of the ProductStatus
* attribute was one of the following:
*
*
* You would first need to specify
*
*
* You could then use these values in an expression, such as
* this:
*
*
* For more information on expression attribute values, see Specifying Conditions in the Amazon DynamoDB Developer
* Guide.
*
* One or more values that can be substituted in an expression.
*
* Use the : (colon) character in an expression to dereference an
* attribute value. For example, suppose that you wanted to check whether
* the value of the ProductStatus attribute was one of the following:
*
*
* You would first need to specify
*
* You could then use these values in an expression, such as this:
*
*
* For more information on expression attribute values, see Specifying Conditions in the Amazon DynamoDB Developer Guide.
*
* Returns a reference to this object so that method calls can be chained
* together.
*
* @param expressionAttributeValues
* One or more values that can be substituted in an expression.
*
* Use the : (colon) character in an expression to
* dereference an attribute value. For example, suppose that you
* wanted to check whether the value of the ProductStatus
* attribute was one of the following:
*
*
* You would first need to specify
*
*
* You could then use these values in an expression, such as
* this:
*
*
* For more information on expression attribute values, see Specifying Conditions in the Amazon DynamoDB Developer
* Guide.
*
* One or more values that can be substituted in an expression.
*
* Use the : (colon) character in an expression to dereference an
* attribute value. For example, suppose that you wanted to check whether
* the value of the ProductStatus attribute was one of the following:
*
*
* You would first need to specify
*
* You could then use these values in an expression, such as this:
*
*
* For more information on expression attribute values, see Specifying Conditions in the Amazon DynamoDB Developer Guide.
*
* The method adds a new key-value pair into ExpressionAttributeValues
* parameter, and returns a reference to this object so that method calls
* can be chained together.
*
* @param key The key of the entry to be added into
* ExpressionAttributeValues.
* @param value The corresponding value of the entry to be added into
* ExpressionAttributeValues.
* @return A reference to this updated object so that method calls can be
* chained together.
*/
public PutItemRequest addExpressionAttributeValuesEntry(String key, AttributeValue value) {
if (null == this.expressionAttributeValues) {
this.expressionAttributeValues = new java.util.HashMap
* Returns a reference to this object so that method calls can be chained
* together.
*/
public PutItemRequest clearExpressionAttributeValuesEntries() {
this.expressionAttributeValues = null;
return this;
}
/**
* Returns a string representation of this object; useful for testing and
* debugging.
*
* @return A string representation of this object.
* @see java.lang.Object#toString()
*/
@Override
public String toString() {
StringBuilder sb = new StringBuilder();
sb.append("{");
if (getTableName() != null)
sb.append("TableName: " + getTableName() + ",");
if (getItem() != null)
sb.append("Item: " + getItem() + ",");
if (getExpected() != null)
sb.append("Expected: " + getExpected() + ",");
if (getReturnValues() != null)
sb.append("ReturnValues: " + getReturnValues() + ",");
if (getReturnConsumedCapacity() != null)
sb.append("ReturnConsumedCapacity: " + getReturnConsumedCapacity() + ",");
if (getReturnItemCollectionMetrics() != null)
sb.append("ReturnItemCollectionMetrics: " + getReturnItemCollectionMetrics() + ",");
if (getConditionalOperator() != null)
sb.append("ConditionalOperator: " + getConditionalOperator() + ",");
if (getConditionExpression() != null)
sb.append("ConditionExpression: " + getConditionExpression() + ",");
if (getExpressionAttributeNames() != null)
sb.append("ExpressionAttributeNames: " + getExpressionAttributeNames() + ",");
if (getExpressionAttributeValues() != null)
sb.append("ExpressionAttributeValues: " + getExpressionAttributeValues());
sb.append("}");
return sb.toString();
}
@Override
public int hashCode() {
final int prime = 31;
int hashCode = 1;
hashCode = prime * hashCode + ((getTableName() == null) ? 0 : getTableName().hashCode());
hashCode = prime * hashCode + ((getItem() == null) ? 0 : getItem().hashCode());
hashCode = prime * hashCode + ((getExpected() == null) ? 0 : getExpected().hashCode());
hashCode = prime * hashCode
+ ((getReturnValues() == null) ? 0 : getReturnValues().hashCode());
hashCode = prime
* hashCode
+ ((getReturnConsumedCapacity() == null) ? 0 : getReturnConsumedCapacity()
.hashCode());
hashCode = prime
* hashCode
+ ((getReturnItemCollectionMetrics() == null) ? 0
: getReturnItemCollectionMetrics().hashCode());
hashCode = prime * hashCode
+ ((getConditionalOperator() == null) ? 0 : getConditionalOperator().hashCode());
hashCode = prime * hashCode
+ ((getConditionExpression() == null) ? 0 : getConditionExpression().hashCode());
hashCode = prime
* hashCode
+ ((getExpressionAttributeNames() == null) ? 0 : getExpressionAttributeNames()
.hashCode());
hashCode = prime
* hashCode
+ ((getExpressionAttributeValues() == null) ? 0 : getExpressionAttributeValues()
.hashCode());
return hashCode;
}
@Override
public boolean equals(Object obj) {
if (this == obj)
return true;
if (obj == null)
return false;
if (obj instanceof PutItemRequest == false)
return false;
PutItemRequest other = (PutItemRequest) obj;
if (other.getTableName() == null ^ this.getTableName() == null)
return false;
if (other.getTableName() != null
&& other.getTableName().equals(this.getTableName()) == false)
return false;
if (other.getItem() == null ^ this.getItem() == null)
return false;
if (other.getItem() != null && other.getItem().equals(this.getItem()) == false)
return false;
if (other.getExpected() == null ^ this.getExpected() == null)
return false;
if (other.getExpected() != null && other.getExpected().equals(this.getExpected()) == false)
return false;
if (other.getReturnValues() == null ^ this.getReturnValues() == null)
return false;
if (other.getReturnValues() != null
&& other.getReturnValues().equals(this.getReturnValues()) == false)
return false;
if (other.getReturnConsumedCapacity() == null ^ this.getReturnConsumedCapacity() == null)
return false;
if (other.getReturnConsumedCapacity() != null
&& other.getReturnConsumedCapacity().equals(this.getReturnConsumedCapacity()) == false)
return false;
if (other.getReturnItemCollectionMetrics() == null
^ this.getReturnItemCollectionMetrics() == null)
return false;
if (other.getReturnItemCollectionMetrics() != null
&& other.getReturnItemCollectionMetrics().equals(
this.getReturnItemCollectionMetrics()) == false)
return false;
if (other.getConditionalOperator() == null ^ this.getConditionalOperator() == null)
return false;
if (other.getConditionalOperator() != null
&& other.getConditionalOperator().equals(this.getConditionalOperator()) == false)
return false;
if (other.getConditionExpression() == null ^ this.getConditionExpression() == null)
return false;
if (other.getConditionExpression() != null
&& other.getConditionExpression().equals(this.getConditionExpression()) == false)
return false;
if (other.getExpressionAttributeNames() == null
^ this.getExpressionAttributeNames() == null)
return false;
if (other.getExpressionAttributeNames() != null
&& other.getExpressionAttributeNames().equals(this.getExpressionAttributeNames()) == false)
return false;
if (other.getExpressionAttributeValues() == null
^ this.getExpressionAttributeValues() == null)
return false;
if (other.getExpressionAttributeValues() != null
&& other.getExpressionAttributeValues().equals(this.getExpressionAttributeValues()) == false)
return false;
return true;
}
}
ConditionExpression
instead.
* For more information, see Expected in the Amazon DynamoDB Developer Guide.
* ConditionExpression
* instead. For more information, see Expected in the Amazon DynamoDB Developer Guide.
* ConditionExpression
instead.
* For more information, see Expected in the Amazon DynamoDB Developer Guide.
* ConditionExpression
instead. For more
* information, see Expected in the Amazon DynamoDB Developer Guide.
* ConditionExpression
instead.
* For more information, see Expected in the Amazon DynamoDB Developer Guide.
* ConditionExpression
instead. For more
* information, see Expected in the Amazon DynamoDB Developer Guide.
* ConditionExpression
instead.
* For more information, see Expected in the Amazon DynamoDB Developer Guide.
* ReturnValues
if you want to get the item attributes as
* they appeared before they were updated with the PutItem
* request. For PutItem
, the valid values are:
*
*
* NONE
- If ReturnValues
is not specified, or if
* its value is NONE
, then nothing is returned. (This setting
* is the default for ReturnValues
.)
* ALL_OLD
- If PutItem
overwrote an attribute
* name-value pair, then the content of the old item is returned.
* ReturnValues
parameter is used by several DynamoDB
* operations; however, PutItem
does not recognize any values
* other than NONE
or ALL_OLD
.
*
* Allowed Values: NONE, ALL_OLD, UPDATED_OLD, ALL_NEW, UPDATED_NEW
*
* @return ReturnValues
if you want to get the item
* attributes as they appeared before they were updated with the
* PutItem
request. For PutItem
, the valid
* values are:
*
*
* NONE
- If ReturnValues
is not
* specified, or if its value is NONE
, then nothing is
* returned. (This setting is the default for
* ReturnValues
.)
* ALL_OLD
- If PutItem
overwrote an
* attribute name-value pair, then the content of the old item is
* returned.
* ReturnValues
parameter is used by several
* DynamoDB operations; however, PutItem
does not
* recognize any values other than NONE
or
* ALL_OLD
.
* ReturnValues
if you want to get the item attributes as
* they appeared before they were updated with the PutItem
* request. For PutItem
, the valid values are:
*
*
* NONE
- If ReturnValues
is not specified, or if
* its value is NONE
, then nothing is returned. (This setting
* is the default for ReturnValues
.)
* ALL_OLD
- If PutItem
overwrote an attribute
* name-value pair, then the content of the old item is returned.
* ReturnValues
parameter is used by several DynamoDB
* operations; however, PutItem
does not recognize any values
* other than NONE
or ALL_OLD
.
*
* Allowed Values: NONE, ALL_OLD, UPDATED_OLD, ALL_NEW, UPDATED_NEW
*
* @param returnValues ReturnValues
if you want to get the item
* attributes as they appeared before they were updated with the
* PutItem
request. For PutItem
, the
* valid values are:
*
*
* NONE
- If ReturnValues
is not
* specified, or if its value is NONE
, then nothing
* is returned. (This setting is the default for
* ReturnValues
.)
* ALL_OLD
- If PutItem
overwrote an
* attribute name-value pair, then the content of the old item is
* returned.
* ReturnValues
parameter is used by several
* DynamoDB operations; however, PutItem
does not
* recognize any values other than NONE
or
* ALL_OLD
.
* ReturnValues
if you want to get the item attributes as
* they appeared before they were updated with the PutItem
* request. For PutItem
, the valid values are:
*
*
* NONE
- If ReturnValues
is not specified, or if
* its value is NONE
, then nothing is returned. (This setting
* is the default for ReturnValues
.)
* ALL_OLD
- If PutItem
overwrote an attribute
* name-value pair, then the content of the old item is returned.
* ReturnValues
parameter is used by several DynamoDB
* operations; however, PutItem
does not recognize any values
* other than NONE
or ALL_OLD
.
*
* Allowed Values: NONE, ALL_OLD, UPDATED_OLD, ALL_NEW, UPDATED_NEW
*
* @param returnValues ReturnValues
if you want to get the item
* attributes as they appeared before they were updated with the
* PutItem
request. For PutItem
, the
* valid values are:
*
*
* NONE
- If ReturnValues
is not
* specified, or if its value is NONE
, then nothing
* is returned. (This setting is the default for
* ReturnValues
.)
* ALL_OLD
- If PutItem
overwrote an
* attribute name-value pair, then the content of the old item is
* returned.
* ReturnValues
parameter is used by several
* DynamoDB operations; however, PutItem
does not
* recognize any values other than NONE
or
* ALL_OLD
.
* ReturnValues
if you want to get the item attributes as
* they appeared before they were updated with the PutItem
* request. For PutItem
, the valid values are:
*
*
* NONE
- If ReturnValues
is not specified, or if
* its value is NONE
, then nothing is returned. (This setting
* is the default for ReturnValues
.)
* ALL_OLD
- If PutItem
overwrote an attribute
* name-value pair, then the content of the old item is returned.
* ReturnValues
parameter is used by several DynamoDB
* operations; however, PutItem
does not recognize any values
* other than NONE
or ALL_OLD
.
*
* Allowed Values: NONE, ALL_OLD, UPDATED_OLD, ALL_NEW, UPDATED_NEW
*
* @param returnValues ReturnValues
if you want to get the item
* attributes as they appeared before they were updated with the
* PutItem
request. For PutItem
, the
* valid values are:
*
*
* NONE
- If ReturnValues
is not
* specified, or if its value is NONE
, then nothing
* is returned. (This setting is the default for
* ReturnValues
.)
* ALL_OLD
- If PutItem
overwrote an
* attribute name-value pair, then the content of the old item is
* returned.
* ReturnValues
parameter is used by several
* DynamoDB operations; however, PutItem
does not
* recognize any values other than NONE
or
* ALL_OLD
.
* ReturnValues
if you want to get the item attributes as
* they appeared before they were updated with the PutItem
* request. For PutItem
, the valid values are:
*
*
* NONE
- If ReturnValues
is not specified, or if
* its value is NONE
, then nothing is returned. (This setting
* is the default for ReturnValues
.)
* ALL_OLD
- If PutItem
overwrote an attribute
* name-value pair, then the content of the old item is returned.
* ReturnValues
parameter is used by several DynamoDB
* operations; however, PutItem
does not recognize any values
* other than NONE
or ALL_OLD
.
*
* Allowed Values: NONE, ALL_OLD, UPDATED_OLD, ALL_NEW, UPDATED_NEW
*
* @param returnValues ReturnValues
if you want to get the item
* attributes as they appeared before they were updated with the
* PutItem
request. For PutItem
, the
* valid values are:
*
*
* NONE
- If ReturnValues
is not
* specified, or if its value is NONE
, then nothing
* is returned. (This setting is the default for
* ReturnValues
.)
* ALL_OLD
- If PutItem
overwrote an
* attribute name-value pair, then the content of the old item is
* returned.
* ReturnValues
parameter is used by several
* DynamoDB operations; however, PutItem
does not
* recognize any values other than NONE
or
* ALL_OLD
.
*
*
* INDEXES
- The response includes the aggregate
* ConsumedCapacity
for the operation, together with
* ConsumedCapacity
for each table and secondary index that was
* accessed.
* GetItem
and
* BatchGetItem
, do not access any indexes at all. In these
* cases, specifying INDEXES
will only return
* ConsumedCapacity
information for table(s).
* TOTAL
- The response includes only the aggregate
* ConsumedCapacity
for the operation.
* NONE
- No ConsumedCapacity
details are included
* in the response.
*
* Allowed Values: INDEXES, TOTAL, NONE
*
* @return
*
* @see ReturnConsumedCapacity
*/
public String getReturnConsumedCapacity() {
return returnConsumedCapacity;
}
/**
* INDEXES
- The response includes the aggregate
* ConsumedCapacity
for the operation, together with
* ConsumedCapacity
for each table and secondary index
* that was accessed.
* GetItem
and
* BatchGetItem
, do not access any indexes at all. In
* these cases, specifying INDEXES
will only return
* ConsumedCapacity
information for table(s).
* TOTAL
- The response includes only the aggregate
* ConsumedCapacity
for the operation.
* NONE
- No ConsumedCapacity
details are
* included in the response.
*
*
* INDEXES
- The response includes the aggregate
* ConsumedCapacity
for the operation, together with
* ConsumedCapacity
for each table and secondary index that was
* accessed.
* GetItem
and
* BatchGetItem
, do not access any indexes at all. In these
* cases, specifying INDEXES
will only return
* ConsumedCapacity
information for table(s).
* TOTAL
- The response includes only the aggregate
* ConsumedCapacity
for the operation.
* NONE
- No ConsumedCapacity
details are included
* in the response.
*
* Allowed Values: INDEXES, TOTAL, NONE
*
* @param returnConsumedCapacity
*
* @see ReturnConsumedCapacity
*/
public void setReturnConsumedCapacity(String returnConsumedCapacity) {
this.returnConsumedCapacity = returnConsumedCapacity;
}
/**
* INDEXES
- The response includes the aggregate
* ConsumedCapacity
for the operation, together with
* ConsumedCapacity
for each table and secondary
* index that was accessed.
* GetItem
and
* BatchGetItem
, do not access any indexes at all.
* In these cases, specifying INDEXES
will only
* return ConsumedCapacity
information for table(s).
* TOTAL
- The response includes only the aggregate
* ConsumedCapacity
for the operation.
* NONE
- No ConsumedCapacity
details
* are included in the response.
*
*
* INDEXES
- The response includes the aggregate
* ConsumedCapacity
for the operation, together with
* ConsumedCapacity
for each table and secondary index that was
* accessed.
* GetItem
and
* BatchGetItem
, do not access any indexes at all. In these
* cases, specifying INDEXES
will only return
* ConsumedCapacity
information for table(s).
* TOTAL
- The response includes only the aggregate
* ConsumedCapacity
for the operation.
* NONE
- No ConsumedCapacity
details are included
* in the response.
*
* Allowed Values: INDEXES, TOTAL, NONE
*
* @param returnConsumedCapacity
*
* @return A reference to this updated object so that method calls can be
* chained together.
* @see ReturnConsumedCapacity
*/
public PutItemRequest withReturnConsumedCapacity(String returnConsumedCapacity) {
this.returnConsumedCapacity = returnConsumedCapacity;
return this;
}
/**
* INDEXES
- The response includes the aggregate
* ConsumedCapacity
for the operation, together with
* ConsumedCapacity
for each table and secondary
* index that was accessed.
* GetItem
and
* BatchGetItem
, do not access any indexes at all.
* In these cases, specifying INDEXES
will only
* return ConsumedCapacity
information for table(s).
* TOTAL
- The response includes only the aggregate
* ConsumedCapacity
for the operation.
* NONE
- No ConsumedCapacity
details
* are included in the response.
*
*
* INDEXES
- The response includes the aggregate
* ConsumedCapacity
for the operation, together with
* ConsumedCapacity
for each table and secondary index that was
* accessed.
* GetItem
and
* BatchGetItem
, do not access any indexes at all. In these
* cases, specifying INDEXES
will only return
* ConsumedCapacity
information for table(s).
* TOTAL
- The response includes only the aggregate
* ConsumedCapacity
for the operation.
* NONE
- No ConsumedCapacity
details are included
* in the response.
*
* Allowed Values: INDEXES, TOTAL, NONE
*
* @param returnConsumedCapacity
*
* @see ReturnConsumedCapacity
*/
public void setReturnConsumedCapacity(ReturnConsumedCapacity returnConsumedCapacity) {
this.returnConsumedCapacity = returnConsumedCapacity.toString();
}
/**
* INDEXES
- The response includes the aggregate
* ConsumedCapacity
for the operation, together with
* ConsumedCapacity
for each table and secondary
* index that was accessed.
* GetItem
and
* BatchGetItem
, do not access any indexes at all.
* In these cases, specifying INDEXES
will only
* return ConsumedCapacity
information for table(s).
* TOTAL
- The response includes only the aggregate
* ConsumedCapacity
for the operation.
* NONE
- No ConsumedCapacity
details
* are included in the response.
*
*
* INDEXES
- The response includes the aggregate
* ConsumedCapacity
for the operation, together with
* ConsumedCapacity
for each table and secondary index that was
* accessed.
* GetItem
and
* BatchGetItem
, do not access any indexes at all. In these
* cases, specifying INDEXES
will only return
* ConsumedCapacity
information for table(s).
* TOTAL
- The response includes only the aggregate
* ConsumedCapacity
for the operation.
* NONE
- No ConsumedCapacity
details are included
* in the response.
*
* Allowed Values: INDEXES, TOTAL, NONE
*
* @param returnConsumedCapacity
*
* @return A reference to this updated object so that method calls can be
* chained together.
* @see ReturnConsumedCapacity
*/
public PutItemRequest withReturnConsumedCapacity(ReturnConsumedCapacity returnConsumedCapacity) {
this.returnConsumedCapacity = returnConsumedCapacity.toString();
return this;
}
/**
* INDEXES
- The response includes the aggregate
* ConsumedCapacity
for the operation, together with
* ConsumedCapacity
for each table and secondary
* index that was accessed.
* GetItem
and
* BatchGetItem
, do not access any indexes at all.
* In these cases, specifying INDEXES
will only
* return ConsumedCapacity
information for table(s).
* TOTAL
- The response includes only the aggregate
* ConsumedCapacity
for the operation.
* NONE
- No ConsumedCapacity
details
* are included in the response.
* SIZE
, the response includes statistics about item
* collections, if any, that were modified during the operation are returned
* in the response. If set to NONE
(the default), no statistics
* are returned.
*
* Allowed Values: SIZE, NONE
*
* @return SIZE
, the response includes statistics about item
* collections, if any, that were modified during the operation are
* returned in the response. If set to NONE
(the
* default), no statistics are returned.
* SIZE
, the response includes statistics about item
* collections, if any, that were modified during the operation are returned
* in the response. If set to NONE
(the default), no statistics
* are returned.
*
* Allowed Values: SIZE, NONE
*
* @param returnItemCollectionMetrics SIZE
, the response includes statistics
* about item collections, if any, that were modified during the
* operation are returned in the response. If set to
* NONE
(the default), no statistics are returned.
* SIZE
, the response includes statistics about item
* collections, if any, that were modified during the operation are returned
* in the response. If set to NONE
(the default), no statistics
* are returned.
*
* Allowed Values: SIZE, NONE
*
* @param returnItemCollectionMetrics SIZE
, the response includes statistics
* about item collections, if any, that were modified during the
* operation are returned in the response. If set to
* NONE
(the default), no statistics are returned.
* SIZE
, the response includes statistics about item
* collections, if any, that were modified during the operation are returned
* in the response. If set to NONE
(the default), no statistics
* are returned.
*
* Allowed Values: SIZE, NONE
*
* @param returnItemCollectionMetrics SIZE
, the response includes statistics
* about item collections, if any, that were modified during the
* operation are returned in the response. If set to
* NONE
(the default), no statistics are returned.
* SIZE
, the response includes statistics about item
* collections, if any, that were modified during the operation are returned
* in the response. If set to NONE
(the default), no statistics
* are returned.
*
* Allowed Values: SIZE, NONE
*
* @param returnItemCollectionMetrics SIZE
, the response includes statistics
* about item collections, if any, that were modified during the
* operation are returned in the response. If set to
* NONE
(the default), no statistics are returned.
* ConditionExpression
instead.
* For more information, see ConditionalOperator in the Amazon DynamoDB Developer Guide.
*
* Allowed Values: AND, OR
*
* @return ConditionExpression
* instead. For more information, see ConditionalOperator in the Amazon DynamoDB Developer
* Guide.
* ConditionExpression
instead.
* For more information, see ConditionalOperator in the Amazon DynamoDB Developer Guide.
*
* Allowed Values: AND, OR
*
* @param conditionalOperator ConditionExpression
instead. For more
* information, see ConditionalOperator in the Amazon DynamoDB Developer
* Guide.
* ConditionExpression
instead.
* For more information, see ConditionalOperator in the Amazon DynamoDB Developer Guide.
*
* Allowed Values: AND, OR
*
* @param conditionalOperator ConditionExpression
instead. For more
* information, see ConditionalOperator in the Amazon DynamoDB Developer
* Guide.
* ConditionExpression
instead.
* For more information, see ConditionalOperator in the Amazon DynamoDB Developer Guide.
*
* Allowed Values: AND, OR
*
* @param conditionalOperator ConditionExpression
instead. For more
* information, see ConditionalOperator in the Amazon DynamoDB Developer
* Guide.
* ConditionExpression
instead.
* For more information, see ConditionalOperator in the Amazon DynamoDB Developer Guide.
*
* Allowed Values: AND, OR
*
* @param conditionalOperator ConditionExpression
instead. For more
* information, see ConditionalOperator in the Amazon DynamoDB Developer
* Guide.
* PutItem
operation to succeed.
*
*
* attribute_exists | attribute_not_exists | attribute_type | contains | begins_with | size
* = | <> | < | > | <= | >= | BETWEEN | IN
* AND | OR | NOT
* PutItem
operation to succeed.
*
*
* attribute_exists | attribute_not_exists | attribute_type | contains | begins_with | size
* = | <> | < | > | <= | >= | BETWEEN | IN
* AND | OR | NOT
* PutItem
operation to succeed.
*
*
* attribute_exists | attribute_not_exists | attribute_type | contains | begins_with | size
* = | <> | < | > | <= | >= | BETWEEN | IN
* AND | OR | NOT
* PutItem
operation to succeed.
*
*
* attribute_exists | attribute_not_exists | attribute_type | contains | begins_with | size
* = | <> | < | > | <= | >= | BETWEEN | IN
* AND | OR | NOT
* PutItem
operation to succeed.
*
*
* attribute_exists | attribute_not_exists | attribute_type | contains | begins_with | size
* = | <> | < | > | <= | >= | BETWEEN | IN
* AND | OR | NOT
* PutItem
operation to succeed.
*
*
* attribute_exists | attribute_not_exists | attribute_type | contains | begins_with | size
* = | <> | < | > | <= | >= | BETWEEN | IN
* AND | OR | NOT
* ExpressionAttributeNames
:
*
*
*
*
* Percentile
* ExpressionAttributeNames
:
*
*
* {"#P":"Percentile"}
*
*
* #P = :val
* ExpressionAttributeNames
:
*
*
*
*
* Percentile
* ExpressionAttributeNames
:
*
*
* {"#P":"Percentile"}
*
*
* #P = :val
* ExpressionAttributeNames
:
*
*
*
*
* Percentile
* ExpressionAttributeNames
:
*
*
* {"#P":"Percentile"}
*
*
* #P = :val
* ExpressionAttributeNames
:
*
*
*
*
* Percentile
* ExpressionAttributeNames
:
*
*
* {"#P":"Percentile"}
*
*
* #P = :val
* ExpressionAttributeNames
:
*
*
*
*
* Percentile
* ExpressionAttributeNames
:
*
*
* {"#P":"Percentile"}
*
*
* #P = :val
* ExpressionAttributeNames
:
*
*
*
*
* Percentile
* ExpressionAttributeNames
:
*
*
* {"#P":"Percentile"}
*
*
* #P = :val
* ExpressionAttributeNames
:
*
*
*
*
* Percentile
* ExpressionAttributeNames
:
*
*
* {"#P":"Percentile"}
*
*
* #P = :val
* Available | Backordered | Discontinued
* ExpressionAttributeValues
as
* follows:
* { ":avail":{"S":"Available"}, ":back":{"S":"Backordered"}, ":disc":{"S":"Discontinued"} }
* ProductStatus IN (:avail, :back, :disc)
* Available | Backordered | Discontinued
* ExpressionAttributeValues
as follows:
* { ":avail":{"S":"Available"}, ":back":{"S":"Backordered"}, ":disc":{"S":"Discontinued"} }
* ProductStatus IN (:avail, :back, :disc)
* Available | Backordered | Discontinued
* ExpressionAttributeValues
as
* follows:
* { ":avail":{"S":"Available"}, ":back":{"S":"Backordered"}, ":disc":{"S":"Discontinued"} }
* ProductStatus IN (:avail, :back, :disc)
* Available | Backordered | Discontinued
* ExpressionAttributeValues
as follows:
* { ":avail":{"S":"Available"}, ":back":{"S":"Backordered"}, ":disc":{"S":"Discontinued"} }
* ProductStatus IN (:avail, :back, :disc)
* Available | Backordered | Discontinued
* ExpressionAttributeValues
as
* follows:
* { ":avail":{"S":"Available"}, ":back":{"S":"Backordered"}, ":disc":{"S":"Discontinued"} }
* ProductStatus IN (:avail, :back, :disc)
* Available | Backordered | Discontinued
* ExpressionAttributeValues
as follows:
* { ":avail":{"S":"Available"}, ":back":{"S":"Backordered"}, ":disc":{"S":"Discontinued"} }
* ProductStatus IN (:avail, :back, :disc)
* Available | Backordered | Discontinued
* ExpressionAttributeValues
as
* follows:
* { ":avail":{"S":"Available"}, ":back":{"S":"Backordered"}, ":disc":{"S":"Discontinued"} }
* ProductStatus IN (:avail, :back, :disc)
*