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 中，則兩者完全獨立，不會共用任何資料。ListTables 操作會針對接收請求的端點，傳回與發出請求之帳戶相關聯的所有資料表名稱。

請求

語法

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

要傳回的資料表名稱上限數。

類型：Integer

 否
ExclusiveStartTableName

清單之首的資料表名稱。如果您已執行 ListTables 操作並收到 LastEvaluatedTableName 值，請在此處使用該值繼續清單。

類型：字串

 否

回應

語法

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