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**
***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
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.
Alle Tabellen, die mit dem AWS-Konto verknüpft sind, das die Anforderung ausgibt, und die AWS-Region, welche die Anforderung empfängt, sind eindeutig (z.B. dynamodb.us-west-1.amazonaws.com). Jeder DynamoDB-Endpunkt ist vollständig unabhängig. Wenn Sie beispielsweise zwei Tabellen namens „MyTable“ haben, eine in dynamodb.us-west-2.amazonaws.com und eine in dynamodb.us-west-1.amazonaws.com, sind sie völlig unabhängig und teilen sich keine Daten; das Löschen der einen löscht die andere nicht.
Verwenden Sie die [DescribeTables](API_DescribeTables_v20111205.md)-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](HowItWorks.CoreComponents.md#HowItWorks.CoreComponents.PrimaryKey).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 [DynamoDB – Modus mit bereitgestellter Kapazität](provisioned-capacity-mode.md). |
| 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](API_DescribeTables_v20111205.md)-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"
}
```
## Zugehörige Aktionen
+ [CreateTable](API_CreateTable_v20111205.md)
+ [DescribeTables](API_DescribeTables_v20111205.md)