View a markdown version of this page

Amazon API Gateway-Ziele für Regeln in Amazon EventBridge - Amazon EventBridge
Dynamische ParameterAufrufwiederholungenZeitüberschreitung

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

Amazon API Gateway können Sie benutzen, um APIs zu erstellen, veröffentlichen, warten und überwachen. 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 Anforderung zugeordnet.

Wichtig

EventBridge unterstützt die Verwendung von API Gateway Edge-optimized 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:

  • Zum Aufrufen einer kundenspezifischen API, die in API Gateway gehostet wird, basierend auf Ereignissen AWS oder Ereignissen von Drittanbietern.

  • 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 die Werte auf, die sequentiell beliebigen Pfadvariablen in Ihrem Endpunkt-ARN entsprechen, z. B. "arn:aws:execute-api:us-east-1:112233445566:myapi/dev/POST/pets/*/*".

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

  • HeaderParameters definiert HTTP-Header, die der Anforderung 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

Wie bei allen Zielen werden einige EventBridge fehlgeschlagene Aufrufe wiederholt. EventBridge Wiederholt für API Gateway Antworten, die mit einem 5xx- oder 429-HTTP-Statuscode gesendet wurden, für bis zu 24 Stunden lang mit exponentiellem Backoff und Jitter. Danach EventBridge veröffentlicht es eine Metrik in Amazon. FailedInvocations CloudWatch EventBridge versucht es nicht erneut mit anderen 4xx-HTTP-Fehlern.

Zeitüberschreitung

EventBridge Regel API Gateway-Anfragen müssen einen maximalen Timeout für die Client-Ausführung von 5 Sekunden haben. Wenn API Gateway länger als 5 Sekunden braucht, um zu antworten, wird das EventBridge Zeitlimit für die Anfrage überschritten und es wird erneut versucht.

EventBridge Pipes API Gateway-Anfragen haben einen maximalen Timeout von 29 Sekunden, was dem API-Gateway-Maximum entspricht.