Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

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

**Wichtig**  
***Dieser Abschnitt bezieht sich auf die veraltete API-Version 2011-12-05, die nicht für neue Anwendungen verwendet werden sollte.***  
 **Eine Dokumentation zur aktuellen Low-Level-API finden Sie in der [Amazon DynamoDB-API-Referenz](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/).**

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

Die `GetItem`-Operation gibt einen `Attributes`-Satz für ein Element zurück, das mit dem Primärschlüssel übereinstimmt. Wenn kein passendes Element vorhanden ist, gibt `GetItem` keine Daten zurück.

Die `GetItem`-Operation stellt standardmäßig einen Eventually Consistent-Lesevorgang bereit. Wenn Eventually Consistent-Lesevorgänge für Ihre Anwendung nicht akzeptabel sind, verwenden Sie `ConsistentRead`. Obwohl diese Operation länger dauern könnte als ein Standardlesevorgang, gibt sie immer den letzten aktualisierten Wert zurück. Weitere Informationen finden Sie unter [DynamoDB-Lesekonsistenz](HowItWorks.ReadConsistency.md).

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

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

```
// This header is abbreviated.
// For a sample of a complete header, see DynamoDB Low-Level-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
}
```


****  

|  Name  |  Beschreibung  |  Erforderlich | 
| --- | --- | --- | 
|  TableName  |  Der Name der Tabelle, die das angeforderte Element enthält.  **Typ:** Zeichenfolge  |  Ja  | 
|  Key  | Die Primärschlüsselwerte, die das Element definieren. Weitere Informationen zu Primärschlüsseln finden Sie unter [Primärschlüssel](HowItWorks.CoreComponents.md#HowItWorks.CoreComponents.PrimaryKey).Typ: Zuordnung von `HashKeyElement` zu seinem Wert und von `RangeKeyElement` zu seinem Wert. | Ja | 
| AttributesToGet  | Array von Attributnamen. Wenn Attributnamen nicht angegeben sind, dann werden alle Attribute zurückgegeben. Wenn einige Attribute nicht gefunden werden, sind sie nicht im Abfrageergebnis enthalten.Typ: Array | Nein | 
| ConsistentRead  | Wenn auf `true` festgelegt, dann wird ein Consistent-Lesevorgang ausgegeben, andernfalls wird Eventually Consistent verwendet.Typ: Boolesch | Nein | 

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

### Syntax
<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
}
```


****  

|  Name  |  Beschreibung  | 
| --- | --- | 
|  Item  | Enthält die angeforderten Attribute.Typ: Zuordnung von Attribut-Namen-Wert-Paare. | 
| ConsumedCapacityUnits | Die Anzahl der Lesekapazitätseinheiten, die von der Operation verbraucht werden. Dieser Wert zeigt die Anzahl, die für Ihren bereitgestellten Durchsatz gültig ist. Anforderungen für nicht vorhandene Elemente verbrauchen je nach Typ des Lesevorgangs die Mindestlesekapazitätseinheiten. Weitere Informationen finden Sie unter [DynamoDB – Modus mit bereitgestellter Kapazität](provisioned-capacity-mode.md). Typ: Zahl | 

## Spezielle Fehler
<a name="API_GetItem_SpecialErrors"></a>

Keine nur für diese Operation spezifischen Fehler.

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

 Beispiele für die Verwendung des AWS SDK finden Sie unter [Arbeiten mit Elementen und Attributen in DynamoDB](WorkingWithItems.md).

### Beispielanforderung
<a name="API_GetItem_Examples_Request"></a>

```
// This header is abbreviated.
// For a sample of a complete header, see DynamoDB Low-Level-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
}
```

### Beispielantwort
<a name="API_GetItem_Examples_Response"></a>

Beachten Sie, dass der Wert für die verbrauchten Kapazitätseinheiten 1 ist, weil der optionale Parameter `ConsistentRead` auf `true` festgelegt ist. Wenn `ConsistentRead` für die gleiche Anforderung auf `false` festgelegt ist (oder nicht angegeben ist), ist die Antwort Eventually Consistent und der Wert für die verbrauchten Kapazitätseinheiten wäre 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
}
```