Amazon API Gateway cible les règles d'Amazon EventBridge

Vous pouvez utiliser Amazon API Gateway pour créer, publier, gérer et surveillerAPIs. Amazon EventBridge prend en charge l'envoi d'événements vers un point de terminaison API Gateway. Lorsque vous spécifiez un point de terminaison de API passerelle comme cible, chaque événement envoyé à la cible correspond à une demande envoyée au point de terminaison.

Important

EventBridge prend en charge l'utilisation de points de terminaison régionaux et optimisés pour API Gateway Edge comme cibles. Les points de terminaison privés ne sont actuellement pas pris en charge. Pour en savoir plus sur les points de terminaison, consultez https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-api-endpoint-types.html.

Vous pouvez utiliser une cible API Gateway dans les cas d'utilisation suivants :

• Pour invoquer un API hébergement spécifié par le client dans API Gateway en fonction d'événements tiers AWS ou en fonction d'événements tiers.

• Pour invoquer un point de terminaison périodiquement selon un calendrier.

Les informations relatives à l' EventBridge JSONévénement sont envoyées dans le corps de la HTTP demande à votre terminal. Vous pouvez spécifier les autres attributs de demande dans le champ HttpParameters de la cible comme suit :

• PathParameterValuesrépertorie les valeurs qui correspondent de manière séquentielle à toutes les variables de chemin de votre point de terminaisonARN, par exemple"arn:aws:execute-api:us-east-1:112233445566:myapi/dev/POST/pets/*/*".

• QueryStringParametersreprésente les paramètres de chaîne de requête EventBridge ajoutés au point de terminaison invoqué.

• HeaderParametersdéfinit HTTP les en-têtes à ajouter à la demande.

Note

Pour des raisons de sécurité, les clés HTTP d'en-tête suivantes ne sont pas autorisées :

• Toutes les clés ayant le préfixe X-Amz ou X-Amzn

• Authorization

• Connection

• Content-Encoding

• Content-Length

• Host

• Max-Forwards

• TE

• Transfer-Encoding

• Trailer

• Upgrade

• Via

• WWW-Authenticate

• X-Forwarded-For

Paramètres dynamiques

Lorsque vous appelez une cible API Gateway, vous pouvez ajouter dynamiquement des données aux événements envoyés à la cible. Pour de plus amples informations, veuillez consulter Paramètres de cible.

Nouvelles tentatives d’invocation

Comme pour toutes les cibles, EventBridge réessaie certains appels qui ont échoué. Pour API Gateway, EventBridge réessaie les réponses envoyées avec un code d'HTTPétat 5xx ou 429 pendant 24 heures au maximum, avec un décalage et une instabilité exponentiels. Ensuite, EventBridge publie une FailedInvocations métrique sur Amazon CloudWatch. EventBridge ne réessaie pas d'autres erreurs 4xxHTTP.

Expiration

EventBridge règle Les demandes de API passerelle doivent avoir un délai d'exécution maximal du client de 5 secondes. Si API Gateway met plus de 5 secondes à répondre, EventBridge expire la demande, puis réessaie.

EventBridge Les demandes de Pipes API Gateway ont un délai maximum de 29 secondes, le délai maximum de API Gateway.