Obiettivi di Amazon API Gateway per le regole in Amazon EventBridge - Amazon EventBridge

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à.

Obiettivi di Amazon API Gateway per le regole in Amazon EventBridge

Puoi usare Amazon API Gateway per creare, pubblicare, gestire e monitorareAPIs. Amazon EventBridge supporta l'invio di eventi a un endpoint API Gateway. Quando specifichi un endpoint API Gateway come destinazione, ogni evento inviato al target corrisponde a una richiesta inviata all'endpoint.

Importante

EventBridge supporta l'utilizzo di API endpoint regionali e ottimizzati per Gateway Edge 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.

È possibile utilizzare un target API Gateway per i seguenti casi d'uso:

  • Per richiamare un API server ospitato in API Gateway specificato dal cliente in base AWS a eventi di terze parti.

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

Le informazioni sull' EventBridge JSONevento vengono inviate come corpo della HTTP richiesta 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'endpointARN, 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 HTTP intestazioni da aggiungere alla richiesta.

Nota

Per motivi di sicurezza, le seguenti chiavi di HTTP intestazione 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 API Gateway, è 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 invocazioni non riuscite. Per API Gateway, EventBridge riprova le risposte inviate con un codice di HTTP stato 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 4xx. HTTP

Timeout

EventBridge regola Le richieste API Gateway devono avere un timeout di esecuzione del 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 massimo del API Gateway.