In diesem Dokument werden häufige Fehler aufgelistet und mögliche Lösungen für die Installation und Konfiguration von Apigee beschrieben.
Neue Instanz erstellen
In diesem Abschnitt werden häufige Fehler und mögliche Lösungen beschrieben, nachdem Sie eine Anfrage an Apigee gesendet haben, um eine neue Instanz zu erstellen:
401 (UNAUTHENTICATED) gibt an, dass Ihre Anmeldedaten abgelaufen sind. Versuchen Sie, Ihr Autorisierungstoken zu erneuern, wie im folgenden Beispiel gezeigt:
RANGES_EXHAUSTED gibt an, dass der von Ihnen angeforderte IP-Adressbereich nicht passt und Sie einen neuen Bereich anfordern müssen. Sie haben ursprünglich in Schritt 2: Netzwerk einrichten eine Bereichsanfrage erstellt.
Um einen neuen Bereich anzufordern, aus dem Apigee eine IP-Adresse für die privaten Dienstverbindungen auswählt, führen Sie folgenden gcloud-Befehl aus:
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
Mit diesem Befehl wird ein neuer Bereich mit dem Namen $RANGE_NAME_2 erstellt.
Details sowohl des alten als auch des neuen Adressbereichs bestätigen
gcloud compute addresses list --global --project=$PROJECT_ID
Prüfen Sie die Details zum vorhandenen VPC-Peering:
gcloud services vpc-peerings list \
--network=$NETWORK_NAME \
--service=servicenetworking.googleapis.com \
--project=$PROJECT_ID
Apigee-Organisation erstellen
Das folgende Beispiel zeigt einen allgemeinen Fehler, den Apigee beim ersten Erstellen einer Organisation anzeigen kann:
In diesem Fall ist mindestens eine der erforderlichen APIs nicht aktiviert. Prüfen Sie die in Schritt 1: Erforderliche APIs aktivieren aufgeführten APIs und achten Sie darauf, dass alle APIs aktiviert sind, bevor Sie fortfahren.
Darüber hinaus kann es zu einem der folgenden HTTP-Fehler kommen:
401 (UNAUTHENTICATED) gibt an, dass Ihre Anmeldedaten abgelaufen sind. Versuchen Sie, Ihr Autorisierungstoken zu erneuern, wie im folgenden Beispiel gezeigt:
404 (Not Found) kann das Ergebnis folgender Elemente sein:
Du hast die falsche Endpunkt-/Anfrage-URL eingegeben. Prüfen Sie, ob Sie apigee.googleapis.com für die Domain des API-Aufrufs angegeben haben.
Ihr Projekt wurde möglicherweise noch nicht bereitgestellt. Apigee-Vertriebsteam kontaktieren.
409 (Conflict) gibt normalerweise an, dass der angegebene Organisationsname bereits vorhanden ist. Organisationsnamen müssen global eindeutig sein. Wählen Sie einen anderen Namen für die Organisation aus und geben Sie den Befehl noch einmal aus. Sie geben den Namen in der Nutzlast der Anfrage an, wenn Sie eine Organisation über die Befehlszeile erstellen. Denke daran, dass du eine Organisation erstellen musst, die denselben Namen wie dein Projekt hat. Das soll aber nur passieren, wenn ein Tippfehler vorliegt.
Der folgende Fehler wird möglicherweise von Apigee zurückgegeben, wenn Sie den Status einer neuen Organisationsanfrage prüfen:
403 (Permission Denied) könnte bedeuten, dass die Organisation noch nicht erstellt wurde. Warten Sie eine Minute und versuchen Sie es dann noch einmal. Wenn Apigee beim ersten Versuch, die neue Organisation zu erstellen, eine 403 zurückgibt, kann dies bedeuten, dass eine oder mehrere Ihrer APIs nicht aktiviert wurden. Alle APIs müssen wie unter Schritt 1: Erforderliche APIs aktivieren beschrieben aktiviert sein.
Beispiele bereitstellen
Load Balancer nicht betriebsbereit
Beim Bereitstellen eines Beispielproxys kann Apigee den HTTP-Fehler 502 (Bad Gateway) zurückgeben.
Versuchen Sie in diesem Fall Folgendes:
Integrität des Load-Balancers prüfen Wählen Sie in der Cloud Console Netzwerkdienste > Load-Balancing aus. Der Tab Load-Balancer zeigt alle Load-Balancer für das Projekt und deren Status an. Ein gelbes Dreieck zeigt an, dass der Back-End-Dienst des Load-Balancers fehlerfrei ist.
Nachdem Sie ein Problem mit dem Load-Balancer bestätigt haben, prüfen Sie die VMs in Ihrer Laufzeitinstanz darauf, ob sie betriebsbereit sind.
Prüfen Sie in den Logdateien, ob ein Fehler vorliegt, der möglicherweise zu einem Problem geführt hat. Weitere Informationen zum Aktivieren und Ansehen von Logs finden Sie unter Logs ansehen.
Führen Sie einen rollierenden Neustart für die Instanzgruppe in der Cloud Console durch:
Wählen Sie Compute Engine > Instanzgruppen aus.
Klicken Sie in der Liste der Instanzgruppen in der Spalte Name auf die Instanzgruppe, die nicht reagiert.
Klicken Sie auf Rollierender Neustart/Ersetzen, wie das folgende Beispiel zeigt:
Klicken Sie auf dem nächsten Bildschirm auf Neu starten.
Dadurch wird die Envoy-Instanz neu gestartet.
Falsche IP-Adresse der Instanz
Wenn Sie Ihre Apigee-Instanz löschen und neu erstellen, ändert sich die IP-Adresse der Apigee-Instanz und kann nicht mehr mit der Endpunkt-IP der MIG-Vorlage (Managed Instance Group, verwaltete Instanzgruppe) synchronisiert werden. Beispiel: Die MIG-Vorlage hat weiterhin die alte IP-Adresse der gelöschten Instanz. Die MIG-Vorlage wurde während des Bereitstellungsprozesses von Apigee erstellt. Führen Sie in diesem Fall die folgenden Schritte aus, um die MIG-Vorlage mit der richtigen Apigee-IP zu aktualisieren:
Öffnen Sie die Instanzvorlage. Sie müssen die Instanzvorlage öffnen, die vom Backend verwendet wird, das Ihrem Load-Balancer zugeordnet ist.
Scrollen Sie nach unten zur IP-Adresse ENDPOINT im Bereich Benutzerdefinierte Metadaten.
Wenn die Endpunkt-IP von der in der Apigee-Benutzeroberfläche abweicht, müssen Sie die IP-Adresse der Instanzvorlage so ändern, dass sie mit der IP-Adresse der Apigee-Instanz übereinstimmt.
Weitere Informationen finden Sie unter Instanz-IP-Adressen ändern.
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Schwer verständlich","hardToUnderstand","thumb-down"],["Informationen oder Beispielcode falsch","incorrectInformationOrSampleCode","thumb-down"],["Benötigte Informationen/Beispiele nicht gefunden","missingTheInformationSamplesINeed","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 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)"]]
