Gunakan StartWorkflow untuk mengirimkan tugas workflow - Intelligent Media Services - Alibaba Cloud - Intelligent Media Services

Deskripsi operasi

Saat ini, hanya aset media Intelligent Media Services (IMS) dan aset media ApsaraVideo VOD yang didukung sebagai input alur kerja.
Saat Anda memulai tugas alur kerja, tentukan templat alur kerja. Anda dapat membuat templat alur kerja di Konsol Intelligent Media Services atau menggunakan template preset.

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

create

*Semua Sumber daya.

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
WorkflowId	string	Yes	ID templat alur kerja. Anda dapat melihat ID templat di Konsol Intelligent Media Services dengan menavigasi ke Manajemen Konfigurasi > Templat Alur Kerja.	****f0e54971ecbffd472190****
TaskInput	string	No	Input alur kerja. Saat ini, tipe aset media dan file OSS didukung. Type: tipe objek media yang didukung. Nilai valid: OSS: file OSS. Media: ID aset media. Media: nilai media. Nilai valid: Jika Type diatur ke OSS, nilainya adalah URL yang mendukung protokol OSS dan protokol HTTP. Jika Type diatur ke Media, nilainya adalah ID aset media.	{ "Type": "Media", "Media": "****30706071edbfe290b488****" } or { "Type": "OSS", "Media": "oss://bucket.oss-ap-southeast-1.aliyuncs.com/A/B/C/test1.flv" }
UserData	string	No	Pengaturan kustom dalam format JSON. Panjang maksimum adalah 512 byte. Konfigurasi URL callback kustom didukung.	{"NotifyAddress":"https://xx.xx.xxx"} or {"NotifyAddress":"ice-callback-demo"}
SkipInputVerification	boolean	No	Apakah akan melewatkan verifikasi jalur input untuk alur kerja. Parameter ini hanya berlaku jika input alur kerja adalah file OSS. Kami menyarankan Anda untuk tidak melewatkan verifikasi guna menghindari error yang disebabkan oleh jalur yang salah. Jika parameter ini tidak ditentukan, nilai defaultnya adalah false. Nilai valid: true: Melewatkan verifikasi. false: Tidak melewatkan verifikasi.	false

Aturan pencocokan pemicu alur kerja

Ketika file OSS memicu alur kerja, kebijakan eksekusi pencocokan aturan adalah sebagai berikut: berdasarkan jalur file yang baru ditambahkan, sistem memeriksa lokasi yang terikat pada alur kerja. Jika jalur file yang baru ditambahkan berisi string yang terikat pada aturan, aturan tersebut cocok. Jika tidak, aturan tidak cocok. Misalnya, untuk http://bucket.oss-ap-southeast-1.aliyuncs.com/A/B/C/test1.flv, aturannya adalah:

1. http://bucket.oss-ap-southeast-1.aliyuncs.com/A/B/C/          Cocok
2. http://bucket.oss-ap-southeast-1.aliyuncs.com/A/B/            Cocok
3. http://bucket.oss-ap-southeast-1.aliyuncs.com/A/              Cocok
4. http://bucket.oss-ap-southeast-1.aliyuncs.com/                Cocok
5. http://bucket.oss-ap-southeast-1.aliyuncs.com/A/B/C/test.flv  Cocok
6. http://bucket.oss-ap-southeast-1.aliyuncs.com/A/B/CC/         Tidak cocok
7. http://bucket.oss-ap-southeast-1.aliyuncs.com/A/B2/           Tidak cocok
8. http://bucket.oss-ap-southeast-1.aliyuncs.com/A2/B/C/         Tidak cocok

Catatan

Saat Anda membuat alur kerja media, jangan konfigurasikan jalur input satu alur kerja sebagai awalan dari jalur input alur kerja lainnya. Jika tidak, satu file inkremental akan memicu dua instance eksekusi alur kerja. Misalnya, jika jalur input dua alur kerja dikonfigurasi masing-masing sebagai test dan test1, file yang diunggah ke folder test1 juga cocok dengan awalan test, yang memicu dua instance eksekusi alur kerja.

Mencocokkan ekstensi nama file

Pemicu memerlukan file multimedia. Layanan pustaka media menentukan tipe file berdasarkan ekstensi nama file. File tidak memiliki ekstensi nama file (nama file tidak mengandung pemisah ekstensi ".") atau memiliki ekstensi nama file yang sesuai dengan aturan berikut:

Catatan

Untuk file SWF, kualitas layanan tangkapan layar dan transkoding tidak dijamin.

Tipe	Ekstensi
Video	3gp, asf, avi, dat, dv, flv, f4v, gif, m2t, m3u8, m4v, mj2, mjpeg, mkv, mov, mp4, mpe, mpg, mpeg, mts, ogg, qt, rm, rmvb, swf, ts, vob, wmv, webm
Audio	aac, ac3, acm, amr, ape, caf, flac, m4a, mp3, ra, wav, wma, aiff

Elemen respons

Element	Type	Description	Example
	object	Skema Respons.
RequestId	string	ID permintaan.	****42-E8E1-4FBB-8E52-F4225C****
TaskId	string	ID tugas alur kerja.	****22dad741d086a50325f9****

Contoh

Respons sukses

JSONformat

{
  "RequestId": "******42-E8E1-4FBB-8E52-F4225C******",
  "TaskId": "******22dad741d086a50325f9******"
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.