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

要返回的表名称最大数量。

类型：整数

 不支持
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"]}