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. # Wählen Sie ein Tutorial zur HTTP-Integration aus Sie können entweder eine HTTP-Proxy-Integration oder eine benutzerdefinierte HTTP-Integration verwenden, um eine API mit HTTP-Integration zu erstellen. Bei einer HTTP-Proxy-Integration müssen Sie lediglich die HTTP-Methode und die HTTP-Endpunkt-URI entsprechend der Backend-Anforderungen festlegen. Wir empfehlen, die HTTP-Proxy-Integration zu verwenden (sofern möglich), um die Vorteile der optimierten API-Einrichtung zu genießen. Die benutzerdefinierte HTTP-Integration kann die bessere Wahl sein, wenn Client-Anforderungsdaten für das Backend oder Backend-Antwortdaten für den Client transformiert werden müssen. **Topics** + [ # Tutorial: Erstellen einer REST-API mit HTTP-Proxy-Integration ](api-gateway-create-api-as-simple-proxy-for-http.md) + [ # Tutorial: REST-API mit HTTP-API ohne Proxy-Integration erstellen ](api-gateway-create-api-step-by-step.md) # Tutorial: Erstellen einer REST-API mit HTTP-Proxy-Integration Die HTTP-Proxy-Integration von ist ein einfacher, leistungsstarker und vielseitiger Mechanismus für den Aufbau einer API, mit der eine Webanwendung auf mehrere Ressourcen oder Funktionen des integrierten HTTP-Endpunktes (z. B. die gesamte Website) zugreifen kann und der eine unkomplizierte Einrichtung einer einzigen API-Methode verwendet. Bei der HTTP-Proxy-Integration leitet API Gateway die vom Client übermittelte Methodenanforderung an das Backend weiter. Diese übergebenen Anforderungsdaten umfassen die Abfrage-Header, Parameter für Abfragezeichenfolgen, die URL-Pfadvariablen und die Nutzlast. Der Backend-HTTP-Endpunkt oder Webserver analysiert die eingehenden Anforderungsdaten, um die eigene Antwort zu bestimmen. Die HTTP-Proxy-Integration sorgt dafür, dass der Client und das Backend direkt interagieren, ohne dass nach dem Einrichten der API-Methode ein Eingriff von API Gateway erfolgt. Dies gilt nicht für bekannte Probleme wie nicht unterstützte Zeichen, die in aufgeführt sin [Wichtige Hinweise zu Amazon API Gateway](api-gateway-known-issues.md). Mit der umfassenden Proxy-Ressource `{proxy+}`und dem umfassenden `ANY`-Verb für die HTTP-Methode können Sie mit einer HTTP-Proxy-Integration eine API mit einer einzelnen API-Methode erstellen. Die Methode macht den gesamten Satz der öffentlich verfügbaren HTTP-Ressourcen und -Vorgänge der Website verfügbar. Wenn der Backend-Webserver mehr Ressourcen für den öffentlichen Zugriff öffnet, kann der Client diese neuen Ressourcen mit derselben API-Einrichtung nutzen. Um dies zu ermöglichen, muss der Websiteentwickler dem Cliententwickler klar kommunizieren, was die neuen Ressourcen sind und welche Vorgänge für diese Umgebungen anwendbar sind. Als kurze Einführung zeigt die folgende Anleitung die HTTP-Proxy-Integration. Im Tutorial erstellen wir mithilfe der API Gateway-Konsole eine API, um sie über eine generische Proxyressource in die PetStore Website zu integrieren`{proxy+}`, und erstellen den Platzhalter für die HTTP-Methode. `ANY` **Topics** + [ ## API mit HTTP-Proxy-Integration unter Verwendung der API Gateway-Konsole erstellen ](#api-gateway-create-api-as-simple-proxy-for-http-build) + [ ## Testen einer API mit HTTP-Proxy-Integration ](#api-gateway-create-api-as-simple-proxy-for-http-test) ## API mit HTTP-Proxy-Integration unter Verwendung der API Gateway-Konsole erstellen Das folgende Verfahren führt Sie durch die Schritte zum Erstellen und Testen einer API mit einer Proxy-Ressource für ein HTTP-Backend unter Verwendung der API Gateway-Konsole. Das HTTP-Backend ist die `PetStore`-Website (`http://petstore-demo-endpoint.execute-api.com/petstore/pets`) von [Tutorial: REST-API mit HTTP-API ohne Proxy-Integration erstellen](api-gateway-create-api-step-by-step.md), auf der Screenshots als visuelle Hilfsmittel zur Veranschaulichung der API Gateway-Benutzeroberflächenelemente verwendet werden. Wenn Ihnen die Verwendung der API Gateway-Konsole zur Erstellung einer API unbekannt ist, sollten Sie zuerst diesen Abschnitt lesen. **So erstellen Sie eine 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. Wenn Sie API Gateway zum ersten Mal verwenden, sehen Sie eine Seite, die Sie mit den Funktionen des Service vertraut macht. Wählen Sie unter **REST-API** die Option **Erstellen** aus. Wenn das Popup-Fenster **Create Example API (Beispiel-API erstellen)** angezeigt wird, klicken Sie auf **OK**. Wenn Sie API Gateway nicht zum ersten Mal verwenden, wählen Sie **Create API (API erstellen)**. Wählen Sie unter **REST-API** die Option **Build (Erstellen)** aus. 1. Geben Sie in **API name** (API-Name) **HTTPProxyAPI** 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**. **IPv4** 1. Wählen Sie **Create API** (API erstellen) aus. In diesem Schritt erstellen Sie einen Proxy-Ressourcenpfad für `{proxy+}`. Dies ist der Platzhalter für beliebige Backend-Endpunkte unter `http://petstore-demo-endpoint.execute-api.com/`. Zum Beispiel kann dies `petstore`, `petstore/pets` und `petstore/pets/{petId}` sein. API Gateway erstellt die `ANY`-Methode, wenn Sie die `{proxy+}`-Ressource erstellen, und dient als Platzhalter für alle unterstützten HTTP-Verben zur Laufzeit. **So erstellen Sie eine **/\$1proxy\$1\$1**-Ressource** 1. Wählen Sie Ihre API aus. 1. Klicken Sie im Hauptnavigationsbereich auf **Resources** (Ressourcen). 1. Wählen Sie **Create Resource** (Ressource erstellen) aus. 1. Aktivieren Sie die Option **Proxy-Ressource**. 1. **Ressourcenpfad** wird als `/` beibehalten. 1. Geben Sie für **Resource name (Ressourcenname)** **\$1proxy\$1\$1** ein. 1. **CORS (Cross Origin Resource Sharing)** bleibt ausgeschaltet. 1. Wählen Sie **Create Resource** (Ressource erstellen) aus. ![\[Erstellen Sie eine untergeordnete Ressource.\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/api-gateway-simple-proxy-create-proxy-resource-new-console.png) In diesem Schritt integrieren Sie die `ANY`-Methode mithilfe einer Proxyintegration in einen Backend-HTTP-Endpunkt. Bei einer Proxy-Integration leitet API Gateway die vom Client übermittelte Methodenanforderung ohne Zutun der API-Gateway an das Backend weiter. **Erstellen einer `ANY`-Methode** 1. Wählen Sie die Ressource **/\$1proxy\$1\$1** aus. 1. Wählen Sie die Methode **BELIEBIGE**. 1. Klicken Sie unter dem Warnsymbol auf **Integration bearbeiten**. Sie können keine API mit einer Methode bereitstellen, die keine Integration hat. 1. Wählen Sie für den **Integrationstyp** die Option **HTTP** aus. 1. Aktivieren Sie die **HTTP-Proxy-Integration**. 1. Für **HTTP-Methode** wählen Sie **BELIEBIGE** aus. 1. Geben Sie für **Endpunkt-URL** **http://petstore-demo-endpoint.execute-api.com/\$1proxy\$1** ein. 1. Wählen Sie **Speichern**. ## Testen einer API mit HTTP-Proxy-Integration Ob eine bestimmte Clientanforderung erfolgreich ist, hängt von Folgendem ab: + Ob das Backend den entsprechenden Backend-Endpunkt verfügbar gemacht hat und, falls dies der Fall ist, ob die erforderlichen Zugriffsberechtigungen erteilt wurden. + Ob der Client die korrekte Eingabe bereitstellt. Die hier verwendete PetStore API macht die `/petstore` Ressource beispielsweise nicht verfügbar. Daher erhalten Sie eine `404 Resource Not Found`-Antwort mit der Fehlermeldung `Cannot GET /petstore`. Darüber hinaus muss der Client in der Lage sein, das Ausgabeformat zu verarbeiten, um das Ergebnis des Backends korrekt zu analysieren. API Gateway fungiert nicht als Vermittler zur Vereinfachung der Interaktionen zwischen dem Client und dem Backend. **Um eine in die PetStore Website integrierte API mithilfe der HTTP-Proxyintegration über die Proxy-Ressource zu testen** 1. Wählen Sie die Registerkarte **Test**. Möglicherweise müssen Sie die rechte Pfeiltaste wählen, um die Registerkarte anzuzeigen. 1. Wählen Sie als **Methodentyp** die Option `GET` aus. 1. Geben Sie für **Pfad** unter **Proxy** **petstore/pets** ein. 1. Für **Abfragezeichenketten** geben Sie **type=fish** ein. 1. Wählen Sie **Test** aus. ![\[Methoden können mit der Testfunktion geprüft werden.\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/api-gateway-simple-proxy-petstore-call-proxy-resource-new-console.png) Da die Backend-Website die `GET /petstore/pets?type=fish`-Anforderung unterstützt, wird eine erfolgreiche Antwort wie die folgende zurückgegeben: ``` [ { "id": 1, "type": "fish", "price": 249.99 }, { "id": 2, "type": "fish", "price": 124.99 }, { "id": 3, "type": "fish", "price": 0.99 } ] ``` Wenn Sie versuchen, `GET /petstore` aufzurufen, erhalten Sie eine `404`-Antwort mit der Fehlermeldung `Cannot GET /petstore`. Der Grund hierfür ist, dass das Backend die angegebene Operation nicht unterstützt. Wenn Sie anrufen`GET /petstore/pets/1`, erhalten Sie eine `200 OK` Antwort mit der folgenden Nutzlast, da die Anfrage von der PetStore Website unterstützt wird. ``` { "id": 1, "type": "dog", "price": 249.99 } ``` Sie können Ihre API zusätzlich in einem Browser testen. Stellen Sie Ihre API bereit und ordnen Sie sie einer Stufe zu, um die Aufruf-URL Ihrer API zu erstellen. **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)** **test** ein. 1. (Optional) Geben Sie unter **Description (Beschreibung)** eine Beschreibung ein. 1. Wählen Sie **Bereitstellen**. Jetzt können Clients Ihre API aufrufen. **So rufen Sie Ihre API auf** 1. Melden Sie sich bei der API Gateway Gateway-Konsole unter [https://console.aws.amazon.com/apigatewayan](https://console.aws.amazon.com/apigateway). 1. Wählen Sie Ihre API aus. 1. Klicken Sie im Hauptnavigationsbereich auf **Stufe**. 1. Wählen Sie unter **Stufendetails** das Kopiersymbol aus, um die Aufruf-URL Ihrer API zu kopieren. Geben Sie die Aufruf-URL Ihrer API in einen Webbrowser ein. Die URL sollte wie folgt aussehen: `https://abcdef123.execute-api.us-east-2.amazonaws.com/test/petstore/pets?type=fish`. Ihr Browser sendet eine `GET`-Anforderung an die API. 1. Das Ergebnis sollte mit dem übereinstimmen, was Ihr **Test** in der API Gateway-Konsole zurückgegeben hat. # Tutorial: REST-API mit HTTP-API ohne Proxy-Integration erstellen In diesem Tutorial erstellen Sie mit der Amazon API Gateway-Konsole eine API von Grund auf. Im Prinzip nutzen Sie die Konsole als API-Designstudio und wählen damit die API-Funktionen aus, testen das API-Verhalten, erstellen die API und stellen sie in Stufen bereit. **Topics** + [ ## Erstellen einer API mit benutzerdefinierter HTTP-Integration ](#api-gateway-create-resource-and-methods) + [ ## (Optionale) Parameter für die Zuordnungsanforderung ](#api-gateway-create-resources-and-methods-next-steps) ## Erstellen einer API mit benutzerdefinierter HTTP-Integration In diesem Abschnitt werden die Schritte beschrieben, mit denen Sie Ressourcen erstellen, Methoden für eine Ressource nutzen, eine Methode für bestimmte API-Verhaltensweisen konfigurieren und die API testen und bereitstellen. In diesem Schritt erstellen Sie eine leere API. In den folgenden Schritten erstellen Sie Ressourcen und Methoden, um Ihre API mithilfe einer Nicht-Proxy-HTTP-Integration mit dem `http://petstore-demo-endpoint.execute-api.com/petstore/pets`-Endpunkt zu verbinden. **So erstellen Sie eine 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. Wenn Sie API Gateway zum ersten Mal verwenden, sehen Sie eine Seite, die Sie mit den Funktionen des Service vertraut macht. Wählen Sie unter **REST-API** die Option **Erstellen** aus. Wenn das Popup-Fenster **Create Example API (Beispiel-API erstellen)** angezeigt wird, klicken Sie auf **OK**. Wenn Sie API Gateway nicht zum ersten Mal verwenden, wählen Sie **Create API (API erstellen)**. Wählen Sie unter **REST-API** die Option **Build (Erstellen)** aus. 1. Geben Sie in **API name** (API-Name) **HTTPNonProxyAPI** 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. In der **Resources**-Struktur wird die Stammressource (`/`) ohne Methoden angezeigt. In dieser Übung erstellen wir die API mit der benutzerdefinierten HTTP-Integration der PetStore Website (http://petstore-demo-endpoint.execute-api). com/petstore/pets.) Zur Veranschaulichung erstellen wir eine `/pets` Ressource als untergeordnetes Element des Stammverzeichnisses und stellen eine GET-Methode für diese Ressource bereit, damit ein Client eine Liste verfügbarer Pets-Elemente von der PetStore Website abrufen kann. **Erstellen einer /pets-Ressource** 1. Wählen Sie **Create Resource** (Ressource erstellen) aus. 1. Die **Proxy-Ressource** bleibt ausgeschaltet. 1. **Ressourcenpfad** wird als `/` beibehalten. 1. Geben Sie für **Resource name (Ressourcenname)** **pets** ein. 1. **CORS (Cross Origin Resource Sharing)** bleibt ausgeschaltet. 1. Wählen Sie **Create Resource** (Ressource erstellen) aus. In diesem Schritt erstellen Sie eine `GET`-Methode für die **/pets**-Ressource. Die `GET`-Methode ist in die `http://petstore-demo-endpoint.execute-api.com/petstore/pets`-Website integriert. Die Folgenden sind weitere Optionen für eine API-Methode: + **POST**; wird vor allem für die Erstellung von untergeordneten Ressourcen verwendet. + **PUT**; wird vor allem für die Aktualisierung vorhandener Ressourcen verwendet (kann auch für die Erstellung untergeordneter Ressourcen verwendet werden, obwohl dies nicht empfohlen wird). + **DELETE**; wird für das Löschen von Ressourcen verwendet. + **PATCH**; wird für die Aktualisierung von Ressourcen verwendet. + **HEAD**; wird vor allem in Testszenarien verwendet. Diese Option ist identisch mit GET, gibt aber nicht die Repräsentation der Ressource zurück. + **OPTIONS** – kann von Aufrufern verwendet werden, um Informationen über verfügbare Kommunikationsoptionen für den Zielservice abzurufen. Als **HTTP method** der Integrationsanforderung müssen Sie eine Methode wählen, die vom Backend unterstützt wird. Bei `HTTP` oder `Mock integration` ist es durchaus sinnvoll, dass die Methoden- und die Integrationsanforderung das gleiche HTTP-Verb nutzen. Bei den anderen Integrationstypen verwenden Methoden- und Integrationsanforderung vermutlich unterschiedliche HTTP-Verben. Um beispielsweise eine Lambda-Funktion aufzurufen, muss die Integrationsanforderung `POST` verwenden, wohingegen die Methodenanforderung – abhängig von der Logik der Lambda-Funktion – ein beliebiges HTTP-Verb nutzen kann. **So erstellen Sie eine `GET`-Methode für die **/pets**-Ressource** 1. Wählen Sie die **/pets**-Ressource aus. 1. Wählen Sie **Methode erstellen** aus. 1. Wählen Sie als **Methodentyp** die Option **GET** (Abrufen) aus. 1. Für den **Integrationstyp** wählen Sie die Option **HTTP-Integration** aus. 1. Die Option **Lambda-Proxy-Integration** bleibt deaktiviert. 1. Für **HTTP-Methode** wählen Sie **GET** aus. 1. Geben Sie für **Endpunkt-URL** **http://petstore-demo-endpoint.execute-api.com/petstore/pets** ein. Auf der PetStore Website können Sie auf einer bestimmten Seite eine Liste von `Pet` Objekten abrufen, die nach der Art des Haustiers, z. B. „Hund“ oder „Katze“, sortiert sind. 1. Für **Inhaltsbehandlung** wählen Sie **Passthrough** aus. 1. Klicken Sie auf **Parameter für URL-Abfragezeichenfolgen**. Die PetStore Website verwendet die Parameter `type` und die `page` Abfragezeichenfolge, um eine Eingabe zu akzeptieren. Hierfür müssen diese Abfragezeichenfolge-Parameter zur Methodenanforderung hinzugefügt, und den entsprechenden Abfragezeichenfolgen der Integrationsanforderung zugewiesen werden. 1. Fügen Sie die Abfragezeichenfolge-Parameter wie folgt hinzu: 1. Wählen Sie **Abfragezeichenfolge hinzufügen** aus. 1. Für **Name** geben Sie **type** ein. 1. Lassen Sie die Optionen **Required** (Obligatorisch) and **Caching** (Cache) deaktiviert. Wiederholen Sie die obigen Schritte, um eine zusätzliche Abfragezeichenfolge namens **page** zu erstellen. 1. Wählen Sie **Methode erstellen** aus. Bei der Anforderungsübermittlung kann der Client nun einen Haustiertyp und eine Seitenzahl als Abfragezeichenfolge-Parameter senden. Diese Eingabeparameter müssen den Abfragezeichenfolgenparametern der Integration zugeordnet werden, um die Eingabewerte an unsere PetStore Website im Backend weiterzuleiten. **Zuordnen von Eingabeparametern zur Integrationsanforderung** 1. Klicken Sie auf der Registerkarte **Integrationsanfrage** unter **Einstellungen für Integrationsanfragen** auf **Bearbeiten**. 1. Klicken Sie auf **URL-Abfragezeichenfolgen-Parameter** und gehen Sie dann wie folgt vor: 1. Klicken Sie auf **Abfragezeichenfolge-Parameter hinzufügen**. 1. Geben Sie unter **Name** **type** ein. 1. Für **Zugeordnet von** geben Sie **method.request.querystring.type** ein. 1. **Caching** bleibt ausgeschaltet. 1. Klicken Sie auf **Abfragezeichenfolge-Parameter hinzufügen**. 1. Geben Sie unter **Name** **page** ein. 1. Für **Zugeordnet von** geben Sie **method.request.querystring.page** ein. 1. **Caching** bleibt ausgeschaltet. 1. Wählen Sie **Speichern**. **So testen Sie die API-Daten** 1. Wählen Sie die Registerkarte **Test**. Möglicherweise müssen Sie die rechte Pfeiltaste wählen, um die Registerkarte anzuzeigen. 1. Für **Abfrage-Zeichenketten** geben Sie **type=Dog&page=2** ein. 1. Wählen Sie **Test** aus. Das Ergebnis sollte wie folgt aussehen: ![\[Ergebnis des Testaufrufs der GET-Methode für die Pets-Ressource\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/api-gateway-create-api-step-by-step-test-invoke-get-on-pets-result-new-console.png) Nach erfolgreich ausgeführtem Test kann die API bereitgestellt und damit öffentlich verfügbar gemacht werden. 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**. 1. (Optional) Klicken Sie unter **Stufendetails** auf das Kopiersymbol für **Aufruf-URL**, um die URL Ihrer Aufruf-API zu kopieren. Sie können diese mit Tools wie [Postman](https://www.postman.com) und [cURL](https://curl.se/) zum Testen Ihrer API verwenden. Wenn Sie ein SDK zum Erstellen eines Clients verwenden, können Sie die Anforderung mithilfe der vom SDK bereitgestellten Methodenaufrufe signieren. Weitere Informationen zur Implementierung finden Sie jeweils im ausgewählten [AWS SDK](https://aws.amazon.com/developer/tools/). **Anmerkung** Nach jeder Änderung der API müssen Sie die API erneut bereitstellen, um die neuen oder aktualisierten Funktionen verfügbar zu machen, bevor die Anforderungs-URL wieder aufgerufen wird. ## (Optionale) Parameter für die Zuordnungsanforderung ### Anfrageparameter für ein API Gateway API zuordnen In diesem Tutorial erfahren Sie, wie Sie einen `{petId}`-Pfadparameter über die Methodenanforderung der API erstellen, um eine Element-ID vorzugeben, diese dem `{id}`-Pfadparameter in der Integrationsanforderungs-URL zuweisen, und dann die Anforderung an den HTTP-Endpunkt senden. **Anmerkung** Eine Verwechslung von Groß- und Kleinschreibung kann im späteren Verlauf zu Fehlern führen. #### Schritt 1: Erstellen von Ressourcen In diesem Schritt erstellen Sie eine Ressource mit einem \$1petId\$1-Pfadparameter. **Erstellen der \$1petId\$1-Ressource** 1. Wählen Sie die **/pets**-Ressource aus und klicken Sie dann auf **Ressource erstellen**. 1. Die **Proxy-Ressource** bleibt ausgeschaltet. 1. Für **Ressourcenpfad** wählen Sie die Option**/pets/**aus. 1. Geben Sie für **Resource name (Ressourcenname)** **\$1petId\$1** ein. Setzen Sie geschweifte Klammern (`{ }`) um `petId`, sodass **/pets/\$1petId\$1** angezeigt wird. 1. **CORS (Cross Origin Resource Sharing)** bleibt ausgeschaltet. 1. Wählen Sie **Create Resource** (Ressource erstellen) aus. #### Schritt 2: Erstellen und Testen der Methoden In diesem Schritt erstellen Sie eine `GET`-Methode mit einem `{petId}`-Pfadparameter. **Einrichten der GET-Methode** 1. Wählen Sie die **/\$1petId\$1**-Ressource aus und klicken Sie dann auf **Methode erstellen**. 1. Wählen Sie als **Methodentyp** die Option **GET** (Abrufen) aus. 1. Für den **Integrationstyp** wählen Sie die Option **HTTP-Integration** aus. 1. Die Option **Lambda-Proxy-Integration** bleibt deaktiviert. 1. Für **HTTP-Methode** wählen Sie **GET** aus. 1. Für **Endpunkt-URL** geben Sie **http://petstore-demo-endpoint.execute-api.com/petstore/pets/\$1id\$1** ein. 1. Für **Inhaltsbehandlung** wählen Sie **Passthrough** aus. 1. Das **Standard-Timeout** bleibt aktiviert. 1. Wählen Sie **Methode erstellen** aus. Als Nächstes ordnen Sie den soeben erstellten `{petId}`-Pfadparameter dem `{id}`-Pfadparameter in der HTTP-Endpunkt-URL der Integrationsanforderung zu. Die HTTP-Endpunkt-URL lautete **http://petstore-demo-endpoint.execute-api.com/petstore/pets/\$1id\$1**. **Zuordnen des `{petId}`-Pfadparameters** 1. Klicken Sie auf der Registerkarte **Integrationsanfrage** unter **Einstellungen für Integrationsanfragen** auf **Bearbeiten**. 1. Klicken Sie auf **URL-Pfadparameter**. 1. API Gateway erstellt einen Pfadparameter für die Integrationsanforderung namens **petId**. Dieser Pfadparameter ist jedoch nicht für die HTTP-Endpunkt-URL gültig, die Sie als Backend-Integration festgelegt haben. Der HTTP-Endpunkt verwendet `{id}` als Pfadparameter. Unter **Name** löschen Sie also **petId** und geben statt dessen **id** ein. Damit wird der Pfadparameter `petId` der Methodenanforderung dem Pfadparameter `id` der Integrationsanforderung zugewiesen. 1. Wählen Sie **Speichern**. Jetzt können Sie die Methode testen. **So testen Sie die -Methode** 1. Wählen Sie die Registerkarte **Test**. Möglicherweise müssen Sie die rechte Pfeiltaste wählen, um die Registerkarte anzuzeigen. 1. Geben Sie unter **Pfad** für **petId** den Wert **4** ein. 1. Wählen Sie **Test** aus. Wenn diese Aktion erfolgreich ist, zeigt **Antworttext** Folgendes an: ``` { "id": 4, "type": "bird", "price": 999.99 } ``` #### Schritt 3: Bereitstellen der API In diesem Schritt stellen Sie die API bereit, sodass Sie beginnen können, sie außerhalb der API-Gateway-Konsole aufzurufen. **So stellen Sie die API bereit** 1. Klicken Sie auf **Deploy API**. 1. Für **Stufe** wählen Sie die Option **Prod** aus. 1. (Optional) Geben Sie unter **Description (Beschreibung)** eine Beschreibung ein. 1. Wählen Sie **Bereitstellen** aus. #### Schritt 4: Testen der API In diesem Schritt wechseln Sie au der API Gateway-Konsole und verwenden Ihre API, um auf den HTTP-Endpunkt zuzugreifen. 1. Klicken Sie im Hauptnavigationsbereich auf **Stufe**. 1. Wählen Sie unter **Stufendetails** das Kopiersymbol aus, um die Aufruf-URL Ihrer API zu kopieren. Sie sollte wie folgt aussehen: ``` https://my-api-id.execute-api.region-id.amazonaws.com/prod ``` 1. Geben Sie diese URL in das Adressfeld einer neuen Registerkarte im Browser ein und fügen Sie `/pets/4` an die URL an, bevor Sie Ihre Anforderung absenden. 1. Der Browser gibt Folgendes zurück: ``` { "id": 4, "type": "bird", "price": 999.99 } ``` #### Nächste Schritte Sie können Ihre API weiter anpassen, indem Sie die Anforderungsvalidierung aktivieren, Daten umwandeln oder benutzerdefinierte Gateway-Antworten erstellen. In den folgenden Tutorien finden Sie weitere Möglichkeiten zur Anpassung Ihrer API: + Weitere Informationen zur Anforderungsvalidierung finden Sie unter [Grundlegende Anforderungsvalidierung in API Gateway einrichten](api-gateway-request-validation-set-up.md). + Weitere Informationen zur Umwandlung von Anforderungs- und Antwort-Nutzlasten finden Sie unter [Tutorial: Ändern Sie die Integrationsanfrage und die Antwort für Integrationen zu Diensten AWS](set-up-data-transformations-in-api-gateway.md). + Informationen zum Erstellen benutzerdefinierter Gateway-Antworten finden Sie unter [Einrichten einer Gateway-Antwort für eine REST-API mit der API-Gateway-Konsole](set-up-gateway-response-using-the-console.md).