全部产品
Search
文档中心

Drive and Photo Service:ListRevision

更新时间:Feb 26, 2026

Mengambil daftar versi suatu file.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

Sintaks permintaan

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

Parameter permintaan

Parameter

Type

Required

Description

Example

body

object

No

Parameter permintaan.

drive_id

string

Yes

ID drive.

1

file_id

string

Yes

ID file.

9520943DC264

marker

string

No

Token paginasi yang digunakan dalam permintaan berikutnya untuk mengambil halaman hasil baru. Anda tidak perlu menentukan parameter ini pada permintaan pertama. Anda harus menentukan token yang diperoleh dari kueri sebelumnya sebagai nilai marker.

Secara default, parameter ini dikosongkan.

40CB7794C929

limit

integer

No

Jumlah maksimum hasil yang dikembalikan. Nilai yang valid: 1 hingga 100.

Nilai default: 50.

Jumlah hasil yang dikembalikan harus kurang dari atau sama dengan jumlah yang ditentukan.

100

fields

string

No

Menentukan bidang-bidang yang dikembalikan.

Secara default, parameter ini dikosongkan. Jika Anda menyetel parameter ini ke *, semua bidang akan dikembalikan. Jika Anda mengosongkan parameter ini, pembuat file tidak akan dikembalikan.

*

Elemen respons

Element

Type

Description

Example

object

Parameter respons.

items

array

Informasi mengenai versi-versi tersebut.

Revision

Informasi mengenai suatu versi.

next_marker

string

Token paginasi. Token ini dapat digunakan dalam permintaan berikutnya untuk mengambil halaman hasil baru. Jika next_marker kosong, berarti tidak ada halaman berikutnya.

NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg

Contoh

Respons sukses

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

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.