Destinos de Amazon API Gateway para reglas de Amazon EventBridge - Amazon EventBridge
Parámetros dinámicosReintentos de invocaciónTiempo de espera

Destinos de Amazon API Gateway para reglas de Amazon EventBridge

Puede usar Amazon API Gateway para crear, publicar, mantener y supervisar API. Amazon EventBridge admite el envío de eventos a un punto de conexión de API Gateway. Al especificar un punto de conexión de API Gateway como destino, cada evento enviado al destino se asigna a una solicitud enviada al punto de conexión.

importante

EventBridge admite el uso de puntos de conexión de API Gateway regionales y optimizados para Edge como destinos. 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.

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 JSON de EventBridge se envía como el cuerpo de la solicitud HTTP al punto de conexión. 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 EventBridge adjunta al punto de conexión 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

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.

Reintentos de invocación

Como ocurre con todos los destinos, EventBridge vuelve a intentar algunas invocaciones fallidas. En el caso de API Gateway, EventBridge vuelve a intentar enviar las respuestas enviadas con un código de estado HTTP 5xx o 429 durante un máximo de 24 horas, con un retardo y un jitter exponenciales. Después, EventBridge publica una métrica FailedInvocations en Amazon CloudWatch. EventBridge no vuelve a intentar el envío en caso de otros errores HTTP 4xx.

Tiempo de espera

Las solicitudes de API Gateway relacionadas con reglas de EventBridge 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, EventBridge agota el tiempo de espera de la solicitud y, a continuación, lo vuelve a intentar.

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