Documentation Oracle Cloud Infrastructure

Dépannage d'API Gateway

Découvrez comment résoudre les problèmes liés à API Gateway et les solutions possibles aux problèmes courants.

Cette rubrique traite des problèmes courants liés au service API Gateway et explique comment les résoudre.

Les questions abordées dans cette rubrique 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
Echec de la création d'une passerelle d'API ou blocage à l'état Création en cours. Echec de la création d'une passerelle d'API ou blocage à l'état Création en cours
VNIC attachment failed due to the limit for number of private IP addresses for this subnet Obtention du message d'échec de l'attachement de carte d'interface réseau virtuelle en raison de la limite sur le nombre d'adresses IP privées pour ce sous-réseau dans le cadre de la création d'une passerelle d'API
The limit for number of private IP addresses for this subnet has been exceeded Obtention du message de dépassement de la limite sur le nombre d'adresses IP privées pour ce sous-réseau dans le cadre de la création d'une passerelle d'API
The limit for number of public IP addresses for this compartment has been exceeded Obtention du message de dépassement de la limite sur le nombre d'adresses IP publiques pour ce compartiment dans le cadre de la création d'une passerelle d'API publique
Work request was cancelled Obtention du message d'annulation de demande de travail dans le cadre de la création d'une passerelle d'API
An unexpected error occurred. Contact Oracle Support for assistance. La création d'une passerelle d'API renvoie une erreur inattendue. Contacter le support technique Oracle 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 Obtention d'une erreur 400 et du message indiquant que la ressource <subnet-ocid> est inconnue et que vous devez vous assurer de l'existence du sous-réseau dans le cadre de la création d'une passerelle d'API

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

Erreurs liées au blocage des déploiements d'API :

Message d'erreur ou description Informations supplémentaires
Echec de la création d'un déploiement d'API ou blocage à l'état Création en cours. Echec de la création d'un déploiement d'API ou blocage à l'état Création en cours

Erreurs HTTP-4xx de "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. La création d'un déploiement d'API échoue avec la mention "Impossible d'activer TLS mutuel car les packages d'autorité de certification personnalisés ne sont pas ajoutés à la passerelle. Ajoutez un package d'autorité de certification personnalisé et réessayez."
Duplicate SAN or CN values passed in input. Echec de la création d'un déploiement d'API avec le message "Dupliquer les valeurs SAN ou CN transmises en entrée"
Too many value, must not have more than 10 values. Echec de la création d'un déploiement d'API avec le message "Trop de valeur, ne doit pas avoir plus de 10 valeurs"
Length of SAN or CN string should be less than 256 characters. Echec de la création d'un déploiement d'API avec le message "La longueur de la chaîne SAN ou CN doit être inférieure à 256 caractères"
Invalid format for SAN or CN. Echec de la création d'un déploiement d'API avec "Format non valide pour SAN ou CN"

Problèmes lors de l'appel d'API

Utilisez les journaux API Gateway pour consulter 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 API Gateway, ainsi que pour la recherche et le stockage de ces journaux. Pour plus d'informations, reportez-vous à 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 lorsqu'un déploiement d'API est créé mais que des 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 "failed to parse pem cert chain" 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 "Client CA Bundle not present" 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 client" est générée dans le journal
503: Service Unavailable L'appel du déploiement d'API échoue avec un message "Service Unavailable" et une erreur 503

Erreurs HTTP-4xx lors de la création du déploiement d'API mais de l'échec des demandes :

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 "Le certificat client n'est pas valide pour cette passerelle" est générée 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 "Echec de la 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 "Base 64 Certificate Size than 8KB" apparaît dans le journal.

Problèmes affectant les passerelles d'API

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