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à.
Puoi utilizzare Amazon API Gateway per creare, pubblicare, gestire e monitorare APIs. 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:
-
PathParameterValueselenca 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. -
HeaderParametersdefinisce 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-AmzoX-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 esponenzialiFailedInvocations 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.
