UpdateTable - Amazon DynamoDB
DescriçãoSolicitaçõesRespostasErros especiaisExemplosAções relacionadas

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.

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 ReadCapacityUnits e WriteCapacityUnits. Consulte Modo de capacidade provisionada do DynamoDB.

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 + intervalo 2048 + 1024). Para obter mais informações sobre chaves primárias, consulte Chave primária.

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