Einrichten von Stufenvariablen mit der Amazon API Gateway-Konsole

In diesem Tutorial erfahren Sie, wie Sie mit der Amazon API Gateway-Konsole Stufenvariablen für zwei Bereitstellungsstufen einer Beispiel-API einrichten. Überprüfen Sie vor Beginn, ob die folgenden Anforderungen erfüllt sind:

• Es muss eine API in API Gateway verfügbar sein. Folgen Sie den Anweisungen in REST-API in Amazon API Gateway erstellen.

• Sie müssen die API mindestens einmal bereitgestellt haben. Folgen Sie den Anweisungen in Bereitstellen einer REST-API in Amazon API Gateway.

• Sie müssen die erste Stufe für eine bereitgestellte API erstellt haben. Folgen Sie den Anweisungen in Erstellen einer neuen Stufe.

So deklarieren Sie Stufenvariablen mit der API Gateway-Konsole

1. Melden Sie sich bei der API Gateway-Konsole unter https://console.aws.amazon.com/apigateway an.

2. Erstellen Sie eine API und anschließend eine GET-Methode für die Root-Ressource der API. Stellen Sie den Integrationstyp auf HTTP und die Endpunkt-URL auf http://${stageVariables.url}.

3. Stellen Sie die API für eine neue Stufe namens beta bereit.

4. Wählen Sie im Navigationsbereich Stages (Stufen) die Stufe beta.

5. Wählen Sie auf der Registerkarte Stage variables (Stufenvariablen) die Option Edit (Bearbeiten) aus.

6. Wählen Sie Add stage variable (Stufenvariable hinzufügen).

7. Geben Sie unter Name url ein. Geben Sie für Value (Wert) httpbin.org/get ein.

8. Wählen Sie Add stage variable (Stufenvariable hinzufügen) und gehen Sie wie folgt vor:

   Geben Sie unter Name stageName ein. Geben Sie für Value (Wert) beta ein.

9. Wählen Sie Add stage variable (Stufenvariable hinzufügen) und gehen Sie wie folgt vor:

   Geben Sie unter Name function ein. Geben Sie für Value (Wert) HelloWorld ein.

   Anmerkung

   Wenn Sie eine Lambda-Funktion als Wert einer Stufenvariable festlegen, verwenden Sie den lokalen Namen der Funktion und binden den Alias oder die Versionsangabe ein, z. B. HelloWorld, HelloWorld:1 oder HelloWorld:alpha. Nutzen Sie nicht den ARN der Funktion (z. B, arn:aws:lambda:us-east-1:123456789012:function:HelloWorld). Die API Gateway-Konsole betrachtet den Stufenvariablenwert einer Lambda-Funktion als unvollständigen Funktionsnamen und erweitert die Stufenvariable zu einem ARN.

10. Wählen Sie Speichern.

11. Erstellen Sie nun eine zweite Stufe. Wählen Sie im Navigationsbereich Stages (Stufen) die Option Create stage (Stufe erstellen). Geben Sie für Stage name (Stufenname) prod ein. Wählen Sie in Deployment (Bereitstellung) eine kürzlich ausgeführte Bereitstellung und anschließend Create stage (Stufe erstellen) aus.

12. Legen Sie wie im Fall der Phase beta die gleichen drei Stufenvariablen (url, stageName und function) auf unterschiedliche Werte fest („petstore-demo-endpoint.execute-api.com/petstore/pets“, „prod“ und „HelloEveryone“).

    Weitere Informationen zur Verwendung von Stufenvariablen finden Sie unter Verwenden von Amazon API Gateway-Stufenvariablen.