415 Nicht unterstützter Medientyp – nicht unterstützte Codierung

Sie sehen die Dokumentation zu Apigee Edge.
Zur Apigee X-Dokumentation weitere Informationen

Symptom

Die Clientanwendung erhält als Antwort auf API-Aufrufe den HTTP-Statuscode 415 Unsupported Media Type mit dem Fehlercode protocol.http.UnsupportedEncoding .

Fehlermeldung

Die Clientanwendung ruft den folgenden Antwortcode ab:

HTTP/1.1 415 Unsupported Media Type

Außerdem wird möglicherweise eine Fehlermeldung wie die folgende angezeigt:

{
   "fault":{
      "faultstring":"Unsupported Encoding \"UTF-8\"",
      "detail":{
         "errorcode":"protocol.http.UnsupportedEncoding"
      }
   }
}

Mögliche Ursachen

Dieser Fehler tritt auf, wenn der Wert des Headers Content-Encoding, der entweder in der vom Client an Apigee gesendeten HTTP-Anfrage oder der HTTP-Antwort, die vom Back-End-Server an Apigee gesendet wird, nicht die von Apigee unterstützte Codierung gemäß der Spezifikation RFC 7231, Abschnitt 6.5.13: 415 Nicht unterstützter Medientyp enthält.

Mögliche Ursachen für diesen Fehler:

Ursache	Beschreibung	Anleitungen zur Fehlerbehebung gelten für
Nicht unterstützte Codierung in der Anfrage	Der Anfrageheader Content-Encoding enthält eine Codierung, die von Apigee Edge nicht unterstützt wird.	Nutzer von Edge Public und Private Cloud
Nicht unterstützte Codierung in der Antwort	Der Antwortheader Content-Encoding des Back-End-Servers enthält eine Codierung, die von Apigee Edge nicht unterstützt wird.	Nutzer von Edge Public und Private Cloud

Allgemeine Diagnoseschritte

Zur Diagnose des Fehlers können Sie eine der folgenden Methoden verwenden:

Ursache: Nicht unterstützte Codierung in der Anfrage

Diagnose

1. Bestimmen Sie den Fehlercode und die Fehlerquelle für den beobachteten Fehler mithilfe von API-Monitoring oder NGINX-Zugriffslogs, wie unter Allgemeine Diagnoseschritte erläutert.
2. Wenn der Fehlercode protocol.http.UnsupportedEncoding lautet und die Fehlerquelle den Wert apigee oder MP hat, weist dies darauf hin, dass die von der Clientanwendung gesendete Anfrage eine nicht unterstützte Codierung im Anfrageheader Content-Encoding enthält.
3. Du kannst den Wert der nicht unterstützten Codierung, die als Teil der HTTP-Anfrage übergeben wird, mit einer der folgenden Methoden ermitteln:

   Fehlermeldung

   Über die Fehlermeldung:

   1. Wenn Sie Zugriff auf die vollständige Fehlermeldung von Apigee Edge haben, lesen Sie die faultstring. faultstring enthält den Wert der nicht unterstützten Endcodierung.

      Beispiel für eine Fehlermeldung:

      "faultstring":"Unsupported Encoding \"UTF-8\""
      

   2. Beachten Sie in der obigen Fehlermeldung, dass der Wert der nicht unterstützten Codierung “UTF-8” ist, wie in faultstring zu sehen.

      Da “UTF-8” keine unterstützte Codierung in Apigee Edge ist, schlägt diese Anfrage mit dem Fehler 415 Unsupported Media Type und dem Fehlercode protocol.http.UnsupportedEncoding fehl.

   Tatsächliche Anfrage

   Tatsächliche Anfrage verwenden:

   1. Wenn Sie keinen Zugriff auf die eigentliche Anfrage der Clientanwendung haben, wechseln Sie zu Lösung.
   2. Wenn Sie Zugriff auf die eigentliche Anfrage der Clientanwendung haben, führen Sie die folgenden Schritte aus:
      1. Ermitteln Sie den Wert, der an den Anfrageheader Content-Encoding. übergeben wird.
      2. Wenn der an den Anfrageheader Content-Encoding übergebene Wert keiner der unter Unterstützte Codierung aufgeführten Werte ist, ist das die Ursache für diesen Fehler.

         Beispielanfrage:

         curl -v "https://HOSTALIAS/v1/testgzip" -H "Content-Encoding: UTF-8" -X POST -d @request_payload.gz
         

         Die obige Beispielanfrage sendet den Wert "UTF-8" an den Header Content- Encoding, was keine unterstützte Codierung in Apigee Edge ist. Daher schlägt diese Anfrage mit dem Fehler 415 Unsupported Media Type und dem Fehlercode fehl: protocol.http.UnsupportedEncoding.

Auflösung

1. Eine Liste der von Apigee unterstützten Codierungen finden Sie unter Unterstützte Codierung.
2. Achten Sie darauf, dass die Clientanwendung immer Folgendes sendet:
   • Nur die unterstützte Codierung als Wert für den Content-Encoding-Header in der Anfrage
   • Die Nutzlast der Anfrage an Apigee Edge im unterstützten Format und entspricht dem im Content-Encoding-Header angegebenen Format

3. Im obigen Beispiel hat die Nutzlast der Anfrage eine gz-Erweiterung, die angibt, dass der Inhalt gzip sein muss. Sie können das Problem beheben, indem Sie den Anfrageheader als Content-Encoding: gzip und die Anfragenutzlast im Format gzip senden:

   curl -v "https://HOSTALIAS/v1/testgzip" -H "Content-Encoding: gzip" -X POST -d @request_payload.gz
   

Ursache: Nicht unterstützte Codierung in der Antwort

Diagnose

1. Bestimmen Sie den Fehlercode und die Fehlerquelle für den beobachteten Fehler mithilfe von API-Monitoring, Trace-Tool oder NGINX-Zugriffslogs, wie unter Allgemeine Diagnoseschritte erläutert.
2. Wenn die Fehlerquelle den Wert target hat, weist dies darauf hin, dass die vom Back-End-Server gesendete Antwort eine nicht unterstützte Codierung im Content-Encoding-Header enthält.
3. Sie können den Wert der nicht unterstützten Codierung als Teil der HTTP-Antwort vom Back-End-Server mit einer der folgenden Methoden ermitteln:

   Fehlermeldung

   Über die Fehlermeldung:

   1. Wenn Sie Zugriff auf die vollständige Fehlermeldung von Apigee Edge haben, lesen Sie die faultstring. faultstring enthält den Wert der nicht unterstützten Codierung.

      Beispiel für eine Fehlermeldung:

      "faultstring":"Unsupported Encoding \"UTF-8\""
      

   2. Beachten Sie in der obigen Fehlermeldung, dass der Wert der nicht unterstützten Codierung “UTF-8” ist, wie in faultstring zu sehen.

      Da “UTF-8” in Apigee Edge keine unterstützte Codierung ist, schlägt diese Anfrage mit dem Fehler 415 Unsupported Media Type und dem Fehlercode protocol.http.UnsupportedEncoding fehl.

   Trace-Tool

   Trace verwenden:

   1. Wenn Sie das Trace für die fehlgeschlagene Anfrage nicht haben, wechseln Sie zu Lösung.
   2. Wenn Sie ein Trace für den Fehler erfasst haben, können Sie die nicht unterstützte Codierung ermitteln, die vom Back-End-Server als Teil des Antwortheaders Content-Encoding übergeben wird, wie unter Trace-Tool erläutert.

Auflösung

1. Eine Liste der von Apigee unterstützten Codierungen finden Sie unter Unterstützte Codierung.
2. Achten Sie darauf, dass der Back-End-Server immer Folgendes sendet:
   • Nur die unterstützte Codierung als Wert für den Content-Encoding-Header in der Anfrage
   • Die Antwortnutzlast im unterstützten Format an Apigee Edge und entspricht dem im Content-Encoding-Header angegebenen Format

Unterstützte Codierung

In der folgenden Tabelle ist das von Apigee Edge unterstützte Codierungsformat aufgeführt:

Header	Codierung	Beschreibung
Content-Encoding	gzip	Das Unix-Format gzip
	deflate	Dieses Format verwendet die zlib-Struktur mit Deflate-Komprimierungsalgorithmus.

Spezifikation

Apigee antwortet mit der Fehlerantwort 415 Unsupported Media Type gemäß der folgenden RFC-Spezifikation:

Spezifikation
RFC 7231, Abschnitt 6.5.13: 415 Nicht unterstützter Medientyp

Wichtige Hinweise

Wichtige Hinweise:

• Wenn der Fehler 415 von Apigee aufgrund einer nicht unterstützten Codierung im Content-Encoding-Header als Teil der API-Anfrage zurückgegeben wird, dann:
  • Sie können den Trace für solche Anfragen nicht erfassen.

  • Sie können das Format oder den Inhalt der Fehlerantwort, die von Apigee Edge gesendet wurde, nicht mit Richtlinien wie IncreaseFault oderAssignMessage ändern.

  Das liegt daran, dass dieser Fehler in einem frühen Stadium im Message Processor auftritt, bevor eine Richtlinie ausgeführt werden kann.

• Wenn der Fehler 415 von Apigee aufgrund einer nicht unterstützten Codierung im Antwortheader Ihres Back-End-Servers zurückgegeben wird, muss dies auf dem Back-End-Server behoben werden, um diesen Fehler zu vermeiden. Wenden Sie sich gegebenenfalls an Ihr Back-End-Team, um dieses Problem zu beheben.

Wenn Sie weiterhin Unterstützung vom Apigee Edge-Support benötigen, lesen Sie den Hilfeartikel Diagnoseinformationen müssen erfasst werden.

Erfassen von Diagnoseinformationen erforderlich

Wenn Sie weiterhin Unterstützung vom Apigee-Support benötigen, stellen Sie die folgenden Diagnoseinformationen zusammen und wenden Sie sich an den Apigee Edge-Support:

Wenn Sie ein Public Cloud-Nutzer sind, geben Sie die folgenden Informationen an:

• Name der Organisation
• Name der Umgebung
• API-Proxy-Name
• Führen Sie den Befehl curl aus, mit dem der Fehler 415 reproduziert wurde
• Ablaufverfolgungsdatei für die API-Anfragen

Wenn Sie ein Private Cloud-Nutzer sind, geben Sie die folgenden Informationen an:

• Vollständige Fehlermeldung bei fehlgeschlagenen Anfragen
• Name der Umgebung
• API-Proxy-Bundle
• Ablaufverfolgungsdatei für die API-Anfragen

• NGINX-Zugriffslogs /opt/apigee/var/log/edge-router/nginx/ORG~ENV.PORT#_access_log

  Hierbei gilt: ORG, ENV und PORT# werden durch tatsächliche Werte ersetzt.

• Systemprotokolle von Message Processor /opt/apigee/var/log/edge-message- processor/logs/system.log