# AttributesToGet (herdado)
<a name="LegacyConditionalParameters.AttributesToGet"></a>

**nota**  
Sugerimos que você use os novos parâmetros de expressão, em vez desses parâmetros herdados. Para obter mais informações, consulte [Usar expressões no DynamoDB](Expressions.md). Para obter informações específicas sobre o novo parâmetro que substitui este, [Use *ProjectionExpression* em vez disso](#ProjectionExpression.instead). 

O parâmetro condicional herdado `AttributesToGet` é um conjunto de um ou mais atributos a serem recuperados do DynamoDB. Se os nomes de atributo não forem fornecidos, todos os atributos serão retornados. Se qualquer um dos atributos solicitados não for encontrado, ele não aparecerá no resultado.

`AttributesToGet` permite que você recupere atributos do tipo List ou Map; no entanto, ele não pode recuperar elementos individuais em uma lista ou um mapa.

Observe que `AttributesToGet` não afeta o consumo de throughput provisionado. O DynamoDB determina as unidades de capacidade consumidas com base no tamanho do item, e não na quantidade de dados que são retornados para um aplicativo.

## Use *ProjectionExpression* em vez disso: exemplo
<a name="ProjectionExpression.instead"></a>

Suponha que você quisesse recuperar um item da tabela *Music*, mas desejasse retornar somente alguns dos atributos. Você poderia usar uma solicitação `GetItem` com um parâmetro `AttributesToGet`, como neste exemplo da 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"}
    }'
```

Você pode usar `ProjectionExpression` em vez disso:

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