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.
# 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 .