Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# GetItem
<a name="API_GetItem_v20111205"></a>

**Importante**  
***In questa sezione si fa riferimento alla versione API 2011-12-05, che è obsoleta e non deve essere utilizzata per le nuove applicazioni.***  
 **Per informazioni sull'API di basso livello corrente, consulta la [Amazon DynamoDB API Reference](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/).**

## Descrizione
<a name="API_GetItem_Description"></a>

L'operazione `GetItem`restituisce un set di `Attributes` per un elemento che corrisponde alla chiave primaria. Se non viene trovato un elemento corrispondente, `GetItem` non restituisce alcun dato.

Per impostazione predefinita, l'operazione `GetItem` usa le letture a consistenza finali. Se le letture a consistenza finale non sono accettabili per l'applicazione, utilizza `ConsistentRead`. Sebbene questa operazione possa richiedere più tempo di una lettura standard, restituisce sempre l'ultimo valore aggiornato. Per ulteriori informazioni, consulta [Coerenza di lettura di DynamoDB](HowItWorks.ReadConsistency.md).

## Richieste
<a name="API_GetItem_RequestParameters"></a>

### Sintassi
<a name="API_GetItem_RequestParameters.syntax"></a>

```
// This header is abbreviated.
// For a sample of a complete header, see API DynamoDB di basso livello.
POST / HTTP/1.1 
x-amz-target: DynamoDB_20111205.GetItem
content-type: application/x-amz-json-1.0 

{"TableName":"Table1",
 	"Key": 
		{"HashKeyElement": {"S":"AttributeValue1"},
		"RangeKeyElement": {"N":"AttributeValue2"} 
	},
	"AttributesToGet":["AttributeName3","AttributeName4"],
	"ConsistentRead":Boolean
}
```


****  

|  Nome  |  Descrizione  |  Richiesto | 
| --- | --- | --- | 
|  TableName  |  Il nome della tabella che contiene gli elementi richiesti.  Tipo: string  |  Sì  | 
|  Key  | I valori della chiave primaria che definiscono l'elemento. Per ulteriori informazioni sulle chiavi primarie, vedere [Chiave primaria](HowItWorks.CoreComponents.md#HowItWorks.CoreComponents.PrimaryKey).Tipo: mappa di `HashKeyElement` sul suo valore e `RangeKeyElement` sul suo valore. | Sì | 
| AttributesToGet  | Matrice di nomi di attributi. Se i nomi degli attributi non sono specificati, verranno restituiti tutti gli attributi. Se alcuni attributi non vengono trovati, non verranno visualizzati nel risultato.Tipo: Array | No | 
| ConsistentRead  | Se impostato su `true`, viene emessa una lettura consistente, altrimenti viene utilizzata la consistenza finale.Tipo: Booleano | No | 

## Risposte
<a name="API_GetItem_ResponseElements"></a>

### Sintassi
<a name="API_GetItem_ResponseElements.syntax"></a>

```
HTTP/1.1 200 
x-amzn-RequestId: 8966d095-71e9-11e0-a498-71d736f27375 
content-type: application/x-amz-json-1.0
content-length: 144

{"Item":{
	"AttributeName3":{"S":"AttributeValue3"},
	"AttributeName4":{"N":"AttributeValue4"},
	"AttributeName5":{"B":"dmFsdWU="}
	},
"ConsumedCapacityUnits": 0.5
}
```


****  

|  Nome  |  Descrizione  | 
| --- | --- | 
|  Item  | Contiene gli attributi richiesti.Tipo: mappa di coppie nome-valore dell'attributo. | 
| ConsumedCapacityUnits | Il numero di unità di capacità di scrittura utilizzate dall'operazione. Questo valore mostra il numero applicato alla velocità effettiva assegnata. Le richieste di elementi inesistenti consumano le unità di capacità di lettura minima in base al tipo di lettura. Per ulteriori informazioni, consulta [Modalità con capacità allocata di DynamoDB](provisioned-capacity-mode.md). Tipo: numero | 

## Errori speciali
<a name="API_GetItem_SpecialErrors"></a>

Nessun errore specifico per questa operazione.

## Esempi
<a name="API_GetItem_Examples"></a>

 Per gli esempi di utilizzo dell'SDK AWS, consulta [Utilizzo di elementi e attributi in DynamoDB](WorkingWithItems.md).

### Richiesta di esempio
<a name="API_GetItem_Examples_Request"></a>

```
// This header is abbreviated.
// For a sample of a complete header, see API DynamoDB di basso livello.
POST / HTTP/1.1 
x-amz-target: DynamoDB_20111205.GetItem
content-type: application/x-amz-json-1.0 

{"TableName":"comptable",
	"Key":
		{"HashKeyElement":{"S":"Julie"},
		"RangeKeyElement":{"N":"1307654345"}},
	"AttributesToGet":["status","friends"],
	"ConsistentRead":true
}
```

### Risposta di esempio
<a name="API_GetItem_Examples_Response"></a>

Si noti che il valore di ConsumedCapacityUnits è 1, poiché il parametro facoltativo `ConsistentRead` è impostato su `true`. Se `ConsistentRead` è impostato su `false` (o se non è specificato) per la stessa richiesta, la risposta è a consistenza finale e il valore ConsumedCapacityUnits sarebbe 0,5.

```
HTTP/1.1 200 
x-amzn-RequestId: 8966d095-71e9-11e0-a498-71d736f27375 
content-type: application/x-amz-json-1.0
content-length: 72

{"Item":
	{"friends":{"SS":["Lynda, Aaron"]},
	"status":{"S":"online"}
	},
"ConsumedCapacityUnits": 1
}
```