Amazon DynamoDB
开发人员指南 (API Version 2012-08-10)
AWS 服务或AWS文档中描述的功能,可能因地区/位置而异。请点击 Amazon AWS 入门,可查看中国地区的具体差异

ListTables

重要

本节引用 API 版本 2011-12-05,此版本已被弃用且不应该用于新应用程序。

有关当前低级 API 的文档,请参阅 Amazon DynamoDB API Reference

说明

返回与当前账户和终端节点关联的所有表的数组。

每个 DynamoDB 终端节点都是完全独立的。举例来说,如果您有两个名为“MyTable”的表,一个位于 dynamodb.us-west-2.amazonaws.com 中,另一个位于 dynamodb.us-east-1.amazonaws.com 中,则它们是完全独立的,并且不共享任何数据。ListTables 操作会为接收请求的终端节点返回与发出请求的账户关联的所有表名。

请求

语法

Copy
// 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 值,请在此处使用该值以继续列出。

类型:字符串

响应

语法

Copy
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 请求和响应。

示例请求

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

示例响应

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