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

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.

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.

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

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