Utilisation AWS Lambda avec Amazon EventBridge (CloudWatch événements)

Note

Amazon EventBridge est le moyen préféré pour gérer vos événements. CloudWatchLes événements et la même API EventBridge constituent le même service sous-jacent et la même API, mais EventBridge offrent davantage de fonctionnalités. Les modifications que vous apportez dans l'un ou l'autre des CloudWatch événements EventBridge apparaîtront dans chaque console. Pour plus d'informations, consultez la EventBridge documentation Amazon.

EventBridge (CloudWatch Événements) vous aide à réagir aux changements d'état de vos AWS ressources. Pour plus d'informations EventBridge, consultez Qu'est-ce qu'Amazon EventBridge ? dans le guide de EventBridge l'utilisateur Amazon.

Lorsque l'état de vos ressources change, des événements sont automatiquement envoyés à un flux d'événements. Avec EventBridge (CloudWatch Events), vous pouvez créer des règles correspondant à des événements sélectionnés dans le flux et les acheminer vers votre AWS Lambda fonction pour qu'elle prenne des mesures. Par exemple, vous pouvez appeler automatiquement une AWS Lambda fonction pour enregistrer l'état d'une instance ou d'un AutoScaling groupe EC2.

EventBridge (CloudWatch Events) invoque votre fonction de manière asynchrone avec un document d'événement qui inclut l'événement depuis sa source. L'exemple suivant montre un événement issu d'un instantané de base de données dans Amazon Relational Database Service.

Exemple EventBridge CloudWatch événement (Événements)

{
    "version": "0",
    "id": "fe8d3c65-xmpl-c5c3-2c87-81584709a377",
    "detail-type": "RDS DB Instance Event",
    "source": "aws.rds",
    "account": "123456789012",
    "time": "2020-04-28T07:20:20Z",
    "region": "us-east-2",
    "resources": [
        "arn:aws:rds:us-east-2:123456789012:db:rdz6xmpliljlb1"
    ],
    "detail": {
        "EventCategories": [
            "backup"
        ],
        "SourceType": "DB_INSTANCE",
        "SourceArn": "arn:aws:rds:us-east-2:123456789012:db:rdz6xmpliljlb1",
        "Date": "2020-04-28T07:20:20.112Z",
        "Message": "Finished DB Instance backup",
        "SourceIdentifier": "rdz6xmpliljlb1"
    }
}

Vous pouvez également créer une fonction Lambda et demander à AWS Lambda de l'appeler régulièrement. Vous pouvez spécifier une fréquence fixe (par exemple, appeler une fonction Lambda toutes les heures ou toutes les 15 minutes) ou une expression Cron.

Exemple EventBridge Événement de message (CloudWatch Événements)

{
  "version": "0",
  "account": "123456789012",
  "region": "us-east-2",
  "detail": {},
  "detail-type": "Scheduled Event",
  "source": "aws.events",
  "time": "2019-03-01T01:23:45Z",
  "id": "cdc73f9d-aea9-11e3-9d5a-835b769c0d9c",
  "resources": [
    "arn:aws:events:us-east-2:123456789012:rule/my-schedule"
  ]
}

Pour configurer EventBridge (CloudWatch Events) pour appeler votre fonction

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

2. Choisir une fonction

3. Sous Function overview (Vue d'ensemble de la fonction), choisissez Add trigger (Ajouter un déclencheur).

4. Définissez le type de déclencheur sur EventBridge (CloudWatch Événements).

5. Pour Rule (Règle), choisissez Create a new rule (Créer une règle).

6. Configurez les options restantes et choisissez Ajouter.

Pour en savoir plus sur la planification des expressions, consultez Expressions de planification à l'aide de rate ou de cron.

Chaque AWS compte peut avoir jusqu'à 100 sources d'événements uniques du type de source EventBridge (CloudWatch Événements) - Planifier. Chacune d'elles peut être la source d'événement de jusqu'à cinq fonctions Lambda. Autrement dit, vous pouvez exécuter jusqu'à 500 fonctions Lambda de manière planifiée dans votre compte AWS.

Rubriques

• Didacticiel : utilisation de AWS Lambda avec des événements planifiés
• Expressions de planification à l'aide de rate ou de cron