# 列举目录下文件 - ListFile
#### 功能介绍
列举存储中某目录下文件。
#### URI
GET*华为云Astro轻应用域名* /u-route/baas/sys/v1.1/connectors/{connector_type}/{connector_name}/listdir?*dir=path\&max-keys=A*\&marker=B
表1路径参数 
| 参数             | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
|:---|:---|:---|:---|
| connector_type | 是    | String | **参数解释**： 连接器的类型。 **约束限制**： 不涉及。 **取值范围**： - obs：与OBS对接的连接器。  - minio：与MINIO对接的连接器。  - objectstorageproxy：对象存储代理类型。   **默认取值**： 不涉及。 |
| connector_name | 是    | String | **参数解释**： 连接器实例的名称，即创建连接器时设置的连接器实例名。 **约束限制**： 不涉及。 **取值范围**： 不涉及。 **默认取值**： 不涉及。                                                                                                                                                                                                                                                                             |
| dir            | 是    | String | **参数解释**： 要列举的目录，如果目录为空或者"/ "，则代表列举根目录。 **约束限制**： 不涉及。 **取值范围**： 不涉及。 **默认取值**： 不涉及。                                                                                                                                                                                                                                                                              |
| max-keys       | 否    | Number | **参数解释**： 最大访问文件个数，最大支持1000个，缺省值为"1000"。 **约束限制**： 不涉及。 **取值范围**： 不涉及。 **默认取值**： 不涉及。                                                                                                                                                                                                                                                                         |
| marker         | 否    | String | **参数解释**： 起始访问位置文件，注意起始位置文件并不会包含到返回结果中，且起始访问文件必须是全路径的，即包含目录。 如果不指定，则从头开始。 示例：marker=a/b/c/1.txt。 **约束限制**： 不涉及。 **取值范围**： 不涉及。 **默认取值**： 不涉及。                                                                                                                                                                            |
   
#### 请求参数
无
#### 响应参数
表2响应参数说明 
| 参数      | 参数类型             | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                |
|:---|:---|:---|
| resCode | String           | **参数解释**： 返回码。 **取值范围**： 如果返回"0"代表请求成功，其他错误码说明请参考[错误码（数据面）](https://support.huaweicloud.com/api-astrozero/astrozero_api_0082.html)。                                                                                                                                                                                   |
| resMsg  | String           | **参数解释**： 返回消息。 **取值范围**： 成功返回"成功"，其他情况会返回具体的错误信息。                                                                                                                                                                                                                                                                 |
| result  | Array of objects | **参数解释**： 返回目录的文件列表，列表中元素字段含义如下： - name：文件名或目录路径。  - isDir：是否为目录。  - size：文件大小。   |
   
#### 请求示例
已创建好OBS类型连接器，连接器实例名称为"命名空间__TestOBS"，执行如下请求，列举OBS桶中"a/b/c"路径下文件，起始文件为"1.txt"。
```
GET https://华为云Astro轻应用域名/u-route/baas/sys/v1.1/connectors/obs/命名空间__TestOBS/listdir?dir=a/b/c&max-keys=1000&marker=a/b/c/1.txt
```
#### 响应示例
```
{
 "resCode": "0",
 "resMsg": "成功",
 "result": [{
   "name": "test.zip",
   "isDir": false,
   "size": 833154
  },
  {
   "name": "图片_20201220181511.png",
   "isDir": false,
   "size": 78530
  },
  {
   "name": "月度总结.txt",
   "isDir": false,
   "size": 824
  }
 ]
}
```
#### 状态码
状态码请参见[状态码](https://support.huaweicloud.com/api-astrozero/astrozero_api_0081.html)。
#### 错误码
错误码请参见[错误码（数据面）](https://support.huaweicloud.com/api-astrozero/astrozero_api_0082.html)。