DeleteTable

重要

このセクションでは、API バージョン 2011-12-05 について言及しています。これは非推奨なので、新しいアプリケーションに使用しないでください。

現在の低レベルの API に関するドキュメントについては、Amazon DynamoDB API リファレンスを参照してください。

説明

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 オペレーションを使用します。

リクエスト

構文

// 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	削除するテーブルの名前。 型: 文字列	はい

レスポンス

構文

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 の名前と値のペアはオプションです (複合プライマリキーにのみ必要)。プライマリキーの詳細については、「プライマリキー」を参照してください。 型: 複合プライマリキーの HashKeyElement、または HashKeyElement および RangeKeyElement のマップ。
ProvisionedThroughput	指定したテーブルのスループット (ReadCapacityUnits と WriteCapacityUnits の値で構成されます)。「DynamoDB プロビジョンドキャパシティモード」を参照してください。
ProvisionedThroughput: ReadCapacityUnits	DynamoDB がロードとその他のオペレーションのバランスを取る前に、指定したテーブルで 1 秒あたりに消費される ReadCapacityUnits の最小数。 型: 数値
ProvisionedThroughput: WriteCapacityUnits	DynamoDB がロードとその他のオペレーションのバランスを取る前に、指定したテーブルで 1 秒あたりに消費される WriteCapacityUnits の最小数。 型: 数値
TableName	削除されたテーブルの名前。 型: 文字列
TableStatus	テーブルの現在の状態 (DELETING)。テーブルが削除されると、テーブルに対する後続のリクエストは resource not found を返します。 テーブルのステータスを確認するには、DescribeTables オペレーションを使用します。 型: 文字列

特殊なエラー

エラー	説明
ResourceInUseException	CREATING または UPDATING の状態のテーブルは削除できません。

例

リクエスト例

// 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"}

レスポンス例

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"
}

関連アクション

• CreateTable

• DescribeTables