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.
DeleteTable
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
Die DeleteTable
-Operation löscht eine Tabelle und alle ihre Elemente. Nach einer DeleteTable
-Anforderung, befindet sich die angegebene Tabelle im Status DELETING
, bis DynamoDB die Löschung abschließt. Wenn sich die Tabelle im Status ACTIVE
befindet, können Sie sie löschen. Wenn eine Tabelle sich im Status CREATING
oder UPDATING
befindet, gibt DynamoDB den Fehler ResourceInUseException
zurück. Wenn die angegebene Tabelle nicht vorhanden ist, gibt DynamoDB einen ResourceNotFoundException
zurück. Wenn die Tabelle sich bereits im Status DELETING
befindet, wird kein Fehler zurückgegeben.
Anmerkung
DynamoDB kann möglicherweise Operationsanforderungen auf Datenebene, z. B. GetItem
und PutItem
, in einer Tabelle mit dem Status DELETING
akzeptieren, bis die Löschung der Tabelle abgeschlossen ist.
Die Tabellen unterscheiden sich in Bezug auf das AWS Konto, das die Anfrage ausstellt, und die AWS Region, in der die Anfrage eingeht (z. B. dynamodb.us-west-1.amazonaws.com). Jeder DynamoDB-Endpunkt ist vollständig unabhängig. Wenn Sie beispielsweise zwei Tabellen mit dem Namen "“ habenMyTable, eine in dynamodb.us-west-2.amazonaws.com und eine in dynamodb.us-west-1.amazonaws.com, sind sie völlig unabhängig und haben keine gemeinsamen Daten. Wenn Sie eine Tabelle löschen, wird die andere nicht gelöscht.
Verwenden Sie die DescribeTables-Operation, um den Status der Tabelle zu überprüfen.
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.DeleteTable content-type: application/x-amz-json-1.0 {"TableName":"Table1"}
Name | Beschreibung | Erforderlich |
---|---|---|
TableName
|
Der Name der zu löschenden Tabelle. Typ: Zeichenfolge |
Ja |
Antworten
Syntax
HTTP/1.1 200 OK x-amzn-RequestId: 4HONCKIVH1BFUDQ1U68CTG3N27VV4KQNSO5AEMVJF66Q9ASUAAJG content-type: application/x-amz-json-1.0 content-length: 311 Date: Sun, 14 Aug 2011 22:56:22 GMT {"TableDescription": {"CreationDateTime":1.313362508446E9, "KeySchema": {"HashKeyElement":{"AttributeName":"user","AttributeType":"S"}, "RangeKeyElement":{"AttributeName":"time","AttributeType":"N"}}, "ProvisionedThroughput":{"ReadCapacityUnits":10,"WriteCapacityUnits":10}, "TableName":"Table1", "TableStatus":"DELETING" } }
Name | Beschreibung |
---|---|
TableDescription
|
Ein Container für die Eigenschaften der Tabelle. |
CreationDateTime |
Das Datum, an dem die Tabelle erstellt wurde. Typ: Zahl |
KeySchema
|
Die Struktur (einfach oder zusammengesetzt) des Primärschlüssels für die Tabelle. Ein Name-Wert-Paar ist für das Typ: Zuordnung von |
ProvisionedThroughput
|
Der Durchsatz für eine angegebene Tabelle, bestehend aus Werten für ReadCapacityUnits und WriteCapacityUnits . Siehe Bereitgestellter Kapazitätsmodus von DynamoDB. |
ProvisionedThroughput :
ReadCapacityUnits |
Die Mindestanzahl von Typ: Zahl |
ProvisionedThroughput :
WriteCapacityUnits |
Die Mindestanzahl von Typ: Zahl |
TableName
|
Der Name der gelöschten Tabelle. Typ: Zeichenfolge |
TableStatus
|
Der aktuelle Status der Tabelle (DELETING ). Sobald die Tabelle gelöscht wird, werden nachfolgende Anforderungen für die Tabelle zurückgegeben resource
not found . Verwenden Sie die DescribeTables-Operation, um den Status der Tabelle zu überprüfen. Typ: Zeichenfolge |
Spezielle Fehler
Fehler | Beschreibung |
---|---|
ResourceInUseException
|
Die Tabelle befindet sich im Status CREATING oder UPDATING und kann nicht gelöscht werden. |
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.DeleteTable content-type: application/x-amz-json-1.0 content-length: 40 {"TableName":"favorite-movies-table"}
Beispielantwort
HTTP/1.1 200 OK x-amzn-RequestId: 4HONCKIVH1BFUDQ1U68CTG3N27VV4KQNSO5AEMVJF66Q9ASUAAJG content-type: application/x-amz-json-1.0 content-length: 160 Date: Sun, 14 Aug 2011 17:20:03 GMT {"TableDescription": {"CreationDateTime":1.313362508446E9, "KeySchema": {"HashKeyElement":{"AttributeName":"name","AttributeType":"S"}}, "TableName":"favorite-movies-table", "TableStatus":"DELETING" }