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à.
Importante
This section refers to API version 2011-12-05,
which is deprecated and should not be used for new
applications.
Per la documentazione sull'attuale livello bassoAPI, consulta Amazon DynamoDB Reference API.
Descrizione
L'operazione GetItemrestituisce 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.
Richieste
Sintassi
// This header is abbreviated. // For a sample of a complete header, see DynamoDB di basso livello API. 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: stringa |
Sì |
Key
|
I valori della chiave primaria che definiscono l'elemento. Per ulteriori informazioni sulle chiavi primarie, vedere Chiave primaria. Tipo: mappa di |
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 Tipo: Booleano |
No |
Risposte
Sintassi
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à di capacità fornita da DynamoDB. Tipo: numero |
Errori speciali
Nessun errore specifico per questa operazione.
Esempi
Per esempi di utilizzo di, consulta. AWS SDK Utilizzo di elementi e attributi in DynamoDB
Richiesta di esempio
// This header is abbreviated. // For a sample of a complete header, see DynamoDB di basso livello API. 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
Notate che il ConsumedCapacityUnits valore è 1, poiché il parametro opzionale ConsistentRead è impostato sutrue. Se ConsistentRead è impostato su false (o non specificato) per la stessa richiesta, la risposta alla fine è coerente e il ConsumedCapacityUnits valore 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
}