ListTables - Amazon DynamoDB
説明リクエストレスポンス特殊なエラー例関連アクション

ListTables

重要

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

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

説明

現在のアカウントおよびエンドポイントに関連付けられたテーブルの配列を返します。

各 DynamoDB エンドポイントは完全に独立しています。例えば、"MyTable" というテーブルが dynamodb.us-west-2.amazonaws.com と dynamodb.us-east-1.amazonaws.com にある場合、この 2 つの "MyTable" テーブルは相互に独立していてデータを共有しません。ListTables オペレーションは、リクエストを受信するエンドポイントについて、リクエストを作成するアカウントに関連付けられたすべてのテーブル名を返します。

リクエスト

Syntax

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

{"ExclusiveStartTableName":"Table1","Limit":3}

デフォルトでは、ListTables オペレーションは、リクエストを受信するエンドポイントについて、リクエストを作成するアカウントに関連付けられたすべてのテーブル名をリクエストします。

名前 説明 必須
Limit

返されるテーブル名の最大数。

型: 整数

 いいえ
ExclusiveStartTableName

リストの最初のテーブルの名前。すでに ListTables オペレーションを実行し、レスポンスで LastEvaluatedTableName 値を受け取っている場合、その値をここで使用してリストを続行します。

型: 文字列

 [いいえ]

レスポンス

Syntax

HTTP/1.1 200 OK
x-amzn-RequestId: S1LEK2DPQP8OJNHVHL8OU2M7KRVV4KQNSO5AEMVJF66Q9ASUAAJG
content-type: application/x-amz-json-1.0
content-length: 81
Date: Fri, 21 Oct 2011 20:35:38 GMT

{"TableNames":["Table1","Table2","Table3"], "LastEvaluatedTableName":"Table3"}
名前 説明
TableNames

現在のエンドポイントの現在のアカウントに関連付けられているテーブルの名前。

型: 配列
LastEvaluatedTableName

現在のリストの最後のテーブルの名前 (アカウントとエンドポイントの一部のテーブルが返されていない場合のみ)。すべてのテーブル名がすでに返されている場合、この値はレスポンスに存在しません。すべてのテーブル名が返されるまでリストを続行するには、この値を新しいリクエスト内で ExclusiveStartTableName として使用します。

型: 文字列

特殊なエラー

このオペレーションに固有のエラーはありません。

例

次の例は、ListTables オペレーションを使用した HTTP POST リクエストとレスポンスを示しています。

リクエスト例

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

{"ExclusiveStartTableName":"comp2","Limit":3}

レスポンス例

HTTP/1.1 200 OK
x-amzn-RequestId: S1LEK2DPQP8OJNHVHL8OU2M7KRVV4KQNSO5AEMVJF66Q9ASUAAJG
content-type: application/x-amz-json-1.0
content-length: 81
Date: Fri, 21 Oct 2011 20:35:38 GMT

{"LastEvaluatedTableName":"comp5","TableNames":["comp3","comp4","comp5"]}