Object Storage Service:Metode untuk mengunggah objek ke OSS

Metode unggah

OSS menyediakan enam metode unggah. Pilih metode yang paling sesuai berdasarkan ukuran file, kondisi jaringan, dan pihak yang memulai unggahan.

• Simple upload: Unggah file hingga 5 GB melalui satu panggilan API PutObject. Metode ini tidak memerlukan konfigurasi tambahan dan cocok untuk unggahan rutin ketika ukuran file dan stabilitas jaringan bukan menjadi kendala.

• Multipart upload: Unggah file hingga 48,8 TB dengan membaginya menjadi beberapa bagian dan mengunggahnya secara paralel. Panggil InitiateMultipartUpload, UploadPart, dan CompleteMultipartUpload secara berurutan; OSS akan menyusun kembali bagian-bagian tersebut menjadi satu objek utuh. Jika unggahan terputus, client mencatat bagian yang gagal dan hanya mengulang pengunggahan bagian tersebut. Gunakan metode ini untuk file besar yang membutuhkan throughput paralel.

• Append upload: Tambahkan data ke objek yang sudah ada menggunakan API AppendObject. Setiap operasi append dapat mencapai 5 GB, dan data yang ditambahkan langsung dapat dibaca. Metode ini cocok untuk aliran video atau file log yang kontennya terus bertambah. Hanya objek yang dapat ditambahkan (appendable objects) yang mendukung metode ini.

• Resumable upload: Unggah file hingga 48,8 TB melalui koneksi yang tidak andal. SDK OSS—seperti metode uploadFile dalam OSS SDK for Java—secara otomatis menyimpan checkpoint kemajuan sehingga unggahan dapat dilanjutkan dari titik terakhir. Gunakan metode ini sebagai pengganti multipart upload ketika gangguan jaringan mungkin terjadi dan Anda menginginkan pemulihan otomatis tanpa perlu menerapkan logika retry di sisi client.

• Form upload: Izinkan pengguna mengunggah objek hingga 5 GB langsung dari halaman HTML melalui HTTP POST. Kebijakan yang dihasilkan server mengontrol batasan unggahan seperti ukuran dan jenis objek. Metode ini ideal untuk aplikasi web di mana browser memulai unggahan.

• Object uploads by using presigned URLs: Berikan izin kepada pihak ketiga untuk mengunggah objek kurang dari 5 GB tanpa membagikan Pasangan Kunci Akses Anda. Hasilkan URL yang ditandatangani dengan jendela masa berlaku tertentu; URL tersebut secara otomatis menjadi tidak valid setelah masa berlakunya habis. Gunakan metode ini ketika Anda memerlukan akses unggah delegasi yang terbatas waktu.

Fitur terkait

• Gunakan progress bar unggahan di SDK OSS untuk menampilkan progres unggahan dan perkiraan waktu tersisa. Untuk informasi selengkapnya, lihat Upload progress bar.

• Aktifkan callback ke server aplikasi Anda setelah unggahan selesai menggunakan upload callbacks. Untuk informasi selengkapnya, lihat Upload callbacks.

• Untuk mengontrol perilaku caching, pengunduhan, dan pemrosesan, atur metadata objek—termasuk header HTTP standar seperti Content-Type—saat unggahan. Untuk informasi selengkapnya, lihat Manage object metadata.

• Unggah file langsung dari client Anda ke OSS untuk mengurangi beban server aplikasi dan meningkatkan kecepatan unggahan. Untuk informasi selengkapnya, lihat Overview.

• Untuk operasi gambar seperti watermark, konversi format, dan kueri metadata, lihat Image processing methods.

• Untuk transkoding video dan pengambilan frame setelah unggahan, lihat Audio and video processing.

• Untuk pratinjau dan pengeditan daring dokumen PowerPoint dan Word, lihat WebOffice online preview dan WebOffice online editing.

• Untuk berbagi objek yang telah diunggah dengan pihak ketiga, tambahkan informasi signature ke URL objek dan sebarkan URL yang ditandatangani tersebut. Untuk informasi selengkapnya, lihat Using presigned URLs to download or preview files.