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

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 ReadCapacityUnits und WriteCapacityUnits. Siehe Bereitgestellter Kapazitätsmodus von DynamoDB.

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 + Range 2048 + 1024-Schlüssel haben). 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

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