更新版本信息,设置版本为永久保留,或者添加版本描述信息。支持将一个文件的最多50个版本设置为永久保留。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求语法
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": ""
}
错误码
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。