Untuk mengunggah file jaringan, mengotomatiskan unggahan, atau melakukan migrasi massal, panggil API Intelligent Media Services (IMS) untuk memperoleh URL unggah dan kredensial, lalu gunakan API native Object Storage Service (OSS) untuk menyelesaikan unggahan.
Prasyarat
-
Anda memahami format file yang didukung. Untuk informasi selengkapnya, lihat Supported file formats.
-
Anda telah mengaktifkan Object Storage Service (OSS). Untuk informasi selengkapnya, lihat Activate OSS.
Informasi latar belakang
Sebelum mengunggah aset media menggunakan API OSS, Anda harus memperoleh URL unggah dan kredensial dari IMS. URL unggah menentukan alamat penyimpanan di OSS, sedangkan kredensial memberikan otorisasi untuk unggahan tersebut. IMS menerbitkan URL dan kredensial ini guna memastikan keamanan serta mencegah unggahan berbahaya. Saat menerbitkan URL unggah dan kredensial, IMS juga secara otomatis membuat ID aset media yang dapat digunakan untuk manajemen siklus hidup aset media atau Pemrosesan Media ApsaraVideo.
Catatan
-
Ukuran maksimum untuk satu file audio atau video adalah 5 GB.
-
Ekstensi file tidak peka huruf besar/kecil saat unggah. Jika ekstensi tidak didukung, unggahan akan gagal karena format file tidak sesuai dengan kredensial unggah.
Langkah 1: Dapatkan URL unggah dan kredensial
Panggil operasi CreateUploadMedia untuk memperoleh URL unggah dan kredensial untuk suatu aset media. Anda dapat mengintegrasikan SDK sisi server (disarankan) atau membuat permintaan HTTP(S) sendiri. Untuk informasi selengkapnya, lihat RPC mechanism.
-
Setiap URL unggah dan kredensial hanya dapat digunakan untuk satu aset media. Jangan gunakan untuk beberapa aset agar tidak menimpa file.
-
Jika Anda meminta URL unggah dan kredensial untuk aset media yang sama beberapa kali, URL dan kredensial yang berbeda akan dikembalikan untuk setiap permintaan.
-
URL unggah ditetapkan secara otomatis oleh Intelligent Media Services. URL kustom tidak didukung.
-
Kredensial unggah berlaku selama 3.000 detik. Untuk file video berukuran besar, kredensial mungkin kedaluwarsa selama proses unggah. Jika kedaluwarsa, panggil operasi RefreshUploadMedia untuk memperbaruinya. Kredensial baru juga berlaku selama 3.000 detik, sedangkan URL unggah tetap tidak berubah.
-
Untuk file berukuran kecil, seperti gambar dan aset media pendukung (misalnya file caption dan font), Anda harus memperoleh kredensial baru jika kredensial saat ini kedaluwarsa.
Langkah 2: Panggil API OSS untuk mengunggah aset media
Lakukan dekode Base64 pada URL unggah dan kredensial. Kemudian, panggil API unggah OSS untuk mengunggah aset media. Untuk informasi selengkapnya, lihat Header HTTP Umum dan Unggah file ke OSS.