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à.
Destinazioni API come obiettivi in Amazon EventBridge
EventBridge Le destinazioni API sono endpoint HTTPS che è possibile richiamare come destinazione di una regola del bus di eventi, o pipe, in modo simile a come si richiama un AWS servizio o una risorsa come destinazione. Utilizzando le destinazioni API, puoi instradare gli eventi tra AWS servizi, applicazioni SaaS (Software as a Service) integrate e applicazioni pubbliche o private utilizzando chiamate API.
Quando specifichi una destinazione API come regola o destinazione pipe, EventBridge richiama l'endpoint HTTPS per qualsiasi evento che corrisponde al modello di evento specificato nella regola o nella pipe e quindi fornisce le informazioni sull'evento con la richiesta. Con EventBridge, puoi utilizzare qualsiasi metodo HTTP tranne CONNECT e TRACE per la richiesta. I metodi HTTP più comuni da utilizzare sono PUT e POST.
È inoltre possibile utilizzare trasformatori di input per personalizzare l'evento in base ai parametri di uno specifico endpoint HTTP. Per ulteriori informazioni, consulta Trasformazione degli EventBridge input di Amazon.
EventBridge Le destinazioni API utilizzano le connessioni per definire il metodo e le credenziali di autorizzazione e la connettività di rete EventBridge da utilizzare durante la connessione a un determinato endpoint HTTPS. Le connessioni supportano API pubbliche e private. Per ulteriori informazioni, consulta Connessioni.
Nota
EventBridge Le destinazioni API attualmente supportano solo nomi di dominio pubblico con certificati pubblicamente affidabili per gli endpoint HTTPS quando si utilizzano API private. Le destinazioni API non supportano il protocollo TLS (MTL) reciproco.
Importante
EventBridge le richieste a un endpoint di destinazione API devono avere un timeout massimo di esecuzione del client di 5 secondi. Se l'endpoint di destinazione impiega più di 5 secondi per rispondere, scade il EventBridge timeout della richiesta. EventBridge riprova le richieste scadute fino al numero massimo configurato nella tua politica di riprova.
Per gli autobus per eventi, per impostazione predefinita, il numero massimo è di 24 ore e 185 volte.
Per le pipe, i tentativi vengono determinati in base al tipo di sorgente della pipe e alla sua configurazione. EventBridge riproverà fino alla scadenza dell'evento dall'origine o al raggiungimento della durata massima dell'evento o dei tentativi di nuovo tentativo configurati.
Dopo l'esecuzione del numero massimo di tentativi, gli eventi vengono inviati alla coda DLQ se esistente. In caso contrario, l'evento viene abbandonato.
Il video seguente dimostra l'uso delle destinazioni API:
Service-linked ruolo per le destinazioni API
Quando crei una connessione per una destinazione API, il ruolo collegato al servizio AmazonEventBridgeApiDestinationsServiceRolePolicy viene aggiunto al tuo account. EventBridge utilizza questo ruolo collegato al servizio per creare e archiviare un segreto in Secrets Manager. Per concedere le autorizzazioni necessarie al ruolo collegato al servizio, EventBridge allega la policy al ruolo. AmazonEventBridgeApiDestinationsServiceRolePolicy La policy limita le autorizzazioni concesse solo a quelle necessarie affinché il ruolo interagisca con il segreto della connessione. Non sono incluse altre autorizzazioni e il ruolo può interagire solo con le connessioni presenti nell'account per la gestione del segreto.
Per ulteriori informazioni sui ruoli collegati al servizio, consulta Utilizzo dei ruoli collegati al servizio nella Guida per l'utente IAM.
Intestazioni incluse nelle richieste a destinazioni API
La sezione seguente descrive in dettaglio come EventBridge gestire le intestazioni HTTP nelle richieste alle destinazioni API.
Intestazioni incluse nelle richieste a destinazioni API
Oltre alle intestazioni di autorizzazione definite per la connessione utilizzata per una destinazione API, EventBridge include le seguenti intestazioni in ogni richiesta.
| Chiave intestazione | Valore intestazione |
|---|---|
|
User-Agent |
Amazon/EventBridge/ApiDestinations |
|
Content-Type |
Se non viene specificato alcun Content-Type valore personalizzato, EventBridge include il seguente valore predefinito come: Content-Type application/json; charset=utf-8 |
|
Intervallo |
bytes=0-1048575 |
|
Accept-Encoding |
gzip,deflate |
|
Connessione |
close |
|
Content-Length |
Un'intestazione di entità che indica la dimensione del corpo dell'entità, in byte, inviata al destinatario. |
|
Host |
Un'intestazione di richiesta che specifica l'host e il numero di porta del server a cui viene inviata la richiesta. |
Intestazioni che non possono essere sovrascritte nelle richieste verso destinazioni API
EventBridge non consente di sovrascrivere le seguenti intestazioni:
-
User-Agent
-
Intervallo
Le intestazioni vengono EventBridge rimosse dalle richieste alle destinazioni API
EventBridge rimuove le seguenti intestazioni per tutte le richieste di destinazione API:
-
A-IM
-
Accept-Charset
-
Accept-Datetime
-
Accept-Encoding
-
Cache-Control
-
Connessione
-
Content-Encoding
-
Content-Length
-
Content-MD5
-
Data
-
Expect
-
Forwarded
-
Da
-
Host
-
HTTP2-Settings
-
If-Match
-
If-Modified-Since
-
If-None-Match
-
If-Range
-
If-Unmodified-Since
-
Max-Forwards
-
Origin
-
Pragma
-
Proxy-Authorization
-
Intervallo
-
Referente
-
TE
-
Trailer
-
Transfer-Encoding
-
User-Agent
-
Upgrade
-
Via
-
Attenzione
Codici di errore delle destinazioni API
Quando EventBridge tenta di inviare un evento a una destinazione API e si verifica un errore, EventBridge effettua le seguenti operazioni:
-
Riprova gli eventi associati ai codici di errore
401407,409429, e5xx. -
Non riprova gli eventi associati ai codici di errore
1xx,2xx3xx, e4xx(diversi da quelli indicati sopra).
EventBridge Le destinazioni API leggono l'intestazione standard della risposta HTTP Retry-After per scoprire quanto tempo attendere prima di effettuare una richiesta di follow-up. Per i bus di eventi, EventBridge sceglie il valore più conservativo tra la politica di ripetizione definita e l'intestazione. Retry-After Se Retry-After il valore è negativo, EventBridge interrompe il tentativo di recapito per quell'evento.
Impatto della frequenza di invocazione sulla distribuzione degli eventi
Se imposti la frequenza di invocazione al secondo su un valore molto inferiore al numero di invocazioni generate, gli eventi potrebbero non essere distribuiti entro il tempo di ripetizione di 24 ore per gli eventi. Ad esempio, se imposti la frequenza di invocazione su 10 chiamate al secondo, ma vengono generati migliaia di eventi al secondo, avrai rapidamente un backlog di eventi da distribuire che supera le 24 ore. Per essere certo che nessun evento vada perso, imposta una coda DLQ a cui inviare gli eventi con invocazioni non riuscite in modo da poterli elaborare in un secondo momento. Per ulteriori informazioni, consulta Utilizzo di code di lettere morte per elaborare gli eventi non recapitati in EventBridge.
Disponibilità nelle regioni
Le destinazioni API verso endpoint HTTPS pubblici sono supportate nelle seguenti regioni: AWS
Stati Uniti orientali (Virginia settentrionale)
Stati Uniti orientali (Ohio)
Stati Uniti occidentali (California settentrionale)
Stati Uniti occidentali (Oregon)
Africa (Città del Capo)
Asia Pacifico (Hong Kong)
Asia Pacifico (Tokyo)
Asia Pacifico (Seoul)
Asia Pacifico (Osaka)
Asia Pacifico (Mumbai)
Asia Pacifico (Hyderabad)
Asia Pacifico (Singapore)
Asia Pacifico (Sydney)
Asia Pacifico (Giacarta)
Canada (Centrale)
Cina (Pechino)
Cina (Ningxia)
Europa (Francoforte)
Europa (Zurigo)
Europa (Stoccolma)
Europa (Milano)
Europa (Spagna)
Europa (Irlanda)
Europa (Londra)
Europa (Parigi)
Medio Oriente (Emirati Arabi Uniti)
Medio Oriente (Bahrein)
Sud America (San Paolo)
