415 Tipo di media non supportato - Codifica non supportata

Stai visualizzando la documentazione di Apigee Edge.
Vai alla documentazione di Apigee X. informazioni

Sintomo

L'applicazione client riceve un codice di stato HTTP 415 Unsupported Media Type con codice di errore protocol.http.UnsupportedEncoding in risposta alle chiamate API.

Messaggio di errore

L'applicazione client riceve il seguente codice di risposta:

HTTP/1.1 415 Unsupported Media Type

Inoltre, potrebbe essere visualizzato un messaggio di errore simile a quello mostrato di seguito:

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

Possibili cause

Questo errore si verifica se il valore dell'intestazione Content-Encoding specificato nella richiesta HTTP inviata dal client ad Apigee o nella risposta HTTP inviata dal server di backend ad Apigee non contiene la codifica supportata da Apigee, secondo la specifica RFC 7231, sezione 6.5.13: 415 tipo di media non supportato.

Le possibili cause di questo errore sono le seguenti:

Causa	Descrizione	Istruzioni per la risoluzione dei problemi applicabili a
Codifica non supportata utilizzata nella richiesta	L'intestazione della richiesta Content-Encoding contiene una codifica non supportata da Apigee Edge.	Utenti di cloud pubblico e privato perimetrale
Codifica non supportata utilizzata nella risposta	L'intestazione della risposta del server di backend Content-Encoding contiene una codifica non supportata da Apigee Edge.	Utenti di cloud pubblico e privato perimetrale

Passaggi di diagnosi più comuni

Per diagnosticare l'errore, puoi utilizzare uno dei seguenti metodi:

Causa: codifica non supportata nella richiesta

Diagnostica

1. Determina il codice di errore e l'origine dell'errore per l'errore osservato utilizzando i log di accesso dell'API Monitoring o NGINX, come spiegato nella sezione Passaggi comuni della diagnostica.
2. Se il codice di errore è protocol.http.UnsupportedEncoding e l'origine dell'errore ha il valore apigee o MP, significa che la richiesta inviata dall'applicazione client contiene una codifica non supportata nell'intestazione della richiesta Content-Encoding.
3. Puoi determinare il valore della codifica non supportata trasmessa come parte della richiesta HTTP utilizzando uno dei seguenti metodi:

   Messaggio di errore

   Tramite il messaggio di errore:

   1. Se hai accesso al messaggio di errore completo ricevuto da Apigee Edge, fai riferimento all'faultstring. faultstring contiene il valore della codifica di fine non supportata.

      Esempio di messaggio di errore:

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

   2. Nel messaggio di errore riportato sopra, nota che il valore della codifica non supportata è “UTF-8” come indicato in faultstring.

      Poiché “UTF-8” non è una codifica supportata in Apigee Edge, questa richiesta non va a buon fine e viene restituito l'errore 415 Unsupported Media Type con il codice di errore: protocol.http.UnsupportedEncoding.

   Richiesta effettiva

   Con la richiesta effettiva:

   1. Se non hai accesso alla richiesta effettiva effettuata dall'applicazione client, vai a Risoluzione.
   2. Se hai accesso alla richiesta effettiva effettuata dall'applicazione client, segui questi passaggi:
      1. Determina il valore passato all'intestazione della richiesta Content-Encoding.
      2. Se il valore passato all'intestazione della richiesta Content-Encoding non è uno dei valori elencati in Codifica supportata, questa è la causa di questo errore.

         Richiesta di esempio:

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

         La richiesta di esempio precedente invia il valore "UTF-8" all'intestazione Content- Encoding, che non è una codifica supportata in Apigee Edge. Pertanto, questa richiesta ha esito negativo e genera un errore 415 Unsupported Media Type con il codice di errore: protocol.http.UnsupportedEncoding.

Risoluzione

1. Consulta l'elenco delle codifiche supportate da Apigee in Codifica supportata.
2. Assicurati che l'applicazione client invii sempre quanto segue:
   • Solo la codifica supportata come valore dell'intestazione Content-Encoding nella richiesta
   • Il payload della richiesta nel formato supportato su Apigee Edge e corrisponde al formato specificato nell'intestazione Content-Encoding

3. Nell'esempio precedente, il payload della richiesta ha un'estensione gz, che indica che i contenuti devono essere gzip. Puoi risolvere il problema inviando l'intestazione della richiesta come Content-Encoding: gzip e il payload della richiesta in formato gzip:

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

Causa: codifica non supportata nella risposta

Diagnostica

1. Determina il codice di errore e l'origine dell'errore per l'errore osservato mediante i log degli accessi di API Monitoring, Trace Tool o NGINX, come spiegato nella sezione Passaggi comuni della diagnostica.
2. Se Origine dell'errore ha il valore target, significa che la risposta inviata dal server di backend contiene una codifica non supportata nell'intestazione Content-Encoding.
3. Puoi determinare il valore della codifica non supportata trasmessa come parte della risposta HTTP dal server di backend utilizzando uno dei seguenti metodi:

   Messaggio di errore

   Tramite il messaggio di errore:

   1. Se hai accesso al messaggio di errore completo ricevuto da Apigee Edge, fai riferimento all'faultstring. faultstring contiene il valore di una codifica non supportata.

      Esempio di messaggio di errore:

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

   2. Nel messaggio di errore riportato sopra, nota che il valore della codifica non supportata è “UTF-8” come indicato in faultstring.

      Poiché “UTF-8” non è una codifica supportata in Apigee Edge, questa richiesta non va a buon fine e genera un errore 415 Unsupported Media Type con il codice di errore: protocol.http.UnsupportedEncoding.

   Strumento Traccia

   Utilizzo di Trace:

   1. Se non hai la traccia per la richiesta non riuscita, vai a Risoluzione.
   2. Se hai acquisito una traccia per l'errore, puoi determinare la codifica non supportata trasmessa dal server di backend nell'ambito dell'intestazione della risposta Content-Encoding, come spiegato nello strumento Traccia.

Risoluzione

1. Consulta l'elenco delle codifiche supportate da Apigee in Codifica supportata
2. Assicurati che il server di backend invii sempre quanto segue:
   • Solo la codifica supportata come valore dell'intestazione Content-Encoding nella richiesta
   • Il payload della risposta nel formato supportato su Apigee Edge corrisponde al formato specificato nell'intestazione Content-Encoding

Codifica supportata

Nella tabella seguente sono elencati i formati di codifica supportati da Apigee Edge:

Titolo	Codifica	Descrizione
Content-Encoding	gzip	Formato Unix gzip
	deflate	Questo formato utilizza la struttura zlib con l'algoritmo di compressione deflate.

Specifiche

Apigee risponde con la risposta di errore 415 Unsupported Media Type in base alla seguente specifica RFC:

Specifiche
RFC 7231, sezione 6.5.13: 415 Tipo di supporto non supportato

Punti chiave da considerare

Tieni presente quanto segue:

• Se l'errore 415 viene restituito da Apigee a causa di una codifica non supportata passata nell'intestazione Content-Encoding come parte della richiesta API:
  • Non potrai acquisire la traccia per queste richieste.

  • Non potrai modificare il formato o il contenuto della risposta di errore inviata da Apigee Edge utilizzando criteri come RaiseFault, AssignMessage.

  Il motivo è che questo errore si verifica in una fase iniziale del processore di messaggi prima di poter eseguire qualsiasi criterio.

• Se Apigee restituisce l'errore 415 a causa di una codifica non supportata trasmessa nell'intestazione della risposta dal server di backend, deve essere corretta nel server di backend per evitare questo errore. Collabora con il team di backend per risolvere il problema.

Se hai ancora bisogno di assistenza da parte dell'Assistenza Apigee Edge, visita la pagina Raccogliere informazioni diagnostiche.

Devi raccogliere dati diagnostici

Se hai ancora bisogno di aiuto dall'Assistenza Apigee, raccogli le seguenti informazioni di diagnostica e contatta l'Assistenza Apigee Edge:

Se sei un utente del cloud pubblico, fornisci le seguenti informazioni:

• Nome dell'organizzazione.
• Nome ambiente
• Nome proxy API
• Comando curl completo utilizzato per riprodurre l'errore 415
• File di traccia per le richieste API

Se sei un utente Private Cloud, fornisci le seguenti informazioni:

• Messaggio di errore completo osservato per le richieste non riuscite
• Nome ambiente
• Bundle del proxy API
• File di traccia per le richieste API

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

  Dove: ORG, ENV e PORT# vengono sostituiti con i valori effettivi.

• Log di sistema del processore di messaggi /opt/apigee/var/log/edge-message- processor/logs/system.log