All Products
Search
Document Center

Drive and Photo Service:RestoreRevision

最終更新日:Aug 04, 2025

Restores a historical version of a file. You cannot restore the latest version 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.

Authorization information

There is currently no authorization information disclosed in the API.

Request syntax

POST /v2/file/revision/restore HTTP/1.1

Request parameters

ParameterTypeRequiredDescriptionExample
bodyobjectNo

The request parameters.

drive_idstringYes

The drive ID.

1
file_idstringYes

The file ID.

9520943DC264
revision_idstringYes

The version ID.

40CB7794C929

Response parameters

ParameterTypeDescriptionExample
Revision

The information about the version.

Examples

Sample success responses

JSONformat

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

Error codes

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