Configuration des EventBridge règles

Pour configurer EventBridge les règles Amazon : créez une règle qui lie l'événement d'AWSElemental MediaConvert au service cible qui répond au changement de statut de votre travail, tel qu'Amazon Simple Notification Service (AmazonSNS) ou AWS Lambda.

Pour un didacticiel sur la configuration d'une EventBridge règle avec AWS Elemental MediaConvert, voirTutoriel : Configuration des notifications par e-mail en cas d'échec des tâches.

Pour obtenir la liste des événements MediaConvert envoyés dans le flux EventBridge d'événements, consultezListe des MediaConvert EventBridge événements.

Pour plus d'informations générales sur l'utilisation EventBridge, consultez le guide de EventBridge l'utilisateur Amazon.

Pour obtenir des informations de dépannage, consultez la section Résolution des problèmes liés EventBridge à Amazon dans le guide de EventBridge l'utilisateur Amazon.

Tutoriel : Configuration des notifications par e-mail en cas d'échec des tâches

Dans ce didacticiel, vous allez configurer une règle d' EventBridge événement qui capture les événements lorsque le statut d'une tâche passe à, ERROR puis vous en informe. Pour ce faire, vous devez d'abord créer un sujet sur Amazon SNS qui vous enverra une notification par e-mail concernant l'échec de la tâche. Ensuite, vous créez une règle en EventBridge définissant une source d'événement et en faisant référence au SNS sujet Amazon (la « cible »).

Étape 1 : créer un sujet sur Amazon SNS

La première étape de la configuration d'une EventBridge règle consiste à préparer la cible de la règle. Dans ce cas, cela signifie créer un SNS sujet Amazon et s'y abonner.

Pour créer un SNS sujet Amazon

1. Ouvrez la SNS console Amazon sur https://console.aws.amazon.com/sns/v3/home.

2. Dans le panneau de navigation, choisissez Rubriques, puis Créer une rubrique.

3. Pour Type, choisissez Standard.

4. Dans Nom, entrezMediaConvertJobErrorAlert, puis choisissez Créer un sujet.

5. Choisissez le nom du sujet que vous venez de créer pour afficher les détails du sujet.

6. Sur la page Détails du MediaConvertJobErrorAlertsujet, dans la section Abonnements, choisissez Créer un abonnement.

7. Pour Protocole, choisissez E-mail. Pour Endpoint, entrez l'adresse e-mail SNS à laquelle vous souhaitez qu'Amazon envoie la notification.

8. Choisissez Create subscription (Créer un abonnement).

9. Vous recevrez un e-mail de notification d'AmazonSNS. Lorsque vous le recevrez, choisissez le lien Confirm subscription (Confirmer l'abonnement) dans le corps de l'e-mail.

Étape 2 : Spécifier un modèle d'événement dans une EventBridge règle

Cette étape montre comment définir votre modèle d'événement dans une EventBridge règle. Cette règle capturera les événements envoyés MediaConvert lorsque le statut d'une tâche passe àERROR.

Pour configurer un modèle d'événement dans une EventBridge règle

1. Ouvrez la EventBridge console Amazon à l'adresse https://console.aws.amazon.com/events/.

2. Dans le volet de navigation, choisissez Règles. Conservez le bus d'événements par défaut, puis choisissez Create rule.

3. Dans Nom, entrezMediaConvertJobStateError, puis choisissez Next.

4. Dans la section Modèle d'événement, en commençant par Source d'événement, choisissez les paramètres suivants :

   • Source de l'événement : AWS services

   • AWS service : MediaConvert

   • Type d'événement : MediaConvert Job State Change

   • Type d'événement, État (s) spécifique (s) : ERROR

5. Une boîte de modèle d'événement ressemblera à l'exemple suivant.

   {
     "source": ["aws.mediaconvert"],
     "detail-type": ["MediaConvert Job State Change"],
     "detail": {
       "status": ["ERROR"]
     }
   }                 

   Ce code définit une règle d' EventBridge événement qui correspond à tout événement dont le statut de la tâche passe àERROR. Pour plus d'informations sur les modèles d'événements, consultez la section Événements et modèles d'événements dans le guide de CloudWatch l'utilisateur Amazon.

6. Choisissez Suivant.

Étape 3 : ajoutez le SNS sujet Amazon et terminez votre règle

Ajoutez le SNS sujet Amazon que vous avez créé à l'étape 1 à la EventBridge règle que vous avez créée à l'étape 2.

Pour ajouter le SNS sujet Amazon et terminer la EventBridge règle

1. Dans la section Sélectionner une ou plusieurs cibles, sous Sélectionner une cible, choisissez un SNSsujet.

2. Dans le champ Sujet, sélectionnez MediaConvertJobErrorAlert.

3. Choisissez Suivant.

4. Ajoutez éventuellement des balises. Ensuite, sélectionnez Suivant.

5. Vérifiez vos paramètres. Puis, choisissez Create rule (Créer une règle).

Étape 4 : Test de la règle

Pour tester votre règle, soumettez une tâche qui entraînera une erreur. Par exemple, spécifiez un emplacement d'entrée qui n'existe pas. Si vous avez configuré votre règle d'événement correctement, vous devriez recevoir un e-mail avec le message du texte de l'événement en quelques minutes.

Pour tester la règle

1. Ouvrez la AWS Elemental MediaConvert console à l'adresse https://console.aws.amazon.com/mediaconvert.

2. Soumettez une nouvelle MediaConvert offre d'emploi. Pour de plus amples informations, veuillez consulter Tutoriel : Configuration des paramètres des tâches.

3. Vérifiez le compte e-mail que vous avez indiqué lors de la configuration de votre SNS rubrique Amazon. Confirmez que vous avez reçu une notification par e-mail concernant l'erreur de tâche.