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.

# Verhalten bei Methodenanfragen für Payloads ohne Zuordnungsvorlagen für REST APIs in API Gateway
<a name="integration-passthrough-behaviors"></a>

Wenn Ihre Methodenanforderung Nutzdaten enthält und Sie keine Zuweisungsvorlage für den `Content-Type`-Header definiert haben, können Sie wählen, ob die vom Client bereitgestellten Anfragenutzdaten ohne Transformation über die Integrationsanforderung an das Backend weitergegeben werden. Dieser Prozess wird als "Integrations-Pass-Through" bezeichnet. 

 Das tatsächliche Passthrough-Verhalten einer eingehenden Anfrage wird durch diese Einstellung bestimmt. Es gibt drei Optionen: 

**Wenn keine Vorlage mit dem angeforderten Inhaltstyp-Header übereinstimmt**  
Wählen Sie diese Option, falls der Methodenanforderungstext ohne Umwandlung durch die Integrationsanforderung an das Backend übergeben werden soll, sofern der Inhaltstyp der Methodenanforderung keinem mit den Zuweisungsvorlagen verknüpften Inhaltstyp entspricht.  
Beim Aufruf der API-Gateway-API wählen Sie diese Option aus, indem Sie `WHEN_NO_MATCH` als `passthroughBehavior`-Eigenschaftswert für die [Integration](https://docs.aws.amazon.com/apigateway/latest/api/API_Integration.html) festlegen.

**Wenn keine Vorlagen definiert sind (empfohlen)**  
Wählen Sie diese Option, falls der Methodenanforderungstext ohne Umwandlung durch die Integrationsanforderung an das Backend übergeben werden soll, sofern in der Integrationsanforderung keine Zuweisungsvorlage definiert ist. Wenn eine Vorlage definiert und diese Option ausgewählt ist, wird die Methodenanforderung mit Nutzdaten und einem Inhaltstyp, der keiner definierten Zuweisungsvorlage entspricht, mit einer HTTP-415-Antwort (Nicht unterstützter Medientype) zurückgewiesen.  
Beim Aufruf der API-Gateway-API wählen Sie diese Option aus, indem Sie `WHEN_NO_TEMPLATES` als `passthroughBehavior`-Eigenschaftswert für die [Integration](https://docs.aws.amazon.com/apigateway/latest/api/API_Integration.html) festlegen.

**Niemals**  
Wählen Sie diese Option, falls der Methodenanforderungstext nicht ohne Umwandlung durch die Integrationsanforderung an das Backend übergeben werden soll, sofern in der Integrationsanforderung keine Zuweisungsvorlage definiert ist. Wenn eine Vorlage definiert und diese Option ausgewählt ist, wird die Methodenanforderung eines nicht zugeordneten Inhaltstyps mit einer Antwort "HTTP 415 Unsupported Media Type" zurückgewiesen.   
Beim Aufruf der API-Gateway-API wählen Sie diese Option aus, indem Sie `NEVER` als `passthroughBehavior`-Eigenschaftswert für die [Integration](https://docs.aws.amazon.com/apigateway/latest/api/API_Integration.html) festlegen.

 Die folgenden Beispiele veranschaulichen die möglichen Pass-Through-Verhalten. 

Beispiel 1: Eine Mapping-Vorlage wird in der Integrationsanforderung für den Content-Type `application/json` definiert.


| Inhaltstyp | Pass-Through-Option | Behavior | 
| --- | --- | --- | 
| Keine<br />API Gateway verwendet standardmäßig `application/json` | WHEN\_NO\_MATCH | Die Anforderungsnutzlast wird anhand der Vorlage umgewandelt. | 
| Keine<br />API Gateway verwendet standardmäßig `application/json` | WHEN\_NO\_TEMPLATES | Die Anforderungsnutzlast wird anhand der Vorlage umgewandelt. | 
| Keine<br />API Gateway verwendet standardmäßig `application/json` | NEVER | Die Anforderungsnutzlast wird anhand der Vorlage umgewandelt. | 
| application/json | WHEN\_NO\_MATCH | Die Anforderungsnutzlast wird anhand der Vorlage umgewandelt. | 
| application/json | WHEN\_NO\_TEMPLATES | Die Anforderungsnutzlast wird anhand der Vorlage umgewandelt. | 
| application/json | NEVER | Die Anforderungsnutzlast wird anhand der Vorlage umgewandelt. | 
| application/xml | WHEN\_NO\_MATCH | Die Anforderungsnutzlast wird nicht umgewandelt, sondern unverändert an das Backend gesendet. | 
| application/xml | WHEN\_NO\_TEMPLATES | Die Anforderung wird mit der HTTP-Antwort 415 Unsupported Media Type abgelehnt. | 
| application/xml | NEVER | Die Anforderung wird mit der HTTP-Antwort 415 Unsupported Media Type abgelehnt. | 

Beispiel 2: Eine Mapping-Vorlage wird in der Integrationsanforderung für den Content-Type `application/xml` definiert.


| Inhaltstyp | Pass-Through-Option | Behavior | 
| --- | --- | --- | 
| Keine<br />API Gateway verwendet standardmäßig `application/json` | WHEN\_NO\_MATCH | Die Anforderungsnutzlast wird nicht umgewandelt, sondern unverändert an das Backend gesendet. | 
| Keine<br />API Gateway verwendet standardmäßig `application/json` | WHEN\_NO\_TEMPLATES | Die Anforderung wird mit der HTTP-Antwort 415 Unsupported Media Type abgelehnt. | 
| Keine<br />API Gateway verwendet standardmäßig `application/json` | NEVER | Die Anforderung wird mit der HTTP-Antwort 415 Unsupported Media Type abgelehnt. | 
| application/json | WHEN\_NO\_MATCH | Die Anforderungsnutzlast wird nicht umgewandelt, sondern unverändert an das Backend gesendet. | 
| application/json | WHEN\_NO\_TEMPLATES | Die Anforderung wird mit der HTTP-Antwort 415 Unsupported Media Type abgelehnt. | 
| application/json | NEVER | Die Anforderung wird mit der HTTP-Antwort 415 Unsupported Media Type abgelehnt. | 
| application/xml | WHEN\_NO\_MATCH | Die Anforderungsnutzlast wird anhand der Vorlage umgewandelt. | 
| application/xml | WHEN\_NO\_TEMPLATES | Die Anforderungsnutzlast wird anhand der Vorlage umgewandelt. | 
| application/xml | NEVER | Die Anforderungsnutzlast wird anhand der Vorlage umgewandelt. | 

Beispiel 3: In der Integrationsanforderung sind keine Zuweisungsvorlagen definiert.


| Inhaltstyp | Pass-Through-Option | Behavior | 
| --- | --- | --- | 
| Keine<br />API Gateway verwendet standardmäßig `application/json` | WHEN\_NO\_MATCH | Die Anforderungsnutzlast wird nicht umgewandelt, sondern unverändert an das Backend gesendet. | 
| Keine<br />API Gateway verwendet standardmäßig `application/json` | WHEN\_NO\_TEMPLATES | Die Anforderungsnutzlast wird nicht umgewandelt, sondern unverändert an das Backend gesendet. | 
| Keine<br />API Gateway verwendet standardmäßig `application/json` | NEVER | Die Anforderung wird mit der HTTP-Antwort 415 Unsupported Media Type abgelehnt. | 
| application/json | WHEN\_NO\_MATCH | Die Anforderungsnutzlast wird nicht umgewandelt, sondern unverändert an das Backend gesendet. | 
| application/json | WHEN\_NO\_TEMPLATES | Die Anforderungsnutzlast wird nicht umgewandelt, sondern unverändert an das Backend gesendet. | 
| application/json | NEVER | Die Anforderung wird mit der HTTP-Antwort 415 Unsupported Media Type abgelehnt. | 
| application/xml | WHEN\_NO\_MATCH | Die Anforderungsnutzlast wird nicht umgewandelt, sondern unverändert an das Backend gesendet. | 
| application/xml | WHEN\_NO\_TEMPLATES | Die Anforderungsnutzlast wird nicht umgewandelt, sondern unverändert an das Backend gesendet. | 
| application/xml | NEVER | Die Anforderung wird mit der HTTP-Antwort 415 Unsupported Media Type abgelehnt. |