# ListTables
<a name="API_ListTables_v20111205"></a>

**重要**  
***本节介绍已经弃用的 API 版本 2011-12-05，不应用于新应用程序。***  
 **有关当前低级别 API 的文档，请参阅 [Amazon DynamoDB API 参考](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/)。**

## 描述
<a name="API_ListTables_Description"></a>

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

每个 DynamoDB 端点完全独立。例如，如果您有两个名为“MyTable”的表，一个位于 dynamodb.us-west-2.amazonaws.com，另一个位于 dynamodb.us-east-1.amazonaws.com，则这两个表完全独立，不共享任何数据。ListTables 操作为接收请求的端点返回与发出请求的账户关联的所有表名称。

## 请求
<a name="API_ListTables_RequestParameters"></a>

### 语法
<a name="API_ListTables_RequestParameters.syntax"></a>

```
// 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` 值，则使用该值继续列表。 类型：字符串 | 否 | 

## 响应
<a name="API_ListTables_ResponseElements"></a>

### 语法
<a name="API_ListTables_ResponseElements.syntax"></a>

```
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` 以继续列表，直到返回所有表名称。 类型：字符串  | 

## 特殊错误
<a name="API_ListTables_SpecialErrors"></a>

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

## 示例
<a name="API_ListTables_Examples"></a>

以下示例显示使用 ListTables 操作的 HTTP POST 请求和响应。

### 示例请求
<a name="API_ListTables_Examples_Request"></a>

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

### 示例响应
<a name="API_ListTables_Examples_Response"></a>

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

## 相关操作
<a name="API_ListTables_Related_Actions"></a>
+  [DescribeTables](API_DescribeTables_v20111205.md) 
+  [CreateTable](API_CreateTable_v20111205.md) 
+  [DeleteTable](API_DeleteTable_v20111205.md)