The GetItem operation returns a set of attributes for the item
with the given primary key. If there is no matching item,
GetItem does not return any data.

GetItem provides an eventually consistent read by default. If
your application requires a strongly consistent read, set
ConsistentRead to true . Although a strongly
consistent read might take more time than an eventually consistent
read, it always returns the last updated value.

A map of attribute names to AttributeValue objects,
representing the primary key of the item to retrieve.

For the
primary key, you must provide all of the attributes. For example, with
a hash type primary key, you only need to provide the hash attribute.
For a hash-and-range type primary key, you must provide both the hash
attribute and the range attribute.

There is a newer parameter available. Use
ProjectionExpression instead. Note that if you use
AttributesToGet and ProjectionExpression at the same
time, DynamoDB will return a ValidationException exception.

This parameter allows you to retrieve attributes of type List or
Map; however, it cannot retrieve individual elements within a List or
a Map.</important>

The names of one or more attributes to retrieve.
If no attribute names are provided, then all attributes will be
returned. If any of the requested attributes are not found, they will
not appear in the result.

Note that AttributesToGet has no
effect on provisioned throughput consumption. DynamoDB determines
capacity units consumed based on item size, not on the amount of data
that is returned to an application.

A value that if set to TOTAL, the response includes
ConsumedCapacity data for tables and indexes. If set to
INDEXES, the response includes ConsumedCapacity
for indexes. If set to NONE (the default),
ConsumedCapacity is not included in the response.

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.

If no attribute names are specified, then all attributes
will be returned. If any of the requested attributes are not found,
they will not appear in the result.

For more information, go to 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
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,
go to 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

<note>

Tokens that begin
with the : character are expression attribute values,
which are placeholders for the actual value at runtime.</note>

For
more information on expression attribute names, go to Accessing
Item Attributes in the Amazon DynamoDB Developer Guide.

Constructs a new GetItemRequest object.
Callers should use the setter or fluent setter (with...) methods to
initialize any additional object members.

Parameters:

tableName The name of the table containing the requested item.

key A map of attribute names to AttributeValue objects,
representing the primary key of the item to retrieve.

For the
primary key, you must provide all of the attributes. For example, with
a hash type primary key, you only need to provide the hash attribute.
For a hash-and-range type primary key, you must provide both the hash
attribute and the range attribute.

Constructs a new GetItemRequest object.
Callers should use the setter or fluent setter (with...) methods to
initialize any additional object members.

Parameters:

tableName The name of the table containing the requested item.

key A map of attribute names to AttributeValue objects,
representing the primary key of the item to retrieve.

For the
primary key, you must provide all of the attributes. For example, with
a hash type primary key, you only need to provide the hash attribute.
For a hash-and-range type primary key, you must provide both the hash
attribute and the range attribute.

consistentRead A value that if set to true, then
the operation uses strongly consistent reads; otherwise, eventually
consistent reads are used.

A map of attribute names to AttributeValue objects,
representing the primary key of the item to retrieve.

For the
primary key, you must provide all of the attributes. For example, with
a hash type primary key, you only need to provide the hash attribute.
For a hash-and-range type primary key, you must provide both the hash
attribute and the range attribute.

Returns:

A map of attribute names to AttributeValue objects,
representing the primary key of the item to retrieve.

For the
primary key, you must provide all of the attributes. For example, with
a hash type primary key, you only need to provide the hash attribute.
For a hash-and-range type primary key, you must provide both the hash
attribute and the range attribute.

A map of attribute names to AttributeValue objects,
representing the primary key of the item to retrieve.

For the
primary key, you must provide all of the attributes. For example, with
a hash type primary key, you only need to provide the hash attribute.
For a hash-and-range type primary key, you must provide both the hash
attribute and the range attribute.

Parameters:

key A map of attribute names to AttributeValue objects,
representing the primary key of the item to retrieve.

For the
primary key, you must provide all of the attributes. For example, with
a hash type primary key, you only need to provide the hash attribute.
For a hash-and-range type primary key, you must provide both the hash
attribute and the range attribute.

A map of attribute names to AttributeValue objects,
representing the primary key of the item to retrieve.

For the
primary key, you must provide all of the attributes. For example, with
a hash type primary key, you only need to provide the hash attribute.
For a hash-and-range type primary key, you must provide both the hash
attribute and the range attribute.

Returns a reference to this object so that method calls can be chained together.

Parameters:

key A map of attribute names to AttributeValue objects,
representing the primary key of the item to retrieve.

For the
primary key, you must provide all of the attributes. For example, with
a hash type primary key, you only need to provide the hash attribute.
For a hash-and-range type primary key, you must provide both the hash
attribute and the range attribute.

Returns:

A reference to this updated object so that method calls can be chained
together.

A map of attribute names to AttributeValue objects,
representing the primary key of the item to retrieve.

For the
primary key, you must provide all of the attributes. For example, with
a hash type primary key, you only need to provide the hash attribute.
For a hash-and-range type primary key, you must provide both the hash
attribute and the range attribute.

This method accepts the hashKey, rangeKey of Key as
java.util.Map.Entry<String, AttributeValue> objects.

A map of attribute names to AttributeValue objects,
representing the primary key of the item to retrieve.

For the
primary key, you must provide all of the attributes. For example, with
a hash type primary key, you only need to provide the hash attribute.
For a hash-and-range type primary key, you must provide both the hash
attribute and the range attribute.

This method accepts the hashKey, rangeKey of Key as
java.util.Map.Entry<String, AttributeValue> objects.

Returns a reference to this object so that method calls can be chained together.

A map of attribute names to AttributeValue objects,
representing the primary key of the item to retrieve.

For the
primary key, you must provide all of the attributes. For example, with
a hash type primary key, you only need to provide the hash attribute.
For a hash-and-range type primary key, you must provide both the hash
attribute and the range attribute.

The method adds a new key-value pair into Key parameter, and returns a
reference to this object so that method calls can be chained together.

There is a newer parameter available. Use
ProjectionExpression instead. Note that if you use
AttributesToGet and ProjectionExpression at the same
time, DynamoDB will return a ValidationException exception.

This parameter allows you to retrieve attributes of type List or
Map; however, it cannot retrieve individual elements within a List or
a Map.</important>

The names of one or more attributes to retrieve.
If no attribute names are provided, then all attributes will be
returned. If any of the requested attributes are not found, they will
not appear in the result.

Note that AttributesToGet has no
effect on provisioned throughput consumption. DynamoDB determines
capacity units consumed based on item size, not on the amount of data
that is returned to an application.

Constraints:Length: 1 -

Returns:

<important>

There is a newer parameter available. Use
ProjectionExpression instead. Note that if you use
AttributesToGet and ProjectionExpression at the same
time, DynamoDB will return a ValidationException exception.

This parameter allows you to retrieve attributes of type List or
Map; however, it cannot retrieve individual elements within a List or
a Map.</important>

The names of one or more attributes to retrieve.
If no attribute names are provided, then all attributes will be
returned. If any of the requested attributes are not found, they will
not appear in the result.

Note that AttributesToGet has no
effect on provisioned throughput consumption. DynamoDB determines
capacity units consumed based on item size, not on the amount of data
that is returned to an application.

There is a newer parameter available. Use
ProjectionExpression instead. Note that if you use
AttributesToGet and ProjectionExpression at the same
time, DynamoDB will return a ValidationException exception.

This parameter allows you to retrieve attributes of type List or
Map; however, it cannot retrieve individual elements within a List or
a Map.</important>

The names of one or more attributes to retrieve.
If no attribute names are provided, then all attributes will be
returned. If any of the requested attributes are not found, they will
not appear in the result.

Note that AttributesToGet has no
effect on provisioned throughput consumption. DynamoDB determines
capacity units consumed based on item size, not on the amount of data
that is returned to an application.

Constraints:Length: 1 -

Parameters:

attributesToGet <important>

There is a newer parameter available. Use
ProjectionExpression instead. Note that if you use
AttributesToGet and ProjectionExpression at the same
time, DynamoDB will return a ValidationException exception.

This parameter allows you to retrieve attributes of type List or
Map; however, it cannot retrieve individual elements within a List or
a Map.</important>

The names of one or more attributes to retrieve.
If no attribute names are provided, then all attributes will be
returned. If any of the requested attributes are not found, they will
not appear in the result.

Note that AttributesToGet has no
effect on provisioned throughput consumption. DynamoDB determines
capacity units consumed based on item size, not on the amount of data
that is returned to an application.

There is a newer parameter available. Use
ProjectionExpression instead. Note that if you use
AttributesToGet and ProjectionExpression at the same
time, DynamoDB will return a ValidationException exception.

This parameter allows you to retrieve attributes of type List or
Map; however, it cannot retrieve individual elements within a List or
a Map.</important>

The names of one or more attributes to retrieve.
If no attribute names are provided, then all attributes will be
returned. If any of the requested attributes are not found, they will
not appear in the result.

Note that AttributesToGet has no
effect on provisioned throughput consumption. DynamoDB determines
capacity units consumed based on item size, not on the amount of data
that is returned to an application.

Returns a reference to this object so that method calls can be chained together.

Constraints:Length: 1 -

Parameters:

attributesToGet <important>

There is a newer parameter available. Use
ProjectionExpression instead. Note that if you use
AttributesToGet and ProjectionExpression at the same
time, DynamoDB will return a ValidationException exception.

This parameter allows you to retrieve attributes of type List or
Map; however, it cannot retrieve individual elements within a List or
a Map.</important>

The names of one or more attributes to retrieve.
If no attribute names are provided, then all attributes will be
returned. If any of the requested attributes are not found, they will
not appear in the result.

Note that AttributesToGet has no
effect on provisioned throughput consumption. DynamoDB determines
capacity units consumed based on item size, not on the amount of data
that is returned to an application.

Returns:

A reference to this updated object so that method calls can be chained
together.

There is a newer parameter available. Use
ProjectionExpression instead. Note that if you use
AttributesToGet and ProjectionExpression at the same
time, DynamoDB will return a ValidationException exception.

This parameter allows you to retrieve attributes of type List or
Map; however, it cannot retrieve individual elements within a List or
a Map.</important>

The names of one or more attributes to retrieve.
If no attribute names are provided, then all attributes will be
returned. If any of the requested attributes are not found, they will
not appear in the result.

Note that AttributesToGet has no
effect on provisioned throughput consumption. DynamoDB determines
capacity units consumed based on item size, not on the amount of data
that is returned to an application.

Returns a reference to this object so that method calls can be chained together.

Constraints:Length: 1 -

Parameters:

attributesToGet <important>

There is a newer parameter available. Use
ProjectionExpression instead. Note that if you use
AttributesToGet and ProjectionExpression at the same
time, DynamoDB will return a ValidationException exception.

This parameter allows you to retrieve attributes of type List or
Map; however, it cannot retrieve individual elements within a List or
a Map.</important>

The names of one or more attributes to retrieve.
If no attribute names are provided, then all attributes will be
returned. If any of the requested attributes are not found, they will
not appear in the result.

Note that AttributesToGet has no
effect on provisioned throughput consumption. DynamoDB determines
capacity units consumed based on item size, not on the amount of data
that is returned to an application.

Returns:

A reference to this updated object so that method calls can be chained
together.

A value that if set to TOTAL, the response includes
ConsumedCapacity data for tables and indexes. If set to
INDEXES, the response includes ConsumedCapacity
for indexes. If set to NONE (the default),
ConsumedCapacity is not included in the response.

Constraints:Allowed Values: INDEXES, TOTAL, NONE

Returns:

A value that if set to TOTAL, the response includes
ConsumedCapacity data for tables and indexes. If set to
INDEXES, the response includes ConsumedCapacity
for indexes. If set to NONE (the default),
ConsumedCapacity is not included in the response.

A value that if set to TOTAL, the response includes
ConsumedCapacity data for tables and indexes. If set to
INDEXES, the response includes ConsumedCapacity
for indexes. If set to NONE (the default),
ConsumedCapacity is not included in the response.

Constraints:Allowed Values: INDEXES, TOTAL, NONE

Parameters:

returnConsumedCapacity A value that if set to TOTAL, the response includes
ConsumedCapacity data for tables and indexes. If set to
INDEXES, the response includes ConsumedCapacity
for indexes. If set to NONE (the default),
ConsumedCapacity is not included in the response.

A value that if set to TOTAL, the response includes
ConsumedCapacity data for tables and indexes. If set to
INDEXES, the response includes ConsumedCapacity
for indexes. If set to NONE (the default),
ConsumedCapacity is not included in the response.

Returns a reference to this object so that method calls can be chained together.

Constraints:Allowed Values: INDEXES, TOTAL, NONE

Parameters:

returnConsumedCapacity A value that if set to TOTAL, the response includes
ConsumedCapacity data for tables and indexes. If set to
INDEXES, the response includes ConsumedCapacity
for indexes. If set to NONE (the default),
ConsumedCapacity is not included in the response.

Returns:

A reference to this updated object so that method calls can be chained
together.

A value that if set to TOTAL, the response includes
ConsumedCapacity data for tables and indexes. If set to
INDEXES, the response includes ConsumedCapacity
for indexes. If set to NONE (the default),
ConsumedCapacity is not included in the response.

Constraints:Allowed Values: INDEXES, TOTAL, NONE

Parameters:

returnConsumedCapacity A value that if set to TOTAL, the response includes
ConsumedCapacity data for tables and indexes. If set to
INDEXES, the response includes ConsumedCapacity
for indexes. If set to NONE (the default),
ConsumedCapacity is not included in the response.

A value that if set to TOTAL, the response includes
ConsumedCapacity data for tables and indexes. If set to
INDEXES, the response includes ConsumedCapacity
for indexes. If set to NONE (the default),
ConsumedCapacity is not included in the response.

Returns a reference to this object so that method calls can be chained together.

Constraints:Allowed Values: INDEXES, TOTAL, NONE

Parameters:

returnConsumedCapacity A value that if set to TOTAL, the response includes
ConsumedCapacity data for tables and indexes. If set to
INDEXES, the response includes ConsumedCapacity
for indexes. If set to NONE (the default),
ConsumedCapacity is not included in the response.

Returns:

A reference to this updated object so that method calls can be chained
together.

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.

If no attribute names are specified, then all attributes
will be returned. If any of the requested attributes are not found,
they will not appear in the result.

For more information, go to Accessing
Item Attributes in the Amazon DynamoDB Developer Guide.

Returns:

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.

If no attribute names are specified, then all attributes
will be returned. If any of the requested attributes are not found,
they will not appear in the result.

For more information, go to Accessing
Item Attributes in the Amazon DynamoDB Developer Guide.

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.

If no attribute names are specified, then all attributes
will be returned. If any of the requested attributes are not found,
they will not appear in the result.

For more information, go to Accessing
Item Attributes in the Amazon DynamoDB Developer Guide.

Parameters:

projectionExpression 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.

If no attribute names are specified, then all attributes
will be returned. If any of the requested attributes are not found,
they will not appear in the result.

For more information, go to Accessing
Item Attributes in the Amazon DynamoDB Developer Guide.

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.

If no attribute names are specified, then all attributes
will be returned. If any of the requested attributes are not found,
they will not appear in the result.

For more information, go to Accessing
Item Attributes in the Amazon DynamoDB Developer Guide.

Returns a reference to this object so that method calls can be chained together.

Parameters:

projectionExpression 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.

If no attribute names are specified, then all attributes
will be returned. If any of the requested attributes are not found,
they will not appear in the result.

For more information, go to Accessing
Item Attributes in the Amazon DynamoDB Developer Guide.

Returns:

A reference to this updated object so that method calls can be chained
together.

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,
go to 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

<note>

Tokens that begin
with the : character are expression attribute values,
which are placeholders for the actual value at runtime.</note>

For
more information on expression attribute names, go to Accessing
Item Attributes in the Amazon DynamoDB Developer Guide.

Returns:

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,
go to 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

<note>

Tokens that begin
with the : character are expression attribute values,
which are placeholders for the actual value at runtime.</note>

For
more information on expression attribute names, go to 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
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,
go to 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

<note>

Tokens that begin
with the : character are expression attribute values,
which are placeholders for the actual value at runtime.</note>

For
more information on expression attribute names, go to Accessing
Item Attributes in the Amazon DynamoDB Developer Guide.

Parameters:

expressionAttributeNames 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,
go to 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

<note>

Tokens that begin
with the : character are expression attribute values,
which are placeholders for the actual value at runtime.</note>

For
more information on expression attribute names, go to 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
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,
go to 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

<note>

Tokens that begin
with the : character are expression attribute values,
which are placeholders for the actual value at runtime.</note>

For
more information on expression attribute names, go to Accessing
Item Attributes in the Amazon DynamoDB Developer Guide.

Returns a reference to this object so that method calls can be chained together.

Parameters:

expressionAttributeNames 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,
go to 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

<note>

Tokens that begin
with the : character are expression attribute values,
which are placeholders for the actual value at runtime.</note>

For
more information on expression attribute names, go to Accessing
Item Attributes in the Amazon DynamoDB Developer Guide.

Returns:

A reference to this updated object so that method calls can be chained
together.

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,
go to 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

<note>

Tokens that begin
with the : character are expression attribute values,
which are placeholders for the actual value at runtime.</note>

For
more information on expression attribute names, go to 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.

Parameters:

key The key of the entry to be added into ExpressionAttributeNames.

value The corresponding value of the entry to be added into ExpressionAttributeNames.