Gunakan UploadMediaByURL untuk mengunggah file audio atau video dari URL - Layanan Media Cerdas - Alibaba Cloud - Intelligent Media Services

Deskripsi operasi

Jika callback dikonfigurasi, Anda akan menerima notifikasi event mengenai penyelesaian unggahan video berbasis URL setelah proses unggahan selesai. Untuk memeriksa status unggahan, Anda dapat memanggil operasi guna memperoleh informasi unggahan URL.
Setelah tugas unggahan berhasil diajukan, sebuah tugas asinkron dibuat di cloud dan dimasukkan ke dalam antrian untuk dieksekusi. Setelah unggahan selesai, Anda dapat mengaitkan URL tersebut dengan ID video berdasarkan informasi yang dikembalikan dalam notifikasi event (message callback).

Batasan

Operasi ini hanya mendukung pengunggahan ke penyimpanan VOD, bukan ke penyimpanan Object Storage Service (OSS) milik pengguna. Jika Anda menggunakan penyimpanan OSS sendiri, tarik terlebih dahulu file tersebut ke perangkat lokal, unggah ke OSS menggunakan OSS SDK, lalu panggil operasi RegisterMediaInfo untuk mendaftarkan file OSS ke pustaka aset media.
Operasi ini saat ini hanya didukung di wilayah China (Shanghai), China (Beijing), dan China (Shenzhen).
Operasi ini hanya mendukung pengunggahan file audio dan video.

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

ice:UploadMediaByURL

create

*Semua Sumber daya.

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
UploadURLs	string	No	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 dalam `UploadMetadatas`. Jika URL menyertakan ekstensi nama file dan parameter FileExtension juga ditentukan, nilai FileExtension akan diutamakan. URL-encode URL tersebut. Pisahkan beberapa URL dengan koma (,). Maksimal 20 URL didukung. Untuk mencegah kegagalan unggahan akibat karakter khusus, lakukan URL-encode pada setiap URL sebelum menggabungkannya dengan koma.	https://diffurl.mp4
AppId	string	No	ID aplikasi.	app-1000000
UserData	string	No	Pengaturan kustom. Nilainya berupa string JSON yang mendukung pengaturan seperti message callback.	{"MessageCallback":{"CallbackURL":"http://example.aliyundoc.com"},"Extend":{"localId":"xxx","test":"www"}}
UploadTargetConfig	string	No	Alamat penyimpanan tujuan. StorageType: hanya oss yang didukung. StorageLocation: hanya penyimpanan VOD yang didukung. Penyimpanan OSS milik pengguna tidak didukung.	{"StorageType":"oss","StorageLocation":"outin-***.oss-cn-shanghai.aliyuncs.com"}
MediaMetaData	string	No	Metadata file media yang akan diunggah. Nilainya berupa string JSON. Metadata hanya berlaku jika sesuai dengan URL dalam UploadURLs. Format JSON: [UploadMetadata, UploadMetadata, ...]. Nilai tersebut harus dikonversi menjadi string JSON. Untuk informasi lebih lanjut, lihat tabel UploadMetadata di bawah ini.	[{"SourceURL":"https://example.aliyundoc.com/video01.mp4","Title":"urlUploadTest"}]
PostProcessConfig	string	No	Aksi pemrosesan pasca-unggah ketika Type diatur ke video atau audio. Nilai valid ProcessType: Workflow.	{"ProcessType": "Workflow","ProcessID":"b72a06c6beeb4dcdb898feef067b1***"}
EntityId	string	No	ID entitas. Anda dapat memanggil operasi CreateEntity untuk membuat entitas dan menentukan struktur metadata dinamis kustom.	d67281da3c8743b8823ad12976187***

UploadMetadata

Name	Type	Required	Description
SourceURL	String	Yes	URL file sumber media yang akan diunggah.
Title	String	Yes	Judul media. Judul dapat memiliki panjang hingga 128 byte. Di-encode UTF-8.
FileSize	String	No	Ukuran file.
Description	String	No	Deskripsi. Deskripsi dapat memiliki panjang hingga 1024 byte. Di-encode UTF-8.
CoverURL	String	No	URL gambar mini video kustom.
CateId	String	No	ID kategori.
Tags	String	No	Tag. Setiap tag dapat memiliki panjang hingga 32 byte. Maksimal 16 tag didukung. Pisahkan beberapa tag dengan koma (,). Di-encode UTF-8.
WorkflowId	String	No	ID alur kerja.
FileExtension	String	No	Ekstensi nama file media.
DynamicMetaData	String	No	Metadata dinamis. Contoh: "{"Uploader": "xxx"}".
EntityId	String	No	ID entitas.

Catatan

Tugas parameter WorkflowId merupakan tugas asinkron. Setelah diajukan, tugas tersebut tidak langsung selesai dan dimasukkan ke dalam antrian untuk dieksekusi secara asinkron di latar belakang.
Parameter dalam UploadMetadata (seperti Title, Description, dan Tags) tidak boleh mengandung karakter emoji.
Jika callback dikonfigurasi, setelah unggahan video selesai, Anda akan menerima notifikasi penyelesaian unggahan video berbasis URL selain notifikasi unggahan dan transkoding.
Ketika tugas diajukan secara batch, setiap SourceURL memiliki notifikasi independen.

Elemen respons

Element	Type	Description	Example
	object	Parameter respons.
RequestId	string	ID permintaan.	**83B7-7F87-4792-BFE9-63CD2137**
UploadJobs	array<object>	Informasi mengenai beberapa pekerjaan.
	object	Rincian tugas unggahan.
JobId	string	ID tugas unggahan.	20ce1e05dba64576b96e9683879f0***
SourceURL	string	URL file sumber tugas unggahan.	http://example****.mp4
MediaId	string	ID aset media.	f476988629f54a7b8a4ba90d1a6c7***

Contoh

Respons sukses

JSONformat

{
  "RequestId": "****83B7-7F87-4792-BFE9-63CD2137****",
  "UploadJobs": [
    {
      "JobId": "20ce1e05dba64576b96e9683879f0***",
      "SourceURL": "http://example****.mp4\n",
      "MediaId": "f476988629f54a7b8a4ba90d1a6c7***"
    }
  ]
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.