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.
# UpdateTable
**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
Aktualisiert den bereitgestellten Durchsatz für die jeweilige Tabelle. Das Festlegen des Durchsatzes für eine Tabelle unterstützt Sie beim Verwalten der Leistung und ist Teil der Funktion des bereitgestellten Durchsatzes von DynamoDB. Weitere Informationen finden Sie unter [DynamoDB – Modus mit bereitgestellter Kapazität](provisioned-capacity-mode.md).
Die bereitgestellten Durchsatzwerte können basierend auf den Maximal- und Mindestwerten, aufgeführt in [Kontingente in Amazon DynamoDB](ServiceQuotas.md), aktualisiert oder herabgestuft werden.
Die Tabelle muss sich im Status `ACTIVE` befinden, damit diese Operation erfolgreich ist. "UpdateTable" ist eine asynchrone Operation; während der Ausführung der Operation befindet sich die Tabelle im Status `UPDATING`. Während sich die Tabelle im Status `UPDATING` befindet, verfügt sie weiterhin über den bereitgestellten Durchsatz von vor dem Aufruf. Die neue Einstellung des bereitgestellten Durchsatzes gilt nur, wenn die Tabelle nach der "UpdateTable"-Operation wieder in den Status `ACTIVE` zurückkehrt.
## 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.UpdateTable
content-type: application/x-amz-json-1.0
{"TableName":"Table1",
"ProvisionedThroughput":{"ReadCapacityUnits":5,"WriteCapacityUnits":15}
}
```
****
| Name | Beschreibung | Erforderlich |
| --- | --- | --- |
| TableName | Der Name der zu erstellenden Tabelle. **Typ:** Zeichenfolge | Ja |
| ProvisionedThroughput | Neuer Durchsatz für die angegebene Tabelle, bestehend aus Werten für `ReadCapacityUnits` und `WriteCapacityUnits`. Siehe [DynamoDB – Modus mit bereitgestellter Kapazität](provisioned-capacity-mode.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/json
Content-Length: 311
Date: Tue, 12 Jul 2011 21:31:03 GMT
{"TableDescription":
{"CreationDateTime":1.321657838135E9,
"KeySchema":
{"HashKeyElement":{"AttributeName":"AttributeValue1","AttributeType":"S"},
"RangeKeyElement":{"AttributeName":"AttributeValue2","AttributeType":"N"}},
"ProvisionedThroughput":
{"LastDecreaseDateTime":1.321661704489E9,
"LastIncreaseDateTime":1.321663607695E9,
"ReadCapacityUnits":5,
"WriteCapacityUnits":10},
"TableName":"Table1",
"TableStatus":"UPDATING"}}
```
****
| Name | Beschreibung |
| --- | --- |
| 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). Die maximale Hash-Schlüsselgröße ist 2048 Byte. Die maximale Range-Schlüsselgröße ist 1024 Byte. Beide Grenzen werden separat durchgesetzt (d. h. Sie können einen kombinierten Hash \$1 Range 2048 \$1 1024-Schlüssel haben). 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 | Aktuelle Durchsatzeinstellungen für die angegebene Tabelle, einschließlich Werte für `LastIncreaseDateTime` (falls zutreffend), `LastDecreaseDateTime` (falls zutreffend), Typ: Array |
| TableName | Der Name der aktualisierten Tabelle. **Typ:** Zeichenfolge |
| TableStatus | Der aktuelle Status der Tabelle (CREATING, ACTIVE, DELETING oder UPDATING), der UPDATING sein sollte. Verwenden Sie die [DescribeTables](API_DescribeTables_v20111205.md)-Operation, um den Status der Tabelle zu überprüfen. **Typ:** Zeichenfolge |
## Spezielle Fehler
****
| Fehler | Beschreibung |
| --- | --- |
| ResourceNotFoundException | Die angegebene Tabelle wurde nicht gefunden. |
| ResourceInUseException | Die Tabelle befindet sich nicht im Status ACTIVE. |
## 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.UpdateTable
content-type: application/x-amz-json-1.0
{"TableName":"comp1",
"ProvisionedThroughput":{"ReadCapacityUnits":5,"WriteCapacityUnits":15}
}
```
### Beispielantwort
```
HTTP/1.1 200 OK
content-type: application/x-amz-json-1.0
content-length: 390
Date: Sat, 19 Nov 2011 00:46:47 GMT
{"TableDescription":
{"CreationDateTime":1.321657838135E9,
"KeySchema":
{"HashKeyElement":{"AttributeName":"user","AttributeType":"S"},
"RangeKeyElement":{"AttributeName":"time","AttributeType":"N"}},
"ProvisionedThroughput":
{"LastDecreaseDateTime":1.321661704489E9,
"LastIncreaseDateTime":1.321663607695E9,
"ReadCapacityUnits":5,
"WriteCapacityUnits":10},
"TableName":"comp1",
"TableStatus":"UPDATING"}
}
```
## Zugehörige Aktionen
+ [CreateTable](API_CreateTable_v20111205.md)
+ [DescribeTables](API_DescribeTables_v20111205.md)
+ [DeleteTable](API_DeleteTable_v20111205.md)