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

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

ListTables

重要

This section refers to API version 2011-12-05, which is deprecated and should not be used for new applications.

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

Description

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

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

Requests

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

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

类型: Integer

ExclusiveStartTableName

列表开头的表的名称。如果您已运行 ListTables 操作并在响应中收到 LastEvaluatedTableName 值,请在此处使用该值继续列表。

类型: 字符串

Responses

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 以继续列表,直到返回所有表名。

类型: 字符串

特殊错误

没有特定于此操作的错误。

Examples

以下示例显示了使用 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"]}