APIdestinos como objetivos por regla general en Amazon EventBridge - Amazon EventBridge

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.

APIdestinos como objetivos por regla general en Amazon EventBridge

Los EventBridge APIdestinos de Amazon HTTP son puntos de enlace que puedes invocar como destino de una regla, de forma similar a como se invoca un AWS servicio o recurso como destino. Al usar API los destinos, puede enrutar eventos entre AWS servicios, aplicaciones de software como servicio (SaaS) integradas y sus aplicaciones al exterior o AWS mediante API llamadas. Al especificar un API destino como destino de una regla, EventBridge invoca el HTTP punto final 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 junto con la solicitud. Con EventBridge, puedes usar cualquier HTTP método excepto CONNECT y TRACE para la solicitud. Los HTTP métodos más comunes que se utilizan son PUT yPOST. También puede utilizar transformadores de entrada para personalizar el evento según los parámetros de un HTTP punto final específico. Para obtener más información, consulte Transformación EventBridge de entradas de Amazon.

nota

APIlos destinos no admiten destinos privados, como los VPC puntos finales de interfaz, incluidos los privados HTTPS APIs en nubes privadas virtuales (VPC) que utilizan Network and Application Load Balancer y puntos finales de interfaz privados. VPC

Para obtener más información, consulte Uso de Amazon EventBridge con puntos de conexión de VPC interfaz.

importante

EventBridge las solicitudes a un punto final de API destino deben tener un tiempo de espera máximo de ejecución por parte del cliente de 5 segundos. Si el punto final de destino tarda más de 5 segundos en responder, se agota el EventBridge tiempo de espera de la solicitud. EventBridge Reintenta las solicitudes agotadas hasta los máximos configurados en tu política de reintentos. De forma predeterminada, los máximos son 24 horas y 185 veces. Una vez transcurrido el número máximo de reintentos, los eventos se envían a cola de mensajes fallidos, si dispone de ella. De lo contrario, el evento se descarta.

En el siguiente vídeo se muestra el uso del destino: API

Función vinculada al servicio para los destinos API

Al crear una conexión para un API destino, se agrega a su cuenta un rol vinculado al servicio denominado AWS ServiceRoleForAmazonEventBridgeApiDestinations. EventBridge usa el rol vinculado al servicio para crear y almacenar un secreto en Secrets Manager. Para conceder los permisos necesarios al rol vinculado al servicio, EventBridge adjunta la AmazonEventBridgeApiDestinationsServiceRolePolicypolítica al rol. La política limita los permisos concedidos únicamente a los necesarios para que el rol interactúe con el secreto de la conexión. No se incluye ningún otro permiso y el rol solo puede interactuar con las conexiones de la cuenta para administrar el secreto.

La siguiente política es la AmazonEventBridgeApiDestinationsServiceRolePolicy.

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "secretsmanager:CreateSecret", "secretsmanager:UpdateSecret", "secretsmanager:DescribeSecret", "secretsmanager:DeleteSecret", "secretsmanager:GetSecretValue", "secretsmanager:PutSecretValue" ], "Resource": "arn:aws:secretsmanager:*:*:secret:events!connection/*" } ] }

Para obtener más información sobre las funciones vinculadas al servicio, consulte Uso de las funciones vinculadas al servicio en la documentación. IAM

Disponibilidad por región

El rol AmazonEventBridgeApiDestinationsServiceRolePolicy vinculado al servicio se admite en las siguientes regiones: AWS

  • Este de EE. UU. (Norte de Virginia)

  • Este de EE. UU. (Ohio)

  • Oeste de EE. UU. (Norte de California)

  • Oeste de EE. UU. (Oregón)

  • África (Ciudad del Cabo)

  • Asia-Pacífico (Hong Kong)

  • Asia-Pacífico (Bombay)

  • Asia-Pacífico (Osaka)

  • Asia-Pacífico (Seúl)

  • Asia-Pacífico (Singapur)

  • Asia-Pacífico (Sídney)

  • Asia-Pacífico (Tokio)

  • Canadá (centro)

  • Europa (Fráncfort)

  • Europa (Irlanda)

  • Europa (Londres)

  • Europa (Milán)

  • Europa (París)

  • Europa (Estocolmo)

  • América del Sur (São Paulo)

  • China (Ningxia)

  • China (Pekín)

Encabezados en las solicitudes a los destinos API

En la siguiente sección se detalla cómo se HTTP gestionan EventBridge los encabezados en las solicitudes a API los destinos.

Los encabezados se incluyen en las solicitudes a los destinos API

Además de los encabezados de autorización definidos para la conexión utilizada para un API destino, EventBridge incluye los siguientes encabezados en cada solicitud.

Clave de encabezado Valor del encabezado

User-Agent

Amazona//EventBridgeApiDestinations

Contenido-Tipo

Si no se especifica ningún valor de tipo de contenido personalizado, EventBridge incluye el siguiente valor predeterminado como tipo de contenido:

aplicación/json; charset=utf-8

Range

bytes=0-1048575

Accept-Encoding

gzip, deflate

Connection

close

Content-Length

Un encabezado de entidad que indica el tamaño del cuerpo de la entidad, en bytes, enviado al destinatario.

Host

Un encabezado de solicitud que especifica el número de host y puerto del servidor al que se envía la solicitud.

Encabezados que no se pueden anular en las solicitudes a los destinos API

EventBridge no permite anular los siguientes encabezados:

  • User-Agent

  • Range

Se EventBridge eliminan los encabezados de las solicitudes a los destinos API

EventBridge elimina los siguientes encabezados de todas las solicitudes de API destino:

  • A-IM

  • Accept-Charset

  • Accept-Datetime

  • Accept-Encoding

  • Cache-Control

  • Connection

  • Content-Encoding

  • Content-Length

  • Contenido: MD5

  • Date

  • Expect

  • Forwarded

  • De

  • Host

  • HTTP2-Ajustes

  • If-Match

  • If-Modified-Since

  • If-None-Match

  • If-Range

  • If-Unmodified-Since

  • Max-Forwards

  • Origen

  • Pragma

  • Proxy-Authorization

  • Range

  • Referer

  • TE

  • Trailer

  • Transfer-Encoding

  • User-Agent

  • Upgrade

  • Via

  • Advertencia

APIcódigos de error de destino

Cuando EventBridge intenta entregar un evento a un API destino y se produce un error, EventBridge hace lo siguiente:

  • Se vuelven a intentar enviar los eventos asociados a los códigos de error 409, 429 y 5xx.

  • No se vuelva a intentar enviar los eventos asociados a los códigos de error 1xx, 2xx, 3xx y 4xx (excepto 429).

EventBridge APIlos destinos leen el encabezado de HTTP respuesta estándar Retry-After para saber cuánto tiempo deben esperar antes de realizar una solicitud de seguimiento. EventBridge elige el valor más conservador entre la política de reintentos definida y el Retry-After encabezado. Si Retry-After el valor es negativo, EventBridge deja de reintentar la entrega para ese evento.

Cómo afecta la tasa de invocación a la entrega del evento

Si establece la tasa de invocación por segundo en un valor muy inferior al número de invocaciones generadas, es posible que los eventos no se entreguen dentro del tiempo de reintento de 24 horas especificado para los eventos. Por ejemplo, si establece la tasa de invocación en 10 invocaciones por segundo, pero se generan miles de eventos por segundo, rápidamente tendrá una acumulación de eventos pendientes de entrega que supera las 24 horas. Para que no se pierdan eventos, configure una cola de mensajes fallidos a la que enviar los eventos con invocaciones fallidas para poder procesarlos más adelante. Para obtener más información, consulte Utilice colas de texto sin formato para procesar los eventos no entregados en EventBridge.