# UpdateTable
**Importante**
***Esta seção refere-se à versão de API 2011-12-05, que está obsoleta e não deve ser usada para novos aplicativos.***
**Para obter a documentação da API de baixo nível atual, consulte a [Referência da API do Amazon DynamoDB](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/).**
## Descrição
Atualiza os valores de throughput provisionado da tabela especificada. Definir o throughput de uma tabela ajuda você a gerenciar a performance e é parte do recurso de throughput provisionado do DynamoDB. Para ter mais informações, consulte [Modo de capacidade provisionada do DynamoDB](provisioned-capacity-mode.md).
Os valores de throughput provisionado podem sofrer upgrade ou downgrade com base nos máximos e mínimos listados em [Cotas no Amazon DynamoDB](ServiceQuotas.md).
A tabela deverá estar no estado `ACTIVE` para que essa operação seja bem-sucedida. UpdateTable é uma operação assíncrona. Durante a execução da operação, a tabela está no estado `UPDATING`. Enquanto estiver no estado `UPDATING`, a tabela ainda terá o throughput provisionado de antes da chamada. A nova configuração de throughput provisionado entra em vigor somente quando a tabela retorna para o estado `ACTIVE` após a operação UpdateTable.
## Solicitações
### Sintaxe
```
// This header is abbreviated.
// For a sample of a complete header, see API de baixo nível do DynamoDB.
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 | Descrição | Obrigatório |
| --- | --- | --- |
| TableName | O nome da tabela a ser atualizada. Tipo: string | Sim |
| ProvisionedThroughput | Novo throughput da tabela especificada consistindo em valores para `ReadCapacityUnits` e `WriteCapacityUnits`. Consulte [Modo de capacidade provisionada do DynamoDB](provisioned-capacity-mode.md).Tipo: matriz | Sim |
| ProvisionedThroughput :ReadCapacityUnits | Define o número mínimo de `ReadCapacityUnits` consistentes consumidas por segundo para a tabela especificada antes que o DynamoDB balanceie a carga com outras operações. As operações de leitura eventualmente consistente requerem menos esforço que uma operação de leitura consistente, portanto, uma definição de 50 `ReadCapacityUnits` consistentes por segundo oferece 100 `ReadCapacityUnits` eventualmente consistentes por segundo. Tipo: número | Sim |
| ProvisionedThroughput :WriteCapacityUnits | Define o número mínimo de `WriteCapacityUnits` consumidas por segundo para a tabela especificada antes que o DynamoDB balanceie a carga com outras operações. Tipo: número | Sim |
## Respostas
### Sintaxe
```
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 | Descrição |
| --- | --- |
| CreationDateTime | Data em que a tabela foi criada.Tipo: número |
| KeySchema | A estrutura da chave primária (simples ou composta) da tabela. O par de nome-valor de `HashKeyElement` é obrigatório, e um par de nome-valor de `RangeKeyElement` é opcional (obrigatório apenas para chaves primárias compostas). O tamanho máximo da chave de hash é 2048 bytes. O tamanho máximo da chave de intervalo é 1024 bytes. Ambos os limites são aplicados separadamente (ou seja, você pode ter uma chave combinada de hash \$1 intervalo 2048 \$1 1024). Para obter mais informações sobre chaves primárias, consulte [Chave primária](HowItWorks.CoreComponents.md#HowItWorks.CoreComponents.PrimaryKey).Tipo: mapa de `HashKeyElement`, ou `HashKeyElement` e `RangeKeyElement` para uma chave primária composta. |
| ProvisionedThroughput | Configurações de throughput atuais da tabela especificada, incluindo valores para `LastIncreaseDateTime` (se aplicável), `LastDecreaseDateTime` (se aplicável), Tipo: matriz |
| TableName | O nome da tabela atualizada. Tipo: string |
| TableStatus | O estado atual da tabela (CREATING, ACTIVE, DELETING ou UPDATING), que deve ser UPDATING. Use a operação [DescribeTables](API_DescribeTables_v20111205.md) para verificar o status da tabela. Tipo: string |
## Erros especiais
****
| Erro | Descrição |
| --- | --- |
| ResourceNotFoundException | A tabela especificada não foi encontrada. |
| ResourceInUseException | A tabela não está no estado ACTIVE. |
## Exemplos
### Exemplo de solicitação
```
// This header is abbreviated.
// For a sample of a complete header, see API de baixo nível do DynamoDB.
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}
}
```
### Exemplo de resposta
```
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"}
}
```
## Ações relacionadas
+ [CreateTable](API_CreateTable_v20111205.md)
+ [DescribeTables](API_DescribeTables_v20111205.md)
+ [DeleteTable](API_DeleteTable_v20111205.md)