APIデプロイメントが正常に作成されたが、リクエストは失敗した場合に発生するHTTP-5xxエラー
APIデプロイメントがAPIゲートウェイ・サービスで正常に作成されたが、リクエストは失敗した場合に、HTTP-5xxエラーをトラブルシューティングする方法を確認します。
APIデプロイメントが正常に作成されると、コール時にHTTP-5xxエラーが発生することがあります。
APIデプロイメントの起動がHTTP-5xxエラーで失敗し、「pem証明書チェーンの解析に失敗しました」エラーがログに出力されます
failed to parse pem cert chain
このエラーは、APIデプロイメントをホストしているAPIゲートウェイのトラスト・ストア内のカスタムCAバンドルが正しい形式でない場合に発生します。
この問題に対処するには、APIゲートウェイのトラスト・ストア内のカスタムCAバンドルが正しい形式であることを確認してください。詳細は、APIデプロイメントへのmTLSサポートの追加を参照してください。
APIデプロイメントの起動がHTTP-5xxエラーで失敗し、「クライアントCAバンドルが存在しません」エラーがログに出力されます
相互TLSが有効なAPIデプロイメントを起動すると、リクエストがHTTP-5xxエラーで失敗し、次のエラー出力がログに表示される場合があります:
Client CA Bundle not present.
このエラーは、少なくとも1つのmTLS対応APIデプロイメントがAPIゲートウェイにデプロイされているが、カスタムCAバンドルがAPIゲートウェイのトラスト・ストアに追加されていない場合に発生します。
この問題に対処するには、次のいずれかを実行します:
- APIゲートウェイからすべてのmTLS対応APIデプロイメントを削除します。
- APIゲートウェイ内のすべてのmTLS対応APIデプロイメントを編集して、mTLSサポートを無効にします。
- APIゲートウェイのトラスト・ストアにカスタムCAバンドルを追加します。
詳細は、APIデプロイメントへのmTLSサポートの追加を参照してください。
APIデプロイメントの起動がHTTP-5xxエラーで失敗し、「クライアント証明書検証のエラー」エラーがログに出力されます
相互TLSが有効なAPIデプロイメントを起動すると、リクエストがHTTP-5xxエラーで失敗し、次のエラー出力がログに表示される場合があります:
Error in client certificate verification.
このエラーは、APIゲートウェイのトラスト・ストアに追加されたカスタムCAバンドルの形式が無効な場合に発生します。ログには、失敗したリクエストに関する追加情報が含まれます。
この問題に対処するには、APIゲートウェイのトラスト・ストアに追加されたカスタムCAバンドルが正しい形式であることを確認してください。このエラーを修正するには、ログのトレースバック情報を使用します。詳細は、APIデプロイメントへのmTLSサポートの追加を参照してください。
APIデプロイメントの起動が「Service Unavailable」メッセージおよび503エラーで失敗する
APIデプロイメントを起動すると、リクエストがHTTP-503エラーで失敗し、次のエラー・メッセージが表示される場合があります:
Service Unavailable.
このメッセージは、容量不足が原因で、API Gatewayが現在リクエストを処理できないことを示しています。
次に注意してください:
- このエラーが続く場合は、APIクライアントを構成して、APIデプロイメント呼出しの間隔を長くすることを検討してください(たとえば、間隔にランダム度を追加するために、ジッタ付きの指数バックオフなどの標準手法を使用)。
- HTTP-503エラーの数がリクエスト/レスポンスのパフォーマンスに悪影響を及ぼし、API呼出し間の時間間隔を長くすることは、運用上許容できない場合、お問合せし、割り当てられたCPU容量の増加を依頼してください。弊社に連絡する際には、APIゲートウェイのOCID、高いリクエスト・スループット率が正常に処理された期間、および達成したいターゲット・スループット率を指定します。CPU容量の増加に関する問い合わせは、ケースバイケースで検討します。
- イベントによってトリガーされたアクションの結果としてAPIデプロイメントが起動されたときにメッセージが表示される場合、APIデプロイメントが正常に起動されるまで、APIデプロイメントの起動の追加試行が自動的に再試行されます。ユーザーの操作は必要ありません。
- 503個のエラー・コードを含むAPIデプロイメント・エラー・レスポンスによってトリガーされるアラームを設定すると、ユーザーの操作が不要な複数の通知が表示される場合があります。
- メッセージが長期間続いて表示される場合は、お問い合せください。