# 列举表
#### 功能介绍
指定仓列举创建的所有表。
#### URI
POST /v1/list-table
表1Query参数 
| 参数         | 是否必选 | 参数类型   | 描述                                                                                                                                                                                   |
|:---|:---|:---|:---|
| store_name | 否    | String | 仓名，全域唯一，不同租户的仓名不能相同。 - 格式：${prefix}-${region-code}-${account-id}，其中prefix为自定义前缀，region-code为kvs集群所在的区域代码，account-id为用户的账户id - 取值字符限制：\[a-z0-9-\]+ - 长度：\[16,52\] 说明： "-"不能出现在名字头部或尾部 |
#### 请求参数
表2请求Body参数 
| 参数          | 是否必选 | 参数类型    | 描述                                                                                    |
|:---|:---|:---|:---|
| cursor_name | 否    | String  | 上次返回游标位置，本次响应包含该table，空表示遍历完。 - 长度：\[3, 63\] - 取值字符限制：\[a-z0-9_-\]+ 说明： 如果为空，表示后面无更多。 |
| limit       | 否    | Integer | 响应返回的表个数。 - 长度：最大100                                                                  |
   
#### 响应参数
**状态码：200**
表3响应Body参数 
| 参数          | 参数类型             | 描述                                                                                       |
|:---|:---|:---|
| cursor_name | String           | 本次响应后的游标位置，下次请求时携带，如果为空，表示后面无更多。 - 长度：\[3, 63\] - 取值字符限制：\[a-z0-9_-\]+ 说明： 如果为空，表示后面无更多。 |
| table_names | Array of strings | 返回的表名列表。 - 长度：最大100                                                                      |
   
**状态码：400**
表4响应Body参数 
| 参数         | 参数类型   | 描述         |
|:---|:---|:---|
| error_code | String | 请求返回的错误码。  |
| error_msg  | String | 请求返回的错误信息。 |
   
#### 请求示例
列举指定仓中的表，限制返回表数量为2
```
POST https://{endpoint}/v1/list-table
{
  "limit" : 2
}
```
#### 响应示例
**状态码：200**
表示列举表请求成功
```
{
  "cursor_name" : "test-table-name_3",
  "table_name_list" : [ "test-table-name_1", "test-table-name_2" ]
}
```
#### 状态码
| 状态码 | 描述         |
|:---|:---|
| 200 | 表示列举表请求成功  |
| 400 | BadRequest |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-kvs/ErrorCode.html)。