このトピックでは、ESA から返される 4xx および 5xx シリーズのステータスコードについて説明し、これらのステータスコードの解決策を提供して、エラーのトラブルシューティングに役立てます。
4XX ステータスコード
4xx コードは、クライアント応答エラーを示します。
400
応答メッセージ: Bad Request
説明: このステータスコードは、クライアントがサーバーに送信したリクエストに問題があり、理解または処理できなかったことを示します。
解決策: リクエストの入力パラメーターが有効かどうかを確認して、再試行してください。
401
応答メッセージ: Unauthorized
説明: このエラーは、リクエストが適切な認証資格情報とともに送信されなかったことを示します。サーバーは、リクエストを処理するために認証を必要とします。
解決策: 有効な認証資格情報を含めるか、オリジンサーバーでリクエストを承認して、再試行してください。
403
応答メッセージ: Forbidden
説明: このエラーは、クライアントのリクエストはサーバーによって理解されましたが、リクエストされたリソースにアクセスするための十分な権限がないため、実行できないことを示します。
解決策: クライアントリクエストの権限を付与して、再試行してください。
404
応答メッセージ: Not Found
説明: このエラーは、オリジンサーバーがリクエストされたリソースを見つけられなかったことを示します。
解決策: リクエストパスを変更して再試行するか、サーバー URL パスがインターネットからアクセス可能かどうかを確認してください。
405
応答メッセージ: Method Not Allowed
説明: このステータスコードは、オリジンサーバーはリクエストされたリソースを認識していますが、リクエストで使用されている HTTP メソッドをサポートしていないことを示します。
解決策: リクエストメソッドをオリジンサーバーでサポートされているメソッドに調整して、再試行してください。
406
応答メッセージ: Not Acceptable
説明: このステータスコードは、リクエストされたリソースが、クライアントによって指定されたコンテンツネゴシエーションヘッダー(たとえば、
Accept-CharsetまたはAccept-Language)に準拠する形式では使用できないことを示します。解決策: リクエストヘッダーフィールドをオリジンサーバーでサポートされているタイプに変更して、再試行してください。
407
応答メッセージ: Authentication Required
説明: このステータスコードは、クライアントがプロキシサーバーを介してリクエストされたリソースにアクセスするために必要な認証資格情報を提供しなかったことを示します。
解決策: プロキシオリジンサーバーの認証が期限切れになっていないかを確認し、プロキシオリジンサーバーによって発行された正しい資格情報を含めて、再試行してください。
408
応答メッセージ: Request Timeout
説明: このステータスコードは、オリジンサーバーが妥当な時間内に完全なリクエストを受信せず、接続を待機し続けたくないことを示します。
解決策: オリジンサーバーの処理時間を延長するか、クライアントリクエストのパッケージサイズを縮小して、再試行してください。
409
応答メッセージ: Conflict
説明: このステータスコードは、ターゲットリソースの現在の状態との競合が原因でリクエストを完了できなかったことを示します。このエラーは、クライアントが 1 つのリソースを編集しようとするときに、
PUTリクエストの応答で発生する可能性があります。解決策: 情報を更新して再送信するか、オリジンサーバーに競合処理メカニズムを追加して、再試行してください。
410
応答メッセージ: Gone
説明: リソースが意図的に永続的に削除された場合、サーバーは 410 ステータスコードを使用して、リソースが使用できなくなったことをクライアントに通知します。
解決策: クライアントは、削除されたリソースへの参照を削除して、再試行する必要があります。
411
応答メッセージ: Length Required
説明: このステータスコードは、クライアントがヘッダーでリクエスト本文の
Content-Lengthを指定しておらず、この情報がリソースの取得に必要であることを示します。解決策: クライアントのリクエストヘッダーに
Content-Lengthフィールドを含めて、再試行してください。長さを推定できない場合は、Transfer-Encoding: chunkedフィールドを含めて、チャンク転送エンコーディングを定義できます。
412
応答メッセージ: Precondition Failed
説明: このステータスコードは、リソースがクライアントによって指定された条件を満たしていないため、サーバーがリクエストを拒否したことを示します。
解決策: リクエストに有効な前提条件を含めて、再試行してください。
413
応答メッセージ: Payload Too Large
説明: このステータスコードは、クライアントによって送信されたペイロードがサーバーの許容サイズ制限を超えているため、サーバーがリクエストの処理を拒否したことを示します。
解決策: ファイルのアップロードサイズまたは送信データサイズを小さくして、再試行してください。
414
応答メッセージ: URI Too Long
説明: このステータスコードは、クライアントによって提供された URI が長すぎるため、サーバーがリクエストの処理を拒否したことを示します。
解決策: クライアントリクエストの URI の長さを短縮するか、長いパラメーターを複数のプロセスに分割し、クライアント側で結果を集計します。
415
応答メッセージ: Unsupported Media Type
説明: このステータスコードは、ペイロードの形式がサポートされていないため、サーバーがリクエストの処理を拒否したことを示します。
解決策: リクエストヘッダーの
Content-Typeフィールドをサーバーでサポートされている形式に変更して、再試行してください。
416
応答メッセージ: Range Not Satisfiable
説明: このステータスコードは、サーバーがクライアントのリクエストの Range ヘッダーで指定されたリクエストされた範囲を満たすことができないことを示します。
解決策:
Rangeリクエストヘッダーフィールドの範囲が有効かどうかを確認し、Rangeを変更して、再試行してください。
417
応答メッセージ: Expectation Failed
説明: このステータスコードは、サーバーがクライアントのリクエストの
Expectヘッダーで指定された要件を満たすことができなかったことを示します。解決策: これはテスト中に一般的です。本番環境で発生した場合は、リクエストヘッダーの
Expectフィールドを無効にします。
429
応答メッセージ: Too Many Requests
説明: このステータスコードは、サーバーのレート制限ルールによって決定されるように、クライアントが指定された時間内に多すぎるリクエストを送信したことを示します。
解決策: 単位時間あたりのリクエスト数がオリジンサーバーの制限を超えています。オリジンサーバーによって設定された再試行間隔の後で再試行してください。
499
応答メッセージ: Client Close Request
説明: このステータスコードは通常、サーバーが応答できるようになる前にクライアントが接続を終了した場合に発生します。クライアントはエラーページを受信しないため、ページを定義する必要はありません。
5XX ステータスコード
520 から 599 までのステータスコードは、ESA によって使用されます。混乱を避けるため、ビジネスではこの範囲のステータスコードを使用しないでください。
500
応答メッセージ: Internal Server Error
説明: このステータスコードは、オリジン Web サーバーに問題があり、リクエストを処理できないことを示します。
解決策: オリジンサーバーログを確認してエラーを見つけて解決します。迅速な回復のために、以前の動作バージョンにロールバックすることもできます。
502
応答メッセージ: Bad Gateway
説明: このステータスコードは、ESA がオリジン Web サーバーと接続できないことを示します。
解決策: オリジンサーバーが使用可能かどうかを確認し、オリジンサーバーのファイアウォールルールで ESA プレゼンスポイント(POP)からのアクセスが許可されているかどうかを確認します。
503
応答メッセージ: Service Temporarily Unavailable
説明: このステータスコードは、オリジン Web サーバーが過負荷になっているときに発生します。
解決策: オリジンサーバーのステータスを確認し、高負荷アプリケーションを見つけ、高負荷の原因をトラブルシューティングして解決します。
504
応答メッセージ: Gateway Timeout
説明: このステータスコードは、ESA がオリジン Web サーバーと接続できないことを示します。
解決策: オリジンサーバーのステータスが使用可能かどうかを確認するか、タイムアウト期間を適切に増やします。
508
応答メッセージ: Loop Detected
説明: このステータスコードは、ESA POP が受信したリクエストが、ESA ネットワークにループで入る最大回数を超えたことを示します。
解決策: オリジンサーバーのループを確認し、ループに終了条件があり、正常に終了できることを確認してから、再試行してください。
520
応答メッセージ: Web server returns an unknown error
説明: このエラーは、オリジンサーバーが ESA に空の、不明な、または予期しない応答を返したときに発生します。
解決策: オリジンサーバーログを確認します。これは、プログラムのクラッシュやデータベース接続エラーでよく発生します。
521
応答メッセージ: Web server is down
説明: このエラーは、オリジン Web サーバーが ESA からの接続を拒否したときに発生します。
解決策: オリジンサーバーが使用可能かどうかを確認します。使用可能な場合は、ESA POP がオリジンサーバーのホワイトリストに含まれているかどうかを確認します。
522
応答メッセージ: Connection timed out
説明: このエラーは、ESA がオリジン Web サーバーへの接続でタイムアウトしたときに発生します。
解決策: ESA POP IP アドレスがオリジンサーバーによってレート制限またはブロックされているかどうかを確認します。オリジンサーバーが ESA POP IP アドレスを許可していることを確認します。
523
応答メッセージ: Origin is unreachable
説明: このエラーは、ESA がオリジン Web サーバーに接続できないときに発生します。
解決策: オリジン IP が ESA DNS に追加されていることを確認し、ESA とオリジンサーバー間のネットワークまたはルーティングをテストします。
524
応答メッセージ: A timeout occurred
説明: このエラーは通常、ESA はオリジン Web サーバーに正常に接続しましたが、オリジンはデフォルトのプロキシ読み取りタイムアウト前に HTTP 応答を提供しなかったことを示します。
解決策: オリジンサーバーが過負荷で動作しているかどうかを確認し、このエラーを回避するために大きな HTTP プロセス状態ポーリングを実装します。
525
応答メッセージ: SSL handshake failed
説明: このエラーは、ESA とオリジン Web サーバー間の SSL ハンドシェイクが失敗したことを示します。
解決策: 正しい SSL 証明書を構成し、ESA でサポートされている TLS 暗号スイートと一致することを確認してから、再試行してください。
526
応答メッセージ: Invalid SSL certificate
説明: これは、ESA がオリジンサーバーの SSL 証明書を検証できないため、安全な接続を確立できないことを示します。
解決策: SSL 証明書を更新して、再試行してください。
530
応答メッセージ: Unable to resolve the origin hostname
説明: これは、ESA がオリジンホスト名を解決できないため、オリジンサーバーへの接続を確立できないことを示します。
解決策: オリジンサーバーのホスト名を解決できることを確認して、再試行してください。
581
応答メッセージ: Exceeding the maximum execution hop count
説明:Edge Function のループ呼び出しシナリオで、最大実行ホップ数を超えた後にインターセプトされます。
ソリューション:再帰的な呼び出しの状況を避けるために、Edge Function コードを調整してください。
582
応答メッセージ: Version retrieval failed
説明:Edge Function のバージョン情報の取得に失敗しました。
ソリューション:Edge Function スクリプトを再公開し、再試行してください。
583
応答メッセージ: Rate limit
説明:Edge Function のレート制限がトリガーされました。
ソリューション:サポートが必要な場合は、お問い合わせください。
584
応答メッセージ: Insufficient computing resources
説明: ESA POP の計算リソースが不足しています。
解決策: お問い合わせ ください。
594
応答メッセージ: uncaught exception
説明:未キャッチの例外により、Edge Function スクリプトが停止しました。
ソリューション:Edge Function スクリプトで対応する例外を処理し、再試行してください。
595
応答メッセージ: Execution time exceeds the limit
説明:Edge Function スクリプトの実行時間が最大時間 (デフォルト 120 秒) を超えました。
解決策: スクリプトの CPU 実行時間が 120 秒以内になるように最適化して、再試行してください。
596
応答メッセージ: Configuration pull failed
説明:Edge Function の設定のプルに失敗したことを示します。
解決策: コンソールから構成を再公開します。エラーが再度発生する場合は、お問い合わせ ください。
598
応答メッセージ: Debugger exception
説明:Edge Function デバッガーに例外が発生しました。
解決策: コードがアップロードされているか、デバッガーセッションが作成されているかを確認して、再試行してください。
599
応答メッセージ: Script execution exception
説明:Edge Function スクリプトに実行エラーがあるか、リソース制限を超えています。
解決策: スクリプトに構文エラーがないか、スクリプト形式が仕様に準拠しているかを確認します。