EventBridge Obiettivi di Amazon per Amazon API Gateway

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 endpoint regionali e ottimizzati per API Gateway Edge come destinazioni. 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 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 gli obiettivi, EventBridge riprova alcune chiamate non riuscite. Per API Gateway, EventBridge ritenta le risposte inviate con un codice di stato HTTP 5xx o 429 per un massimo di 24 ore con back off e jitter esponenziali. Successivamente, EventBridge pubblica una FailedInvocations metrica in Amazon. CloudWatch EventBridge non riprova altri errori HTTP 4xx.

Timeout

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

EventBridge Le richieste Pipes API Gateway hanno un timeout massimo di 29 secondi, il valore massimo dell'API Gateway.