列举目录下文件 - ListFile
功能介绍
列举存储中某目录下文件。
URI
GET 华为云Astro轻应用域名/u-route/baas/sys/v1.1/connectors/{connector_type}/{connector_name}/listdir?dir=path&max-keys=A&marker=B
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| connector_type | 是 | String | 参数解释： 连接器的类型。 约束限制： 不涉及。 取值范围：
默认取值： 不涉及。 |
| connector_name | 是 | String | 参数解释： 连接器实例的名称，即创建连接器时设置的连接器实例名。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 |
| dir | 是 | String | 参数解释： 要列举的目录，如果目录为空或者“/ ”，则代表列举根目录。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 |
| max-keys | 否 | Number | 参数解释： 最大访问文件个数，最大支持1000个，缺省值为“1000”。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 |
| marker | 否 | String | 参数解释： 起始访问位置文件，注意起始位置文件并不会包含到返回结果中，且起始访问文件必须是全路径的，即包含目录。 如果不指定，则从头开始。 示例：marker=a/b/c/1.txt。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 |
请求参数
无
响应参数
| 参数 | 参数类型 | 描述 |
|---|---|---|
| resCode | String | 参数解释： 返回码。 取值范围： 如果返回“0”代表请求成功，其他错误码说明请参考错误码。 |
| resMsg | String | 参数解释： 返回消息。 取值范围： 成功返回“成功”，其他情况会返回具体的错误信息。 |
| result | Array of objects | 参数解释： 返回目录的文件列表，列表中元素字段含义如下：
|
请求示例
已创建好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
}
]
} 状态码
状态码请参见状态码。
错误码
错误码请参见错误码。
