本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 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)