Les déclencheurs traitent les nouveaux fichiers présents dans un compartiment Object Storage Service (OSS). Par exemple, vous pouvez convertir des fichiers .docx nouvellement ajoutés au format .pdf ou transcoder des fichiers .mov au format .mp4. Contrairement au traitement par lots, un déclencheur ne traite que les nouveaux fichiers ajoutés à un compartiment après sa création. Il ignore les fichiers existants.
Les API et les kits de développement logiciel (SDK) pour la nouvelle fonctionnalité de traitement des données sont disponibles dans les régions disposant de points de terminaison IMM.
Les déclencheurs sont des tâches asynchrones qui s'exécutent en arrière-plan. La durée d'exécution varie. Par conséquent, le fichier de sortie n'est pas immédiatement accessible après le chargement du fichier source.
Après la création d'un déclencheur, celui-ci génère une tâche de traitement des données pour chaque nouveau fichier. L'exécution des tâches est facturée. Pour plus d'informations, consultez la rubrique Facturation.
Remarques sur l'utilisation
Un déclencheur génère des tâches de traitement des données pour les fichiers qui répondent aux conditions spécifiées. Nous vous recommandons de tester le déclencheur avec un petit nombre de fichiers.
Si vous suspendez un déclencheur, il cesse immédiatement de générer de nouvelles tâches de traitement des données. Toutefois, les tâches déjà soumises continuent de s'exécuter.
Le chemin de sortie ne doit pas être identique au chemin d'entrée ni avoir ce dernier comme préfixe. Cette règle permet d'éviter les boucles de déclenchement et l'écrasement des fichiers sources.
Le chemin de sortie ne peut pas se terminer par une barre oblique (
/). Vous devez spécifier un chemin d'objet de sortie complet, y compris l'extension. Le nom de l'objet peut inclure des variables. Pour plus d'informations sur les variables, consultez la rubrique Variables.Le nom de fichier doit contenir au moins une variable. Sinon, plusieurs fichiers de sortie s'écraseront mutuellement.
Lorsque vous utilisez les variables {key}, {barename} ou {basename} dans le chemin de sortie, assurez-vous que le chemin de sortie est différent du chemin d'entrée. Sinon, les objets sources risquent d'être écrasés ou un traitement récursif peut se déclencher.
Un fichier généré par un déclencheur ne peut pas servir de fichier d'entrée.
Les déclencheurs prennent uniquement en charge les fichiers de classe de stockage Standard.
Créer un déclencheur
Connectez-vous à la console OSS.
Dans le volet de navigation de gauche, cliquez sur Buckets, puis sur le nom du compartiment de destination.
Dans le volet de navigation de gauche, sélectionnez Data Processing.
Sélectionnez document processing, ApsaraVideo Media Processing ou d'autres capacités de traitement des données (cet exemple utilise le traitement de documents).
Cliquez sur l'onglet Trigger, puis cliquez sur Create Trigger.
-
Dans le panneau Create Trigger, configurez les paramètres Input Configuration, Output Configuration, Permission Configuration et Notification Configuration.
Paramètre
Description
Input Bucket
Le compartiment contenant les fichiers à traiter.
Path Prefix
Le préfixe de chemin des fichiers à traiter.
Filter Rule
Filtre les fichiers à traiter en fonction du préfixe de chemin et de la règle de filtrage.
All : tous les fichiers du répertoire spécifié par le paramètre Path Prefix sont traités.
File Prefix : traite les données des fichiers dont les noms correspondent à un préfixe spécifique dans le répertoire spécifié par Path Prefix. Pour spécifier plusieurs préfixes, séparez-les par des virgules (,).
File Suffix : effectue le traitement des données sur les fichiers ayant un suffixe spécifique dans le répertoire spécifié par le préfixe de chemin. Pour spécifier plusieurs suffixes, séparez-les par une virgule (,).
Style
Le style à utiliser pour traiter les objets. Si aucun style n'est disponible, sélectionnez Add Style dans la liste déroulante pour créer un style.
Output Path
Le chemin de stockage des fichiers traités.
Le chemin ne peut pas se terminer par une barre oblique (/). Utilisez des variables dans le chemin de sortie. Sinon, les sorties de plusieurs tâches s'écraseront mutuellement. Pour plus d'informations, consultez la rubrique Variables.
Stop on Task Submission Failure
Indique si le processus doit s'interrompre immédiatement en cas d'échec de soumission d'une tâche.
Break : si une erreur se produit lors de la soumission d'une sous-tâche, le déclencheur échoue et s'arrête immédiatement.
Ignore : si la soumission d'une sous-tâche échoue, le déclencheur continue de s'exécuter.
Service Role
Le rôle qui accorde à IMM les autorisations nécessaires pour accéder à d'autres ressources cloud, telles qu'OSS. Nous vous recommandons d'utiliser le rôle de service
AliyunIMMBatchTriggerRole. Si le rôle de service n'existe pas, vous pouvez le créer sur la page Resource Access Management (RAM).Message Queue
Vous pouvez configurer une file d'attente de messages pour recevoir les résultats des tâches de traitement des données une fois celles-ci terminées. Lorsqu'une tâche est achevée, une notification contenant le résultat du traitement peut être envoyée à une file d'attente de messages légère. Pour plus d'informations, consultez la rubrique Quick Start.
Cliquez sur OK.
Interroger un déclencheur
Connectez-vous à la console OSS.
Dans le volet de navigation de gauche, cliquez sur Buckets, puis sur le nom du compartiment de destination.
Dans le volet de navigation de gauche, sélectionnez Data Processing, puis choisissez le type de traitement requis, tel que Document Processing ou ApsaraVideo Media Processing.
-
Cliquez sur l'onglet Trigger pour afficher la liste des déclencheurs.
Le tableau suivant décrit les états des déclencheurs.
État
Description
Ready
Une tâche nouvellement créée possède cet état.
Running
La tâche s'exécute normalement.
Success
La tâche a été exécutée avec succès.
Paused
La tâche est en pause. Aucune nouvelle tâche n'est déclenchée. Les tâches déjà démarrées continueront de s'exécuter jusqu'à leur achèvement.
Failed
La tâche a échoué. Une erreur s'est produite lors de l'exécution et la tâche ne peut pas récupérer automatiquement.
Dans la zone de recherche Trigger ID, saisissez un ID de déclencheur et cliquez sur l'icône de recherche.
Pour afficher les détails d'un déclencheur, cliquez sur View Details dans la colonne Actions.
Cliquez sur l'icône d'expansion à côté d'un ID de déclencheur pour afficher toutes les tâches associées à ce déclencheur. Vous pouvez rechercher des tâches par chemin de fichier ou par état.