Verhalten bei Methodenanfragen für Payloads ohne Zuordnungsvorlagen für REST APIs in API Gateway - Amazon API Gateway

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

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 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 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 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

API Gateway verwendet standardmäßig application/json

 WHEN_NO_MATCH Die Anforderungsnutzlast wird anhand der Vorlage umgewandelt.

Keine

API Gateway verwendet standardmäßig application/json

 WHEN_NO_TEMPLATES Die Anforderungsnutzlast wird anhand der Vorlage umgewandelt.

Keine

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

API Gateway verwendet standardmäßig application/json

 WHEN_NO_MATCH Die Anforderungsnutzlast wird nicht umgewandelt, sondern unverändert an das Backend gesendet.

Keine

API Gateway verwendet standardmäßig application/json

 WHEN_NO_TEMPLATES Die Anforderung wird mit der HTTP-Antwort 415 Unsupported Media Type abgelehnt.

Keine

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

API Gateway verwendet standardmäßig application/json

 WHEN_NO_MATCH Die Anforderungsnutzlast wird nicht umgewandelt, sondern unverändert an das Backend gesendet.

Keine

API Gateway verwendet standardmäßig application/json

 WHEN_NO_TEMPLATES Die Anforderungsnutzlast wird nicht umgewandelt, sondern unverändert an das Backend gesendet.

Keine

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.