ランタイム エラー カタログ

<ph type="x-smartling-placeholder"></ph> 現在、Apigee Edge のドキュメントが表示されています。
Apigee X のドキュメント
詳細

<ph type="x-smartling-placeholder">

Apigee Edge でのエラー

Apigee Edge、Apigee Edge コンポーネントの Router と Message Processor、またはバックエンドを介して API リクエストが行われた場合 クライアント アプリケーションにエラーを返すことができます。

Message Processor からのエラー

Message Processor は Apigee Edge のコア コンポーネントであり、ポリシーを処理し、 バックエンドサーバーとやり取りします次のような問題が検出された場合は、エラーが返されることがあります。

  • ネットワーク接続の問題、TLS handshake の失敗、バックエンド サーバーを使用できない、バックエンド サーバーとの通信中のレスポンスの欠如
  • ポリシー実行時の障害
  • 無効な HTTP ヘッダー、エンコード、パス、HTTP 仕様に準拠していない、製品の制限を超えているなど
    • クライアント アプリケーションから送信された HTTP リクエストを使用
    • または

    • バックエンド サーバーによって送信された HTTP レスポンスを使用
  • その他

Message Processor からのエラーの例

Message Processor では、常に HTTP ステータス コードとエラー メッセージに加えて、次のような JSON 形式のエラーコードが返されます。

クライアント アプリケーションは、次の例のようなレスポンス コードを取得します。

HTTP/1.1 414 Request-URI Too Long

Message Processor からのエラー レスポンスは次の形式で表示されます。

{
   "fault":{
      "faultstring":"request line size exceeding 7,168",
      "detail":{
         "errorcode":"protocol.http.TooBigLine"
      }
   }
}
<ph type="x-smartling-placeholder">

エラー レスポンスのフィールドの説明:

フィールド 説明
faultstring 考えられるエラー原因を示すエラー メッセージが含まれます。
errorcode エラーに関連付けられているエラーコード(障害コードとも呼ばれます)

ランタイム エラー カタログ

このエラーカタログには、ランタイムについて知っておくべきすべての情報が含まれています。 Apigee Edge メッセージによって返されるエラーコード(ポリシー以外のエラーの場合) プロセッサ コンポーネント。各エラーコードについて、次の情報が含まれています。

  • HTTP ステータス コード
  • エラー メッセージ
  • 考えられるエラー原因
  • 関連する HTTP 仕様やプロダクトの制限
  • エラーの原因を診断する手順と、エラーを自分で解決するために適用できる効果的な解決策(利用可能な場合)が記載されているハンドブックと動画
  • ご自身によるエラー解決策

次のエラーコード カテゴリが対象となります。

下の [検索] ボックスを使って表をフィルタリングすれば、特定のエラーコードについて上記の情報を確認できます。表内の任意のフィールドのステータス コードまたはコンテンツを検索できます。

エラーコード 説明 修正

flow.*

flow.APITimedOut

  • HTTP ステータス コード:
504 Gateway Timeout
  • エラー メッセージ:
API timed out
  • 考えられる原因:

このエラーは、次の場合に発生します。

  • バックエンド サーバーからの応答が、特定の API プロキシのプロパティ api.timeout で構成されているタイムアウト期間内に戻ってこない。
  • オペレーションの計算負荷が高い、あるいは高負荷、低パフォーマンスな状態にあるため、ポリシーの実行に時間がかかっている。

注: このハンドブックでは、エラーコードのトラブルシューティングを行う手順を説明します。 messaging.adaptors.http.flow.GatewayTimeout、ただし、 同じハンドブックで flow.APITimedOut エラーコードのトラブルシューティングを行います。

<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> ハンドブック

flow.SharedFlowNotFound

  • HTTP ステータス コード:
500 Internal Server Error
  • エラー メッセージ:
Shared Flow {shared_flow_name} Not Found
  • 考えられる原因:

このエラーは、特定の共有フローが次の場合に発生します。

  • 存在しない
  • または

  • 存在するがデプロイされていない
<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> ハンドブック

messaging.adaptors.http.flow

messaging.adaptors.http.flow.ApplicationNotFound

  • HTTP ステータス コード:
404 Not Found
  • エラー メッセージ:
Unable to identify proxy for host: {virtual_host} and url: {pathsuffix}
  • 考えられる原因:

このエラーは、次のいずれかのシナリオで発生します。

  1. 具体的な API プロキシは次のとおりです。
    1. リクエストを受け入れるように構成されていない 仮想ホスト
    2. 特定のパスでリクエストを受け入れるように構成されていない リクエストで使用
    3. 対象の特定の環境にデプロイされていない API リクエストを
    4. 1 つ以上の Message Processor にデプロイされていない
  2. 作成しようとしている特定の環境 API リクエストが 1 つ以上の Message Processor に読み込まれていない
<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> ハンドブック
このエラーは、複数の仮想ホストで同じホストを使用している場合にも発生することがあります。 エイリアスとポート番号です <ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> ハンドブック

messaging.adaptors.http.flow.DecompressionFailureAtRequest

  • HTTP ステータス コード:
400 Bad Request
  • エラー メッセージ:
Decompression failure at request
  • 考えられる原因:

このエラーは、次の場合にのみ発生します。

  • HTTP リクエスト ヘッダーで指定されたエンコード Content-Encoding は有効で、 <ph type="x-smartling-placeholder"></ph> Apigee Edge でサポートされている
  • ただし

  • HTTP リクエストの一部としてクライアントから送信されるペイロードの形式が、Content-Encoding ヘッダーで指定されたエンコード形式と一致していない
<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> ハンドブック

messaging.adaptors.http.flow.DecompressionFailureAtResponse

  • HTTP ステータス コード:
502 Bad Gateway
  • エラー メッセージ:
Decompression failure at response
  • 考えられる原因:

このエラーは、次の場合にのみ発生します。

  • バックエンド/ターゲット サーバーの HTTP レスポンス ヘッダー Content-Encoding が有効であり、 <ph type="x-smartling-placeholder"></ph> Apigee Edge でサポートされている
  • ただし

  • HTTP レスポンスの一部としてバックエンド / ターゲット サーバーによって送信されるペイロード形式が、Content-Encoding ヘッダーで指定されたエンコード形式と一致していない
<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> ハンドブック

messaging.adaptors.http.flow.ErrorResponseCode

  • HTTP ステータス コード:
500

<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> ハンドブック

<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> 動画

  • エラー メッセージ:
エラー メッセージと形式は、バックエンド サーバーの実装によって異なります。
  • 考えられる原因:
このエラーは、バックエンド サーバーがステータスで応答した場合に発生します。 コード 500 を Apigee Edge に送信します。
  • HTTP ステータス コード:
503

<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> ハンドブック

<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> 動画

  • エラー メッセージ:
エラー メッセージと形式は、バックエンド サーバーの実装によって異なります。
  • 考えられる原因:
このエラーは、バックエンド サーバーがステータスで応答した場合に発生します。 コード 503 を Apigee Edge に送信します。
  • HTTP ステータス コード:
504 <ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> ハンドブック
  • エラー メッセージ:
エラー メッセージと形式は、バックエンド サーバーの実装によって異なります。
  • 考えられる原因:
このエラーは、バックエンド サーバーがステータスで応答した場合に発生します。 コード 504 を Apigee Edge に送信します。

注: エラーコード messaging.adaptors.http.flow.ErrorResponseCode はクライアント アプリケーションに送信されるエラー メッセージの一部として返されません。これは、 このエラーコードは、バックエンド サーバーの実行時に エラーと 4XX または 5XX のいずれかが返される ステータス コードが返されます。このエラーコードは、API Monitoring、NGINX アクセスログ、 分析データベースなどです。

messaging.adaptors.http.flow.GatewayTimeout

  • HTTP ステータス コード:
504 Gateway Timeout
  • エラー メッセージ:
Gateway Timeout
  • 考えられる原因:
このエラーは、バックエンド サーバーが応答しない場合に発生します。 Apigee Edge Message Processor です。 <ph type="x-smartling-placeholder"></ph> I/O タイムアウト期間
<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> ハンドブック

messaging.adaptors.http.flow.LengthRequired

  • HTTP ステータス コード:
411 Length Required
  • エラー メッセージ:
'Content-Length' is missing
  • 考えられる原因:

このエラーは、Content-Length ヘッダーが渡されなかった場合に発生します。 HTTP POST および PUT の一部としてのクライアント アプリケーション リクエストの数を表します。

注: このエラーによって失敗したリクエストは、Trace ツールでキャプチャできません。これは、Message Processor が、リクエストを処理し、API プロキシで任意のポリシーを実行するよりかなり前の段階でこの検証を行うためです。

  • HTTP の仕様:
RFC セクション 3.3.2: Content-Length

修正

このエラーに対処する手順は次のとおりです。

  1. クライアント アプリケーションが常にヘッダーを渡すようにする HTTP POST の一部としての Content-Length と Apigee Edge に送信された PUT リクエスト。例:

    curl -X POST https://HOSTALIAS/PATH -d '{"name": "abc"}' -H "Content-Length: 15"
    
  2. POST リクエストと PUT リクエストで空のペイロードを渡す場合でも、ヘッダー Content-Length: 0 が渡されるようにしてください。例:

    curl -X POST https://HOSTALIAS/PATH -H "Content-Length: 0"
    

messaging.adaptors.http.flow.NoActiveTargets

  • HTTP ステータス コード:
503 Service Unavailable
  • エラー メッセージ:
The Service is temporarily unavailable
  • 考えられる原因:

このエラーは、次のいずれかのシナリオで発生します。 使用している場合、 <ph type="x-smartling-placeholder"></ph> TargetServer:

  1. カスタム認証サーバーによるバックエンド サーバーホストの DNS 解決が正しくないと、接続エラーにつながる IP アドレスの不具合が生じる。
  2. 次の原因による接続タイムアウト エラー:
    1. バックエンド サーバーのファイアウォール制限により、 Apigee Edge がバックエンド サーバーに接続しない。
    2. Apigee Edge 間のネットワーク接続の問題 バックエンドサーバーと通信します
  3. TargetServer で指定されたホストが正しくないか、不要な文字(スペースなど)が含まれている。

<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> ハンドブック

<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> 動画

このエラーは、ターゲット サーバーのヘルスチェックをモニタリングするように構成されたヘルスチェックが失敗した場合にも発生することがあります。

<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> ハンドブック

<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> 動画

messaging.adaptors.http.flow.RequestTimeOut

  • HTTP ステータス コード:
408 Request Timeout
  • エラー メッセージ:
Request timed out
  • 考えられる原因:
このエラーは、Apigee Edge Message Processor がメッセージを受け取らない場合に発生します。 ペイロードのリクエスト ペイロードを <ph type="x-smartling-placeholder"></ph> I/O タイムアウト期間。Message Processor コンポーネントで構成します。

修正

クライアント アプリケーションが <ph type="x-smartling-placeholder"></ph> I/O タイムアウト期間: Apigee Edge の Message Processor コンポーネントで構成します。

messaging.adaptors.http.flow.ServiceUnavailable

  • HTTP ステータス コード:
503 Service Unavailable
  • エラー メッセージ:
The Service is temporarily unavailable
  • 考えられる原因:

このエラーは、次のいずれかのシナリオで発生します。

  1. カスタム認証サーバーによるバックエンド サーバーホストの DNS 解決が正しくないと、接続エラーにつながる IP アドレスの不具合が生じる。
  2. 次の原因による接続タイムアウト エラー:
    1. バックエンド サーバーのファイアウォール制限により、 Apigee Edge がバックエンド サーバーに接続しない。
    2. Apigee Edge と Apigee の間のネットワーク接続の問題 バックエンドサーバーと通信します
  3. ターゲット エンドポイントで指定されたターゲット サーバー ホストが正しくないか、不要な文字(スペースなど)が含まれている。

<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> ハンドブック

DNS 障害:

<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> 動画

ネットワーク接続:

<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> 動画

また、Message Processor がバックエンド サーバーにリクエスト ペイロードを送信している間に、バックエンド サーバーが接続を早期に閉じた場合にも、このエラーが発生することがあります。 <ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> ハンドブック

messaging.adaptors.http.flow.SslHandshakeFailed

  • HTTP ステータス コード:
503 Service Unavailable
  • エラー メッセージ:
SSL Handshake failed {error_message}
  • 考えられる原因:

このエラーは、Apigee Edge の VPC ネットワーク間の SSL handshake プロセス中に Message Processor とバックエンド サーバー(次の場合)

  1. Apigee Edge の Message Processor のトラストストア: <ph type="x-smartling-placeholder">
      </ph>
    • バックエンド サーバーの証明書チェーンと一致しない証明書チェーンが含まれている 完全な証明書チェーン
    • または

    • バックエンド サーバーの完全な証明書チェーンが含まれていない
  2. バックエンド サーバーによって提示される証明書チェーン:
    • ターゲット エンドポイントで指定されたホスト名と一致しない完全修飾ドメイン名(FQDN)が含まれている
    • または

    • 不正確 / 不完全な証明書チェーンが含まれている

<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> ハンドブック

<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> 動画

messaging.adaptors.http.flow.UnexpectedEOFAtTarget

  • HTTP ステータス コード:
502 Bad Gateway
  • エラー メッセージ:
Unexpected EOF at target
  • 考えられる原因:

このエラーは、次のいずれかのシナリオで発生します。

  1. <ph type="x-smartling-placeholder"></ph> TargetServer が TLS/SSL 接続をサポートするように適切に構成されていない Apigee Edge を使用しています。
  2. バックエンド サーバーが接続を突然閉じることがあります。 バックエンド サーバーからのレスポンスを待機している間に、Apigee Edge がバックエンド サーバーからのレスポンスを待機しています。
  3. Apigee とバックエンド サーバーでキープアライブ タイムアウトが正しく構成されていない。
<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> ハンドブック

messaging.runtime.*

messaging.runtime.RouteFailed

  • HTTP ステータス コード:
500 Internal Server Error
  • エラー メッセージ:
Unable to route the message to a TargetEndpoint
  • 考えられる原因:

このエラーは、Apigee Edge がリクエストをどのサービスにもルーティングできない場合に発生します。 TargetEndpoint の理由:

  • プロキシのリクエストに一致するルートルール(<RouteRule>)の条件がない
  • AND

  • ProxyEndpoint にデフォルトのルートルールが定義されていない(例: <RouteRule>、条件なし)

修正

このエラーに対処する手順は次のとおりです。

  1. ProxyEndpoint で定義されたルートルールを確認し、リクエストに一致するルートルール条件が少なくとも 1 つ存在するように変更します。
  2. 複数の RouteRules がある場合は、条件なしでデフォルトのルートルールを定義することをおすすめします。
  3. ProxyEndpoint ではルールが上から下への順に評価されるため、デフォルトのルートルールが条件付きルートのリストの最後に常に定義されていることを確認してください。

ProxyEndpoint での <RouteRule> 条件の定義について詳しくは、条件付きターゲットをご覧ください。

messaging.runtime.SenseRaiseFault

  • HTTP ステータス コード:
403 Forbidden
  • エラー メッセージ:
Sense Fault
  • 考えられる原因:
このエラーは、特定のクライアント IP アドレスから API リクエストが行われた場合に発生します。 これは Apigee Sense ルールの一部としてブロックされます。

修正

このエラーに対処する手順は次のとおりです。

  1. 特定のクライアント IP アドレスをブロックしていることを確認する <ph type="x-smartling-placeholder"></ph> Apigee Sense で構成されたルールを確認するをご覧ください。ブロックされた場合は 設計どおりに機能していることを示します
  2. 特定のクライアント IP アドレスがブロックされていなくても、 このエラーが発生した場合は、Apigee Edge サポートにお問い合わせください。

protocol.http.* - Caused due to bad request

protocol.http.BadFormData

  • HTTP ステータス コード:
500 Internal Server Error
  • エラー メッセージ:
Bad Form Data
  • 考えられる原因:

このエラーは、次のすべての条件が満たされた場合にのみ発生します。

  1. クライアントから Apigee Edge に送信された HTTP リクエスト 次を含む: <ph type="x-smartling-placeholder">
      </ph>
    • Content-Type: application/x-www-form-urlencoded、および
    • パーセント記号(%)付き、またはパーセント記号(%)の後にフォーム - セクション 17.13.4.1 によって許可されていない無効な 16 進数文字が続くフォームデータ。
  2. Apigee Edge の API プロキシが特定のフォームを読み取ります。 パラメータに リクエスト フロー内の ExtractVariables または AssignMessage ポリシー。
<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> ハンドブック

protocol.http.DuplicateHeader

  • HTTP ステータス コード:
400 Bad Request
  • エラー メッセージ:
Duplicate Header "{header_name}"
  • 考えられる原因:
このエラーは、重複が許可されていない特定の HTTP ヘッダーがある場合に発生します。 Apigee Edge では、ページの一部として同じまたは異なる値で複数回 クライアント アプリケーションから Apigee Edge に送信された HTTP リクエスト。
  • HTTP の仕様:
RFC 7230、セクション 3.2.2: Field Order
<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> ハンドブック

protocol.http.EmptyHeaderName

  • HTTP ステータス コード:
400 Bad Request
  • エラー メッセージ:
Header name cannot be empty
  • 考えられる原因:
このエラーは、HTTP リクエストの一部として送信されたヘッダー名が クライアント アプリケーションから Apigee Edge へのリクエストは空です。
  • HTTP の仕様:
RFC 7230、セクション 3.2: Header Fields

修正

クライアント アプリケーションから HTTP リクエストが Apigee Edge への送信可能なヘッダーには常に、 <ph type="x-smartling-placeholder"></ph> RFC 7230、セクション 3.2: Header Fields にあります。

protocol.http.HeaderNameWithNonAsciiChar

  • HTTP ステータス コード:
400 Bad Request
  • エラー メッセージ:
Header {header_name} contains non ascii character {character}
  • 考えられる原因:
このエラーは、HTTP リクエストの一部として送信されたヘッダー名が、 非 ASCII 文字が含まれていることを意味します。
  • HTTP の仕様:

RFC 7230、セクション 3.2: Header FieldsRFC 7230、セクション 3.2.6: Field Value Components

修正

クライアントの HTTP リクエストが Apigee Edge では、ヘッダー名に ASCII 以外の文字は含まれていません。 <ph type="x-smartling-placeholder"></ph> RFC 7230、セクション 3.2.6: Field Value Components

protocol.http.HeaderWithInvalidChar

  • HTTP ステータス コード:
400 Bad Request
  • エラー メッセージ:
Header {header_name} contains invalid character {character}
  • 考えられる原因:
このエラーは、HTTP リクエストの一部として送信されたヘッダー名が、 クライアント アプリケーションから Apigee Edge に送信されると、 等号(=)、カンマ(,)、セミコロン(;)、タブ、CRLF、改行文字。
  • HTTP の仕様:

RFC 7230、セクション 3.2: Header FieldsRFC 7230、セクション 3.2.6: Field Value Components

修正

クライアント アプリケーションから Apigee Edge に送信される HTTP リクエストが、 ヘッダー名に無効な文字が含まれている( <ph type="x-smartling-placeholder"></ph> RFC 7230、セクション 3.2.6: Field Value Components

protocol.http.InvalidPath

  • HTTP ステータス コード:
400 Bad Request
  • エラー メッセージ:
Invalid path {path}
  • 考えられる原因:
このエラーは、クライアント アプリケーションから送信された HTTP リクエスト URL のパスが、 Apigee Edge に、仕様で許可されていない文字が含まれている RFC 3986、セクション 3.3: Path。
  • HTTP の仕様:

RFC 3986、セクション 3: Syntax ComponentsRFC 3986、セクション 3.3: Path

修正

クライアントから送信された HTTP リクエスト URL のパスを確認する アプリケーションを Apigee Edge には、使用が許可されていない文字は含まれていません。 <ph type="x-smartling-placeholder"></ph> (RFC 3986 のセクション 3.3: Path)をご覧ください。

protocol.http.TooBigBody

  • HTTP ステータス コード:
413 Request Entity Too Large
  • エラー メッセージ:
Body buffer overflow
  • 考えられる原因:
このエラーは、サービス アカウントの一部としてクライアント アプリケーションによって送信されたペイロード サイズが Apigee Edge への HTTP リクエストが、Apigee Edge で許可されている上限を超えています。
  • 上限:
Apigee Edge の上限
<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> ハンドブック

protocol.http.TooBigHeaders

  • HTTP ステータス コード:
431 Request Header Fields Too Large
  • エラー メッセージ:
request headers size exceeding {limit}
  • 考えられる原因:
クライアントから送信されたすべてのリクエスト ヘッダーの合計サイズ Apigee Edge への HTTP リクエストに含まれていた IP 範囲が、許可される IP 範囲を上回っています。 Apigee Edge での上限について見ていきましょう。
  • HTTP の仕様:
RFC 6585、セクション 5: 431 Request Header Fields Too Large
  • 上限:
<ph type="x-smartling-placeholder"></ph> Apigee Edge の上限
<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> ハンドブック

protocol.http.TooBigLine

  • HTTP ステータス コード:
414 Request-URI Too Long
  • エラー メッセージ:
request line size exceeding {limit}
  • 考えられる原因:
このエラーは、クライアント アプリケーションから送信されたリクエスト ラインのサイズが HTTP リクエストの一部として送信され、許容される上限を超えています。 Apigee Edge
  • 上限:
Apigee Edge の上限
<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> ハンドブック

protocol.http.UnsupportedEncoding

  • HTTP ステータス コード:
415 Unsupported Media
  • エラー メッセージ:
Unsupported Encoding "{encoding}"
  • 考えられる原因:
このエラーは、クライアントから送信された Content-Encoding ヘッダーが送信された場合に発生します。 ペイロード形式が、HTTP レスポンスに含まれない URL を <ph type="x-smartling-placeholder"></ph> Apigee Edge がサポートしています
  • HTTP の仕様:
RFC 7231、セクション 6.5.13: 415 Unsupported Media Type
<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> ハンドブック

protocol.http.* - Caused by target

protocol.http.BadPath

  • HTTP ステータス コード:
500 Internal Server Error
  • エラー メッセージ:
Invalid request path
  • 考えられる原因:
このエラーは、フロー変数 target.url で表されるバックエンド サーバーのリクエスト URL に、スラッシュ(/)の代わりに、疑問符(?)で始まるパスが含まれている場合に発生します。これは無効です。
  • HTTP の仕様:

RFC 3986、セクション 3: Syntax ComponentsRFC 3986、セクション 3.3: Path

<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> ハンドブック

protocol.http.DuplicateHeader

  • HTTP ステータス コード:
502 Bad Gateway
  • エラー メッセージ:
Duplicate Header "{header_name}"
  • 考えられる原因:
このエラーは、重複が許可されていない特定の HTTP ヘッダーがある場合に発生します。 Apigee Edge 内では、ページの一部として同じまたは異なる値で複数回 バックエンド サーバーから Apigee Edge に送信された HTTP レスポンス。
  • HTTP の仕様:
RFC 7230、セクション 3.2.2: Field Order
<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> ハンドブック

protocol.http.EmptyHeaderName

  • HTTP ステータス コード:
502 Bad Gateway
  • エラー メッセージ:
Header name cannot be empty
  • 考えられる原因:
このエラーは、HTTP リクエストの一部としてバックエンド サーバーによって送信されたヘッダー名が、 Apigee Edge へのレスポンスが空です。
  • HTTP の仕様:
RFC 7230、セクション 3.2: Header Fields

修正

バックエンドから送信される HTTP レスポンスを確認する Apigee Edge へのサーバー リソースには、 <ph type="x-smartling-placeholder"></ph> RFC 7230、セクション 3.2: Header Fields にあります。

protocol.http.EmptyPath

  • HTTP ステータス コード:
500 Internal Server Error
  • エラー メッセージ:
Request path cannot be empty
  • 考えられる原因:
このエラーは、フロー変数 target.url で表されるバックエンド サーバーの HTTP リクエスト URL に空のパスが含まれている場合に発生します。
  • HTTP の仕様:

RFC 3986、セクション 3: Syntax ComponentsRFC 3986、セクション 3.3: Path

<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> ハンドブック

protocol.http.HeaderNameWithNonAsciiChar

  • HTTP ステータス コード:
502 Bad Gateway
  • エラー メッセージ:
Header {header_name} contains non ascii character {character}
  • 考えられる原因:
このエラーは、Apigee Edge への HTTP レスポンスの一部としてバックエンド サーバーから送信されたヘッダー名に ASCII 以外の文字が含まれている場合に発生します。
  • HTTP の仕様:

RFC 7230、セクション 3.2: Header FieldsRFC 7230、セクション 3.2.6: Field Value Components

修正

バックエンド サーバーの HTTP レスポンスが Apigee Edge では、ヘッダー名に ASCII 以外の文字は含まれていません。 <ph type="x-smartling-placeholder"></ph> RFC 7230、セクション 3.2.6: Field Value Components

protocol.http.HeaderWithInvalidChar

  • HTTP ステータス コード:
502 Bad Gateway
  • エラー メッセージ:
Header {header_name} contains invalid character {character}
  • 考えられる原因:
このエラーは、バックエンド サーバーが HTTP レスポンスの一部として送信したヘッダー名に無効な文字(等号(=)、カンマ(,)、セミコロン(;)、タブ、CRLF、改行文字など)が含まれている場合に発生します。
  • HTTP の仕様:

RFC 7230、セクション 3.2: Header FieldsRFC 7230、セクション 3.2.6: Field Value Components

修正

Apigee Edge に送信されるバックエンド サーバーの HTTP レスポンスに、 ヘッダー名に無効な文字が含まれています <ph type="x-smartling-placeholder"></ph> RFC 7230、セクション 3.2.6: Field Value Components

protocol.http.ProxyTunnelCreationFailed

  • HTTP ステータス コード:
503 Service Unavailable
  • エラー メッセージ:
Proxy refused to create tunnel with response status {status code}
  • 考えられる原因:

このエラーは、Apigee Edge と ファイアウォール、ACL(アクセス制御リスト)、DNS によるプロキシ サーバーによる バックエンド サーバーの可用性などに関する問題を解決します。

注: エラー メッセージ(faultstring)のステータス コードに、問題の大まかな原因が示されています。

<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> ハンドブック

protocol.http.Response306Reserved

  • HTTP ステータス コード:
502 Bad Gateway
  • エラー メッセージ:
Response Status code 306 is reserved, so can't be used.
  • 考えられる原因:

このエラーは、バックエンド サーバーが 306 ステータス コードを Apigee Edge に送信します。

ステータス コード 306 は、以前のバージョンの HTTP 仕様で定義されていたものです。現行の HTTP 仕様では、このコードは予約済みであるため使用できません。

  • HTTP の仕様:
RFC 7231、セクション 6.3.5: 306 Reserved

修正

ステータス コード 306 は予約済みであるため、次のことを確認します。 送信側のバックエンド サーバーがこのステータス コードを使用せず、 レスポンスが返されます。

protocol.http.Response405WithoutAllowHeader

  • HTTP ステータス コード:
502 Bad Gateway
  • エラー メッセージ:
Received 405 Response without Allow Header
  • 考えられる原因:
バックエンド サーバーが、「Allow」ヘッダーなしでステータス コード 405 Method Not Allowed を返している。
  • HTTP の仕様:

RFC 7231、セクション 6.5.5: 405 Method Not AllowedRFC 7231、セクション 7.4.1: Allow

<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> ハンドブック

protocol.http.ResponseWithBody

  • HTTP ステータス コード:
502 Bad Gateway
  • エラー メッセージ:
Received {status_code} Response with message body
  • 考えられる原因:

このエラーは、バックエンド サーバーから Apigee Edge への HTTP レスポンスが 204 No Content または 205 Reset Content ですが、 レスポンスの本文および/または次のヘッダーの 1 つ以上を使用します。

  • Content-Length
  • Content-Encoding
  • Transfer-Encoding
  • HTTP の仕様:

RFC 7231、セクション 6.3.5: 204 No ContentRFC 7231、セクション 6.3.6: 205 Reset Content

<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> ハンドブック

protocol.http.TooBigBody

  • HTTP ステータス コード:
502 Bad Gateway
  • エラー メッセージ:
Body buffer overflow
  • 考えられる原因:
このエラーは、サービス アカウントの一部としてクライアント アプリケーションによって送信されたペイロード サイズが Apigee Edge への HTTP リクエストが、Apigee Edge で許可されている上限を超えています。
  • 上限:
Apigee Edge の上限
<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> ハンドブック

protocol.http.TooBigHeaders

  • HTTP ステータス コード:
502 Bad Gateway
  • エラー メッセージ:
response headers size exceeding {limit}
  • 考えられる原因:
このエラーは、すべてのレスポンス ヘッダーの合計サイズが Apigee Edge への HTTP レスポンスの一部として使用されているバックエンド サーバーの数が、 Apigee Edge で許可されません。
  • 上限:
<ph type="x-smartling-placeholder"></ph> Apigee Edge の上限
<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> ハンドブック

protocol.http.TooBigLine

  • HTTP ステータス コード:
502 Bad Gateway
  • エラー メッセージ:
response line size exceeding {limit}
  • 考えられる原因:
このエラーは、バックエンド サーバーによって送信されたレスポンス ラインのサイズが Apigee Edge への HTTP レスポンスの一部が、Apigee で許可されている上限を超えています。 。
  • 上限:
Apigee Edge の上限
<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> ハンドブック

protocol.http.UnsupportedEncoding

  • HTTP ステータス コード:
415 Unsupported Media
  • エラー メッセージ:
Unsupported Encoding "{encoding}"
  • 考えられる原因:
このエラーは、Google Compute Engine API によって送信された Content-Encoding ヘッダーが HTTP レスポンスの一部としてバックエンド サーバーにエンコーディング/ペイロードが含まれる 一致しない <ph type="x-smartling-placeholder"></ph> Apigee Edge がサポートしています
  • HTTP の仕様:
RFC 7231、セクション 6.5.13: 415 Unsupported Media Type
<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> ハンドブック

security.util.*

security.util.KeyAliasNotFound

  • HTTP ステータス コード:
500 Internal Server Error
  • エラー メッセージ:
KeyAlias {KeyAlias_name} is not found in Keystore {Keystore_Name}
  • 考えられる原因:

このエラーは、TargetEndpoint または TargetServer で参照されている特定の KeyAlias が、特定のキーストアで見つからない場合に発生します。

修正

TargetEndpoint または TargetServer で指定された KeyAlias が存在し、それが特定のキーストアの一部であることを確認します。

security.util.TrustStoreWithNoCertificates

  • HTTP ステータス コード:
500 Internal Server Error
  • エラー メッセージ:
TrustStore {truststore_name} has no certificates
  • 考えられる原因:

このエラーは、TargetEndpoint または TargetServer で参照されている特定のトラストストアに証明書が含まれていない場合に発生します。

修正

バックエンド サーバーの証明書を検証し、TargetEndpoint または TargetServer でトラストストアを使用する場合は、トラストストアにバックエンド サーバーの有効な証明書が含まれていることを確認します。