Daftarkan aset media - Intelligent Media Services - Alibaba Cloud - Intelligent Media Services

Memulai tugas untuk mendaftarkan aset media dan menetapkan mediaId baru di Intelligent Media Services (IMS). Berdasarkan InputURL, operasi ini memanggil layanan informasi aset media lainnya secara asinkron untuk mengambil informasi file tentang aset media. Anda juga dapat mengatur informasi dasar seperti judul, tag, dan deskripsi. Operasi ini mengembalikan mediaId secara sinkron. Anda dapat memanggil operasi [GetMediaInfo](~~441155~~) untuk mendapatkan informasi detail aset media. Saat ini, hanya file OSS dan aset media VOD yang didukung sebagai nilai InputURL.

Deskripsi operasi

Pendaftaran aset media adalah tugas asinkron yang biasanya membutuhkan waktu 2 hingga 3 detik untuk diselesaikan. Saat operasi pendaftaran mengembalikan mediaId, aset media mungkin belum sepenuhnya terdaftar. Dalam hal ini, memanggil GetMediaInfo mungkin tidak mengembalikan informasi file aset media.

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 yang akan didaftarkan di sistem terkait. Setelah terdaftar, URL ini tidak dapat diubah dan dilampirkan ke mediaId IMS. URL OSS. Dua format didukung. http(s)://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4 oss://example-bucket/example.mp4 (Format ini mengasumsikan wilayah OSS sama dengan area pendaftaran layanan secara default.) Aset media VOD vod://*20b48fb04483915d4f2cd8ac**.	http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4 或 vod://**20b48fb04483915d4f2cd8ac**
MediaType	string	No	Tipe media aset media. Nilai valid: image video audio text Saat nilainya adalah text, businessType harus diatur ke subtitles atau font. Tentukan parameter ini sesuai kebutuhan. Saat InputURL adalah URL OSS, tipe media juga dapat ditentukan secara otomatis berdasarkan ekstensi nama file (hanya untuk ekstensi file image, video, dan audio). Untuk pemetaan, lihat File formats.	video
BusinessType	string	No	Tipe bisnis aset media. Nilai valid: subtitles font watermark opening ending general.	opening
Title	string	No	Judul. Jika tidak ditentukan, judul default akan dibuat secara otomatis berdasarkan tanggal. Panjang maksimum: 128 byte. Dikodekan UTF-8.	defaultTitle
Description	string	No	Deskripsi konten. Panjang maksimum: 1024 byte. Dikodekan UTF-8.	defaultDescription
MediaTags	string	No	Tag. Jumlah tag maksimum: 16. Pisahkan beberapa tag dengan koma (,). Panjang maksimum satu tag: 32 byte. Dikodekan UTF-8.	tag1,tag2
CoverURL	string	No	URL gambar sampul. Panjang maksimum: 128 byte. Dikodekan UTF-8.	http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.png
UserData	string	No	Data pengguna. Konfigurasi URL callback kustom didukung. Untuk informasi lebih lanjut, lihat Configure a callback upon editing completion. Panjang maksimum: 1024 byte. Dikodekan UTF-8. Format JSON.	{"NotifyAddress":"http://xx.xx.xxx"} 或{"NotifyAddress":"https://xx.xx.xxx"} 或{"NotifyAddress":"ice-callback-demo"}
Overwrite	boolean	No	Apakah akan menimpa aset media terdaftar yang sudah ada. Nilai default: false. true: Jika inputUrl sudah terdaftar, aset media yang ada akan dihapus dan aset media baru akan didaftarkan. false: Jika inputUrl sudah terdaftar, aset media baru tidak akan didaftarkan. Nilai inputUrl duplikat tidak didukung.	true
ClientToken	string	No	Token klien. UUID 32 karakter yang memastikan idempotensi permintaan.	**0311a423d11a5f7dee713535**
RegisterConfig	string	No	Konfigurasi pendaftaran. Secara default, gambar Sprite dibuat untuk aset media. Untuk menonaktifkannya, atur bidang NeedSprite ke false. Secara default, Snapshot dibuat. Untuk menonaktifkannya, atur bidang NeedSnapshot ke false. Untuk menentukan pengatur waktu gambar sampul, konfigurasikan CoverConfig, yang berisi bidang berikut: StartTime: waktu dalam detik saat gambar sampul diambil dari aset media. Hingga empat tempat desimal didukung. Setelah pendaftaran aset media, untuk mengimpor aset media ke pustaka pencarian kustom, konfigurasikan SearchLibName. Untuk informasi tentang cara membuat dan menggunakan pustaka pencarian kustom, lihat Use a custom search library.	{ "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. Hanya huruf kecil, huruf besar, digit, tanda hubung (-), dan garis bawah (_) yang didukung. Panjangnya harus 6 hingga 64 karakter. ID harus unik untuk setiap pengguna.	123-123
SmartTagTemplateId	string	No	Templat tag pintar. Nilai valid: S00000101-300080: templat sistem yang mencakup pemahaman konten NLP. S00000103-000001: templat yang mencakup pemahaman konten NLP dan semua kemampuan penandaan. S00000103-000002: templat yang mencakup semua kemampuan penandaan tetapi tidak mencakup pemahaman konten NLP. Untuk informasi lebih lanjut tentang kemampuan penandaan, lihat dokumentasi. Setelah parameter ini dikonfigurasi, tugas analisis tag pintar akan dimulai secara otomatis saat pendaftaran aset media. Untuk informasi penagihan, lihat Penagihan Tag Pintar Edisi Standar.	S00000101-300080

Elemen respons

Element	Type	Description	Example
	object	Skema Respons.
RequestId	string	ID permintaan.	****5A-CAAC-4850-A3AF-B74606****
MediaId	string	ID aset media 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.