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. # Methoden für REST APIs in API Gateway In API Gateway setzt sich eine API-Methode aus einer [Methodenanfrage](https://docs.aws.amazon.com/apigateway/latest/api/API_Method.html) und eine [Methodenantwort](https://docs.aws.amazon.com/apigateway/latest/api/API_MethodResponse.html) zusammen. Sie richten eine API-Methode ein, um zu definieren, was ein Client tun sollte oder tun muss, um eine Anforderung für den Zugriff auf den Service am Backend zu übermitteln und um die Antworten zu definieren, die der Client im Gegenzug erhält. Für die Eingabe können Sie Methodenanforderungs-Parameter oder eine anwendbare Nutzlast für den Client auswählen, um die erforderlichen oder optionalen Daten zur Laufzeit bereitzustellen. Für die Ausgabe bestimmen Sie den Statuscode der Methodenantwort, die Header und den geltenden Textkörper als Ziele denen Backend-Antwortdaten zugewiesen werden, bevor die Rückgabe an den Client erfolgt. Um den Client-Developer dabei zu unterstützen, das Verhalten und die Eingabe- und Ausgabeformate Ihrer API zu verstehen, können Sie [Ihre API dokumentieren](api-gateway-documenting-api.md) und [ordnungsgemäße Fehlermeldungen](api-gateway-gatewayResponse-definition.md#customize-gateway-responses) für [ungültige Anforderungen](api-gateway-method-request-validation.md) bereitstellen. Eine API-Methodenanforderung ist eine HTTP-Anforderung. Um die Methodenanforderung einzurichten, konfigurieren Sie eine HTTP-Methode (oder einVerb), den Pfad zu einer API-[Ressource](https://docs.aws.amazon.com/apigateway/latest/api/API_Resource.html), Header, geltende Parameter für Abfragezeichenfolgen. Außerdem konfigurieren Sie eine Nutzlast, wenn die HTTP-Methode `POST`, `PUT`oder `PATCH` ist. Um beispielsweise mithilfe der [PetStore Beispiel-API](api-gateway-create-api-from-example.md) ein Haustier abzurufen, definieren Sie die API-Methodenanfrage von`GET /pets/{petId}`. Dabei `{petId}` handelt es sich um einen Pfadparameter, der zur Laufzeit eine Zahl annehmen kann. ``` GET /pets/1 Host: apigateway.us-east-1.amazonaws.com ... ``` Wenn der Client einen falschen Pfad angibt, zum Beispiel `/pet/1` oder `/pets/one` anstatt `/pets/1`, wird eine Ausnahme ausgelöst. Eine API-Methodenantwort ist eine HTTP-Antwort mit einem bestimmten Statuscode. Für eine Nicht-Proxy-Integration müssen Sie Methodenantworten einrichten, um die erforderlichen oder optionalen Ziele von Mappings anzugeben. Diese transformieren Integrationsantwort-Header oder einen Textkörper in verknüpfte Methodenantwort-Header oder einen Textkörper. Das Mapping kann so einfach wie eine [identische Transformation](https://en.wikipedia.org/wiki/Identity_transform) sein, mit der die Header oder der Text unverändert mittels die Integration übergeben werden. Zum Beispiel zeigt die folgende `200`-Methodenantwort ein Beispiel für die Weiterleitung einer unveränderten erfolgreichen Integrationsantwort. ``` 200 OK Content-Type: application/json ... { "id": "1", "type": "dog", "price": "$249.99" } ``` In der Regel können Sie eine Methodenantwort entsprechend einer bestimmten Antwort vom Backend definieren. In der Regel handelt es sich dabei um alle 2XX-, 4XX- und 5XX-Antworten. Dies kann jedoch nicht praktikabel sein, da Sie häufig nicht alle Antworten, die ein Backend möglicherweise zurückgibt, im Vorfeld wissen können. In der Praxis können Sie eine Methodenantwort als Standard festlegen, um die unbekannten oder nicht zugewiesenen Antworten vom Backend zu verarbeiten. Es ist ein bewährtes Verfahren, die 500-Antwort als Standard festzulegen. In jedem Fall müssen Sie mindestens eine Methodenantwort für Nicht-Proxy-Integrationen einrichten. Andernfalls gibt API Gateway eine 500-Fehler-Antwort an den Client zurück, selbst wenn die Anfrage am Backend erfolgreich ist. Zur Unterstützung eines stark typisierten SDKs, z. B. ein Java-SDK für Ihre API, sollten Sie das Datenmodell zur Eingabe für die Methodenanforderung und das Datenmodell zur Ausgabe der Methodenantwort definieren. ## Voraussetzungen Vor dem Einrichten einer API-Methode, überprüfen Sie Folgendes: + Die Methode muss in API Gateway verfügbar sein. Folgen Sie den Anweisungen in [Tutorial: REST-API mit HTTP-API ohne Proxy-Integration erstellen](api-gateway-create-api-step-by-step.md). + Wenn die Methode mit einer Lambda-Funktion kommunizieren soll, müssen Sie die Lambda-Aufrufrolle und die Lambda-Ausführungsrolle bereits in IAM erstellt haben. Sie müssen außerdem die Lambda-Funktion erstellt haben, mit der Ihre Methode in AWS Lambda kommuniziert. Befolgen Sie zum Erstellen der Rollen und der Funktion die Anweisungen in [Lambda-Funktion für die Nicht-Proxy-Integration von Lambda erstellen](getting-started-lambda-non-proxy-integration.md#getting-started-new-lambda) unter [Wählen Sie ein AWS Lambda Integrations-Tutorial](getting-started-with-lambda-integration.md). + Wenn Sie möchten, dass die Methode mit einer HTTP- oder HTTP-Proxy-Integration kommunizieren soll, muss die HTTP-Endpunkt-URL, mit der die Methode kommuniziert, bereits erstellt sein und Sie müssen Zugriff darauf haben. + Stellen Sie sicher, dass Ihre Zertifikate für HTTP- und HTTP-Proxy-Endpunkte von API Gateway unterstützt werden. Weitere Informationen finden Sie unter [Von API Gateway unterstützte Zertifizierungsstellen für HTTP- und HTTP-Proxy-Integrationen](api-gateway-supported-certificate-authorities-for-http-endpoints.md). **Topics** + [Voraussetzungen](#method-setting-prerequisites) + [Methodenanfrage in API Gateway einrichten](api-gateway-method-settings-method-request.md) + [Einrichten einer Methodenantwort in API Gateway](api-gateway-method-settings-method-response.md) + [Methode über die API Gateway-Konsole einrichten](how-to-set-up-method-using-console.md)