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

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.

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 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: sequência

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.

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.
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: sequência

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 para verificar o status da tabela.

Tipo: sequência

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