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
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
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 Bereitgestellter Kapazitätsmodus von DynamoDB.
Die bereitgestellten Durchsatzwerte können basierend auf den Maximal- und Mindestwerten, aufgeführt in Kontingente in Amazon DynamoDB, aktualisiert oder herabgestuft werden.
Die Tabelle muss sich im ACTIVE
Status befinden, damit dieser Vorgang erfolgreich ist. UpdateTable ist ein asynchroner Vorgang. Während der Ausführung des Vorgangs befindet sich die Tabelle im UPDATING
Status. Während sich die Tabelle im Status UPDATING
befindet, verfügt sie weiterhin über den bereitgestellten Durchsatz von vor dem Aufruf. Die neue Einstellung für den bereitgestellten Durchsatz ist nur wirksam, wenn die Tabelle nach dem Vorgang wieder in den ACTIVE
Status zurückkehrt. UpdateTable
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 Typ: Array |
Ja |
ProvisionedThroughput
:ReadCapacityUnits |
Legt die Mindestanzahl von konsistenten Eventually Consistent-Leseoperationen erfordern weniger Aufwand als Consistent-Leseoperationen. Daher stellt die Festlegung von 50 konsistenten Typ: Zahl |
Ja |
ProvisionedThroughput
:WriteCapacityUnits |
Legt die Mindestanzahl von 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 Typ: Zuordnung von |
ProvisionedThroughput |
Aktuelle Durchsatzeinstellungen für die angegebene Tabelle, einschließlich Werte für 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-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"} }