

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 Gateway-Ziele für Regeln in Amazon EventBridge
<a name="eb-api-gateway-target"></a>

Sie können Amazon API Gateway zum Erstellen, Veröffentlichen, Verwalten und Überwachen verwenden APIs. Amazon EventBridge unterstützt das Senden von Ereignissen an einen API-Gateway-Endpunkt. Wenn Sie einen API-Gateway-Endpunkt als [Ziel](eb-targets.md) angeben, wird jedes an das Ziel gesendete [Ereignis](eb-events.md) einer an den Endpunkt gesendeten Anforderung 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](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 eine vom Kunden angegebene API aufzurufen, die in API Gateway gehostet wird und auf AWS 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 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/*/*"`.
+ `QueryStringParameters`stellt die Parameter der Abfragezeichenfolge 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
<a name="eb-targets-apigateway-dynamic"></a>

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](eb-targets.md#targets-specific-parms).

## Aufrufwiederholungen
<a name="eb-targets-apigateway-retries"></a>

 EventBridge Wiederholt, wie bei allen Zielen, einige fehlgeschlagene Aufrufe. Für API Gateway werden Antworten, EventBridge die mit einem 5xx- oder 429-HTTP-Statuscode gesendet wurden, bis zu 24 Stunden lang wiederholt, wobei [exponentielles Back-Off](https://aws.amazon.com/blogs/architecture/exponential-backoff-and-jitter/) und Jitter auftreten. Veröffentlicht danach eine EventBridge `FailedInvocations` Metrik in Amazon CloudWatch. EventBridge wiederholt keine anderen 4xx-HTTP-Fehler.

## Zeitüberschreitung
<a name="eb-targets-apigateway-timeout"></a>

EventBridge Regel API Gateway Gateway-Anfragen müssen ein maximales Client-Ausführungstimeout von 5 Sekunden haben. Wenn die Antwort von API Gateway länger als 5 Sekunden dauert, wird das EventBridge Zeitlimit für die Anfrage überschritten und es wird erneut versucht.

EventBridge Pipes API Gateway Gateway-Anfragen haben ein maximales Timeout von 29 Sekunden, das API-Gateway-Maximum.