Amazon API Gateway cible les règles d'Amazon EventBridge - Amazon EventBridge
Paramètres dynamiquesNouvelles tentatives d’invocationExpiration

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

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

Vous pouvez utiliser Amazon API Gateway pour créer, publier, gérer et surveiller APIs. 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 API Gateway en tant que 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 pour les cas d’utilisation suivants :

  • Pour appeler une API spécifiée par le client et hébergée 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 d'événement EventBridge JSON sont envoyées dans le corps de la requête HTTP à votre point de terminaison. Vous pouvez spécifier les autres attributs de demande dans le champ HttpParameters de la cible comme suit :

  • PathParameterValues répertorie les valeurs qui correspondent séquentiellement à toutes les variables de chemin dans l’ARN de votre point de terminaison, 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é.

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

Note

Pour des raisons de sécurité, les clés d’en-tête HTTP 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 invoquez 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'état HTTP 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 HTTP 4xx.

Expiration

EventBridge règle Les demandes API Gateway 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 requêtes Pipes API Gateway ont un délai maximum de 29 secondes, le délai maximum pour l'API Gateway.