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.
Amazon API Gateway-Ziele für Regeln in Amazon EventBridge
Sie können Amazon API Gateway zum Erstellen, Veröffentlichen, Verwalten und Überwachen verwendenAPIs. Amazon EventBridge unterstützt das Senden von Ereignissen an einen API Gateway-Endpunkt. Wenn Sie einen API Gateway-Endpunkt als Ziel angeben, wird jedes an das Ziel gesendete Ereignis einer an den Endpunkt gesendeten Anfrage zugeordnet.
Wichtig
EventBridge unterstützt die Verwendung von API Gateway Edge-optimierten und regionalen Endpunkten als Ziele. Private Endpunkte werden derzeit nicht unterstützt. Weitere Informationen zu Endpunkten finden Sie unter https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-api-endpoint-types.html.
Sie können ein API Gateway-Ziel für die folgenden Anwendungsfälle verwenden:
-
Um ein vom Kunden spezifiziertes, in API Gateway API gehostetes Objekt aufzurufen, das auf Ereignissen AWS oder Ereignissen von Drittanbietern basiert.
-
Wenn Sie einen Endpunkt regelmäßig nach einem Zeitplan aufrufen möchten.
Die EventBridge JSON Ereignisinformationen werden als Hauptteil der HTTP Anfrage an Ihren Endpunkt gesendet. Sie können die anderen Anforderungsattribute im HttpParameters
-Feld des Ziels wie folgt angeben:
-
PathParameterValues
listet beispielsweise"arn:aws:execute-api:us-east-1:112233445566:myapi/dev/POST/pets/*/*"
die Werte auf, die sequentiell beliebigen Pfadvariablen in Ihrem Endpunkt ARN entsprechen. -
QueryStringParameters
stellt die Parameter der Abfragezeichenfolge dar, die an den EventBridge aufgerufenen Endpunkt angehängt werden. -
HeaderParameters
definiert HTTP Header, die der Anfrage hinzugefügt werden sollen.
Anmerkung
Aus Sicherheitsgründen sind die folgenden HTTP Header-Schlüssel nicht zulässig:
-
Alles, was mit dem Präfix
X-Amz
oderX-Amzn
versehen ist -
Authorization
-
Connection
-
Content-Encoding
-
Content-Length
-
Host
-
Max-Forwards
-
TE
-
Transfer-Encoding
-
Trailer
-
Upgrade
-
Via
-
WWW-Authenticate
-
X-Forwarded-For
Dynamische Parameter
Wenn Sie ein API Gateway-Ziel aufrufen, können Sie dynamisch Daten zu Ereignissen hinzufügen, die an das Ziel gesendet werden. Weitere Informationen finden Sie unter Zielparameter.
Aufrufwiederholungen
EventBridge Wiederholt, wie bei allen Zielen, einige fehlgeschlagene Aufrufe. Bei API Gateway werden Antworten, EventBridge die mit einem 5xx- oder HTTP 429-Statuscode gesendet wurden, bis zu 24 Stunden lang wiederholt, wobei exponentielles Back-Off und Jitter auftreten.FailedInvocations
Metrik in Amazon CloudWatch. EventBridge wiederholt keine anderen 4xx-FehlerHTTP.
Zeitüberschreitung
EventBridge Regel API Gateway-Anfragen müssen ein maximales Timeout für die Client-Ausführung von 5 Sekunden haben. Wenn API Gateway länger als 5 Sekunden benötigt, um zu antworten, wird das EventBridge Zeitlimit für die Anfrage überschritten und es wird erneut versucht.
EventBridge Pipes API Gateway-Anfragen haben ein maximales Timeout von 29 Sekunden, das API Gateway-Maximum.