Dapatkan URL unggah dan kredensial untuk aset media menggunakan CreateUploadMedia - Layanan Media Cerdas - Alibaba Cloud - Intelligent Media Services

Deskripsi operasi

Mengambil URL unggah dan unggah kredensial adalah operasi inti di Intelligent Media Services dan diperlukan untuk setiap prosedur unggah.
Jika unggah kredensial video kedaluwarsa (epoch validitas default adalah 3000 detik), panggil operasi refresh video upload credential untuk mendapatkan unggah kredensial baru.
Setelah unggah, Anda dapat mengonfigurasi callback untuk menerima notifikasi event unggah, atau memanggil operasi GetMediaInfo untuk memeriksa status Aset media yang dikembalikan guna menentukan apakah unggah berhasil.
Parameter MediaId yang dikembalikan oleh operasi ini dapat digunakan untuk manajemen siklus hidup Aset media atau pemrosesan media.

Batasan

Operasi ini hanya mendukung unggah ke penyimpanan VOD. Unggah ke penyimpanan OSS milik pengguna tidak didukung. Jika Anda menggunakan penyimpanan OSS sendiri, unggah file ke OSS menggunakan OSS SDK, lalu panggil operasi RegisterMediaInfo untuk mendaftarkan file OSS ke pustaka Aset media.
Operasi ini saat ini hanya mendukung wilayah China (Shanghai), China (Beijing), dan China (Shenzhen).

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

create

*全部资源

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
AppId	string	No	ID aplikasi. Nilai default: app-1000000.	app-1000000
EntityId	string	No	ID entitas. Anda dapat memanggil operasi CreateEntity untuk membuat entitas dan menentukan struktur metadata dinamis kustom.	9e177cac2fb44f8b8c67b199fcc7bffd
FileInfo	string	No	Informasi file dalam format JSON. Parameter ini berisi field berikut: Type (wajib): tipe file. Nilai valid: video, image, audio, text, dan other. Name (wajib): nama file tanpa ekstensi nama file. Size (opsional): ukuran file. Ext (wajib): ekstensi nama file.	{\"Type\":\"video\",\"Name\":\"test\",\"Size\":108078336,\"Ext\":\"mp4\"}
UserData	string	No	Pengaturan kustom. Nilainya adalah string JSON yang mendukung pengaturan seperti callback Paket.	{"MessageCallback":{"CallbackURL":"http://example.aliyundoc.com"},"Extend":{"localId":"*****","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 Aset media yang akan diunggah, dalam format JSON. Title (wajib): judul. Judul dapat memiliki panjang hingga 128 karakter. Dikodekan UTF-8. Description (opsional): deskripsi. Deskripsi dapat memiliki panjang hingga 1024 karakter. Dikodekan UTF-8. CateId (opsional): ID kategori. Tags (opsional): tag. BusinessType (wajib): tipe bisnis. Nilai valid: Jika Type diatur ke video, nilai valid: opening: kredit pembuka. ending: kredit penutup. Jika Type diatur ke image, nilai valid: default: default. cover: gambar sampul. Jika Type diatur ke text, nilai valid: subtitles: subtitle. font: font. Jika Type diatur ke material, nilai valid: watermark: Watermark. general: serbaguna. CoverURL (opsional): URL sampul. DynamicMetaData: metadata dinamis. Nilainya adalah string.	{\"Title\": \"UploadTest\", \"Description\": \"UploadImageTest\", \"Tags\": \"tag1,tag2\",\"BusinessType\":\"cover\"}
PostProcessConfig	string	No	Aksi pemrosesan pasca-unggah, berlaku ketika Type diatur ke video atau audio. Nilai valid ProcessType: Workflow. Catatan Parameter ini memicu Tugas asinkron. Setelah dikirim, tugas tidak langsung selesai dan akan masuk antrean untuk dieksekusi secara asinkron di latar belakang.	{\"ProcessType\":\"Workflow\",\"ProcessID\":\"74ba870f1a4873a3ba238e0bf6fa9***\"}

Elemen respons

Element	Type	Description	Example
	object	Parameter tanggapan.
RequestId	string	ID permintaan.	4E84BE44-58A7-**-**-FBEBEA16EF94
MediaId	string	ID Aset media.	**20b48fb04483915d4f2cd8ac**
MediaURL	string	URL Aset media. Catatan Jika Nama domain CDN dikonfigurasi, URL CDN akan dikembalikan. Jika tidak, URL OSS akan dikembalikan. Jika MediaURL yang dikembalikan tidak dapat diakses (403) di browser, Penandatanganan URL diaktifkan untuk Nama domain VOD. Nonaktifkan Penandatanganan URL atau buat tanda tangan penandatanganan.	https://xxq-live-playback.oss-cn-shanghai.aliyuncs.com/capture/5d96d2b4-111b-4e5d-a0e5-20f44405bb55.mp4
FileURL	string	URL OSS file (tanpa otentikasi).	http://outin-***.oss-cn-north-2-gov-1.aliyuncs.com/sv/40360f05-181f63c3110-0004-cd8e-27f-de3c9.mp4
UploadAddress	string	URL unggah. Catatan URL unggah yang dikembalikan oleh operasi ini dikodekan Base64. Saat Anda menggunakan SDK atau API untuk mengunggah Aset media, dekode nilai Base64 sebelum digunakan. Anda hanya perlu mengurai UploadAddress saat menggunakan OSS SDK atau OSS API native untuk unggah.	eyJTZWN1cml0a2VuIjoiQ0FJU3p3TjF****
UploadAuth	string	Unggah kredensial. Catatan Unggah kredensial yang dikembalikan oleh operasi ini dikodekan Base64. Saat Anda menggunakan SDK atau API untuk mengunggah Aset media, dekode nilai Base64 sebelum digunakan. Anda hanya perlu mengurai UploadAuth saat menggunakan OSS SDK atau OSS API native untuk unggah.	eyJFbmRwb2ludCI6Imm****

Contoh

Respons sukses

JSONformat

{
  "RequestId": "4E84BE44-58A7-****-****-FBEBEA16EF94",
  "MediaId": "****20b48fb04483915d4f2cd8ac****",
  "MediaURL": "https://xxq-live-playback.oss-cn-shanghai.aliyuncs.com/capture/5d96d2b4-111b-4e5d-a0e5-20f44405bb55.mp4",
  "FileURL": "http://outin-***.oss-cn-north-2-gov-1.aliyuncs.com/sv/40360f05-181f63c3110-0004-cd8e-27f-de3c9.mp4",
  "UploadAddress": "eyJTZWN1cml0a2VuIjoiQ0FJU3p3TjF****",
  "UploadAuth": "eyJFbmRwb2ludCI6Imm****"
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.