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

Deskripsi operasi

Mengambil URL unggah dan kredensial merupakan fondasi inti Intelligent Media Services serta prosedur wajib untuk setiap operasi unggah.
Jika kredensial unggah video kedaluwarsa (masa berlaku default adalah 3.000 detik), panggil operasi refresh video upload credential untuk mendapatkan kredensial unggah baru.
Setelah unggah selesai, Anda dapat mengonfigurasi callback untuk menerima notifikasi event unggah atau memanggil operasi GetMediaInfo guna memeriksa status aset media yang dikembalikan dan 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 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

*Semua Sumber daya.

*

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 menyesuaikan struktur metadata dinamis.	9e177cac2fb44f8b8c67b199fcc7bffd
FileInfo	string	No	Informasi file dalam format JSON. Parameter ini berisi bidang-bidang berikut: Type (wajib): jenis file. Nilai yang 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 berupa string JSON yang mendukung pengaturan seperti callback pesan.	{"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): Panjang maksimum 128 karakter. Dienkode UTF-8. Description (opsional): Panjang maksimum 1024 karakter. Dienkode UTF-8. CateId (opsional): ID kategori. Tags (opsional): tag. BusinessType (wajib): jenis bisnis. Nilai yang valid: Jika Type = video:opening: opening credits.ending: ending credits. Jika Type = image:default: default.cover: cover image. Jika Type = text:subtitles: subtitles.font: font. Jika Type = material:watermark: watermark. general: general-purpose. CoverURL (opsional): URL sampul. DynamicMetaData: metadata dinamis. Nilainya berupa string.	{\"Title\": \"UploadTest\", \"Description\": \"UploadImageTest\", \"Tags\": \"tag1,tag2\",\"BusinessType\":\"cover\"}
PostProcessConfig	string	No	Menentukan aksi pemrosesan pasca-unggah ketika Type = video atau audio. ProcessType: atur ke Workflow. Catatan Parameter ini memicu tugas asinkron. Setelah dikirim, tugas tidak langsung selesai dan masuk ke antrian latar belakang untuk dieksekusi secara asinkron.	{\"ProcessType\":\"Workflow\",\"ProcessID\":\"74ba870f1a4873a3ba238e0bf6fa9***\"}

Elemen respons

Element	Type	Description	Example
	object	Parameter respons.
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 yang dikembalikan. Jika MediaURL yang dikembalikan tidak dapat diakses (403) di browser, Penandatanganan URL diaktifkan untuk Nama domain VOD. Nonaktifkan Penandatanganan URL atau buat signature penandatanganan.	https://xxq-live-playback.oss-cn-shanghai.aliyuncs.com/capture/5d96d2b4-111b-4e5d-a0e5-20f44405bb55.mp4
FileURL	string	URL OSS file (tanpa autentikasi).	http://outin-***.oss-cn-north-2-gov-1.aliyuncs.com/sv/40360f05-181f63c3110-0004-cd8e-27f-de3c9.mp4
UploadAddress	string	Alamat unggah. Catatan Alamat unggah yang dikembalikan oleh operasi ini merupakan nilai yang dikodekan Base64. Saat Anda memanggil SDK atau API untuk mengunggah aset media, dekode nilai tersebut menggunakan Base64 sebelum digunakan. Hanya unggah melalui OSS SDK native atau OSS API yang memerlukan Anda untuk mengurai UploadAddress.	eyJTZWN1cml0a2VuIjoiQ0FJU3p3TjF****
UploadAuth	string	Kredensial unggah. Catatan Kredensial unggah yang dikembalikan oleh operasi ini merupakan nilai yang dikodekan Base64. Saat Anda memanggil SDK atau API untuk mengunggah aset media, dekode nilai tersebut menggunakan Base64 sebelum digunakan. Hanya unggah melalui OSS SDK native atau OSS API yang memerlukan Anda untuk mengurai UploadAuth.	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.