791 lines
49 KiB
C++
791 lines
49 KiB
C++
/**
|
|
* Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
|
|
* SPDX-License-Identifier: Apache-2.0.
|
|
*/
|
|
|
|
#pragma once
|
|
#include <aws/dynamodb/DynamoDB_EXPORTS.h>
|
|
#include <aws/dynamodb/DynamoDBRequest.h>
|
|
#include <aws/core/utils/memory/stl/AWSString.h>
|
|
#include <aws/core/utils/memory/stl/AWSMap.h>
|
|
#include <aws/core/utils/memory/stl/AWSVector.h>
|
|
#include <aws/dynamodb/model/ReturnConsumedCapacity.h>
|
|
#include <aws/dynamodb/model/AttributeValue.h>
|
|
#include <utility>
|
|
|
|
namespace Aws
|
|
{
|
|
namespace DynamoDB
|
|
{
|
|
namespace Model
|
|
{
|
|
|
|
/**
|
|
* <p>Represents the input of a <code>GetItem</code> operation.</p><p><h3>See
|
|
* Also:</h3> <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/GetItemInput">AWS
|
|
* API Reference</a></p>
|
|
*/
|
|
class AWS_DYNAMODB_API GetItemRequest : public DynamoDBRequest
|
|
{
|
|
public:
|
|
GetItemRequest();
|
|
|
|
// Service request name is the Operation name which will send this request out,
|
|
// each operation should has unique request name, so that we can get operation's name from this request.
|
|
// Note: this is not true for response, multiple operations may have the same response name,
|
|
// so we can not get operation's name from response.
|
|
inline virtual const char* GetServiceRequestName() const override { return "GetItem"; }
|
|
|
|
Aws::String SerializePayload() const override;
|
|
|
|
Aws::Http::HeaderValueCollection GetRequestSpecificHeaders() const override;
|
|
|
|
|
|
/**
|
|
* <p>The name of the table containing the requested item.</p>
|
|
*/
|
|
inline const Aws::String& GetTableName() const{ return m_tableName; }
|
|
|
|
/**
|
|
* <p>The name of the table containing the requested item.</p>
|
|
*/
|
|
inline bool TableNameHasBeenSet() const { return m_tableNameHasBeenSet; }
|
|
|
|
/**
|
|
* <p>The name of the table containing the requested item.</p>
|
|
*/
|
|
inline void SetTableName(const Aws::String& value) { m_tableNameHasBeenSet = true; m_tableName = value; }
|
|
|
|
/**
|
|
* <p>The name of the table containing the requested item.</p>
|
|
*/
|
|
inline void SetTableName(Aws::String&& value) { m_tableNameHasBeenSet = true; m_tableName = std::move(value); }
|
|
|
|
/**
|
|
* <p>The name of the table containing the requested item.</p>
|
|
*/
|
|
inline void SetTableName(const char* value) { m_tableNameHasBeenSet = true; m_tableName.assign(value); }
|
|
|
|
/**
|
|
* <p>The name of the table containing the requested item.</p>
|
|
*/
|
|
inline GetItemRequest& WithTableName(const Aws::String& value) { SetTableName(value); return *this;}
|
|
|
|
/**
|
|
* <p>The name of the table containing the requested item.</p>
|
|
*/
|
|
inline GetItemRequest& WithTableName(Aws::String&& value) { SetTableName(std::move(value)); return *this;}
|
|
|
|
/**
|
|
* <p>The name of the table containing the requested item.</p>
|
|
*/
|
|
inline GetItemRequest& WithTableName(const char* value) { SetTableName(value); return *this;}
|
|
|
|
|
|
/**
|
|
* <p>A map of attribute names to <code>AttributeValue</code> objects, representing
|
|
* the primary key of the item to retrieve.</p> <p>For the primary key, you must
|
|
* provide all of the attributes. 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 values for both the partition key and the sort key.</p>
|
|
*/
|
|
inline const Aws::Map<Aws::String, AttributeValue>& GetKey() const{ return m_key; }
|
|
|
|
/**
|
|
* <p>A map of attribute names to <code>AttributeValue</code> objects, representing
|
|
* the primary key of the item to retrieve.</p> <p>For the primary key, you must
|
|
* provide all of the attributes. 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 values for both the partition key and the sort key.</p>
|
|
*/
|
|
inline bool KeyHasBeenSet() const { return m_keyHasBeenSet; }
|
|
|
|
/**
|
|
* <p>A map of attribute names to <code>AttributeValue</code> objects, representing
|
|
* the primary key of the item to retrieve.</p> <p>For the primary key, you must
|
|
* provide all of the attributes. 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 values for both the partition key and the sort key.</p>
|
|
*/
|
|
inline void SetKey(const Aws::Map<Aws::String, AttributeValue>& value) { m_keyHasBeenSet = true; m_key = value; }
|
|
|
|
/**
|
|
* <p>A map of attribute names to <code>AttributeValue</code> objects, representing
|
|
* the primary key of the item to retrieve.</p> <p>For the primary key, you must
|
|
* provide all of the attributes. 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 values for both the partition key and the sort key.</p>
|
|
*/
|
|
inline void SetKey(Aws::Map<Aws::String, AttributeValue>&& value) { m_keyHasBeenSet = true; m_key = std::move(value); }
|
|
|
|
/**
|
|
* <p>A map of attribute names to <code>AttributeValue</code> objects, representing
|
|
* the primary key of the item to retrieve.</p> <p>For the primary key, you must
|
|
* provide all of the attributes. 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 values for both the partition key and the sort key.</p>
|
|
*/
|
|
inline GetItemRequest& WithKey(const Aws::Map<Aws::String, AttributeValue>& value) { SetKey(value); return *this;}
|
|
|
|
/**
|
|
* <p>A map of attribute names to <code>AttributeValue</code> objects, representing
|
|
* the primary key of the item to retrieve.</p> <p>For the primary key, you must
|
|
* provide all of the attributes. 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 values for both the partition key and the sort key.</p>
|
|
*/
|
|
inline GetItemRequest& WithKey(Aws::Map<Aws::String, AttributeValue>&& value) { SetKey(std::move(value)); return *this;}
|
|
|
|
/**
|
|
* <p>A map of attribute names to <code>AttributeValue</code> objects, representing
|
|
* the primary key of the item to retrieve.</p> <p>For the primary key, you must
|
|
* provide all of the attributes. 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 values for both the partition key and the sort key.</p>
|
|
*/
|
|
inline GetItemRequest& AddKey(const Aws::String& key, const AttributeValue& value) { m_keyHasBeenSet = true; m_key.emplace(key, value); return *this; }
|
|
|
|
/**
|
|
* <p>A map of attribute names to <code>AttributeValue</code> objects, representing
|
|
* the primary key of the item to retrieve.</p> <p>For the primary key, you must
|
|
* provide all of the attributes. 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 values for both the partition key and the sort key.</p>
|
|
*/
|
|
inline GetItemRequest& AddKey(Aws::String&& key, const AttributeValue& value) { m_keyHasBeenSet = true; m_key.emplace(std::move(key), value); return *this; }
|
|
|
|
/**
|
|
* <p>A map of attribute names to <code>AttributeValue</code> objects, representing
|
|
* the primary key of the item to retrieve.</p> <p>For the primary key, you must
|
|
* provide all of the attributes. 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 values for both the partition key and the sort key.</p>
|
|
*/
|
|
inline GetItemRequest& AddKey(const Aws::String& key, AttributeValue&& value) { m_keyHasBeenSet = true; m_key.emplace(key, std::move(value)); return *this; }
|
|
|
|
/**
|
|
* <p>A map of attribute names to <code>AttributeValue</code> objects, representing
|
|
* the primary key of the item to retrieve.</p> <p>For the primary key, you must
|
|
* provide all of the attributes. 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 values for both the partition key and the sort key.</p>
|
|
*/
|
|
inline GetItemRequest& AddKey(Aws::String&& key, AttributeValue&& value) { m_keyHasBeenSet = true; m_key.emplace(std::move(key), std::move(value)); return *this; }
|
|
|
|
/**
|
|
* <p>A map of attribute names to <code>AttributeValue</code> objects, representing
|
|
* the primary key of the item to retrieve.</p> <p>For the primary key, you must
|
|
* provide all of the attributes. 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 values for both the partition key and the sort key.</p>
|
|
*/
|
|
inline GetItemRequest& AddKey(const char* key, AttributeValue&& value) { m_keyHasBeenSet = true; m_key.emplace(key, std::move(value)); return *this; }
|
|
|
|
/**
|
|
* <p>A map of attribute names to <code>AttributeValue</code> objects, representing
|
|
* the primary key of the item to retrieve.</p> <p>For the primary key, you must
|
|
* provide all of the attributes. 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 values for both the partition key and the sort key.</p>
|
|
*/
|
|
inline GetItemRequest& AddKey(const char* key, const AttributeValue& value) { m_keyHasBeenSet = true; m_key.emplace(key, value); return *this; }
|
|
|
|
|
|
/**
|
|
* <p>This is a legacy parameter. Use <code>ProjectionExpression</code> instead.
|
|
* For more information, see <a
|
|
* href="https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/LegacyConditionalParameters.AttributesToGet.html">AttributesToGet</a>
|
|
* in the <i>Amazon DynamoDB Developer Guide</i>.</p>
|
|
*/
|
|
inline const Aws::Vector<Aws::String>& GetAttributesToGet() const{ return m_attributesToGet; }
|
|
|
|
/**
|
|
* <p>This is a legacy parameter. Use <code>ProjectionExpression</code> instead.
|
|
* For more information, see <a
|
|
* href="https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/LegacyConditionalParameters.AttributesToGet.html">AttributesToGet</a>
|
|
* in the <i>Amazon DynamoDB Developer Guide</i>.</p>
|
|
*/
|
|
inline bool AttributesToGetHasBeenSet() const { return m_attributesToGetHasBeenSet; }
|
|
|
|
/**
|
|
* <p>This is a legacy parameter. Use <code>ProjectionExpression</code> instead.
|
|
* For more information, see <a
|
|
* href="https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/LegacyConditionalParameters.AttributesToGet.html">AttributesToGet</a>
|
|
* in the <i>Amazon DynamoDB Developer Guide</i>.</p>
|
|
*/
|
|
inline void SetAttributesToGet(const Aws::Vector<Aws::String>& value) { m_attributesToGetHasBeenSet = true; m_attributesToGet = value; }
|
|
|
|
/**
|
|
* <p>This is a legacy parameter. Use <code>ProjectionExpression</code> instead.
|
|
* For more information, see <a
|
|
* href="https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/LegacyConditionalParameters.AttributesToGet.html">AttributesToGet</a>
|
|
* in the <i>Amazon DynamoDB Developer Guide</i>.</p>
|
|
*/
|
|
inline void SetAttributesToGet(Aws::Vector<Aws::String>&& value) { m_attributesToGetHasBeenSet = true; m_attributesToGet = std::move(value); }
|
|
|
|
/**
|
|
* <p>This is a legacy parameter. Use <code>ProjectionExpression</code> instead.
|
|
* For more information, see <a
|
|
* href="https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/LegacyConditionalParameters.AttributesToGet.html">AttributesToGet</a>
|
|
* in the <i>Amazon DynamoDB Developer Guide</i>.</p>
|
|
*/
|
|
inline GetItemRequest& WithAttributesToGet(const Aws::Vector<Aws::String>& value) { SetAttributesToGet(value); return *this;}
|
|
|
|
/**
|
|
* <p>This is a legacy parameter. Use <code>ProjectionExpression</code> instead.
|
|
* For more information, see <a
|
|
* href="https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/LegacyConditionalParameters.AttributesToGet.html">AttributesToGet</a>
|
|
* in the <i>Amazon DynamoDB Developer Guide</i>.</p>
|
|
*/
|
|
inline GetItemRequest& WithAttributesToGet(Aws::Vector<Aws::String>&& value) { SetAttributesToGet(std::move(value)); return *this;}
|
|
|
|
/**
|
|
* <p>This is a legacy parameter. Use <code>ProjectionExpression</code> instead.
|
|
* For more information, see <a
|
|
* href="https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/LegacyConditionalParameters.AttributesToGet.html">AttributesToGet</a>
|
|
* in the <i>Amazon DynamoDB Developer Guide</i>.</p>
|
|
*/
|
|
inline GetItemRequest& AddAttributesToGet(const Aws::String& value) { m_attributesToGetHasBeenSet = true; m_attributesToGet.push_back(value); return *this; }
|
|
|
|
/**
|
|
* <p>This is a legacy parameter. Use <code>ProjectionExpression</code> instead.
|
|
* For more information, see <a
|
|
* href="https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/LegacyConditionalParameters.AttributesToGet.html">AttributesToGet</a>
|
|
* in the <i>Amazon DynamoDB Developer Guide</i>.</p>
|
|
*/
|
|
inline GetItemRequest& AddAttributesToGet(Aws::String&& value) { m_attributesToGetHasBeenSet = true; m_attributesToGet.push_back(std::move(value)); return *this; }
|
|
|
|
/**
|
|
* <p>This is a legacy parameter. Use <code>ProjectionExpression</code> instead.
|
|
* For more information, see <a
|
|
* href="https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/LegacyConditionalParameters.AttributesToGet.html">AttributesToGet</a>
|
|
* in the <i>Amazon DynamoDB Developer Guide</i>.</p>
|
|
*/
|
|
inline GetItemRequest& AddAttributesToGet(const char* value) { m_attributesToGetHasBeenSet = true; m_attributesToGet.push_back(value); return *this; }
|
|
|
|
|
|
/**
|
|
* <p>Determines the read consistency model: If set to <code>true</code>, then the
|
|
* operation uses strongly consistent reads; otherwise, the operation uses
|
|
* eventually consistent reads.</p>
|
|
*/
|
|
inline bool GetConsistentRead() const{ return m_consistentRead; }
|
|
|
|
/**
|
|
* <p>Determines the read consistency model: If set to <code>true</code>, then the
|
|
* operation uses strongly consistent reads; otherwise, the operation uses
|
|
* eventually consistent reads.</p>
|
|
*/
|
|
inline bool ConsistentReadHasBeenSet() const { return m_consistentReadHasBeenSet; }
|
|
|
|
/**
|
|
* <p>Determines the read consistency model: If set to <code>true</code>, then the
|
|
* operation uses strongly consistent reads; otherwise, the operation uses
|
|
* eventually consistent reads.</p>
|
|
*/
|
|
inline void SetConsistentRead(bool value) { m_consistentReadHasBeenSet = true; m_consistentRead = value; }
|
|
|
|
/**
|
|
* <p>Determines the read consistency model: If set to <code>true</code>, then the
|
|
* operation uses strongly consistent reads; otherwise, the operation uses
|
|
* eventually consistent reads.</p>
|
|
*/
|
|
inline GetItemRequest& WithConsistentRead(bool value) { SetConsistentRead(value); return *this;}
|
|
|
|
|
|
|
|
inline const ReturnConsumedCapacity& GetReturnConsumedCapacity() const{ return m_returnConsumedCapacity; }
|
|
|
|
|
|
inline bool ReturnConsumedCapacityHasBeenSet() const { return m_returnConsumedCapacityHasBeenSet; }
|
|
|
|
|
|
inline void SetReturnConsumedCapacity(const ReturnConsumedCapacity& value) { m_returnConsumedCapacityHasBeenSet = true; m_returnConsumedCapacity = value; }
|
|
|
|
|
|
inline void SetReturnConsumedCapacity(ReturnConsumedCapacity&& value) { m_returnConsumedCapacityHasBeenSet = true; m_returnConsumedCapacity = std::move(value); }
|
|
|
|
|
|
inline GetItemRequest& WithReturnConsumedCapacity(const ReturnConsumedCapacity& value) { SetReturnConsumedCapacity(value); return *this;}
|
|
|
|
|
|
inline GetItemRequest& WithReturnConsumedCapacity(ReturnConsumedCapacity&& value) { SetReturnConsumedCapacity(std::move(value)); return *this;}
|
|
|
|
|
|
/**
|
|
* <p>A string that identifies one or more attributes to retrieve from the table.
|
|
* These attributes can include scalars, sets, or elements of a JSON document. The
|
|
* attributes in the expression must be separated by commas.</p> <p>If no attribute
|
|
* names are specified, then all attributes are returned. If any of the requested
|
|
* attributes are not found, they do not appear in the result.</p> <p>For more
|
|
* information, see <a
|
|
* href="https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.AccessingItemAttributes.html">Specifying
|
|
* Item Attributes</a> in the <i>Amazon DynamoDB Developer Guide</i>.</p>
|
|
*/
|
|
inline const Aws::String& GetProjectionExpression() const{ return m_projectionExpression; }
|
|
|
|
/**
|
|
* <p>A string that identifies one or more attributes to retrieve from the table.
|
|
* These attributes can include scalars, sets, or elements of a JSON document. The
|
|
* attributes in the expression must be separated by commas.</p> <p>If no attribute
|
|
* names are specified, then all attributes are returned. If any of the requested
|
|
* attributes are not found, they do not appear in the result.</p> <p>For more
|
|
* information, see <a
|
|
* href="https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.AccessingItemAttributes.html">Specifying
|
|
* Item Attributes</a> in the <i>Amazon DynamoDB Developer Guide</i>.</p>
|
|
*/
|
|
inline bool ProjectionExpressionHasBeenSet() const { return m_projectionExpressionHasBeenSet; }
|
|
|
|
/**
|
|
* <p>A string that identifies one or more attributes to retrieve from the table.
|
|
* These attributes can include scalars, sets, or elements of a JSON document. The
|
|
* attributes in the expression must be separated by commas.</p> <p>If no attribute
|
|
* names are specified, then all attributes are returned. If any of the requested
|
|
* attributes are not found, they do not appear in the result.</p> <p>For more
|
|
* information, see <a
|
|
* href="https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.AccessingItemAttributes.html">Specifying
|
|
* Item Attributes</a> in the <i>Amazon DynamoDB Developer Guide</i>.</p>
|
|
*/
|
|
inline void SetProjectionExpression(const Aws::String& value) { m_projectionExpressionHasBeenSet = true; m_projectionExpression = value; }
|
|
|
|
/**
|
|
* <p>A string that identifies one or more attributes to retrieve from the table.
|
|
* These attributes can include scalars, sets, or elements of a JSON document. The
|
|
* attributes in the expression must be separated by commas.</p> <p>If no attribute
|
|
* names are specified, then all attributes are returned. If any of the requested
|
|
* attributes are not found, they do not appear in the result.</p> <p>For more
|
|
* information, see <a
|
|
* href="https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.AccessingItemAttributes.html">Specifying
|
|
* Item Attributes</a> in the <i>Amazon DynamoDB Developer Guide</i>.</p>
|
|
*/
|
|
inline void SetProjectionExpression(Aws::String&& value) { m_projectionExpressionHasBeenSet = true; m_projectionExpression = std::move(value); }
|
|
|
|
/**
|
|
* <p>A string that identifies one or more attributes to retrieve from the table.
|
|
* These attributes can include scalars, sets, or elements of a JSON document. The
|
|
* attributes in the expression must be separated by commas.</p> <p>If no attribute
|
|
* names are specified, then all attributes are returned. If any of the requested
|
|
* attributes are not found, they do not appear in the result.</p> <p>For more
|
|
* information, see <a
|
|
* href="https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.AccessingItemAttributes.html">Specifying
|
|
* Item Attributes</a> in the <i>Amazon DynamoDB Developer Guide</i>.</p>
|
|
*/
|
|
inline void SetProjectionExpression(const char* value) { m_projectionExpressionHasBeenSet = true; m_projectionExpression.assign(value); }
|
|
|
|
/**
|
|
* <p>A string that identifies one or more attributes to retrieve from the table.
|
|
* These attributes can include scalars, sets, or elements of a JSON document. The
|
|
* attributes in the expression must be separated by commas.</p> <p>If no attribute
|
|
* names are specified, then all attributes are returned. If any of the requested
|
|
* attributes are not found, they do not appear in the result.</p> <p>For more
|
|
* information, see <a
|
|
* href="https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.AccessingItemAttributes.html">Specifying
|
|
* Item Attributes</a> in the <i>Amazon DynamoDB Developer Guide</i>.</p>
|
|
*/
|
|
inline GetItemRequest& WithProjectionExpression(const Aws::String& value) { SetProjectionExpression(value); return *this;}
|
|
|
|
/**
|
|
* <p>A string that identifies one or more attributes to retrieve from the table.
|
|
* These attributes can include scalars, sets, or elements of a JSON document. The
|
|
* attributes in the expression must be separated by commas.</p> <p>If no attribute
|
|
* names are specified, then all attributes are returned. If any of the requested
|
|
* attributes are not found, they do not appear in the result.</p> <p>For more
|
|
* information, see <a
|
|
* href="https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.AccessingItemAttributes.html">Specifying
|
|
* Item Attributes</a> in the <i>Amazon DynamoDB Developer Guide</i>.</p>
|
|
*/
|
|
inline GetItemRequest& WithProjectionExpression(Aws::String&& value) { SetProjectionExpression(std::move(value)); return *this;}
|
|
|
|
/**
|
|
* <p>A string that identifies one or more attributes to retrieve from the table.
|
|
* These attributes can include scalars, sets, or elements of a JSON document. The
|
|
* attributes in the expression must be separated by commas.</p> <p>If no attribute
|
|
* names are specified, then all attributes are returned. If any of the requested
|
|
* attributes are not found, they do not appear in the result.</p> <p>For more
|
|
* information, see <a
|
|
* href="https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.AccessingItemAttributes.html">Specifying
|
|
* Item Attributes</a> in the <i>Amazon DynamoDB Developer Guide</i>.</p>
|
|
*/
|
|
inline GetItemRequest& WithProjectionExpression(const char* value) { SetProjectionExpression(value); return *this;}
|
|
|
|
|
|
/**
|
|
* <p>One or more substitution tokens for attribute names in an expression. The
|
|
* following are some use cases for using
|
|
* <code>ExpressionAttributeNames</code>:</p> <ul> <li> <p>To access an attribute
|
|
* whose name conflicts with a DynamoDB reserved word.</p> </li> <li> <p>To create
|
|
* a placeholder for repeating occurrences of an attribute name in an
|
|
* expression.</p> </li> <li> <p>To prevent special characters in an attribute name
|
|
* from being misinterpreted in an expression.</p> </li> </ul> <p>Use the <b>#</b>
|
|
* character in an expression to dereference an attribute name. For example,
|
|
* consider the following attribute name:</p> <ul> <li> <p> <code>Percentile</code>
|
|
* </p> </li> </ul> <p>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 <a
|
|
* href="https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ReservedWords.html">Reserved
|
|
* Words</a> in the <i>Amazon DynamoDB Developer Guide</i>). To work around this,
|
|
* you could specify the following for <code>ExpressionAttributeNames</code>:</p>
|
|
* <ul> <li> <p> <code>{"#P":"Percentile"}</code> </p> </li> </ul> <p>You could
|
|
* then use this substitution in an expression, as in this example:</p> <ul> <li>
|
|
* <p> <code>#P = :val</code> </p> </li> </ul> <p>Tokens that begin with the
|
|
* <b>:</b> character are <i>expression attribute values</i>, which are
|
|
* placeholders for the actual value at runtime.</p> <p>For more
|
|
* information on expression attribute names, see <a
|
|
* href="https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.AccessingItemAttributes.html">Specifying
|
|
* Item Attributes</a> in the <i>Amazon DynamoDB Developer Guide</i>.</p>
|
|
*/
|
|
inline const Aws::Map<Aws::String, Aws::String>& GetExpressionAttributeNames() const{ return m_expressionAttributeNames; }
|
|
|
|
/**
|
|
* <p>One or more substitution tokens for attribute names in an expression. The
|
|
* following are some use cases for using
|
|
* <code>ExpressionAttributeNames</code>:</p> <ul> <li> <p>To access an attribute
|
|
* whose name conflicts with a DynamoDB reserved word.</p> </li> <li> <p>To create
|
|
* a placeholder for repeating occurrences of an attribute name in an
|
|
* expression.</p> </li> <li> <p>To prevent special characters in an attribute name
|
|
* from being misinterpreted in an expression.</p> </li> </ul> <p>Use the <b>#</b>
|
|
* character in an expression to dereference an attribute name. For example,
|
|
* consider the following attribute name:</p> <ul> <li> <p> <code>Percentile</code>
|
|
* </p> </li> </ul> <p>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 <a
|
|
* href="https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ReservedWords.html">Reserved
|
|
* Words</a> in the <i>Amazon DynamoDB Developer Guide</i>). To work around this,
|
|
* you could specify the following for <code>ExpressionAttributeNames</code>:</p>
|
|
* <ul> <li> <p> <code>{"#P":"Percentile"}</code> </p> </li> </ul> <p>You could
|
|
* then use this substitution in an expression, as in this example:</p> <ul> <li>
|
|
* <p> <code>#P = :val</code> </p> </li> </ul> <p>Tokens that begin with the
|
|
* <b>:</b> character are <i>expression attribute values</i>, which are
|
|
* placeholders for the actual value at runtime.</p> <p>For more
|
|
* information on expression attribute names, see <a
|
|
* href="https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.AccessingItemAttributes.html">Specifying
|
|
* Item Attributes</a> in the <i>Amazon DynamoDB Developer Guide</i>.</p>
|
|
*/
|
|
inline bool ExpressionAttributeNamesHasBeenSet() const { return m_expressionAttributeNamesHasBeenSet; }
|
|
|
|
/**
|
|
* <p>One or more substitution tokens for attribute names in an expression. The
|
|
* following are some use cases for using
|
|
* <code>ExpressionAttributeNames</code>:</p> <ul> <li> <p>To access an attribute
|
|
* whose name conflicts with a DynamoDB reserved word.</p> </li> <li> <p>To create
|
|
* a placeholder for repeating occurrences of an attribute name in an
|
|
* expression.</p> </li> <li> <p>To prevent special characters in an attribute name
|
|
* from being misinterpreted in an expression.</p> </li> </ul> <p>Use the <b>#</b>
|
|
* character in an expression to dereference an attribute name. For example,
|
|
* consider the following attribute name:</p> <ul> <li> <p> <code>Percentile</code>
|
|
* </p> </li> </ul> <p>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 <a
|
|
* href="https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ReservedWords.html">Reserved
|
|
* Words</a> in the <i>Amazon DynamoDB Developer Guide</i>). To work around this,
|
|
* you could specify the following for <code>ExpressionAttributeNames</code>:</p>
|
|
* <ul> <li> <p> <code>{"#P":"Percentile"}</code> </p> </li> </ul> <p>You could
|
|
* then use this substitution in an expression, as in this example:</p> <ul> <li>
|
|
* <p> <code>#P = :val</code> </p> </li> </ul> <p>Tokens that begin with the
|
|
* <b>:</b> character are <i>expression attribute values</i>, which are
|
|
* placeholders for the actual value at runtime.</p> <p>For more
|
|
* information on expression attribute names, see <a
|
|
* href="https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.AccessingItemAttributes.html">Specifying
|
|
* Item Attributes</a> in the <i>Amazon DynamoDB Developer Guide</i>.</p>
|
|
*/
|
|
inline void SetExpressionAttributeNames(const Aws::Map<Aws::String, Aws::String>& value) { m_expressionAttributeNamesHasBeenSet = true; m_expressionAttributeNames = value; }
|
|
|
|
/**
|
|
* <p>One or more substitution tokens for attribute names in an expression. The
|
|
* following are some use cases for using
|
|
* <code>ExpressionAttributeNames</code>:</p> <ul> <li> <p>To access an attribute
|
|
* whose name conflicts with a DynamoDB reserved word.</p> </li> <li> <p>To create
|
|
* a placeholder for repeating occurrences of an attribute name in an
|
|
* expression.</p> </li> <li> <p>To prevent special characters in an attribute name
|
|
* from being misinterpreted in an expression.</p> </li> </ul> <p>Use the <b>#</b>
|
|
* character in an expression to dereference an attribute name. For example,
|
|
* consider the following attribute name:</p> <ul> <li> <p> <code>Percentile</code>
|
|
* </p> </li> </ul> <p>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 <a
|
|
* href="https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ReservedWords.html">Reserved
|
|
* Words</a> in the <i>Amazon DynamoDB Developer Guide</i>). To work around this,
|
|
* you could specify the following for <code>ExpressionAttributeNames</code>:</p>
|
|
* <ul> <li> <p> <code>{"#P":"Percentile"}</code> </p> </li> </ul> <p>You could
|
|
* then use this substitution in an expression, as in this example:</p> <ul> <li>
|
|
* <p> <code>#P = :val</code> </p> </li> </ul> <p>Tokens that begin with the
|
|
* <b>:</b> character are <i>expression attribute values</i>, which are
|
|
* placeholders for the actual value at runtime.</p> <p>For more
|
|
* information on expression attribute names, see <a
|
|
* href="https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.AccessingItemAttributes.html">Specifying
|
|
* Item Attributes</a> in the <i>Amazon DynamoDB Developer Guide</i>.</p>
|
|
*/
|
|
inline void SetExpressionAttributeNames(Aws::Map<Aws::String, Aws::String>&& value) { m_expressionAttributeNamesHasBeenSet = true; m_expressionAttributeNames = std::move(value); }
|
|
|
|
/**
|
|
* <p>One or more substitution tokens for attribute names in an expression. The
|
|
* following are some use cases for using
|
|
* <code>ExpressionAttributeNames</code>:</p> <ul> <li> <p>To access an attribute
|
|
* whose name conflicts with a DynamoDB reserved word.</p> </li> <li> <p>To create
|
|
* a placeholder for repeating occurrences of an attribute name in an
|
|
* expression.</p> </li> <li> <p>To prevent special characters in an attribute name
|
|
* from being misinterpreted in an expression.</p> </li> </ul> <p>Use the <b>#</b>
|
|
* character in an expression to dereference an attribute name. For example,
|
|
* consider the following attribute name:</p> <ul> <li> <p> <code>Percentile</code>
|
|
* </p> </li> </ul> <p>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 <a
|
|
* href="https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ReservedWords.html">Reserved
|
|
* Words</a> in the <i>Amazon DynamoDB Developer Guide</i>). To work around this,
|
|
* you could specify the following for <code>ExpressionAttributeNames</code>:</p>
|
|
* <ul> <li> <p> <code>{"#P":"Percentile"}</code> </p> </li> </ul> <p>You could
|
|
* then use this substitution in an expression, as in this example:</p> <ul> <li>
|
|
* <p> <code>#P = :val</code> </p> </li> </ul> <p>Tokens that begin with the
|
|
* <b>:</b> character are <i>expression attribute values</i>, which are
|
|
* placeholders for the actual value at runtime.</p> <p>For more
|
|
* information on expression attribute names, see <a
|
|
* href="https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.AccessingItemAttributes.html">Specifying
|
|
* Item Attributes</a> in the <i>Amazon DynamoDB Developer Guide</i>.</p>
|
|
*/
|
|
inline GetItemRequest& WithExpressionAttributeNames(const Aws::Map<Aws::String, Aws::String>& value) { SetExpressionAttributeNames(value); return *this;}
|
|
|
|
/**
|
|
* <p>One or more substitution tokens for attribute names in an expression. The
|
|
* following are some use cases for using
|
|
* <code>ExpressionAttributeNames</code>:</p> <ul> <li> <p>To access an attribute
|
|
* whose name conflicts with a DynamoDB reserved word.</p> </li> <li> <p>To create
|
|
* a placeholder for repeating occurrences of an attribute name in an
|
|
* expression.</p> </li> <li> <p>To prevent special characters in an attribute name
|
|
* from being misinterpreted in an expression.</p> </li> </ul> <p>Use the <b>#</b>
|
|
* character in an expression to dereference an attribute name. For example,
|
|
* consider the following attribute name:</p> <ul> <li> <p> <code>Percentile</code>
|
|
* </p> </li> </ul> <p>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 <a
|
|
* href="https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ReservedWords.html">Reserved
|
|
* Words</a> in the <i>Amazon DynamoDB Developer Guide</i>). To work around this,
|
|
* you could specify the following for <code>ExpressionAttributeNames</code>:</p>
|
|
* <ul> <li> <p> <code>{"#P":"Percentile"}</code> </p> </li> </ul> <p>You could
|
|
* then use this substitution in an expression, as in this example:</p> <ul> <li>
|
|
* <p> <code>#P = :val</code> </p> </li> </ul> <p>Tokens that begin with the
|
|
* <b>:</b> character are <i>expression attribute values</i>, which are
|
|
* placeholders for the actual value at runtime.</p> <p>For more
|
|
* information on expression attribute names, see <a
|
|
* href="https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.AccessingItemAttributes.html">Specifying
|
|
* Item Attributes</a> in the <i>Amazon DynamoDB Developer Guide</i>.</p>
|
|
*/
|
|
inline GetItemRequest& WithExpressionAttributeNames(Aws::Map<Aws::String, Aws::String>&& value) { SetExpressionAttributeNames(std::move(value)); return *this;}
|
|
|
|
/**
|
|
* <p>One or more substitution tokens for attribute names in an expression. The
|
|
* following are some use cases for using
|
|
* <code>ExpressionAttributeNames</code>:</p> <ul> <li> <p>To access an attribute
|
|
* whose name conflicts with a DynamoDB reserved word.</p> </li> <li> <p>To create
|
|
* a placeholder for repeating occurrences of an attribute name in an
|
|
* expression.</p> </li> <li> <p>To prevent special characters in an attribute name
|
|
* from being misinterpreted in an expression.</p> </li> </ul> <p>Use the <b>#</b>
|
|
* character in an expression to dereference an attribute name. For example,
|
|
* consider the following attribute name:</p> <ul> <li> <p> <code>Percentile</code>
|
|
* </p> </li> </ul> <p>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 <a
|
|
* href="https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ReservedWords.html">Reserved
|
|
* Words</a> in the <i>Amazon DynamoDB Developer Guide</i>). To work around this,
|
|
* you could specify the following for <code>ExpressionAttributeNames</code>:</p>
|
|
* <ul> <li> <p> <code>{"#P":"Percentile"}</code> </p> </li> </ul> <p>You could
|
|
* then use this substitution in an expression, as in this example:</p> <ul> <li>
|
|
* <p> <code>#P = :val</code> </p> </li> </ul> <p>Tokens that begin with the
|
|
* <b>:</b> character are <i>expression attribute values</i>, which are
|
|
* placeholders for the actual value at runtime.</p> <p>For more
|
|
* information on expression attribute names, see <a
|
|
* href="https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.AccessingItemAttributes.html">Specifying
|
|
* Item Attributes</a> in the <i>Amazon DynamoDB Developer Guide</i>.</p>
|
|
*/
|
|
inline GetItemRequest& AddExpressionAttributeNames(const Aws::String& key, const Aws::String& value) { m_expressionAttributeNamesHasBeenSet = true; m_expressionAttributeNames.emplace(key, value); return *this; }
|
|
|
|
/**
|
|
* <p>One or more substitution tokens for attribute names in an expression. The
|
|
* following are some use cases for using
|
|
* <code>ExpressionAttributeNames</code>:</p> <ul> <li> <p>To access an attribute
|
|
* whose name conflicts with a DynamoDB reserved word.</p> </li> <li> <p>To create
|
|
* a placeholder for repeating occurrences of an attribute name in an
|
|
* expression.</p> </li> <li> <p>To prevent special characters in an attribute name
|
|
* from being misinterpreted in an expression.</p> </li> </ul> <p>Use the <b>#</b>
|
|
* character in an expression to dereference an attribute name. For example,
|
|
* consider the following attribute name:</p> <ul> <li> <p> <code>Percentile</code>
|
|
* </p> </li> </ul> <p>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 <a
|
|
* href="https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ReservedWords.html">Reserved
|
|
* Words</a> in the <i>Amazon DynamoDB Developer Guide</i>). To work around this,
|
|
* you could specify the following for <code>ExpressionAttributeNames</code>:</p>
|
|
* <ul> <li> <p> <code>{"#P":"Percentile"}</code> </p> </li> </ul> <p>You could
|
|
* then use this substitution in an expression, as in this example:</p> <ul> <li>
|
|
* <p> <code>#P = :val</code> </p> </li> </ul> <p>Tokens that begin with the
|
|
* <b>:</b> character are <i>expression attribute values</i>, which are
|
|
* placeholders for the actual value at runtime.</p> <p>For more
|
|
* information on expression attribute names, see <a
|
|
* href="https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.AccessingItemAttributes.html">Specifying
|
|
* Item Attributes</a> in the <i>Amazon DynamoDB Developer Guide</i>.</p>
|
|
*/
|
|
inline GetItemRequest& AddExpressionAttributeNames(Aws::String&& key, const Aws::String& value) { m_expressionAttributeNamesHasBeenSet = true; m_expressionAttributeNames.emplace(std::move(key), value); return *this; }
|
|
|
|
/**
|
|
* <p>One or more substitution tokens for attribute names in an expression. The
|
|
* following are some use cases for using
|
|
* <code>ExpressionAttributeNames</code>:</p> <ul> <li> <p>To access an attribute
|
|
* whose name conflicts with a DynamoDB reserved word.</p> </li> <li> <p>To create
|
|
* a placeholder for repeating occurrences of an attribute name in an
|
|
* expression.</p> </li> <li> <p>To prevent special characters in an attribute name
|
|
* from being misinterpreted in an expression.</p> </li> </ul> <p>Use the <b>#</b>
|
|
* character in an expression to dereference an attribute name. For example,
|
|
* consider the following attribute name:</p> <ul> <li> <p> <code>Percentile</code>
|
|
* </p> </li> </ul> <p>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 <a
|
|
* href="https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ReservedWords.html">Reserved
|
|
* Words</a> in the <i>Amazon DynamoDB Developer Guide</i>). To work around this,
|
|
* you could specify the following for <code>ExpressionAttributeNames</code>:</p>
|
|
* <ul> <li> <p> <code>{"#P":"Percentile"}</code> </p> </li> </ul> <p>You could
|
|
* then use this substitution in an expression, as in this example:</p> <ul> <li>
|
|
* <p> <code>#P = :val</code> </p> </li> </ul> <p>Tokens that begin with the
|
|
* <b>:</b> character are <i>expression attribute values</i>, which are
|
|
* placeholders for the actual value at runtime.</p> <p>For more
|
|
* information on expression attribute names, see <a
|
|
* href="https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.AccessingItemAttributes.html">Specifying
|
|
* Item Attributes</a> in the <i>Amazon DynamoDB Developer Guide</i>.</p>
|
|
*/
|
|
inline GetItemRequest& AddExpressionAttributeNames(const Aws::String& key, Aws::String&& value) { m_expressionAttributeNamesHasBeenSet = true; m_expressionAttributeNames.emplace(key, std::move(value)); return *this; }
|
|
|
|
/**
|
|
* <p>One or more substitution tokens for attribute names in an expression. The
|
|
* following are some use cases for using
|
|
* <code>ExpressionAttributeNames</code>:</p> <ul> <li> <p>To access an attribute
|
|
* whose name conflicts with a DynamoDB reserved word.</p> </li> <li> <p>To create
|
|
* a placeholder for repeating occurrences of an attribute name in an
|
|
* expression.</p> </li> <li> <p>To prevent special characters in an attribute name
|
|
* from being misinterpreted in an expression.</p> </li> </ul> <p>Use the <b>#</b>
|
|
* character in an expression to dereference an attribute name. For example,
|
|
* consider the following attribute name:</p> <ul> <li> <p> <code>Percentile</code>
|
|
* </p> </li> </ul> <p>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 <a
|
|
* href="https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ReservedWords.html">Reserved
|
|
* Words</a> in the <i>Amazon DynamoDB Developer Guide</i>). To work around this,
|
|
* you could specify the following for <code>ExpressionAttributeNames</code>:</p>
|
|
* <ul> <li> <p> <code>{"#P":"Percentile"}</code> </p> </li> </ul> <p>You could
|
|
* then use this substitution in an expression, as in this example:</p> <ul> <li>
|
|
* <p> <code>#P = :val</code> </p> </li> </ul> <p>Tokens that begin with the
|
|
* <b>:</b> character are <i>expression attribute values</i>, which are
|
|
* placeholders for the actual value at runtime.</p> <p>For more
|
|
* information on expression attribute names, see <a
|
|
* href="https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.AccessingItemAttributes.html">Specifying
|
|
* Item Attributes</a> in the <i>Amazon DynamoDB Developer Guide</i>.</p>
|
|
*/
|
|
inline GetItemRequest& AddExpressionAttributeNames(Aws::String&& key, Aws::String&& value) { m_expressionAttributeNamesHasBeenSet = true; m_expressionAttributeNames.emplace(std::move(key), std::move(value)); return *this; }
|
|
|
|
/**
|
|
* <p>One or more substitution tokens for attribute names in an expression. The
|
|
* following are some use cases for using
|
|
* <code>ExpressionAttributeNames</code>:</p> <ul> <li> <p>To access an attribute
|
|
* whose name conflicts with a DynamoDB reserved word.</p> </li> <li> <p>To create
|
|
* a placeholder for repeating occurrences of an attribute name in an
|
|
* expression.</p> </li> <li> <p>To prevent special characters in an attribute name
|
|
* from being misinterpreted in an expression.</p> </li> </ul> <p>Use the <b>#</b>
|
|
* character in an expression to dereference an attribute name. For example,
|
|
* consider the following attribute name:</p> <ul> <li> <p> <code>Percentile</code>
|
|
* </p> </li> </ul> <p>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 <a
|
|
* href="https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ReservedWords.html">Reserved
|
|
* Words</a> in the <i>Amazon DynamoDB Developer Guide</i>). To work around this,
|
|
* you could specify the following for <code>ExpressionAttributeNames</code>:</p>
|
|
* <ul> <li> <p> <code>{"#P":"Percentile"}</code> </p> </li> </ul> <p>You could
|
|
* then use this substitution in an expression, as in this example:</p> <ul> <li>
|
|
* <p> <code>#P = :val</code> </p> </li> </ul> <p>Tokens that begin with the
|
|
* <b>:</b> character are <i>expression attribute values</i>, which are
|
|
* placeholders for the actual value at runtime.</p> <p>For more
|
|
* information on expression attribute names, see <a
|
|
* href="https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.AccessingItemAttributes.html">Specifying
|
|
* Item Attributes</a> in the <i>Amazon DynamoDB Developer Guide</i>.</p>
|
|
*/
|
|
inline GetItemRequest& AddExpressionAttributeNames(const char* key, Aws::String&& value) { m_expressionAttributeNamesHasBeenSet = true; m_expressionAttributeNames.emplace(key, std::move(value)); return *this; }
|
|
|
|
/**
|
|
* <p>One or more substitution tokens for attribute names in an expression. The
|
|
* following are some use cases for using
|
|
* <code>ExpressionAttributeNames</code>:</p> <ul> <li> <p>To access an attribute
|
|
* whose name conflicts with a DynamoDB reserved word.</p> </li> <li> <p>To create
|
|
* a placeholder for repeating occurrences of an attribute name in an
|
|
* expression.</p> </li> <li> <p>To prevent special characters in an attribute name
|
|
* from being misinterpreted in an expression.</p> </li> </ul> <p>Use the <b>#</b>
|
|
* character in an expression to dereference an attribute name. For example,
|
|
* consider the following attribute name:</p> <ul> <li> <p> <code>Percentile</code>
|
|
* </p> </li> </ul> <p>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 <a
|
|
* href="https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ReservedWords.html">Reserved
|
|
* Words</a> in the <i>Amazon DynamoDB Developer Guide</i>). To work around this,
|
|
* you could specify the following for <code>ExpressionAttributeNames</code>:</p>
|
|
* <ul> <li> <p> <code>{"#P":"Percentile"}</code> </p> </li> </ul> <p>You could
|
|
* then use this substitution in an expression, as in this example:</p> <ul> <li>
|
|
* <p> <code>#P = :val</code> </p> </li> </ul> <p>Tokens that begin with the
|
|
* <b>:</b> character are <i>expression attribute values</i>, which are
|
|
* placeholders for the actual value at runtime.</p> <p>For more
|
|
* information on expression attribute names, see <a
|
|
* href="https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.AccessingItemAttributes.html">Specifying
|
|
* Item Attributes</a> in the <i>Amazon DynamoDB Developer Guide</i>.</p>
|
|
*/
|
|
inline GetItemRequest& AddExpressionAttributeNames(Aws::String&& key, const char* value) { m_expressionAttributeNamesHasBeenSet = true; m_expressionAttributeNames.emplace(std::move(key), value); return *this; }
|
|
|
|
/**
|
|
* <p>One or more substitution tokens for attribute names in an expression. The
|
|
* following are some use cases for using
|
|
* <code>ExpressionAttributeNames</code>:</p> <ul> <li> <p>To access an attribute
|
|
* whose name conflicts with a DynamoDB reserved word.</p> </li> <li> <p>To create
|
|
* a placeholder for repeating occurrences of an attribute name in an
|
|
* expression.</p> </li> <li> <p>To prevent special characters in an attribute name
|
|
* from being misinterpreted in an expression.</p> </li> </ul> <p>Use the <b>#</b>
|
|
* character in an expression to dereference an attribute name. For example,
|
|
* consider the following attribute name:</p> <ul> <li> <p> <code>Percentile</code>
|
|
* </p> </li> </ul> <p>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 <a
|
|
* href="https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ReservedWords.html">Reserved
|
|
* Words</a> in the <i>Amazon DynamoDB Developer Guide</i>). To work around this,
|
|
* you could specify the following for <code>ExpressionAttributeNames</code>:</p>
|
|
* <ul> <li> <p> <code>{"#P":"Percentile"}</code> </p> </li> </ul> <p>You could
|
|
* then use this substitution in an expression, as in this example:</p> <ul> <li>
|
|
* <p> <code>#P = :val</code> </p> </li> </ul> <p>Tokens that begin with the
|
|
* <b>:</b> character are <i>expression attribute values</i>, which are
|
|
* placeholders for the actual value at runtime.</p> <p>For more
|
|
* information on expression attribute names, see <a
|
|
* href="https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.AccessingItemAttributes.html">Specifying
|
|
* Item Attributes</a> in the <i>Amazon DynamoDB Developer Guide</i>.</p>
|
|
*/
|
|
inline GetItemRequest& AddExpressionAttributeNames(const char* key, const char* value) { m_expressionAttributeNamesHasBeenSet = true; m_expressionAttributeNames.emplace(key, value); return *this; }
|
|
|
|
private:
|
|
|
|
Aws::String m_tableName;
|
|
bool m_tableNameHasBeenSet;
|
|
|
|
Aws::Map<Aws::String, AttributeValue> m_key;
|
|
bool m_keyHasBeenSet;
|
|
|
|
Aws::Vector<Aws::String> m_attributesToGet;
|
|
bool m_attributesToGetHasBeenSet;
|
|
|
|
bool m_consistentRead;
|
|
bool m_consistentReadHasBeenSet;
|
|
|
|
ReturnConsumedCapacity m_returnConsumedCapacity;
|
|
bool m_returnConsumedCapacityHasBeenSet;
|
|
|
|
Aws::String m_projectionExpression;
|
|
bool m_projectionExpressionHasBeenSet;
|
|
|
|
Aws::Map<Aws::String, Aws::String> m_expressionAttributeNames;
|
|
bool m_expressionAttributeNamesHasBeenSet;
|
|
};
|
|
|
|
} // namespace Model
|
|
} // namespace DynamoDB
|
|
} // namespace Aws
|