APIの呼出し時のその他のエラー

APIゲートウェイ・サービスを使用してAPIデプロイメントが正常に作成されたが、リクエストが失敗した場合のその他のエラーのトラブルシューティング方法を確認します。

APIデプロイメントの起動は成功しましたが、「Base 64 Certificate Size greater than 8KB」警告がログに出力されます

相互TLSが有効なAPIデプロイメントを起動すると、リクエストが正常に処理されたが、次の警告がログに出力される場合があります:

Base 64 Certificate Size greater than 8KB.

証明書がBase64でエンコードされている場合、APIクライアントによって提示されたTLS証明書が8KBを超えると、メッセージがログに出力されます。Base64でエンコードされた証明書が8KBを超える場合、証明書はrequest.certコンテキスト変数として格納されません。

この問題に対処するには、APIクライアントがBase64でエンコードされた場合に8KB未満の証明書を提示する必要があります。詳細は、APIデプロイメントへのmTLSサポートの追加を参照してください。

APIデプロイメントの呼出しは、「負荷が過剰なため接続がクローズされました」というメッセージで失敗します

APIデプロイメントを起動すると、SSL/TLSハンドシェイク・エラーのバーストと、次のエラー出力がログに表示される場合があります:

Connection closed due to excessive load.

このメッセージは、容量不足が原因で、API Gatewayが現在リクエストを処理できないことを示しています。

次に注意してください:

  • このエラーが続く場合は、APIクライアントを構成して、APIデプロイメント呼出しの間隔を長くすることを検討してください(たとえば、間隔にランダム度を追加するために、ジッタ付きの指数バックオフなどの標準手法を使用)。
  • エラーの数がリクエスト/レスポンスのパフォーマンスに悪影響を及ぼしており、API呼出しの間隔を長くしてお問合せし、割り当てられたCPU容量の増加を要求することは、操作上許容できません。弊社に連絡する際には、APIゲートウェイのOCID、高いリクエスト・スループット率が正常に処理された期間、および達成したいターゲット・スループット率を指定します。CPU容量の増加に関する問い合わせは、ケースバイケースで検討します。
  • イベントによってトリガーされたアクションの結果としてAPIデプロイメントが起動されたときにメッセージが表示される場合、APIデプロイメントが正常に起動されるまで、APIデプロイメントの起動の追加試行が自動的に再試行されます。ユーザーの操作は必要ありません。
  • メッセージが長期間続いて表示される場合は、お問い合せください。