全部产品
Search
文档中心

网盘与相册服务:UpdateRevision - 更新版本信息

更新时间:May 26, 2026

更新版本信息,设置版本为永久保留,或者添加版本描述信息。支持将一个文件的最多50个版本设置为永久保留。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求语法

POST /v2/file/revision/update HTTP/1.1

请求参数

名称

类型

必填

描述

示例值

domain_id

string

A short description of struct

body

object

请求体参数。

drive_id

string

空间 id

1

file_id

string

文件 id

9520943DC264

revision_id

string

版本 id

40CB7794C929

keep_forever

boolean

是否永久保留

默认不传递该参数,表示不修改版本的永久保留属性。

true

revision_description

string

版本描述信息,最长 1024 字符

默认不传递该参数,表示不修改版本的版本描述信息。

aaa

返回参数

名称

类型

描述

示例值

Revision

版本信息

示例

正常返回示例

JSON格式

{
  "domain_id": "bj1",
  "drive_id": "1",
  "file_id": "9520943DC264",
  "revision_id": "40CB7794C929",
  "revision_name": "1.mov",
  "revision_version": 1,
  "size": 1024,
  "file_extension": "mov",
  "created_at": "2019-08-20T06:51:27.292Z",
  "updated_at": "2019-08-20T06:51:27.292Z",
  "keep_forever": false,
  "revision_description": "aaa",
  "is_latest_version": false,
  "crc64_hash": "3574582125365864471",
  "content_hash": "EA4942AA8761213890A5C386F88E6464D2C31CA3",
  "content_hash_name": "sha1",
  "thumbnail": "https://data.aliyunpds.com/hz22%2F5d5b986facbec311ef844c25954f96821497b383%2F5d5b986f955410dd991646bb87c6b4e899eff525?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx\n",
  "url": "https://data.aliyunpds.com/hz22%2F5d5b986facbec311ef844c25954f96821497b383%2F5d5b986f955410dd991646bb87c6b4e899eff525?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx\n",
  "download_url": "https://data.aliyunpds.com/hz22%2F5d5b986facbec311ef844c25954f96821497b383%2F5d5b986f955410dd991646bb87c6b4e899eff525?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx\n",
  "creator_type": "",
  "creator_id": "",
  "creator_name": ""
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息,参考变更详情