What are the workflow trigger modes? - ApsaraVideo Media Processing

Comparaison des modes de déclenchement

Mode de déclenchement	Scénario
Déclenchement automatique	Un fichier doit être traité par le workflow prédéfini immédiatement après son téléchargement vers le chemin d'accès spécifié.
Déclenchement manuel pour les fichiers situés sous un chemin d'accès vérifié	Plusieurs fichiers historiques stockés dans Object Storage Service (OSS) doivent être traités par lot via le workflow prédéfini. Le traitement du fichier n'est pas requis immédiatement après le téléchargement. Par exemple, vous souhaitez traiter un fichier uniquement après qu'un utilisateur y a accédé ou lorsqu'il est consulté par un grand nombre d'utilisateurs. Les fichiers doivent être traités par différents workflows selon votre logique métier.
Déclenchement manuel pour les fichiers situés sous différents chemins d'accès	Des fichiers stockés dans différents chemins d'accès doivent être traités par le même workflow.

Mode 1 : Déclenchement automatique

Créez un workflow et définissez son mode de déclenchement sur « déclenchement automatique ». Par défaut, tout nouveau workflow utilise ce mode. Pour plus d'informations sur la création d'un workflow, consultez Créer un workflow.
Ajoutez un fichier. Les conditions suivantes doivent être remplies :
- Le fichier ne doit pas avoir été généré par MPS ou Intelligent Media Services (IMS). Pour plus d'informations, reportez-vous à la section « Les fichiers ne sont pas générés par MPS ou IMS » de cette rubrique.
- Le chemin d'accès au fichier respecte les règles de correspondance de chemin. Pour plus d'informations, reportez-vous à la section « Règles de correspondance de chemin » de cette rubrique.
- Le nom du fichier respecte les règles de correspondance d'extension de fichier. Pour plus d'informations, reportez-vous à la section « Règles de correspondance d'extension de fichier » de cette rubrique.
- Le fichier est téléchargé en appelant l'une des opérations API OSS suivantes.
  |
  Opération
  |
  Description
  | | --- | --- | |
  PutObject
  |
  Télécharge un objet.
  | |
  PostObject
  |
  Télécharge un objet vers un compartiment spécifique à l'aide d'un formulaire HTML.
  | |
  CopyObject
  |
  Copie un objet au sein d'un compartiment ou entre des compartiments situés dans la même région.
  | |
  CompleteMultipartUpload
  |
  Combine les parties téléchargées pour former un objet une fois que toutes les parties ont été envoyées.
  | |
  PutSymlink
  |
  Crée un lien symbolique pour un objet, ce qui permet d'y accéder via ce lien.
  |

Mode 2 : Déclenchement manuel pour les fichiers situés sous un chemin d'accès vérifié

Créez un workflow. Avant d'ajouter des fichiers, modifiez le mode de déclenchement du workflow en le passant à déclenchement manuel en appelant l'opération UpdateMediaWorkflowTriggerMode. Pour plus d'informations sur la création d'un workflow, consultez Créer un workflow.

Ajoutez un fichier. Les conditions suivantes doivent être remplies :
- Le chemin d'accès au fichier respecte les règles de correspondance de chemin. Pour plus d'informations, reportez-vous à la section « Règles de correspondance de chemin » de cette rubrique.
- Le nom du fichier respecte les règles de correspondance d'extension de fichier. Pour plus d'informations, reportez-vous à la section « Règles de correspondance d'extension de fichier » de cette rubrique.
- Le fichier est téléchargé en appelant l'opération API OSS de votre choix.
Une fois le fichier ajouté, appelez l'opération AddMedia pour spécifier le fichier à traiter ainsi que l'ID du workflow à déclencher, selon vos besoins métier.

Mode 3 : Déclenchement manuel pour les fichiers situés sous différents chemins d'accès

Créez un workflow. Avant d'ajouter des fichiers, modifiez le mode de déclenchement du workflow en le passant à déclenchement manuel en appelant l'opération UpdateMediaWorkflowTriggerMode. Pour plus d'informations sur la création d'un workflow, consultez Créer un workflow.

Ajoutez un fichier. Les conditions suivantes doivent être remplies :
- Le fichier est stocké dans la région où MPS est activé.
- Le fichier est téléchargé en appelant l'opération API OSS de votre choix.
Une fois le fichier ajouté, appelez l'opération AddMedia pour spécifier le fichier à traiter ainsi que l'ID du workflow à déclencher, selon vos besoins métier. Définissez également le paramètre InputUnbind sur false, afin d'indiquer que MPS ne vérifie pas le fichier par rapport aux règles de correspondance de chemin ni aux règles de correspondance d'extension de fichier.

Règles de correspondance des fichiers

Les fichiers ne sont pas générés par MPS ou IMS

Si le chemin d'accès en entrée d'un workflow coïncide avec le chemin d'accès en sortie d'une tâche MPS ou IMS, les fichiers générés par cette tâche ne peuvent pas déclencher le workflow. Cette restriction évite les déclenchements cycliques dus au chevauchement des chemins d'entrée et de sortie. Exemple :

Le chemin de sortie du Workflow A et le chemin d'entrée du Workflow B sont tous deux http://bucket.oss-cn-hangzhou.aliyuncs.com/A/.

Si le fichier d'entrée http://bucket.oss-cn-hangzhou.aliyuncs.com/A/example.flv a été généré par le Workflow A, le Workflow B ne peut pas être déclenché.
Si le fichier d'entrée http://bucket.oss-cn-hangzhou.aliyuncs.com/A/example.flv est directement téléchargé vers le chemin http://bucket.oss-cn-hangzhou.aliyuncs.com/A/, le Workflow B peut être déclenché.

Règles de correspondance de chemin

Un fichier d'entrée ne peut déclencher un workflow que si son chemin se trouve sous le chemin d'accès en entrée spécifié pour le nœud Input du workflow. Exemple :

Remarque

Évitez de définir le chemin d'accès en entrée d'un workflow comme préfixe du chemin d'accès en entrée d'un autre workflow. Dans le cas contraire, les deux workflows seront déclenchés lors du téléchargement d'un fichier vers le second chemin. Par exemple, si le chemin d'entrée du Workflow A est test et celui du Workflow B est test1, le téléchargement d'un fichier dans le dossier test1 déclenchera les deux workflows.

Si le chemin d'accès en entrée spécifié pour le nœud Input d'un workflow se termine par une barre oblique (/), comme http://bucket.oss-cn-hangzhou.aliyuncs.com/A/, le tableau suivant présente les résultats de correspondance pour différents fichiers d'entrée.

|
**Chemin d'un fichier d'entrée**
|
**Correspondance**
| | --- | --- | |
http://bucket.oss-cn-hangzhou.aliyuncs.com/A/example.flv
|
Oui
| |
http://bucket.oss-cn-hangzhou.aliyuncs.com/A/B/example.flv
|
Oui
| |
http://bucket.oss-cn-hangzhou.aliyuncs.com/A/B/C/example.flv
|
Oui
| |
http://bucket.oss-cn-hangzhou.aliyuncs.com/A1/example.flv
|
Non
| |
http://bucket.oss-cn-hangzhou.aliyuncs.com/A_video01.mp4
|
Non
| |
http://bucket.oss-cn-beijing.aliyuncs.com/A/example.flv
|
Non
| |
http://bucket.oss-cn-hangzhou.aliyuncs.com/example.flv
|
Non
| |
http://bucket.oss-cn-hangzhou.aliyuncs.com/D/example.flv
|
Non
|

Si le chemin d'accès en entrée spécifié pour le nœud Input d'un workflow ne se termine pas par une barre oblique (/), comme http://bucket.oss-cn-hangzhou.aliyuncs.com/A, le tableau suivant présente les résultats de correspondance pour différents fichiers d'entrée.

|
**Chemin d'un fichier d'entrée**
|
**Correspondance**
| | --- | --- | |
http://bucket.oss-cn-hangzhou.aliyuncs.com/A/example.flv
|
Oui
| |
http://bucket.oss-cn-hangzhou.aliyuncs.com/A/B/example.flv
|
Oui
| |
http://bucket.oss-cn-hangzhou.aliyuncs.com/A/B/C/example.flv
|
Oui
| |
http://bucket.oss-cn-hangzhou.aliyuncs.com/A1/example.flv
|
Oui
| |
http://bucket.oss-cn-hangzhou.aliyuncs.com/A_video01.mp4
|
Oui
| |
http://bucket.oss-cn-beijing.aliyuncs.com/A/example.flv
|
Non
| |
http://bucket.oss-cn-hangzhou.aliyuncs.com/example.flv
|
Non
| |
http://bucket.oss-cn-hangzhou.aliyuncs.com/D/example.flv
|
Non
|

Règles de correspondance d'extension de fichier

Le tableau ci-dessous répertorie les extensions de fichier prises en charge. Un fichier d'entrée ne peut déclencher un workflow que si son extension figure dans cette liste. Exemple :

Le fichier d'entrée est http://bucket.oss-cn-hangzhou.aliyuncs.com/A/B/C/test1.flv. L'extension .flv respecte les règles de correspondance.

Remarque

La vérification s'appuie sur la dernière extension du nom de fichier. Par exemple, si le fichier d'entrée est http://bucket.oss-cn-hangzhou.aliyuncs.com/A/B/C/test1.flv.mp4, l'extension considérée est .mp4, laquelle respecte les règles de correspondance.

|
**Type**
|
**Extension de fichier**
| | --- | --- | |
Fichier vidéo
|
.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, .vob, .wmv, .webm, .mxf, et .quicktime
| |
Fichier audio
|
.s48, .aac, .ac3, .acm, .amr, .ape, .caf, .flac, .m4a, .mp3, .ra, .wav, .wma, et .aiff
|