ファイルのバージョン一覧を照会します。
今すぐお試しください
テスト
RAM 認証
リクエスト構文
POST /v2/file/revision/list HTTP/1.1リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| 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 |
レスポンスパラメーターです。 |
||
| items |
array |
バージョン情報です。 |
|
| Revision |
単一バージョンの情報です。 |
||
| next_marker |
string |
ページネーショントークンです。次のリクエストで新しい結果ページを取得する際に使用します。next_marker が空の場合、次のページは存在しません。 |
NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg |
例
成功レスポンス
JSONJSON
{
"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"
}エラーコード
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。