Upload file media dari URL dengan menggunakan UploadMediaByURL-ApsaraVideo VOD-Alibaba Cloud - ApsaraVideo VOD

Mengunggah file media audio atau video dengan mengambilnya dari URL sumber. Operasi ini mendukung unggahan batch.

Deskripsi operasi

Sebelum memanggil operasi ini, pastikan Anda memahami metode penagihan dan harga ApsaraVideo for VOD. Mengunggah file aset media ke ApsaraVideo for VOD akan dikenakan biaya penyimpanan. Untuk informasi selengkapnya, lihat Penyimpanan media. Jika Anda telah mengaktifkan akselerasi transfer penyimpanan, mengunggah file aset media ke ApsaraVideo for VOD juga akan dikenakan biaya akselerasi unggahan. Untuk informasi selengkapnya, lihat akselerasi transfer penyimpanan..
Untuk daftar format media yang didukung, lihat Format media.
Gunakan operasi ini untuk mengunggah file dari URL publik, bukan dari server atau perangkat lokal.
Ini adalah API unggahan asinkron. Operasi ini tidak selesai secara real time dan tidak memiliki waktu pemrosesan yang dijamin. Sebuah pekerjaan dapat memakan waktu beberapa jam atau bahkan berhari-hari untuk selesai. Untuk unggahan yang lebih cepat, gunakan SDK unggahan.
Jika Anda mengonfigurasi callback, Anda akan menerima notifikasi event URLUploadComplete setelah unggahan selesai. Anda dapat memanggil operasi GetURLUploadInfos untuk mengkueri status unggahan.
Saat Anda mengirimkan pekerjaan unggahan, layanan akan membuat tugas asinkron. Layanan akan mengantrikan pekerjaan unggahan URL dari semua pengguna di wilayah yang sama. Waktu yang diperlukan untuk menyelesaikan pekerjaan bergantung pada jumlah pekerjaan yang ada. Setelah unggahan selesai, Anda dapat menggunakan URL dan ID video yang dikembalikan dalam notifikasi event untuk mengaitkan resource.
Operasi ini hanya tersedia di wilayah berikut: China (Shanghai), China (Beijing), China (Shenzhen), Singapore, dan US (Silicon Valley).
Setiap kali Anda mengirimkan pekerjaan unggahan untuk URL file media yang sama, ApsaraVideo for VOD akan membuat resource media baru dengan ID media baru.
Jika satu file melebihi 20 GB, unggahan akan gagal. Jika Anda perlu mengunggah file yang lebih besar dari 20 GB, gunakan SDK unggahan. Untuk informasi selengkapnya, lihat Ikhtisar SDK unggahan.

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:UploadMediaByURL

create

*All Resource

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
UploadURLs	string	Yes	URL file media sumber. URL harus menyertakan ekstensi file. Misalnya, mp4 adalah ekstensi file dalam `https://**.mp4`. Jika URL tidak mengandung ekstensi file, Anda dapat menentukannya dengan mengatur parameter `FileExtension` di `UploadMetadatas`. Jika Anda menentukan ekstensi file di URL dan parameter `FileExtension`, nilai parameter `FileExtension` akan diutamakan. Untuk daftar ekstensi file yang didukung, lihat Ikhtisar unggahan. Catatan Anda dapat menentukan hingga 20 URL. Pisahkan beberapa URL dengan koma (,). Untuk mencegah kegagalan unggahan yang disebabkan oleh karakter khusus, Anda harus mengodekan URL** setiap URL sebelum menggabungkannya dengan koma.	https://****.mp4
TemplateGroupId	string	No	ID kelompok template transkoding. Anda dapat memperoleh ID dengan salah satu cara berikut: Masuk ke Konsol ApsaraVideo for VOD. Di panel navigasi sebelah kiri, pilih Manajemen Konfigurasi > Pemrosesan Media > Grup Template transkoding untuk Tampilan ID kelompok template transkoding. Nilai `TranscodeTemplateGroupId` dalam tanggapan operasi AddTranscodeTemplateGroup. Nilai `TranscodeTemplateGroupId` dalam tanggapan operasi ListTranscodeTemplateGroup. Catatan Jika Anda tidak menentukan parameter ini, kelompok template transkoding default akan digunakan. Jika Anda menentukan parameter ini, kelompok template transkoding yang ditentukan akan digunakan. Anda juga dapat mengatur parameter ini di `UploadMetadatas`. Jika Anda mengatur `TemplateGroupId` di `UploadMetadatas` dan di tingkat ini, `TemplateGroupId` di `UploadMetadatas` akan diutamakan.	ca3a8f6e4957b65806709586****
StorageLocation	string	No	Lokasi penyimpanan file media. Masuk ke Konsol ApsaraVideo for VOD. Di panel navigasi sebelah kiri, pilih Manajemen Konfigurasi > Manajemen Aset Media > Penyimpanan untuk Tampilan lokasi penyimpanan. Jika Anda tidak menentukan parameter ini, lokasi penyimpanan default akan digunakan.	outin-bfefbb90a47c******163e1c7426.oss-cn-shanghai.aliyuncs.com
UploadMetadatas	string	No	Metadata file media yang akan diunggah. Nilai harus berupa string JSON. Parameter ini hanya berlaku jika cocok dengan URL di `UploadURLs`. Nilai harus berupa string JSON yang merepresentasikan array objek `UploadMetadata`. Untuk informasi selengkapnya, lihat tabel UploadMetadata di bawah.	[{"SourceURL":"https://example.aliyundoc.com/video01.mp4","Title":"urlUploadTest"}]
UserData	string	No	Pengaturan kustom. Nilai harus berupa string JSON. Parameter ini mendukung fitur seperti callback Paket dan akselerasi unggahan. Untuk informasi selengkapnya, lihat UserData. Catatan Untuk menggunakan callback Paket, Anda harus mengonfigurasi URL callback HTTP dan memilih tipe event yang sesuai di konsol. Jika tidak, pengaturan callback tidak akan berlaku. Untuk informasi selengkapnya tentang cara mengonfigurasi callback HTTP di konsol, lihat Pengaturan callback. Untuk menggunakan fitur akselerasi unggahan, Anda harus mengirimkan tiket untuk mengaktifkannya. Untuk informasi selengkapnya, lihat Catatan terkait unggahan. Untuk informasi tentang cara mengirimkan tiket, lihat Hubungi kami.	{"MessageCallback":{"CallbackURL":"http://example.aliyundoc.com"},"Extend":{"localId":"xxx","test":"www"}}
AppId	string	No	ID aplikasi. Nilai default adalah app-1000000. Untuk informasi selengkapnya, lihat Layanan multi-aplikasi.	app-****
WorkflowId	string	No	ID alur kerja. Untuk Tampilan ID alur kerja, masuk ke Konsol ApsaraVideo for VOD. Di panel navigasi sebelah kiri, pilih Manajemen Konfigurasi > Pemrosesan Media > Alur Kerja. Catatan Jika Anda menentukan `WorkflowId` dan `TemplateGroupId`, `WorkflowId` akan diutamakan. Untuk informasi selengkapnya, lihat Alur Kerja.	e1e243b42548248197d6f74f9****
SessionId	string	No	Pengidentifikasi deduplikasi kustom. Jika Anda menentukan parameter ini di permintaan, layanan akan mengembalikan error jika permintaan dengan pengidentifikasi yang sama diulang dalam waktu 10 menit. Catatan Anda dapat menyesuaikan pengidentifikasi. Pengidentifikasi dapat memiliki panjang hingga 50 karakter dan dapat berisi huruf besar, huruf kecil, digit, tanda hubung (-), dan garis bawah (_). Jika Anda tidak menentukan parameter ini atau meneruskan string kosong, layanan tidak akan melakukan deduplikasi.	5c62d40299034bbaa4c195da330****
EnableFirstFrameCover	boolean	No
GenerateThumbnail	boolean	No

UploadMetadata

Parameter	Tipe	Wajib	Deskripsi
SourceURL	String	Ya	URL file media sumber yang akan diunggah.
Title	String	Tidak	Judul file media. Judul dapat memiliki panjang hingga 128 byte dan harus dienkode UTF-8.
FileSize	String	Tidak	Ukuran file.
Description	String	Tidak	Deskripsi file media. Deskripsi dapat memiliki panjang hingga 1.024 byte dan harus dienkode UTF-8.
CoverURL	String	Tidak	URL sampul video kustom.
CateId	String	Tidak	ID kategori. Untuk Tampilan ID kategori, masuk ke Konsol ApsaraVideo for VOD. Di panel navigasi sebelah kiri, pilih Manajemen Konfigurasi > Manajemen Aset Media > Kategori.
Tags	String	Tidak	Tag file media. Satu tag dapat memiliki panjang hingga 32 byte. Anda dapat menentukan maksimum 16 tag. Pisahkan beberapa tag dengan koma (,). Tag harus dienkode UTF-8.
TemplateGroupId	String	Tidak	ID kelompok template transkoding. Parameter ini menggantikan `TemplateGroupId` yang ditentukan di tingkat teratas permintaan.
WorkflowId	String	Tidak	ID alur kerja. Jika Anda menentukan `WorkflowId` dan `TemplateGroupId`, `WorkflowId` akan diutamakan. Untuk informasi selengkapnya, lihat Alur Kerja.
FileExtension	String	Tidak	Ekstensi file media. Untuk daftar ekstensi file yang didukung, lihat Ikhtisar unggahan.
ReferenceId	String	Tidak	ID kustom. ID dapat memiliki panjang 6 hingga 64 karakter dan dapat berisi huruf, digit, tanda hubung (-), dan garis bawah (_). ID harus unik dalam akun Anda.

Catatan

Parameter di UploadMetadata, seperti Title, Description, dan Tags, tidak dapat berisi emoji.
Untuk memastikan pemutaran yang tepat saat transkoding dinonaktifkan (dengan mengatur TemplateGroupId ke VOD_NO_TRANSCODE), hanya file dalam format MP4, FLV, MP3, M3U8, dan WEBM yang dapat diputar langsung setelah diunggah. Format lain hanya didukung untuk penyimpanan. Sistem memeriksa ekstensi file. Jika Anda menggunakan Alibaba Cloud Player, versinya harus 3.1.0 atau lebih baru.
Jika Anda menentukan kelompok templat yang menonaktifkan transkoding (TemplateGroupId diatur ke VOD_NO_TRANSCODE), Anda hanya akan menerima notifikasi event untuk VideoUploadComplete setelah video diunggah. Anda tidak akan menerima notifikasi event untuk TranscodeComplete.
Jika callback dikonfigurasi, Anda akan menerima notifikasi event URLUploadComplete selain notifikasi unggahan dan transkoding setelah video diunggah.
Untuk pengiriman batch, layanan mengirimkan notifikasi terpisah untuk setiap SourceURL.

Elemen respons

Element	Type	Description	Example
	object	Tanggapan yang dikembalikan.
RequestId	string	ID permintaan.	25818875-5F78-4AF6-D7393642CA58****
UploadJobs	array<object>	Daftar pekerjaan unggahan.
	object	Detail pekerjaan unggahan.
SourceURL	string	URL sumber file dalam pekerjaan unggahan.	http://example****.mp4
JobId	string	ID pekerjaan unggahan.	ad90a501b1b94fb72374ad005046****

Contoh

Respons sukses

JSONformat

{
  "RequestId": "25818875-5F78-4AF6-D7393642CA58****",
  "UploadJobs": [
    {
      "SourceURL": "http://example****.mp4",
      "JobId": "ad90a501b1b94fb72374ad005046****"
    }
  ]
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.