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 cibles suivantes pour les événements 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. Elles considèrent plutôt l'événement comme un déclencheur pour invoquer un événement spécifique. API 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 cibles prennent en charge la syntaxe de JSON chemin dynamique facultative. Cette syntaxe vous permet de spécifier JSON des chemins plutôt que des valeurs statiques (par exemple$.detail.state). La valeur entière doit être un JSON chemin, 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 JSON chemins de paramètres dynamiques est la même que lors de la transformation des entrées. 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 API passer des appels sur les ressources que vous possédez, vous devez disposer EventBridge d'une autorisation appropriée. For AWS Lambda et Amazon SNS Resources EventBridge utilisent des politiques basées sur les ressources. Par EC2 exemple, les flux de données Kinesis et les machines d'état Step Functions EventBridge utilisent des IAM rôles que vous spécifiez dans le RoleARN paramètre dans. PutTargets Vous pouvez appeler un point de terminaison API Gateway avec une IAM autorisation 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 cryptée, vous devez inclure la section suivante dans votre politique de KMS clés.

{
    "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 comme 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 en tant que 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

Les ECS tâches Amazon comme cibles

Si vous façonnez l'événement d'entrée en fonction d'une cible afin qu'elle corresponde à la ECS RunTask TaskOverridestructure Amazon, les paramètres seront mappés de 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.