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à. # UpdateTable **Importante** ***In questa sezione si fa riferimento alla versione API 2011-12-05, che è obsoleta e non deve essere utilizzata per le nuove applicazioni.*** **Per informazioni sull'API di basso livello corrente, consulta la [Amazon DynamoDB API Reference](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/).** ## 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à con capacità allocata di DynamoDB](provisioned-capacity-mode.md). I valori della velocità effettiva assegnata possono essere aggiornati o declassati in base ai valori massimi e minimi elencati in [Quote in Amazon DynamoDB](ServiceQuotas.md). Perché questa operazione abbia esito positivo, la tabella deve trovarsi nello stato `ACTIVE`. UpdateTable è un'operazione asincrona; durante l'esecuzione dell'operazione, la tabella si trova 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 di velocità effettiva assegnata è valida solo quando la tabella ritorna allo stato `ACTIVE`dopo l'operazione UpdateTable. ## Richieste ### Sintassi ``` // This header is abbreviated. // For a sample of a complete header, see API DynamoDB di basso livello. 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: string | Sì | | ProvisionedThroughput | La nuova velocità effettiva per la tabella specificata, costituita dai valori per `ReadCapacityUnits` e `WriteCapacityUnits`. Consultare [Modalità con capacità allocata di DynamoDB](provisioned-capacity-mode.md).Tipo: Array | Sì | | ProvisionedThroughput :ReadCapacityUnits | Imposta il numero minimo di `ReadCapacityUnits` con consistenza consumate al secondo per la tabella specificata prima che DynamoDB bilanci il carico con altre operazioni. Le operazioni di lettura a consistenza finale richiedono meno sforzo rispetto a un'operazione di lettura consistente, quindi un'impostazione di 50 `ReadCapacityUnits` consistente al secondo fornisce 100 `ReadCapacityUnits` a consistenza finale al secondo. Tipo: numero | Sì | | ProvisionedThroughput :WriteCapacityUnits | Imposta il numero minimo di `WriteCapacityUnits` consumate al secondo per la tabella specificata prima che DynamoDB bilanci il carico con altre operazioni. 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 `HashKeyElement` è obbligatoria mentre una coppia nome-valore per `RangeKeyElement` è facoltativa (richiesta solo per le chiavi primarie composite). La dimensione massima della chiave hash è 2048 byte. La dimensione massima della chiave di intervallo è 1024 byte. Entrambi i limiti sono applicati separatamente (cioè è possibile avere una chiave hash \$1 intervallo combinato, ovvero 2048\$11024). Per ulteriori informazioni sulle chiavi primarie, vedere [Chiave primaria](HowItWorks.CoreComponents.md#HowItWorks.CoreComponents.PrimaryKey).Tipo: mappa di `HashKeyElement`, oppure `HashKeyElement` e `RangeKeyElement` per una chiave primaria composita. | | ProvisionedThroughput | Impostazioni del throughput corrente per la tabella specificata, inclusi i valori per `LastIncreaseDateTime` (se applicabile), `LastDecreaseDateTime` (se applicabile), Tipo: Array | | TableName | Il nome della tabella aggiornata. Tipo: string | | TableStatus | Lo stato corrente della tabella (CREATING, ACTIVE, DELETING o UPDATING), che dovrebbe essere UPDATING. Utilizza l'operazione [DescribeTables](API_DescribeTables_v20111205.md) per controllare lo stato della tabella. Tipo: string | ## 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 API DynamoDB di basso livello. 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"} } ``` ## Operazioni correlate + [CreateTable](API_CreateTable_v20111205.md) + [DescribeTables](API_DescribeTables_v20111205.md) + [DeleteTable](API_DeleteTable_v20111205.md)