获取指定路径下的文件信息
更新时间：2025-08-05
接口描述
本接口用于获取指定路径下的文件列表。
请求结构
Plain Text
1GET /v1/bos/bucket/{bucketId}/path?currentPath={currentPath}&nextMarker={nextMarker}&maxKeys={maxKeys}&prefix={prefix} HTTP/1.1
2Host: bec.baidubce.com
3Authorization: authorization string请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必选 | 参数位置 | 描述 |
|---|---|---|---|---|
| bucketId | String | 是 | URL参数 | bucketId |
| currentPath | String | 是 | Query参数 | 指定的获取路径，应以"/"符号结尾，不能以"/"符号作为开头，为空时代表根目录 |
| nextMarker | String | 否 | RequestParam参数 | 剩余文件列表的起始 |
| maxKeys | int | 否 | RequestParam参数 | 每次最大展示的文件数,默认100 |
| prefix | String | 否 | RequestParam参数 | 搜索以prefix为前缀的object |
响应头域
除公共头域外，无其它特殊头域。
响应参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| objectNum | int | 调用返回的结果数 |
| nextMarker | String | 用于获取剩余文件列表，若truncated为false则该字段为null |
| truncated | Boolean | 为ture代表结果中的文件列表被截断，可以传入nextMarker获取剩余的文件列表 |
| objectBriefVoList | List<ObjectBriefVo> | 调用返回的结果数 |
错误码
请参照错误返回章节的内容。
请求示例
JSON
1GET https://bec.baidubce.com/v1/bos/bucket/bkt-nk9a9xjp/path?currentPath= HTTP/1.1
2Host: bec.baidubce.com
3Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
4{
5 "currentPath": "",
6}响应示例
JSON
1HTTP/1.1 200 OK
2Content-Type: application/json;charset=UTF-8
3Date: Wed, 08 Jul 2015 03:28:11 GMT
4x-bce-request-id: d8752367-38e8-45e4-b4c7-e53be3137ce5
5Server: BWS
6{
7 "objectBriefVoList": [
8 {
9 "bucketId": "bkt-nk9a9xjp",
10 "bucketName": "abc0",
11 "endpoint": "http://10.190.77.32:8080",
12 "authority": "PRIVATE",
13 "objectName": "01. 93 939 993 .jpeg",
14 "objectKey": "01. 93 939 993 .jpeg",
15 "objectType": "File",
16 "objectSize": 9070,
17 "lastModifyTime": "2020-05-08 11:13:10"
18 },
19 {
20 "bucketId": "bkt-nk9a9xjp",
21 "bucketName": "abc0",
22 "endpoint": "http://10.190.77.32:8080",
23 "authority": "PRIVATE",
24 "objectName": "0218.log",
25 "objectKey": "0218.log",
26 "objectType": "File",
27 "objectSize": 67102,
28 "lastModifyTime": "2020-05-08 13:50:44"
29 },
30 {
31 "bucketId": "bkt-nk9a9xjp",
32 "bucketName": "abc0",
33 "endpoint": "http://10.190.77.32:8080",
34 "authority": "PRIVATE",
35 "objectName": "0309.log",
36 "objectKey": "0309.log",
37 "objectType": "File",
38 "objectSize": 160143,
39 "lastModifyTime": "2020-05-08 14:23:11"
40 },
41 {
42 "bucketId": "bkt-nk9a9xjp",
43 "bucketName": "abc0",
44 "endpoint": "http://10.190.77.32:8080",
45 "authority": "PRIVATE",
46 "objectName": "1219一图看懂区块链.jpeg",
47 "objectKey": "1219一图看懂区块链.jpeg",
48 "objectType": "File",
49 "objectSize": 11193080,
50 "lastModifyTime": "2020-05-09 11:42:48"
51 },
52 {
53 "bucketId": "bkt-nk9a9xjp",
54 "bucketName": "abc0",
55 "endpoint": "http://10.190.77.32:8080",
56 "authority": "PRIVATE",
57 "objectName": "Zoom.pkg",
58 "objectKey": "Zoom.pkg",
59 "objectType": "File",
60 "objectSize": 13105965,
61 "lastModifyTime": "2020-05-07 15:45:22"
62 }
63 ],
64 "objectNum": 5,
65 "nextMarker": "Zoom.pkg",
66 "truncated": true
67}Model
ObjectBriefVo
| 参数名称 | 类型 | 描述 |
|---|---|---|
| bucketId | String | bucketId |
| bucketName | String | bucket名称 |
| endpoint | String | endpoint |
| authority | String | 权限 |
| objectName | String | 对象名称 |
| objectKey | String | 对象唯一标识 |
| objectType | String | 对象类型 |
| objectSize | int | 对象大小 |
| lastModifyTime | String | 上次更新时间 |