ListRevision - Drive and Photo Service - Alibaba Cloud Documentation Center

Queries the versions of a file.

Debugging

You can run this interface directly in OpenAPI Explorer, saving you the trouble of calculating signatures. After running successfully, OpenAPI Explorer can automatically generate SDK code samples.

Debug

Authorization information

There is currently no authorization information disclosed in the API.

Request syntax

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

Request parameters

Parameter	Type	Required	Description	Example
body	object	No	The request parameters.
drive_id	string	Yes	The drive ID.	1
file_id	string	Yes	The file ID.	9520943DC264
marker	string	No	The pagination token that is used in the next request to retrieve a new page of results. You do not need to specify this parameter for the first request. You must specify the token that is obtained from the previous query as the value of marker. By default, this parameter is left empty.	40CB7794C929
limit	long	No	The maximum number of results to return. Valid values: 1 to 100. Default value: 50. The number of returned results must be less than or equal to the specified number.	100
fields	string	No	Specifies the returned fields. By default, this parameter is left empty. If you set this parameter to *, all fields are returned. If you leave this parameter empty, the creator of the file is not returned.	*

Response parameters

Parameter	Type	Description	Example
	object	The response parameters.
items	array	The information about the versions.
	Revision	The information about a version.
next_marker	string	A pagination token. It can be used in the next request to retrieve a new page of results. If next_marker is empty, no next page exists.	NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg

Examples

Sample success responses

JSONformat

{
  "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": 3574582125365864400,
      "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"
}

Error codes

For a list of error codes, visit the Service error codes.