415 サポートされていないメディアタイプ - サポートされていないエンコード

現在、Apigee Edge のドキュメントを表示しています。
Apigee X のドキュメントをご確認ください。 情報

内容

クライアント アプリケーションが、API 呼び出しへのレスポンスとして HTTP ステータス コード 415 Unsupported Media Type とエラーコード protocol.http.UnsupportedEncoding を受け取ります。

エラー メッセージ

クライアント アプリケーションが次のレスポンス コードを受け取ります。

HTTP/1.1 415 Unsupported Media Type

また、以下のようなエラー メッセージが表示される場合もあります。

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

考えられる原因

このエラーは、クライアントが Apigee に送信された HTTP リクエストまたはバックエンド サーバーから Apigee に送信された HTTP レスポンスで指定された Content-Encoding ヘッダーの値に、仕様 RFC 7231、セクション 6.5.13: 415 Unsupported Media Type に従い、Apigee によってサポートされているエンコードが含まれていない場合に発生します。

このエラーには、次のような原因が考えられます。

原因	説明	トラブルシューティングの実施対象
サポートされていないエンコードがリクエストで使用されている	リクエスト ヘッダー Content-Encoding に、Apigee Edge でサポートされていないエンコードが含まれています。	Edge Public Cloud ユーザーと Private Cloud ユーザー
サポートされていないエンコードがレスポンスで使用されています	バックエンド サーバーのレスポンス ヘッダー Content-Encoding に、Apigee Edge でサポートされていないエンコードが含まれています。	Edge Public Cloud ユーザーと Private Cloud ユーザー

共通の診断手順

エラーを診断するには、次のいずれかの方法を使用します。

原因: リクエストでサポートされていないエンコード

診断

1. 一般的な診断手順で説明されているように、API Monitoring または NGINX アクセスログを使用して確認されたエラーの障害コードと障害ソースを特定します。
2. [Fault Code] が protocol.http.UnsupportedEncoding で、[Fault Source] の値が apigee または MP の場合、クライアント アプリケーションから送信されたリクエストのリクエスト ヘッダー Content-Encoding に、サポートされていないエンコードが含まれていることを示します。
3. HTTP リクエストの一部として渡される、サポートされていないエンコードの値は、次のいずれかの方法で確認できます。

   エラー メッセージ

   該当するエラー メッセージの場合:

   1. Apigee Edge から受信した完全なエラー メッセージにアクセスできる場合は、faultstring を参照してください。faultstring には、サポートされていない終了コードの値が含まれます。

      エラー メッセージの例:

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

   2. 上記のエラー メッセージで、サポートされていないエンコードの値は faultstring にある “UTF-8” です。

      “UTF-8” は Apigee Edge でサポートされていないエンコードであるため、このリクエストは 415 Unsupported Media Type エラーで失敗します（エラーコード: protocol.http.UnsupportedEncoding）。

   実際のリクエスト

   実際のリクエストを使用する場合:

   1. クライアント アプリケーションから行われた実際のリクエストにアクセスできない場合は、解決策に進みます。
   2. クライアント アプリケーションによって行われた実際のリクエストにアクセスできる場合は、次の手順を行います。
      1. リクエスト ヘッダー Content-Encoding. に渡される値を確認します。
      2. リクエスト ヘッダー Content-Encoding に渡される値が、サポートされているエンコードに示されている値でない場合、それがこのエラーの原因です。

         リクエストの例:

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

         上記のサンプル リクエストは値 "UTF-8" を Content- Encoding ヘッダーに送信します。これは Apigee Edge で サポートされているエンコードではありません。このため、このリクエストは 415 Unsupported Media Type エラー（エラーコード: protocol.http.UnsupportedEncoding）で失敗します。

解像度

1. サポートされているエンコードの、Apigee でサポートされているエンコードのリストをご覧ください。
2. クライアント アプリケーションが常に以下を送信することを確認します。
   • リクエストの Content-Encoding ヘッダーの値としてサポートされているエンコードのみ
   • Apigee Edge に対してサポートされている形式でリクエスト ペイロード。Content-Encoding ヘッダーで指定された形式と一致します。

3. 上記の例では、リクエスト ペイロードに gz 拡張が含まれており、コンテンツが gzip でなければならないことを示しています。この問題を解決するには、リクエスト ヘッダーを Content-Encoding: gzip として、リクエスト ペイロードを gzip 形式で送信します。

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

原因: レスポンスでサポートされていないエンコード

診断

1. 一般的な診断手順で説明されているように、API Monitoring、Trace Tool、または NGINX アクセスログを使用して確認されたエラーの障害コードと障害ソースを特定します。
2. [Fault Source] の値が target の場合、バックエンド サーバーから送信されたレスポンスの Content-Encoding ヘッダーに、サポートされていないエンコードが含まれていることを示します。
3. バックエンド サーバーから HTTP レスポンスの一部として渡される、サポートされていないエンコードの値は、次のいずれかの方法で確認できます。

   エラー メッセージ

   該当するエラー メッセージの場合:

   1. Apigee Edge から受信した完全なエラー メッセージにアクセスできる場合は、faultstring を参照してください。faultstring には、サポートされていないエンコードの値が含まれます。

      エラー メッセージの例:

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

   2. 上記のエラー メッセージで、サポートされていないエンコードの値は faultstring にある “UTF-8” です。

      “UTF-8” は Apigee Edge でサポートされていないエンコードであるため、このリクエストは 415 Unsupported Media Type エラーで失敗します（エラーコード: protocol.http.UnsupportedEncoding）。

   Trace ツール

   Trace の使用:

   1. 失敗したリクエストのトレースがない場合は、解決策に進みます。
   2. 障害のトレースをキャプチャしたら、Trace ツールで説明されているように、バックエンド サーバーから渡されたサポートされていないエンコードを Content-Encoding レスポンス ヘッダーの一部として確認できます。

解像度

1. サポートされているエンコードで、Apigee でサポートされているエンコードのリストをご覧ください。
2. バックエンド サーバーが常に以下を送信することを確認します。
   • リクエストの Content-Encoding ヘッダーの値として、サポートされているエンコードのみ
   • Apigee Edge に対してサポートされている形式で、Content-Encoding ヘッダーで指定された形式のレスポンス ペイロード

サポートされているエンコード

次の表に、Apigee Edge でサポートされているエンコード形式を示します。

ヘッダー	エンコード	説明
Content-Encoding	gzip	Unix gzip 形式
	deflate	この形式では、zlib 構造とデフレート圧縮アルゴリズムを使用します。

仕様

Apigee は、次の RFC 仕様に従って 415 Unsupported Media Type エラー レスポンスを返します。

仕様
RFC 7231、section 6.5.13: 415 Unsupported Media Type

重要なポイント

次の点に注意してください。

• API リクエストの一部として Content-Encoding ヘッダーでサポートされていないエンコードが渡されたため、Apigee から 415 エラーが返された場合:
  • このようなリクエストのトレースはキャプチャできません。

  • RaiseFault、AssignMessage などのポリシーを使用して、Apigee Edge によって送信されるエラー レスポンスの形式や内容を変更することはできません。

  このエラーは、ポリシーの実行前に Message Processor の初期段階で発生するためです。

• バックエンド サーバーからレスポンス ヘッダーで渡されるサポートされていないエンコードが原因で Apigee から 415 エラーが返された場合、このエラーを回避するにはバックエンド サーバーで修正する必要があります。必要に応じてバックエンド チームと連携して、この問題を修正してください。

Apigee Edge サポートのサポートが必要な場合は、診断情報の収集が必要な場合をご覧ください。

診断情報の収集が必要な場合

Apigee サポートのサポートが必要な場合は、次の診断情報を収集して、Apigee Edge サポートに連絡してください。

Public Cloud ユーザーの場合は、次の情報を入力します。

• 組織の名前
• 環境名
• API プロキシ名
• 415 エラーを再現するための完全な curl コマンド
• API リクエストのトレース ファイル

Private Cloud ユーザーの場合は、次の情報を入力します。

• 失敗したリクエストについて確認された完全なエラー メッセージ
• 環境名
• API プロキシ バンドル
• API リクエストのトレース ファイル

• NGINX アクセスログ /opt/apigee/var/log/edge-router/nginx/ORG~ENV.PORT#_access_log

  ここで、ORG、ENV、PORT# は実際の値に置き換えられます。

• Message Processor のシステムログ /opt/apigee/var/log/edge-message- processor/logs/system.log