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.
Destinos de API como destinos en Amazon EventBridge
EventBridge Los destinos de las API son puntos de enlace HTTPS que puedes invocar como destino de una canalización o regla de bus de eventos, 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 integradas de software como servicio (SaaS) 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 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 utilizan al conectarse a un punto final HTTPS determinado. Las conexiones admiten API públicas y privadas. Para obtener más información, consulte Conexiones.
nota
EventBridge Actualmente, los destinos de API solo admiten nombres de dominio público con certificados de confianza pública para puntos de enlace HTTPS cuando se utilizan API privadas. Los destinos de la API no admiten TLS mutua (mTLS).
importante
EventBridge las solicitudes a un punto final de destino de la API deben tener un tiempo máximo de espera 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 los reintentos han agotado el tiempo de espera de las solicitudes hasta los máximos configurados en su política de reintentos.
De forma predeterminada, los máximos para los buses de eventos son 24 horas y 185 veces.
En el caso de las canalizaciones, los reintentos se determinan según el tipo de origen de la canalización y su configuración. EventBridge volverá a intentarlo hasta que el evento caduque desde el origen o hasta que se alcance la antigüedad máxima del evento o los reintentos configurados.
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 de los destinos de la API:
Service-linked rol para los destinos de API
Cuando creas una conexión para un destino de API, el rol vinculado al servicio AmazonEventBridgeApiDestinationsServiceRolePolicy se agrega a tu cuenta. EventBridge usa este rol vinculado a un servicio para crear y almacenar un secreto en Secrets Manager. Para conceder los permisos necesarios al rol vinculado a un servicio, EventBridge adjunta la AmazonEventBridgeApiDestinationsServiceRolePolicy polí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.
Para obtener más información acerca de los roles vinculados a servicios, consulte Uso de roles vinculados a servicios en la Guía del usuario de IAM.
Encabezados en solicitudes a destinos de la API
En la siguiente sección, se detalla cómo se gestionan los EventBridge 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 en un destino de API, EventBridge incluye los siguientes encabezados en cada solicitud.
| Clave de encabezado | Valor del encabezado |
|---|---|
|
User-Agent |
Amazon/EventBridge/ApiDestinations |
|
Content-Type |
Si no se especifica ningún Content-Type valor personalizado, EventBridge incluye el siguiente valor predeterminado como: Content-Type application/json; juego de caracteres = 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 de la API
EventBridge no permite anular los siguientes encabezados:
-
User-Agent
-
Range
Los encabezados se EventBridge eliminan de las solicitudes a los destinos de la API
EventBridge elimina los siguientes encabezados de todas las solicitudes de destino de la API:
-
A-IM
-
Accept-Charset
-
Accept-Datetime
-
Accept-Encoding
-
Cache-Control
-
Connection
-
Content-Encoding
-
Content-Length
-
Content-MD5
-
Date
-
Expect
-
Forwarded
-
De
-
Host
-
HTTP2-Settings
-
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
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 realiza lo siguiente:
-
Reintenta los eventos asociados a los códigos de error
401,407,409,429y5xx. -
No reintenta los eventos asociados a los códigos de error
1xx,2xx,3xxy4xx(distintos de los indicados anteriormente).
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 detiene el reintento de 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 Utilizar colas de correo no entregado para procesar los eventos no entregados en EventBridge.
Disponibilidad por región
Los destinos de API a puntos de enlace HTTPS públicos se admiten 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 (Tokio)
Asia-Pacífico (Seúl)
Asia-Pacífico (Osaka)
Asia-Pacífico (Mumbai)
Asia-Pacífico (Hyderabad)
Asia-Pacífico (Singapur)
Asia-Pacífico (Sídney)
Asia-Pacífico (Yakarta)
Canadá (centro)
China (Pekín)
China (Ningxia)
Europa (Fráncfort)
Europa (Zúrich)
Europa (Estocolmo)
Europa (Milán)
Europa (España)
Europa (Irlanda)
Europa (Londres)
Europa (París)
Medio Oriente (EAU)
Middle East (Bahrain)
América del Sur (São Paulo)
