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

ApsaraVideo VOD menyediakan alamat unggah dan unggah kredensial untuk unggahan yang aman dan terotorisasi. Panggil operasi ini untuk mendapatkan alamat unggah dan unggah kredensial, membuat ID media (dikembalikan sebagai VideoId), dan mengatur informasi dasar untuk file media.

Deskripsi operasi

Sebelum menggunakan operasi ini, pastikan Anda memahami metode penagihan dan harga ApsaraVideo VOD. Mengunggah file media akan dikenakan biaya penyimpanan media. Untuk informasi selengkapnya, lihat Penagihan penyimpanan media. Jika Anda telah mengaktifkan penyimpanan dan akselerasi transfer, Anda juga akan dikenakan biaya akselerasi unggah. Untuk informasi selengkapnya, lihat Penagihan penyimpanan dan akselerasi transfer. Biaya penyimpanan dihitung setelah file berhasil diunggah. Biaya akselerasi dikenakan untuk unggahan setelah fitur diaktifkan. Memanggil operasi ini saja tidak akan dikenakan biaya apa pun..
Mendapatkan alamat unggah dan kredensial adalah langkah pertama untuk setiap unggahan ke ApsaraVideo VOD. Layanan ini mendukung berbagai metode unggah, masing-masing dengan persyaratan berbeda untuk mendapatkan alamat dan kredensial. Untuk informasi selengkapnya, lihat Alamat unggah dan kredensial.
Operasi ini hanya mendapatkan alamat unggah, kredensial, dan informasi media dasar. Operasi ini tidak mengunggah file media itu sendiri. Untuk contoh lengkap cara mengunggah file media menggunakan API, lihat Mengunggah file media menggunakan API ApsaraVideo VOD.
Anda dapat memanggil operasi ini untuk mendapatkan alamat unggah dan kredensial untuk file video dan audio. Untuk informasi selengkapnya, lihat Alamat unggah dan kredensial.
Jika unggah kredensial kedaluwarsa (periode validitas default adalah 3.000 detik), panggil operasi RefreshUploadVideo untuk mendapatkan yang baru.
Setelah unggahan selesai, Anda dapat mengonfigurasi callback untuk menerima notifikasi event atau memanggil operasi GetMezzanineInfo untuk memeriksa status file dan memverifikasi bahwa unggahan berhasil.
Gunakan VideoId yang dikembalikan 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

*All Resource

*

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 media yang ditampilkan di ApsaraVideo VOD setelah unggahan selesai. Deskripsi dapat memiliki panjang hingga 1.024 karakter. Nilai harus dienkode dalam UTF-8.	UploadTest
FileName	string	Yes	Jalur file media sumber yang akan diunggah. Nama file harus menyertakan ekstensi, yang tidak peka huruf besar/kecil. Untuk daftar ekstensi file yang didukung, lihat Ikhtisar unggah.	D:\video_01.mp4
FileSize	integer	No	Ukuran file media sumber, dalam byte.	123
Title	string	Yes	Judul file media yang ditampilkan di ApsaraVideo VOD setelah unggahan selesai. Judul dapat memiliki panjang hingga 128 karakter. Nilai harus dienkode dalam UTF-8.	UploadTest
CateId	integer	No	ID kategori. Anda dapat memperoleh ID kategori dengan salah satu cara berikut: Masuk ke Konsol ApsaraVideo VOD dan pilih Pengaturan > Manajemen Aset Media > Manajemen Kategori untuk Tampilan ID kategori. ID kategori adalah nilai parameter `CateId` dalam tanggapan operasi AddCategory. ID kategori adalah nilai parameter `CateId` dalam tanggapan operasi GetCategories.	100036****
Tags	string	No	Tag file media. Mendukung maksimum 16 tag. Untuk menambahkan beberapa tag, pisahkan dengan koma (,). Satu tag dapat memiliki panjang hingga 32 karakter. Nilai harus dienkode dalam UTF-8.	tag1,tag2
UserData	string	No	Pengaturan kustom dalam format string JSON. Parameter ini memungkinkan Anda mengonfigurasi fitur seperti callback Paket dan akselerasi unggah. Untuk informasi selengkapnya, lihat UserData. Catatan Untuk menggunakan callback Paket, Anda harus mengonfigurasi URL callback HTTP dan memilih tipe event yang sesuai di Konsol ApsaraVideo VOD. Jika tidak, pengaturan callback akan diabaikan. Jika Anda tidak menentukan URL callback untuk tugas berikutnya, notifikasi event akan dikirim ke URL yang dikonfigurasi secara default. Untuk informasi selengkapnya tentang cara mengonfigurasi callback HTTP di konsol, lihat Pengaturan callback. Untuk menggunakan fitur akselerasi unggah, Anda harus mengisi formulir di Yida untuk mengaktifkan fitur tersebut. Untuk informasi selengkapnya, lihat Instruksi terkait unggah.	{"MessageCallback":{"CallbackURL":"http://example.aliyundoc.com"},"Extend":{"localId":"*****","test":"www"}}
TemplateGroupId	string	No	ID kelompok template transkoding. Anda dapat memperoleh ID dengan salah satu cara berikut: Masuk ke Konsol ApsaraVideo VOD dan pilih Pengaturan > Pengaturan Pemrosesan Media > Kelompok template transkoding untuk Tampilan ID kelompok template transkoding. ID adalah nilai parameter `TranscodeTemplateGroupId` dalam tanggapan operasi AddTranscodeTemplateGroup. ID adalah nilai parameter `TranscodeTemplateGroupId` dalam tanggapan operasi ListTranscodeTemplateGroup. Catatan Jika Anda menentukan `WorkflowId` dan `TemplateGroupId`, `WorkflowId` akan diutamakan. Jika Anda tidak menentukan parameter ini, kelompok template transkoding default akan digunakan. Jika Anda menentukan parameter ini, kelompok template yang ditentukan akan digunakan. Jika Anda mengatur parameter ini ke kelompok template No Transcoding bawaan, hanya notifikasi event UploadComplete yang dikirim setelah unggahan. Tidak ada notifikasi event TranscodeComplete yang dikirim. Parameter ini memicu Tugas asinkron. Setelah permintaan dikirim, tugas akan masuk antrean untuk pemrosesan latar belakang. Untuk memastikan pemutaran yang tepat, jika Anda menggunakan kelompok template No Transcoding bawaan, hanya format berikut yang dapat diputar langsung tanpa transkoding: MP4, FLV, MP3, M3U8, dan WEBM. Format lain hanya dapat disimpan (format ditentukan oleh ekstensi di `FileName`). Jika Anda menggunakan Alibaba Cloud Player, versinya harus 3.1.0 atau lebih baru.	405477f9e214d19ea2c7c854****
WorkflowId	string	No	ID alur kerja. Untuk Tampilan ID alur kerja, masuk ke Konsol ApsaraVideo VOD dan pilih Pengaturan > Pengaturan Pemrosesan Media > Manajemen Alur Kerja. Catatan Jika Anda menentukan `WorkflowId` dan `TemplateGroupId`, `WorkflowId` akan diutamakan. Untuk informasi selengkapnya, lihat Alur kerja. Parameter ini memicu Tugas asinkron. Setelah permintaan dikirim, tugas akan masuk antrean untuk pemrosesan latar belakang.	613efff3887ec34af685714cc461****
StorageLocation	string	No	Lokasi penyimpanan. Untuk Tampilan lokasi penyimpanan, masuk ke Konsol ApsaraVideo VOD dan pilih Pengaturan > Manajemen Aset Media > Manajemen Penyimpanan. Catatan Jika Anda tidak menentukan parameter ini, file media akan diunggah ke lokasi penyimpanan default. Jika tidak ada lokasi penyimpanan default yang ditentukan, file akan diunggah ke lokasi penyimpanan pertama dalam daftar. Jika Anda menentukan parameter ini, 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 Multi-aplikasi.	app-1000000
ReferenceId	string	No	ID kustom. Hanya dapat berisi huruf kecil, huruf besar, digit, tanda hubung (-), dan garis bawah (_). ID harus memiliki panjang 6 hingga 64 karakter dan harus unik untuk setiap 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	Alamat unggah. Catatan Alamat unggah yang dikembalikan oleh operasi ini dienkode Base64. Anda harus mendekode Base64 alamat tersebut sebelum menggunakannya untuk mengunggah file media. Penguraian ini hanya diperlukan saat menggunakan OSS SDK atau OSS API untuk mengunggah file.	eyJTZWN1cml0a2VuIjoiQ0FJU3p3TjF****
VideoId	string	ID file media. Gunakan ID ini sebagai parameter permintaan untuk operasi seperti manajemen aset media, pemrosesan media, dan moderasi media.	93ab850b4f6f54b6e91d24d81d44****
UploadAuth	string	Unggah kredensial. Catatan Unggah kredensial yang dikembalikan oleh operasi ini dienkode Base64. Anda harus mendekode Base64 kredensial tersebut sebelum menggunakannya untuk mengunggah file media. Penguraian ini hanya diperlukan saat menggunakan OSS SDK atau OSS API untuk mengunggah file.	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.