Documentation sur Oracle Cloud Infrastructure

Dépannage de passerelle d'API

Découvrez comment résoudre les problèmes liés au service de passerelle d'API et les solutions possibles aux problèmes courants.

Cette rubrique décrit les problèmes courants liés au service Passerelle d'API et comment les résoudre.

Les questions abordées dans ce sujet sont classées dans les grandes catégories suivantes :

Problèmes lors de la création de passerelles d'API

Message d'erreur ou description Informations supplémentaires
Création d'une passerelle d'API bloquée avec l'état Création ou en échec. Création d'une passerelle d'API bloquée avec l'état Création ou en échec
VNIC attachment failed due to the limit for number of private IP addresses for this subnet La création d'une passerelle d'API retourne un message indiquant l'échec de l'attachement d'une carte vNIC en raison de la limite du nombre d'adresses IP privées pour ce sous-réseau
The limit for number of private IP addresses for this subnet has been exceeded La création d'une passerelle d'API retourne un message indiquant que la limite du nombre d'adresses IP privées pour ce sous-réseau a été dépassée
The limit for number of public IP addresses for this compartment has been exceeded La création d'une passerelle d'API publique retourne un message indiquant que la limite du nombre d'adresses IP publiques pour ce compartiment a été dépassée
Work request was cancelled La création d'une passerelle d'API retourne un message indiquant que la demande de travail a été annulée
An unexpected error occurred. Contact Oracle Support for assistance. La création d'une passerelle d'API retourne une erreur inattendue. Communiquez avec Oracle Support pour obtenir de l'aide"
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 La création d'une passerelle d'API retourne un message avec un code d'erreur 400 indiquant une ressource inconnue <subnet-ocid> et de vérifier l'existence du sous-réseau

Problèmes lors de la création de déploiements d'API

Erreurs liées à l'arrêt des déploiements d'API :

Message d'erreur ou description Informations supplémentaires
Création d'un déploiement d'API bloqué avec l'état Création ou en échec. Création d'un déploiement d'API bloqué avec l'état Création ou en échec

Erreurs HTTP-4xx "mauvaise demande" liées à la configuration mTLS :

Message d'erreur ou description Informations supplémentaires
Cannot enable mutual TLS because custom CA Bundles are not added to the Gateway. Please add a custom CA Bundle and try again. Échec de la création d'un déploiement d'API avec l'option "Impossible d'activer TLS mutuel car les ensembles AC personnalisés ne sont pas ajoutés à la passerelle. Ajoutez un ensemble AC personnalisé et réessayez."
Duplicate SAN or CN values passed in input. La création d'un déploiement d'API échoue avec le message "Dupliquer les valeurs SAN ou CN transmises en entrée"
Too many value, must not have more than 10 values. Échec de la création d'un déploiement d'API avec le message "Trop de valeurs, ne doit pas avoir plus de 10 valeurs"
Length of SAN or CN string should be less than 256 characters. Échec de la création d'un déploiement d'API avec le message "La longueur de la chaîne SAN ou CN doit comporter moins de 256 caractères"
Invalid format for SAN or CN. La création d'un déploiement d'API échoue avec "Format non valide pour SAN ou CN"

Problèmes lors de l'appel d'API

Utilisez les journaux du service de passerelle d'API pour vérifier les informations d'appel. Le service Oracle Cloud Infrastructure Logging est l'option par défaut et recommandée pour l'accès, la recherche et le stockage des journaux du service de passerelle d'API. Pour plus d'informations, voir Ajout de la journalisation aux déploiements d'API.

Utilisez les messages d'erreur des journaux et les informations ci-dessous pour résoudre les problèmes d'appel.

Erreurs HTTP-5xx lorsque le déploiement d'API est créé mais que les demandes échouent :

Message d'erreur ou description Informations supplémentaires
failed to parse pem cert chain, affiché dans le journal. L'appel du déploiement d'API échoue avec une erreur HTTP-5xx, et une erreur "Échec de l'analyse de la chaîne de certificats pem" est générée dans le journal
Client CA Bundle not present, affiché dans le journal. L'appel du déploiement d'API échoue avec une erreur HTTP-5xx, et une erreur "Ensemble AC client absent" est générée dans le journal
Error in client certificate verification, affiché dans le journal. L'appel du déploiement d'API échoue avec une erreur HTTP-5xx, et une erreur "Erreur lors de la vérification du certificat du client" est générée dans le journal
503: Service Unavailable L'appel du déploiement d'API échoue avec un message "Service non disponible" et une erreur 503

Erreur HTTP 4xx lorsque le déploiement d'API a été créé mais que les demandes ont échoué :

Message d'erreur ou description Informations supplémentaires
Client certificate is invalid for this gateway., affiché dans le journal. L'appel du déploiement d'API échoue avec une erreur HTTP-4xx, et une erreur "Certificat de client non valide pour cette passerelle" est sortie dans le journal
SAN validation failure, affiché dans le journal. L'appel du déploiement d'API échoue avec une erreur HTTP-4xx, et une erreur "Échec de validation SAN" est générée dans le journal

Erreurs diverses lors de l'appel d'API

Message d'erreur ou description Informations supplémentaires
Base 64 Certificate Size greater than 8KB, affiché dans le journal. L'appel du déploiement d'API a réussi, mais un avertissement "Taille du certificat de base 64 supérieure à 8 Ko" est généré dans le journal

Problèmes affectant les passerelles d'API

Message d'erreur ou description Informations supplémentaires
La modification d'un marqueur défini entraîne l'échec d'une passerelle d'API. La modification d'un marqueur défini entraîne l'échec d'une passerelle d'API