# AttributesToGet（遗留）
<a name="LegacyConditionalParameters.AttributesToGet"></a>

**注意**  
我们建议您尽可能使用新的表达式参数，而不是这些旧式参数。有关更多信息，请参阅 [在 DynamoDB 中使用表达式](Expressions.md)。有关取代此参数的新参数的具体信息，请参阅[改用 *ProjectionExpression*](#ProjectionExpression.instead)。

遗留条件参数 `AttributesToGet` 是从 DynamoDB 检索的一个或多个属性的数组。如果未提供属性名称，则返回所有属性。如果找不到任何请求的属性，则不会出现在结果中。

`AttributesToGet` 支持检索 List 或 Map 类型的属性；但无法检索 List 或 Map 中的单个元素。

请注意，`AttributesToGet` 对预调配吞吐量消耗没有影响。DynamoDB 将依据项目大小确定消耗的容量单位，而不是依据返回应用程序的数据量。

## 改用 *ProjectionExpression* – 示例
<a name="ProjectionExpression.instead"></a>

假设要从 *Music* 表检索一个项目，但只希望返回部分属性。可以使用 `GetItem` 请求和 `AttributesToGet` 参数，如这个 AWS CLI 示例：

```
aws dynamodb get-item \
    --table-name Music \
    --attributes-to-get '["Artist", "Genre"]' \
    --key '{
        "Artist": {"S":"No One You Know"},
        "SongTitle": {"S":"Call Me Today"}
    }'
```

您可以改用 `ProjectionExpression`：

```
aws dynamodb get-item \
    --table-name Music \
    --projection-expression "Artist, Genre" \
    --key '{
        "Artist": {"S":"No One You Know"},
        "SongTitle": {"S":"Call Me Today"}
    }'
```