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:

• PathParameterValueslistet 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.

• QueryStringParametersstellt die Abfragezeichenfolgenparameter dar, die an den EventBridge aufgerufenen Endpunkt angehängt werden.

• HeaderParametersdefiniert 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 oder X-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 Zurückschalten und Jitter auftreten. Veröffentlicht danach eine EventBridge 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.