Selecione suas preferências de cookies

Usamos cookies essenciais e ferramentas semelhantes que são necessárias para fornecer nosso site e serviços. Usamos cookies de desempenho para coletar estatísticas anônimas, para que possamos entender como os clientes usam nosso site e fazer as devidas melhorias. Cookies essenciais não podem ser desativados, mas você pode clicar em “Personalizar” ou “Recusar” para recusar cookies de desempenho.

Se você concordar, a AWS e terceiros aprovados também usarão cookies para fornecer recursos úteis do site, lembrar suas preferências e exibir conteúdo relevante, incluindo publicidade relevante. Para aceitar ou recusar todos os cookies não essenciais, clique em “Aceitar” ou “Recusar”. Para fazer escolhas mais detalhadas, clique em “Personalizar”.

DeleteItem

Modo de foco
DeleteItem - Amazon DynamoDB
Importante

Esta seção refere-se à versão de API 2011-12-05, que está obsoleta e não deve ser usada para novos aplicativos.

Para obter a documentação da API de baixo nível atual, consulte a Referência da API do Amazon DynamoDB.

Descrição

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.

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

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.

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 }
PrivacidadeTermos do sitePreferências de cookies
© 2025, Amazon Web Services, Inc. ou suas afiliadas. Todos os direitos reservados.