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. # DeleteItem **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 Löscht ein einzelnes Element in einer Tabelle nach Primärschlüssel Sie können eine bedingte Löschoperation durchführen, die das Element löscht, wenn es vorhanden ist oder wenn es über einen erwarteten Attributwert verfügt. **Anmerkung** Wenn Sie `DeleteItem` ohne Attribute oder Werte angeben, werden alle Attribute für das Element gelöscht. Sofern Sie keine Bedingungen angeben, ist `DeleteItem` eine idempotente Operation. Das mehrmalige Ausführen für das gleiche Element oder Attribut resultiert *nicht* in einer Fehlermeldung. Bedingte Löschungen eignen sich nur für das Löschen von Elementen und Attributen, wenn bestimmte Bedingungen erfüllt sind. Wenn die Bedingungen erfüllt sind, führt DynamoDB die Löschung durch. Andernfalls wird das Element nicht gelöscht. Sie können die erwartete bedingte Prüfung für ein Attribut pro Operation durchführen. ## Anforderungen ### Syntax ``` // 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.DeleteItem content-type: application/x-amz-json-1.0 {"TableName":"Table1", "Key": {"HashKeyElement":{"S":"AttributeValue1"},"RangeKeyElement":{"N":"AttributeValue2"}}, "Expected":{"AttributeName3":{"Value":{"S":"AttributeValue3"}}}, "ReturnValues":"ALL_OLD"} } ``` **** | Name | Beschreibung | Erforderlich | | --- | --- | --- | | TableName | Der Name der Tabelle, die das zu löschende Element enthält. **Typ:** Zeichenfolge | Ja | | Key | Der Primärschlüssel, der das Element definiert. 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 | | Expected | Bestimmt ein Attribut für eine bedingte Löschung. Der Parameter `Expected` ermöglicht es Ihnen, einen Attributnamen anzugeben und zu entscheiden, ob DynamoDB prüfen soll oder nicht, ob das Attribut über einen bestimmten Wert verfügt, bevor es gelöscht wird.Typ: Zuordnung von Attributnamen. | Nein | | Expected:AttributeName | Der Name des Attributs für die bedingte Put-Operation. **Typ:** Zeichenfolge | Nein | | Expected:AttributeName: ExpectedAttributeValue | Verwenden Sie diesen Parameter, um anzugeben, ob ein Wert für das Attributname-Wert-Paar bereits vorhanden ist oder nicht. Die folgende JSON-Notation löscht das Element, wenn das Attribut "Farbe" für dieses Element nicht vorhanden ist:
"Expected" :
	{"Color":{"Exists":false}}
Die folgende JSON-Notation prüft, ob das Attribut mit dem Namen "Farbe" über einen vorhandenen Wert für "Gelb" verfügt, bevor das Element gelöscht wird: 
"Expected" : 
	{"Color":{"Exists":true},{"Value":{"S":"Yellow"}}}
Wenn Sie den Parameter `Expected` verwenden und einen `Value` angeben, geht DynamoDB davon aus, dass das Attribut vorhanden ist und einen zu ersetzenden aktuellen Wert hat. Sie müssen `{"Exists":true}` demnach nicht angeben, weil er enthalten ist. Sie können die Anforderung verkürzen, um:
"Expected" : 
	{"Color":{"Value":{"S":"Yellow"}}}
Wenn Sie `{"Exists":true}` ohne einen zu prüfenden Attributwert angeben, gibt DynamoDB einen Fehler zurück. | Nein | | ReturnValues | Verwenden Sie diesen Parameter, wenn Sie die Attribut-Namen-Wert-Paare erhalten möchten, bevor sie gelöscht wurden. Mögliche Parameterwerte sind `NONE` (Standard) oder `ALL_OLD`. Wenn `ALL_OLD` angegeben wird, werden die Inhalte des alten Elements zurückgegeben. Wenn dieser Parameter nicht angegeben wird oder `NONE` ist, wird nichts zurückgegeben.**Typ:** Zeichenfolge | Nein | ## Antworten ### Syntax ``` HTTP/1.1 200 OK x-amzn-RequestId: CSOC7TJPLR0OOKIRLGOHVAICUFVV4KQNSO5AEMVJF66Q9ASUAAJG content-type: application/x-amz-json-1.0 content-length: 353 Date: Tue, 12 Jul 2011 21:31:03 GMT {"Attributes": {"AttributeName3":{"SS":["AttributeValue3","AttributeValue4","AttributeValue5"]}, "AttributeName2":{"S":"AttributeValue2"}, "AttributeName1":{"N":"AttributeValue1"} }, "ConsumedCapacityUnits":1 } ``` **** | Name | Beschreibung | | --- | --- | | Attributes | Wenn der Parameter `ReturnValues` als `ALL_OLD` in der Anforderung angegeben wird, gibt DynamoDB ein Array von Attribut-Namen-Wert-Paare zurück (im Wesentlichen, das gelöschte Element). Andernfalls enthält die Antwort einen leeren Satz. Typ: Array von Attribut-Namen-Wert-Paare. | | ConsumedCapacityUnits | Die Anzahl der Schreibkapazitätseinheiten, die von dem Vorgang verbraucht werden. Dieser Wert zeigt die Anzahl, die für Ihren bereitgestellten Durchsatz gültig ist. Löschoperationen für nicht vorhandene Elemente verbrauchen 1 Schreibkapazitätseinheit. Weitere Informationen finden Sie unter [DynamoDB – Modus mit bereitgestellter Kapazität](provisioned-capacity-mode.md). Typ: Zahl | ## Spezielle Fehler **** | Fehler | Beschreibung | | --- | --- | | ConditionalCheckFailedException | Bedingte Prüfung fehlgeschlagen. Ein erwarteter Attributwert wurde nicht gefunden. | ## Beispiele ### Beispielanforderung ``` // 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.DeleteItem content-type: application/x-amz-json-1.0 {"TableName":"comp-table", "Key": {"HashKeyElement":{"S":"Mingus"},"RangeKeyElement":{"N":"200"}}, "Expected": {"status":{"Value":{"S":"shopping"}}}, "ReturnValues":"ALL_OLD" } ``` ### Beispielantwort ``` HTTP/1.1 200 OK x-amzn-RequestId: U9809LI6BBFJA5N2R0TB0P017JVV4KQNSO5AEMVJF66Q9ASUAAJG content-type: application/x-amz-json-1.0 content-length: 353 Date: Tue, 12 Jul 2011 22:31:23 GMT {"Attributes": {"friends":{"SS":["Dooley","Ben","Daisy"]}, "status":{"S":"shopping"}, "time":{"N":"200"}, "user":{"S":"Mingus"} }, "ConsumedCapacityUnits":1 } ``` ## Zugehörige Aktionen + [PutItem](API_PutItem_v20111205.md)