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. # Anwendungsfälle für API Gateway Der folgende Abschnitt mit Anwendungsfällen bietet einen Überblick über die verschiedenen Arten von API-Gateway-APIs und Entwickler, die API Gateway verwenden. Detailinformationen zu den Unterschieden zwischen REST-APIs und HTTP-APIs finden Sie unter [Wählen Sie zwischen REST APIs und HTTP APIs](http-api-vs-rest.md). **Topics** + [API Gateway zur Erstellung von REST-APIs verwenden](#api-gateway-overview-rest) + [API Gateway zur Erstellung von HTTP-APIs verwenden](#api-gateway-overview-http) + [Verwenden Sie API Gateway, um WebSocket APIs zu erstellen](#api-gateway-overview-websocket) + [Von wem wird API Gateway verwendet?](#apigateway-who-uses-api-gateway) ## API Gateway zur Erstellung von REST-APIs verwenden Eine API Gateway-REST-API setzt sich aus Ressourcen und Methoden zusammen. Eine Ressource ist eine logische Entität, auf die eine App über einen Ressourcenpfad zugreifen kann. Eine Methode entspricht einer REST-API-Anforderung, die vom API-Benutzer übermittelt wird, und der Antwort, die an den Benutzer zurückgegeben wird. So könnte beispielsweise `/incomes` der Pfad der Ressource sein, die das Einkommen des App-Benutzers angibt. Eine Ressource kann für eine oder mehrere Operationen verwendet werden, die durch geeignete HTTP-Verben wie GET, POST, PUT, PATCH und DELETE definiert sind. Eine Kombination aus einem Ressourcenpfad und einer Operation identifiziert eine Methode der API. Die Methode `POST /incomes` beispielsweise könnte das Einkommen des Aufrufers hinzufügen, und die Methode `GET /expenses` könnte die vom Aufrufer angegebenen Ausgaben abfragen. Die App benötigt keine Informationen dazu, wo auf dem Backend die angeforderten Daten gespeichert und abgerufen werden. Bei API Gateway-REST-APIs wird das Frontend durch *Methoden-Anfragen* und *Methoden-Antworten* gekapselt. Die API arbeitet über *Integrationsanforderungen* und *Integrationsantworten* mit dem Backend zusammen. Wenn beispielsweise DynamoDB das Backend bildet, richtet der API-Entwickler die Integrationsanforderung so ein, dass die eingehende Methodenanforderung an das gewählte Backend weitergeleitet wird. Die Konfiguration umfasst Spezifikationen für eine geeignete DynamoDB-Aktion, eine erforderliche IAM-Rolle sowie -Richtlinien und die erforderlichen Eingabedaten. Das Backend gibt das Ergebnis als Integrationsantwort an API Gateway zurück. Um die Integrationsantwort auf eine geeignete Methodenantwort (eines HTTP-Statuscodes) an den Client weiterzuleiten, können Sie die Integrationsantwort so konfigurieren, dass die erforderlichen Antwortparameter von der Integration der Methode zugewiesen werden. Falls erforderlich, übertragen Sie anschließend das Backend-Ausgabedatenformat in das für das Frontend erforderliche Format. API Gateway bietet die Möglichkeit, ein Schema oder Modell für die [Nutzlast](https://en.wikipedia.org/wiki/Payload_(computing)) zu definieren, um die Einrichtung der Textzuweisungsvorlage zu erleichtern. API Gateway bietet REST-API-Verwaltungsfunktionen wie die folgenden: + Unterstützung für die Generierung von SDKs und die Erstellung einer API-Dokumentation mit API Gateway-Erweiterungen für OpenAPI + Drosselung von HTTP-Anforderungen ## API Gateway zur Erstellung von HTTP-APIs verwenden Mit HTTP-APIs können Sie REST-fähige APIs mit geringerer Latenzzeit und zu geringeren Kosten als REST-APIs erstellen. Sie können HTTP-APIs verwenden, um Anfragen an AWS Lambda Funktionen oder an jeden öffentlich routbaren HTTP-Endpunkt zu senden. Beispielsweise können Sie eine HTTP-API erstellen, die in eine Lambda-Funktion auf dem Backend integriert wird. Wenn ein Client Ihre API aufruft, sendet API Gateway die Anfrage an die Lambda-Funktion und gibt die Antwort der Funktion an den Client zurück. HTTP-APIs unterstützen die [OpenID Connect](https://openid.net/developers/how-connect-works/)- und [OAuth 2.0](https://oauth.net/2/)-Autorisierung. Sie verfügen über integrierten Support für Cross-Origin Resource Sharing (CORS) und automatische Bereitstellungen. Weitere Informationen hierzu finden Sie unter [Wählen Sie zwischen REST APIs und HTTP APIs](http-api-vs-rest.md). ## Verwenden Sie API Gateway, um WebSocket APIs zu erstellen In einer WebSocket API können sowohl der Client als auch der Server jederzeit Nachrichten aneinander senden. Backend-Server können problemlos Daten an verbundene Benutzer und Geräte übertragen, ohne komplexe Abfragemechanismen implementieren zu müssen. Sie könnten beispielsweise mithilfe einer WebSocket API Gateway eine serverlose Anwendung erstellen und Nachrichten AWS Lambda an und von einzelnen Benutzern oder Benutzergruppen in einem Chatroom senden und empfangen. Oder Sie könnten Back-End-Dienste wie AWS Lambda Amazon Kinesis oder einen HTTP-Endpunkt aufrufen, der auf Nachrichteninhalten basiert. Sie können API Gateway WebSocket Gateway-APIs verwenden, um sichere Kommunikationsanwendungen in Echtzeit zu erstellen, ohne Server zur Verwaltung von Verbindungen oder umfangreichem Datenaustausch bereitstellen oder verwalten zu müssen. Zu vorgesehenen Anwendungsfällen gehören Echtzeit-Anwendungen wie die folgenden: + Chat-Anwendungen + Real-time Dashboards wie Börsenticker + Real-time Warnmeldungen und Benachrichtigungen API Gateway bietet WebSocket API-Verwaltungsfunktionen wie die folgenden: + Überwachung und Drosselung von Verbindungen und Nachrichten + Wird verwendet AWS X-Ray , um Nachrichten auf ihrem Weg durch die APIs zu Back-End-Diensten zu verfolgen + Einfache Integration mit Endpunkten HTTP/HTTPS ## Von wem wird API Gateway verwendet? Es gibt zwei Arten von Entwicklern, die API Gateway verwenden: API-Entwickler und Anwendungsentwickler. Ein API-Entwickler erstellt eine API und stellt sie bereit, um die erforderliche Funktionalität in API Gateway zu aktivieren. Der API-Entwickler muss ein Benutzer des AWS Kontos sein, dem die API gehört. Ein App-Entwickler erstellt eine funktionierende Anwendung zum Aufrufen von AWS Diensten, indem er eine WebSocket oder eine von einem API-Entwickler erstellte REST-API in API Gateway aufruft. Der App-Entwickler ist der Kunde des API-Entwicklers. Der App-Entwickler benötigt kein AWS Konto, vorausgesetzt, die API benötigt entweder keine IAM-Berechtigungen oder unterstützt die Autorisierung von Benutzern über externe Federated Identity Provider, die von [Amazon Cognito User Pool](https://docs.aws.amazon.com/cognito/latest/developerguide/) Identity Federation unterstützt werden. Zu diesen Identitätsanbietern gehören Amazon, Amazon Cognito-Benutzerpools, Facebook und Google. ### API Gateway-API erstellen und verwalten Ein API-Entwickler arbeitet mit der API Gateway-Service-Komponente für die API-Verwaltung (`apigateway`), um eine API zu erstellen, zu konfigurieren und bereitzustellen. Als API-Entwickler können Sie eine API erstellen und verwalten, indem Sie die unter [Erste Schritte mit API-Gateway](getting-started.md) beschriebene API Gateway-Konsole verwenden oder die [API-Referenzen](api-ref.md) aufrufen. Es gibt mehrere Möglichkeiten, diese API aufzurufen. Dazu gehören die Verwendung von AWS Command Line Interface (AWS CLI) oder die Verwendung eines SDK. AWS Außerdem ist die API-Erstellung auch mittels [AWS CloudFormation -Vorlagen](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-reference.html) oder (im Falle von REST- und HTTP-APIs) [OpenAPI-Erweiterungen für API Gateway](api-gateway-swagger-extensions.md) möglich. Eine Liste der Regionen, in denen API Gateway verfügbar ist, sowie der zugehörigen Kontrolldienstendpunkte finden Sie unter [Amazon API Gateway-Endpunkte und -Kontingente](https://docs.aws.amazon.com/general/latest/gr/apigateway.html). ### API Gateway-API aufrufen Ein Anwendungsentwickler arbeitet mit der API Gateway Service-Komponente für die API-Ausführung (`execute-api`), um eine API aufzurufen, die in API Gateway erstellt oder bereitgestellt wurde. Die zugrunde liegenden Programmierentitäten werden von der erstellten API bereitgestellt. Es gibt mehrere Methoden für den Aufruf einer solchen API. Weitere Informationen hierzu finden Sie unter [Aufrufen von REST-APIs in API Gateway](how-to-call-api.md) und [Aufrufen WebSocket APIs](apigateway-how-to-call-websocket-api.md).