Tutoriel : Création d'une EventBridge règle qui réagit aux AWS API appels via CloudTrail - Amazon EventBridge
Étape 1 : Création d'un AWS CloudTrail parcoursÉtape 2 : Créer une fonction AWS LambdaÉtape 3 : Créer une règleÉtape 4 : Tester la règleÉtape 5 : Confirmer la bonne exécutionÉtape 6 : Nettoyer vos ressources

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Tutoriel : Création d'une EventBridge règle qui réagit aux AWS API appels via CloudTrail

Vous pouvez utiliser EventBridge les règles d'Amazon pour réagir aux API appels passés par un AWS service qui sont enregistrés par AWS CloudTrail.

Dans ce didacticiel, vous allez créer une AWS CloudTrailpiste, une fonction Lambda et une règle dans la EventBridge console. La règle invoque la fonction Lambda lorsqu'une instance EC2 Amazon est arrêtée.

Étape 1 : Création d'un AWS CloudTrail parcours

Si vous disposez déjà d’un journal de suivi configuré, passez directement à l’étape 2.

Pour créer un journal de suivi

  1. Ouvrez la CloudTrail console à l'adresse https://console.aws.amazon.com/cloudtrail/.

  2. Choisissez Trails (Suivis), Create trail (Créer un suivi).

  3. Dans Trail name, tapez un nom pour le journal.

  4. Pour Emplacement de stockage, choisissez Créer un compartiment S3.

  5. Dans le AWS KMS champ alias, tapez un alias pour la KMS clé.

  6. Choisissez Suivant.

  7. Choisissez Suivant.

  8. Choisissez Create trail (Créer un journal de suivi).

Étape 2 : Créer une fonction AWS Lambda

Créez une fonction Lambda pour enregistrer les événements d'APIappel.

Pour créer une fonction Lambda

  1. Ouvrez la AWS Lambda console à l'adresse https://console.aws.amazon.com/lambda/.

  2. Choisissez Créer une fonction.

  3. Choisissez Créer à partir de zéro.

  4. Saisissez un nom et une description pour la fonction Lambda. Par exemple, nommez la fonction LogEC2StopInstance.

  5. Gardez les autres options comme valeurs par défaut et choisissez Créer une fonction.

  6. Dans l’onglet Code de la page de fonction, double-cliquez sur index.js.

  7. Remplacez le code existant par le code suivant.

    'use strict';

exports.handler = (event, context, callback) => {
    console.log('LogEC2StopInstance');
    console.log('Received event:', JSON.stringify(event, null, 2));
    callback(null, 'Finished');
};

  8. Choisissez Deploy (Déployer).

Étape 3 : Créer une règle

Créez une règle pour exécuter la fonction Lambda que vous avez créée à l'étape 2 chaque fois que vous arrêtez une instance AmazonEC2.

Pour créer une 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.

  3. Choisissez Créer une règle.

  4. Saisissez un nom et une description pour la règle. Par exemple, nommez la règle TestRule

  5. Pour Event bus (Bus d'événement), sélectionnez le bus d'événement que vous souhaitez associer à cette règle. Si vous souhaitez que cette règle mette en correspondance les événements en provenance de votre compte, sélectionnez Par défaut. Lorsqu'un service AWS de votre compte émet un événement, il accède toujours au bus d'événement par défaut de votre compte.

  6. Pour Type de règle, choisissez Règle avec un modèle d’événement.

  7. Choisissez Suivant.

  8. Pour Source d'événement, choisissez Services AWS .

  9. Pour Event pattern (Modèle d’événement), procédez comme suit :

    1. Pour Source de l'événement, EC2sélectionnez dans la liste déroulante.

    2. Pour le type d'événement, sélectionnez AWS APIAppeler via CloudTrail dans la liste déroulante.

    3. Choisissez Opération(s) spécifique(s) et entrez StopInstances.

  10. Choisissez Suivant.

  11. Pour Types de cibles, choisissez service AWS .

  12. Pour Sélectionner une cible, choisissez Fonction Lambda dans la liste déroulante.

  13. Pour Fonction, sélectionnez la fonction Lambda que vous avez créée dans la section Étape 1 : Créer une fonction Lambda. Dans cet exemple, sélectionnez LogEC2StopInstance.

  14. Choisissez Suivant.

  15. Choisissez Suivant.

  16. Consultez les détails de la règle et choisissez Create rule (Créer une règle).

Étape 4 : Tester la règle

Vous pouvez tester votre règle en arrêtant une EC2 instance Amazon à l'aide de la EC2 console Amazon. Attendez quelques minutes que l'instance s'arrête, puis vérifiez vos AWS Lambda métriques sur la CloudWatch console pour vérifier que votre fonction s'est exécutée.

Pour tester votre règle en arrêtant une instance

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

  2. Lancez une instance. Pour plus d'informations, consultez Launch Your Instance dans le guide de EC2 l'utilisateur Amazon.

  3. Arrêtez l’instance. Pour plus d'informations, consultez la section Stop and Start Your Instance dans le guide de EC2 l'utilisateur Amazon.

  4. Pour afficher la sortie de la fonction Lambda, procédez de la manière suivante :

    1. Ouvrez la CloudWatch console à l'adresse https://console.aws.amazon.com/cloudwatch/.

    2. Dans le panneau de navigation, sélectionnez Logs (Journaux).

    3. Sélectionnez le nom du groupe de journaux pour votre fonction Lambda (/aws/lambda/function-name).

    4. Sélectionnez le nom du flux de journaux pour afficher les données fournies par la fonction concernant l'instance que vous avez arrêtée.

  5. (Facultatif) Lorsque vous avez terminé, mettez fin à l'instance arrêtée. Pour plus d'informations, consultez la section Résiliation de votre instance dans le guide de EC2 l'utilisateur Amazon.

Étape 5 : Confirmer la bonne exécution

Si vous voyez l'événement Lambda dans les CloudWatch journaux, cela signifie que vous avez terminé ce didacticiel avec succès. Si l'événement ne figure pas dans vos CloudWatch journaux, commencez le dépannage en vérifiant que la règle a été créée avec succès et, si la règle semble correcte, vérifiez que le code de votre fonction Lambda est correct.

Étape 6 : Nettoyer vos ressources

Vous pouvez maintenant supprimer les ressources que vous avez créées pour ce didacticiel, sauf si vous souhaitez les conserver. En supprimant AWS les ressources que vous n'utilisez plus, vous évitez des frais inutiles sur votre AWS compte.

Pour supprimer la ou les EventBridge règles

  1. Ouvrez la page Règles de la EventBridge console.

  2. Sélectionnez la ou les règles que vous avez créées.

  3. Sélectionnez Delete.

  4. Sélectionnez Delete.

Pour supprimer la ou les fonctions Lambda

  1. Ouvrez la page Functions (Fonctions) de la console Lambda.

  2. Sélectionnez la ou les fonctions que vous avez créées.

  3. Sélectionnez Actions, Supprimer.

  4. Sélectionnez Supprimer.

Pour supprimer le ou les CloudTrail parcours

  1. Ouvrez la page Trails de la CloudTrail console.

  2. Sélectionnez le ou les journaux de suivi que vous avez créés.

  3. Sélectionnez Delete.

  4. Sélectionnez Supprimer.