全部产品
Search
文档中心

Object Storage Service:Metode untuk mengunggah objek ke OSS

更新时间:Jul 09, 2025

Anda dapat mengunggah berbagai jenis file, termasuk gambar, dokumen, dan video, ke Bucket OSS. File yang diunggah disimpan sebagai objek dalam Bucket OSS. Setiap objek mencakup file dan metadata yang menjelaskan file tersebut. Anda dapat mengunggah sejumlah besar objek ke bucket secara bersamaan.

Metode unggah

OSS menyediakan metode berikut untuk mengunggah file:

  • Unggah Sederhana: Metode ini cocok untuk mengunggah file kecil dengan ukuran hingga 5 GB. Anda dapat memanggil operasi PutObject yang disediakan oleh OSS untuk mengunggah file tanpa memerlukan konfigurasi tambahan.

  • Unggah Multipart: Metode ini cocok untuk mengunggah file besar dengan ukuran hingga 48,8 TB. Anda dapat memanggil operasi InitiateMultipartUpload, UploadPart, dan CompleteMultipartUpload untuk membagi file menjadi beberapa bagian dan mengunggahnya secara paralel. Setelah semua bagian diunggah, Anda dapat menggabungkannya menjadi satu objek lengkap. Jika pengunggahan terganggu karena masalah jaringan, klien akan mencatat bagian yang gagal dan mengunggah ulang bagian tersebut.

  • Unggah Tambahan: Metode ini cocok untuk mengunggah file tambahan, seperti aliran video, dengan ukuran hingga 5 GB per file. Anda dapat memanggil operasi AppendObject yang disediakan oleh OSS untuk menghasilkan objek yang dapat ditambahkan. Anda dapat menambahkan konten ke objek yang sudah ada, dan data yang ditambahkan dapat dibaca segera. Unggah tambahan hanya mendukung objek yang dapat ditambahkan.

  • Unggah Berkelanjutan: Metode ini cocok untuk mengunggah file besar hingga ukuran 48,8 TB melalui jaringan yang tidak stabil. Anda dapat memanggil metode berbasis unggah multipart yang disediakan oleh SDK OSS, seperti metode uploadFile dari OSS SDK for Java, untuk secara otomatis mencatat kemajuan unggahan pada klien dan melanjutkan unggahan dari posisi di mana unggahan berhenti.

  • Unggah Formulir: Metode ini cocok untuk mengunggah objek dengan ukuran hingga 5 GB melalui halaman HTML dengan mengirimkan permintaan HTTP POST ke OSS. Anda dapat menggunakan kebijakan yang dihasilkan oleh server untuk membatasi atribut objek, seperti ukuran dan tipe file.

  • Unggah Objek Menggunakan URL Presigned: Metode ini cocok untuk memberikan izin kepada pengguna pihak ketiga untuk mengunggah objek dengan ukuran kurang dari 5 GB. Pemilik objek dapat menghasilkan URL presigned dan menentukan periode validitasnya, sehingga pengguna pihak ketiga dapat mengunggah objek tanpa memerlukan pasangan AccessKey. URL presigned akan kedaluwarsa secara otomatis setelah masa berlakunya habis.

Referensi

  • Anda dapat menggunakan bilah kemajuan unggah yang disediakan oleh SDK OSS untuk menampilkan kemajuan unggah dan waktu tersisa yang diperlukan untuk menyelesaikan proses. Untuk informasi lebih lanjut, lihat Bilah Kemajuan Unggah.

  • Setelah mengunggah objek ke OSS, Anda dapat mengirimkan permintaan callback ke server aplikasi tertentu menggunakan upload callbacks. Untuk informasi lebih lanjut, lihat Upload Callbacks.

  • Jika Anda ingin mengontrol caching, pengunduhan, dan pemrosesan objek yang diunggah, Anda dapat mengonfigurasi metadata objek, seperti header HTTP standar termasuk Content-Type, saat mengunggah objek. Untuk informasi lebih lanjut, lihat Kelola Metadata Objek.

  • Kami merekomendasikan agar Anda mengunggah file langsung dari klien ke OSS. Solusi ini mempercepat proses unggah dan mengurangi penggunaan sumber daya server aplikasi dengan menghilangkan kebutuhan untuk mentransfer objek ke dan dari server aplikasi. Untuk informasi lebih lanjut, lihat Ikhtisar.

  • Lihat Mode Implementasi IMG jika Anda ingin melakukan operasi seperti menambahkan watermark pada gambar, mengonversi format gambar, dan menanyakan informasi tentang gambar.

  • Lihat Pemrosesan Media jika Anda ingin mentranskode atau menangkap frame dari video yang diunggah.

  • Lihat Pratinjau Dokumen Online dengan WebOffice dan Pengeditan Online WebOffice jika Anda ingin meninjau atau mengedit dokumen Powerpoint atau Word secara online.

  • Anda dapat menambahkan informasi tanda tangan ke URL objek yang diunggah dan membagikan URL yang telah ditandatangani untuk memungkinkan pihak ketiga mengakses objek tersebut. Untuk informasi lebih lanjut, lihat Unduh Objek Menggunakan URL Presigned.