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

**nota**  
Le recomendamos que utilice los nuevos parámetros de expresión en lugar de estos parámetros heredados siempre que sea posible. Para obtener más información, consulte [Uso de expresiones en DynamoDB](Expressions.md). Para obtener información específica sobre el nuevo parámetro que reemplaza a este, [Use *ProjectionExpression* en su lugar](#ProjectionExpression.instead). 

El parámetro condicional heredado `AttributesToGet` es una matriz de uno o varios atributos que se recuperan de DynamoDB. Si no se proporcionan sus nombres, se devuelven todos los atributos. Si cualquiera de los atributos solicitados no se encuentra, no aparecerá en el resultado.

`AttributesToGet` permite recuperar atributos de tipo List o Map; sin embargo, no puede recuperar entradas individuales dentro de una lista o un mapa.

Tenga en cuenta que `AttributesToGet` no modifica el consumo de rendimiento aprovisionado. DynamoDB determina las unidades de capacidad de lectura consumidas según el tamaño de los elementos y no según la cantidad de datos que se devuelven a la aplicación.

## Use *ProjectionExpression* en su lugar; ejemplo
<a name="ProjectionExpression.instead"></a>

Supongamos que desea recuperar un elemento de la tabla *Music*, pero no devolverlo completo, sino solo algunos de los atributos. Podría usar una solicitud `GetItem` con un parámetro `AttributesToGet` como en este ejemplo de la 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"}
    }'
```

Puede utilizar `ProjectionExpression` en su lugar:

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