Cibles du bus d'événements sur Amazon EventBridge

Une cible est une ressource ou un point de terminaison qui EventBridge envoie un événement lorsque celui-ci correspond au modèle d'événement défini pour une règle. La règle traite les données de l’événement et envoie les informations pertinentes à la cible. Pour fournir des données d'événements à une cible, vous devez EventBridge disposer d'une autorisation pour accéder à la ressource cible. Vous pouvez définir jusqu’à cinq cibles pour chaque règle.

Lorsque vous ajoutez des cibles à une règle et que cette règle s’exécute peu de temps après, il se peut que les cibles nouvelles ou mises à jour ne soient pas invoquées immédiatement. Les modifications ne prennent pas effet instantanément.

La vidéo suivante explique les principes de base des cibles :

Cibles du bus d'événements disponibles dans la EventBridge console

Vous pouvez configurer les types de cibles suivants pour les règles dans la EventBridge console :

Paramètres de cible

Certaines cibles n'envoient pas les informations contenues dans la charge utile de l'événement à la cible, mais traitent l'événement comme un déclencheur pour appeler une API spécifique. EventBridge utilise les paramètres de la cible pour déterminer ce qui se passe avec cette cible. Tel est le cas des éléments suivants :

Paramètres de chemin dynamiques

Certains paramètres de cible prennent en charge la syntaxe de chemin JSON dynamique facultative. Cette syntaxe vous permet de spécifier des chemins JSON au lieu de valeurs statiques (par exemple, $.detail.state). La valeur entière doit être un chemin JSON, pas seulement une partie de celui-ci. Par exemple, RedshiftParameters.Sql peut avoir la valeur $.detail.state, mais pas la valeur "SELECT * FROM $.detail.state". Ces chemins sont remplacés de manière dynamique lors de l’exécution par des données provenant de la charge utile de l’événement elle-même au niveau du chemin spécifié. Les paramètres de chemin dynamiques ne peuvent pas faire référence à des valeurs nouvelles ou transformées résultant d’une transformation d’entrée. La syntaxe prise en charge pour les chemins JSON de paramètres dynamiques est la même que lors de la transformation d’une entrée. Pour plus d’informations, consultez Transformation des EventBridge entrées Amazon.

La syntaxe dynamique peut être utilisée sur tous les champs de type chaîne non enum de ces paramètres :

Autorisations

Pour effectuer des appels d'API sur les ressources que vous possédez, vous devez EventBridge disposer des autorisations appropriées. Pour AWS Lambda et les ressources Amazon SNS, EventBridge utilise des politiques basées sur les ressources. Par exemple EC2 , les flux de données Kinesis et les machines d'état Step Functions EventBridge utilisent les rôles IAM que vous spécifiez dans le RoleARN paramètre dans. PutTargets Vous pouvez invoquer un point de terminaison API Gateway avec une autorisation IAM configurée, mais le rôle est facultatif si vous n’avez pas configuré d’autorisation. Pour de plus amples informations, veuillez consulter Amazon EventBridge et AWS Identity and Access Management.

Si un autre compte se trouve dans la même région et vous a accordé l’autorisation, vous pouvez envoyer des événements à ce compte. Pour de plus amples informations, veuillez consulter Envoi et réception d'événements entre AWS comptes sur Amazon EventBridge.

Si votre cible est chiffrée, vous devez inclure la section suivante dans votre stratégie de clé KMS.

{
    "Sid": "Allow EventBridge to use the key",
    "Effect": "Allow",
    "Principal": {
        "Service": "events.amazonaws.com"
    },
    "Action": [
        "kms:Decrypt",
        "kms:GenerateDataKey"
    ],
    "Resource": "*"
}

AWS Batch files d'attente de tâches en tant que cibles

Certains paramètres AWS Batch submitJob peuvent être configurés via BatchParameters.

Les autres paramètres peuvent être spécifiées dans la charge utile de l’événement. Si la charge utile de l'événement (transmise par ou via InputTransformers) contient les clés suivantes, elles sont mappées aux paramètres de submitJob demande :

CloudWatch Enregistre les groupes en tant que cibles

Si vous n'utilisez pas un InputTransformeravec une cible CloudWatch Logs, la charge utile de l'événement est utilisée comme message de journal et la source de l'événement comme horodatage. Si vous utilisez un InputTransformer, le modèle doit être :

{"timestamp":<timestamp>,"message":<message>}

EventBridge regroupe les entrées envoyées à un flux de journal ; par conséquent, il EventBridge peut transmettre un ou plusieurs événements à un flux de journal, en fonction du trafic.

CodeBuild projets comme cibles

Si vous façonnez l'événement d'entrée en une cible pour qu'elle corresponde à la CodeBuild StartBuildRequeststructure, les paramètres seront mappés 1 à 1 et transmis à. InputTransformerscodeBuild.StartBuild

Tâches Amazon ECS en tant que cibles

Si vous façonnez l'événement d'entrée sur une cible afin qu'elle corresponde à la RunTask TaskOverridestructure Amazon ECS, les paramètres seront mappés 1 à 1 et transmis à. InputTransformersecs.RunTask

Plans de réponse du gestionnaire d'incidents en tant que cibles

Si l'événement correspondant provient d' CloudWatch alarmes, les détails du changement d'état de l'alarme sont renseignés dans les détails du déclencheur de l' StartIncidentRequest appel à Incident Manager.