DeleteItem - Amazon-DynamoDB
BeschreibungAnforderungenAntwortenSpezielle FehlerBeispieleZugehörige Aktionen

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 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"}}}
Anmerkung

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 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
}