# 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` リクエストの後、指定されたテーブルは、DynamoDB が削除を完了するまで `DELETING` 状態になります。`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 にある場合、この 2 つの "MyTable" テーブルは相互に独立していてデータを共有しません。一方を削除しても、もう一方は削除されません。

テーブルのステータスを確認するには、[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 がロードとその他のオペレーションのバランスを取る前に、指定したテーブルで 1 秒あたりに消費される `ReadCapacityUnits` の最小数。型: 数値  | 
| ProvisionedThroughput: WriteCapacityUnits | DynamoDB がロードとその他のオペレーションのバランスを取る前に、指定したテーブルで 1 秒あたりに消費される `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)