文档首页/ 云空间服务 KooDrive/ API参考（运营商）/ API/ 文件多版本/ 列举指定文件的所有版本信息 - listRevision
更新时间：2026-04-16 GMT+08:00
查看PDF
分享

列举指定文件的所有版本信息 - listRevision

功能介绍

列举指定文件的所有版本信息。

授权信息

当前API调用无需身份策略权限。

URI

POST /koodrive/ose/v1/revision/listRevision

请求参数

表1 请求Header参数

参数

是否必选

参数类型

描述

Authorization

是

String

该字段存储的是Access Token。调用KooDrive的API使用Token认证，拥有Token就代表拥有某种权限，在调用API的时候将Token加到请求消息头中，从而通过身份认证，获得操作API的权限。Access Token的获取请参考对应的开发手册，格式参考：Bearer+{access_token}

X-User-Id

是

String

用户id，用于app鉴权

X-Date

是

String

日期，用于app鉴权

X-Traceid

否

String

消息日志跟踪标识（必须58位）
表2 请求Body参数

参数

是否必选

参数类型

描述

pageInfo

否

PageInfo object

分页信息

containerId

是

String

空间ID

fileId

是

String

文件ID

fields

否

String

当前只支持*，不传默认为*
表3 PageInfo

参数

是否必选

参数类型

描述

pageSize

否

Integer

参数解释：

每页文件数量，

约束限制：

不涉及

取值范围：

取值范围[1,100]

默认取值：

默认100

pageCursor

否

String

参数解释：

分页起始游标

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

响应参数

状态码：200

表4 响应Body参数

参数

参数类型

描述

revisionList

Array of FileRevisionInfo objects

文件版本信息列表默认按版本创建时间降序排序注：列举版本信息时FileRevisionInfo 不返回downloadUrl

nextPageCursor

String

下一页起始游标，最后一页值为空
表5 FileRevisionInfo

参数

参数类型

描述

containerId

String

空间ID

fileId

String

文件ID

revisionId

String

版本ID（就是云空间返回的assetId+"."+versionId）

revisionVersion

Long

版本号，唯一递增

keepForever

Boolean

是否永久保留

latestVersion

Boolean

是否为最新版本，对比版本id和files.get.metadata的版本id是否一致

createReason

Integer

版本创建缘由详见枚举类型RevisionCreateReason，1 创建文件；2 历史版本恢复

createdAt

Long

创建时间，毫秒时间戳，云空间版本查询接口的createdTime

createdBy

String

查询接口返回的attributes的createdBy

updatedAt

Long

更新时间，毫秒时间戳，云空间版本查询接口的editedTime

updatedBy

String

修改者ID，查询响应的lastEditor的userId可以解析出三方id

name

String

文件名称（包含扩展名）禁止出现以下9 个非法字符：''、'/'、':'、'*'、'?'、'"'、'<'、'>'、'|'

size

Long

文件大小单位：字节

extension

String

文件扩展名注：不区分大小写

fileType

Integer

查看接口的attributes的fileType

description

String

描述，files.get.metadat获取description

sha256

String

文件内容Hash 值，十六进制字符串注：不区分大小写

downloadUrl

String

指定版本的文件下载地址

metadataAuditInfo

FileAuditInfo object

文件元信息审核信息

contentAuditInfo

FileAuditInfo object

文件内容审核信息注：仅普通文件返回
表6 FileAuditInfo

参数

参数类型

描述

auditDetail

String

审核详情

请求示例

列举指定文件的所有版本信息

POST /koodrive/ose/v1/revision/listRevision

Authorization:Bearer+10f88d07fa************44791e9ff
{
  "containerId": "IAAAKIRZGifzJgncA1605122035640590977",
  "fileId": "FkiferVNK5NwXck7XXBhPLIRhV1GayJPc",
    "pageInfo": {
        "pageSize": 100,
        "pageCursor": null
    }
}

响应示例

状态码：200

列举指定文件的所有版本信息

{
    "code": 0,
    "msg": "success",
    "revisionList": [
        {
            "containerId": "IAAAKIRZGifzJgncA1605122035640590977",
            "fileId": "FkiferVNK5NwXck7XXBhPLIRhV1GayJPc",
            "revisionId": "1756003706882580864.1763168515927411840",
            "revisionVersion": 13671,
            "keepForever": true,
            "latestVersion": true,
            "createdAt": 1740536019896,
            "createdBy": "ee33a28d0f454801b4532233258822e4",
            "updatedAt": 1756458066178,
            "updatedBy": "ZWUzM2EyOGQwZjQ1NDgwMWI0NTMyMjMzMjU4ODIyZTQtMTYwNTEwNzExNTIwOTQxNzM0NA",
            "name": "ee33a28d0f454801b4532233258822e4",
            "size": 33282,
            "extension": "呜呜.png",
            "fileType": 15,
            "sha256": "c3311df6e54f32456f886deb890420e12bf46192271377f08cf33f143f3c8c56",
            "downloadUrl": "https://b10-obs-ykj-uat-01.obs.cidc-rp-2006.joint.cmecloud.cn/a5cb1d1dcd00481e8a1c2ad0538b0cad086?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=MKRISPBZAJWFHNBJ5WLB%2F20250902%2Fcidc-rp-2006%2Fs3%2Faws4_request&X-Amz-Date=20250902T104653Z&X-Amz-Expires=3600&X-Amz-SignedHeaders=host&response-content-disposition=attachment%3B%20filename%3D%22%25E5%2591%259C%25E5%2591%259C.png%22&X-Amz-Signature=f6135c79a56fdc8e8b47abde69f8ea80efd29eb3aaa602073c8eeb5ce0491e21",
        }
    ]
}

状态码

状态码

描述

200

列举指定文件的所有版本信息
父主题： 文件多版本