Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
Importante
This section refers to API version 2011-12-05,
which is deprecated and should not be used for new
applications.
Per la documentazione sull'attuale livello bassoAPI, consulta Amazon DynamoDB Reference API.
Descrizione
Aggiorna la velocità effettiva assegnata per la tabella specificata. L'impostazione della velocità effettiva per una tabella consente di gestire le prestazioni e fa parte della caratteristica di velocità effettiva assegnata di DynamoDB. Per ulteriori informazioni, consulta Modalità di capacità fornita da DynamoDB.
I valori della velocità effettiva assegnata possono essere aggiornati o declassati in base ai valori massimi e minimi elencati in Quote di servizio, account e tabelle in Amazon DynamoDB.
Affinché l'operazione abbia successo, la tabella deve essere nello ACTIVE
stato in cui si trova. UpdateTable è un'operazione asincrona; durante l'esecuzione dell'operazione, la tabella è nello stato. UPDATING
Mentre la tabella si trova nello stato UPDATING
, la tabella ha ancora la velocità effettiva assegnata prima della chiamata. La nuova impostazione del throughput assegnato è attiva solo quando la tabella torna allo stato dopo l'ACTIVE
operazione. UpdateTable
Richieste
Sintassi
// This header is abbreviated. // For a sample of a complete header, see DynamoDB di basso livello 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} }
Nome | Descrizione | Richiesto |
---|---|---|
TableName
|
Il nome della tabella da aggiornare. Tipo: stringa |
Sì |
ProvisionedThroughput
|
La nuova velocità effettiva per la tabella specificata, costituita dai valori per Tipo: Array |
Sì |
ProvisionedThroughput
:ReadCapacityUnits |
Imposta il numero minimo di Le operazioni di lettura a consistenza finale richiedono meno sforzo rispetto a un'operazione di lettura consistente, quindi un'impostazione di 50 Tipo: numero |
Sì |
ProvisionedThroughput
:WriteCapacityUnits |
Imposta il numero minimo di Tipo: numero |
Sì |
Risposte
Sintassi
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"}}
Nome | Descrizione |
---|---|
CreationDateTime |
La data in cui è stata creata la tabella. Tipo: numero |
KeySchema
|
La struttura della chiave primaria (semplice o composita) per la tabella. Una coppia nome-valore per Tipo: mappa di |
ProvisionedThroughput |
Impostazioni del throughput corrente per la tabella specificata, inclusi i valori per Tipo: Array |
TableName
|
Il nome della tabella aggiornata. Tipo: stringa |
TableStatus
|
Lo stato corrente della tabella (CREATING , ACTIVE , DELETING o UPDATING ), che dovrebbe essere UPDATING . Utilizza l'operazione DescribeTables per controllare lo stato della tabella. Tipo: stringa |
Errori speciali
Errore | Descrizione |
---|---|
ResourceNotFoundException
|
La tabella specificata non è stata trovata. |
ResourceInUseException |
La tabella non si trova nello stato ACTIVE . |
Esempi
Richiesta di esempio
// This header is abbreviated. // For a sample of a complete header, see DynamoDB di basso livello 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} }
Risposta di esempio
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"}
}