415 Tipo de mídia incompatível - Codificação não suportada

Esta é a documentação do Apigee Edge.
Acesse Documentação da Apigee X. informações

Sintoma

O aplicativo cliente recebe um código de status HTTP de 415 Unsupported Media Type com código de erro protocol.http.UnsupportedEncoding como uma resposta às chamadas de API.

Mensagem de erro

O aplicativo cliente recebe o seguinte código de resposta:

HTTP/1.1 415 Unsupported Media Type

Além disso, uma mensagem de erro semelhante a esta pode aparecer:

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

Causas possíveis

Esse erro ocorrerá se o valor do cabeçalho Content-Encoding especificado no a solicitação HTTP enviada pelo cliente para a Apigee ou a resposta HTTP enviada pelo servidor de back-end para A Apigee não tem as codificação compatível com a Apigee, de acordo com a especificação RFC 7231, seção 6.5.13: 415 Tipo de mídia incompatível.

Estas são as possíveis causas desse erro:

Etapas comuns do diagnóstico

Para diagnosticar o erro, é possível usar qualquer um dos seguintes métodos:

Causa: codificação incompatível na solicitação

Diagnóstico

1. Determine o código da falha e a fonte da falha do erro observado usando a API registros de acesso do Monitoring ou do NGINX, conforme explicado em Etapas comuns de diagnóstico.
2. Se o Código da falha for protocol.http.UnsupportedEncoding e o Código da falha Source tem o valor apigee ou MP, o que indica que o a solicitação enviada pelo aplicativo cliente contém uma codificação não suportada no cabeçalho da solicitação Content-Encoding.
3. É possível determinar o valor de codificação não compatível passada como parte da solicitação HTTP usando um dos seguintes métodos:

   Mensagem de erro

   Usar a mensagem de erro:

   1. Se você tiver acesso à mensagem de erro completa recebida do Apigee Edge, consulte ao faultstring. O campo faultstring contém o valor do atributo programação.

      Exemplo de mensagem de erro:

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

   2. Na mensagem de erro acima, observe que o valor da codificação não compatível é “UTF-8”, conforme mostrado em faultstring.

      Como “UTF-8” não é uma codificação compatível com a Apigee Edge, esta solicitação falha com o erro 415 Unsupported Media Type com o código de erro: protocol.http.UnsupportedEncoding

   Solicitação real

   Usando a solicitação real:

   1. Se você não tiver acesso à solicitação real feita pelo aplicativo cliente, acesse Resolução.
   2. Se você tiver acesso à solicitação real feita pelo aplicativo cliente, execute a etapas a seguir:
      1. Determine o valor transmitido ao cabeçalho da solicitação Content-Encoding.
      2. Se o valor transmitido ao cabeçalho da solicitação Content-Encoding não for um dos valores listados em Codificação compatível, a causa desse erro.

         Exemplo de solicitação:

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

         O exemplo de solicitação acima envia o valor "UTF-8" para o cabeçalho Content- Encoding, que não é um Codificação com suporte no Apigee Edge. Portanto, a solicitação falha com o erro 415 Unsupported Media Type, que contém o código de erro: protocol.http.UnsupportedEncoding.

Resolução

1. Consulte a lista de codificação com suporte da Apigee em Codificação compatível.
2. Verifique se o aplicativo cliente sempre envia o seguinte:
   • Somente a codificação compatível como o valor do cabeçalho Content-Encoding em a solicitação
   • O payload da solicitação no formato compatível para o Apigee Edge e corresponde ao formato especificado no cabeçalho Content-Encoding

3. No exemplo acima, o payload da solicitação tem uma extensão gz que indica que o conteúdo precisa ser gzip. Para corrigir o problema, envie o cabeçalho da solicitação como Content-Encoding: gzip e o payload da solicitação no formato gzip:

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

Causa: codificação sem suporte na resposta

Diagnóstico

1. Determine o código da falha e a fonte da falha do erro observado usando a API do Monitoring, da ferramenta Trace ou do NGINX, conforme explicado em Etapas comuns de diagnóstico.
2. Se a Origem da falha tiver o valor target, isso indica que o a resposta enviada pelo servidor de back-end contém codificações sem suporte no Content-Encoding.
3. É possível determinar o valor de codificação não compatível passada como parte da resposta HTTP do o servidor de back-end usando um destes métodos:

   Mensagem de erro

   Usar a mensagem de erro:

   1. Se você tiver acesso à mensagem de erro completa recebida do Apigee Edge, consulte o faultstring. O faultstring contém o valor do sem suporte.

      Exemplo de mensagem de erro:

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

   2. Na mensagem de erro acima, observe que o valor da codificação não compatível é “UTF-8”, conforme mostrado em faultstring.

      Como “UTF-8” não é uma codificação compatível com o Apigee Edge, este A solicitação falha com o erro 415 Unsupported Media Type com o código de erro: protocol.http.UnsupportedEncoding

   Ferramenta Trace

   Como usar o Trace:

   1. Se você não tiver o rastreamento da solicitação com falha, acesse Resolução.
   2. Se você capturou um rastro da falha, pode determinar os arquivos codificação transmitida pelo servidor de back-end como parte da resposta Content-Encoding conforme explicado na Ferramenta de rastreamento.

Resolução

1. Consulte a lista de codificação com suporte da Apigee em Codificação compatível
2. Verifique se o servidor de back-end sempre envia o seguinte:
   • Somente a codificação compatível como o valor da Cabeçalho Content-Encoding na solicitação
   • O payload de resposta no formato compatível com o Apigee Edge e corresponde ao formato especificado no cabeçalho Content-Encoding

Codificação com suporte

A tabela a seguir lista o formato de codificação compatível com o Apigee Edge:

Especificação

A Apigee responde com a resposta de erro 415 Unsupported Media Type conforme o seguinte especificação RFC:

Pontos principais a observar

Observe o seguinte:

• Se o erro 415 for retornado pela Apigee devido à transmissão sem suporte da codificação o cabeçalho Content-Encoding como parte da solicitação da API, em seguida:
  • Não será possível capturar o rastro para essas solicitações.

  • Você não poderá modificar o formato ou o conteúdo da resposta de erro enviada pelo Apigee Edge usando as políticas, como ElevateFault eAssignMessage.

  Isso ocorre porque esse erro ocorre em uma fase inicial no processador de mensagens antes política possa ser executada.

• Se o erro 415 for retornado pela Apigee devido à transmissão sem suporte da codificação no cabeçalho de resposta do servidor de back-end, ele terá que ser corrigido em no servidor de back-end para evitar esse erro. Trabalhe com sua equipe de back-end conforme apropriado para corrigir esse problema.

Se você ainda precisar de ajuda do suporte do Apigee Edge, Acesse É necessário coletar informações de diagnóstico.

É necessário coletar informações de diagnóstico

Se você ainda precisar de ajuda do suporte da Apigee, reúna as seguintes informações: informações de diagnóstico e entre em contato com o suporte do Apigee Edge:

Se você for um usuário da nuvem pública, forneça as seguintes informações:

• Nome da organização
• Nome do ambiente
• Nome do proxy da API
• Comando curl completo usado para reproduzir o erro 415
• Arquivo de rastreamento para as solicitações de API

Se você for um usuário da nuvem privada, forneça estas informações:

• Mensagem de erro completa observada para as solicitações com falha
• Nome do ambiente
• Pacote de proxy de API
• Arquivo de rastreamento para as solicitações de API

• Registros de acesso do NGINX /opt/apigee/var/log/edge-router/nginx/ORG~ENV.PORT#_access_log

  Onde:ORG, ENV e PORT# são substituídos por valores reais.

• Registros do sistema do processador de mensagens /opt/apigee/var/log/edge-message- processor/logs/system.log