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

Mengambil file media audio dan video untuk diunggah berdasarkan URL file sumber. Unggahan batch didukung.

Deskripsi operasi

Sebelum menggunakan operasi ini, pastikan Anda sepenuhnya memahami metode penagihan dan harga ApsaraVideo VOD. Mengunggah file media ke ApsaraVideo VOD menimbulkan biaya penyimpanan. Untuk detail penagihan, lihat Penagihan penyimpanan Aset media. Jika Anda telah mengaktifkan akselerasi transfer penyimpanan, mengunggah file media ke ApsaraVideo VOD juga menimbulkan biaya akselerasi unggah. Untuk detail penagihan, lihat Penagihan akselerasi transfer penyimpanan.
Untuk format file media yang didukung oleh operasi ini, lihat Format media.
Operasi ini terutama berlaku untuk skenario di mana file tidak disimpan di server lokal atau terminal dan perlu diunggah melalui URL dengan akses jaringan publik.
Operasi ini adalah operasi unggah asinkron. Operasi ini tidak real-time dan tidak menjamin pengatur waktu. Umumnya, unggah migrasi selesai dalam hitungan jam atau bahkan hari setelah node dikirimkan. Jika Anda memiliki persyaratan pengatur waktu yang tinggi, gunakan SDK unggah sebagai gantinya.
Jika callback dikonfigurasi, Anda akan menerima notifikasi event URL upload video complete setelah unggahan selesai. Anda dapat memanggil operasi GetURLUploadInfos untuk mengkueri status unggahan.
Setelah node unggah dikirimkan, node asinkron dibuat di cloud untuk dieksekusi. Semua node unggah URL yang dikirimkan oleh pengguna di wilayah layanan terkait masuk dalam antrean untuk dieksekusi. Waktu penyelesaian dipengaruhi oleh jumlah node yang ada. Setelah unggahan selesai, Anda dapat mengaitkan URL dengan ID video berdasarkan informasi yang dikembalikan dalam notifikasi event (callback Paket).
Operasi ini saat ini hanya mendukung wilayah China (Shanghai), China (Beijing), China (Shenzhen), Singapura, dan US (Silicon Valley).
Setiap kali Anda mengirimkan node unggah untuk URL file media yang sama, Sumber daya media baru dibuat di ApsaraVideo VOD (yaitu, ID media baru dibuat).
Jika satu file melebihi 20 GB, unggahan gagal. Jika Anda perlu mengunggah satu file yang lebih besar dari 20 GB, gunakan SDK unggah. Untuk informasi lebih lanjut, lihat Ikhtisar SDK unggah.

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

*全部资源

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
UploadURLs	string	Yes	URL file sumber media. URL harus menyertakan ekstensi nama file. Misalnya, mp4 adalah ekstensi nama file dalam `https://**.mp4`. Jika URL tidak menyertakan ekstensi nama file, Anda dapat menentukan parameter FileExtension di `UploadMetadatas`. Jika URL menyertakan ekstensi nama file dan parameter `FileExtension` juga ditentukan, nilai `FileExtension` yang diutamakan. Untuk ekstensi nama file yang didukung, lihat Ikhtisar unggah. Catatan** Pisahkan beberapa URL dengan koma (,). Maksimal 20 URL didukung. Untuk mencegah kegagalan unggah yang disebabkan oleh karakter khusus, lakukan URL-encode pada setiap URL sebelum menggabungkannya dengan koma.	https://****.mp4
TemplateGroupId	string	No	ID kelompok template transkoding. Anda dapat memperoleh ID tersebut dengan salah satu metode berikut: Masuk ke Konsol ApsaraVideo VOD dan pilih Configuration Management > Media Processing > Transcoding Template Groups untuk melihat ID kelompok template transkoding. Dapatkan nilai TranscodeTemplateGroupId dari tanggapan saat Anda memanggil operasi AddTranscodeTemplateGroup. Dapatkan nilai TranscodeTemplateGroupId dari tanggapan saat Anda memanggil operasi ListTranscodeTemplateGroup. Catatan Jika Anda tidak menentukan ID kelompok template transkoding, kelompok template transcoding default digunakan. Jika Anda menentukan ID kelompok template transkoding, kelompok template yang ditentukan digunakan. Anda juga dapat mengatur parameter ini di `UploadMetadatas`. Jika TemplateGroupId diatur di kedua UploadMetadatas dan parameter ini, nilai di UploadMetadatas yang diutamakan.	ca3a8f6e4957b65806709586****
StorageLocation	string	No	Alamat penyimpanan file media. Masuk ke Konsol ApsaraVideo VOD dan pilih Configuration Management > Pengelolaan Aset Media > Storage untuk melihat alamat penyimpanan. Jika Anda tidak menentukan parameter ini, alamat penyimpanan default digunakan.	outin-bfefbb90a47c******163e1c7426.oss-cn-shanghai.aliyuncs.com.
UploadMetadatas	string	No	Metadata file media yang akan diunggah. Nilainya adalah string JSON. Metadata hanya berlaku jika cocok dengan URL di UploadURLs. Format JSON: `[UploadMetadata, UploadMetadata,…]`. Nilai harus dikonversi menjadi string JSON. Untuk informasi lebih lanjut, lihat tabel UploadMetadata di bawah ini.	[{"SourceURL":"https://example.aliyundoc.com/video01.mp4","Title":"urlUploadTest"}]
UserData	string	No	Pengaturan kustom. Nilainya adalah string JSON yang mendukung callback Paket dan pengaturan akselerasi unggah. Untuk informasi lebih lanjut, lihat UserData. Catatan Untuk menggunakan callback Paket di parameter ini, Anda harus mengonfigurasi URL callback HTTP dan memilih jenis event callback yang sesuai di konsol. Jika tidak, pengaturan callback tidak berlaku. Untuk informasi tentang cara mengonfigurasi callback HTTP di konsol, lihat Pengaturan callback. Untuk menggunakan fitur akselerasi unggah, kirimkan Tiket untuk mengaktifkannya. Untuk informasi lebih lanjut, lihat Instruksi unggah. 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: app-1000000. Untuk informasi lebih lanjut, lihat Multi-aplikasi.	app-****
WorkflowId	string	No	ID alur kerja. Masuk ke Konsol ApsaraVideo VOD dan pilih Configuration Management > Media Processing > Workflows untuk melihat ID alur kerja. Catatan Jika WorkflowId dan TemplateGroupId keduanya ditentukan, WorkflowId yang diutamakan. Untuk instruksi penggunaan, lihat Alur kerja.	e1e243b42548248197d6f74f9****
SessionId	string	No	Identifier deduplikasi kustom. Jika parameter ini ditentukan dan permintaan dengan identifier yang sama dikirim dalam 10 menit terakhir, error dikembalikan untuk permintaan saat ini. Catatan Identifier deduplikasi ini didefinisikan secara kustom. Panjangnya dapat mencapai 50 karakter dan dapat berisi huruf besar dan kecil, digit, tanda hubung (-), dan garis bawah (_). Jika parameter ini tidak ditentukan atau diatur ke string kosong, deduplikasi tidak dilakukan.	5c62d40299034bbaa4c195da330****
EnableFirstFrameCover	boolean	No
GenerateThumbnail	boolean	No

UploadMetadata

Nama	Tipe	Wajib	Deskripsi
SourceURL	String	Ya	URL file sumber media yang akan diunggah.
Title	String	Tidak	Judul file media. Judul dapat memiliki panjang hingga 128 byte. Pengkodean UTF-8 digunakan.
FileSize	String	Tidak	Ukuran file.
Description	String	Tidak	Deskripsi. Deskripsi dapat memiliki panjang hingga 1024 byte. Pengkodean UTF-8 digunakan.
CoverURL	String	Tidak	URL thumbnail video kustom.
CateId	String	Tidak	ID kategori. Masuk ke Konsol ApsaraVideo VOD dan pilih Configuration Management > Pengelolaan Aset Media > Categories untuk melihat ID kategori.
Tags	String	Tidak	Tag. Setiap tag dapat memiliki panjang hingga 32 byte. Maksimal 16 tag didukung. Pisahkan beberapa tag dengan koma (,). Pengkodean UTF-8 digunakan.
TemplateGroupId	String	Tidak	ID kelompok template transkoding. Nilai ini menggantikan TemplateGroupId yang ditentukan di parameter luar.
WorkflowId	String	Tidak	ID alur kerja. Jika WorkflowId dan TemplateGroupId keduanya ditentukan, WorkflowId yang diutamakan. Untuk informasi lebih lanjut, lihat Alur kerja.
FileExtension	String	Tidak	Ekstensi nama file media. Untuk ekstensi nama file yang didukung, lihat Ikhtisar unggah.
ReferenceId	String	Tidak	ID kustom. Hanya huruf kecil, huruf besar, digit, tanda hubung (-), dan garis bawah (_) yang didukung. Nilai harus memiliki panjang 6 hingga 64 karakter. Nilai harus unik dalam satu akun pengguna.

Catatan

Parameter di UploadMetadata (seperti Title, Description, dan Tags) tidak boleh mengandung karakter emoji.
Untuk memastikan pemutaran normal, saat Anda mengunggah file video dengan TemplateGroupId diatur ke "VOD_NO_TRANSCODE" (tanpa transkoding), hanya format berikut yang mendukung pemutaran langsung tanpa transkoding: MP4, FLV, MP3, M3U8, dan WEBM. Format lain hanya mendukung penyimpanan (perhatikan ekstensi nama file FileName). Jika Anda menggunakan Alibaba Cloud Player, versinya harus 3.1.0 atau lebih baru.
Jika Anda menentukan kelompok template tanpa transkoding (TemplateGroupId diatur ke "VOD_NO_TRANSCODE"), hanya notifikasi event video upload complete yang dikirim setelah video diunggah. Notifikasi event single stream transcoding complete tidak dikirim.
Jika callback dikonfigurasi, setelah unggahan video selesai, selain notifikasi unggah dan transkoding, notifikasi event URL upload video complete juga dikirim.
Saat Anda mengirimkan tugas secara batch, setiap SourceURL memiliki notifikasi independen.

Elemen respons

Element	Type	Description	Example
	object	Parameter tanggapan.
RequestId	string	ID permintaan.	25818875-5F78-4AF6-D7393642CA58****
UploadJobs	array<object>	Daftar pekerjaan unggah.
	object	Detail pekerjaan unggah.
SourceURL	string	URL file sumber dari pekerjaan unggah.	http://example****.mp4
JobId	string	ID pekerjaan unggah.	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.