Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# AttributesToGet (héritage)
<a name="LegacyConditionalParameters.AttributesToGet"></a>

**Note**  
Dans la mesure du possible, nous vous recommandons d’utiliser les nouveaux paramètres d’expression plutôt que ces paramètres hérités. Pour de plus amples informations, veuillez consulter [Utilisation d’expressions dans DynamoDB](Expressions.md). Pour obtenir des informations précises sur le nouveau paramètre qui remplace celui-ci, [Utiliser *ProjectionExpression* à la place](#ProjectionExpression.instead). 

Le paramètre conditionnel hérité `AttributesToGet` est un tableau d’un ou plusieurs attributs à extraire de DynamoDB. Si aucun nom d’attribut n’est fourni, tous les attributs sont renvoyés. Les attributs demandés non trouvés n’apparaissent pas dans le résultat.

`AttributesToGet` vous permet d’extraire des attributs de type liste ou mappage, mais pas des éléments individuels d’une liste ou d’un mappage.

Notez qu’`AttributesToGet` n’a aucun effet sur la consommation du débit approvisionné. DynamoDB détermine les unités de capacité consommées sur la base de la taille d’un élément, pas de la quantité de données qu’il renvoie à une application.

## Utiliser *ProjectionExpression*plutôt — Exemple
<a name="ProjectionExpression.instead"></a>

Supposons que vous souhaitez extraire un élément de la table *Music*, mais ne voulez renvoyer que certains des attributs. Vous pouvez utiliser une `GetItem` requête avec un `AttributesToGet` paramètre, comme dans cet AWS CLI exemple :

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

Vous pouvez utiliser `ProjectionExpression` à la place :

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