ListTables - Amazon DynamoDB
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

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