DeleteTable - 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.

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 HashKeyElement und optional für das RangeKeyElement erforderlich (nur für zusammengesetzte Primärschlüssel erforderlich). Weitere Informationen zu Primärschlüsseln finden Sie unter Primärschlüssel.

Typ: Zuordnung von HashKeyElement oder HashKeyElement und RangeKeyElement für einen zusammengesetzten Primärschlüssel.
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 ReadCapacityUnits, die pro Sekunde für die angegebene Tabelle verbraucht werden, bevor DynamoDB die Last mit anderen Operationen ausgleicht.

Typ: Zahl

ProvisionedThroughput: WriteCapacityUnits

Die Mindestanzahl von WriteCapacityUnits, die pro Sekunde für die angegebene Tabelle verbraucht werden, bevor DynamoDB die Last mit anderen Operationen ausgleicht.

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