Los destinos de la API como objetivos en Amazon EventBridge

EventBridge Los destinos de las API son puntos de enlace HTTPS que se pueden invocar como destino de una regla de bus de eventos, o canal, de forma similar a como se invoca un AWS servicio o recurso como destino. Con los destinos de API, puede enrutar eventos entre AWS servicios, aplicaciones de software como servicio (SaaS) integradas y aplicaciones públicas o privadas mediante llamadas a la API.

Cuando especificas un destino de API como objetivo de regla o canalización, EventBridge invoca el punto final HTTPS para cualquier evento que coincida con el patrón de eventos especificado en la regla o canalización y, a continuación, entrega la información del evento junto con la solicitud. Con EventBridge, puedes usar cualquier método HTTP excepto CONNECT y TRACE para la solicitud. Los métodos HTTP más habituales son PUT y POST.

También puede usar transformadores de entrada para personalizar el evento según los parámetros de un punto de conexión HTTP específico. Para obtener más información, consulte Transformación EventBridge de entradas de Amazon.

EventBridge Los destinos de la API utilizan las conexiones para definir el método de autorización y las credenciales y la conectividad de red EventBridge que se utilizarán al conectarse a un punto final HTTPS determinado. Las conexiones admiten tanto las conexiones públicas como las privadas APIs. Para obtener más información, consulte Connections.

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

Rol vinculado a un servicio para los destinos de la API

Cuando creas una conexión para un destino de API, se añade a tu 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 acerca los roles vinculados a servicios, consulte Uso de roles vinculados a servicios en la Guía del usuario de IAM.

Disponibilidad por región

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

Encabezados en solicitudes a destinos de la API

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

Encabezados se incluyen en solicitudes a destinos de la API

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

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

EventBridge no permite anular los siguientes encabezados:

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

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

Códigos de error de destinos de la API

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

EventBridge Los destinos de la API leen el encabezado de respuesta HTTP estándar Retry-After para saber cuánto tiempo deben esperar antes de realizar una solicitud de seguimiento. En el caso de los buses de eventos, 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 de 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 Uso de colas con letra muerta para procesar los eventos no entregados en EventBridge.