delete_table¶
Operation¶
async
¶
delete_table(input: DeleteTableInput, plugins: list[Plugin] | None = None) -> DeleteTableOutput
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. For the full list of table states, see
TableStatus.
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 action to check the status of the table.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
input
|
DeleteTableInput
|
An instance of |
required |
plugins
|
list[Plugin] | None
|
A list of callables that modify the configuration dynamically. Changes made by these plugins only apply for the duration of the operation execution and will not affect any other operation invocations. |
None
|
Returns:
| Type | Description |
|---|---|
DeleteTableOutput
|
An instance of |
Input¶
dataclass
¶
Output¶
dataclass
¶
Represents the output of a DeleteTable operation.
Attributes¶
class-attribute
instance-attribute
¶
table_description: TableDescription | None = None
Represents the properties of a table.