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.
# CreateTable
**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 `CreateTable`-Operation fügt dem Konto eine neue Tabelle hinzu.
Tabellennamen müssen innerhalb derer eindeutig sein, die dem AWS-Konto zugehören, das die Anforderung ausführt und der AWS-Region, welche die Anforderung empfängt (z.B. dynamodb.us-west-2.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.
Die `CreateTable`-Operation löst eine asynchrone Workload aus, um mit der Erstellung der Tabelle zu beginnen. DynamoDB gibt unmittelbar den Status der Tabelle (`CREATING`) zurück, bis sich die Tabelle im Status `ACTIVE` befindet. Sobald sich die Tabelle im Status `ACTIVE` befindet, können Sie Datenebenenoperationen durchführen.
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.CreateTable
content-type: application/x-amz-json-1.0
{"TableName":"Table1",
"KeySchema":
{"HashKeyElement":{"AttributeName":"AttributeName1","AttributeType":"S"},
"RangeKeyElement":{"AttributeName":"AttributeName2","AttributeType":"N"}},
"ProvisionedThroughput":{"ReadCapacityUnits":5,"WriteCapacityUnits":10}
}
```
****
| Name | Beschreibung | Erforderlich |
| --- | --- | --- |
| TableName | Der Name der zu erstellenden Tabelle.Zulässige Zeichen sind a-z, A-Z, 0-9, „\$1“ (Unterstrich), „-“ (Bindestrich) und „.“ (Punkt). Namen können zwischen 3 und 255 Zeichen lang sein. **Typ:** Zeichenfolge | Ja |
| 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).Elementnamen der Primärschlüssel können zwischen 1 und 255 Zeichen lang sein und unterliegen keinen Zeicheneinschränkungen. Mögliche Werte für den AttributeType sind "S" (Zeichenfolge), "N" (numerisch) oder "B" (binär).Typ: Zuordnung von `HashKeyElement` oder `HashKeyElement` und `RangeKeyElement` für einen zusammengesetzten Primärschlüssel. | Ja |
| ProvisionedThroughput | Neuer Durchsatz für die angegebene Tabelle, bestehend aus Werten für ReadCapacityUnits und WriteCapacityUnits. Details hierzu finden Sie unter [DynamoDB – Modus mit bereitgestellter Kapazität](provisioned-capacity-mode.md). Aktuelle Höchst- und Mindestwerte finden Sie unter [Kontingente in Amazon DynamoDB](ServiceQuotas.md). Typ: Array | Ja |
| ProvisionedThroughput: ReadCapacityUnits | Legt die Mindestanzahl von konsistenten `ReadCapacityUnits` fest, die pro Sekunde für die angegebene Tabelle verbraucht wird, bevor DynamoDB die Last mit anderen Operationen ausgleicht. Eventually Consistent-Leseoperationen erfordern weniger Aufwand als Consistent-Leseoperationen. Daher stellt die Festlegung von 50 konsistenten `ReadCapacityUnits` pro Sekunde 100 Eventually Consistent-`ReadCapacityUnits` pro Sekunde bereit. Typ: Zahl | Ja |
| ProvisionedThroughput: WriteCapacityUnits | Legt die Mindestanzahl von WriteCapacityUnits fest, die pro Sekunde für die angegebene Tabelle verbraucht wird, bevor DynamoDB die Last mit anderen Operationen ausgleicht. Typ: Zahl | Ja |
## Antworten
### Syntax
```
HTTP/1.1 200 OK
x-amzn-RequestId: CSOC7TJPLR0OOKIRLGOHVAICUFVV4KQNSO5AEMVJF66Q9ASUAAJG
content-type: application/x-amz-json-1.0
content-length: 311
Date: Tue, 12 Jul 2011 21:31:03 GMT
{"TableDescription":
{"CreationDateTime":1.310506263362E9,
"KeySchema":
{"HashKeyElement":{"AttributeName":"AttributeName1","AttributeType":"S"},
"RangeKeyElement":{"AttributeName":"AttributeName2","AttributeType":"N"}},
"ProvisionedThroughput":{"ReadCapacityUnits":5,"WriteCapacityUnits":10},
"TableName":"Table1",
"TableStatus":"CREATING"
}
}
```
****
| Name | Beschreibung |
| --- | --- |
| TableDescription | Ein Container für die Eigenschaften der Tabelle. |
| CreationDateTime | Datum als die Tabelle in [UNIX epoch time](http://www.epochconverter.com/) 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). Typ: Array |
| ProvisionedThroughput :ReadCapacityUnits | Die minimale Anzahl von `ReadCapacityUnits`, die pro Sekunde verbraucht werden, bevor DynamoDB die Last mit anderen Operationen ausgleichtTyp: Zahl |
| ProvisionedThroughput :WriteCapacityUnits | Die minimale Anzahl von `ReadCapacityUnits`, die pro Sekunde verbraucht werden, bevor `WriteCapacityUnits` die Last mit anderen Operationen ausgleichtTyp: Zahl |
| TableName | Der Name der erstellten Tabelle. **Typ:** Zeichenfolge |
| TableStatus | Der aktuelle Status der Tabelle (`CREATING`). Sobald sich die Tabelle im `ACTIVE`-Status befindet, können Sie in dieser Daten ablegen.Verwenden Sie die [DescribeTables](API_DescribeTables_v20111205.md)-API, um den Status der Tabelle zu überprüfen.**Typ:** Zeichenfolge |
## Spezielle Fehler
****
| Fehler | Beschreibung |
| --- | --- |
| ResourceInUseException | Versuch, eine bereits vorhandene Tabelle neu zu erstellen. |
| LimitExceededException | Die Anzahl von gleichzeitigen Tabellenanforderungen (kumulative Anzahl von Tabellen im Status `CREATING`, `DELETING` oder `UPDATING`) überschreitet die maximal zulässige. Aktuelle Höchst- und Mindestwerte finden Sie unter [Kontingente in Amazon DynamoDB](ServiceQuotas.md). . |
## Beispiele
Das folgende Beispiel erstellt eine Tabelle mit einem zusammengesetzten Primärschlüssel, der eine Zeichenfolge und eine Zahl enthält. Beispiele für die Verwendung des AWS SDK finden Sie unter [Arbeiten mit Tabellen und Daten in DynamoDB](WorkingWithTables.md).
### 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.CreateTable
content-type: application/x-amz-json-1.0
{"TableName":"comp-table",
"KeySchema":
{"HashKeyElement":{"AttributeName":"user","AttributeType":"S"},
"RangeKeyElement":{"AttributeName":"time","AttributeType":"N"}},
"ProvisionedThroughput":{"ReadCapacityUnits":5,"WriteCapacityUnits":10}
}
```
### Beispielantwort
```
HTTP/1.1 200 OK
x-amzn-RequestId: CSOC7TJPLR0OOKIRLGOHVAICUFVV4KQNSO5AEMVJF66Q9ASUAAJG
content-type: application/x-amz-json-1.0
content-length: 311
Date: Tue, 12 Jul 2011 21:31:03 GMT
{"TableDescription":
{"CreationDateTime":1.310506263362E9,
"KeySchema":
{"HashKeyElement":{"AttributeName":"user","AttributeType":"S"},
"RangeKeyElement":{"AttributeName":"time","AttributeType":"N"}},
"ProvisionedThroughput":{"ReadCapacityUnits":5,"WriteCapacityUnits":10},
"TableName":"comp-table",
"TableStatus":"CREATING"
}
}
```
## Zugehörige Aktionen
+ [DescribeTables](API_DescribeTables_v20111205.md)
+ [DeleteTable](API_DeleteTable_v20111205.md)