

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.

# Einrichten einer Methodenantwort in API Gateway
<a name="api-gateway-method-settings-method-response"></a>

Eine API-Methodenantwort kapselt die Ausgabe einer API-Methodenanforderung, die der Client erhält. Die Ausgabedaten enthalten einen HTTP-Statuscode, einige Header und in der Regel einen Textkörper. 

Mit Nicht-Proxy-Integrationen können die angegebenen Antwortparameter und Textkörper von den zugeordneten Integrationsantwortdaten oder bestimmten statischen Werten entsprechend der Mappings zugewiesen werden. Diese Mappings werden in der Integrationsantwort beschrieben. Das Mapping kann eine identische Transformation sein, die die Integrationsantwort unverändert weiterleitet.

Bei einer Proxy-Integration leitet API Gateway die Antwort des Backends automatisch an die Antwort der Methode weiter. Sie müssen sich nicht um die Einrichtung der API-Methodenantwort kümmern. Bei der Lambda-Proxy-Integration muss die Lambda-Funktion jedoch ein Ergebnis in [diesem Ausgabeformat](set-up-lambda-proxy-integrations.md#api-gateway-simple-proxy-for-lambda-output-format) zurückgeben, damit API Gateway die Integrationsantwort erfolgreich einer Methodenantwort zuordnen kann. 

[Programmatisch gesehen läuft die Einrichtung der Methodenantwort darauf hinaus, eine [MethodResponse](https://docs.aws.amazon.com/apigateway/latest/api/API_MethodResponse.html)Ressource von API Gateway zu erstellen und die Eigenschaften von [statusCode](https://docs.aws.amazon.com/apigateway/latest/api/API_MethodResponse.html#statusCode), [ResponseParameters und ResponseModels](https://docs.aws.amazon.com/apigateway/latest/api/API_MethodResponse.html#responseParameters) festzulegen.](https://docs.aws.amazon.com/apigateway/latest/api/API_MethodResponse.html#responseModels) 

Wenn Sie Statuscodes für eine API-Methode festlegen, sollten Sie einen als Standard auswählen, um jede Integrationsantwort eines unerwarteten Statuscodes zu bearbeiten. Es ist sinnvoll, `500` als Standard festzulegen, da dies mit dem Umwandeln von ansonsten nicht zugeordneten Antworten als serverseitiger Fehler gleichzusetzen ist. Zur Vereinfachung legt die API Gateway-Konsole die `200`-Antwort als Standard fest. Sie können dies jedoch auf die `500`-Antwort zurücksetzen. 

Um eine Methodenantwort einzurichten, müssen Sie die Methodenanforderung erstellt haben. 

## Einrichten des Statuscodes der Methodenantwort
<a name="setup-method-response-status-code"></a>

Der Statuscode einer Methodenantwort definiert einen Antworttyp. Beispiel: Antworten von 200, 400 und 500 geben jeweils erfolgreiche, clientseitige Fehler und serverseitige Fehlerantworten an. 

Um den Statuscode einer Methodenantwort einzurichten, legen Sie die [https://docs.aws.amazon.com/apigateway/latest/api/API_MethodResponse.html#statusCode](https://docs.aws.amazon.com/apigateway/latest/api/API_MethodResponse.html#statusCode)-Eigenschaft auf einen HTTP-Statuscode fest. [put-method-response](https://docs.aws.amazon.com/cli/latest/reference/apigateway/put-method-response.html)Der folgende Befehl erstellt eine `200` Methodenantwort.

```
aws apigateway put-method-response \
    --rest-api-id vaz7da96z6 \ 
    --resource-id 6sxz2j \
    --http-method GET \
    --status-code 200
```

## Einrichten von Parametern der Methodenantwort
<a name="setup-method-response-parameters"></a>

Parameter der Methodenantwort definieren, welche Header der Client als Reaktion auf die zugeordnete Methodenanforderung erhält. Antwortparameter legen auch ein Ziel fest, dem API Gateway einen Parameter der Integrationsantwort entsprechend der Mappings zuweist, die in der Integrationsantwort der API beschrieben sind. 

Um die Parameter der Methodenantwort einzurichten, fügen Sie der [https://docs.aws.amazon.com/apigateway/latest/api/API_MethodResponse.html#responseParameters](https://docs.aws.amazon.com/apigateway/latest/api/API_MethodResponse.html#responseParameters)-Zuordnung der `MethodResponse`-Schlüssel-Wert-Paare im Format `"{parameter-name}":"{boolean}"` hinzu. Der folgende [put-method-response](https://docs.aws.amazon.com/cli/latest/reference/apigateway/put-method-response.html)Befehl legt den `my-header` Header fest.

```
aws apigateway put-method-response \
        --rest-api-id vaz7da96z6 \
        --resource-id 6sxz2j \
        --http-method GET \
        --status-code 200  \
        --response-parameters method.response.header.my-header=false
```

## Einrichten von Modellen der Methodenantwort
<a name="setup-method-response-models"></a>

 

 Ein Modell der Methodenantwort definiert ein Format des Textkörpers der Methodenantwort. Das Einrichten eines Methodenantwort-Modells ist erforderlich, wenn Sie einen stark typisierten SDK für die API generieren. Es stellt sicher, dass die Ausgabe an eine geeignete Klasse in Java oder Objective-C übergeben wird. In anderen Fällen ist das Einrichten eines Modells optional.

Bevor Sie das Antwortmodell einrichten können, müssen Sie das Modell zunächst in API Gateway erstellen. Dazu können Sie den Befehl `[create-model](https://docs.aws.amazon.com/cli/latest/reference/apigateway/create-model.html)` aufrufen. Der folgende [create-model](https://docs.aws.amazon.com/cli/latest/reference/apigateway/create-model.html)-Befehl erstellt das `PetStorePet`-Modell, um den Body der Antwort auf die Methodenanforderung `GET /pets/{petId}` zu beschreiben.

```
aws apigateway create-model \
    --rest-api-id vaz7da96z6 \
    --content-type application/json \
    --name PetStorePet \
    --schema '{ \
                  "$schema": "http://json-schema.org/draft-04/schema#", \
                  "title": "PetStorePet", \
                  "type": "object", \
                  "properties": { \
                    "id": { "type": "number" }, \
                    "type": { "type": "string" }, \
                    "price": { "type": "number" } \
                  } \
              }'
```

Das Ergebnis wird als eine API Gateway-[https://docs.aws.amazon.com/apigateway/latest/api/API_Model.html](https://docs.aws.amazon.com/apigateway/latest/api/API_Model.html)-Ressource erstellt.

Um die Methodenantwortmodelle zur Definition des Payload-Formats einzurichten, fügen Sie der Ressourcenzuweisung das Schlüssel-Wert-Paar „application/json“:“ PetStorePet "hinzu. [https://docs.aws.amazon.com/apigateway/latest/api/API_MethodResponse.html#responseModels](https://docs.aws.amazon.com/apigateway/latest/api/API_MethodResponse.html#responseModels) Der folgende [put-method-response](https://docs.aws.amazon.com/cli/latest/reference/apigateway/put-method-response.html)Befehl erstellt eine Methodenantwort, die ein Antwortmodell verwendet, um das Payload-Format zu definieren: 

```
aws apigateway put-method-response \
    --rest-api-id vaz7da96z6 \
    --resource-id 6sxz2j \
    --http-method GET \
    --status-code 200  \
    --response-parameters method.response.header.my-header=false \
    --response-models '{"application/json":"PetStorePet"}'
```