# Versão anterior da API de baixo nível do DynamoDB (5/12/2011)
Esta seção documenta as operações disponíveis na versão anterior da API de baixo nível do DynamoDB (2011-12-05). Essa versão da API de baixo nível é mantida para compatibilidade com versões anteriores de aplicativos existentes.
**Novos aplicativos devem usar a versão atual da API (2012-08-10)**. Para obter mais informações, consulte [Referência de API do DynamoDB](CurrentAPI.md).
**nota**
Recomendamos migrar suas aplicações para a versão mais recente da API (2012-08-10), pois a compatibilização com a versão anterior da API não será oferecida para novos recursos do DynamoDB.
**Topics**
+ [BatchGetItem](API_BatchGetItem_v20111205.md)
+ [BatchWriteItem](API_BatchWriteItem_v20111205.md)
+ [CreateTable](API_CreateTable_v20111205.md)
+ [DeleteItem](API_DeleteItem_v20111205.md)
+ [DeleteTable](API_DeleteTable_v20111205.md)
+ [DescribeTables](API_DescribeTables_v20111205.md)
+ [GetItem](API_GetItem_v20111205.md)
+ [ListTables](API_ListTables_v20111205.md)
+ [PutItem](API_PutItem_v20111205.md)
+ [Consulta](API_Query_v20111205.md)
+ [Verificar](API_Scan_v20111205.md)
+ [UpdateItem](API_UpdateItem_v20111205.md)
+ [UpdateTable](API_UpdateTable_v20111205.md)
# BatchGetItem
**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
A operação `BatchGetItem` retorna os atributos para vários itens de várias tabelas usando suas chaves primárias. O número máximo de itens que podem ser recuperados para uma única operação é 100. Além disso, o número de itens recuperados é restrito por um limite de tamanho de 1 MB. Se o limite de tamanho da resposta for excedido ou se um resultado parcial for retornado porque o throughput provisionado da tabela foi excedida, ou devido a uma falha de processamento interno, o DynamoDB retornará um valor de `UnprocessedKeys` para que você possa tentar novamente a operação começando com o próximo item a ser obtido. O DynamoDB ajusta automaticamente o número de itens retornados por página para impor esse limite. Por exemplo, mesmo que você solicite o retorno de 100 itens, mas cada item tem um tamanho de 50 KB, o sistema retornará 20 itens e um valor de `UnprocessedKeys` apropriado para que você possa obter a próxima página de resultados. Se você desejar, o aplicativo pode incluir sua própria lógica para reunir as páginas de resultados em um único conjunto.
Se nenhum item pôde ser processado devido a um throughput provisionado insuficiente em cada uma das tabelas envolvidas na solicitação, o DynamoDB retornará um erro `ProvisionedThroughputExceededException`.
**nota**
Por padrão, o `BatchGetItem` realiza leituras finais consistentes em cada tabela da solicitação. Você pode definir o parâmetro `ConsistentRead` como `true` para cada tabela se quiser leituras consistentes.
`BatchGetItem` busca itens em paralelo para minimizar latências de resposta.
Ao projetar sua aplicação, tenha em mente que o DynamoDB não garante como os atributos são ordenados na resposta retornada. Inclua os valores de chaves primárias no `AttributesToGet` dos itens na sua solicitação para ajudar a analisar a resposta por item.
Se os itens solicitados não existirem, nada será retornado na resposta para esses itens. Solicitações de itens inexistentes consomem as unidades mínimas de capacidade de leitura de acordo com o tipo de leitura. Para ter mais informações, consulte [Tamanhos e formatos de item do DynamoDB](CapacityUnitCalculations.md).
## 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.BatchGetItem
content-type: application/x-amz-json-1.0
{"RequestItems":
{"Table1":
{"Keys":
[{"HashKeyElement": {"S":"KeyValue1"}, "RangeKeyElement":{"N":"KeyValue2"}},
{"HashKeyElement": {"S":"KeyValue3"}, "RangeKeyElement":{"N":"KeyValue4"}},
{"HashKeyElement": {"S":"KeyValue5"}, "RangeKeyElement":{"N":"KeyValue6"}}],
"AttributesToGet":["AttributeName1", "AttributeName2", "AttributeName3"]},
"Table2":
{"Keys":
[{"HashKeyElement": {"S":"KeyValue4"}},
{"HashKeyElement": {"S":"KeyValue5"}}],
"AttributesToGet": ["AttributeName4", "AttributeName5", "AttributeName6"]
}
}
}
```
****
| Nome | Descrição | Obrigatório |
| --- | --- | --- |
| RequestItems | Um contêiner do nome da tabela e de itens correspondentes a serem obtidos por chave primária. Ao solicitar itens, cada nome de tabela pode ser invocado apenas uma vez por operação.Tipo: string Padrão: nenhum | Sim |
| Table | O nome da tabela que contém os itens a serem obtidos. A entrada é simplesmente uma string especificando uma tabela existente, sem rótulo. Tipo: string Padrão: nenhum | Sim |
| Table:Keys | Os valores de chave primária que definem os itens na tabela especificada. Para obter mais informações sobre chaves primárias, consulte [Chave primária](HowItWorks.CoreComponents.md#HowItWorks.CoreComponents.PrimaryKey). Tipo: Chaves | Sim |
| Table:AttributesToGet | Matriz de nomes de atributos dentro da tabela especificada. Se os nomes de atributos não forem especificados, todos os atributos serão retornados. Se alguns atributos não forem encontrados, eles não serão exibidos no resultado. Tipo: matriz | Não |
| Table:ConsistentRead | Se definido como `true`, uma leitura consistente será emitida; caso contrário, uma leitura eventualmente consistente será usada. Tipo: booliano | Não |
## Respostas
### Sintaxe
```
HTTP/1.1 200
x-amzn-RequestId: 8966d095-71e9-11e0-a498-71d736f27375
content-type: application/x-amz-json-1.0
content-length: 855
{"Responses":
{"Table1":
{"Items":
[{"AttributeName1": {"S":"AttributeValue"},
"AttributeName2": {"N":"AttributeValue"},
"AttributeName3": {"SS":["AttributeValue", "AttributeValue", "AttributeValue"]}
},
{"AttributeName1": {"S": "AttributeValue"},
"AttributeName2": {"S": "AttributeValue"},
"AttributeName3": {"NS": ["AttributeValue", "AttributeValue", "AttributeValue"]}
}],
"ConsumedCapacityUnits":1},
"Table2":
{"Items":
[{"AttributeName1": {"S":"AttributeValue"},
"AttributeName2": {"N":"AttributeValue"},
"AttributeName3": {"SS":["AttributeValue", "AttributeValue", "AttributeValue"]}
},
{"AttributeName1": {"S": "AttributeValue"},
"AttributeName2": {"S": "AttributeValue"},
"AttributeName3": {"NS": ["AttributeValue", "AttributeValue","AttributeValue"]}
}],
"ConsumedCapacityUnits":1}
},
"UnprocessedKeys":
{"Table3":
{"Keys":
[{"HashKeyElement": {"S":"KeyValue1"}, "RangeKeyElement":{"N":"KeyValue2"}},
{"HashKeyElement": {"S":"KeyValue3"}, "RangeKeyElement":{"N":"KeyValue4"}},
{"HashKeyElement": {"S":"KeyValue5"}, "RangeKeyElement":{"N":"KeyValue6"}}],
"AttributesToGet":["AttributeName1", "AttributeName2", "AttributeName3"]}
}
}
```
****
| Nome | Descrição |
| --- | --- |
| Responses | Nomes de tabelas e os respectivos atributos de itens das tabelas.Tipo: mapa |
| Table | O nome da tabela que contém os itens. A entrada é simplesmente uma string especificando a tabela, sem rótulo.Tipo: string |
| Items | Contêiner para nomes de atributos e valores que atendem aos parâmetros de operação.Tipo: mapa de nomes de atributo e seus tipos de dados e valores. |
| ConsumedCapacityUnits | O número de unidades de capacidade de leitura consumidas, para cada tabela. Esse valor mostra o número utilizado no throughput provisionado. As solicitações de itens não existentes consomem o mínimo de unidades de capacidade de leitura, dependendo do tipo de leitura. Para ter mais informações, consulte [Modo de capacidade provisionada do DynamoDB](provisioned-capacity-mode.md). Tipo: número |
| UnprocessedKeys | Contém uma matriz de tabelas e suas respectivas chaves que não foram processadas com a resposta atual, possivelmente devido a um limite atingido no tamanho da resposta. O valor `UnprocessedKeys` está no mesmo formato que um parâmetro `RequestItems` (portanto, ele pode ser fornecido diretamente a uma operação `BatchGetItem` posterior). Para obter mais informações, consulte o parâmetro `RequestItems` acima.Tipo: matriz |
| UnprocessedKeys: Table: Keys | Os valores de atributos de chave primária que definem os itens e os atributos associados a esses itens. Para obter mais informações sobre chaves primárias, consulte [Chave primária](HowItWorks.CoreComponents.md#HowItWorks.CoreComponents.PrimaryKey).Tipo: matriz de pares de nome-valor de atributo. |
| UnprocessedKeys: Table: AttributesToGet | Nomes de atributos na tabela especificada. Se os nomes de atributos não forem especificados, todos os atributos serão retornados. Se alguns atributos não forem encontrados, eles não serão exibidos no resultado. Tipo: Matriz de nomes de atributos. |
| UnprocessedKeys: Table: ConsistentRead | Se definido como `true`, uma leitura consistente será usada para a tabela especificada; caso contrário, uma leitura eventualmente consistente será usada. Tipo: booliano. |
## Erros especiais
****
| Erro | Descrição |
| --- | --- |
| ProvisionedThroughputExceededException | O throughput provisionado máximo permitido foi excedido. |
## Exemplos
Os exemplos a seguir mostram uma solicitação HTTP POST e uma resposta usando a operação BatchGetItem. Para obter exemplos sobre o uso do AWS SDK, consulte [Trabalhar com itens e atributos no DynamoDB](WorkingWithItems.md).
### Exemplo de solicitação
O exemplo a seguir solicita atributos de duas tabelas diferentes.
```
// 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.BatchGetItem
content-type: application/x-amz-json-1.0
content-length: 409
{"RequestItems":
{"comp1":
{"Keys":
[{"HashKeyElement":{"S":"Casey"},"RangeKeyElement":{"N":"1319509152"}},
{"HashKeyElement":{"S":"Dave"},"RangeKeyElement":{"N":"1319509155"}},
{"HashKeyElement":{"S":"Riley"},"RangeKeyElement":{"N":"1319509158"}}],
"AttributesToGet":["user","status"]},
"comp2":
{"Keys":
[{"HashKeyElement":{"S":"Julie"}},{"HashKeyElement":{"S":"Mingus"}}],
"AttributesToGet":["user","friends"]}
}
}
```
### Exemplo de resposta
O exemplo a seguir é a resposta.
```
HTTP/1.1 200 OK
x-amzn-RequestId: GTPQVRM4VJS792J1UFJTKUBVV4KQNSO5AEMVJF66Q9ASUAAJG
content-type: application/x-amz-json-1.0
content-length: 373
Date: Fri, 02 Sep 2011 23:07:39 GMT
{"Responses":
{"comp1":
{"Items":
[{"status":{"S":"online"},"user":{"S":"Casey"}},
{"status":{"S":"working"},"user":{"S":"Riley"}},
{"status":{"S":"running"},"user":{"S":"Dave"}}],
"ConsumedCapacityUnits":1.5},
"comp2":
{"Items":
[{"friends":{"SS":["Elisabeth", "Peter"]},"user":{"S":"Mingus"}},
{"friends":{"SS":["Dave", "Peter"]},"user":{"S":"Julie"}}],
"ConsumedCapacityUnits":1}
},
"UnprocessedKeys":{}
}
```
# BatchWriteItem
**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
Essa operação permite que você insira ou exclua vários itens de várias tabelas em uma única chamada.
Para fazer upload de um item, você pode usar `PutItem` e, para excluir um item, você pode usar `DeleteItem`. No entanto, quando você deseja enviar ou excluir grandes quantidades de dados, por exemplo, carregar grandes quantidades de dados do Amazon EMR (Amazon EMR) ou migrar dados de outro banco de dados para o DynamoDB, `BatchWriteItem` oferece uma alternativa eficiente.
Se você usa linguagens como o Java, pode usar threads para carregar itens em paralelo. Isso adiciona complexidade à sua aplicação para manipular os threads. Outras linguagens não oferecem suporte para threads. Por exemplo, se você estiver usando o PHP, deverá carregar ou excluir itens um de cada vez. Em ambas as situações, `BatchWriteItem` fornece uma alternativa na qual as operações de inserção e exclusão especificadas são processadas em paralelo, proporcionando a você o poder da abordagem de pools de threads sem a necessidade de introduzir complexidade no seu aplicativo.
Observe que cada operação individual de inserção e exclusão especificada em uma operação `BatchWriteItem` tem o mesmo custo em termos de unidades de capacidade consumidas. No entanto, como `BatchWriteItem` realiza as operações especificadas em paralelo, a latência é menor. Operações de exclusão em itens inexistentes consomem 1 unidade de capacidade de gravação. Para obter mais informações sobre unidades de capacidade consumidas, consulte [Trabalhar com tabelas e dados no DynamoDB](WorkingWithTables.md).
Ao usar `BatchWriteItem`, observe as seguintes limitações:
+ **Operações máximas em uma única solicitação**: é possível especificar um total de até 25 operações de inserção ou exclusão. No entanto, o tamanho total da solicitação não pode exceder 1 MB (a carga útil HTTP).
+ A operação `BatchWriteItem` só pode ser usada para inserir e excluir itens. Ela não pode ser usada para atualizar itens existentes.
+ **Não é uma operação atômica**: operações individuais especificadas em uma `BatchWriteItem` são atômicas. No entanto, `BatchWriteItem` como um todo é uma operação de "melhor esforço", e não uma operação atômica. Ou seja, em uma solicitação `BatchWriteItem`, algumas operações podem ser bem-sucedidas, enquanto outras podem falhar. As operações com falha são retornadas em um campo `UnprocessedItems` na resposta. Algumas dessas falhas podem ocorrer porque você excedeu o throughput provisionado configurado para a tabela ou devido a uma falha transitória, como um erro de rede. Você pode investigar e, opcionalmente, reenviar as solicitações. Em geral, você chama `BatchWriteItem` em um loop e em cada verificação de iteração em busca de itens não processados e envia uma nova solicitação `BatchWriteItem` com esses itens não processados.
+ **Não retorna itens**: `BatchWriteItem` foi projetada para carregar grandes quantidades de dados de forma eficiente. Ela não oferece algumas das sofisticações oferecidas por `PutItem` e `DeleteItem`. Por exemplo, `DeleteItem` oferece suporte ao campo `ReturnValues` no corpo da solicitação para solicitar o item excluído na resposta. A operação `BatchWriteItem` não retorna itens na resposta.
+ Ao contrário de `PutItem` e `DeleteItem`, `BatchWriteItem` não permite que você especifique condições em solicitações de gravação individuais na operação.
+ Valores de atributos não devem ser nulos, atributos do tipo string e binários devem ter comprimentos maiores que zero, e atributos de tipo definido não podem permanecer vazios. Solicitações que têm valores vazios serão rejeitadas com uma `ValidationException`.
O DynamoDB rejeitará a operação de gravação em lote inteira em qualquer uma das seguintes situações:
+ Se uma ou mais tabelas especificadas na solicitação `BatchWriteItem` não existir.
+ Se atributos de chaves primárias especificados em um item na solicitação não corresponderem ao esquema de chave primária da tabela correspondente.
+ Se você tentar realizar várias operações no mesmo item na mesma solicitação `BatchWriteItem`. Por exemplo, não é possível inserir e excluir o mesmo item na mesma solicitação `BatchWriteItem`.
+ Se o tamanho total da solicitação exceder o limite de 1 MB (a carga útil HTTP).
+ Se qualquer item individual em um lote exceder o limite de tamanho de item de 64 KB.
## 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.BatchGetItem
content-type: application/x-amz-json-1.0
{
"RequestItems" : RequestItems
}
RequestItems
{
"TableName1" : [ Request, Request, ... ],
"TableName2" : [ Request, Request, ... ],
...
}
Request ::=
PutRequest | DeleteRequest
PutRequest ::=
{
"PutRequest" : {
"Item" : {
"Attribute-Name1" : Attribute-Value,
"Attribute-Name2" : Attribute-Value,
...
}
}
}
DeleteRequest ::=
{
"DeleteRequest" : {
"Key" : PrimaryKey-Value
}
}
PrimaryKey-Value ::= HashTypePK | HashAndRangeTypePK
HashTypePK ::=
{
"HashKeyElement" : Attribute-Value
}
HashAndRangeTypePK
{
"HashKeyElement" : Attribute-Value,
"RangeKeyElement" : Attribute-Value,
}
Attribute-Value ::= String | Numeric| Binary | StringSet | NumericSet | BinarySet
Numeric ::=
{
"N": "Number"
}
String ::=
{
"S": "String"
}
Binary ::=
{
"B": "Base64 encoded binary data"
}
StringSet ::=
{
"SS": [ "String1", "String2", ... ]
}
NumberSet ::=
{
"NS": [ "Number1", "Number2", ... ]
}
BinarySet ::=
{
"BS": [ "Binary1", "Binary2", ... ]
}
```
No corpo da solicitação, o objeto JSON `RequestItems` descreve as operações que você deseja realizar. As operações são agrupadas por tabelas. É possível usar `BatchWriteItem` para atualizar ou excluir vários itens em várias tabelas. Para cada solicitação de gravação específica, você deve identificar o tipo de solicitação (`PutItem`, `DeleteItem`) seguido de informações detalhadas sobre a operação.
+ Para uma `PutRequest`, você fornece o item, ou seja, uma lista de atributos e seus valores.
+ Para uma `DeleteRequest`, você fornece o nome e o valor da chave primária.
## Respostas
### Sintaxe
Veja a seguir a sintaxe do corpo JSON retornado na resposta.
```
{
"Responses" : ConsumedCapacityUnitsByTable
"UnprocessedItems" : RequestItems
}
ConsumedCapacityUnitsByTable
{
"TableName1" : { "ConsumedCapacityUnits", : NumericValue },
"TableName2" : { "ConsumedCapacityUnits", : NumericValue },
...
}
RequestItems
This syntax is identical to the one described in the JSON syntax in the request.
```
## Erros especiais
Não há erros específicos para esta operação.
## Exemplos
O exemplo a seguir mostra uma solicitação HTTP POST e a resposta de uma operação `BatchWriteItem`. A solicitação especifica as seguintes operações nas tabelas Reply e Thread:
+ Inserir um item e excluí-lo da tabela Reply
+ Inserir um item na tabela Thread
Para obter exemplos sobre o uso do AWS SDK, consulte [Trabalhar com itens e atributos no DynamoDB](WorkingWithItems.md).
### 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.BatchGetItem
content-type: application/x-amz-json-1.0
{
"RequestItems":{
"Reply":[
{
"PutRequest":{
"Item":{
"ReplyDateTime":{
"S":"2012-04-03T11:04:47.034Z"
},
"Id":{
"S":"DynamoDB#DynamoDB Thread 5"
}
}
}
},
{
"DeleteRequest":{
"Key":{
"HashKeyElement":{
"S":"DynamoDB#DynamoDB Thread 4"
},
"RangeKeyElement":{
"S":"oops - accidental row"
}
}
}
}
],
"Thread":[
{
"PutRequest":{
"Item":{
"ForumName":{
"S":"DynamoDB"
},
"Subject":{
"S":"DynamoDB Thread 5"
}
}
}
}
]
}
}
```
### Exemplo de resposta
A seguinte resposta de exemplo mostra uma operação de inserção bem-sucedida nas tabelas Thread e Reply e uma operação de exclusão com falha na tabela Reply (por motivos como a limitação causada quando você excede o throughput provisionado na tabela). Observe o seguinte na resposta JSON:
+ O objeto `Responses` mostra que uma unidade de capacidade foi consumida em ambas as tabelas `Thread` e `Reply` como resultado da operação bem-sucedida em cada uma dessas tabelas.
+ O objeto `UnprocessedItems` mostra a operação de exclusão que falhou na tabela `Reply`. Em seguida, você pode emitir uma nova chamada `BatchWriteItem` para solucionar essas solicitações não processadas.
```
HTTP/1.1 200 OK
x-amzn-RequestId: G8M9ANLOE5QA26AEUHJKJE0ASBVV4KQNSO5AEMVJF66Q9ASUAAJG
Content-Type: application/x-amz-json-1.0
Content-Length: 536
Date: Thu, 05 Apr 2012 18:22:09 GMT
{
"Responses":{
"Thread":{
"ConsumedCapacityUnits":1.0
},
"Reply":{
"ConsumedCapacityUnits":1.0
}
},
"UnprocessedItems":{
"Reply":[
{
"DeleteRequest":{
"Key":{
"HashKeyElement":{
"S":"DynamoDB#DynamoDB Thread 4"
},
"RangeKeyElement":{
"S":"oops - accidental row"
}
}
}
}
]
}
}
```
# CreateTable
**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
A operação `CreateTable` adiciona uma nova tabela à sua conta.
O nome da tabela deve ser exclusivo entre aqueles associados à conta da AWS que emite a solicitação e à região da AWS que recebe a solicitação (como dynamodb.us-west-2.amazonaws.com). Cada endpoint do DynamoDB é totalmente independente. Por exemplo, se você tiver duas tabelas chamadas “MyTable”, uma em dynamodb.us-west-2.amazonaws.com e outra em dynamodb.us-west-1.amazonaws.com, elas serão completamente independentes e não compartilharão nenhum dado.
A operação `CreateTable` desencadeia um fluxo de trabalho assíncrono para começar a criação da tabela. O DynamoDB retorna imediatamente o estado da tabela (`CREATING`) até que ela atinja o estado `ACTIVE`. Quando a tabela estiver no estado `ACTIVE`, você poderá realizar as operações de plano de dados.
Use a operação [DescribeTables](API_DescribeTables_v20111205.md) para verificar o status da tabela.
## 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.CreateTable
content-type: application/x-amz-json-1.0
{"TableName":"Table1",
"KeySchema":
{"HashKeyElement":{"AttributeName":"AttributeName1","AttributeType":"S"},
"RangeKeyElement":{"AttributeName":"AttributeName2","AttributeType":"N"}},
"ProvisionedThroughput":{"ReadCapacityUnits":5,"WriteCapacityUnits":10}
}
```
****
| Nome | Descrição | Obrigatório |
| --- | --- | --- |
| TableName | O nome da tabela a ser criada.Os caracteres permitidos são a-z, A-Z, 0-9, '\$1' (sublinhado), '-' (traço) e '.' (ponto). Os nomes podem ter de 3 a 255 caracteres. Tipo: string | Sim |
| 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). Para obter mais informações sobre chaves primárias, consulte [Chave primária](HowItWorks.CoreComponents.md#HowItWorks.CoreComponents.PrimaryKey).Nomes de elementos de chave primária podem ter entre 1 e 255 caracteres de comprimento, sem restrições de caracteres. Os valores possíveis para AttributeType são "S" (string), "N" (numérico) ou "B" (binário).Tipo: mapa de `HashKeyElement`, ou `HashKeyElement` e `RangeKeyElement` para uma chave primária composta. | Sim |
| ProvisionedThroughput | Novo throughput da tabela especificada consistindo em valores para ReadCapacityUnits e WriteCapacityUnits. Para obter detalhes, consulte [Modo de capacidade provisionada do DynamoDB](provisioned-capacity-mode.md). Para conhecer os valores máximos/mínimos atuais, consulte [Cotas no Amazon DynamoDB](ServiceQuotas.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/x-amz-json-1.0
content-length: 311
Date: Tue, 12 Jul 2011 21:31:03 GMT
{"TableDescription":
{"CreationDateTime":1.310506263362E9,
"KeySchema":
{"HashKeyElement":{"AttributeName":"AttributeName1","AttributeType":"S"},
"RangeKeyElement":{"AttributeName":"AttributeName2","AttributeType":"N"}},
"ProvisionedThroughput":{"ReadCapacityUnits":5,"WriteCapacityUnits":10},
"TableName":"Table1",
"TableStatus":"CREATING"
}
}
```
****
| Nome | Descrição |
| --- | --- |
| TableDescription | Um contêiner para as propriedades da tabela. |
| CreationDateTime | Data em que a tabela foi criada, no formato de [tempo epoch UNIX](http://www.epochconverter.com/).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). 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 | O throughput da tabela especificada consistindo em valores para `ReadCapacityUnits` e `WriteCapacityUnits`. Consulte [Modo de capacidade provisionada do DynamoDB](provisioned-capacity-mode.md). Tipo: matriz |
| ProvisionedThroughput :ReadCapacityUnits | O número mínimo de `ReadCapacityUnits` consumidas por segundo antes que o DynamoDB balanceie a carga com outras operações.Tipo: número |
| ProvisionedThroughput :WriteCapacityUnits | O número mínimo de `ReadCapacityUnits` consumidas por segundo antes que `WriteCapacityUnits` balanceie a carga com outras operações.Tipo: número |
| TableName | O nome da tabela criada. Tipo: string |
| TableStatus | O estado atual da tabela (`CREATING`). Quando a tabela estiver no estado `ACTIVE`, você poderá inserir dados nela.Use a API [DescribeTables](API_DescribeTables_v20111205.md) para verificar o status da tabela.Tipo: string |
## Erros especiais
****
| Erro | Descrição |
| --- | --- |
| ResourceInUseException | Tentativa de recriar uma tabela já existente. |
| LimitExceededException | O número de solicitações simultâneas de tabela (número cumulativo de tabelas no estado `CREATING`, `DELETING` ou `UPDATING`) excede o máximo permitido. Para conhecer os valores máximos/mínimos atuais, consulte [Cotas no Amazon DynamoDB](ServiceQuotas.md). . |
## Exemplos
O exemplo a seguir cria uma tabela com uma chave primária composta que contém uma string e um número. Para obter exemplos sobre o uso do AWS SDK, consulte [Trabalhar com tabelas e dados no DynamoDB](WorkingWithTables.md).
### 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.CreateTable
content-type: application/x-amz-json-1.0
{"TableName":"comp-table",
"KeySchema":
{"HashKeyElement":{"AttributeName":"user","AttributeType":"S"},
"RangeKeyElement":{"AttributeName":"time","AttributeType":"N"}},
"ProvisionedThroughput":{"ReadCapacityUnits":5,"WriteCapacityUnits":10}
}
```
### Exemplo de resposta
```
HTTP/1.1 200 OK
x-amzn-RequestId: CSOC7TJPLR0OOKIRLGOHVAICUFVV4KQNSO5AEMVJF66Q9ASUAAJG
content-type: application/x-amz-json-1.0
content-length: 311
Date: Tue, 12 Jul 2011 21:31:03 GMT
{"TableDescription":
{"CreationDateTime":1.310506263362E9,
"KeySchema":
{"HashKeyElement":{"AttributeName":"user","AttributeType":"S"},
"RangeKeyElement":{"AttributeName":"time","AttributeType":"N"}},
"ProvisionedThroughput":{"ReadCapacityUnits":5,"WriteCapacityUnits":10},
"TableName":"comp-table",
"TableStatus":"CREATING"
}
}
```
## Ações relacionadas
+ [DescribeTables](API_DescribeTables_v20111205.md)
+ [DeleteTable](API_DeleteTable_v20111205.md)
# DeleteItem
**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
Exclui um item único em uma tabela por meio de uma chave primária Você pode executar uma operação de exclusão condicional que exclui o item, se ele existir, ou se ele tiver um valor de atributo esperado.
**nota**
Se você especificar `DeleteItem` sem atributos ou valores, todos os atributos do item serão excluídos.
A não ser que você especifique as condições, `DeleteItem` é uma operação idempotente; executá-la várias vezes no mesmo item ou atributo *não* resultará em uma resposta de erro.
As exclusões condicionais são úteis para excluir somente itens e atributos se condições específicas forem atendidas. Se as condições forem atendidas, o DynamoDB executará a exclusão. Caso contrário, o item não é excluído.
Você pode executar a verificação condicional esperada em um atributo por operação.
## 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.DeleteItem
content-type: application/x-amz-json-1.0
{"TableName":"Table1",
"Key":
{"HashKeyElement":{"S":"AttributeValue1"},"RangeKeyElement":{"N":"AttributeValue2"}},
"Expected":{"AttributeName3":{"Value":{"S":"AttributeValue3"}}},
"ReturnValues":"ALL_OLD"}
}
```
****
| Nome | Descrição | Obrigatório |
| --- | --- | --- |
| TableName | O nome da tabela que contém o item a ser excluído. Tipo: string | Sim |
| Key | A chave primária que define o item. Para obter mais informações sobre chaves primárias, consulte [Chave primária](HowItWorks.CoreComponents.md#HowItWorks.CoreComponents.PrimaryKey).Tipo: mapa de `HashKeyElement` para seu valor e `RangeKeyElement` para seu valor. | Sim |
| Expected | Designa um atributo para uma exclusão condicional. O parâmetro `Expected` permite que você forneça um nome de atributo e se o DynamoDB deve ou não verificar se o atributo tem um valor específico antes de excluí-lo.Tipo: mapa de nomes de atributo. | Não |
| Expected:AttributeName | O nome do atributo da operação put condicional. Tipo: string | Não |
| Expected:AttributeName: ExpectedAttributeValue | Use esse parâmetro para especificar se o valor já existe ou não para o par de nome-valor do atributo. A notação JSON a seguir exclui o item se o atributo "Cor" não existir para esse item:"Expected" :
{"Color":{"Exists":false}}
A notação JSON a seguir verifica se o atributo com o nome "Cor" tem um valor existente "Amarelo" antes de excluir o item: "Expected" :
{"Color":{"Exists":true},{"Value":{"S":"Yellow"}}}
Por padrão, se você usar o parâmetro `Expected` e fornecer um `Value`, o DynamoDB presumirá que o atributo existe e tem um valor atual a ser substituído. Portanto, você não precisa especificar `{"Exists":true}`, pois ele está implícito. Você pode reduzir a solicitação para:"Expected" :
{"Color":{"Value":{"S":"Yellow"}}}
Se você especificar `{"Exists":true}` sem um valor de atributo para verificar, o DynamoDB retornará um erro. | Não |
| ReturnValues | Use este parâmetro se você deseja obter os pares de nome-valor de atributo antes que eles sejam excluídos. Os possíveis valores de parâmetro são `NONE` (padrão) ou `ALL_OLD`. Se `ALL_OLD` for especificado, o conteúdo do item antigo será retornado. Se esse parâmetro não for fornecido ou for `NONE`, nada será retornado.Tipo: string | Não |
## Respostas
### Sintaxe
```
HTTP/1.1 200 OK
x-amzn-RequestId: CSOC7TJPLR0OOKIRLGOHVAICUFVV4KQNSO5AEMVJF66Q9ASUAAJG
content-type: application/x-amz-json-1.0
content-length: 353
Date: Tue, 12 Jul 2011 21:31:03 GMT
{"Attributes":
{"AttributeName3":{"SS":["AttributeValue3","AttributeValue4","AttributeValue5"]},
"AttributeName2":{"S":"AttributeValue2"},
"AttributeName1":{"N":"AttributeValue1"}
},
"ConsumedCapacityUnits":1
}
```
****
| Nome | Descrição |
| --- | --- |
| Attributes | Se o parâmetro `ReturnValues` for fornecido como `ALL_OLD` na solicitação, o DynamoDB retornará uma matriz de pares de nome-valor de atributo (basicamente, o item excluído). Caso contrário, a resposta conterá um conjunto vazio. Tipo: matriz de pares de nome-valor de atributo. |
| ConsumedCapacityUnits | O número de unidades de capacidade de gravação consumidas pela operação. Esse valor mostra o número utilizado no throughput provisionado. As solicitações de exclusão em itens não existentes consomem 1 unidade de capacidade de gravação. Para ter mais informações, consulte [Modo de capacidade provisionada do DynamoDB](provisioned-capacity-mode.md). Tipo: número |
## Erros especiais
****
| Erro | Descrição |
| --- | --- |
| ConditionalCheckFailedException | Falha na verificação condicional. Um valor de atributo esperado não foi encontrado. |
## 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.DeleteItem
content-type: application/x-amz-json-1.0
{"TableName":"comp-table",
"Key":
{"HashKeyElement":{"S":"Mingus"},"RangeKeyElement":{"N":"200"}},
"Expected":
{"status":{"Value":{"S":"shopping"}}},
"ReturnValues":"ALL_OLD"
}
```
### Exemplo de resposta
```
HTTP/1.1 200 OK
x-amzn-RequestId: U9809LI6BBFJA5N2R0TB0P017JVV4KQNSO5AEMVJF66Q9ASUAAJG
content-type: application/x-amz-json-1.0
content-length: 353
Date: Tue, 12 Jul 2011 22:31:23 GMT
{"Attributes":
{"friends":{"SS":["Dooley","Ben","Daisy"]},
"status":{"S":"shopping"},
"time":{"N":"200"},
"user":{"S":"Mingus"}
},
"ConsumedCapacityUnits":1
}
```
## Ações relacionadas
+ [PutItem](API_PutItem_v20111205.md)
# DeleteTable
**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
A operação `DeleteTable` exclui uma tabela e todos os seus itens. Após uma solicitação `DeleteTable`, a tabela especificada permanece no estado `DELETING` até que o DynamoDB conclua a exclusão. Se a tabela estiver no estado `ACTIVE`, será possível excluí-la. Se uma tabela estiver no estado `CREATING` ou `UPDATING`, o DynamoDB retornará um erro `ResourceInUseException`. Se a tabela especificada não existir, o DynamoDB retornará um `ResourceNotFoundException`. Se a tabela já estiver no estado `DELETING`, nenhum erro será retornado.
**nota**
O DynamoDB pode continuar a aceitar solicitações de operação no plano de dados, como `GetItem` e `PutItem`, em uma tabela no estado `DELETING` até que a exclusão da tabela seja concluída.
As tabelas devem ser exclusivas entre aquelas associadas à conta da AWS que emite a solicitação e à região da AWS que recebe a solicitação (como dynamodb.us-west-1.amazonaws.com). Cada endpoint do DynamoDB é totalmente independente. Por exemplo, se você tiver duas tabelas chamadas “MyTable”, uma em dynamodb.us-west-2.amazonaws.com e outra em dynamodb.us-west-1.amazonaws.com, elas serão completamente independentes e não compartilharão nenhum dado. Excluir uma não excluirá a outra.
Use a operação [DescribeTables](API_DescribeTables_v20111205.md) para verificar o status da tabela.
## 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.DeleteTable
content-type: application/x-amz-json-1.0
{"TableName":"Table1"}
```
****
| Nome | Descrição | Obrigatório |
| --- | --- | --- |
| TableName | O nome da tabela a ser excluída. Tipo: string | Sim |
## Respostas
### Sintaxe
```
HTTP/1.1 200 OK
x-amzn-RequestId: 4HONCKIVH1BFUDQ1U68CTG3N27VV4KQNSO5AEMVJF66Q9ASUAAJG
content-type: application/x-amz-json-1.0
content-length: 311
Date: Sun, 14 Aug 2011 22:56:22 GMT
{"TableDescription":
{"CreationDateTime":1.313362508446E9,
"KeySchema":
{"HashKeyElement":{"AttributeName":"user","AttributeType":"S"},
"RangeKeyElement":{"AttributeName":"time","AttributeType":"N"}},
"ProvisionedThroughput":{"ReadCapacityUnits":10,"WriteCapacityUnits":10},
"TableName":"Table1",
"TableStatus":"DELETING"
}
}
```
****
| Nome | Descrição |
| --- | --- |
| TableDescription | Um contêiner para as propriedades da tabela. |
| 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). 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 | O throughput da tabela especificada consistindo em valores para ReadCapacityUnits e WriteCapacityUnits. Consulte [Modo de capacidade provisionada do DynamoDB](provisioned-capacity-mode.md). |
| ProvisionedThroughput: ReadCapacityUnits | O número mínimo de `ReadCapacityUnits` consumidas por segundo para a tabela especificada antes que o DynamoDB balanceie a carga com outras operações. Tipo: número |
| ProvisionedThroughput: WriteCapacityUnits | 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 |
| TableName | O nome da tabela excluída. Tipo: string |
| TableStatus | O estado atual da tabela (DELETING). Assim que a tabela é excluída, as solicitações subsequentes para a tabela retornam resource not found. Use a operação [DescribeTables](API_DescribeTables_v20111205.md) para verificar o status da tabela. Tipo: string |
## Erros especiais
****
| Erro | Descrição |
| --- | --- |
| ResourceInUseException | A tabela está no estado CREATING ou UPDATING e não pode ser excluída. |
## 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.DeleteTable
content-type: application/x-amz-json-1.0
content-length: 40
{"TableName":"favorite-movies-table"}
```
### Exemplo de resposta
```
HTTP/1.1 200 OK
x-amzn-RequestId: 4HONCKIVH1BFUDQ1U68CTG3N27VV4KQNSO5AEMVJF66Q9ASUAAJG
content-type: application/x-amz-json-1.0
content-length: 160
Date: Sun, 14 Aug 2011 17:20:03 GMT
{"TableDescription":
{"CreationDateTime":1.313362508446E9,
"KeySchema":
{"HashKeyElement":{"AttributeName":"name","AttributeType":"S"}},
"TableName":"favorite-movies-table",
"TableStatus":"DELETING"
}
```
## Ações relacionadas
+ [CreateTable](API_CreateTable_v20111205.md)
+ [DescribeTables](API_DescribeTables_v20111205.md)
# DescribeTables
**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
Retorna informações sobre a tabela, incluindo seu status atual, o esquema de chave primária e quando a tabela foi criada. Os resultados de DescribeTable são finais consistentes. Se você usar DescribeTable muito cedo no processo de criação de uma tabela, o DynamoDB retornará um `ResourceNotFoundException`. Se você usar DescribeTable muito cedo no processo de atualizar uma tabela, os novos valores talvez não estejam imediatamente disponíveis.
## 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.DescribeTable
content-type: application/x-amz-json-1.0
{"TableName":"Table1"}
```
****
| Nome | Descrição | Obrigatório |
| --- | --- | --- |
| TableName | O nome da tabela a ser descrita. Tipo: string | Sim |
## Respostas
### Sintaxe
```
HTTP/1.1 200
x-amzn-RequestId: 8966d095-71e9-11e0-a498-71d736f27375
content-type: application/x-amz-json-1.0
Content-Length: 543
{"Table":
{"CreationDateTime":1.309988345372E9,
ItemCount:1,
"KeySchema":
{"HashKeyElement":{"AttributeName":"AttributeName1","AttributeType":"S"},
"RangeKeyElement":{"AttributeName":"AttributeName2","AttributeType":"N"}},
"ProvisionedThroughput":{"LastIncreaseDateTime": Date, "LastDecreaseDateTime": Date, "ReadCapacityUnits":10,"WriteCapacityUnits":10},
"TableName":"Table1",
"TableSizeBytes":1,
"TableStatus":"ACTIVE"
}
}
```
****
| Nome | Descrição |
| --- | --- |
| Table | O contêiner da tabela que está sendo descrita. Tipo: string |
| CreationDateTime | Data em que a tabela foi criada, no formato de [tempo epoch UNIX](http://www.epochconverter.com/). |
| ItemCount | Número de itens na tabela especificada. O DynamoDB atualiza esse valor aproximadamente a cada seis horas. Alterações recentes podem não ser refletidas nesse valor. 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). |
| ProvisionedThroughput | O throughput da tabela especificada, consistindo em valores para LastIncreaseDateTime (se aplicável), LastDecreaseDateTime (se aplicável), ReadCapacityUnits e WriteCapacityUnits. Se o throughput da tabela nunca tiver sido aumentada ou diminuída, o DynamoDB não retornará valores para esses elementos. Consulte [Modo de capacidade provisionada do DynamoDB](provisioned-capacity-mode.md).Tipo: matriz |
| TableName | O nome da tabela solicitada. Tipo: string |
| TableSizeBytes | O tamanho total da tabela especificada, em bytes. O DynamoDB atualiza esse valor aproximadamente a cada seis horas. Alterações recentes podem não ser refletidas nesse valor. Tipo: número |
| TableStatus | O estado atual da tabela (CREATING, ACTIVE, DELETING ou UPDATING). Quando a tabela estiver no estado ACTIVE, você poderá adicionar dados. |
## Erros especiais
Nenhum erro é específico dessa operação.
## Exemplos
Os exemplos a seguir mostram uma solicitação HTTP POST e uma resposta usando a operação DescribeTable para uma tabela chamada "comp-table". A tabela tem uma chave primária composta.
### 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.DescribeTable
content-type: application/x-amz-json-1.0
{"TableName":"users"}
```
### Exemplo de resposta
```
HTTP/1.1 200
x-amzn-RequestId: 8966d095-71e9-11e0-a498-71d736f27375
content-type: application/x-amz-json-1.0
content-length: 543
{"Table":
{"CreationDateTime":1.309988345372E9,
"ItemCount":23,
"KeySchema":
{"HashKeyElement":{"AttributeName":"user","AttributeType":"S"},
"RangeKeyElement":{"AttributeName":"time","AttributeType":"N"}},
"ProvisionedThroughput":{"LastIncreaseDateTime": 1.309988345384E9, "ReadCapacityUnits":10,"WriteCapacityUnits":10},
"TableName":"users",
"TableSizeBytes":949,
"TableStatus":"ACTIVE"
}
}
```
## Ações relacionadas
+ [CreateTable](API_CreateTable_v20111205.md)
+ [DeleteTable](API_DeleteTable_v20111205.md)
+ [ListTables](API_ListTables_v20111205.md)
# GetItem
**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
A operação `GetItem` retorna um conjunto de `Attributes` para um item que corresponde à chave primária. Se não houver item correspondente, `GetItem` não retornará quaisquer dados.
A operação `GetItem` fornece uma leitura final consistente por padrão. Caso a aplicação não aceite leituras finais consistentes, use `ConsistentRead`. Embora essa operação possa demorar mais do que uma leitura padrão, ela sempre retorna o último valor atualizado. Para ter mais informações, consulte [Consistência de leitura do DynamoDB](HowItWorks.ReadConsistency.md).
## 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.GetItem
content-type: application/x-amz-json-1.0
{"TableName":"Table1",
"Key":
{"HashKeyElement": {"S":"AttributeValue1"},
"RangeKeyElement": {"N":"AttributeValue2"}
},
"AttributesToGet":["AttributeName3","AttributeName4"],
"ConsistentRead":Boolean
}
```
****
| Nome | Descrição | Obrigatório |
| --- | --- | --- |
| TableName | O nome da tabela que contém o item solicitado. Tipo: string | Sim |
| Key | Os valores de chave primária que definem o item. Para obter mais informações sobre chaves primárias, consulte [Chave primária](HowItWorks.CoreComponents.md#HowItWorks.CoreComponents.PrimaryKey).Tipo: mapa de `HashKeyElement` para seu valor e `RangeKeyElement` para seu valor. | Sim |
| AttributesToGet | Matriz de nomes de atributos. Se os nomes de atributos não forem especificados, todos os atributos serão retornados. Se alguns atributos não forem encontrados, eles não serão exibidos no resultado.Tipo: matriz | Não |
| ConsistentRead | Se definido como `true`, uma leitura consistente será emitida; caso contrário, uma leitura eventualmente consistente será usada.Tipo: booliano | Não |
## Respostas
### Sintaxe
```
HTTP/1.1 200
x-amzn-RequestId: 8966d095-71e9-11e0-a498-71d736f27375
content-type: application/x-amz-json-1.0
content-length: 144
{"Item":{
"AttributeName3":{"S":"AttributeValue3"},
"AttributeName4":{"N":"AttributeValue4"},
"AttributeName5":{"B":"dmFsdWU="}
},
"ConsumedCapacityUnits": 0.5
}
```
****
| Nome | Descrição |
| --- | --- |
| Item | Contém os atributos solicitados.Tipo: mapa de pares de nome-valor de atributo. |
| ConsumedCapacityUnits | O número de unidades de capacidade de leitura consumidas pela operação. Esse valor mostra o número utilizado no throughput provisionado. As solicitações de itens não existentes consomem o mínimo de unidades de capacidade de leitura, dependendo do tipo de leitura. Para ter mais informações, consulte [Modo de capacidade provisionada do DynamoDB](provisioned-capacity-mode.md). Tipo: número |
## Erros especiais
Não há erros específicos para esta operação.
## Exemplos
Para obter exemplos sobre o uso do AWS SDK, consulte [Trabalhar com itens e atributos no DynamoDB](WorkingWithItems.md).
### 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.GetItem
content-type: application/x-amz-json-1.0
{"TableName":"comptable",
"Key":
{"HashKeyElement":{"S":"Julie"},
"RangeKeyElement":{"N":"1307654345"}},
"AttributesToGet":["status","friends"],
"ConsistentRead":true
}
```
### Exemplo de resposta
Observe que o valor ConsumedCapacityUnits é 1, pois o parâmetro opcional `ConsistentRead` está definido como `true`. Se `ConsistentRead` estiver definido como `false` (ou não especificado) para a mesma solicitação, a resposta é eventualmente consistente e o valor ConsumedCapacityUnits seria 0,5.
```
HTTP/1.1 200
x-amzn-RequestId: 8966d095-71e9-11e0-a498-71d736f27375
content-type: application/x-amz-json-1.0
content-length: 72
{"Item":
{"friends":{"SS":["Lynda, Aaron"]},
"status":{"S":"online"}
},
"ConsumedCapacityUnits": 1
}
```
# ListTables
**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
Retorna uma matriz de todas as tabelas associadas à conta e ao endpoint atuais.
Cada endpoint do DynamoDB é totalmente independente. Por exemplo, se você tiver duas tabelas chamadas “MyTable”, uma em dynamodb.us-west-2.amazonaws.com e outra em dynamodb.us-east-1.amazonaws.com, elas serão completamente independentes e não compartilharão nenhum dado. A operação ListTables retorna todos os nomes de tabelas associados à conta que está fazendo a solicitação, para o endpoint que recebe a solicitação.
## 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.ListTables
content-type: application/x-amz-json-1.0
{"ExclusiveStartTableName":"Table1","Limit":3}
```
Por padrão, a operação ListTables solicita todos os nomes de tabelas associados à conta que está fazendo a solicitação, para o endpoint que recebe a solicitação.
****
| Nome | Descrição | Obrigatório |
| --- | --- | --- |
| Limit | Um número de nomes de tabela máximos a serem retornados. Tipo: número inteiro | Não |
| ExclusiveStartTableName | O nome da tabela que inicia a lista. Se você já executou uma operação ListTables e recebeu um valor `LastEvaluatedTableName` na resposta, use esse valor aqui para continuar a lista. Tipo: string | Não |
## Respostas
### Sintaxe
```
HTTP/1.1 200 OK
x-amzn-RequestId: S1LEK2DPQP8OJNHVHL8OU2M7KRVV4KQNSO5AEMVJF66Q9ASUAAJG
content-type: application/x-amz-json-1.0
content-length: 81
Date: Fri, 21 Oct 2011 20:35:38 GMT
{"TableNames":["Table1","Table2","Table3"], "LastEvaluatedTableName":"Table3"}
```
****
| Nome | Descrição |
| --- | --- |
| TableNames | Os nomes das tabelas associadas à conta atual no endpoint atual. Tipo: matriz |
| LastEvaluatedTableName | O nome da última tabela na lista atual, somente se algumas tabelas da conta e do endpoint não tiverem sido retornadas. Esse valor não existirá em uma resposta se todos os nomes de tabelas já tiverem sido retornados. Use esse valor como o `ExclusiveStartTableName` em uma nova solicitação para continuar a lista até que todos os nomes das tabelas sejam retornados. Tipo: string |
## Erros especiais
Nenhum erro é específico dessa operação.
## Exemplos
Os exemplos a seguir mostram uma solicitação e uma resposta HTTP POST usando a operação ListTables.
### 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.ListTables
content-type: application/x-amz-json-1.0
{"ExclusiveStartTableName":"comp2","Limit":3}
```
### Exemplo de resposta
```
HTTP/1.1 200 OK
x-amzn-RequestId: S1LEK2DPQP8OJNHVHL8OU2M7KRVV4KQNSO5AEMVJF66Q9ASUAAJG
content-type: application/x-amz-json-1.0
content-length: 81
Date: Fri, 21 Oct 2011 20:35:38 GMT
{"LastEvaluatedTableName":"comp5","TableNames":["comp3","comp4","comp5"]}
```
## Ações relacionadas
+ [DescribeTables](API_DescribeTables_v20111205.md)
+ [CreateTable](API_CreateTable_v20111205.md)
+ [DeleteTable](API_DeleteTable_v20111205.md)
# PutItem
**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
Cria um novo item ou substitui um item antigo por um novo (incluindo todos os atributos). Se algum item existe em uma tabela específica com a mesma chave primária, o novo item substitui completamente o item já existente. Você pode executar uma operação Put condicional (inserir um novo item, caso não exista um com a chave primária) ou substituir um item existente se ele tiver determinados valores de atributo.
Os valores de atributo não podem ser nulos; os atributos do tipo string e binário devem ter tamanhos maiores que zero; e os atributos do tipo conjunto não devem estar vazios. As solicitações com valores vazios serão rejeitadas com `ValidationException`.
**nota**
Para garantir que um novo item não substitua um item existente, use uma operação put condicional com `Exists` definido como `false` para o atributo de chave primária, ou atributos.
Para obter mais informações sobre o uso de `PutItem`, consulte [Trabalhar com itens e atributos no DynamoDB](WorkingWithItems.md).
## 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.PutItem
content-type: application/x-amz-json-1.0
{"TableName":"Table1",
"Item":{
"AttributeName1":{"S":"AttributeValue1"},
"AttributeName2":{"N":"AttributeValue2"},
"AttributeName5":{"B":"dmFsdWU="}
},
"Expected":{"AttributeName3":{"Value": {"S":"AttributeValue"}, "Exists":Boolean}},
"ReturnValues":"ReturnValuesConstant"}
```
****
| Nome | Descrição | Obrigatório |
| --- | --- | --- |
| TableName | O nome da tabela que conterá o item. Tipo: string | Sim |
| Item | Um mapa dos atributos do item, e deve incluir os valores de chave primária que definem o item. Outros pares de nome-valor de atributo podem ser fornecidos para o item. Para obter mais informações sobre chaves primárias, consulte [Chave primária](HowItWorks.CoreComponents.md#HowItWorks.CoreComponents.PrimaryKey).Tipo: mapa de nomes de atributo para valores de atributo. | Sim |
| Expected | Designa um atributo para uma operação Put condicional. O parâmetro `Expected` permite que você forneça o nome do atributo, e se o DynamoDB deve ou não verificar se o valor de atributo já existe; ou se o valor de atributo existe e tem um valor específico antes de alterá-lo.Tipo: mapa de um nome de atributo para um valor de atributo, e se ele existe. | Não |
| Expected:AttributeName | O nome do atributo da operação put condicional.Tipo: string | Não |
| Expected:AttributeName: ExpectedAttributeValue | Use esse parâmetro para especificar se o valor já existe ou não para o par de nome-valor do atributo. A notação JSON seguinte substitui o item, se o atributo "Cor" ainda não existir para esse item:"Expected" :
{"Color":{"Exists":false}}
A notação JSON a seguir verifica se o atributo com o nome "Cor" tem um valor existente "Amarelo" antes de substituir o item: "Expected" :
{"Color":{"Exists":true,{"Value":{"S":"Yellow"}}}
Por padrão, se você usar o parâmetro `Expected` e fornecer um `Value`, o DynamoDB presumirá que o atributo existe e tem um valor atual a ser substituído. Portanto, você não precisa especificar `{"Exists":true}`, pois ele está implícito. Você pode reduzir a solicitação para:"Expected" :
{"Color":{"Value":{"S":"Yellow"}}}
Se você especificar `{"Exists":true}` sem um valor de atributo para verificar, o DynamoDB retornará um erro. | Não |
| ReturnValues | Use esse parâmetro se você quiser obter os pares de nome-valor de atributo antes que eles sejam atualizados com a solicitação `PutItem`. Os possíveis valores de parâmetro são `NONE` (padrão) ou `ALL_OLD`. Se `ALL_OLD` for especificado, e `PutItem` sobrescreveu um par de nome-valor de atributo, o conteúdo do item antigo é retornado. Se esse parâmetro não for fornecido ou for `NONE`, nada será retornado.Tipo: string | Não |
## Respostas
### Sintaxe
A sintaxe a seguir presume que a solicitação especificou um parâmetro `ReturnValues` de `ALL_OLD`; caso contrário, a resposta terá apenas o elemento `ConsumedCapacityUnits`.
```
HTTP/1.1 200
x-amzn-RequestId: 8966d095-71e9-11e0-a498-71d736f27375
content-type: application/x-amz-json-1.0
content-length: 85
{"Attributes":
{"AttributeName3":{"S":"AttributeValue3"},
"AttributeName2":{"SS":"AttributeValue2"},
"AttributeName1":{"SS":"AttributeValue1"},
},
"ConsumedCapacityUnits":1
}
```
****
| Nome | Descrição |
| --- | --- |
| Attributes | Os valores de atributo antes da operação Put, mas somente se o parâmetro `ReturnValues` for especificado `ALL_OLD` na solicitação.Tipo: mapa de pares de nome-valor de atributo. |
| ConsumedCapacityUnits | O número de unidades de capacidade de gravação consumidas pela operação. Esse valor mostra o número utilizado no throughput provisionado. Para ter mais informações, consulte [Modo de capacidade provisionada do DynamoDB](provisioned-capacity-mode.md). Tipo: número |
## Erros especiais
****
| Erro | Descrição |
| --- | --- |
| ConditionalCheckFailedException | Falha na verificação condicional. Um valor de atributo esperado não foi encontrado. |
| ResourceNotFoundException | O item especificado ou o atributo não foi encontrado. |
## Exemplos
Para obter exemplos sobre o uso do AWS SDK, consulte [Trabalhar com itens e atributos no DynamoDB](WorkingWithItems.md).
### 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.PutItem
content-type: application/x-amz-json-1.0
{"TableName":"comp5",
"Item":
{"time":{"N":"300"},
"feeling":{"S":"not surprised"},
"user":{"S":"Riley"}
},
"Expected":
{"feeling":{"Value":{"S":"surprised"},"Exists":true}}
"ReturnValues":"ALL_OLD"
}
```
### Exemplo de resposta
```
HTTP/1.1 200
x-amzn-RequestId: 8952fa74-71e9-11e0-a498-71d736f27375
content-type: application/x-amz-json-1.0
content-length: 84
{"Attributes":
{"feeling":{"S":"surprised"},
"time":{"N":"300"},
"user":{"S":"Riley"}},
"ConsumedCapacityUnits":1
}
```
## Ações relacionadas
+ [UpdateItem](API_UpdateItem_v20111205.md)
+ [DeleteItem](API_DeleteItem_v20111205.md)
+ [GetItem](API_GetItem_v20111205.md)
+ [BatchGetItem](API_BatchGetItem_v20111205.md)
# Consulta
**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
Uma operação `Query` obtém os valores de um ou mais itens e seus atributos por chave primária (`Query` só está disponível para tabelas de chave primária de hash e intervalo). Você deve fornecer um `HashKeyValue` específico e pode restringir o escopo da consulta usando operadores de comparação no `RangeKeyValue` da chave primária. Use o parâmetro `ScanIndexForward` para obter resultados em ordem progressiva ou inversa, por chave de intervalo.
Consultas que não retornam resultados consomem as unidades de capacidade de leitura mínimas de acordo com o tipo de leitura.
**nota**
Se o número total de itens que atendem aos parâmetros de consulta exceder o limite de 1 MB, a consulta será interrompida e os resultados serão retornados ao usuário com uma `LastEvaluatedKey` para continuar a consulta em uma operação subsequente. Ao contrário de uma operação de Verificação, uma operação de Consulta nunca retorna um conjunto de resultados vazio *e* uma `LastEvaluatedKey`. A `LastEvaluatedKey` apenas será fornecida se o resultado exceder 1 MB, ou se você tiver usado o parâmetro `Limit`.
O resultado pode ser definido para uma leitura consistente usando o parâmetro `ConsistentRead`.
## 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.Query
content-type: application/x-amz-json-1.0
{"TableName":"Table1",
"Limit":2,
"ConsistentRead":true,
"HashKeyValue":{"S":"AttributeValue1":},
"RangeKeyCondition": {"AttributeValueList":[{"N":"AttributeValue2"}],"ComparisonOperator":"GT"}
"ScanIndexForward":true,
"ExclusiveStartKey":{
"HashKeyElement":{"S":"AttributeName1"},
"RangeKeyElement":{"N":"AttributeName2"}
},
"AttributesToGet":["AttributeName1", "AttributeName2", "AttributeName3"]},
}
```
****
| Nome | Descrição | Obrigatório |
| --- | --- | --- |
| TableName | O nome da tabela que contém os itens solicitados. Tipo: string | Sim |
| AttributesToGet | Matriz de nomes de atributos. Se os nomes de atributos não forem especificados, todos os atributos serão retornados. Se alguns atributos não forem encontrados, eles não serão exibidos no resultado.Tipo: matriz | Não |
| Limit | O número máximo de itens a serem retornados (não necessariamente o número de itens correspondentes). Se o DynamoDB processar o número de itens até o limite enquanto consulta a tabela, ele interromperá essa consulta e retornará os valores correspondentes até esse ponto, bem como uma `LastEvaluatedKey` a ser aplicada em uma operação subsequente para continuar a consulta. Além disso, se o conjunto de resultados exceder 1 MB antes que o DynamoDB atinja esse limite, ele interromperá a consulta e retornará os valores correspondentes, bem como uma `LastEvaluatedKey` a ser aplicada a uma operação subsequente para continuar a consulta.Tipo: número | Não |
| ConsistentRead | Se definido como `true`, uma leitura consistente será emitida; caso contrário, uma leitura eventualmente consistente será usada.Tipo: booliano | Não |
| Count | Se definido como `true`, o DynamoDB retornará um número total de itens que correspondem aos parâmetros de consulta, em vez de uma lista dos itens correspondentes e seus atributos. É possível aplicar o parâmetro `Limit` a consultas somente de contagem. Não defina `Count` como `true` ao fornecer uma lista de `AttributesToGet`. Caso contrário, o DynamoDB retornará um erro de validação. Para ter mais informações, consulte [Contar os itens nos resultados](Query.Other.md#Query.Count).Tipo: booliano | Não |
| HashKeyValue | O valor do atributo do componente de hash da chave primária composta.Tipo: String, número ou binário | Sim |
| RangeKeyCondition | Um contêiner dos valores de atributos e operadores de comparação a serem usados para a consulta. Uma solicitação de consulta não requer uma `RangeKeyCondition`. Se você fornecer apenas o `HashKeyValue`, o DynamoDB retornará todos os itens com o valor do elemento de chave de hash especificado.Tipo: mapa | Não |
| RangeKeyCondition: AttributeValueList | Os valores de atributos a serem avaliados para os parâmetros de consulta. O `AttributeValueList` contém um valor de atributo, a menos que uma comparação `BETWEEN` seja especificada. Para a comparação `BETWEEN`, o `AttributeValueList` contém dois valores de atributo. Tipo: Um mapa de `AttributeValue` para uma `ComparisonOperator`. | Não |
| RangeKeyCondition: ComparisonOperator | Os critérios para avaliar os atributos fornecidos, como igual a, maior que etc. Veja a seguir os operadores de comparação válidos para uma operação de Consulta. As comparações de valor de string para maior que, igual a ou menor que são baseadas em valores de código de caracteres ASCII. Por exemplo, `a` é maior que `A`, e `aa` é maior que `B`. Para obter uma lista de valores de código, consulte [http://en.wikipedia.org/wiki/ASCII\$1ASCII\$1printable\$1characters](http://en.wikipedia.org/wiki/ASCII#ASCII_printable_characters). Para Binary, o DynamoDB trata cada byte dos dados binários como não atribuído ao comparar valores binários, por exemplo, ao avaliar as expressões de consulta. Tipo: string ou binário | Não |
| | `EQ` : Igual. Para `EQ`, `AttributeValueList` pode conter apenas um `AttributeValue` do tipo String, Number ou Binary (e não um conjunto). Se um item contém um `AttributeValue` de um valor diferente do especificado na solicitação, os valores não coincidem. Por exemplo, `{"S":"6"}` não é igual a `{"N":"6"}`. Além disso, `{"N":"6"}` não é igual a `{"NS":["6", "2", "1"]}`. | |
| | `LE` : Menor ou igual a. Para `LE`, `AttributeValueList` pode conter apenas um `AttributeValue` do tipo String, Number ou Binary (e não um conjunto). Se um item contém um `AttributeValue` de um valor diferente do especificado na solicitação, os valores não coincidem. Por exemplo, `{"S":"6"}` não é igual a `{"N":"6"}`. Além disso, `{"N":"6"}` não se compara a `{"NS":["6", "2", "1"]}`. | |
| | `LT` : Menor que. Para `LT`, `AttributeValueList` pode conter apenas um `AttributeValue` do tipo String, Number ou Binary (e não um conjunto). Se um item contém um `AttributeValue` de um valor diferente do especificado na solicitação, os valores não coincidem. Por exemplo, `{"S":"6"}` não é igual a `{"N":"6"}`. Além disso, `{"N":"6"}` não se compara a `{"NS":["6", "2", "1"]}`. | |
| | `GE` : Maior ou igual a. Para `GE`, `AttributeValueList` pode conter apenas um `AttributeValue` do tipo String, Number ou Binary (e não um conjunto). Se um item contém um `AttributeValue` de um valor diferente do especificado na solicitação, os valores não coincidem. Por exemplo, `{"S":"6"}` não é igual a `{"N":"6"}`. Além disso, `{"N":"6"}` não se compara a `{"NS":["6", "2", "1"]}`. | |
| | `GT` : Maior que. Para `GT`, `AttributeValueList` pode conter apenas um `AttributeValue` do tipo String, Number ou Binary (e não um conjunto). Se um item contém um `AttributeValue` de um valor diferente do especificado na solicitação, os valores não coincidem. Por exemplo, `{"S":"6"}` não é igual a `{"N":"6"}`. Além disso, `{"N":"6"}` não se compara a `{"NS":["6", "2", "1"]}`. | |
| | `BEGINS_WITH` : procura um prefixo. Para `BEGINS_WITH`, `AttributeValueList` pode conter apenas um `AttributeValue` do tipo String ou Binary (e não um Number ou conjunto). O atributo de destino da comparação deve ser String ou Binary (não Number ou um conjunto). | |
| | `BETWEEN` : Maior ou igual ao primeiro valor e menor que ou igual ao segundo valor. Para `BETWEEN`, `AttributeValueList` deve conter dois elementos `AttributeValue` do mesmo tipo, seja String, Number ou Binary (e não um conjunto). Um atributo de destino corresponderá se o valor de destino for maior que ou igual ao primeiro elemento e menor que ou igual ao segundo elemento. Se um item contém um `AttributeValue` de um valor diferente do especificado na solicitação, os valores não coincidem. Por exemplo, `{"S":"6"}` não se compara a `{"N":"6"}`. Além disso, `{"N":"6"}` não se compara a `{"NS":["6", "2", "1"]}`. | |
| ScanIndexForward | Especifica o percurso crescente ou decrescente do índice. O DynamoDB retornará resultados que refletem a ordem solicitada determinada pela chave de intervalo: se o tipo de dados for Number, os resultados serão retornados em ordem numérica. Caso contrário, o percurso se baseará em valores do código de caracteres ASCII.Tipo: boolianoO padrão é `true` (crescente). | Não |
| ExclusiveStartKey | A chave primária do item a partir do qual a consulta anterior deve continuar. Uma consulta anterior poderá fornecer esse valor como a `LastEvaluatedKey` se essa operação de consulta tiver sido interrompida antes da conclusão da consulta, seja devido ao tamanho do conjunto de resultados ou ao parâmetro `Limit`. A `LastEvaluatedKey` pode ser retornada em uma nova solicitação de consulta para continuar a operação a partir desse ponto.Tipo: `HashKeyElement` ou `HashKeyElement` e `RangeKeyElement` para uma chave primária composta. | Não |
## Respostas
### Sintaxe
```
HTTP/1.1 200
x-amzn-RequestId: 8966d095-71e9-11e0-a498-71d736f27375
content-type: application/x-amz-json-1.0
content-length: 308
{"Count":2,"Items":[{
"AttributeName1":{"S":"AttributeValue1"},
"AttributeName2":{"N":"AttributeValue2"},
"AttributeName3":{"S":"AttributeValue3"}
},{
"AttributeName1":{"S":"AttributeValue3"},
"AttributeName2":{"N":"AttributeValue4"},
"AttributeName3":{"S":"AttributeValue3"},
"AttributeName5":{"B":"dmFsdWU="}
}],
"LastEvaluatedKey":{"HashKeyElement":{"AttributeValue3":"S"},
"RangeKeyElement":{"AttributeValue4":"N"}
},
"ConsumedCapacityUnits":1
}
```
****
| Nome | Descrição |
| --- | --- |
| Items | Atributos do item que atendem aos parâmetros de consulta.Tipo: mapa de nomes de atributo e seus tipos de dados e valores. |
| Count | Número de itens na resposta. Para ter mais informações, consulte [Contar os itens nos resultados](Query.Other.md#Query.Count). Tipo: número |
| LastEvaluatedKey | Chave primária do item no qual a operação de consulta foi interrompida, incluindo o conjunto de resultados anterior. Use esse valor para iniciar uma nova operação, excluindo o valor na nova solicitação.A `LastEvaluatedKey` é `null` quando o conjunto inteiro de resultados da consulta está completo (ou seja, a operação processou a "última página"). Tipo: `HashKeyElement` ou `HashKeyElement` e `RangeKeyElement` para uma chave primária composta. |
| ConsumedCapacityUnits | O número de unidades de capacidade de leitura consumidas pela operação. Esse valor mostra o número utilizado no throughput provisionado. Para ter mais informações, consulte [Modo de capacidade provisionada do DynamoDB](provisioned-capacity-mode.md). Tipo: número |
## Erros especiais
****
| Erro | Descrição |
| --- | --- |
| ResourceNotFoundException | A tabela especificada não foi encontrada. |
## Exemplos
Para obter exemplos sobre o uso do AWS SDK, consulte [Consultar tabelas no DynamoDB](Query.md).
### 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.Query
content-type: application/x-amz-json-1.0
{"TableName":"1-hash-rangetable",
"Limit":2,
"HashKeyValue":{"S":"John"},
"ScanIndexForward":false,
"ExclusiveStartKey":{
"HashKeyElement":{"S":"John"},
"RangeKeyElement":{"S":"The Matrix"}
}
}
```
### Exemplo de resposta
```
HTTP/1.1 200
x-amzn-RequestId: 3647e778-71eb-11e0-a498-71d736f27375
content-type: application/x-amz-json-1.0
content-length: 308
{"Count":2,"Items":[{
"fans":{"SS":["Jody","Jake"]},
"name":{"S":"John"},
"rating":{"S":"***"},
"title":{"S":"The End"}
},{
"fans":{"SS":["Jody","Jake"]},
"name":{"S":"John"},
"rating":{"S":"***"},
"title":{"S":"The Beatles"}
}],
"LastEvaluatedKey":{"HashKeyElement":{"S":"John"},"RangeKeyElement":{"S":"The Beatles"}},
"ConsumedCapacityUnits":1
}
```
### 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.Query
content-type: application/x-amz-json-1.0
{"TableName":"1-hash-rangetable",
"Limit":2,
"HashKeyValue":{"S":"Airplane"},
"RangeKeyCondition":{"AttributeValueList":[{"N":"1980"}],"ComparisonOperator":"EQ"},
"ScanIndexForward":false}
```
### Exemplo de resposta
```
HTTP/1.1 200
x-amzn-RequestId: 8b9ee1ad-774c-11e0-9172-d954e38f553a
content-type: application/x-amz-json-1.0
content-length: 119
{"Count":1,"Items":[{
"fans":{"SS":["Dave","Aaron"]},
"name":{"S":"Airplane"},
"rating":{"S":"***"},
"year":{"N":"1980"}
}],
"ConsumedCapacityUnits":1
}
```
## Ações relacionadas
+ [Verificar](API_Scan_v20111205.md)
# Verificar
**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
A operação `Scan` retorna um ou mais itens e seus atributos realizando uma verificação completa de uma tabela. Forneça um `ScanFilter` para obter resultados mais específicos.
**nota**
Se o número total de itens verificados exceder o limite de 1 MB, a verificação será interrompida e os resultados serão retornados para o usuário com `LastEvaluatedKey` para continuar a verificação em uma operação posterior. Os resultados também incluem o número de itens que excedem o limite. O resultado de uma verificação pode ser que nenhum dado corresponda aos critérios de filtro.
O conjunto de resultados é eventualmente consistente.
## 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.Scan
content-type: application/x-amz-json-1.0
{"TableName":"Table1",
"Limit": 2,
"ScanFilter":{
"AttributeName1":{"AttributeValueList":[{"S":"AttributeValue"}],"ComparisonOperator":"EQ"}
},
"ExclusiveStartKey":{
"HashKeyElement":{"S":"AttributeName1"},
"RangeKeyElement":{"N":"AttributeName2"}
},
"AttributesToGet":["AttributeName1", "AttributeName2", "AttributeName3"]},
}
```
****
| Nome | Descrição | Obrigatório |
| --- | --- | --- |
| TableName | O nome da tabela que contém os itens solicitados. Tipo: string | Sim |
| AttributesToGet | Matriz de nomes de atributos. Se os nomes de atributos não forem especificados, todos os atributos serão retornados. Se alguns atributos não forem encontrados, eles não serão exibidos no resultado.Tipo: matriz | Não |
| Limit | O número máximo de itens a serem avaliados (não necessariamente o número de itens correspondentes). Se o DynamoDB processa o número de itens até o limite ao processar os resultados, ele para e retorna os valores correspondentes até esse ponto, além de um `LastEvaluatedKey` para aplicar em uma operação subsequente para continuar a recuperação de itens. Além disso, se o tamanho do conjunto de dados exceder 1 MB antes que o DynamoDB atinja esse limite, a verificação será interrompida e retornará os valores correspondentes até o limite, além de uma `LastEvaluatedKey` para aplicar em uma operação subsequente para continuar a verificação.Tipo: número | Não |
| Count | Se definido como `true`, o DynamoDB retorna um número total de itens para a operação Scan, mesmo se a operação não tiver itens correspondentes ao filtro associado. Você pode aplicar o parâmetro de limite somente para contar verificações. Não defina `Count` como `true` ao fornecer uma lista de `AttributesToGet`. Caso contrário, o DynamoDB retornará um erro de validação. Para ter mais informações, consulte [Contar os itens nos resultados](Scan.md#Scan.Count).Tipo: booliano | Não |
| ScanFilter | Avalia os resultados da verificação e retorna apenas os valores desejados. Várias condições são tratadas como operações "AND": todas as condições devem ser atendidas para serem incluídas nos resultados. Tipo: um mapa de nomes de atributo para valores com operadores de comparação. | Não |
| ScanFilter:AttributeValueList | Os valores e as condições para avaliar os resultados da verificação do filtro.Tipo: Um mapa de `AttributeValue` para uma `Condition`. | Não |
| ScanFilter: ComparisonOperator | Os critérios para avaliar os atributos fornecidos, como igual a, maior que etc. A seguir estão os operadores de comparação válidos para uma operação de verificação. As comparações de valor de string para maior que, igual a ou menor que são baseadas em valores de código de caracteres ASCII. Por exemplo, `a` é maior que `A`, e `aa` é maior que `B`. Para obter uma lista de valores de código, consulte [http://en.wikipedia.org/wiki/ASCII\$1ASCII\$1printable\$1characters](http://en.wikipedia.org/wiki/ASCII#ASCII_printable_characters). Para Binary, o DynamoDB trata cada byte dos dados binários como não atribuído ao comparar valores binários, por exemplo, ao avaliar as expressões de consulta. Tipo: string ou binário | Não |
| | `EQ` : Igual. Para `EQ`, `AttributeValueList` pode conter apenas um `AttributeValue` do tipo String, Number ou Binary (e não um conjunto). Se um item contém um `AttributeValue` de um valor diferente do especificado na solicitação, os valores não coincidem. Por exemplo, `{"S":"6"}` não é igual a `{"N":"6"}`. Além disso, `{"N":"6"}` não é igual a `{"NS":["6", "2", "1"]}`. | |
| | `NE` : Não é igual. Para `NE`, `AttributeValueList` pode conter apenas um `AttributeValue` do tipo String, Number ou Binary (e não um conjunto). Se um item contém um `AttributeValue` de um valor diferente do especificado na solicitação, os valores não coincidem. Por exemplo, `{"S":"6"}` não é igual a `{"N":"6"}`. Além disso, `{"N":"6"}` não é igual a `{"NS":["6", "2", "1"]}`. | |
| | `LE` : Menor ou igual a. Para `LE`, `AttributeValueList` pode conter apenas um `AttributeValue` do tipo String, Number ou Binary (e não um conjunto). Se um item contém um `AttributeValue` de um valor diferente do especificado na solicitação, os valores não coincidem. Por exemplo, `{"S":"6"}` não é igual a `{"N":"6"}`. Além disso, `{"N":"6"}` não se compara a `{"NS":["6", "2", "1"]}`. | |
| | `LT` : Menor que. Para `LT`, `AttributeValueList` pode conter apenas um `AttributeValue` do tipo String, Number ou Binary (e não um conjunto). Se um item contém um `AttributeValue` de um valor diferente do especificado na solicitação, os valores não coincidem. Por exemplo, `{"S":"6"}` não é igual a `{"N":"6"}`. Além disso, `{"N":"6"}` não se compara a `{"NS":["6", "2", "1"]}`. | |
| | `GE` : Maior ou igual a. Para `GE`, `AttributeValueList` pode conter apenas um `AttributeValue` do tipo String, Number ou Binary (e não um conjunto). Se um item contém um `AttributeValue` de um valor diferente do especificado na solicitação, os valores não coincidem. Por exemplo, `{"S":"6"}` não é igual a `{"N":"6"}`. Além disso, `{"N":"6"}` não se compara a `{"NS":["6", "2", "1"]}`. | |
| | `GT` : Maior que. Para `GT`, `AttributeValueList` pode conter apenas um `AttributeValue` do tipo String, Number ou Binary (e não um conjunto). Se um item contém um `AttributeValue` de um valor diferente do especificado na solicitação, os valores não coincidem. Por exemplo, `{"S":"6"}` não é igual a `{"N":"6"}`. Além disso, `{"N":"6"}` não se compara a `{"NS":["6", "2", "1"]}`. | |
| | `NOT_NULL` : o atributo existe. | |
| | `NULL` : o atributo não existe. | |
| | `CONTAINS` : verifica uma subsequência ou valor em um conjunto. Para `CONTAINS`, `AttributeValueList` pode conter apenas um `AttributeValue` do tipo String, Number ou Binary (e não um conjunto). Se o atributo de destino da comparação for uma String, a operação procurará uma substring correspondente. Se o atributo de destino da comparação for Binary, a operação procurará uma subsequência do destino que corresponda à entrada. Se o atributo de destino da comparação for um conjunto ("SS", "NS" ou "BS"), a operação procurará um membro do conjunto (não uma substring). | |
| | `NOT_CONTAINS` : verifica a ausência de uma subsequência ou a ausência de um valor em um conjunto. Para `NOT_CONTAINS`, `AttributeValueList` pode conter apenas um `AttributeValue` do tipo String, Number ou Binary (e não um conjunto). Se o atributo de destino da comparação for String, a operação verificará a ausência de uma substring correspondente. Se o atributo de destino da comparação for Binary, a operação verificará a ausência de uma subsequência do destino que corresponda à entrada. Se o atributo de destino da comparação for um conjunto ("SS", "NS" ou "BS"), a operação verificará a ausência de um membro do conjunto (não uma substring). | |
| | `BEGINS_WITH` : procura um prefixo. Para `BEGINS_WITH`, `AttributeValueList` pode conter apenas um `AttributeValue` do tipo String ou Binary (e não um Number ou conjunto). O atributo de destino da comparação deve ser String ou Binary (não Number ou um conjunto). | |
| | `IN` : verifica se existem correspondências exatas. Para `IN`, `AttributeValueList` pode conter mais de um `AttributeValue` do tipo String, Number ou Binary (não um conjunto). O atributo de destino da comparação deve ser do mesmo tipo e ter o valor exato para corresponder. Um atributo String nunca corresponde a um String set. | |
| | `BETWEEN` : Maior ou igual ao primeiro valor e menor que ou igual ao segundo valor. Para `BETWEEN`, `AttributeValueList` deve conter dois elementos `AttributeValue` do mesmo tipo, seja String, Number ou Binary (e não um conjunto). Um atributo de destino corresponderá se o valor de destino for maior que ou igual ao primeiro elemento e menor que ou igual ao segundo elemento. Se um item contém um `AttributeValue` de um valor diferente do especificado na solicitação, os valores não coincidem. Por exemplo, `{"S":"6"}` não se compara a `{"N":"6"}`. Além disso, `{"N":"6"}` não se compara a `{"NS":["6", "2", "1"]}`. | |
| ExclusiveStartKey | A chave primária do item a partir do qual a verificação anterior deve continuar. Uma verificação anterior deve fornecer esse valor, se essa operação Scan foi interrompida antes da verificação da tabela inteira, seja por causa do tamanho do conjunto de resultados ou do parâmetro `Limit`. O valor `LastEvaluatedKey` pode ser passado de volta em uma nova solicitação de verificação para continuar a operação a partir desse ponto.Tipo: `HashKeyElement` ou `HashKeyElement` e `RangeKeyElement` para uma chave primária composta. | Não |
## Respostas
### Sintaxe
```
HTTP/1.1 200
x-amzn-RequestId: 8966d095-71e9-11e0-a498-71d736f27375
content-type: application/x-amz-json-1.0
content-length: 229
{"Count":2,"Items":[{
"AttributeName1":{"S":"AttributeValue1"},
"AttributeName2":{"S":"AttributeValue2"},
"AttributeName3":{"S":"AttributeValue3"}
},{
"AttributeName1":{"S":"AttributeValue4"},
"AttributeName2":{"S":"AttributeValue5"},
"AttributeName3":{"S":"AttributeValue6"},
"AttributeName5":{"B":"dmFsdWU="}
}],
"LastEvaluatedKey":
{"HashKeyElement":{"S":"AttributeName1"},
"RangeKeyElement":{"N":"AttributeName2"},
"ConsumedCapacityUnits":1,
"ScannedCount":2}
}
```
****
| Nome | Descrição |
| --- | --- |
| Items | Contêiner dos atributos que atendem aos parâmetros da operação.Tipo: mapa de nomes de atributo e seus tipos de dados e valores. |
| Count | Número de itens na resposta. Para ter mais informações, consulte [Contar os itens nos resultados](Scan.md#Scan.Count). Tipo: número |
| ScannedCount | Número de itens na verificação completa antes de todos os filtros serem aplicados. Um valor `ScannedCount` alto com poucos ou sem `Count` resultados indica uma operação Scan ineficiente. Para ter mais informações, consulte [Contar os itens nos resultados](Scan.md#Scan.Count).Tipo: número |
| LastEvaluatedKey | Chave primária do item em que a operação Scan foi interrompida. Forneça esse valor em uma operação Scan subsequente para continuar a operação a partir desse ponto.O valor `LastEvaluatedKey` é `null` quando o conjunto de resultados da verificação inteira está completo (ou seja, a operação processou a “última página”). |
| ConsumedCapacityUnits | O número de unidades de capacidade de leitura consumidas pela operação. Esse valor mostra o número utilizado no throughput provisionado. Para ter mais informações, consulte [Modo de capacidade provisionada do DynamoDB](provisioned-capacity-mode.md). Tipo: número |
## Erros especiais
****
| Erro | Descrição |
| --- | --- |
| ResourceNotFoundException | A tabela especificada não foi encontrada. |
## Exemplos
Para obter exemplos sobre o uso do AWS SDK, consulte [Verificar tabelas no DynamoDB](Scan.md).
### 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.Scan
content-type: application/x-amz-json-1.0
{"TableName":"1-hash-rangetable","ScanFilter":{}}
```
### Exemplo de resposta
```
HTTP/1.1 200
x-amzn-RequestId: 4e8a5fa9-71e7-11e0-a498-71d736f27375
content-type: application/x-amz-json-1.0
content-length: 465
{"Count":4,"Items":[{
"date":{"S":"1980"},
"fans":{"SS":["Dave","Aaron"]},
"name":{"S":"Airplane"},
"rating":{"S":"***"}
},{
"date":{"S":"1999"},
"fans":{"SS":["Ziggy","Laura","Dean"]},
"name":{"S":"Matrix"},
"rating":{"S":"*****"}
},{
"date":{"S":"1976"},
"fans":{"SS":["Riley"]},"
name":{"S":"The Shaggy D.A."},
"rating":{"S":"**"}
},{
"date":{"S":"1985"},
"fans":{"SS":["Fox","Lloyd"]},
"name":{"S":"Back To The Future"},
"rating":{"S":"****"}
}],
"ConsumedCapacityUnits":0.5
"ScannedCount":4}
```
### 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.Scan
content-type: application/x-amz-json-1.0
content-length: 125
{"TableName":"comp5",
"ScanFilter":
{"time":
{"AttributeValueList":[{"N":"400"}],
"ComparisonOperator":"GT"}
}
}
```
### Exemplo de resposta
```
HTTP/1.1 200 OK
x-amzn-RequestId: PD1CQK9QCTERLTJP20VALJ60TRVV4KQNSO5AEMVJF66Q9ASUAAJG
content-type: application/x-amz-json-1.0
content-length: 262
Date: Mon, 15 Aug 2011 16:52:02 GMT
{"Count":2,
"Items":[
{"friends":{"SS":["Dave","Ziggy","Barrie"]},
"status":{"S":"chatting"},
"time":{"N":"2000"},
"user":{"S":"Casey"}},
{"friends":{"SS":["Dave","Ziggy","Barrie"]},
"status":{"S":"chatting"},
"time":{"N":"2000"},
"user":{"S":"Fredy"}
}],
"ConsumedCapacityUnits":0.5
"ScannedCount":4
}
```
### 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.Scan
content-type: application/x-amz-json-1.0
{"TableName":"comp5",
"Limit":2,
"ScanFilter":
{"time":
{"AttributeValueList":[{"N":"400"}],
"ComparisonOperator":"GT"}
},
"ExclusiveStartKey":
{"HashKeyElement":{"S":"Fredy"},"RangeKeyElement":{"N":"2000"}}
}
```
### Exemplo de resposta
```
HTTP/1.1 200 OK
x-amzn-RequestId: PD1CQK9QCTERLTJP20VALJ60TRVV4KQNSO5AEMVJF66Q9ASUAAJG
content-type: application/x-amz-json-1.0
content-length: 232
Date: Mon, 15 Aug 2011 16:52:02 GMT
{"Count":1,
"Items":[
{"friends":{"SS":["Jane","James","John"]},
"status":{"S":"exercising"},
"time":{"N":"2200"},
"user":{"S":"Roger"}}
],
"LastEvaluatedKey":{"HashKeyElement":{"S":"Riley"},"RangeKeyElement":{"N":"250"}},
"ConsumedCapacityUnits":0.5
"ScannedCount":2
}
```
## Ações relacionadas
+ [Consulta](API_Query_v20111205.md)
+ [BatchGetItem](API_BatchGetItem_v20111205.md)
# UpdateItem
**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
Edita os atributos de um item existente. Você pode executar uma atualização condicional (insira um novo par de nome-valor de atributo se ele não existir, ou substitua um par de nome-valor existente se ele tiver determinados valores de atributos esperados).
**nota**
Não é possível atualizar os atributos da chave primária usando UpdateItem. Em vez disso, exclua o item e use PutItem para criar um novo item com novos atributos.
A operação UpdateItem inclui um parâmetro `Action` que define como executar a atualização. Você pode inserir, excluir ou adicionar valores de atributo.
Os valores de atributo não podem ser nulos; os atributos do tipo string e binário devem ter tamanhos maiores que zero; e os atributos do tipo conjunto não devem estar vazios. As solicitações com valores vazios serão rejeitadas com `ValidationException`.
Se um item existente tiver a chave primária especificada:
+ **PUT**: adiciona o atributo especificado. Se o atributo existir, ele será substituído pelo novo valor.
+ **DELETE**: se nenhum valor for especificado, o atributo e seu valor serão removidos. Se um conjunto de valores for especificado, os valores no conjunto especificado serão removidos do conjunto antigo. Portanto, se o valor do atributo incluir [a, b, c] e a ação de exclusão incluir [a, c], o valor do atributo final será [b]. O tipo de valor especificado deve corresponder ao tipo de valor existente. Não é válido especificar um conjunto vazio.
+ **ADD**: use a ação de adicionar apenas para números ou se o atributo de destino for um conjunto (incluindo conjuntos de strings). ADD não funcionará se o atributo de destino for um único valor de string ou um valor binário escalar. O valor especificado é adicionado a um valor numérico (aumentando ou diminuindo o valor numérico existente) ou adicionado como um valor extra em um conjunto de strings. Se um conjunto de valores for especificado, os valores serão adicionados ao conjunto existente. Por exemplo, se o conjunto original for [1,2] e o valor fornecido for [3], após a operação de adição, o conjunto será [1,2,3] e não [4,5]. Ocorrerá um erro se uma ação Adicionar for especificada para um atributo de conjunto e o tipo de atributo especificado não corresponder ao tipo de conjunto existente.
Se você usar ADD para um atributo que não existe, o atributo e seus valores serão adicionados ao item.
Se nenhum item corresponder à chave primária especificada:
+ **PUT**: cria um novo item com a chave primária especificada. Em seguida, adiciona o atributo especificado.
+ **DELETE -** Nada acontece.
+ **ADD**: cria um item com a chave primária e o número fornecidos (ou conjunto de números) para o valor de atributo. Não é válido para um tipo string ou binário.
**nota**
Se você usar `ADD` para aumentar ou reduzir um valor de número de um item que não existe antes da atualização, o DynamoDB usará `0` como o valor inicial. Além disso, se você atualizar um item usando `ADD` para aumentar ou diminuir um valor de número de um atributo que não existe antes da atualização (mas o item existe), o DynamoDB usará `0` como o valor inicial. Por exemplo, você usa `ADD` para adicionar `+3` a um atributo que não existia antes da atualização. O DynamoDB usa `0` para o valor inicial, e o valor após a atualização é `3`.
Para obter mais informações sobre o uso dessa operação, consulte [Trabalhar com itens e atributos no DynamoDB](WorkingWithItems.md).
## 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.UpdateItem
content-type: application/x-amz-json-1.0
{"TableName":"Table1",
"Key":
{"HashKeyElement":{"S":"AttributeValue1"},
"RangeKeyElement":{"N":"AttributeValue2"}},
"AttributeUpdates":{"AttributeName3":{"Value":{"S":"AttributeValue3_New"},"Action":"PUT"}},
"Expected":{"AttributeName3":{"Value":{"S":"AttributeValue3_Current"}}},
"ReturnValues":"ReturnValuesConstant"
}
```
****
| Nome | Descrição | Obrigatório |
| --- | --- | --- |
| TableName | O nome da tabela que contém o item a ser atualizado. Tipo: string | Sim |
| Key | A chave primária que define o item. Para obter mais informações sobre chaves primárias, consulte [Chave primária](HowItWorks.CoreComponents.md#HowItWorks.CoreComponents.PrimaryKey).Tipo: mapa de `HashKeyElement` para seu valor e `RangeKeyElement` para seu valor. | Sim |
| AttributeUpdates | Mapa de nome de atributo para o novo valor e ação para a atualização. Os nomes de atributo especificam os atributos a serem modificados, e não podem conter quaisquer atributos da chave primária.Tipo: mapa de nome de atributo, valor e uma ação para a atualização do atributo. | |
| AttributeUpdates:Action | Especifica como executar a atualização. Valores possíveis: `PUT` (padrão) `ADD` ou `DELETE`. As semânticas são explicadas na descrição de UpdateItem.Tipo: stringPadrão: `PUT` | Não |
| Expected | Designa um atributo para uma atualização condicional. O parâmetro `Expected` permite que você forneça o nome do atributo, e se o DynamoDB deve ou não verificar se o valor de atributo já existe; ou se o valor de atributo existe e tem um valor específico antes de alterá-lo.Tipo: mapa de nomes de atributo. | Não |
| Expected:AttributeName | O nome do atributo da operação put condicional.Tipo: string | Não |
| Expected:AttributeName: ExpectedAttributeValue | Use esse parâmetro para especificar se o valor já existe ou não para o par de nome-valor do atributo. A notação JSON seguinte atualiza o item, se o atributo "Cor" ainda não existir para esse item:"Expected" :
{"Color":{"Exists":false}}
A notação JSON seguinte verifica se o atributo com o nome "Cor" tem um valor existente "Amarelo" antes de atualizar o item: "Expected" :
{"Color":{"Exists":true},{"Value":{"S":"Yellow"}}}
Por padrão, se você usar o parâmetro `Expected` e fornecer um `Value`, o DynamoDB presumirá que o atributo existe e tem um valor atual a ser substituído. Portanto, você não precisa especificar `{"Exists":true}`, pois ele está implícito. Você pode reduzir a solicitação para:"Expected" :
{"Color":{"Value":{"S":"Yellow"}}}
Se você especificar `{"Exists":true}` sem um valor de atributo para verificar, o DynamoDB retornará um erro. | Não |
| ReturnValues | Use esse parâmetro se você quiser obter os pares de nome-valor de atributo antes que eles sejam atualizados com a solicitação `UpdateItem`. Possíveis valores de parâmetro são `NONE` (padrão) ou `ALL_OLD`, `UPDATED_OLD`, `ALL_NEW` ou `UPDATED_NEW`. Se `ALL_OLD` for especificado, e `UpdateItem` sobrescreveu um par de nome-valor de atributo, o conteúdo do item antigo é retornado. Se esse parâmetro não for fornecido ou for `NONE`, nada será retornado. Se `ALL_NEW` for especificado, todos os atributos da nova versão do item serão retornados. Se `UPDATED_NEW` for especificado, somente as novas versões dos atributos atualizados serão retornadas.Tipo: string | Não |
## Respostas
### Sintaxe
A sintaxe a seguir presume que a solicitação especificou um parâmetro `ReturnValues` de `ALL_OLD`; caso contrário, a resposta terá apenas o elemento `ConsumedCapacityUnits`.
```
HTTP/1.1 200
x-amzn-RequestId: 8966d095-71e9-11e0-a498-71d736f27375
content-type: application/x-amz-json-1.0
content-length: 140
{"Attributes":{
"AttributeName1":{"S":"AttributeValue1"},
"AttributeName2":{"S":"AttributeValue2"},
"AttributeName3":{"S":"AttributeValue3"},
"AttributeName5":{"B":"dmFsdWU="}
},
"ConsumedCapacityUnits":1
}
```
****
| Nome | Descrição |
| --- | --- |
| Attributes | Um mapa de pares de nome-valor de atributo, mas somente se o parâmetro `ReturnValues` for especificado como algo diferente de `NONE` na solicitação.Tipo: mapa de pares de nome-valor de atributo. |
| ConsumedCapacityUnits | O número de unidades de capacidade de gravação consumidas pela operação. Esse valor mostra o número utilizado no throughput provisionado. Para ter mais informações, consulte [Modo de capacidade provisionada do DynamoDB](provisioned-capacity-mode.md). Tipo: número |
## Erros especiais
****
| Erro | Descrição |
| --- | --- |
| ConditionalCheckFailedException | Falha na verificação condicional. Atributo ("\$1 name \$1"), o valor é ("\$1 value \$1") mas o esperado era ("\$1 expValue \$1") |
| ResourceNotFoundExceptions | O item especificado ou o atributo não foi encontrado. |
## Exemplos
Para obter exemplos sobre o uso do AWS SDK, consulte [Trabalhar com itens e atributos no DynamoDB](WorkingWithItems.md).
### 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.UpdateItem
content-type: application/x-amz-json-1.0
{"TableName":"comp5",
"Key":
{"HashKeyElement":{"S":"Julie"},"RangeKeyElement":{"N":"1307654350"}},
"AttributeUpdates":
{"status":{"Value":{"S":"online"},
"Action":"PUT"}},
"Expected":{"status":{"Value":{"S":"offline"}}},
"ReturnValues":"ALL_NEW"
}
```
### Exemplo de resposta
```
HTTP/1.1 200 OK
x-amzn-RequestId: 5IMHO7F01Q9P7Q6QMKMMI3R3QRVV4KQNSO5AEMVJF66Q9ASUAAJG
content-type: application/x-amz-json-1.0
content-length: 121
Date: Fri, 26 Aug 2011 21:05:00 GMT
{"Attributes":
{"friends":{"SS":["Lynda, Aaron"]},
"status":{"S":"online"},
"time":{"N":"1307654350"},
"user":{"S":"Julie"}},
"ConsumedCapacityUnits":1
}
```
## Ações relacionadas
+ [PutItem](API_PutItem_v20111205.md)
+ [DeleteItem](API_DeleteItem_v20111205.md)
# 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)