ApsaraVideo VOD menyediakan alamat unggah dan kredensial untuk unggahan yang sah dan aman, serta membuat ID media (atau VideoId) guna manajemen aset media. Panggil operasi ini untuk memperoleh alamat unggah dan kredensial sekaligus menginisialisasi aset media.
Deskripsi operasi
Sebelum menggunakan operasi ini, pahami metode penagihan dan tarif ApsaraVideo VOD. Mengunggah aset media ke ApsaraVideo VOD dikenai biaya penyimpanan. Untuk informasi selengkapnya, lihat Penagihan penyimpanan. Jika Anda telah mengaktifkan akselerasi penyimpanan dan transfer, biaya akselerasi unggah juga akan dikenakan. Untuk informasi selengkapnya, lihat Penagihan akselerasi penyimpanan dan transfer. Biaya penyimpanan berlaku segera setelah file berhasil diunggah, sedangkan biaya akselerasi dikenakan hanya jika fitur tersebut telah diaktifkan. Pemanggilan operasi ini tidak dikenai biaya.
Mendapatkan alamat unggah dan kredensial wajib dilakukan untuk semua unggahan. ApsaraVideo VOD mendukung beberapa metode unggah, dan cara memperolehnya bergantung pada metode yang dipilih. Untuk informasi selengkapnya, lihat Alamat unggah dan kredensial.
Operasi ini hanya memperoleh alamat unggah dan kredensial serta menginisialisasi aset media, namun tidak melakukan pengunggahan file. Untuk contoh lengkap unggah melalui API, lihat Unggah aset media menggunakan VOD API.
Operasi ini memperoleh alamat unggah dan kredensial untuk file video dan audio. Untuk informasi selengkapnya, lihat Alamat unggah dan kredensial.
Jika kredensial unggah kedaluwarsa (masa berlakunya 3.000 detik secara default), panggil operasi RefreshUploadVideo untuk mendapatkan kredensial baru.
Setelah unggah selesai, Anda dapat mengonfigurasi callback untuk menerima notifikasi event unggah atau memanggil operasi GetMezzanineInfo guna memeriksa status file dan memverifikasi unggahan.
Parameter VideoId yang dikembalikan oleh operasi ini dapat digunakan untuk manajemen siklus hidup aset media atau pemrosesan media.
Coba sekarang
Test
RAM authorization
|
Action |
Access level |
Resource type |
Condition key |
Dependent action |
|
vod:CreateUploadVideo |
create |
*全部资源
|
None | None |
Parameter permintaan
|
Parameter |
Type |
Required |
Description |
Example |
| CoverURL |
string |
No |
URL cover video kustom. |
https://example.aliyundoc.com/image/D22F553TEST****.jpeg |
| Description |
string |
No |
Deskripsi file audio atau video. Deskripsi ini ditampilkan di Konsol ApsaraVideo VOD setelah unggahan selesai.
|
UploadTest |
| FileName |
string |
Yes |
Jalur ke file sumber audio atau video.
|
D:\video_01.mp4 |
| FileSize |
integer |
No |
Ukuran file sumber, dalam byte. |
123 |
| Title |
string |
Yes |
Judul file audio atau video. Judul ini ditampilkan di Konsol ApsaraVideo VOD setelah unggahan selesai.
|
UploadTest |
| CateId |
integer |
No |
ID kategori. Anda dapat memperoleh ID kategori dengan salah satu cara berikut:
|
100036**** |
| Tags |
string |
No |
Tag untuk audio atau video.
|
tag1,tag2 |
| UserData |
string |
No |
Pengaturan kustom dalam format JSON. Parameter ini mendukung fitur seperti callback pesan dan akselerasi unggah. Untuk informasi selengkapnya, lihat UserData. Catatan
|
{"MessageCallback":{"CallbackURL":"http://example.aliyundoc.com"},"Extend":{"localId":"*****","test":"www"}} |
| TemplateGroupId |
string |
No |
ID kelompok template transkoding. Anda dapat memperoleh ID ini dengan salah satu cara berikut:
Catatan
|
405477f9e214d19ea2c7c854**** |
| WorkflowId |
string |
No |
ID alur kerja. Untuk menemukan ID alur kerja, login ke Konsol ApsaraVideo VOD, lalu pilih Configuration Management > Media Processing > Workflow Management. Catatan
Jika Anda menentukan |
613efff3887ec34af685714cc461**** |
| StorageLocation |
string |
No |
Lokasi penyimpanan. Untuk menemukan lokasi penyimpanan, login ke Konsol ApsaraVideo VOD, lalu pilih Configuration Management > Media Management > Storage Management. Catatan
Jika Anda mengabaikan parameter ini, file media akan diunggah ke lokasi penyimpanan default. Jika tidak ada lokasi penyimpanan default yang dikonfigurasi, file akan diunggah ke lokasi pertama dalam daftar penyimpanan. Jika tidak, file akan diunggah ke lokasi penyimpanan yang ditentukan. |
out-****.oss-cn-shanghai.aliyuncs.com |
| AppId |
string |
No |
ID aplikasi. Nilai default: app-1000000. Untuk informasi selengkapnya, lihat Layanan multi-aplikasi. |
app-1000000 |
| ReferenceId |
string |
No |
ID kustom. Panjangnya harus antara 6 hingga 64 karakter dan hanya boleh berisi huruf kecil, huruf besar, angka, tanda hubung (-), dan garis bawah (_). ID ini harus unik untuk setiap pengguna. |
123-123 |
Elemen respons
|
Element |
Type |
Description |
Example |
|
object |
Badan respons. |
||
| RequestId |
string |
ID permintaan. |
25818875-5F78-4AF6-04D5-D7393642**** |
| UploadAddress |
string |
Alamat unggah. Catatan
Alamat unggah adalah string yang dikodekan Base64. Anda harus mendekodekannya sebelum menggunakannya untuk mengunggah aset media dengan SDK atau API. Parsing hanya diperlukan jika Anda menggunakan SDK native Object Storage Service (OSS) atau memanggil API OSS untuk mengunggah aset media. |
eyJTZWN1cml0a2VuIjoiQ0FJU3p3TjF**** |
| VideoId |
string |
ID file audio atau video. ID ini dapat digunakan sebagai parameter permintaan untuk manajemen aset media, pemrosesan media, dan tinjauan media. |
93ab850b4f6f54b6e91d24d81d44**** |
| UploadAuth |
string |
Kredensial unggah. Catatan
Kredensial unggah adalah string yang dikodekan Base64. Anda harus mendekodekannya sebelum menggunakannya untuk mengunggah aset media dengan SDK atau API. Parsing hanya diperlukan jika Anda menggunakan SDK native Object Storage Service (OSS) atau memanggil API OSS untuk mengunggah aset media. |
eyJFbmRwb2ludCI6Imm**** |
Contoh
Respons sukses
JSONformat
{
"RequestId": "25818875-5F78-4AF6-04D5-D7393642****",
"UploadAddress": "eyJTZWN1cml0a2VuIjoiQ0FJU3p3TjF****",
"VideoId": "93ab850b4f6f54b6e91d24d81d44****",
"UploadAuth": "eyJFbmRwb2ludCI6Imm****"
}Kode kesalahan
Lihat Error Codes untuk daftar lengkap.
Catatan rilis
Lihat Release Notes untuk daftar lengkap.