列举备份文件 - listBackupFile
功能介绍
列举备份文件
授权信息
当前API调用无需身份策略权限。
URI
GET /koodrive/ose/v1/backup/record/{recordId}/files
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| recordId | 是 | String | 参数解释: 备份记录id 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| pageSize | 是 | Integer | 参数解释: 每页大小 约束限制: 不涉及 取值范围: 1-100 默认取值: 不涉及 |
| cursor | 否 | String | 参数解释: 游标 约束限制: 不涉及 取值范围: 长度最大为1000 默认取值: 不涉及 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | String | 参数解释: 该字段存储的是 Access Token。 调用KooDrive的API使用Token认证,拥有Token就代表拥有某种权限,在调用API的时候将Token加到请求消息头中,从而通过身份认证,获得操作API的权限。 约束限制: 格式参考:Bearer+/access token} 取值范围: Access Token的获取请参考对应的开发手册 默认取值: 不涉及 |
| X-User-Id | 是 | String | 参数解释: koodrive侧用户id,用于appId鉴权 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
| X-Date | 是 | String | 参数解释: 签名时间,用于appId鉴权 约束限制: 距当前时间15分钟以内,不能晚于当前时间 取值范围: yyyMMdd'T'HHmmss'Z',例:20251103T070140Z 默认取值: 不涉及 参数解释: 签名时间,用于appId鉴权 约束限制: 距当前时间15分钟以内,不能晚于当前时间 取值范围: yyyMMdd'T'HHmmss'Z',例:20251103T070140Z 默认取值: 不涉及 |
响应参数
状态码:200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| code | Integer | 状态码 |
| msg | String | 状态描述 |
| data | Array of BackupFile objects | 备份文件信息列表 |
| nextCursor | String | 下页游标 |
请求示例
列举备份文件请求示例
/koodrive/ose/v1/backup/record/1842862763295184641/files?pageSize=1 Authorization:Bearer+60f4ccc7b1********3dd9a68068 x-backup-lock-id: 78e41c7e-db02-4d55-85b3-8153e4fefd2e@102
响应示例
状态码:200
列举备份文件响应体
{
"data" : [ {
"fileId" : "FuxCm9nVttfaIdohnfs1BB6hNdU2w7bX2",
"fileName" : "123.jpg",
"sha256" : "5b7be4c0c1b6f6a4107f2b8d40661c9c06c50fa9d2b7ba0c439a386cd18c3c33",
"size" : "2139005",
"createTime" : "2025-12-18T01:22:58.738Z"
} ],
"code" : 0,
"msg" : "成功"
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | 列举备份文件响应体 |