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.
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.
Os valores de throughput provisionado podem sofrer upgrade ou downgrade com base nos máximos e mínimos listados em Service quotas, conta e cotas de tabela no Amazon DynamoDB.
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 Tipo: matriz |
Sim |
ProvisionedThroughput
:ReadCapacityUnits |
Define o número mínimo de As operações de leitura eventualmente consistente requerem menos esforço que uma operação de leitura consistente, portanto, uma definição de 50 Tipo: número |
Sim |
ProvisionedThroughput
:WriteCapacityUnits |
Define o número mínimo de 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 Tipo: mapa de |
ProvisionedThroughput |
Configurações de throughput atuais da tabela especificada, incluindo valores para 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 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"}
}