获取指定路径下的文件信息
更新时间：2022-08-24
接口描述
本接口用于获取指定路径下的文件列表。
请求结构
GET /v1/bos/bucket/{bucketId}/path?currentPath={currentPath}&nextMarker={nextMarker}&maxKeys={maxKeys}&prefix={prefix} HTTP/1.1
Host: bec.baidubce.com
Authorization: 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> | 调用返回的结果数 |
错误码
请参照错误返回章节的内容。
请求示例
GET https://bec.baidubce.com/v1/bos/bucket/bkt-nk9a9xjp/path?currentPath= HTTP/1.1
Host: bec.baidubce.com
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
{
"currentPath": "",
}响应示例
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Date: Wed, 08 Jul 2015 03:28:11 GMT
x-bce-request-id: d8752367-38e8-45e4-b4c7-e53be3137ce5
Server: BWS
{
"objectBriefVoList": [
{
"bucketId": "bkt-nk9a9xjp",
"bucketName": "abc0",
"endpoint": "http://10.190.77.32:8080",
"authority": "PRIVATE",
"objectName": "01. 93 939 993 .jpeg",
"objectKey": "01. 93 939 993 .jpeg",
"objectType": "File",
"objectSize": 9070,
"lastModifyTime": "2020-05-08 11:13:10"
},
{
"bucketId": "bkt-nk9a9xjp",
"bucketName": "abc0",
"endpoint": "http://10.190.77.32:8080",
"authority": "PRIVATE",
"objectName": "0218.log",
"objectKey": "0218.log",
"objectType": "File",
"objectSize": 67102,
"lastModifyTime": "2020-05-08 13:50:44"
},
{
"bucketId": "bkt-nk9a9xjp",
"bucketName": "abc0",
"endpoint": "http://10.190.77.32:8080",
"authority": "PRIVATE",
"objectName": "0309.log",
"objectKey": "0309.log",
"objectType": "File",
"objectSize": 160143,
"lastModifyTime": "2020-05-08 14:23:11"
},
{
"bucketId": "bkt-nk9a9xjp",
"bucketName": "abc0",
"endpoint": "http://10.190.77.32:8080",
"authority": "PRIVATE",
"objectName": "1219一图看懂区块链.jpeg",
"objectKey": "1219一图看懂区块链.jpeg",
"objectType": "File",
"objectSize": 11193080,
"lastModifyTime": "2020-05-09 11:42:48"
},
{
"bucketId": "bkt-nk9a9xjp",
"bucketName": "abc0",
"endpoint": "http://10.190.77.32:8080",
"authority": "PRIVATE",
"objectName": "Zoom.pkg",
"objectKey": "Zoom.pkg",
"objectType": "File",
"objectSize": 13105965,
"lastModifyTime": "2020-05-07 15:45:22"
}
],
"objectNum": 5,
"nextMarker": "Zoom.pkg",
"truncated": true
}Model
ObjectBriefVo
| 参数名称 | 类型 | 描述 |
|---|---|---|
| bucketId | String | bucketId |
| bucketName | String | bucket名称 |
| endpoint | String | endpoint |
| authority | String | 权限 |
| objectName | String | 对象名称 |
| objectKey | String | 对象唯一标识 |
| objectType | String | 对象类型 |
| objectSize | int | 对象大小 |
| lastModifyTime | String | 上次更新时间 |