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
This section refers to API version 2011-12-05,
which is deprecated and should not be used for new
applications.
Eine Dokumentation zur aktuellen Low-Level-API finden Sie in der Amazon DynamoDB-API-Referenz.
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. Typ: Zuordnung von |
Ja |
Expected
|
Bestimmt ein Attribut für eine bedingte Löschung. Der Parameter 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:
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:
Wenn Sie den Parameter
AnmerkungWenn Sie |
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 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 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 Bereitgestellter Kapazitätsmodus von DynamoDB. 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 }