flow.*
|
|
flow.APITimedOut |
|
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 |
|
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 |
|
404 Not Found |
|
|
Unable to identify proxy for host: {virtual_host} and url: {pathsuffix} |
|
|
このエラーは、次のいずれかのシナリオで発生します。
- 具体的な API プロキシは次のとおりです。
- リクエストを受け入れるように構成されていない
仮想ホスト
- 特定のパスでリクエストを受け入れるように構成されていない
リクエストで使用
- 対象の特定の環境にデプロイされていない
API リクエストを
- 1 つ以上の Message Processor にデプロイされていない
- 作成しようとしている特定の環境
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 |
|
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 |
|
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 |
|
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 に送信します。 |
|
|
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 に送信します。 |
|
|
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 |
|
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 |
|
411 Length Required |
|
'Content-Length' is missing |
|
このエラーは、Content-Length ヘッダーが渡されなかった場合に発生します。
HTTP POST および PUT の一部としてのクライアント アプリケーション
リクエストの数を表します。 注: このエラーによって失敗したリクエストは、Trace ツールでキャプチャできません。これは、Message Processor が、リクエストを処理し、API プロキシで任意のポリシーを実行するよりかなり前の段階でこの検証を行うためです。 |
|
RFC セクション 3.3.2: Content-Length |
|
修正
このエラーに対処する手順は次のとおりです。
-
クライアント アプリケーションが常にヘッダーを渡すようにする
HTTP POST の一部としての Content-Length と
Apigee Edge に送信された PUT リクエスト。例:
curl -X POST https://HOSTALIAS/PATH -d '{"name": "abc"}' -H "Content-Length: 15"
POST リクエストと PUT リクエストで空のペイロードを渡す場合でも、ヘッダー Content-Length: 0 が渡されるようにしてください。例:
curl -X POST https://HOSTALIAS/PATH -H "Content-Length: 0"
|
messaging.adaptors.http.flow.NoActiveTargets |
|
503 Service Unavailable |
|
|
The Service is temporarily unavailable |
|
|
このエラーは、次のいずれかのシナリオで発生します。
使用している場合、
<ph type="x-smartling-placeholder"></ph>
TargetServer:
- カスタム認証サーバーによるバックエンド サーバーホストの DNS 解決が正しくないと、接続エラーにつながる IP アドレスの不具合が生じる。
- 次の原因による接続タイムアウト エラー:
- バックエンド サーバーのファイアウォール制限により、
Apigee Edge がバックエンド サーバーに接続しない。
- Apigee Edge 間のネットワーク接続の問題
バックエンドサーバーと通信します
- 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 |
|
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 |
|
503 Service Unavailable |
|
|
The Service is temporarily unavailable |
|
|
このエラーは、次のいずれかのシナリオで発生します。
- カスタム認証サーバーによるバックエンド サーバーホストの DNS 解決が正しくないと、接続エラーにつながる IP アドレスの不具合が生じる。
- 次の原因による接続タイムアウト エラー:
- バックエンド サーバーのファイアウォール制限により、
Apigee Edge がバックエンド サーバーに接続しない。
- Apigee Edge と Apigee の間のネットワーク接続の問題
バックエンドサーバーと通信します
- ターゲット エンドポイントで指定されたターゲット サーバー ホストが正しくないか、不要な文字(スペースなど)が含まれている。
|
<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 |
|
503 Service Unavailable |
|
SSL Handshake failed {error_message} |
|
このエラーは、Apigee Edge の VPC ネットワーク間の SSL handshake プロセス中に
Message Processor とバックエンド サーバー(次の場合)
- Apigee Edge の Message Processor のトラストストア:
<ph type="x-smartling-placeholder">
</ph>
- バックエンド サーバーの証明書チェーンと一致しない証明書チェーンが含まれている
完全な証明書チェーン
または
- バックエンド サーバーの完全な証明書チェーンが含まれていない
- バックエンド サーバーによって提示される証明書チェーン:
- ターゲット エンドポイントで指定されたホスト名と一致しない完全修飾ドメイン名(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 |
|
502 Bad Gateway |
|
Unexpected EOF at target |
|
このエラーは、次のいずれかのシナリオで発生します。
-
<ph type="x-smartling-placeholder"></ph>
TargetServer が TLS/SSL 接続をサポートするように適切に構成されていない
Apigee Edge を使用しています。
- バックエンド サーバーが接続を突然閉じることがあります。
バックエンド サーバーからのレスポンスを待機している間に、Apigee Edge がバックエンド サーバーからのレスポンスを待機しています。
- Apigee とバックエンド サーバーでキープアライブ タイムアウトが正しく構成されていない。
|
|
<ph type="x-smartling-placeholder"></ph>
<ph type="x-smartling-placeholder"></ph>
ハンドブック |
|
messaging.runtime.*
|
|
messaging.runtime.RouteFailed |
|
500 Internal Server Error |
|
Unable to route the message to a TargetEndpoint |
|
このエラーは、Apigee Edge がリクエストをどのサービスにもルーティングできない場合に発生します。
TargetEndpoint の理由:
- プロキシのリクエストに一致するルートルール(
<RouteRule> )の条件がない
AND
- ProxyEndpoint にデフォルトのルートルールが定義されていない(例:
<RouteRule> 、条件なし)
|
|
修正
このエラーに対処する手順は次のとおりです。
- ProxyEndpoint で定義されたルートルールを確認し、リクエストに一致するルートルール条件が少なくとも 1 つ存在するように変更します。
- 複数の RouteRules がある場合は、条件なしでデフォルトのルートルールを定義することをおすすめします。
- ProxyEndpoint ではルールが上から下への順に評価されるため、デフォルトのルートルールが条件付きルートのリストの最後に常に定義されていることを確認してください。
ProxyEndpoint での <RouteRule> 条件の定義について詳しくは、条件付きターゲットをご覧ください。
|
messaging.runtime.SenseRaiseFault |
|
403 Forbidden |
|
Sense Fault |
|
このエラーは、特定のクライアント IP アドレスから API リクエストが行われた場合に発生します。
これは Apigee Sense ルールの一部としてブロックされます。 |
|
|
protocol.http.* - Caused due to bad request
|
|
|
|
500 Internal Server Error |
|
Bad Form Data |
|
このエラーは、次のすべての条件が満たされた場合にのみ発生します。
- クライアントから Apigee Edge に送信された HTTP リクエスト
次を含む:
<ph type="x-smartling-placeholder">
</ph>
Content-Type: application/x-www-form-urlencoded 、および
- パーセント記号(%)付き、またはパーセント記号(%)の後にフォーム - セクション 17.13.4.1 によって許可されていない無効な 16 進数文字が続くフォームデータ。
- Apigee Edge の API プロキシが特定のフォームを読み取ります。
パラメータに
リクエスト フロー内の ExtractVariables または AssignMessage ポリシー。
|
|
<ph type="x-smartling-placeholder"></ph>
<ph type="x-smartling-placeholder"></ph>
ハンドブック |
|
|
400 Bad Request |
|
Duplicate Header "{header_name}" |
|
このエラーは、重複が許可されていない特定の HTTP ヘッダーがある場合に発生します。
Apigee Edge では、ページの一部として同じまたは異なる値で複数回
クライアント アプリケーションから Apigee Edge に送信された HTTP リクエスト。
|
|
RFC 7230、セクション 3.2.2: Field Order |
|
<ph type="x-smartling-placeholder"></ph>
<ph type="x-smartling-placeholder"></ph>
ハンドブック
|
|
|
|
|
|
|
|
|
|
protocol.http.InvalidPath |
|
修正
クライアントから送信された HTTP リクエスト URL のパスを確認する
アプリケーションを
Apigee Edge には、使用が許可されていない文字は含まれていません。
<ph type="x-smartling-placeholder"></ph>
(RFC 3986 のセクション 3.3: Path)をご覧ください。
|
protocol.http.TooBigBody |
|
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>
ハンドブック |
|
|
<ph type="x-smartling-placeholder"></ph>
<ph type="x-smartling-placeholder"></ph>
ハンドブック |
protocol.http.TooBigLine |
|
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 |
|
<ph type="x-smartling-placeholder"></ph>
<ph type="x-smartling-placeholder"></ph>
ハンドブック |
protocol.http.* - Caused by target
|
|
protocol.http.BadPath |
|
<ph type="x-smartling-placeholder"></ph>
<ph type="x-smartling-placeholder"></ph>
ハンドブック |
|
|
502 Bad Gateway |
|
Duplicate Header "{header_name}" |
|
このエラーは、重複が許可されていない特定の HTTP ヘッダーがある場合に発生します。
Apigee Edge 内では、ページの一部として同じまたは異なる値で複数回
バックエンド サーバーから Apigee Edge に送信された HTTP レスポンス。
|
|
RFC 7230、セクション 3.2.2: Field Order |
|
<ph type="x-smartling-placeholder"></ph>
<ph type="x-smartling-placeholder"></ph>
ハンドブック
|
|
|
|
protocol.http.EmptyPath |
|
<ph type="x-smartling-placeholder"></ph>
<ph type="x-smartling-placeholder"></ph>
ハンドブック |
|
|
|
|
|
|
protocol.http.ProxyTunnelCreationFailed |
|
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 |
|
502 Bad Gateway |
|
Response Status code 306 is reserved, so can't be used. |
|
このエラーは、バックエンド サーバーが
306 ステータス コードを Apigee Edge に送信します。
ステータス コード 306 は、以前のバージョンの HTTP 仕様で定義されていたものです。現行の HTTP 仕様では、このコードは予約済みであるため使用できません。
|
|
RFC 7231、セクション 6.3.5: 306 Reserved |
|
修正
ステータス コード 306 は予約済みであるため、次のことを確認します。
送信側のバックエンド サーバーがこのステータス コードを使用せず、
レスポンスが返されます。
|
|
|
<ph type="x-smartling-placeholder"></ph>
<ph type="x-smartling-placeholder"></ph>
ハンドブック |
protocol.http.ResponseWithBody |
|
<ph type="x-smartling-placeholder"></ph>
<ph type="x-smartling-placeholder"></ph>
ハンドブック |
protocol.http.TooBigBody |
|
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>
ハンドブック |
|
|
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 |
|
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 |
|
<ph type="x-smartling-placeholder"></ph>
<ph type="x-smartling-placeholder"></ph>
ハンドブック |
security.util.*
|
|
security.util.KeyAliasNotFound |
|
500 Internal Server Error |
|
KeyAlias {KeyAlias_name} is not found in
Keystore {Keystore_Name} |
|
このエラーは、TargetEndpoint または TargetServer で参照されている特定の KeyAlias が、特定のキーストアで見つからない場合に発生します。
|
|
修正
TargetEndpoint または TargetServer で指定された KeyAlias が存在し、それが特定のキーストアの一部であることを確認します。
|
security.util.TrustStoreWithNoCertificates |
|
500 Internal Server Error |
|
TrustStore {truststore_name} has no certificates |
|
このエラーは、TargetEndpoint または TargetServer で参照されている特定のトラストストアに証明書が含まれていない場合に発生します。
|
|
修正
バックエンド サーバーの証明書を検証し、TargetEndpoint または TargetServer でトラストストアを使用する場合は、トラストストアにバックエンド サーバーの有効な証明書が含まれていることを確認します。
|