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.
# Was ist Amazon API Gateway?
Amazon API Gateway ist ein AWS Service für die Erstellung, Veröffentlichung, Wartung, Überwachung und Sicherung von REST, HTTP und WebSocket APIs in jeder Größenordnung. API-Entwickler können APIs diesen Zugriff AWS oder andere Webdienste sowie in der [AWS Cloud](https://aws.amazon.com/what-is-cloud-computing/) gespeicherte Daten erstellen. Als API Gateway API-Entwickler können Sie API-Anwendungen APIs für die Verwendung in Ihren eigenen Client-Anwendungen erstellen. Oder Sie können Ihre App Entwicklern von Drittanbietern APIs zur Verfügung stellen. Weitere Informationen finden Sie unter [Von wem wird API Gateway verwendet?](api-gateway-overview-developer-experience.md#apigateway-who-uses-api-gateway).
API Gateway erstellt RESTful APIs das:
+ HTTP-basiert sind
+ Die zustandslose Client-Server-Kommunikation aktivieren.
+ HTTP-Standardmethoden wie GET, POST, PUT, PATCH und DELETE implementieren.
Weitere Informationen zu API Gateway REST APIs und HTTP finden Sie unter APIs [Wählen Sie zwischen REST APIs und HTTP APIs](http-api-vs-rest.md)[API-Gateway-HTTP-APIs](http-api.md),[Verwenden Sie API Gateway, um REST zu erstellen APIs](api-gateway-overview-developer-experience.md#api-gateway-overview-rest), und[Entwickeln Sie REST APIs in API Gateway](rest-api-develop.md).
API Gateway erstellt WebSocket APIs das:
+ Halten Sie sich an das [WebSocket](https://datatracker.ietf.org/doc/html/rfc6455)Protokoll, das eine statusbehaftete Vollduplex-Kommunikation zwischen Client und Server ermöglicht.
+ eingehende Nachrichten basierend auf dem Inhalt der Nachricht weiterleiten.
Weitere Informationen zu API Gateway WebSocket APIs finden Sie unter [Verwenden Sie API Gateway zum Erstellen WebSocket APIs](api-gateway-overview-developer-experience.md#api-gateway-overview-websocket) und[Überblick über WebSocket APIs in API Gateway](apigateway-websocket-api-overview.md).
**Topics**
+ [Architektur von API Gateway](#api-gateway-overview-aws-backbone)
+ [Funktionen von API Gateway](#api-gateway-overview-features)
+ [Anwendungsfälle für API Gateway](api-gateway-overview-developer-experience.md)
+ [Auf API Gateway zugreifen](#introduction-accessing-apigateway)
+ [Teil der AWS serverlosen Infrastruktur](#api-gateway-overview-a-serverless-pillar)
+ [So steigen Sie in Amazon API Gateway ein:](#welcome-how-to-get-started)
+ [Amazon API Gateway-Konzepte](api-gateway-basic-concept.md)
+ [Wählen Sie zwischen REST APIs und HTTP APIs](http-api-vs-rest.md)
+ [Erste Schritte mit der REST-API-Konsole](getting-started-rest-new-console.md)
## Architektur von API Gateway
Das folgende Diagramm zeigt die API Gateway-Architektur.
![\[API Gateway-Architekturdiagramm\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/Product-Page-Diagram_Amazon-API-Gateway-How-Works.png)
Dieses Diagramm zeigt, wie das, APIs was Sie in Amazon API Gateway erstellen, Ihnen oder Ihren Entwicklerkunden ein integriertes und konsistentes Entwicklererlebnis für die Erstellung AWS serverloser Anwendungen bietet. API Gateway handhabt sämtliche Aufgaben im Zusammenhang mit der Annahme und Verarbeitung von Hunderttausenden gleichzeitiger API-Aufrufe. Zu diesen Aufgaben gehören die Verwaltung des Datenverkehrs, Autorisierung und Zugriffskontrolle, Überwachung und Verwaltung der API-Version.
API Gateway fungiert als „Eingangstür“ für Anwendungen, die auf Daten, Geschäftslogik oder Funktionen aus Ihren Backend-Services zugreifen können, z. B. Workloads, die auf Amazon Elastic Compute Cloud (Amazon EC2) ausgeführt werden, Code, der auf beliebigen Webanwendungen ausgeführt wird AWS Lambda, oder Echtzeitkommunikationsanwendungen.
## Funktionen von API Gateway
Amazon API Gateway bietet zum Beispiel die folgenden Funktionen:
+ Support für stateful ([WebSocket](apigateway-websocket-api.md)) und stateless ([HTTP](http-api.md) und [REST](apigateway-rest-api.md)). APIs
+ Leistungsstarke, flexible [Authentifizierungsmechanismen](apigateway-control-access-to-api.md) wie AWS Identity and Access Management Richtlinien, Lambda-Autorisierungsfunktionen und Amazon Cognito Cognito-Benutzerpools.
+ [Canary-Release-Bereitstellungen](canary-release.md) für sichere fortlaufende Änderungen
+ [CloudTrail](cloudtrail.md)-Protokollierung und -Überwachung von API-Nutzung und API-Änderungen
+ CloudWatch Zugriffs- und Ausführungsprotokollierung, einschließlich der Möglichkeit, Alarme einzustellen. Weitere Informationen erhalten Sie unter [Überwachen Sie die REST-API-Ausführung mit CloudWatch Amazon-Metriken](monitoring-cloudwatch.md) und [Überwachen Sie die WebSocket API-Ausführung mit CloudWatch Metriken](apigateway-websocket-api-logging.md).
+ Möglichkeit, CloudFormation Vorlagen zu verwenden, um die API-Erstellung zu ermöglichen. Weitere Informationen finden Sie unter [Referenz der Amazon API Gateway-Ressourcentypen](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/AWS_ApiGateway.html) und [Referenz der Amazon API Gateway V2-Ressourcentypen](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/AWS_ApiGatewayV2.html).
+ Unterstützung [benutzerdefinierter Domänennamen](how-to-custom-domains.md)
+ Integration mit [AWS WAF](apigateway-control-access-aws-waf.md)zum Schutz APIs vor gängigen Web-Exploits.
+ [AWS X-Ray](apigateway-xray.md)-Integration für ein besseres Verständnis und die Analyse leistungsbezogener Latenzen
Eine vollständige Liste der API Gateway-Funktionsversionen finden Sie unter [Dokumentverlauf](history.md).
# Anwendungsfälle für API Gateway
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 unter[Wählen Sie zwischen REST APIs und HTTP APIs](http-api-vs-rest.md).
**Topics**
+ [Verwenden Sie API Gateway, um REST zu erstellen APIs](#api-gateway-overview-rest)
+ [Verwenden Sie API Gateway, um HTTP zu erstellen APIs](#api-gateway-overview-http)
+ [Verwenden Sie API Gateway zum Erstellen WebSocket APIs](#api-gateway-overview-websocket)
+ [Von wem wird API Gateway verwendet?](#apigateway-who-uses-api-gateway)
## 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](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:
+ Support für die Generierung SDKs und Erstellung von API-Dokumentation mithilfe von API Gateway Gateway-Erweiterungen für OpenAPI
+ Drosselung von HTTP-Anforderungen
## 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](https://openid.net/developers/how-connect-works/) und [OAuth 2.0-Autorisierung](https://oauth.net/2/). 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 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:
+ Chat-Anwendungen
+ Echtzeit-Dashboards, wie z. B. Aktienticker
+ Echtzeit-Warnungen 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 Backend-Dienste 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 Darüber hinaus können Sie die API-Erstellung mit [AWS CloudFormation Vorlagen](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-reference.html) oder (im Fall von REST APIs und HTTP APIs) aktivieren[OpenAPI-Erweiterungen für API Gateway](api-gateway-swagger-extensions.md).
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).
## Auf API Gateway zugreifen
Sie können wie folgt auf Amazon API Gateway zugreifen:
+ **AWS-Managementkonsole**— Das AWS-Managementkonsole bietet eine Weboberfläche zum Erstellen und Verwalten APIs. Nachdem Sie die Schritte unter [Einrichten der API Gateway](setting-up.md) ausgeführt haben, können Sie unter [https://console.aws.amazon.com/apigateway](https://console.aws.amazon.com/apigateway) auf die API-Gateway-Konsole zugreifen.
+ **AWS SDKs**— Wenn Sie eine Programmiersprache verwenden, die ein SDK für AWS bereitstellt, können Sie ein SDK für den Zugriff auf API Gateway verwenden. SDKs Vereinfachen Sie die Authentifizierung, lassen Sie sich problemlos in Ihre Entwicklungsumgebung integrieren und bieten Sie Zugriff auf API Gateway Gateway-Befehle. Weitere Informationen finden Sie unter [Tools für Amazon Web Services](https://aws.amazon.com/developer/tools/).
+ **API Gateway V1 und V2 APIs** — Wenn Sie eine Programmiersprache verwenden, für die kein SDK verfügbar ist, lesen Sie die [Amazon API Gateway Version 1 API-Referenz](https://docs.aws.amazon.com/apigateway/latest/api/API_Operations.html) und [Amazon API Gateway Version 2 API-Referenz](https://docs.aws.amazon.com/apigatewayv2/latest/api-reference/api-reference.html).
+ **AWS Command Line Interface** – Weitere Informationen finden Sie unter [Einrichtung der AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/) im *AWS Command Line Interface -Benutzerhandbuch*.
+ **AWS Tools for Windows PowerShell** – Weitere Informationen finden Sie unter [Einrichten von AWS Tools for Windows PowerShell](https://docs.aws.amazon.com/powershell/latest/userguide/) im *AWS -Tools für PowerShell Benutzerhandbuch*.
## Teil der AWS serverlosen Infrastruktur
Zusammen mit [AWS Lambda](https://docs.aws.amazon.com/lambda/latest/dg/)API Gateway bildet das API Gateway den anwendungsorientierten Teil der AWS serverlosen Infrastruktur. Weitere Informationen zu den ersten Schritten mit Serverless-Technologie finden Sie im [Serverless-Entwicklerhandbuch](https://docs.aws.amazon.com/serverless/latest/devguide/welcome.html).
Damit eine App öffentlich verfügbare AWS Dienste aufruft, können Sie Lambda verwenden, um mit den erforderlichen Diensten zu interagieren und Lambda-Funktionen über API-Methoden in API Gateway verfügbar zu machen. AWS Lambda führt Ihren Code auf einer hochverfügbaren Computerinfrastruktur aus. Es übernimmt die erforderliche Ausführung und Verwaltung der Datenverarbeitungsressourcen. Um serverlose Anwendungen zu ermöglichen, unterstützt API Gateway [optimierte Proxyintegrationen](api-gateway-set-up-simple-proxy.md) mit AWS Lambda und HTTP-Endpunkten.
## So steigen Sie in Amazon API Gateway ein:
Eine Einführung in Amazon API Gateway finden Sie in den folgenden Themen:
+ [Erste Schritte mit API-Gateway](getting-started.md), worin Sie eine Anleitung zum Erstellen einer HTTP-API erhalten.
+ [Serverless Land](https://serverlessland.com/video?tag=Amazon%20API%20Gateway), das Lehrvideos bietet.
+ [Happy Little API Shorts](https://www.youtube.com/playlist?list=PLJo-rJlep0EDFw7t0-IBHffVYKcPMDXHY), eine Reihe kurzer Lehrvideos.
# Amazon API Gateway-Konzepte
Im folgenden Abschnitt werden einführende Konzepte für die Verwendung von API Gateway beschrieben.
**API Gateway**
API Gateway ist ein AWS Dienst, der Folgendes unterstützt:
+ Erstellen, Bereitstellen und Verwalten einer [RESTful](https://en.wikipedia.org/wiki/Representational_state_transfer)Anwendungsprogrammierschnittstelle (API) zur Bereitstellung von HTTP-Endpunkten, AWS Lambda -Funktionen oder anderen AWS Diensten im Backend.
+ Erstellen, Bereitstellen und Verwalten einer [WebSocket](https://datatracker.ietf.org/doc/html/rfc6455)API zur Bereitstellung von AWS Lambda Funktionen oder anderen AWS Diensten.
+ Aufrufen von exponierten API-Methoden über das Frontend-HTTP und WebSocket die Endpunkte.
**API Gateway-REST-API**
Eine Sammlung von HTTP-Ressourcen und -Methoden, die in Backend-HTTP-Endpunkte, Lambda-Funktionen oder andere Dienste integriert sind. AWS Sie können diese Sammlung in einer oder mehreren Stufen bereitstellen. In der Regel werden API-Ressourcen in einer Ressourcenstruktur organisiert, die der Anwendungslogik entspricht. Jede API-Ressource kann eine oder mehrere API-Methoden offenlegen, die eindeutige HTTP-Verben haben, die von API Gateway unterstützt werden. Weitere Informationen finden Sie unter [Wählen Sie zwischen REST APIs und HTTP APIs](http-api-vs-rest.md).
**API Gateway-HTTP-API**
Eine Sammlung von Routen und Methoden, die mit Backend-HTTP-Endpunkten oder Lambda-Funktionen integriert sind. Sie können diese Sammlung in einer oder mehreren Stufen bereitstellen. Jede Route kann eine oder mehrere API-Methoden bereitstellen, die eindeutige HTTP-Verben haben, die von API Gateway unterstützt werden. Weitere Informationen finden Sie unter [Wählen Sie zwischen REST APIs und HTTP APIs](http-api-vs-rest.md).
** WebSocket API-Gateway-API**
Eine Sammlung von WebSocket Routen und Routenschlüsseln, die in Backend-HTTP-Endpunkte, Lambda-Funktionen oder andere Dienste integriert sind. AWS Sie können diese Sammlung in einer oder mehreren Stufen bereitstellen. API-Methoden werden über WebSocket Frontend-Verbindungen aufgerufen, die Sie einem registrierten benutzerdefinierten Domainnamen zuordnen können.
**API-Bereitstellung**
Eine point-in-time Momentaufnahme Ihrer API-Gateway-API. Damit eine Bereitstellung von einem Client verwendet werden kann, muss sie mindestens einer API-Stufe zugeordnet sein.
**API-Developer**
Ihr AWS Konto, dem eine API Gateway Gateway-Bereitstellung gehört (z. B. ein Dienstanbieter, der auch programmatischen Zugriff unterstützt).
**API-Endpunkt**
Ein Hostname für eine API in API Gateway, die in einer bestimmten Region bereitgestellt wird. Der Hostname hat das Format `{api-id}.execute-api.{region}.amazonaws.com`. Die folgenden Arten von API-Endpunkten werden unterstützt:
+ [Edge-optimierter API-Endpunkt](#apigateway-definition-edge-optimized-api-endpoint)
+ [Privater API-Endpunkt](#apigateway-definition-private-api-endpoint)
+ [Regionaler API-Endpunkt](#apigateway-definition-regional-api-endpoint)
**API-Schlüssel**
Eine alphanumerische Zeichenfolge, die API Gateway verwendet, um einen App-Entwickler zu identifizieren, der Ihre REST oder WebSocket API verwendet. API Gateway kann API-Schlüssel für Sie erstellen. Alternativ können Sie Schlüssel aus einer CSV-Datei importieren. Sie können API-Schlüssel zusammen mit [Lambda-Autorisierern](apigateway-use-lambda-authorizer.md) oder [Nutzungsplänen](api-gateway-api-usage-plans.md) verwenden, um den Zugriff auf Ihre zu kontrollieren. APIs
Siehe [API-Endpunkte](#apigateway-definition-api-endpoints).
**API-Eigentümer**
Siehe [API-Developer](#apigateway-definition-api-developer).
**API-Stufe**
Ein logischer Verweis auf einen Lebenszyklusstatus Ihres API (z. B. "dev", "prod", "Beta", "v2"). API-Stufen werden mit API-ID und Stufenname bezeichnet.
**App-Developer**
Ein App-Ersteller, der möglicherweise über ein AWS Konto verfügt oder auch nicht und mit der API interagiert, die Sie als API-Entwickler bereitgestellt haben. App-Developer sind Ihre Kunden. Ein App-Developer wird in der Regel durch einen [API-Schlüssel](#apigateway-definition-api-key) identifiziert.
**Rückruf-URL**
Wenn mit einem neuen Client über eine WebSocket Verbindung verbunden wird, können Sie eine Integration in API Gateway aufrufen, um die Callback-URL des Clients zu speichern. Sie können diese Rückruf-URL dann zum Senden von Nachrichten vom Backend-System zum Client verwenden.
**Entwicklerportal**
Eine Anwendung, mit der API-Anbieter ihre APIs und ihre API-Dokumentation an API-Nutzer weitergeben können. APIs sind in Produkte gruppiert, bei denen es sich um eine Sammlung von REST-API-Endpunkten, API-Dokumentation und ergänzender Produktdokumentation handelt.
Siehe [API Gateway Gateway-Portale](apigateway-portals.md).
**Edge-optimierter API-Endpunkt**
Der Standard-Hostname einer API-Gateway-API, die in der angegebenen Region bereitgestellt wird und dabei eine CloudFront Distribution verwendet, um den Client-Zugriff in der Regel aus verschiedenen AWS Regionen zu erleichtern. API-Anfragen werden an den nächstgelegenen CloudFront Point of Presence (POP) weitergeleitet, was in der Regel die Verbindungszeit für geografisch unterschiedliche Clients verbessert.
Siehe [API-Endpunkte](#apigateway-definition-api-endpoints).
**Integrationsanforderung**
Die interne Schnittstelle einer WebSocket API-Route oder REST-API-Methode in API Gateway, in der Sie den Hauptteil einer Routenanforderung oder die Parameter und den Hauptteil einer Methodenanforderung den vom Backend benötigten Formaten zuordnen.
**Integrationsantwort**
Die interne Schnittstelle einer WebSocket API-Route oder REST-API-Methode in API Gateway, in der Sie die vom Backend empfangenen Statuscodes, Header und Nutzdaten dem Antwortformat zuordnen, das an eine Client-App zurückgegeben wird.
**Zuweisungsvorlage**
Ein Skript in [Velocity Template Language (VTL)](https://velocity.apache.org/engine/devel/vtl-reference.html), mit dem der Anforderungstext im Frontend-Datenformat in das Backend-Datenformat konvertiert wird oder mit dem der Antworttext aus dem Backend-Datenformat in das Frontend-Datenformat konvertiert wird. Zuweisungsvorlagen können in der Integrationsanforderung oder in der Integrationsantwort angegeben werden. Sie können auf Daten verweisen, die zur Laufzeit als Kontext- und Stufenvariablen zur Verfügung gestellt werden.
Die Zuordnung kann so einfach wie eine [Identitätstransformation](https://en.wikipedia.org/wiki/Identity_transform) sein, mit der für eine Anforderung Header oder Text unverändert durch die Integration vom Client an das Backend übergeben werden. Das Gleiche gilt für eine Antwort, in der die Nutzlast vom Backend an den Client übergeben wird.
**Methodenanforderung**
Die öffentliche Schnittstelle einer API-Methode in API Gateway, die die Parameter und den Text vorgibt, die ein App-Entwickler in Anfragen senden muss, um über die API auf das Backend zugreifen zu können.
**Methodenantwort**
Die öffentliche Schnittstelle einer REST-API, die Statuscodes, Header und Textmodelle vorgibt, die ein App-Developer in Antworten von der API erwarten sollte.
**Pseudointegration**
Bei einer Mock-Integration werden API-Antworten direkt von API Gateway generiert, ohne dass ein Integrations-Backend erforderlich ist. Als API-Entwickler entscheiden Sie, wie API Gateway auf eine Mock-Integrationsanfrage antwortet. Dazu konfigurieren Sie die Integrationsanforderung und -antwort der Methode, um einer Antwort einen bestimmten Statuscode zuzuweisen.
**Model**
Ein Datenschema, das die Datenstruktur einer Anforderungs- oder Antwortnutzlast angibt. Ein Modell ist erforderlich, um ein stark typisiertes SDK einer API zu generieren. Es wird auch zur Validierung der Nutzlast verwendet. Ein Modell bietet praktische Vorteile, da eine Beispiel-Zuweisungsvorlage generiert wird, über die eine Produktionszuweisungsvorlage initiiert werden kann. Für die Erstellung einer Zuweisungsvorlage ist ein Modell zwar hilfreich, aber nicht erforderlich.
**Portal**
[Siehe Entwicklerportal.](#apigateway-definition-developer-portal)
**Portal-Produkt**
Ein Service oder eine Funktion, die Sie teilen möchten. Ihr Portalprodukt ist eine Sammlung von REST-Produktendpunkten und Produktseiten. Produkt-REST-Endpunkte sind die Zugriffspunkte zu Ihrem Portalprodukt. Sie bestehen aus dem Pfad und der Methode einer REST-API sowie der Phase, in der sie bereitgestellt wird. Bei Produktseiten handelt es sich um eine Dokumentation, die Sie bereitstellen, um zu erklären, wie API-Nutzer Ihre Produktendpunkte verwenden können. Sie können Produkte AWS kontenübergreifend teilen, um sie zu Portalen hinzuzufügen.
Weitere Informationen finden [Sie unter Produkt erstellen](apigateway-portals-create-portal-product.md).
**Private API**
Siehe [Privater API-Endpunkt](#apigateway-definition-private-api).
**Privater API-Endpunkt**
Ein API-Endpunkt, der über Schnittstellen-VPC-Endpunkte bereitgestellt wird und einem Client den sicheren Zugriff auf private API-Ressourcen innerhalb einer VPC ermöglicht. Private APIs sind vom öffentlichen Internet isoliert und können nur über VPC-Endpunkte für API Gateway abgerufen werden, denen Zugriff gewährt wurde.
**Private Integration**
Ein API Gateway-Integrationstyp für einen Client zum Zugriff auf Ressourcen in der VPC eines Kunden über einen privaten REST-API-Endpunkt, ohne die Ressourcen im öffentlichen Internet offenzulegen.
**Proxy-Integration**
Eine vereinfachte API Gateway-Integrationskonfiguration. Sie können eine Proxy-Integration als HTTP-Proxy-Integration oder als Lambda-Proxy-Integration einrichten.
Bei einer HTTP-Proxy-Integration leitet API Gateway die gesamte Anfrage und Antwort zwischen dem Frontend und einem HTTP-Backend weiter. Bei der Lambda-Proxy-Integration sendet API Gateway die gesamte Anfrage als Eingabe an eine Lambda-Funktion im Backend. API Gateway wandelt dann die Ausgabe der Lambda-Funktion in eine HTTP-Antwort des Frontends um.
In REST APIs wird die Proxyintegration am häufigsten mit einer Proxyressource verwendet, die durch eine Greedy Path-Variable (z. B.`{proxy+}`) in Kombination mit einer `ANY` Catch-All-Methode dargestellt wird.
**Quick Create**
Sie können die Schnellerstellung verwenden, um die Erstellung einer HTTP-API zu vereinfachen. Quick Create erstellt eine API mit einer Lambda- oder HTTP-Integration, eine Catch-All-Standardroute und eine Standardphase, die für die automatische Bereitstellung von Änderungen konfiguriert ist. Weitere Informationen finden Sie unter [Erstellen Sie eine HTTP-API mithilfe der AWS CLI](http-api-develop.md#http-api-examples.cli.quick-create).
**Regionaler API-Endpunkt**
Der Hostname einer API, die in der angegebenen Region bereitgestellt wird und für Clients, z. B. EC2 Instances, in derselben Region vorgesehen ist. AWS API-Anfragen werden direkt an die regionsspezifische API Gateway gerichtet, ohne dass eine Verteilung erforderlich ist. CloudFront Bei Anfragen innerhalb einer Region umgeht ein regionaler Endpunkt den unnötigen Roundtrip zu einer Distribution. CloudFront
Darüber hinaus können Sie [latenzbasiertes Routing](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/routing-policy.html#routing-policy-latency) an den regionalen Endpunkten anwenden, um eine API für mehrere Regionen mithilfe derselben regionalen API-Endpunkt-Konfiguration bereitzustellen, dieselben benutzerdefinierten Domänennamen für jede bereitgestellte API festzulegen und latenzbasierte DNS-Datensätze in Route 53 zu konfigurieren, um Client-Anfragen an die Region mit der niedrigsten Latenz zu leiten.
Siehe [API-Endpunkte](#apigateway-definition-api-endpoints).
**Route**
Eine WebSocket Route in API Gateway wird verwendet, um eingehende Nachrichten basierend auf dem Inhalt der Nachricht an eine bestimmte Integration, z. B. eine AWS Lambda Funktion, weiterzuleiten. Wenn Sie Ihre WebSocket API definieren, geben Sie einen Routenschlüssel und ein Integrations-Backend an. Der Routenschlüssel ist ein Attribut im Nachrichtentext. Wenn der Routenschlüssel in einer eingehenden Nachricht abgeglichen wird, wird das Integrations-Backend aufgerufen.
Es kann auch eine Standardroute für nicht übereinstimmende Routenschlüssel oder zur Angabe eines Proxy-Modells festgelegt werden, mit dem die Nachricht unverändert an Backend-Komponenten übergeben wird, die die Weiterleitung und Verarbeitung der Anforderung durchführen.
**Routenanforderung**
Die öffentliche Schnittstelle einer WebSocket API-Methode in API Gateway, die den Text definiert, den ein App-Entwickler in den Anfragen senden muss, um über die API auf das Backend zuzugreifen.
**Routenantwort**
Die öffentliche Schnittstelle einer WebSocket API, die die Statuscodes, Header und Body-Modelle definiert, die ein App-Entwickler von API Gateway erwarten sollte.
**Nutzungsplan**
Ein [Nutzungsplan](api-gateway-api-usage-plans.md) bietet ausgewählten API-Clients Zugriff auf einen oder mehrere bereitgestellte REST- oder WebSocket APIs. Sie können einen Nutzungsplan dazu verwenden, die Drosselungs- und Kontingentlimits zu konfigurieren, die für einzelne Client-API-Schlüssel erzwungen werden.
**WebSocket Verbindung**
API Gateway unterhält eine beständige Verbindung zwischen Clients und API Gateway. Es gibt keine beständige Verbindung zwischen API Gateway und Backend-Integrationen wie z. B. Lambda-Funktionen. Backend-Services werden nach Bedarf aufgerufen, basierend auf dem Inhalt der Nachrichten, die von Clients empfangen werden.
# Wählen Sie zwischen REST APIs und HTTP APIs
REST APIs und HTTP APIs sind beide RESTful API-Produkte. REST APIs unterstützt mehr Funktionen als HTTP APIs, während HTTP APIs mit minimalen Funktionen konzipiert wurde, sodass sie zu einem niedrigeren Preis angeboten werden können. Wählen Sie REST, APIs wenn Sie Funktionen wie API-Schlüssel, Drosselung pro Client, Validierung von Anfragen, AWS WAF Integration oder private API-Endpunkte benötigen. Wählen Sie HTTP APIs , wenn Sie die in REST enthaltenen Funktionen nicht benötigen. APIs
In den folgenden Abschnitten werden die wichtigsten Funktionen zusammengefasst, die in REST APIs und HTTP APIs verfügbar sind. Der Einfachheit halber werden zusätzliche Links bereitgestellt, um zwischen den Abschnitten zu REST-API und HTTP-API im API Gateway-Entwicklerhandbuch zu navigieren.
## Endpunkttyp
Der Endpunkttyp bezieht sich auf den Endpunkt, den API Gateway für Ihre API erstellt. Weitere Informationen finden Sie unter [API-Endpunkttypen für REST APIs in API Gateway](api-gateway-api-endpoint-types.md).
| Endpunkttypen | REST-API | HTTP-API |
| --- | --- | --- |
| [Edge-optimiert](api-gateway-api-endpoint-types.md#api-gateway-api-endpoint-types-edge-optimized) | ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/success_icon.svg) Ja | ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/negative_icon.svg) Nein |
| [Regional](api-gateway-api-endpoint-types.md#api-gateway-api-endpoint-types-regional) | ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/success_icon.svg) Ja | ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/success_icon.svg) Ja |
| [Privat](api-gateway-api-endpoint-types.md#api-gateway-api-endpoint-types-private) | ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/success_icon.svg) Ja | ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/negative_icon.svg) Nein |
## Sicherheit
API Gateway bietet eine Reihe von Möglichkeiten, Ihre API vor bestimmten Bedrohungen zu schützen, z. B. vor böswilligen Akteuren oder Spitzen im Datenverkehr. Weitere Informationen hierzu finden Sie unter [Schützen Sie Ihren REST APIs in API Gateway](rest-api-protect.md) und [Schutz Ihrer HTTP-APIs in API Gateway](http-api-protect.md).
| Sicherheitsfunktionen | REST-API | HTTP-API |
| --- | --- | --- |
| [Gegenseitige TLS-Authentifizierung](rest-api-mutual-tls.md) | ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/success_icon.svg) [ Ja](rest-api-mutual-tls.md) | ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/success_icon.svg) [ Ja](http-api-mutual-tls.md) |
| [Zertifikate für Backend-Authentifizierung](getting-started-client-side-ssl-authentication.md) | ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/success_icon.svg) Ja | ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/negative_icon.svg) Nein |
| [AWS WAF](apigateway-control-access-aws-waf.md) | ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/success_icon.svg) Ja | ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/negative_icon.svg) Nein |
## Autorisierung
API Gateway unterstützt mehrere Mechanismen zur Steuerung und Verwaltung des Zugriffs auf Ihre API. Weitere Informationen erhalten Sie unter [Steuern und verwalten Sie den Zugriff auf REST APIs in API Gateway](apigateway-control-access-to-api.md) und [Steuern und verwalten Sie den Zugriff auf HTTP APIs in API Gateway](http-api-access-control.md).
| Autorisierungsoptionen | REST-API | HTTP-API |
| --- | --- | --- |
| [IAM](permissions.md) | ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/success_icon.svg) [ Ja](permissions.md) | ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/success_icon.svg) [ Ja](http-api-access-control-iam.md) |
| [Ressourcenrichtlinien](apigateway-resource-policies.md) | ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/success_icon.svg) Ja | ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/negative_icon.svg) Nein |
| [Amazon Cognito](apigateway-integrate-with-cognito.md) | ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/success_icon.svg) Ja | ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/success_icon.svg) Ja 1 |
| [Benutzerdefinierte Autorisierung mit einer Funktion AWS Lambda](apigateway-use-lambda-authorizer.md) | ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/success_icon.svg) [ Ja](apigateway-use-lambda-authorizer.md) | ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/success_icon.svg) [ Ja](http-api-lambda-authorizer.md) |
| [JSON Web Token (JWT)](http-api-jwt-authorizer.md) 2 | ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/negative_icon.svg) Nein | ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/success_icon.svg) Ja |
1 Sie können Amazon Cognito mit einem [JWT-Genehmiger](http-api-jwt-authorizer.md) verwenden.
2 Sie können einen [Lambda-Autorisierer verwenden, um JWTs für REST](apigateway-use-lambda-authorizer.md) zu validieren. APIs
## API-Management
Wählen Sie REST APIs , wenn Sie API-Verwaltungsfunktionen wie API-Schlüssel und Ratenbegrenzung pro Client benötigen. Weitere Informationen finden Sie unter [Verteilen Sie Ihren REST APIs an Kunden in API Gateway](rest-api-distribute.md), [Benutzerdefinierter Domainname für öffentliches REST APIs in API Gateway](how-to-custom-domains.md) und [Benutzerdefinierte Domainnamen für HTTP-APIs in API Gateway](http-api-custom-domain-names.md).
| Features | REST-API | HTTP-API |
| --- | --- | --- |
| [Benutzerdefinierte Domänen](how-to-custom-domains.md) | ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/success_icon.svg) [ Ja](how-to-custom-domains.md) | ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/success_icon.svg) [ Ja](http-api-custom-domain-names.md) |
| [API-Schlüssel](api-gateway-api-usage-plans.md) | ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/success_icon.svg) Ja | ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/negative_icon.svg) Nein |
| [Clientbasierte Ratenbegrenzung](api-gateway-request-throttling.md) | ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/success_icon.svg) Ja | ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/negative_icon.svg) Nein |
| [Clientbasierte Nutzungsdrosselung](api-gateway-api-usage-plans.md) | ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/success_icon.svg) Ja | ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/negative_icon.svg) Nein |
| [Entwicklerportal](apigateway-portals.md) | ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/success_icon.svg) Ja | ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/negative_icon.svg) Nein |
## Entwicklung
Während Sie Ihre API Gateway-API entwickeln, entscheiden Sie sich für eine Reihe von Merkmalen Ihrer API. Diese Eigenschaften hängen davon ab, wofür Ihre API verwendet werden soll. Weitere Informationen finden Sie unter [Entwickeln Sie REST APIs in API Gateway](rest-api-develop.md) und [Entwickeln Sie HTTP APIs in API Gateway](http-api-develop.md).
| Features | REST-API | HTTP-API |
| --- | --- | --- |
| [CORS-Konfiguration](how-to-cors.md) | ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/success_icon.svg) [ Ja](how-to-cors.md) | ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/success_icon.svg) [ Ja](http-api-cors.md) |
| [Testaufrufe](how-to-test-method.md) | ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/success_icon.svg) Ja | ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/negative_icon.svg) Nein |
| [Caching](api-gateway-caching.md) | ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/success_icon.svg) Ja | ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/negative_icon.svg) Nein |
| [Benutzergesteuerte Bereitstellungen](how-to-deploy-api.md) | ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/success_icon.svg) [ Ja](how-to-deploy-api.md) | ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/success_icon.svg) [ Ja](http-api-stages.md) |
| [Automatische Bereitstellungen](http-api-stages.md) | ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/negative_icon.svg) Nein | ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/success_icon.svg) Ja |
| [Benutzerdefinierte Gateway-Antworten](api-gateway-gatewayResponse-definition.md) | ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/success_icon.svg) Ja | ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/negative_icon.svg) Nein |
| [Canary-Release-Bereitstellungen](canary-release.md) | ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/success_icon.svg) Ja | ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/negative_icon.svg) Nein |
| [Anforderungsvalidierung](api-gateway-method-request-validation.md) | ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/success_icon.svg) Ja | ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/negative_icon.svg) Nein |
| [Transformation von Anfrageparametern](rest-api-data-transformations.md) | ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/success_icon.svg) [ Ja](rest-api-data-transformations.md) | ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/success_icon.svg) [ Ja](http-api-parameter-mapping.md) |
| [Transformation von Anforderungstext](rest-api-data-transformations.md) | ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/success_icon.svg) Ja | ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/negative_icon.svg) Nein |
## Überwachen
API Gateway unterstützt verschiedene Optionen zum Protokollieren von API-Anfragen und zur Überwachung Ihrer APIs. Weitere Informationen erhalten Sie unter [REST APIs in API Gateway überwachen](rest-api-monitor.md) und [Überwachen Sie HTTP APIs im API Gateway](http-api-monitor.md).
| Feature | REST-API | HTTP-API |
| --- | --- | --- |
| [ CloudWatch Amazon-Metriken](monitoring-cloudwatch.md) | ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/success_icon.svg) [ Ja](monitoring-cloudwatch.md) | ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/success_icon.svg) [ Ja](http-api-metrics.md) |
| [Zugriff auf Logs auf CloudWatch Logs](set-up-logging.md) | ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/success_icon.svg) [ Ja](set-up-logging.md) | ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/success_icon.svg) [ Ja](http-api-logging.md) |
| [Zugriffsprotokolle für Amazon Data Firehose](apigateway-logging-to-kinesis.md) | ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/success_icon.svg) Ja | ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/negative_icon.svg) Nein |
| [Ausführungsprotokolle](set-up-logging.md) | ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/success_icon.svg) Ja | ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/negative_icon.svg) Nein |
| [AWS X-Ray Rückverfolgung](apigateway-xray.md) | ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/success_icon.svg) Ja | ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/negative_icon.svg) Nein |
## Integrationen
Integrationen verbinden Ihre API-Gateway-API mit Backend-Ressourcen. Weitere Informationen erhalten Sie unter [Integrationen für REST APIs in API Gateway](how-to-integration-settings.md) und [Erstellen von Integrationen für HTTP-APIs in API Gateway](http-api-develop-integrations.md).
| Feature | REST-API | HTTP-API |
| --- | --- | --- |
| [Öffentliche HTTP-Endpunkte](setup-http-integrations.md) | ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/success_icon.svg) [ Ja](setup-http-integrations.md) | ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/success_icon.svg) [ Ja](http-api-develop-integrations-http.md) |
| [AWS Dienstleistungen](api-gateway-api-integration-types.md) | ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/success_icon.svg) [ Ja](api-gateway-api-integration-types.md) | ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/success_icon.svg) [ Ja](http-api-develop-integrations-aws-services.md) |
| [AWS Lambda Funktionen](set-up-lambda-integrations.md) | ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/success_icon.svg) [ Ja](set-up-lambda-integrations.md) | ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/success_icon.svg) [ Ja](http-api-develop-integrations-lambda.md) |
| [Private Integrationen mit Network Load Balancers](set-up-private-integration.md) | ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/success_icon.svg) [ Ja](set-up-private-integration.md) | ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/success_icon.svg) [ Ja](http-api-develop-integrations-private.md) |
| [Private Integrationen mit Application Load Balancers](http-api-develop-integrations-private.md) | ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/success_icon.svg) [ Ja](set-up-private-integration.md) | ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/success_icon.svg) Ja |
| [Private Integrationen mit AWS Cloud Map](http-api-develop-integrations-private.md) | ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/negative_icon.svg) Nein | ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/success_icon.svg) Ja |
| [Pseudointegrationen](how-to-mock-integration.md) | ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/success_icon.svg) Ja | ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/negative_icon.svg) Nein |
| [Antwort-Streaming](response-transfer-mode.md) | ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/success_icon.svg) Ja | ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/negative_icon.svg) Nein |
# Erste Schritte mit der REST-API-Konsole
In dieser Übung zu den ersten Schritten erstellen Sie eine Serverless-REST-API mithilfe der API-Gateway-REST-API-Konsole. Mit Serverless APIs können Sie sich auf Ihre Anwendungen konzentrieren, anstatt Ihre Zeit mit der Bereitstellung und Verwaltung von Servern zu verbringen. Diese Übung dauert weniger als 20 Minuten und kann im Rahmen des [Kostenlosen AWS -Kontingents](https://aws.amazon.com/free/) durchgeführt werden.
Zunächst erstellen Sie eine Lambda-Funktion unter Verwendung der Lambda-Konsole. Dann erstellen Sie eine REST-API mit der API-Gateway-REST-API-Konsole. Anschließend erstellen Sie eine API-Methode und integrieren sie mithilfe einer Lambda-Proxy-Integration in eine Lambda-Funktion. Schließlich stellen Sie Ihre API bereit und rufen sie auf.
Wenn Sie Ihre REST-API aufrufen, leitet API Gateway die Anfrage an Ihre Lambda-Funktion weiter. Lambda führt die Funktion aus und gibt eine Antwort an API Gateway zurück. API Gateway gibt dann diese Antwort an Sie zurück.
![\[Übersicht der REST-API, die Sie in diesem Tutorial erstellen.\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/getting-started-overview-rest.png)
Um diese Übung durchführen zu können, benötigen Sie einen AWS-Konto und einen AWS Identity and Access Management (IAM) -Benutzer mit Konsolenzugriff. Weitere Informationen finden Sie unter [Einrichten der API Gateway](setting-up.md).
**Topics**
+ [Schritt 1: Erstellen einer Lambda-Funktion](#getting-started-rest-new-console-create-function)
+ [Schritt 2: Erstellen einer REST-API](#getting-started-rest-new-console-create-api)
+ [Schritt 3: Erstellen einer Lambda-Proxy-Integration](#getting-started-rest-new-console-create-integration)
+ [Schritt 4: Bereitstellen Ihrer API](#getting-started-rest-new-console-deploy)
+ [Schritt 5: Aufrufen Ihrer API](#getting-started-rest-new-console-invoke-api)
+ [(Optional) Schritt 6: Bereinigen](#getting-started-cleanup-rest)
## Schritt 1: Erstellen einer Lambda-Funktion
Sie verwenden eine Lambda-Funktion für das Backend Ihrer API. Lambda führt Ihren Code nur bei Bedarf aus und skaliert automatisch – von einigen Anforderungen pro Tag bis zu Tausenden pro Sekunde.
In dieser Übung verwenden Sie eine Node.js-Standardfunktion in der Lambda-Konsole.
**So erstellen Sie eine Lambda-Funktion**
1. Melden Sie sich bei der Lambda-Konsole unter [https://console.aws.amazon.com/lambda](https://console.aws.amazon.com/lambda) an.
1. Wählen Sie **Funktion erstellen**.
1. Geben Sie unter **Basic Information (Grundlegende Informationen)** für **Function name (Funktionsname)** **my-function** ein.
1. Verwenden Sie die Standardeinstellung für alle anderen Optionen.
1. Wählen Sie **Funktion erstellen**.
Der standardmäßige Lambda-Funktionscode sollte wie folgt aussehen:
```
export const handler = async (event) => {
const response = {
statusCode: 200,
body: JSON.stringify('The API Gateway REST API console is great!'),
};
return response;
};
```
Sie können Ihre Lambda-Funktion für diese Übung ändern, solange die Antwort der Funktion mit dem [Format übereinstimmt, das API Gateway benötigt](set-up-lambda-proxy-integrations.md#api-gateway-simple-proxy-for-lambda-output-format).
Ersetzen Sie den Standardantworttext (`Hello from Lambda!`) durch `The API Gateway REST API console is great!`. Wenn Sie die Beispielfunktion aufrufen, gibt sie zusammen mit der aktualisierten Antwort eine `200`-Antwort an die Clients zurück.
## Schritt 2: Erstellen einer REST-API
Als Nächstes erstellen Sie eine REST-API mit einer Root-Ressource (`/`).
**So erstellen Sie eine REST-API**
1. Melden Sie sich bei der API Gateway Gateway-Konsole unter [https://console.aws.amazon.com/apigatewayan](https://console.aws.amazon.com/apigateway).
1. Führen Sie eine der folgenden Aktionen aus:
+ Um Ihre erste API zu erstellen, wählen Sie für **REST-API** die Option **Erstellen**.
+ Wenn Sie zuvor eine API erstellt haben, wählen Sie **API erstellen** und dann für **REST-API** die Option **Erstellen**.
1. Geben Sie in **API name** (API-Name) **my-rest-api** ein.
1. (Optional) Geben Sie unter **Description (Beschreibung)** eine Beschreibung ein.
1. Lassen Sie die Einstellung für **API-Endpunkttyp** bei **Regional**.
1. Wählen Sie als **IP-Adresstyp** die Option. **IPv4**
1. Wählen Sie **Create API** (API erstellen) aus.
## Schritt 3: Erstellen einer Lambda-Proxy-Integration
Als Nächstes erstellen Sie eine API-Methode für Ihre REST-API in der Root-Ressource (`/`) und integrieren die Methode mithilfe einer Proxy-Integration in Ihre Lambda-Funktion. Bei einer Lambda-Proxy-Integration leitet API Gateway die eingehende Anfrage vom Client direkt an die Lambda-Funktion weiter.
**So erstellen Sie eine Lambda-Proxy-Integration**
1. Wählen Sie die `/`-Ressource und dann **Methode erstellen** aus.
1. Wählen Sie als **Methodentyp** die Option `ANY` aus.
1. Wählen Sie für den **Integrationstyp** die Option **Lambda** aus.
1. Schalten Sie die **Lambda-Proxy-Integration** ein.
1. Geben Sie **my-function** für **Lambda-Funktion** ein und wählen Sie dann Ihre Lambda.Funktion aus.
1. Wählen Sie **Methode erstellen** aus.
## Schritt 4: Bereitstellen Ihrer API
Als Nächstes erstellen Sie eine API-Bereitstellung und verknüpfen sie mit einer Stufe.
**Stellen Sie Ihre API bereit**
1. Klicken Sie auf **Deploy API**.
1. Wählen Sie für **Stufe** die Option **Neue Stufe** aus.
1. Geben Sie für **Stage name (Stufenname)** **Prod** ein.
1. (Optional) Geben Sie unter **Description (Beschreibung)** eine Beschreibung ein.
1. Wählen Sie **Bereitstellen**.
Jetzt können Clients Ihre API aufrufen. Um Ihre API vor der Bereitstellung zu testen, können Sie optional die **ANY**-Methode wählen, zur Registerkarte **Test** navigieren und dann **Test** auswählen.
## Schritt 5: Aufrufen Ihrer API
**So rufen Sie Ihre API auf**
1. Wählen Sie im Haupt-Navigationsbereich **Stufe** aus.
1. Wählen Sie unter **Stufendetails** das Kopiersymbol aus, um die Aufruf-URL Ihrer API zu kopieren.
![\[Nachdem Sie Ihre REST-API erstellt haben, zeigt die Konsole die Aufruf-URL Ihrer API an.\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/getting-started-rest-invoke-url.png)
1. Geben Sie die Aufruf-URL in einen Webbrowser ein.
Die URL sollte wie folgt aussehen: `https://abcd123.execute-api.us-east-2.amazonaws.com/Prod`.
Ihr Browser sendet eine `GET`-Anforderung an die API.
1. Verifizieren Sie die Antwort Ihrer API. Sie sollten den Text `"The API Gateway REST API console is great!"` in Ihrem Browser sehen.
## (Optional) Schritt 6: Bereinigen
Um zu verhindern, dass Ihnen unnötige Kosten entstehen AWS-Konto, löschen Sie die Ressourcen, die Sie im Rahmen dieser Übung erstellt haben. In den folgenden Schritten werden Ihre REST-API, Ihre Lambda-Funktion und die zugehörigen Ressourcen gelöscht.
**So löschen Sie Ihre REST-API**
1. Wählen Sie im Bereich **Ressourcen** die Option **API-Aktionen** und **API löschen** aus.
1. Geben Sie im Dialogfeld **API löschen** **Bestätigen** ein und wählen Sie dann **Löschen**.
**So löschen Sie Ihre Lambda-Funktion**
1. Melden Sie sich bei der Lambda-Konsole unter [https://console.aws.amazon.com/lambda](https://console.aws.amazon.com/lambda) an.
1. Wählen Sie auf der Seite **Funktionen** Ihre Funktion aus. Wählen Sie **Aktionen**, **Löschen** aus.
1. Geben Sie im Dialogfeld **Löschen** den Text **delete** ein und wählen Sie dann **Löschen** aus.
**So löschen Sie die Protokollgruppe Ihrer Lambda-Funktion**
1. Öffnen Sie die [Seite Protokollgruppen](https://console.aws.amazon.com/cloudwatch/home#logs:) der CloudWatch Amazon-Konsole.
1. Wählen Sie auf der Seite **Protokollgruppen** die Protokollgruppe (`/aws/lambda/my-function`) Ihrer Funktion aus. Wählen Sie für **Aktionen** die Option **Protokollgruppe(n) löschen** aus.
1. Wählen Sie im Dialogfeld **Delete log group(s)** (Protokollgruppe(n) löschen) die Option **Delete** (Löschen) aus.
**So löschen Sie die Ausführungsrolle Ihrer Lambda-Funktion:**
1. Öffnen Sie die Seite [Roles (Rollen)](https://console.aws.amazon.com/iam/home?#/roles) in der IAM-Konsole.
1. (Optional) Geben Sie auf der Seite **Rollen** in das Suchfeld **my-function** ein.
1. Wählen Sie die Rolle Ihrer Funktion aus (z. B. `my-function-31exxmpl`) und wählen Sie dann **Löschen** aus.
1. Geben Sie im Dialogfeld **`my-function-31exxmpl` löschen?** den Namen der Rolle ein und wählen Sie anschließend **Löschen** aus.
**Tipp**
Sie können die Erstellung und Bereinigung von AWS Ressourcen automatisieren, indem Sie AWS CloudFormation oder AWS Serverless Application Model (AWS SAM) verwenden. Einige CloudFormation Beispielvorlagen finden Sie in den [Beispielvorlagen für API Gateway](https://github.com/awsdocs/amazon-api-gateway-developer-guide/tree/main/cloudformation-templates) im **awsdocs-Repository** GitHub .