全部产品
Search
文档中心

网盘与相册服务:ListRevision - 列举版本

更新时间:May 26, 2026

列举版本信息。

调试

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

调试

授权信息

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

请求语法

POST /v2/file/revision/list HTTP/1.1

请求参数

名称

类型

必填

描述

示例值

domain_id

string

A short description of struct

body

object

请求体参数。

drive_id

string

空间 id

1

file_id

string

文件 id

9520943DC264

marker

string

设定结果从 marker 之后按字母排序的第一个开始返回。如果不设定,则从头开始返回数据。

默认值:无

40CB7794C929

limit

integer

限定此次返回资源的数量,取值范围[1,100]。

默认值为 50

返回结果可以小于指定的数量,但不能多于指定的数量。

100

fields

string

筛选返回字段

默认为空。当填 * 时,返回所有字段,会比为空时多返回创建者名称。

*

返回参数

名称

类型

描述

示例值

object

Schema of Response

items

array

版本信息数组

Revision

版本信息

next_marker

string

下一页起始资源标识符, 最后一页该值为空

NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg

示例

正常返回示例

JSON格式

{
  "items": [
    {
      "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": ""
    }
  ],
  "next_marker": "NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg"
}

错误码

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

变更历史

更多信息,参考变更详情