Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
API-Ziele als Ziele in Amazon EventBridge
EventBridge API-Ziele sind HTTPS-Endpunkte, die Sie als Ziel einer Event-Bus-Regel oder -Pipe aufrufen können, ähnlich wie Sie einen AWS Dienst oder eine Ressource als Ziel aufrufen. Mithilfe von API-Zielen können Sie Ereignisse mithilfe von AWS API-Aufrufen zwischen Diensten, integrierten Software-as-a-Service (SaaS) -Anwendungen und öffentlichen oder privaten Anwendungen weiterleiten.
Wenn Sie ein API-Ziel als Regel- oder Pipeziel angeben, EventBridge ruft den HTTPS-Endpunkt für jedes Ereignis auf, das dem in der Regel oder Pipe angegebenen Ereignismuster entspricht, und übermittelt dann die Ereignisinformationen mit der Anforderung. Mit EventBridge können Sie jede HTTP-Methode außer CONNECT und TRACE für die Anfrage verwenden. Die am häufigsten verwendeten HTTP-Methoden sind PUT und POST.
Sie können auch Eingabe-Transformatoren verwenden, um das Ereignis an die Parameter bestimmter HTTP-Endpunktparameter anzupassen. Weitere Informationen finden Sie unter Transformation von EventBridge Amazon-Eingaben.
EventBridge API-Ziele verwenden Verbindungen, um die Autorisierungsmethode sowie die Anmeldeinformationen und die Netzwerkkonnektivität zu definieren, die beim Herstellen einer Verbindung EventBridge zu einem bestimmten HTTPS-Endpunkt verwendet werden sollen. Verbindungen unterstützen sowohl öffentliche als auch private APIs. Weitere Informationen finden Sie unter Verbindungen.
Anmerkung
EventBridge API-Ziele unterstützen derzeit nur öffentliche Domainnamen mit öffentlich vertrauenswürdigen Zertifikaten für HTTPS-Endpunkte, wenn private APIs verwendet werden. API-Ziele unterstützen Mutual TLS (mTLS) nicht.
Wichtig
EventBridge Für Anfragen an einen API-Zielendpunkt muss ein maximales Timeout für die Client-Ausführung von 5 Sekunden gelten. Wenn die Antwort des Zielendpunkts länger als 5 Sekunden dauert, wird das EventBridge Zeitlimit für die Anfrage überschritten. EventBridge wiederholt Anfragen, bei denen das Zeitlimit überschritten wurde, bis zu den Höchstwerten, die in Ihrer Wiederholungsrichtlinie konfiguriert sind.
Bei Event-Bussen liegen die Höchstwerte standardmäßig bei 24 Stunden und 185 Mal.
Bei Rohrleitungen werden bei Wiederholungsversuchen der Quelltyp und die zugehörige Konfiguration bestimmt. EventBridge wiederholt den Vorgang, bis das Ereignis an der Quelle abläuft oder das konfigurierte maximale Mindestalter für Wiederholungsversuche erreicht ist.
Sobald die maximale Anzahl an Wiederholungen erreicht ist, werden Ereignisse an Ihre Warteschlange für unzustellbare Nachrichten gesendet. Andernfalls wird das Ereignis gelöscht.
Das folgende Video zeigt die Verwendung von API-Zielen:
Service-linked Rolle für API-Ziele
Wenn Sie eine Verbindung für ein API-Ziel herstellen, AmazonEventBridgeApiDestinationsServiceRolePolicy wird die mit dem Dienst verknüpfte Rolle Ihrem Konto hinzugefügt. EventBridge verwendet diese dienstverknüpfte Rolle, um ein Geheimnis in Secrets Manager zu erstellen und zu speichern. Hängt die AmazonEventBridgeApiDestinationsServiceRolePolicy Richtlinie an die Rolle an, um der dienstverknüpften EventBridge Rolle die erforderlichen Berechtigungen zu gewähren. Die Richtlinie beschränkt die gewährten Berechtigungen auf diejenigen, die für die Interaktion der Rolle mit dem Secret für die Verbindung erforderlich sind. Es sind keine weiteren Berechtigungen enthalten und die Rolle kann nur mit den Verbindungen in Ihrem Konto interagieren, um das Secret zu verwalten.
Weitere Informationen zu serviceverknüpften Rollen finden Sie unter Verwenden serviceverknüpfter Rollen im IAM-Benutzerhandbuch.
Header in Anforderungen an API-Ziele
Im folgenden Abschnitt wird beschrieben, wie HTTP-Header in Anfragen an API-Ziele EventBridge behandelt werden.
Header, die in Anforderungen an API-Ziele enthalten sind
EventBridge Enthält zusätzlich zu den Autorisierungs-Headern, die für die für ein API-Ziel verwendete Verbindung definiert sind, die folgenden Header in jeder Anfrage.
| Header-Schlüssel | Header-Wert |
|---|---|
|
User-Agent |
Amazon/EventBridge/ApiDestinations |
|
Content-Type |
Wenn kein benutzerdefinierter Content-Type Wert angegeben ist, wird der EventBridge folgende Standardwert wie folgt aufgenommen: Content-Type application/json; Zeichensatz = utf-8 |
|
Range |
bytes=0-1048575 |
|
Accept-Encoding |
gzip,deflate |
|
Connection (Verbindung) |
close |
|
Content-Length |
Ein Entity-Header, der die Größe des entity-body in Byte angibt, der an den Empfänger gesendet wird |
|
Host |
Ein Anforderungsheader, der den Host und die Portnummer des Servers angibt, an den die Anfrage gesendet wird |
Header, die in Anforderungen an API-Ziele nicht überschrieben werden können
EventBridge erlaubt es Ihnen nicht, die folgenden Header zu überschreiben:
-
User-Agent
-
Range
Header EventBridge werden aus Anfragen an API-Ziele entfernt
EventBridge entfernt die folgenden Header für alle API-Zielanfragen:
-
A-IM
-
Accept-Charset
-
Accept-Datetime
-
Accept-Encoding
-
Cache-Control
-
Connection (Verbindung)
-
Content-Encoding
-
Content-Length
-
Content-MD5
-
Date
-
Expect
-
Forwarded
-
From
-
Host
-
HTTP2-Settings
-
If-Match
-
If-Modified-Since
-
If-None-Match
-
If-Range
-
If-Unmodified-Since
-
Max-Forwards
-
Origin
-
Pragma
-
Proxy-Authorization
-
Range
-
Referer
-
TE
-
Trailer
-
Transfer-Encoding
-
User-Agent
-
Upgrade
-
Via
-
Warning
Fehlercodes für das API-Ziel
Wenn EventBridge versucht wird, ein Ereignis an ein API-Ziel zu senden und ein Fehler EventBridge auftritt, gehen Sie wie folgt vor:
-
Wiederholt Ereignisse, die den Fehlercodes
401,407409429, und5xxzugeordnet sind. -
Wiederholt keine Ereignisse, die mit den Fehlercodes
1xx,2xx3xx, und verknüpft sind4xx(mit Ausnahme der oben genannten).
EventBridge API-Ziele lesen den Standard-HTTP-Antwort-HeaderRetry-After, um herauszufinden, wie lange gewartet werden muss, bevor eine Folgeanfrage gestellt wird. EventBridgeWählt für Event-Busse den konservativeren Wert zwischen der definierten Wiederholungsrichtlinie und dem Retry-After Header. Wenn der Retry-After Wert negativ ist, wird die erneute Übermittlung für dieses Ereignis EventBridge beendet.
Wie wirkt sich die Aufrufrate auf die Ereigniszustellung aus
Wenn Sie die Aufrufrate pro Sekunde auf einen Wert festlegen, der deutlich unter der Anzahl der generierten Aufrufe liegt, werden Ereignisse möglicherweise nicht innerhalb der 24-stündigen Wiederholungszeit für Ereignisse zugestellt. Wenn Sie beispielsweise die Aufrufrate auf 10 Aufrufe pro Sekunde festlegen, aber Tausende von Ereignissen pro Sekunde generiert werden, entsteht schnell ein Backlog an zuzustellenden Ereignissen, der 24 Stunden überschreitet. Wenn Sie sicherstellen möchten, dass keine Ereignisse verloren gehen, richten Sie eine Warteschlange für unzustellbare Nachrichten ein, an die Ereignisse mit fehlgeschlagenen Aufrufen gesendet werden, sodass Sie die Ereignisse zu einem späteren Zeitpunkt verarbeiten können. Weitere Informationen finden Sie unter Verwenden Sie Warteschlangen, in denen noch nicht zugestellt wurde, um Ereignisse zu verarbeiten, die nicht zugestellt wurden EventBridge.
Verfügbarkeit in Regionen
API-Ziele für öffentliche HTTPS-Endpunkte werden in den folgenden AWS Regionen unterstützt:
USA Ost (Nord-Virginia)
USA Ost (Ohio)
USA West (Nordkalifornien)
USA West (Oregon)
Africa (Cape Town)
Asien-Pazifik (Hongkong)
Asien-Pazifik (Tokio)
Asien-Pazifik (Seoul)
Asien-Pazifik (Osaka)
Asien-Pazifik (Mumbai)
Asien-Pazifik (Hyderabad)
Asien-Pazifik (Singapur)
Asien-Pazifik (Sydney)
Asien-Pazifik (Jakarta)
Kanada (Zentral)
China (Peking)
China (Ningxia)
Europa (Frankfurt)
Europa (Zürich)
Europa (Stockholm)
Europa (Milan)
Europa (Spain)
Europa (Irland)
Europa (London)
Europa (Paris)
Naher Osten (VAE)
Middle East (Bahrain)
Südamerika (São Paulo)
