Ce document liste les erreurs courantes et décrit les solutions possibles pour l'installation et la configuration d'Apigee.
Créer une instance
Cette section décrit les erreurs courantes et les solutions possibles après l'envoi d'une requête à Apigee pour créer une instance :
401 (UNAUTHENTICATED) indique que vos identifiants ont peut-être expiré. Essayez de renouveler votre jeton d'autorisation, comme illustré dans l'exemple suivant :
RANGES_EXHAUSTED indique que la plage d'adresses IP que vous avez demandée à l'origine n'a pas pu être traitée et que vous devez demander une nouvelle plage. Vous avez initialement créé une requête de plage à l'étape 2: Configurer la mise en réseau.
Pour demander une nouvelle plage à partir de laquelle Apigee choisit une adresse IP pour les connexions de services privés, exécutez la commande gcloud suivante :
gcloud compute addresses create $RANGE_NAME_2
--project=$PROJECT_ID --global --prefix-length=16
--description="additional peering range for Google services" --network=$NETWORK_NAME
--purpose=VPC_PEERING
Cette commande crée une plage nommée $RANGE_NAME_2.
Vérifiez les détails de l'ancienne et de la nouvelle plage d'adresses.
gcloud compute addresses list --global --project=$PROJECT_ID
Vérifiez les détails de l'appairage de VPC existant :
gcloud services vpc-peerings list \
--network=$NETWORK_NAME \
--service=servicenetworking.googleapis.com \
--project=$PROJECT_ID
Créer une organisation Apigee
L'exemple suivant montre une erreur courante qu'Apigee peut afficher lorsque vous essayez de créer une organisation :
Cela signifie qu'une ou plusieurs des API requises ne sont pas activées. Passez en revue les API répertoriées à l'Étape 1 : Activer les API requises et assurez-vous que toutes les API sont activées avant de continuer.
De plus, vous pouvez obtenir l'une des erreurs HTTP suivantes :
401 (UNAUTHENTICATED) indique que vos identifiants ont peut-être expiré. Essayez de renouveler votre jeton d'autorisation, comme illustré dans l'exemple suivant :
Vous avez saisi une URL de point de terminaison ou de requête incorrecte. Vérifiez que vous avez spécifié apigee.googleapis.com pour le domaine de l'appel d'API.
409 (Conflict) indique généralement que le nom d'organisation donné existe déjà. Les noms d'organisations doivent être uniques. Choisissez un autre nom pour l'organisation et relancez la commande. (Vous devez spécifier le nom dans la charge utile de la requête si vous créez une organisation sur la ligne de commande. Gardez à l'esprit que vous devez créer une organisation portant le même nom que votre projet. Cette erreur ne devrait donc pas se produire tant qu'il n'y a pas de faute de frappe.)
Voici une erreur possible qu'Apigee peut renvoyer lorsque vous vérifiez l'état d'une nouvelle requête d'organisation :
403 (Permission Denied) pourrait indiquer que l'organisation n'a pas encore été créée. Veuillez patienter une minute et réessayez. Si Apigee renvoie un résultat 403 lorsque vous essayez de créer la nouvelle organisation, cela peut signifier qu'une ou plusieurs de vos API n'ont pas été activées. Assurez-vous d'avoir activé toutes les API comme décrit à l'étape 1: Activez les API requises.
Déployer des exemples
Équilibreur de charge non opérationnel
Lors du déploiement d'un exemple de proxy, Apigee peut renvoyer une erreur HTTP 502 (Bad Gateway).
Dans ce cas, essayez les solutions suivantes :
Vérifiez l'état de l'équilibreur de charge. Dans la console Cloud, sélectionnez Services réseau > Équilibrage de charge. L'onglet Équilibreur de charge affiche tous les équilibreurs de charge du projet et leur état. Un triangle jaune indique que le service de backend de l'équilibreur de charge n'est pas opérationnel.
Après avoir confirmé un problème avec l'équilibreur de charge, vérifiez les VM dans votre instance d'exécution pour vous assurer qu'elles sont opérationnelles.
Examinez les fichiers journaux pour voir si vous trouvez une erreur ou un autre type de problème qui pourrait avoir entraîné un dysfonctionnement. Pour en savoir plus sur l'activation et l'affichage des journaux, consultez la page Afficher les journaux.
Essayez d'effectuer un redémarrage progressif sur le groupe d'instances dans Cloud Console :
Dans la liste des groupes d'instances, cliquez sur celui qui ne répond pas dans la colonne Nom.
Cliquez sur Redémarrer/Remplacer progressivement, comme illustré dans l'exemple suivant :
Sur l'écran suivant, cliquez sur Redémarrer.
Cela redémarre l'instance Envoy.
Adresse IP d'instance incorrecte
Si vous supprimez et recréez votre instance Apigee à un quelconque moment, l'adresse IP de l'instance Apigee change et peut ne plus être synchronisée avec l'adresse IP du point de terminaison du modèle de groupe d'instances géré (MIG). Par exemple, le modèle de MIG contiendra toujours l'ancienne adresse IP de l'instance supprimée. Le modèle de MIG a été créé pendant le processus de provisionnement d'Apigee. Dans cette situation, essayez d'appliquer la procédure suivante pour mettre à jour le modèle de MIG avec l'adresse IP Apigee correcte :
Ouvrez le modèle d'instance. Vous devez ouvrir le modèle d'instance utilisé par le backend mappé à votre équilibreur de charge.
Faites défiler la page vers le bas pour trouver l'adresse IP ENDPOINT dans la section Custom Metadata (Métadonnées personnalisées).
Si l'adresse IP du point de terminaison diffère de celle que vous avez notée dans l'UI Apigee, vous devez modifier l'adresse IP du modèle d'instance pour qu'elle corresponde à l'adresse IP de l'instance Apigee.
Consultez la section Modifier des adresses IP d'instance.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/09/04 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Difficile à comprendre","hardToUnderstand","thumb-down"],["Informations ou exemple de code incorrects","incorrectInformationOrSampleCode","thumb-down"],["Il n'y a pas l'information/les exemples dont j'ai besoin","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/09/04 (UTC)."],[[["\u003cp\u003eThis document provides troubleshooting steps for common errors encountered during the installation and configuration of Apigee, excluding Apigee hybrid.\u003c/p\u003e\n"],["\u003cp\u003eA \u003ccode\u003e401 (UNAUTHENTICATED)\u003c/code\u003e error typically indicates expired credentials, requiring a renewal of the authorization token.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eRANGES_EXHAUSTED\u003c/code\u003e error when creating a new instance means a new IP address range must be requested by executing gcloud commands to update your connection request.\u003c/p\u003e\n"],["\u003cp\u003eWhen creating an Apigee organization, a \u003ccode\u003e409 (Conflict)\u003c/code\u003e error indicates the organization name already exists and a different, globally unique name must be used.\u003c/p\u003e\n"],["\u003cp\u003eA \u003ccode\u003e502 (Bad Gateway)\u003c/code\u003e error during sample proxy deployment suggests an issue with the load balancer, which can be resolved by checking the load balancer's health and potentially doing a rolling restart on the instance group.\u003c/p\u003e\n"]]],[],null,["# Troubleshooting the Apigee installation\n\n*This page\napplies to **Apigee** , but not to **Apigee hybrid**.*\n\n\n*View [Apigee Edge](https://docs.apigee.com/api-platform/get-started/what-apigee-edge) documentation.*\n\nThis document lists common errors and describes possible resolutions for\nwhen you install and configure Apigee.\n\nCreating a new instance\n-----------------------\n\nThis section describes common errors and possible resolutions after sending a request to Apigee\nto create a new instance:\n\n- `401 (UNAUTHENTICATED)` indicates that your credentials may have timed out. Try renewing your authorization token, as the following example shows: \n\n ```\n AUTH=\"Authorization: Bearer $(gcloud auth print-access-token)\"\n ```\n- `RANGES_EXHAUSTED` indicates that the range of IP addresses that you initially requested could not be accommodated and that you must request a new range. You initially created a range request in [Step 2: Set up networking](/apigee/docs/api-platform/get-started/configure-service-networking).\n 1. Create these environment variables \n\n ```\n RANGE_NAME_1=YOUR_RANGE_NAME_1\n RANGE_NAME_2=YOUR_RANGE_NAME_2\n NETWORK_NAME=YOUR_NETWORK_NAME\n ```\n 2. Verify the details of the existing address ranges and ensure it will not overlap with the new range. \n\n ```\n gcloud compute addresses list --global --project=$PROJECT_ID\n ``` \n\n ```\n gcloud compute addresses describe $RANGE_NAME_1 --global --project=$PROJECT_ID \n ```\n 3. To request a new range from which Apigee chooses an IP address for the private service connections execute the following **gcloud** command: \n\n ```\n gcloud compute addresses create $RANGE_NAME_2\n --project=$PROJECT_ID --global --prefix-length=16\n --description=\"additional peering range for Google services\" --network=$NETWORK_NAME\n --purpose=VPC_PEERING \n ```\n 4. This command creates a new range named **$RANGE_NAME_2**.\n 5. Verify the details of both the old and new address range \n\n ```\n gcloud compute addresses list --global --project=$PROJECT_ID \n ``` \n\n ```\n gcloud compute addresses describe $RANGE_NAME_1 --global --project=$PROJECT_ID \n ``` \n\n ```\n gcloud compute addresses describe $RANGE_NAME_2 --global --project=$PROJECT_ID \n ```\n 6. Verify the existing VPC peering details: \n\n ```\n gcloud services vpc-peerings list \\\n --network=$NETWORK_NAME \\\n --service=servicenetworking.googleapis.com \\\n --project=$PROJECT_ID \n ```\n 7. Execute the following command to update your connection request: \n\n ```\n gcloud services vpc-peerings update\n --service=servicenetworking.googleapis.com --network=$NETWORK_NAME\n --ranges=$RANGE_NAME_1,$RANGE_NAME_2 --project=$PROJECT_ID \n ```\n | **Note:** You must specify the name of your first range (in this case, `RANGE_NAME_1`) and a name for your newly requested range (in this case, `RANGE_NAME_2`). For more information, see [gcloud services\n | vpc-peerings update](/sdk/gcloud/reference/services/vpc-peerings/update).\n 8. Verify the existing VPC peering details: \n\n ```\n gcloud services vpc-peerings list \\\n --network=$NETWORK_NAME \\\n --service=servicenetworking.googleapis.com \\\n --project=$PROJECT_ID \n ```\n\nCreating an Apigee organization\n-------------------------------\n\nThe following example shows a common error that Apigee might display when you first try to create\nan organization: \n\n```text\n Apigee API (staging) has not been used in project 59387731598 before or it is disabled. \n Enable it by visiting https://console.developers.google.com/apis/api/staging-apigee.sandbox.googleapis.com/overview?project=59387731598 then retry. \n If you enabled this API recently, wait a few minutes for the action to propagate to our systems and retry.\n```\n\nThis means that one or more of the required APIs is not enabled. Review the APIs listed in\n[Step 1: Enable required APIs](/apigee/docs/api-platform/get-started/enable-apis) and be sure that all APIs are enabled before you continue.\n\nIn addition, you might get one of the following HTTP errors:\n\n- `401 (UNAUTHENTICATED)` indicates that your credentials may have timed out. Try renewing your authorization token, as the following example shows: \n\n ```\n AUTH=\"Authorization: Bearer $(gcloud auth print-access-token)\"\n ```\n- `404 (Not Found)` can be the result of the following:\n - You entered the wrong endpoint/request URL. Check that you specified `apigee.googleapis.com` for the API call's domain.\n - Your project might not yet be provisioned. Contact [Apigee Sales](https://pages.apigee.com/contact-sales-reg.html).\n- `409 (Conflict)` usually indicates that the given organization name already exists. Organization names must be globally unique. Choose another name for the organization and re-issue the command. (You specify the name in the payload of the request if you are creating an organization on the command line. Keep in mind that you must create an organization that has the same name as your project, so this really shouldn't happen unless there's a typo.)\n\nThe following is a possible error that Apigee might return when you check the status of a new\norganization request:\n\n- `403 (Permission Denied)` could indicate that the organization has not yet been created. Wait another minute and try again. If Apigee returns a `403` when you first try to create the new organization, it could mean that one or more of your APIs have not been enabled. Be sure that you enabled all the APIs as described in [Step 1: Enable required APIs](/apigee/docs/api-platform/get-started/enable-apis) .\n\nDeploying samples\n-----------------\n\n### Load balancer not healthy\n\nWhen deploying a sample proxy, Apigee might return a `502 (Bad Gateway)` HTTP error.\nIn this case, try the following:\n\n1.\n Check the health of the Load Balancer. The Load balancer tab shows all load\n balancers for the project and their statuses. A yellow triangle indicates\n that the load balancer backend service is not healthy.\n\n In the Google Cloud console, go to the **Network services \\\u003e Load balancing** page.\n\n [Go to Load balancing](https://console.cloud.google.com/net-services/loadbalancing)\n2. After confirming an issue with the load balancer, check the VMs in your runtime instance to ensure that they are up and healthy.\n3. Look at the log files to see if you can find an error or other type of issue that might have lead to a problem. For more information on enabling and viewing logs, see [Viewing logs](/load-balancing/docs/https/https-logging-monitoring#viewing_logs).\n4. Try doing a rolling restart on the instance group in Cloud console:\n 1. In the Google Cloud console, go to the **Compute Engine \\\u003e Instance groups** page.\n\n [Go to Instance groups](https://console.cloud.google.com/compute/instanceGroups)\n 2. From the list of instance groups, click the one that is not responding in the **Name** column.\n 3. Click **Rolling Restart/Replace**.\n 4. On the next screen, click **Restart** .\n\n This restarts the Envoy instance.\n\n### Incorrect instance IP\n\n\nIf at any time you delete and recreate your Apigee instance,\nthe Apigee instance IP changes and can become out of sync with the managed instance group (MIG)\ntemplate's endpoint IP. For example, the MIG template will still have the old IP from the\ndeleted instance. The MIG template was created during the Apigee [provisioning process](/apigee/docs/api-platform/get-started/install-cli#external). In this situation, try the following steps to update the MIG template with\nthe correct Apigee IP:\n\n1. In the Google Cloud console, go to the **Apigee \\\u003e Admin \\\u003e Instances** page.\n\n [Go to Instances](https://console.cloud.google.com/apigee/instances)\n2. Note the IP Address of the instance. You will need to know this IP in a later step. For example: `10.117.200.2`.\n3. In the Google Cloud console, go to the **Instance templates** page.\n\n [Go to Instance templates](https://console.cloud.google.com/compute/instances)\n4. Open the instance template. You need to open the instance template that is used by the backend that is mapped to your load balancer.\n5. Scroll down to find the `ENDPOINT` IP under the **Custom metadata** section.\n6. If the endpoint IP differs from the one you noted in the Apigee UI, you must change the Instance template IP to match the Apigee instance IP. See [Changing instance IPs.](/apigee/docs/api-platform/system-administration/change-instance-ips)"]]
