AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.
DELETING
state until DynamoDB
completes the deletion. If the table is in the ACTIVE
state, you can
delete it. If a table is in CREATING
or UPDATING
states,
then DynamoDB returns a ResourceInUseException. If the specified table does
not exist, DynamoDB returns a ResourceNotFoundException. If table is already
in the DELETING
state, no error is returned.
DynamoDB might continue to accept data read and write operations, such as GetItem
and PutItem, on a table in the DELETING
state until the table
deletion is complete.
When you delete a table, any indexes on that table are also deleted.
If you have DynamoDB Streams enabled on the table, then the corresponding stream on
that table goes into the DISABLED
state, and the stream is automatically
deleted after 24 hours.
Use the DescribeTable API to check the status of the table.
Namespace: Amazon.DynamoDBv2
Assembly: AWSSDK.dll
Version: (assembly version)
public abstract DeleteTableResponse DeleteTable( DeleteTableRequest request )
Container for the necessary parameters to execute the DeleteTable service method.
Exception | Condition |
---|---|
InternalServerErrorException | An error occurred on the server side. |
LimitExceededException | The number of concurrent table requests (cumulative number of tables in the CREATING, DELETING or UPDATING state) exceeds the maximum allowed of 10. Also, for tables with secondary indexes, only one of those tables can be in the CREATING state at any point in time. Do not attempt to create more than one such table simultaneously. The total limit of tables in the ACTIVE state is 250. |
ResourceInUseException | The operation conflicts with the resource's availability. For example, you attempted to recreate an existing table, or tried to delete a table currently in the CREATING state. |
ResourceNotFoundException | The operation tried to access a nonexistent table or index. The resource might not be specified correctly, or its status might not be ACTIVE. |
This example shows how to delete a table.
// Create a client AmazonDynamoDBClient client = new AmazonDynamoDBClient(); // Configure the DeleteTable request DeleteTableRequest request = new DeleteTableRequest { TableName = "SampleTable" }; // Issue DeleteTable request and retrieve the table description TableDescription tableDescription = client.DeleteTable(request).TableDescription; Console.WriteLine("Table name: {0}", tableDescription.TableName); Console.WriteLine("Table status: {0}", tableDescription.TableStatus);
.NET Framework:
Supported in: 4.5, 4.0, 3.5