文档首页/ 云空间服务 KooDrive/ API参考/ API/ 文件多版本/ 修改指定文件、指定版本 ID 的版本信息 - updateRevision
更新时间:2025-10-21 GMT+08:00

修改指定文件、指定版本 ID 的版本信息 - updateRevision

功能介绍

修改指定文件、指定版本 ID 的版本信息。 注:目前仅用于修改版本是否永久保留。

授权信息

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

URI

POST /koodrive/ose/v1/revision/updateRevision

请求参数

表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鉴权

Host

String

地址,用于app鉴权

X-Traceid

String

消息日志跟踪标识(必须58位)

表2 请求Body参数

参数

是否必选

参数类型

描述

containerId

String

空间ID

fileId

String

文件ID

revisionId

String

文件的assetId+versionId

keepForever

Boolean

是否永久保留true:永久保留false:由平台根据规则自动清理

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

code

String

响应码

msg

String

响应信息

请求示例

修改指定文件、指定版本 ID 的版本信息

POST /koodrive/ose/v1/revision/updateRevision

Authorization:Bearer+10f88d07fa************44791e9ff

{
  "containerId": "IAAFotBZGfP8nAncA1605110969531523201",
  "fileId": "FqX2B_dehFwue-TwoyUZKr787_QLwo2AL",
    "revisionId": "1618739290026578816.1763131768673766528",
    "keepForever": true
}

响应示例

状态码:200

修改完成响应

{
  "code" : 0,
  "msg" : "成功"
}

状态码

状态码

描述

200

修改完成响应