EventBridge Objectifs Amazon - Amazon EventBridge
Cibles disponibles dans la EventBridge consoleParamètres de cibleAutorisationsEventBridge spécificités de la cible

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.

EventBridge Objectifs Amazon

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 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, 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 :

  • Destinations d’API (Les données envoyées à une destination d’API doivent correspondre à la structure de l’API. Vous devez utiliser l’objet InputTransformer pour vous assurer que les données sont correctement structurées. Si vous souhaitez inclure la charge utile de l’événement d’origine, référencez-la dans InputTransformer.)

  • API Gateway (Les données envoyées à API Gateway doivent correspondre à la structure de l’API. Vous devez utiliser l’objet InputTransformer pour vous assurer que les données sont correctement structurées. Si vous souhaitez inclure la charge utile de l’événement d’origine, référencez-la dans InputTransformer.)

  • Amazon EC2 Image Builder

  • RedshiftDataParameters (clusters d’API de données Amazon Redshift)

  • SageMakerPipelineParameters(Pipelines de création de modèles Amazon SageMaker Runtime)

Note

EventBridge ne prend pas en charge toutes les syntaxes JSON Path et ne l'évalue pas lors de l'exécution. La syntaxe prise en charge inclut :

  • notation par points (par exemple, $.detail)

  • tirets

  • traits de soulignement

  • caractères alphanumériques

  • index de tableau

  • caractères génériques (*)

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. Pour les instances EC2, les flux de données Kinesis et les machines EventBridge d'état Step Functions utilisent les rôles IAM que vous spécifiez dans le paramètre dansRoleARN. 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 plus d’informations, consultez 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 plus d’informations, consultez Envoyer et recevoir des EventBridge événements Amazon entre AWS comptes.

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": "*"
}

EventBridge spécificités de la cible

AWS Batch files d'attente pour les emplois

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 :

  • ContainerOverrides: containerOverrides

    Note

    Inclut uniquement command, environment, memory et vcpus

  • DependsOn: dependsOn

    Note

    Inclut uniquement jobId

  • Parameters: parameters

CloudWatch Groupe de journaux

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 projet

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

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

Plan de réponse Incident Manager

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.