Oracle Cloud Infrastructureドキュメント

APIゲートウェイのトラブルシューティング

API Gatewayの問題のトラブルシューティング方法、および一般的な問題に対する考えられる解決策をご覧ください。

このトピックでは、APIゲートウェイ・サービスに関連する一般的な問題と、その対処方法について説明します。

このトピックの問題は、次の広範なカテゴリにまとめられています。

APIゲートウェイの作成に関する問題

エラーメッセージまたは説明 詳細情報
新規APIゲートウェイの作成が「作成中」の状態で停止するか、失敗する 新規APIゲートウェイの作成が「作成中」の状態で停止するか、失敗する
VNIC attachment failed due to the limit for number of private IP addresses for this subnet 新しいAPIゲートウェイを作成すると、「このサブネットのプライベートIPアドレス数の制限により、VNIC添付ファイルが失敗しました」というメッセージが返されます
The limit for number of private IP addresses for this subnet has been exceeded 新しいAPIゲートウェイを作成すると、「このサブネットのプライベートIPアドレス数の制限を超過しました」というメッセージが返されます
The limit for number of public IP addresses for this compartment has been exceeded 新しいパブリックAPIゲートウェイを作成すると、「このコンパートメントのパブリックIPアドレス数の制限を超過しました」というメッセージが返されます
Work request was cancelled 新しいAPIゲートウェイを作成すると、「作業リクエストが取り消されました」というメッセージが返されます
An unexpected error occurred. Contact Oracle Support for assistance. 新しいAPIゲートウェイを作成すると、「予期しないエラーが発生しました。Oracleサポートに連絡してください」というメッセージが返されます
Unknown resource <subnet-ocid>, make sure subnet exists, the user can access the subnet and it is in the same region where the gateway will be created 新しいAPIゲートウェイを作成すると、「不明リソース<subnet-ocid>。サブネットが存在することを確認してください...」というメッセージおよび400エラーが返されます

APIデプロイメントの作成に関する問題

停止APIデプロイメントに関連するエラー:

エラーメッセージまたは説明 詳細情報
新規APIデプロイメントの作成が「作成中」の状態で停止するか、失敗する 新規APIデプロイメントの作成が「作成中」の状態で停止するか、失敗する

mTLS構成に関連するHTTP-4xxエラー:

エラーメッセージまたは説明 詳細情報
Cannot enable mutual TLS because custom CA Bundles are not added to the Gateway. Please add a custom CA Bundle and try again. 「Cannot enable mutual TLS because custom CA Bundles are not added to the Gateway.」で、新しいAPI配備の作成が失敗します。カスタムCAバンドルを追加して再試行してください。」メッセージ
Duplicate SAN or CN values passed in input. 「Duplicate SAN or CN values passed in input」メッセージで新規APIデプロイメントの作成が失敗する
Too many value, must not have more than 10 values. 「Too many value、 must not have more than 10 values」というメッセージで、新しいAPIデプロイメントの作成が失敗する
Length of SAN or CN string should be less than 256 characters. 新しいAPIデプロイメントの作成が「SANまたはCN文字列の長さは256文字未満である必要があります」メッセージで失敗します
Invalid format for SAN or CN. 新しいAPIデプロイメントの作成が「SANまたはCNのフォーマットが無効です」で失敗します

APIの呼出しに関する問題

APIゲートウェイ・ログを使用して、起動情報を確認します。Oracle Cloud Infrastructure Loggingサービスは、APIゲートウェイ・ログのアクセス、検索および格納を行うデフォルトかつ推奨のオプションです。詳細は、APIデプロイメントへのロギングの追加を参照してください。

ログからのエラー・メッセージおよび次の情報を使用して、起動の問題を解決します。

APIデプロイメントが正常に作成されたが、リクエストは失敗した場合に発生するHTTP-5xxエラー:

エラーメッセージまたは説明 詳細情報
failed to parse pem cert chain。ログに表示されます。 APIデプロイメントの起動がHTTP-5xxエラーで失敗し、「pem証明書チェーンの解析に失敗しました」エラーがログに出力されます
Client CA Bundle not present。ログに表示されます。 APIデプロイメントの起動がHTTP-5xxエラーで失敗し、「クライアントCAバンドルが存在しません」エラーがログに出力されます
Error in client certificate verification。ログに表示されます。 APIデプロイメントの起動がHTTP-5xxエラーで失敗し、「クライアント証明書検証のエラー」エラーがログに出力されます
503: Service Unavailable APIデプロイメントの起動が「Service Unavailable」メッセージおよび503エラーで失敗する

APIデプロイメントが正常に作成されたが、リクエストは失敗した場合に発生するHTTP-4xxエラー:

エラーメッセージまたは説明 その他の情報
Client certificate is invalid for this gateway.。ログに表示されます。 APIデプロイメントの起動がHTTP-4xxエラーで失敗し、「クライアント証明書がこのゲートウェイに対して無効です」エラーがログに出力されます
SAN validation failure。ログに表示されます。 APIデプロイメントの起動がHTTP-4xxエラーで失敗し、SAN検証失敗エラーがログに出力されます

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

エラーメッセージまたは説明 その他の情報
Base 64 Certificate Size greater than 8KB。ログに表示されます。 APIデプロイメントの起動は成功しましたが、「Base 64 Certificate Size greater than 8KB」警告がログに出力されます

APIゲートウェイに影響する問題

エラーメッセージまたは説明 その他の情報
定義済タグを変更すると、APIゲートウェイは失敗状態になります。 定義済タグを変更すると、APIゲートウェイは失敗状態になります