View a markdown version of this page

Amazon API Gateway è destinato alle regole in Amazon EventBridge - Amazon EventBridge
Parametri dinamiciRipetizione di invocazioniTimeout

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Amazon API Gateway è destinato alle regole in Amazon EventBridge

Per creare, pubblicare, gestire e monitorare le API puoi utilizzare Gateway Amazon API. Amazon EventBridge supporta l'invio di eventi a un endpoint API Gateway. Quando specifichi un endpoint Gateway API come destinazione, ogni evento inviato alla destinazione viene mappato a una richiesta inviata all'endpoint.

Importante

EventBridge supporta l'utilizzo di API Gateway Edge-optimized e endpoint regionali come obiettivi. Gli endpoint privati non sono attualmente supportati. Per ulteriori informazioni sugli endpoint, consulta https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-api-endpoint-types.html.

Puoi utilizzare un destinazione di Gateway API per i seguenti casi d'uso:

  • Per richiamare un'API specificata dal cliente ospitata in API Gateway in base AWS a eventi o di terze parti.

  • Per richiamare un endpoint periodicamente in base a una pianificazione.

Le informazioni sull'evento EventBridge JSON vengono inviate come corpo della richiesta HTTP all'endpoint. È possibile specificare gli altri attributi della richiesta nel campo HttpParameters della destinazione come segue:

  • PathParameterValues elenca i valori che corrispondono in sequenza a qualsiasi variabile di percorso nell'ARN dell'endpoint, ad esempio "arn:aws:execute-api:us-east-1:112233445566:myapi/dev/POST/pets/*/*".

  • QueryStringParametersrappresenta i parametri della stringa di query che vengono EventBridge aggiunti all'endpoint richiamato.

  • HeaderParameters definisce le intestazioni HTTP da aggiungere alla richiesta.

Nota

Per motivi di sicurezza, le seguenti chiavi di intestazione HTTP non sono consentite:

  • Qualsiasi chiave con prefisso X-Amz o X-Amzn

  • Authorization

  • Connection

  • Content-Encoding

  • Content-Length

  • Host

  • Max-Forwards

  • TE

  • Transfer-Encoding

  • Trailer

  • Upgrade

  • Via

  • WWW-Authenticate

  • X-Forwarded-For

Parametri dinamici

Quando si richiama una destinazione di Gateway API, è possibile aggiungere dinamicamente dati agli eventi che vengono inviati alla destinazione. Per ulteriori informazioni, consulta Parametri di destinazione.

Ripetizione di invocazioni

Come per tutti i target, EventBridge riprova alcune chiamate non riuscite. Per API Gateway, EventBridge riprova le risposte inviate con un codice di stato HTTP 5xx o 429 per un massimo di 24 ore con backoff e jitter esponenziali. Successivamente, pubblica una metrica su Amazon EventBridge . FailedInvocations CloudWatch EventBridge non riprova altri errori HTTP 4xx.

Timeout

EventBridge regola Le richieste API Gateway devono avere un timeout massimo di esecuzione del client di 5 secondi. Se API Gateway impiega più di 5 secondi per rispondere, scade il EventBridge timeout della richiesta e quindi riprova.

EventBridge Le richieste di Pipes API Gateway hanno un timeout massimo di 29 secondi, quello massimo di API Gateway.