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 Amazon EventBridge Pipes
Puede enviar los datos de la canalización a un destino específico. Puede configurar los siguientes objetivos al configurar una tubería en EventBridge:
+ [Destino de la API](eb-api-destinations.md)
+ [API Gateway](eb-api-gateway-target.md)
+ [Cola de trabajos por lotes](#pipes-targets-specifics-batch)
+ [CloudWatch grupo de registros](#pipes-targets-specifics-cwl)
+ [Tarea de ECS](#pipes-targets-specifics-ecs-task)
+ [Bus de eventos en la misma cuenta y región](#pipes-targets-specifics-eventbridge)
+ Flujo de entrega de Firehose
+ Plantilla de evaluación del inspector
+ Flujo de Kinesis
+ [Función de Lambda (SYNC o ASYNC)](#pipes-targets-specifics-lambda-stepfunctions)
+ Consultas de API de datos de clústeres de Redshift
+ SageMaker AI Pipeline
+ Tema de Amazon SNS (no se admiten temas FIFO de Amazon SNS)
+ Cola de Amazon SQS
+ [Máquina de estado de Step Functions](#pipes-targets-specifics-lambda-stepfunctions)
+ Flujos de trabajo rápido (SYNC o ASYNC)
+ Flujos de trabajo estándar (ASYNC)
+ [Timestream para LiveAnalytics mesa](#pipes-targets-specifics-timestream)
## Parámetros de destino
Algunos servicios de destino no envían la carga útil del evento al destino, sino que tratan el evento como un desencadenante para invocar una API específica. EventBridge usa el [https://docs.aws.amazon.com/eventbridge/latest/pipes-reference/API_PipeTargetParameters.html](https://docs.aws.amazon.com/eventbridge/latest/pipes-reference/API_PipeTargetParameters.html)para especificar qué información se envía a esa API. 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. Debe usar el objeto [https://docs.aws.amazon.com/eventbridge/latest/pipes-reference/API_PipeTargetParameters.html#pipes-Type-PipeTargetParameters-InputTemplate](https://docs.aws.amazon.com/eventbridge/latest/pipes-reference/API_PipeTargetParameters.html#pipes-Type-PipeTargetParameters-InputTemplate) para asegurarse de que los datos estén estructurados correctamente. Si desea incluir la carga del evento original, haga referencia a ella en el objeto [https://docs.aws.amazon.com/eventbridge/latest/pipes-reference/API_PipeTargetParameters.html#pipes-Type-PipeTargetParameters-InputTemplate](https://docs.aws.amazon.com/eventbridge/latest/pipes-reference/API_PipeTargetParameters.html#pipes-Type-PipeTargetParameters-InputTemplate).)
+ API Gateway (Los datos enviados a API Gateway deben coincidir con la estructura de la API. Debe usar el objeto [https://docs.aws.amazon.com/eventbridge/latest/pipes-reference/API_PipeTargetParameters.html#pipes-Type-PipeTargetParameters-InputTemplate](https://docs.aws.amazon.com/eventbridge/latest/pipes-reference/API_PipeTargetParameters.html#pipes-Type-PipeTargetParameters-InputTemplate) para asegurarse de que los datos estén estructurados correctamente. Si desea incluir la carga del evento original, haga referencia a ella en el objeto [https://docs.aws.amazon.com/eventbridge/latest/pipes-reference/API_PipeTargetParameters.html#pipes-Type-PipeTargetParameters-InputTemplate](https://docs.aws.amazon.com/eventbridge/latest/pipes-reference/API_PipeTargetParameters.html#pipes-Type-PipeTargetParameters-InputTemplate).)
+ [https://docs.aws.amazon.com/eventbridge/latest/pipes-reference/API_PipeTargetRedshiftDataParameters.html](https://docs.aws.amazon.com/eventbridge/latest/pipes-reference/API_PipeTargetRedshiftDataParameters.html) (Clústeres de API de datos de Amazon Redshift)
+ [https://docs.aws.amazon.com/eventbridge/latest/pipes-reference/API_PipeTargetSageMakerPipelineParameters.html](https://docs.aws.amazon.com/eventbridge/latest/pipes-reference/API_PipeTargetSageMakerPipelineParameters.html)(Amazon SageMaker Runtime Model Building Pipelines)
+ [https://docs.aws.amazon.com/eventbridge/latest/pipes-reference/API_PipeTargetBatchJobParameters.html](https://docs.aws.amazon.com/eventbridge/latest/pipes-reference/API_PipeTargetBatchJobParameters.html) (AWS Batch)
**nota**
EventBridge no admite toda la sintaxis de rutas de 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
EventBridge Los parámetros de destino de Pipes admiten la sintaxis de ruta JSON dinámica opcional. Puede usar esta sintaxis para 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 Pipes](eb-pipes-input-transformation.md).
La sintaxis dinámica se puede utilizar en todos los campos de cadena y sin enumeración de todos los parámetros de enriquecimiento y destino de EventBridge Pipes, excepto:
+ [https://docs.aws.amazon.com/eventbridge/latest/pipes-reference/API_PipeTargetCloudWatchLogsParameters.html](https://docs.aws.amazon.com/eventbridge/latest/pipes-reference/API_PipeTargetCloudWatchLogsParameters.html)
+ [https://docs.aws.amazon.com/eventbridge/latest/pipes-reference/API_PipeTargetEventBridgeEventBusParameters.html](https://docs.aws.amazon.com/eventbridge/latest/pipes-reference/API_PipeTargetEventBridgeEventBusParameters.html)
+ [https://docs.aws.amazon.com/eventbridge/latest/pipes-reference/API_PipeEnrichmentHttpParameters.html](https://docs.aws.amazon.com/eventbridge/latest/pipes-reference/API_PipeEnrichmentHttpParameters.html)
+ [https://docs.aws.amazon.com/eventbridge/latest/pipes-reference/API_PipeTargetHttpParameters.html](https://docs.aws.amazon.com/eventbridge/latest/pipes-reference/API_PipeTargetHttpParameters.html)
[Por ejemplo, para establecer el objetivo `PartitionKey` de un canal de Kinesis en una clave personalizada del evento de origen, defina el. KinesisTargetParameter PartitionKey](https://docs.aws.amazon.com/)para:
+ `"$.data.{{someKey}}"` para un origen de Kinesis
+ `"$.body.{{someKey}}"` para un origen de Amazon SQS
A continuación, si la carga útil del evento es una cadena JSON válida, por ejemplo`{"{{someKey}}":"{{someValue}}"}`, EventBridge extrae el valor de la ruta JSON y lo utiliza como parámetro de destino. En este ejemplo, EventBridge configuraría Kinesis `PartitionKey` en "»{{someValue}}.
## Permisos
Para realizar llamadas a la API en los recursos de su propiedad, EventBridge Pipes necesita el permiso adecuado. EventBridge PIpes utiliza la función de IAM que especifiques en el proceso de enriquecimiento y dirige las llamadas mediante el principio de IAM. `pipes.amazonaws.com`
## Invocación de destinos
EventBridge tiene las siguientes formas de invocar un objetivo:
+ **Sincrónicamente** (tipo de invocación establecido en`REQUEST_RESPONSE`): EventBridge espera una respuesta del objetivo antes de continuar.
+ De forma **asíncrona** (tipo de invocación establecido en`FIRE_AND_FORGET`): EventBridge no espera una respuesta para continuar.
De forma predeterminada, en el caso de las canalizaciones con fuentes ordenadas, EventBridge invoca los destinos de forma sincrónica, ya que se necesita una respuesta del destino antes de pasar al siguiente evento.
Si una fuente no hace cumplir el orden, como una cola estándar de Amazon SQS, EventBridge puede invocar un destino compatible de forma sincrónica o asíncrona.
Con las funciones de Lambda y las máquinas de estado Step Functions, puede configurar el tipo de invocación.
**nota**
Para las máquinas de estado Step Functions, los [flujos de trabajo estándar](https://docs.aws.amazon.com/step-functions/latest/dg/concepts-standard-vs-express.html) se deben invocar de forma asíncrona.
## Límites de tamaño de carga útil
EventBridge Pipes admite cargas útiles de hasta 6 MB. Sin embargo, el límite de tamaño efectivo de la carga útil viene determinado por lo que sea menor: el límite de Pipes de 6 MB o el tamaño máximo de carga útil del servicio de destino. Por ejemplo:
+ Las funciones Lambda admiten cargas útiles de hasta 6 MB, por lo que el límite efectivo para una tubería dirigida a Lambda es de 6 MB.
+ EventBridge Los buses de eventos admiten cargas útiles de hasta 1 MB, por lo que el límite efectivo para una canalización dirigida a un bus de eventos es de 1 MB.
+ Las máquinas de estados Step Functions admiten cargas útiles de hasta 256 KB, por lo que el límite efectivo para una canalización dirigida a Step Functions es de 256 KB.
Al configurar su canal, asegúrese de que el tamaño de la carga útil, incluidas las transformaciones aplicadas mediante el enriquecimiento o la transformación de entrada, no supere el tamaño máximo de carga útil del objetivo.
## AWS Batch las colas de trabajos se centran en aspectos específicos
Todos los AWS Batch `submitJob` parámetros se configuran de forma explícita con la carga útil del evento entrante y`BatchParameters`, como ocurre con todos los parámetros de Pipe, pueden ser dinámicos mediante una ruta JSON a la carga útil del evento entrante.
## CloudWatch Registra los detalles del objetivo del grupo
Tanto si utiliza un transformador de entrada como si no, la carga del evento se utiliza como mensaje de registro. Puede configurar el `Timestamp` (o el `LogStreamName` explícito del destino) mediante `CloudWatchLogsParameters` en `PipeTarget`. Como todos los parámetros de canalización, estos parámetros pueden ser dinámicos cuando se usa una ruta JSON con la carga del evento entrante.
## Aspectos específicos de los destinos de la tarea de Amazon ECS
Todos los parámetros `runTask` e Amazon ECS se configuran de forma explícita mediante `EcsParameters`. Como todos los parámetros de canalización, estos parámetros pueden ser dinámicos cuando se usa una ruta JSON con la carga del evento entrante.
## Aspectos específicos de los destinos de las funciones de Lambda y los flujos de trabajo de Step Functions
Lambda y Step Functions no tienen una API de lotes. Para procesar lotes de eventos de un origen de canalización, el lote se convierte en una matriz JSON y se transfiere como entrada al destino de Lambda o Step Functions. Para obtener más información, consulte [Procesamiento por lotes y simultaneidad de Amazon EventBridge Pipes](eb-pipes-batching-concurrency.md).
## Timestream para obtener información específica sobre los objetivos de la LiveAnalytics tabla
A la hora de especificar una LiveAnalytics tabla Timestream de formulario como objetivo de tubería, se incluyen las siguientes:
+ Actualmente, las transmisiones de Apache Kafka (incluidas las de proveedores externos Amazon MSK o de terceros) no se admiten como fuente canalizada.
+ Si ha especificado una DynamoDB transmisión Kinesis o como fuente de canalización, debe especificar el número de reintentos.
Para obtener más información, consulte [Configuración de los ajustes de la canalización](eb-pipes-create.md#pipes-configure-pipe-settings).
## EventBridge detalles del destino del bus de eventos
Al configurar un bus de EventBridge eventos como destino de canalización, la carga útil de la canalización se coloca automáticamente en la `detail` sección del EventBridge evento. Se utiliza [https://docs.aws.amazon.com/eventbridge/latest/pipes-reference/API_PipeTargetEventBridgeEventBusParameters.html](https://docs.aws.amazon.com/eventbridge/latest/pipes-reference/API_PipeTargetEventBridgeEventBusParameters.html)para configurar los `detail-type` campos `source` y los eventos. Ambos campos admiten la sintaxis de rutas JSON dinámica para extraer valores de la carga útil del evento. Por ejemplo, establézcalo `Source` en `$.body.source` o `DetailType` en`$.data.eventType`. También puede usar transformadores de entrada para modificar la estructura del evento antes de colocarlo en el `detail` campo. Para obtener más información, consulte [Transformación EventBridge de entradas de Amazon Pipes](eb-pipes-input-transformation.md).