Gunakan CreateUploadVideo untuk mendapatkan URL dan kredensial unggah - ApsaraVideo VOD - Alibaba Cloud - ApsaraVideo VOD

Mengambil URL unggah dan unggah kredensial untuk file audio atau video. ApsaraVideo VOD menerbitkan URL unggah dan unggah kredensial untuk memastikan otorisasi dan keamanan serta mencegah unggahan berbahaya. Selama penerbitan, ID media (MediaId), yang juga disebut ID video (VideoId), dibuat secara otomatis untuk manajemen.

Deskripsi operasi

Sebelum menggunakan operasi ini, pastikan Anda memahami metode penagihan dan harga ApsaraVideo VOD. Mengunggah file media ke ApsaraVideo VOD menimbulkan biaya penyimpanan. Untuk informasi lebih lanjut, lihat Penagihan penyimpanan aset media. Jika Anda telah mengaktifkan akselerasi penyimpanan dan transfer, mengunggah file media ke ApsaraVideo VOD juga menimbulkan biaya akselerasi unggah. Untuk informasi lebih lanjut, lihat Penagihan akselerasi penyimpanan dan transfer. Biaya penyimpanan dihitung sejak pengatur waktu file diunggah. Biaya akselerasi dihitung saat Anda melakukan operasi unggah setelah fitur diaktifkan. Hanya memanggil operasi ini tidak menimbulkan biaya.
Mengambil URL unggah dan kredensial adalah fondasi inti dari ApsaraVideo VOD dan merupakan langkah wajib untuk setiap operasi unggah. ApsaraVideo VOD menyediakan berbagai metode unggah, masing-masing dengan persyaratan berbeda untuk mengambil URL unggah dan kredensial. Untuk informasi lebih lanjut, lihat URL unggah dan kredensial.
Operasi ini hanya digunakan untuk mengambil URL unggah dan kredensial serta membuat informasi dasar aset media. Operasi ini tidak mengunggah file. Untuk contoh lengkap mengunggah file menggunakan operasi API, lihat Mengunggah file media menggunakan API ApsaraVideo VOD.
Operasi ini mendukung pengambilan URL unggah dan kredensial untuk file video dan audio. Untuk informasi lebih lanjut, lihat URL unggah dan kredensial.
Jika kredensial unggah kedaluwarsa (periode validitas default adalah 3000 detik), panggil operasi RefreshUploadVideo untuk mendapatkan unggah kredensial baru.
Setelah unggahan selesai, Anda dapat mengonfigurasi callback untuk menerima notifikasi event unggah atau memanggil operasi GetMezzanineInfo untuk memeriksa status file dan menentukan apakah unggahan berhasil.
Parameter VideoId yang dikembalikan oleh operasi ini dapat digunakan untuk manajemen siklus hidup aset media atau pemrosesan media.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.
API: API yang dapat Anda panggil untuk melakukan aksi tersebut.
Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.
Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.
- Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.
- Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.
Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.
Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

vod:CreateUploadVideo

create

*全部资源

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
CoverURL	string	No	URL gambar mini video kustom.	https://example.aliyundoc.com/image/D22F553TEST****.jpeg.
Description	string	No	Deskripsi file audio atau video yang ditampilkan di ApsaraVideo VOD setelah unggahan selesai. Deskripsi dapat memiliki panjang hingga 1024 karakter. Nilai dienkode dalam UTF-8.	UploadTest.
FileName	string	Yes	Alamat sumber video file audio atau video yang akan diunggah. Ekstensi nama file diperlukan dan tidak peka huruf besar/kecil. Untuk ekstensi nama file yang didukung, lihat Tampilan ikhtisar unggah.	D:\video_01.mp4
FileSize	integer	No	Ukuran sumber video file audio atau video yang akan diunggah. Unit: byte.	123
Title	string	Yes	Judul file audio atau video yang ditampilkan di ApsaraVideo VOD setelah unggahan selesai. Judul dapat memiliki panjang hingga 128 karakter. Nilai dienkode dalam UTF-8.	UploadTest.
CateId	integer	No	ID kategori. Anda dapat memperoleh ID kategori dengan menggunakan salah satu metode berikut: Masuk ke Konsol ApsaraVideo VOD dan pilih Konfigurasi Manajemen > Konfigurasi Manajemen Media > Manajemen Kategori untuk melihat ID kategori di Tampilan. Saat membuat kategori dengan memanggil operasi AddCategory, ID kategori adalah nilai parameter CateId dalam tanggapan. Saat mengkueri kategori dengan memanggil operasi GetCategories, ID kategori adalah nilai parameter CateId dalam tanggapan.	100036****
Tags	string	No	Tag file audio atau video. Anda dapat menentukan hingga 16 tag. Untuk menentukan beberapa tag, pisahkan dengan koma (,). Setiap tag dapat memiliki panjang hingga 32 karakter. Nilai dienkode dalam UTF-8.	tag1,tag2
UserData	string	No	Pengaturan kustom dalam string JSON. Pengaturan mendukung callback Paket, akselerasi transfer, dan konfigurasi lainnya. Untuk informasi lebih lanjut, lihat UserData. Catatan Untuk menggunakan callback Paket dalam parameter ini, Anda harus mengonfigurasi URL callback HTTP dan memilih jenis event callback yang sesuai di konsol. Jika tidak, pengaturan callback tidak berlaku. Jika tidak ada URL callback yang ditentukan untuk tugas berikutnya, callback dikirim ke alamat ini secara default. Untuk mengonfigurasi callback HTTP di konsol, lihat Pengaturan callback. Untuk menggunakan fitur akselerasi transfer, Anda harus mengirimkan formulir Yida untuk mengajukan aktivasi. Untuk informasi lebih lanjut, lihat Instruksi unggah.	{"MessageCallback":{"CallbackURL":"http://example.aliyundoc.com"},"Extend":{"localId":"*****","test":"www"}}
TemplateGroupId	string	No	ID kelompok template transkoding. Anda dapat memperoleh ID dengan menggunakan salah satu metode berikut: Masuk ke Konsol ApsaraVideo VOD dan pilih Konfigurasi Manajemen > Konfigurasi Pemrosesan Media > Kelompok Template Transkoding untuk melihat ID kelompok template transkoding di Tampilan. Saat membuat kelompok template transkoding dengan memanggil operasi Membuat kelompok template transkoding, ID kelompok template transkoding adalah nilai parameter TranscodeTemplateGroupId dalam tanggapan. Saat mengkueri kelompok template transkoding dengan memanggil operasi Mengkueri konfigurasi transkoding, ID kelompok template transkoding adalah nilai parameter TranscodeTemplateGroupId dalam tanggapan. Catatan Jika WorkflowId dan TemplateGroupId keduanya ditentukan, WorkflowId diutamakan. Jika parameter ini tidak ditentukan, kelompok template transcoding default digunakan untuk transkoding. Jika ID kelompok template transkoding ditentukan, kelompok template yang ditentukan digunakan untuk transkoding. Jika parameter ini diatur ke kelompok template bawaan No Transcoding, hanya notifikasi event Unggah Video Selesai yang dikirim setelah file audio atau video diunggah. Notifikasi event Transkoding Selesai untuk Satu Definisi tidak dikirim. Parameter ini memicu tugas asinkron. Setelah pengiriman, tugas tidak segera selesai dan dimasukkan ke dalam antrian untuk eksekusi asinkron di latar belakang. Untuk memastikan pemutaran normal, ketika kelompok template bawaan No Transcoding digunakan, hanya format berikut yang mendukung pemutaran langsung tanpa transkoding setelah file audio atau video diunggah: MP4, FLV, MP3, M3U8, dan WEBM. Format lain hanya mendukung penyimpanan (periksa ekstensi nama file FileName). Jika Anda menggunakan Pemutar Video Apsara, versi pemutar harus 3.1.0 atau lebih baru.	405477f9e214d19ea2c7c854****
WorkflowId	string	No	ID alur kerja. Masuk ke Konsol ApsaraVideo VOD dan pilih Konfigurasi Manajemen > Konfigurasi Pemrosesan Media > Manajemen Alur Kerja untuk melihat ID alur kerja di Tampilan. Catatan Jika WorkflowId dan TemplateGroupId keduanya ditentukan, WorkflowId diutamakan. Untuk informasi lebih lanjut, lihat Alur kerja. Parameter ini memicu tugas asinkron. Setelah pengiriman, tugas tidak segera selesai dan dimasukkan ke dalam antrian untuk eksekusi asinkron di latar belakang.	613efff3887ec34af685714cc461****
StorageLocation	string	No	Alamat penyimpanan. Anda dapat memperoleh alamat penyimpanan dengan menggunakan metode berikut: Masuk ke Konsol ApsaraVideo VOD dan pilih Konfigurasi Manajemen > Konfigurasi Manajemen Media > Manajemen Penyimpanan untuk melihat alamat penyimpanan di Tampilan. Catatan Jika parameter ini tidak ditentukan, file audio atau video diunggah ke alamat penyimpanan default. Jika tidak ada alamat penyimpanan default, file diunggah ke alamat penyimpanan pertama dalam daftar penyimpanan. Jika parameter ini ditentukan, file audio atau video diunggah ke alamat penyimpanan yang ditentukan.	out-****.oss-cn-shanghai.aliyuncs.com.
AppId	string	No	ID aplikasi. Nilai default: app-1000000. Untuk informasi lebih lanjut, lihat Multi-aplikasi.	app-1000000
ReferenceId	string	No	ID kustom. Hanya huruf kecil, huruf besar, digit, tanda hubung, dan garis bawah yang didukung. Panjangnya 6 hingga 64 karakter. ID unik di tingkat pengguna.	123-123
EnableFirstFrameCover	boolean	No
GenerateThumbnail	boolean	No

Elemen respons

Element	Type	Description	Example
	object	Parameter tanggapan.
RequestId	string	ID permintaan.	25818875-5F78-4AF6-04D5-D7393642****
UploadAddress	string	URL unggah. Catatan URL unggah yang dikembalikan oleh operasi ini adalah nilai yang dienkode Base64. Saat Anda menggunakan SDK atau API untuk mengunggah aset media, Anda harus mendekode nilai Base64 tersebut sebelum digunakan. Hanya unggahan menggunakan SDK OSS native atau API OSS yang memerlukan Anda mengurai UploadAddress.	eyJTZWN1cml0a2VuIjoiQ0FJU3p3TjF****
VideoId	string	ID audio atau video. ID ini dapat digunakan sebagai parameter permintaan untuk operasi manajemen aset media, pemrosesan media, dan moderasi konten.	93ab850b4f6f54b6e91d24d81d44****
UploadAuth	string	Unggah kredensial. Catatan Unggah kredensial yang dikembalikan oleh operasi ini adalah nilai yang dienkode Base64. Saat Anda menggunakan SDK atau API untuk mengunggah aset media, Anda harus mendekode nilai Base64 tersebut sebelum digunakan. Hanya unggahan menggunakan SDK OSS native atau API OSS yang memerlukan Anda mengurai UploadAuth.	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.