AWS SDK for .NET Documentation
DeleteTable Method (deleteTableRequest)
Amazon ► Amazon.DynamoDBv2 ► AmazonDynamoDB ► DeleteTable(DeleteTableRequest)
Did this page help you? Yes No Tell us about it...

The DeleteTable operation deletes a table and all of its items. After a DeleteTable request, the specified table is in the 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.

NOTE: 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.

Use the DescribeTable API to check the status of the table.

Declaration Syntax

C#

    DeleteTableResponse DeleteTable(
    	DeleteTableRequest deleteTableRequest
    )

Parameters

deleteTableRequest (DeleteTableRequest)
  Container for the necessary parameters to execute the DeleteTable service method on AmazonDynamoDBv2.

Return Value
The response from the DeleteTable service method, as returned by AmazonDynamoDBv2.
Examples

This example shows how to delete a table.

CopyDeleteTable sample

    // 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).DeleteTableResult.TableDescription;
    Console.WriteLine("Table name: {0}", tableDescription.TableName);
    Console.WriteLine("Table status: {0}", tableDescription.TableStatus);

Exceptions

Exception | Condition
--- | ---
ResourceInUseException |
ResourceNotFoundException |
LimitExceededException |
InternalServerErrorException |

Assembly: AWSSDK (Module: AWSSDK) Version: 1.5.60.0 (1.5.60.0)