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.
Integrations-Pass-Through-Verhalten
Wenn bei Nicht-Proxyintegrationen eine Methodenanforderung eine Nutzlast enthält und entweder der Content-Type
-Header nicht der angegebenen Mapping-Vorlage entspricht oder keine Mapping-Vorlage definiert ist, können Sie die vom Client bereitgestellte Anforderungsnutzlast ohne Transformation über die Integrationsanforderung an das Backend weiterleiten. Dieser Prozess wird als "Integrations-Pass-Through" bezeichnet.
Bei Proxy-Integrationen leitet API Gateway die gesamte Anfrage an Ihr Backend weiter, und Sie haben nicht die Möglichkeit, das Passthrough-Verhalten zu ändern.
Das tatsächliche Pass-Through-Verhalten einer eingehenden Anforderung basiert auf der Option, die Sie beim Einrichten der Integrationsanforderung für eine bestimmte Mapping-Vorlage ausgewählt haben, und dem Content-Type-Header, den der Client in der eingehenden Anforderung festgelegt hat. 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.
- 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 bei Auswahl dieser Option eine Vorlage definiert ist, wird die Methodenanforderung eines Inhaltstyps, dem keine Zuordnung zugewiesen wurde, mit der Antwort HTTP 415 Nicht unterstützter Medientyp zurückgewiesen.
- 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 bei Auswahl dieser Option eine Vorlage definiert ist, wird die Methodenanforderung eines Inhaltstyps, dem keine Zuordnung zugewiesen wurde, mit der Antwort HTTP 415 Nicht unterstützter Medientyp zurückgewiesen.
Die folgenden Beispiele veranschaulichen das mögliche Pass-Through-Verhalten.
Beispiel 1: Eine Mapping-Vorlage wird in der Integrationsanforderung für den Content-Type application/json
definiert.
Content-Type-Header\ausgewählte Pass-Through-Option | WHEN_NO_MATCH |
WHEN_NO_TEMPLATES |
NEVER |
---|---|---|---|
Keine (standardmäßig application/json ) |
Die Anforderungsnutzlast wird anhand der Vorlage umgewandelt. | Die Anforderungsnutzlast wird anhand der Vorlage umgewandelt. | Die Anforderungsnutzlast wird anhand der Vorlage umgewandelt. |
application/json |
Die Anforderungsnutzlast wird anhand der Vorlage umgewandelt. | Die Anforderungsnutzlast wird anhand der Vorlage umgewandelt. | Die Anforderungsnutzlast wird anhand der Vorlage umgewandelt. |
application/xml |
Die Anforderungsnutzlast wird nicht umgewandelt, sondern unverändert an das Backend gesendet. | Die Anfrage wird mit einer HTTP 415 Unsupported Media
Type Antwort zurückgewiesen. |
Die Anfrage wird mit einer HTTP 415 Unsupported Media
Type Antwort abgelehnt. |
Beispiel 2: Eine Mapping-Vorlage wird in der Integrationsanforderung für den Content-Type application/xml
definiert.
Content-Type-Header\ausgewählte Pass-Through-Option | WHEN_NO_MATCH |
WHEN_NO_TEMPLATES |
NEVER |
---|---|---|---|
Keine (Standard application/json ) |
Die Anforderungsnutzlast wird nicht umgewandelt, sondern unverändert an das Backend gesendet. | Die Anfrage wird mit einer HTTP 415 Unsupported Media
Type Antwort abgelehnt. |
Die Anfrage wird mit einer HTTP 415 Unsupported Media
Type Antwort abgelehnt. |
application/json |
Die Anforderungsnutzlast wird nicht umgewandelt, sondern unverändert an das Backend gesendet. | Die Anfrage wird mit einer HTTP 415 Unsupported Media
Type Antwort abgelehnt. |
Die Anfrage wird mit einer HTTP 415 Unsupported Media
Type Antwort abgelehnt. |
application/xml |
Die Anforderungsnutzlast wird anhand der Vorlage umgewandelt. | Die Anforderungsnutzlast wird anhand der Vorlage umgewandelt. | Die Anforderungsnutzlast wird anhand der Vorlage umgewandelt. |