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

**importante**  
***Esta sección se refiere a la versión 2011-12-05 del API, que está obsoleta y no debe utilizarse para nuevas aplicaciones.***  
 **Para consultar la documentación sobre la API de bajo nivel actual, consulte la [Referencia de la API de Amazon DynamoDB](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/).**

## Descripción
<a name="API_DeleteTable_Description"></a>

La operación `DeleteTable` elimina una tabla y todos sus elementos. Después de una solicitud `DeleteTable`, la tabla especificada se encuentra en estado `DELETING` hasta que DynamoDB completa la eliminación. Si la tabla está en estado `ACTIVE`, puede eliminarla. Si una tabla se encuentra en los estados `CREATING` o `UPDATING`, entonces DynamoDB devuelve un error `ResourceInUseException`. Si la tabla especificada no existe, DynamoDB devuelve una `ResourceNotFoundException`. Si la tabla ya se encuentra en el estado `DELETING`, no se devuelve ningún error. 

**nota**  
DynamoDB podría continuar aceptando solicitudes de operaciones con el plano de datos, tales como `GetItem` y `PutItem`, en una tabla que se encuentre en estado `DELETING` hasta que se haya completado la eliminación de la tabla.

Las tablas son únicas entre las asociadas a la cuenta de AWS que emite la solicitud y la región de AWS que recibe la solicitud a las que están asociadas (por ejemplo, dynamodb.us-west-1.amazonaws.com). Cada punto de enlace de DynamoDB es totalmente independiente. Por ejemplo, si tiene dos tablas llamadas “MyTable”, una en dynamodb.us-west-2.amazonaws.com y otra en dynamodb.us-west-1.amazonaws.com, son completamente independientes y no comparten ningún dato; al eliminar una no se elimina la otra.

Use la operación [DescribeTables](API_DescribeTables_v20111205.md) para comprobar el estado de la tabla. 

## Solicitudes
<a name="API_DeleteTable_RequestParameters"></a>

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

```
// This header is abbreviated. 
// For a sample of a complete header, see API de bajo nivel de DynamoDB.
POST / HTTP/1.1 
x-amz-target: DynamoDB_20111205.DeleteTable 
content-type: application/x-amz-json-1.0

{"TableName":"Table1"}
```


****  

|  Nombre  |  Descripción  |  Obligatorio | 
| --- | --- | --- | 
|  TableName  |   Nombre de la tabla que se va a eliminar.   Tipo: cadena   |  Sí  | 

## Respuestas
<a name="API_DeleteTable_CommonResponseElements"></a>

### Sintaxis
<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"
    }
}
```


****  

|  Nombre  |  Descripción  | 
| --- | --- | 
| TableDescription  | Contenedor de propiedades de la tabla. | 
| CreationDateTime | Fecha de creación de la tabla.Tipo: Number  | 
| KeySchema  | Estructura de la clave principal (simple o compuesta) de la tabla. Se requiere un par de nombre-valor de `HashKeyElement`, pero el par de nombre-valor de `RangeKeyElement` es opcional (solo es obligatorio para las claves principales compuestas). Para obtener más información sobre claves principales, consulte [Clave principal](HowItWorks.CoreComponents.md#HowItWorks.CoreComponents.PrimaryKey).Tipo: Map, mapa de `HashKeyElement`, o bien de `HashKeyElement` y de `RangeKeyElement` si se trata de una clave principal compuesta. | 
| ProvisionedThroughput  | Rendimiento de la tabla especificada, que se compone de los valores de ReadCapacityUnits y WriteCapacityUnits. Consulte [Modo de capacidad aprovisionada de DynamoDB](provisioned-capacity-mode.md). | 
| ProvisionedThroughput: ReadCapacityUnits |  Cantidad mínima de `ReadCapacityUnits` consumidas por segundo para la tabla especificada antes de que DynamoDB equilibre la carga con otras operaciones. Tipo: Number  | 
| ProvisionedThroughput: WriteCapacityUnits | Cantidad mínima de `WriteCapacityUnits` consumidas por segundo para la tabla especificada antes de que DynamoDB equilibre la carga con otras operaciones.Tipo: Number  | 
|  TableName  |  Nombre de la tabla eliminada. Tipo: cadena   | 
|  TableStatus  | Estado actual de la tabla (DELETING). Una vez que se elimina la tabla, las solicitudes posteriores de la tabla devuelven resource not found. Use la operación [DescribeTables](API_DescribeTables_v20111205.md) para comprobar el estado de la tabla. Tipo: cadena | 

## Errores especiales
<a name="API_DeleteTable_SpecialErrors"></a>


****  

|  Error  |  Descripción  | 
| --- | --- | 
|  ResourceInUseException  |  La tabla se encuentra en el estado CREATING o UPDATING y no se puede eliminar.  | 

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

### Solicitud de ejemplo
<a name="API_DeleteTable_Examples_Request"></a>

```
// This header is abbreviated. For a sample of a complete header, see API de bajo nivel de 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"}
```

### Respuesta de ejemplo
<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"
}
```

## Acciones relacionadas
<a name="API_DeleteTable_Related_Actions"></a>
+  [CreateTable](API_CreateTable_v20111205.md) 
+  [DescribeTables](API_DescribeTables_v20111205.md)