Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Objetivos de autobuses para eventos en Amazon EventBridge
Un *objetivo* es un recurso o punto final que EventBridge envía un [evento](eb-events.md) cuando el evento coincide con el patrón de eventos definido para una [regla](eb-rules.md). **La regla procesa los datos del [evento](eb-events.md) 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.
## 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:
+ Destinos de la API
Los destinos de la API son puntos de conexión HTTPS que puede invocar como destino de una regla de bus de eventos. Cuando especificas un destino de API como destino de la regla, EventBridge invoca el punto final HTTPS para cualquier evento que coincida con el patrón de eventos especificado en la regla y, a continuación, entrega la información del evento con la solicitud. Para obtener más información, consulte [Destinos de la API](eb-api-destinations.md).
+ Buses de eventos
Puede especificar otros buses de eventos como destinos de las reglas. Esto incluye los buses de eventos de la misma cuenta o de AWS cuentas diferentes.
+ [Buses de eventos entre cuentas múltiples como destinos](eb-cross-account.md)
+ [Buses de eventos de la misma cuenta como destinos](eb-bus-to-bus.md)
+ AWS servicios
Puede EventBridge enviar eventos a varios recursos de AWS servicio. Entre ellos se incluyen:
+ [API Gateway](eb-api-gateway-target.md)
+ [AWS AppSync](target-appsync.md)
+ [Cola de trabajos por lotes](#targets-specifics-batch)
+ [CloudWatch grupo de registros](#targets-specifics-cwl)
+ [CodeBuild project](#targets-specifics-codebuild)
+ CodePipeline
+ Llamada a la API `CreateSnapshot` de Amazon EBS
+ Generador de Imágenes de EC2
+ Llamada a la API `RebootInstances` de EC2
+ Llamada a la API `StopInstances` de EC2
+ Llamada a la API `TerminateInstances` de EC2
+ [Tarea de ECS](#targets-specifics-ecs-task)
+ Flujo de entrega de Firehose
+ Flujo de trabajo de Glue
+ [Plan de respuesta del Administrador de incidentes](https://docs.aws.amazon.com//incident-manager/latest/userguide/incident-creation.html#incident-tracking-auto-eventbridge)
+ Plantilla de evaluación del inspector
+ Flujo de Kinesis
+ Función de Lambda (ASYNC)
+ [Consultas de API de datos de clústeres de Amazon Redshift](https://docs.aws.amazon.com/redshift/latest/mgmt/data-api-calling-event-bridge.html)
+ [Consultas de API de datos de grupos de trabajo de Amazon Redshift sin servidor](https://docs.aws.amazon.com/redshift/latest/mgmt/data-api-calling-event-bridge.html)
+ SageMaker AI Pipeline
+ Tema de Amazon SNS
+ [Colas estándar, justas y FIFO de Amazon SQS](#targets-specifics-sqs)
+ Máquina de estado de Step Functions (ASYNC)
+ Automatización de Systems Manager
+ Systems Manager OpsItem
+ Systems Manager Run Command
## 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](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_Target.html) para determinar qué ocurre con ese objetivo. Estos incluyen los siguientes:
+ Destinos de la API
Los datos enviados a un destino de la API deben coincidir con la estructura de la API. Use el objeto [https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_InputTransformer.html](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_InputTransformer.html) para asegurarse de que los datos estén estructurados correctamente. Si desea incluir la carga útil del evento original, haga referencia a ella en [https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_InputTransformer.html](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_InputTransformer.html).
+ API Gateway
Los datos enviados a una puerta de enlace de la API deben coincidir con la estructura de la API. Use el objeto [https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_InputTransformer.html](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_InputTransformer.html) para asegurarse de que los datos estén estructurados correctamente. Si desea incluir la carga útil del evento original, haga referencia a ella en [https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_InputTransformer.html](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_InputTransformer.html).
+ Amazon EC2 Image Builder
+ Clústeres de la API de datos de Amazon Redshift
Utilice [https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_RedshiftDataParameters.html](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_RedshiftDataParameters.html).
+ Canalizaciones de creación SageMaker de modelos Amazon Runtime
Utilice [https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_SageMakerPipelineParameters.html](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_SageMakerPipelineParameters.html).
+ Feria Amazon SQS y colas FIFO
Utilice [https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_SqsParameters.html](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_SqsParameters.html) para especificar el grupo de mensajes que se usará como destino.
+ Systems Manager Run Command
Se utiliza [https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_RunCommandParameters.html](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_RunCommandParameters.html)para especificar el documento SSM y las instancias de destino. Para obtener más información, consulte [Systems Manager Run Command as a target](#targets-specifics-ssm-run-command).
**nota**
EventBridge no admite toda la sintaxis de rutas JSON y la evalúa en tiempo de ejecución. La sintaxis admitida incluye:
notación de puntos (por ejemplo, `$.detail`)
guiones
guiones bajos
Caracteres alfanuméricos
índices de matrices
caracteres comodín (\*)
barras diagonales
### Parámetros de ruta dinámicos
Los parámetros de ruta dinámica permiten utilizar la sintaxis de ruta JSON para hacer referencia a los datos de eventos en tiempo de ejecución en lugar de a valores estáticos.
Puedes usar la sintaxis de ruta JSON dinámica con los parámetros de destino para especificar rutas JSON en lugar de valores estáticos (por ejemplo,`$.detail.state`).
#### Requisitos
El valor completo debe ser una ruta JSON, no solo una parte de ella. Por ejemplo:
+ ✓ Correcto: `RedshiftParameters.Sql` puede ser `$.detail.state`
+ ✗ Incorrecto: `RedshiftParameters.Sql` no puede ser `"SELECT * FROM $.detail.state"`
EventBridge reemplaza estas rutas en tiempo de ejecución con datos de la carga útil del evento en la ruta especificada.
#### Limitaciones
Los parámetros de ruta dinámica no pueden hacer referencia a valores nuevos o transformados de la transformación de entrada. La sintaxis de la ruta de JSON es la misma que la de la transformación de entrada. Para obtener más información, consulta [Transformación EventBridge de entradas de Amazon](eb-transform-target-input.md).
#### Parámetros admitidos
Puede utilizar la sintaxis dinámica en todos los campos de cadena, que no sean de enumeración, de los siguientes parámetros:
+ [https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_EcsParameters.html](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_EcsParameters.html)
+ [https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_HttpParameters.html](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_HttpParameters.html) (excepto claves `HeaderParameters`)
+ [https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_RedshiftDataParameters.html](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_RedshiftDataParameters.html)
+ [https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_SageMakerPipelineParameters.html](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_SageMakerPipelineParameters.html)
+ [https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_SqsParameters.html](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_SqsParameters.html)
## Permisos
Para realizar llamadas a la API en los recursos que posee, EventBridge necesita los permisos adecuados. Especifique una función de ejecución de IAM [mediante la EventBridge consola](eb-create-rule-wizard.md#eb-create-rule-target) o configurando el `RoleARN` [https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_PutTargets.html](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_PutTargets.html)parámetro.
Por ejemplo, la siguiente política define el permiso para enviar mensajes a una cola de Amazon SQS:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"sqs:SendMessage"
],
"Resource": [
"arn:aws:sqs:{{us-east-1}}:{{111122223333}}:{{sqs-queue-name}}"
]
}
]
}
```
------
Y la siguiente política de confianza permite EventBridge asumir el rol:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "events.amazonaws.com"
},
"Action": "sts:AssumeRole"
}
]
}
```
------
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](eb-iam.md).
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](eb-cross-account.md).
Si su destino, como una cola de Amazon SQS, utiliza el cifrado AWS Key Management Service (AWS KMS), debe incluir la siguiente sección en su 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](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_BatchParameters.html).
Otros se pueden especificar la carga del evento. Si la carga útil del evento (pasada o vía [InputTransformers](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-transform-target-input.html)) contiene las siguientes claves, se asignan a los parámetros de la `submitJob` [solicitud](https://docs.aws.amazon.com/batch/latest/APIReference/API_SubmitJob.html#API_SubmitJob_RequestSyntax):
+ `ContainerOverrides: containerOverrides`
**nota**
Esto incluye solo el comando, el entorno, la memoria y las vCPU
+ `DependsOn: dependsOn`
**nota**
Esto incluye solo jobld
+ `Parameters: parameters`
## CloudWatch Registra los grupos como objetivos
Si no utilizas uno [InputTransformer](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-transform-target-input.html)con 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":,"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
EventBridge admite compilaciones estándar y por lotes como objetivos.
Si utiliza un [transformador de entrada](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-transform-target-input.html) para dar forma al evento de origen para que coincida con la [StartBuildRequest](https://docs.aws.amazon.com/codebuild/latest/APIReference/API_StartBuild.html#API_StartBuild_RequestSyntax)estructura antes de entregarlo a un CodeBuild destino, los parámetros se asignarán uno a uno y se transferirán a `codeBuild.StartBuild` ellos de forma predeterminada.
Para pasarle los parámetros `codeBuild.StartBuildBatch` en su lugar, transforme el evento de origen para que coincida con la [StartBuildBatchRequest](https://docs.aws.amazon.com/codebuild/latest/APIReference/API_StartBuildBatch.html#API_StartBuildBatch_RequestSyntax)estructura y añada el siguiente key/value par a la raíz del evento transformado:
`"buildType": "BATCH"`
## Tareas de Amazon ECS como destinos
Si suele dar forma [InputTransformers](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-transform-target-input.html)al evento de entrada a un Target para que coincida con la RunTask [TaskOverride](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_TaskOverride.html)estructura 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 de activación de la StartIncidentRequest llamada a Incident Manager.
## Systems Manager: ejecute el comando como objetivo
Cuando especifica Systems Manager Run Command como destino, EventBridge llama a la [https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_SendCommand.html](https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_SendCommand.html)API en su nombre. Configure el destino utilizando [https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_RunCommandParameters.html](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_RunCommandParameters.html), que especifica el documento SSM que se va a ejecutar y las instancias o etiquetas de destino.
`RunCommandParameters`contiene los siguientes campos:
+ `RunCommandTargets`— (Obligatorio) Una lista de pares clave-valor que especifican las instancias de destino. Utilice `Key` set to `InstanceIds` con una lista de instancias IDs, o `Key` configure set to `tag:{{tag-name}}` con valores de etiqueta para segmentar las instancias por etiqueta. Puede especificar entre 1 y 5 objetivos de comando de ejecución.
Para especificar qué documento SSM ejecutar y pasarle los parámetros, utilice el `Input` campo del [https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_Target.html](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_Target.html)objeto. El `Input` valor debe ser un objeto JSON con la siguiente estructura:
```
{
"DocumentName": "{{document-name}}",
"DocumentVersion": "{{version}}",
"Parameters": {
"{{parameter-key}}": ["{{parameter-value}}"]
}
}
```
Donde:
+ `DocumentName`— El nombre o el ARN del documento SSM que se va a ejecutar.
+ `DocumentVersion`— (Opcional) La versión del documento. Si se omite, se utiliza la versión por defecto.
+ `Parameters`— (Opcional) Un mapa de nombres de parámetros a matrices de valores, que coincide con los parámetros definidos en el documento SSM.
Por ejemplo, el siguiente AWS CLI comando crea una regla que ejecuta el `AWS-RunShellScript` documento en una instancia específica cuando coincide un EventBridge evento:
```
aws events put-targets --rule "my-rule" --targets '[{
"Id": "ssm-target-1",
"Arn": "arn:aws:ssm:{{region}}:{{account-id}}:document/AWS-RunShellScript",
"RoleArn": "arn:aws:iam::{{account-id}}:role/{{EventBridgeSSMRole}}",
"Input": "{\\"Parameters\\":{\\"commands\\":[\\"echo Hello from EventBridge\\"]}}",
"RunCommandParameters": {
"RunCommandTargets": [{
"Key": "InstanceIds",
"Values": ["{{i-0123456789abcdef0}}"]
}]
}
}]'
```
**nota**
El `Input` campo del `Target` objeto se utiliza para pasar el nombre y los parámetros del documento a Systems Manager Run Command. Esto es diferente del [https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_InputTransformer.html](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_InputTransformer.html), que transforma la carga útil del evento. Cuando utilice Systems Manager Run Command como destino, defina los parámetros del documento `Input` y especifique las instancias de destino en`RunCommandParameters`.
## Colas de Amazon SQS como destinos
EventBridge no admite el uso de colas de Amazon SQS cifradas con un. Clave propiedad de AWS Esto incluye los objetivos, así como las colas de Amazon SQS especificadas como colas de mensajes fallidos para los destinos. Para obtener más información al respecto Claves propiedad de AWS, consulte [las claves AWS propias](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-owned-cmk) en la Guía *AWS Key Management Service para desarrolladores*.