Objetivos de autobuses para eventos en Amazon EventBridge

Un objetivo es un recurso o punto final que EventBridge envía un evento cuando el evento coincide con el patrón de eventos definido para una regla. La regla procesa los datos del evento y envía la información pertinente al destino. Para entregar datos de eventos a un destino, EventBridge necesita permiso para acceder al recurso de destino. Puede definir hasta cinco destinos para cada regla.

Cuando se agregan destinos a una regla y esa regla se ejecuta poco después, es posible que los destinos actualizados no se invoquen inmediatamente. Espere un breve periodo para que los cambios surtan efecto.

En el siguiente vídeo se describen los aspectos básicos de los destinos:

Los objetivos del bus de eventos están disponibles en la EventBridge consola

Puede configurar los siguientes tipos de objetivos para las reglas de la EventBridge consola:

Parámetros de destino

Algunos destinos no envían la información de la carga útil del evento al objetivo, sino que tratan el evento como un desencadenante para invocar una API específica. EventBridge usa los parámetros de Target para determinar qué ocurre con ese objetivo. Estos incluyen los siguientes:

Parámetros de ruta dinámicos

Algunos parámetros de destino admiten sintaxis de ruta JSON dinámica opcional. Esta sintaxis le permite especificar rutas JSON en lugar de valores estáticos (por ejemplo$.detail.state). El valor completo debe ser una ruta JSON, no solo una parte de ella. Por ejemplo, RedshiftParameters.Sql puede ser $.detail.state, pero no puede ser "SELECT * FROM $.detail.state". Estas rutas se sustituyen dinámicamente en tiempo de ejecución por datos de la propia carga del evento en la ruta especificada. Los parámetros de ruta dinámicos no pueden hacer referencia a valores nuevos o transformados que resulten de la transformación de entrada. La sintaxis admitida para las rutas JSON con parámetros dinámicos es la misma que cuando se transforma la entrada. Para obtener más información, consulte Transformación EventBridge de entradas de Amazon

La sintaxis dinámica se puede utilizar en todos los campos non-enum de cadena de estos parámetros:

Permisos

Para realizar llamadas a la API en los recursos de su propiedad, EventBridge necesita el permiso adecuado. Para AWS Lambda los recursos de Amazon SNS, EventBridge utiliza políticas basadas en recursos. EC2 En algunos casos, las transmisiones de datos de Kinesis y las máquinas de estado de Step Functions EventBridge utilizan las funciones de IAM que se especifican en el RoleARN parámetro en. PutTargets Puede invocar un punto de conexión de API Gateway con la autorización de la IAM configurada, pero la función es opcional si no ha configurado la autorización. Para obtener más información, consulte Amazon EventBridge y AWS Identity and Access Management.

Si otra cuenta se encuentra en la misma región y le dio permiso, puede enviar eventos a esa cuenta. Para obtener más información, consulte Envío y recepción de eventos entre AWS cuentas de Amazon EventBridge.

Si el destino está cifrado, debe incluir la siguiente sección en la política de claves de KMS.

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

AWS Batch colas de trabajos como objetivos

Algunos parámetros se AWS Batch submitJob pueden configurar mediante BatchParameters.

Otros se pueden especificar la carga del evento. Si la carga útil del evento (pasada o vía InputTransformers) contiene las siguientes claves, se asignan a los parámetros de la submitJob solicitud:

CloudWatch Registra los grupos como objetivos

Si no utilizas uno InputTransformercon un objetivo de CloudWatch Logs, la carga útil del evento se utiliza como mensaje de registro y el origen del evento como marca de tiempo. Si utilizas una InputTransformer, la plantilla debe ser:

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

EventBridge agrupa las entradas enviadas a un flujo de registro; por lo tanto, EventBridge puede entregar uno o varios eventos a un flujo de registro, según el tráfico.

CodeBuild proyectos como objetivos

Si se utiliza InputTransformerspara dar forma al evento de entrada a un objetivo para que coincida con la CodeBuild StartBuildRequestestructura, los parámetros se asignarán uno a uno y se transferirán a. codeBuild.StartBuild

Tareas de Amazon ECS como destinos

Si suele dar forma InputTransformersal evento de entrada a un Target para que coincida con la RunTask TaskOverrideestructura de Amazon ECS, los parámetros se asignarán 1 a 1 y se transferirán a. ecs.RunTask

Planes de respuesta de Incident Manager como destinos

Si el evento coincidente proviene de CloudWatch Alarms, los detalles del cambio de estado de la alarma se incluyen en los detalles del activador de la StartIncidentRequest llamada a Incident Manager.