Cibles du bus d'événements sur Amazon EventBridge - Amazon EventBridge
Cibles disponiblesParamètres de cibleAutorisationsAWS Batch files d'attente pour les emploisCloudWatch Groupes de journauxCodeBuild projetsECSTâches AmazonPlans de réponse du gestionnaire d'incidents

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.

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, mais considèrent 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 :

  • APIdestinations (Les données envoyées à une API destination doivent correspondre à la structure duAPI. Vous devez utiliser l'InputTransformerobjet 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 le InputTransformer.)

  • APIPasserelle (Les données envoyées à API Gateway doivent correspondre à la structure duAPI. Vous devez utiliser l'InputTransformerobjet 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 le InputTransformer.)

  • Amazon EC2 Image Builder

  • RedshiftDataParameters(clusters de données API 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 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 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 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 :

  • ContainerOverrides: containerOverrides

    Note

    Inclut uniquement command, environment, memory et vcpus

  • DependsOn: dependsOn

    Note

    Cela inclut uniquement jobId

  • Parameters: parameters

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, 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 en tant que 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.