Daftarkan aset media - Intelligent Media Services

Mendaftarkan aset media ke Intelligent Media Services (IMS). IMS menetapkan ID untuk aset media tersebut. Operasi ini mengakses layanan aset media tempat aset media disimpan secara asinkron untuk memperoleh informasi file berdasarkan URL input. Anda juga dapat menentukan informasi dasar seperti judul, tag, dan deskripsi untuk aset media tersebut. Operasi ini mengembalikan ID aset media, yang dapat digunakan untuk memanggil operasi GetMediaInfo guna mengkueri detail aset media. Parameter InputURL hanya dapat diatur ke URL file Object Storage Service (OSS) atau aset media ApsaraVideo VOD.

Deskripsi operasi

Pendaftaran aset media merupakan proses asinkron yang memerlukan waktu 2 hingga 3 detik. Meskipun operasi telah mengembalikan ID aset media, proses pendaftaran mungkin belum selesai. Jika Anda memanggil operasi GetMediaInfo pada saat itu, informasi aset media mungkin belum tersedia.

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

create

*全部资源

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
InputURL	string	Yes	URL aset media di layanan lain. URL ini dikaitkan dengan ID aset media di IMS. URL tidak dapat diubah setelah didaftarkan. Jenis URL berikut didukung: URL OSS dalam salah satu format berikut: http(s)://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4 oss://example-bucket/example.mp4: Dalam format ini, wilayah bucket OSS tempat aset media berada dianggap sama dengan wilayah tempat IMS diaktifkan. URL aset media ApsaraVideo VOD vod://*20b48fb04483915d4f2cd8ac**	http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4 或 vod://**20b48fb04483915d4f2cd8ac**
MediaType	string	No	Jenis aset media. Nilai yang valid: image video audio text Kami menyarankan agar Anda menentukan parameter ini sesuai kebutuhan bisnis Anda. Jika Anda mengatur InputURL ke URL OSS, jenis aset media dapat ditentukan secara otomatis berdasarkan ekstensi nama file. Untuk informasi selengkapnya .	video
BusinessType	string	No	Jenis bisnis aset media. Nilai yang valid: subtitles watermark opening ending general	opening
Title	string	No	Judul. Jika Anda tidak menentukan parameter ini, judul default akan dibuat secara otomatis berdasarkan tanggal. Nilainya dapat mencapai panjang maksimum 128 byte. Nilai harus dikodekan dalam UTF-8.	defaultTitle
Description	string	No	Deskripsi aset media. Nilainya dapat mencapai panjang maksimum 1.024 byte. Nilai harus dikodekan dalam UTF-8.	defaultDescription
MediaTags	string	No	Tag aset media. Mendukung hingga 16 tag. Pisahkan beberapa tag dengan koma (,). Panjang tiap tag maksimal 32 byte. Nilai harus dikodekan dalam UTF-8.	tag1,tag2
CoverURL	string	No	URL gambar mini aset media. Nilainya dapat mencapai panjang maksimum 128 byte. Nilai harus dikodekan dalam UTF-8.	http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.png
UserData	string	No	Data pengguna. Anda dapat menentukan URL callback kustom. Untuk informasi selengkapnya. Nilainya dapat mencapai panjang maksimum 1.024 byte. Nilai harus dikodekan dalam UTF-8. Nilai harus dalam format JSON.	{"NotifyAddress":"http://xx.xx.xxx"} 或{"NotifyAddress":"https://xx.xx.xxx"} 或{"NotifyAddress":"ice-callback-demo"}
Overwrite	boolean	No	Menentukan apakah akan menimpa aset media yang telah didaftarkan menggunakan URL yang sama. Nilai default: false. Nilai yang valid: - true: Jika aset media telah didaftarkan menggunakan URL yang sama, aset media asli akan dihapus dan aset media baru akan didaftarkan. - false: Jika aset media telah didaftarkan menggunakan URL yang sama, aset media baru tidak akan didaftarkan. Satu URL tidak dapat digunakan untuk mendaftarkan beberapa aset media.	true
ClientToken	string	No	Token klien yang digunakan untuk memastikan idempotensi permintaan. Nilainya harus berupa UUID yang terdiri dari 32 karakter.	**0311a423d11a5f7dee713535**
RegisterConfig	string	No	Konfigurasi pendaftaran. Secara default, sprite akan dibuat untuk aset media. Anda dapat mengatur NeedSprite ke false untuk menonaktifkan pembuatan sprite otomatis. Secara default, snapshot akan dibuat untuk aset media. Anda dapat mengatur NeedSnapshot ke false untuk menonaktifkan pembuatan snapshot otomatis.	{ "NeedSprite": "false", "CoverConfig": { "StartTime": 1.0 }, "SearchLibName": "test" }
CateId	integer	No	ID kategori.	3048
WorkflowId	string	No	ID alur kerja.	****b4fb044839815d4f2cd8****
ReferenceId	string	No	ID kustom. ID ini harus terdiri dari 6 hingga 64 karakter dan hanya boleh berisi huruf, angka, tanda hubung (-), dan garis bawah (_). Pastikan ID tersebut unik di antara pengguna.	123-123
SmartTagTemplateId	string	No	ID templat tagging cerdas. Nilai yang valid: S00000101-300080: templat sistem yang mendukung pemrosesan bahasa alami (NLP) untuk pengenalan konten. S00000103-000001: templat sistem yang mendukung NLP untuk pengenalan konten dan semua kemampuan tagging. S00000103-000002: templat sistem yang mendukung semua kemampuan tagging tetapi tidak mendukung NLP untuk pengenalan konten. Setelah Anda mengonfigurasi parameter ini, tugas analisis tagging cerdas akan secara otomatis dimulai setelah aset media didaftarkan. Untuk informasi selengkapnya mengenai item yang dapat ditagih.	S00000101-300080

Elemen respons

Element	Type	Description	Example
	object	Parameter respons.
RequestId	string	ID permintaan.	****5A-CAAC-4850-A3AF-B74606****
MediaId	string	ID aset media di IMS.	****b48fb04483915d4f2cd8****

Contoh

Respons sukses

JSONformat

{
  "RequestId": "******5A-CAAC-4850-A3AF-B74606******",
  "MediaId": "******b48fb04483915d4f2cd8******"
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
403	Forbidden	User not authorized to operate on the specified resource.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.