Anwendungsfälle für API Gateway

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.

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.

Der folgende Abschnitt mit Anwendungsfällen bietet einen Überblick über die verschiedenen Arten von API-Gateways APIs und die verschiedenen Arten von Entwicklern, die API Gateway verwenden. Ausführlichere Informationen zum Unterschied zwischen REST APIs und HTTP APIs finden Sie unterWählen Sie zwischen REST APIs und HTTP APIs.

Verwenden Sie API Gateway, um REST zu erstellen APIs

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. In API Gateway REST APIs ist das Frontend durch Methodenanfragen und Methodenantworten 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 zu definieren, um die Einrichtung der Textzuweisungsvorlage zu erleichtern.

API Gateway bietet REST-API-Verwaltungsfunktionen wie die folgenden:

Verwenden Sie API Gateway, um HTTP zu erstellen APIs

HTTP APIs ermöglicht es Ihnen, RESTful APIs mit geringerer Latenz und geringeren Kosten als REST zu erstellen APIs.

Sie können HTTP verwenden APIs , 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.

APIs HTTP-Unterstützung OpenID Connect und OAuth 2.0-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.

Verwenden Sie API Gateway zum Erstellen WebSocket APIs

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 verwenden, WebSocket APIs 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:

API Gateway bietet WebSocket API-Verwaltungsfunktionen wie die folgenden:

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 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 beschriebene API Gateway-Konsole verwenden oder die API-Referenzen 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 Darüber hinaus können Sie die API-Erstellung mit AWS CloudFormation Vorlagen oder (im Fall von REST APIs und HTTP APIs) aktivierenOpenAPI-Erweiterungen für API Gateway.

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.

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 Rufen Sie REST APIs im API Gateway auf und Aufrufen WebSocket APIs.