DeleteTable - Amazon DynamoDB
DescripciónSolicitudesRespuestasErrores especialesEjemplosAcciones relacionadas

DeleteTable

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.

Descripción

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 para comprobar el estado de la tabla.

Solicitudes

Sintaxis

// 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

Sintaxis

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.

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.
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 para comprobar el estado de la tabla.

Tipo: cadena

Errores especiales

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

Ejemplos

Solicitud de ejemplo

// 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

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