本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 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)