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.

# Amazon API Gateway apunta a las reglas de Amazon EventBridge
<a name="eb-api-gateway-target"></a>

Puede utilizar Amazon API Gateway para crear, publicar, mantener y supervisar APIs. Amazon EventBridge admite el envío de eventos a un punto final de API Gateway. Al especificar un punto de conexión de API Gateway como [destino](eb-targets.md), cada [evento](eb-events.md) enviado al destino se asigna a una solicitud enviada al punto de conexión.

**importante**  
EventBridge admite el uso de puntos finales *regionales* y *optimizados para* API Gateway Edge como objetivos. Actualmente, no se admiten puntos de conexión *privados*. Para obtener más información sobre puntos de conexión, consulte [https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-api-endpoint-types.html](https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-api-endpoint-types.html).

Puede utilizar un destino de API Gateway para los siguientes casos de uso:
+ Para invocar una API especificada por el cliente alojada en API Gateway en función de eventos AWS o de terceros.
+ Para invocar un punto de conexión de forma periódica y de forma programada.

La información del evento EventBridge JSON se envía como el cuerpo de la solicitud HTTP a tu punto final. Puede especificar los demás atributos de la solicitud en el campo `HttpParameters` del destino de la siguiente manera:
+ `PathParameterValues` muestra los valores que corresponden secuencialmente a cualquier variable de ruta del ARN del punto de conexión, por ejemplo `"arn:aws:execute-api:us-east-1:112233445566:myapi/dev/POST/pets/*/*"`.
+ `QueryStringParameters`representa los parámetros de la cadena de consulta que se EventBridge anexan al punto final invocado.
+ `HeaderParameters` define los encabezados HTTP que se van a agregar a la solicitud.

**nota**  
Por motivos de seguridad, actualmente no se permiten las siguientes claves de encabezado HTTP:  
Cualquiera que tenga el prefijo `X-Amz` o `X-Amzn`
`Authorization`
`Connection`
`Content-Encoding`
`Content-Length`
`Host`
`Max-Forwards`
`TE`
`Transfer-Encoding`
`Trailer`
`Upgrade`
`Via`
`WWW-Authenticate`
`X-Forwarded-For`

## Parámetros dinámicos
<a name="eb-targets-apigateway-dynamic"></a>

Al invocar un destino de API Gateway, puede añadir datos de forma dinámica a los eventos que se envían al destino. Para obtener más información, consulte [Parámetros de destino](eb-targets.md#targets-specific-parms).

## Reintentos de invocación
<a name="eb-targets-apigateway-retries"></a>

Como ocurre con todos los objetivos, EventBridge vuelve a intentar algunas invocaciones fallidas. En el caso de API Gateway, EventBridge vuelve a intentar las respuestas enviadas con un código de estado HTTP 5xx o 429 durante un máximo de 24 horas, con retardo y [fluctuación exponenciales.](https://aws.amazon.com/blogs/architecture/exponential-backoff-and-jitter/) Después de eso, EventBridge publica una `FailedInvocations` métrica en Amazon CloudWatch. EventBridge no vuelve a intentar otros errores HTTP de 4xx.

## Timeout (Tiempo de espera)
<a name="eb-targets-apigateway-timeout"></a>

EventBridge regla Las solicitudes de API Gateway deben tener un tiempo de espera máximo de ejecución del cliente de 5 segundos. Si API Gateway tarda más de 5 segundos en responder, agota el EventBridge tiempo de espera de la solicitud y, a continuación, vuelve a intentarlo.

EventBridge Las solicitudes de API Gateway de Pipes tienen un tiempo de espera máximo de 29 segundos, el máximo de API Gateway.