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

**重要**  
***本节介绍已经弃用的 API 版本 2011-12-05，不应用于新应用程序。***  
 **有关当前低级别 API 的文档，请参阅 [Amazon DynamoDB API 参考](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/)。**

## 描述
<a name="API_DeleteTable_Description"></a>

`DeleteTable` 操作删除表及其所有项目。`DeleteTable` 请求后，指定的表处于 `DELETING` 状态，直到 DynamoDB 完成删除。如果表处于 `ACTIVE` 状态，可以删除。如果表处于 `CREATING` 或 `UPDATING` 状态，DynamoDB 将返回一个 `ResourceInUseException` 错误。如果指定的表不存在，DynamoDB 将返回 `ResourceNotFoundException`。如果表已经处于 `DELETING` 状态，则不返回任何错误。

**注意**  
DynamoDB 可能会继续接受数据层面操作请求，如处于 `DELETING` 状态的表上的 `GetItem` 和 `PutItem`，直到表删除完成。

表在发出请求的 AWS 账户关联区域，以及接收请求的 AWS 区域（例如 dynamodb.us-west-1.amazonaws.com）中唯一。每个 DynamoDB 端点完全独立。例如，如果您有两个名为“MyTable”的表，一个位于 dynamodb.us-west-2.amazonaws.com，另一个位于 dynamodb.us-west-1.amazonaws.com，则这两个表完全独立，不共享任何数据；删除一个表不会删除另一个表。

使用 [DescribeTables](API_DescribeTables_v20111205.md) 操作检查表的状态。

## 请求
<a name="API_DeleteTable_RequestParameters"></a>

### 语法
<a name="API_DeleteTable_RequestParameters.syntax"></a>

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

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


****  

|  名称  |  描述  |  必填 | 
| --- | --- | --- | 
|  TableName  |   要删除的表的名称。  类型：字符串   |  是  | 

## 响应
<a name="API_DeleteTable_CommonResponseElements"></a>

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


****  

|  名称  |  描述  | 
| --- | --- | 
| TableDescription  | 表属性的容器。 | 
| CreationDateTime | 表的创建日期。类型：数字  | 
| KeySchema  | 表的主键（简单或复合）结构。`HashKeyElement` 的名称-值对是必填的，`RangeKeyElement` 的名称-值对是可选的（只有复合主键需要）。有关主键的更多信息，请参阅 [主键](HowItWorks.CoreComponents.md#HowItWorks.CoreComponents.PrimaryKey)。类型：`HashKeyElement` 的映射，或者复合主键的 `HashKeyElement` 和 `RangeKeyElement`。 | 
| ProvisionedThroughput  | 指定的表的吞吐量，由 ReadCapacityUnits 和 WriteCapacityUnits 的值组成。请参阅 [DynamoDB 预置容量模式](provisioned-capacity-mode.md)。 | 
| ProvisionedThroughput: ReadCapacityUnits |  DynamoDB 平衡负载和其他操作前，指定表每秒消耗的 `ReadCapacityUnits` 的最小数量。类型：数字  | 
| ProvisionedThroughput: WriteCapacityUnits | DynamoDB 平衡负载和其他操作前，指定表每秒消耗的 `WriteCapacityUnits` 的最小数量。类型：数字  | 
|  TableName  |  已删除的表的名称。 类型：字符串   | 
|  TableStatus  | 表的当前状态 (DELETING)。删除表后，对表的后续请求将返回 resource not found。使用 [DescribeTables](API_DescribeTables_v20111205.md) 操作检查表的状态。类型：字符串 | 

## 特殊错误
<a name="API_DeleteTable_SpecialErrors"></a>


****  

|  错误  |  描述  | 
| --- | --- | 
|  ResourceInUseException  |  表处于 CREATING 或 UPDATING 状态，无法删除。 | 

## 示例
<a name="API_DeleteTable_Examples"></a>

### 示例请求
<a name="API_DeleteTable_Examples_Request"></a>

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

### 示例响应
<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"
}
```

## 相关操作
<a name="API_DeleteTable_Related_Actions"></a>
+  [CreateTable](API_CreateTable_v20111205.md) 
+  [DescribeTables](API_DescribeTables_v20111205.md)