# DeleteTable
<a name="API_DeleteTable_v20111205"></a>

**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 name="API_DeleteTable_Description"></a>

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
<a name="API_DeleteTable_RequestParameters"></a>

### Sintaxe
<a name="API_DeleteTable_RequestParameters.syntax"></a>

```
// 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
<a name="API_DeleteTable_CommonResponseElements"></a>

### Sintaxe
<a name="API_DeleteTable_CommonResponseElements.syntax"></a>

```
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
<a name="API_DeleteTable_SpecialErrors"></a>


****  

|  Erro  |  Descrição  | 
| --- | --- | 
|  ResourceInUseException  |  A tabela está no estado CREATING ou UPDATING e não pode ser excluída.  | 

## Exemplos
<a name="API_DeleteTable_Examples"></a>

### Exemplo de solicitação
<a name="API_DeleteTable_Examples_Request"></a>

```
// 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
<a name="API_DeleteTable_Examples_Response"></a>

```
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
<a name="API_DeleteTable_Related_Actions"></a>
+  [CreateTable](API_CreateTable_v20111205.md) 
+  [DescribeTables](API_DescribeTables_v20111205.md)