Apa itu versi historis dari sebuah file? - Drive and Photo Service

Topik ini menjelaskan fitur versi historis dari Drive and Photo Service (Edisi Pengembang). Anda dapat menggunakan fitur versi historis di BasicUI default yang disediakan oleh PDS. Anda juga dapat memanggil operasi API dari PDS untuk mengelola versi historis dari sebuah file dengan merujuk pada topik ini.

Konsep dasar

File dan folder disimpan dalam struktur pohon di ruang pribadi atau drive perusahaan.

Folder tidak memiliki versi historis, sedangkan sebuah file dapat memiliki hingga n versi historis. Nilai n adalah bilangan bulat yang lebih besar dari atau sama dengan 1.
Versi file dihasilkan setelah Anda membuat atau memodifikasi file.
Setelah Anda membuat file, file tersebut hanya memiliki satu versi.
Setelah Anda memodifikasi atau menimpa file yang ada, versi baru dari file dihasilkan.
Jika fitur versi historis dinonaktifkan, hanya versi terbaru dari file yang disimpan.
Jika fitur versi historis diaktifkan, versi file saat ini disimpan sebagai versi historis setelah versi baru dihasilkan. Jumlah versi historis dikontrol berdasarkan aturan yang telah dikonfigurasi.
Versi historis dari sebuah file memakan ruang penyimpanan di drive Anda.

Deskripsi fitur

Anda dapat mengaktifkan fitur versi historis untuk mencadangkan beberapa versi dari sebuah file. Dengan cara ini, Anda dapat menyimpan file beserta versi historisnya dan dengan mudah memulihkan file jika file tersebut tertimpa atau salah dimodifikasi.
Jika Anda memodifikasi atau menimpa file, versi baru dari file akan dihasilkan. Anda dapat melihat semua versi historis dari file, melihat detail versi historis, memulihkan versi historis, atau menghapus versi historis. Anda juga dapat menambahkan tag ke versi historis file.
Anda dapat mengonfigurasi periode retensi untuk versi historis dari sebuah file. Periode retensi berkisar antara 1 hingga 999 hari. Anda juga dapat menyimpan versi historis tertentu secara permanen dan mengonfigurasi penggabungan versi historis secara berkala untuk mencegah akumulasi versi historis.
Anda dapat menyimpan hingga 999 versi historis dari sebuah file dan hingga 50 versi historis secara permanen. Versi historis yang disimpan secara permanen tidak akan dihapus meskipun periode retensi berakhir atau jumlah maksimum versi historis terlampaui.

Prasyarat

Sebuah PDS Developer Edition telah dibuat.
Hanya administrator super atau administrator drive yang dapat mengaktifkan fitur ini.
BasicUI harus diaktifkan. Untuk informasi lebih lanjut, lihat Aktifkan BasicUI.

Aktifkan fitur versi historis

Masuk ke BasicUI dan buka konsol admin. Untuk informasi tentang cara masuk ke BasicUI, lihat Masuk ke BasicUI.
Di panel navigasi sebelah kiri, pilih Enterprise Settings > File Settings.
Aktifkan Historical Version.

Konfigurasi versi historis

Anda dapat mengklik Edit di pojok kanan atas halaman File Settings untuk memodifikasi konfigurasi versi historis.

Fitur	Deskripsi
Merge file history versions	Fitur ini diaktifkan secara default. Jika fitur ini diaktifkan, beberapa versi file yang dihasilkan dalam waktu 10 menit digabungkan dan hanya versi historis terbaru dari file yang disimpan. Ini mencegah banyak versi historis dihasilkan jika file sering disimpan setelah Anda melakukan operasi pada file, seperti memodifikasi dan menyimpan file secara online atau menyinkronkan file antara disk lokal dan cloud drive. Jika fitur ini dinonaktifkan, versi historis file dihasilkan setiap kali Anda menyimpan file secara manual atau file disimpan secara otomatis.
Set the upper limit of the number of versions	Anda dapat mengatur nilai menjadi bilangan bulat antara 1 dan 999. Kecuali versi historis yang disimpan secara permanen, versi historis lainnya yang melebihi batas atas akan dihapus secara otomatis. Terlalu banyak versi historis dapat menyebabkan manajemen versi menjadi kacau dan memakan terlalu banyak ruang penyimpanan. Kami sarankan Anda mengatur nilai yang wajar.
Set the version storage period	Anda dapat mengatur nilai menjadi bilangan bulat antara 1 dan 999. Unit: hari. Kecuali versi historis yang disimpan secara permanen, versi historis lainnya yang melebihi periode penyimpanan akan dihapus secara otomatis. Versi historis jangka panjang dapat menyebabkan manajemen versi menjadi kacau dan memakan terlalu banyak ruang penyimpanan. Kami sarankan Anda mengatur nilai yang wajar.

Operasi API dan contoh panggilan

CreateFile

Setelah Anda mengunggah file ke PDS untuk membuat file, file tersebut hanya memiliki satu versi. Setelah Anda mengunggah file ke PDS untuk menimpa file yang ada, versi baru dari file dihasilkan.

Untuk informasi tentang mengunggah file ke PDS untuk menimpa file yang ada, lihat bagian "Unggah file dalam mode timpa" dari topik Unggah File. Untuk menimpa file yang ada, atur parameter file_id ke ID file yang ingin ditimpa saat Anda memanggil operasi CreateFile. Konfigurasi lainnya sama dengan unggah file untuk membuat file.

ListRevision

Anda dapat memanggil operasi ListRevision untuk melihat versi historis file berdasarkan halaman. Hasil yang dikembalikan diurutkan secara kronologis terbalik, dari versi terbaru hingga yang paling lama.

Contoh Permintaan

{
	"drive_id":"testDriveId",
	"file_id": "testFileId"
}

Contoh Respons

{
	"items": [{
		"domain_id": "testDomainId",
		"drive_id": "testDriveId",
		"file_id": "testFileId",
		"revision_id": "testRevisionId",
		"revision_name": "history_version.xlsx",
		"file_extension": "xlsx",
		"size": 8493,
		"revision_version": 2,
		"keep_forever": false,
		"revision_description": "",
		"revision_create_reason": "overwrite",
		"content_hash_name": "sha1",
		"content_hash": "xxxxxx",
		"crc64_hash": "xxxxxx",
		"created_at": "2022-09-05T04:00:09.017Z",
		"updated_at": "2022-09-05T04:00:09.017Z",
		"creator_type": "User",
		"creator_id": "testCreatorId",
		"is_latest_version": true
	}],
	"next_marker": ""
}

Deskripsi Parameter

Parameter permintaan drive_id menentukan ID drive individu atau drive perusahaan tempat file yang versi historisnya ingin Anda lihat berada.
Parameter permintaan file_id menentukan ID file yang versi historisnya ingin Anda lihat. Anda tidak dapat menentukan ID folder untuk parameter ini.
Jika hasil dikembalikan berdasarkan halaman, parameter respons next_marker menunjukkan token paginasi yang digunakan dalam permintaan berikutnya untuk mengambil halaman hasil baru. Anda harus menentukan token yang diperoleh dari permintaan sebelumnya sebagai nilai parameter marker dari permintaan berikutnya. Jika tidak ada nilai yang dikembalikan untuk parameter respons next_marker, hasil halaman terakhir dikembalikan.
Parameter respons revision_version menunjukkan nomor versi. Angka yang lebih kecil menunjukkan versi yang lebih awal.
Parameter respons revision_create_reason menunjukkan alasan mengapa versi dihasilkan. Nilai valid:
- String kosong: File dibuat.
- overwrite: File yang ada ditimpa.
- restore_rev: Versi historis dipulihkan.
Parameter respons is_latest_version menunjukkan apakah file merupakan versi terbaru.
Parameter respons revision_name menunjukkan nama versi terbaru dari file. Nama versi terbaru dari file sama dengan nama file. Nama versi historis tetap saat versi historis dihasilkan.

GetRevision

Anda dapat memanggil operasi GetRevision untuk melihat detail dari versi historis. Dibandingkan dengan operasi ListRevision, parameter download_url ditambahkan ke respons operasi GetRevision.

Contoh Permintaan

{
	"drive_id":"testDriveId",
	"file_id": "testFileId",
	"revision_id": "testRevisionId"
}

Contoh Respons

{
	"domain_id": "testDomainId",
	"drive_id": "testDriveId",
	"file_id": "testFileId",
	"revision_id": "testRevisionId",
	"revision_name": "history_version.xlsx",
	"file_extension": "xlsx",
	"size": 8493,
	"revision_version": 2,
	"keep_forever": false,
	"revision_description": "",
	"revision_create_reason": "overwrite",
	"content_hash_name": "sha1",
	"content_hash": "xxxxxx",
	"crc64_hash": "xxxxxx",
	"created_at": "2022-09-05T04:00:09.017Z",
	"updated_at": "2022-09-05T04:00:09.017Z",
	"creator_type": "User",
	"creator_id": "testCreatorId",
	"is_latest_version": true,
	"download_url": "testDownloadUrl"
}

UpdateRevision

Anda dapat memanggil operasi UpdateRevision untuk mengonfigurasi properti versi file.

Aktifkan versi file agar disimpan secara permanen

Penting

Anda dapat menyimpan hingga 50 versi historis file secara permanen. Versi historis file yang disimpan secara permanen tidak akan dihapus meskipun periode retensi versi historis berakhir atau jumlah maksimum versi historis file terlampaui.
Anda dapat menghapus versi historis file yang disimpan secara permanen dengan memanggil operasi DeleteRevision.
Versi historis file yang disimpan secara permanen dihapus jika file dihapus secara permanen.

Contoh Permintaan

{
	"drive_id": "testDriveId",
	"file_id": "testFileId",
	"revision_id": "testRevisionId",
	"keep_forever": true
}

Nonaktifkan versi file agar tidak disimpan secara permanen

Contoh Permintaan

{
	"drive_id": "testDriveId",
	"file_id": "testFileId",
	"revision_id": "testRevisionId",
	"keep_forever": false
}

Tentukan deskripsi versi file

Contoh Permintaan

{
	"drive_id": "testDriveId",
	"file_id": "testFileId",
	"revision_id": "testRevisionId",
	"revision_description": "ini adalah revisi"
}

RestoreRevision

Penting

Anda tidak dapat memanggil operasi ini untuk memulihkan versi terbaru dari file.
Saat Anda memulihkan versi historis file, versi baru dihasilkan berdasarkan versi historis. Status versi historis tetap tidak berubah. Pembuat versi baru adalah operator yang memulihkan versi historis. Untuk menghapus versi historis guna melepaskan ruang penyimpanan yang ditempati oleh versi historis, Anda harus memanggil operasi DeleteRevision.

Anda dapat memanggil operasi RestoreRevision untuk memulihkan versi historis file sebagai versi terbaru dari file.

Contoh Permintaan

{
	"drive_id": "testDriveId",
	"file_id": "testFileId",
	"revision_id": "testRevisionId"
}

DeleteRevision

Penting

Anda tidak dapat memanggil operasi ini untuk menghapus versi terbaru dari file.

Anda dapat memanggil operasi DeleteRevision untuk menghapus versi historis guna melepaskan ruang penyimpanan yang ditempati oleh versi historis.

Contoh Permintaan

{
	"drive_id": "testDriveId",
	"file_id": "testFileId",
	"revision_id": "testRevisionId"
}

FAQ

Apa manfaat fitur penggabungan versi?

Jika fitur penggabungan versi diaktifkan, beberapa versi file yang dihasilkan dalam siklus 10 menit digabungkan dan hanya versi historis terbaru dari file yang disimpan. Ini mencegah banyak versi historis dihasilkan jika file sering disimpan setelah Anda melakukan operasi pada file, seperti memodifikasi dan menyimpan file secara online atau menyinkronkan file antara disk lokal dan cloud drive. Siklus 10 menit menunjukkan siklus selama 10 menit. Misalnya, siklus 10 menit dimulai pada pukul 10:00 dan berakhir pada pukul 10:10 atau dimulai pada pukul 10:10 dan berakhir pada pukul 10:20.
Jika fitur penggabungan versi dinonaktifkan, versi historis file dihasilkan setiap kali Anda menyimpan file secara manual atau file disimpan secara otomatis.

Bisakah versi pertama dari file disimpan secara permanen?

Versi pertama dari file dihasilkan saat file dibuat.
Jika versi pertama dari file adalah versi historis, versi tersebut dihapus setelah periode retensi yang ditentukan berakhir.
Jika jumlah total versi historis file melebihi jumlah yang ditentukan, versi paling awal dari file dihapus. Dalam hal ini, versi pertama dari file mungkin dihapus. Anda dapat menggunakan konsol PDS atau memanggil operasi UpdateRevision untuk menyimpan versi pertama dari file secara permanen.
Versi terbaru dari file tidak dapat dihapus.

Bagaimana cara menonaktifkan fitur versi historis?

Fitur versi historis tidak dapat dinonaktifkan setelah diaktifkan. Jika Anda ingin menghentikan fitur ini, Anda dapat mengatur batas atas jumlah versi menjadi 1. Ini memiliki efek yang sama seolah-olah fitur tersebut tidak diaktifkan.