In diesem Thema wird erläutert, wie Sie die IP-Adresse einer Apigee-Instanz ändern, indem Sie die VMs manuell aktualisieren.
Übersicht
Wenn eine Apigee-Instanz gelöscht und dann neu erstellt wird, wird für die neu erstellte Instanz eine IP-Adresse generiert. Bestimmte Instanzparameter wie "cidrRange" und "networking" sind unveränderlich. Wenn Sie diese Parameter ändern möchten, müssen Sie daher die Instanz löschen und mit der gewünschten Konfiguration neu erstellen.
In den meisten Fällen wird beim erneuten Erstellen einer Instanz zwar dieselbe Instanz-IP-Adresse ausgewählt, aber es wird nicht garantiert, dass dieselbe IP-Adresse zurückgegeben wird. Die VMs, die Traffic vom Load-Balancer an die private IP-Adresse von Apigee weiterleiten, haben noch die alte IP-Adresse. Wenn eine neue Instanz-IP-Adresse generiert wird, müssen Sie die VMs also manuell mit der neuen IP-Adresse aktualisieren.
Instanz-IP-Adresse ändern
So aktualisieren Sie die VMs mit einer neuen Instanz-IP-Adresse:
Rufen Sie in der Google Cloud Console die Seite Virtual Machines>Instance templates auf.
Klicken Sie auf die Apigee-Instanzvorlage, also die Vorlage, die Sie kopieren und aktualisieren möchten.
Klicken Sie auf Ähnliche erstellen.
Geben Sie im Feld Name einen neuen Namen für die Vorlage ein. So können Sie beispielsweise ein Suffix wie "v2" am Ende des ursprünglichen Namens hinzufügen.
Klicken Sie unter Erweiterte Optionen auf den Tab Verwaltung.
Scrollen Sie nach unten zum Bereich Metadaten (optional) und suchen Sie nach dem Schlüssel/Wert-Paar, das den Schlüssel ENDPOINT enthält. Ändern Sie den Wert des Endpunkts so, dass er mit der neuen Instanz-IP-Adresse übereinstimmt. Verwenden Sie Ihre eigene IP-Adresse und nicht die im Screenshot gezeigte:
Klicken Sie auf Erstellen, um die Vorlage anzulegen.
Rufen Sie in der Google Cloud Console die Seite Instanzgruppen auf.
Klicken Sie in der Spalte Name der Liste auf den Namen der Apigee-Instanzgruppe, die Sie ändern möchten.
Klicken Sie auf Bearbeiten, um die verwaltete Instanzgruppe zu bearbeiten.
Wählen Sie unter Instanzvorlage die neu erstellte Instanzvorlage aus.
Klicken Sie auf Speichern.
Klicken Sie oben auf der Seite auf Rolling Update.
Lassen Sie alle Standardeinstellungen/Voreinstellungen unverändert und klicken Sie auf Aktualisieren.
Es dauert einige Minuten, bis die neuen VMs gestartet werden. Die alten VMs werden heruntergefahren und entfernt. Sobald die neuen VMs aktiv sind, wird der gesamte API-Traffic normal fortgesetzt.
[[["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-05 (UTC)."],[[["\u003cp\u003eThis content pertains to Apigee, excluding Apigee hybrid, and is specifically for organizations with VPC peering enabled.\u003c/p\u003e\n"],["\u003cp\u003eWhen an Apigee instance is deleted and recreated, a new IP address may be generated, requiring manual updating of the VMs.\u003c/p\u003e\n"],["\u003cp\u003eChanging certain immutable parameters of an Apigee instance, like \u003ccode\u003ecidrRange\u003c/code\u003e and networking, necessitates deleting and recreating the instance.\u003c/p\u003e\n"],["\u003cp\u003eTo update VMs with a new instance IP, create a new instance template, modify the \u003ccode\u003eENDPOINT\u003c/code\u003e metadata to reflect the new IP, and then apply this template to the instance group via a rolling update.\u003c/p\u003e\n"],["\u003cp\u003eAfter a rolling update is initiated, new VMs will take a few minutes to become operational, and old VMs will be shut down, resuming normal API traffic upon completion.\u003c/p\u003e\n"]]],[],null,["# Changing instance IPs\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\n| **Important:** This topic only applies to organizations that were created with VPC peering enabled. See also [Apigee networking options](/apigee/docs/api-platform/get-started/networking-options).\n\n\nThis topic explains how to change the IP of an Apigee instance by manually updating the\nVMs.\n\nOverview\n--------\n\n\nWhen an Apigee instance is\n[deleted](https://cloud.google.com/apigee/docs/reference/apis/apigee/rest/v1/organizations.instances/delete)\nand then [created](https://cloud.google.com/apigee/docs/reference/apis/apigee/rest/v1/organizations.instances/create)\nagain, an IP address is generated for the newly created instance. For example, certain instance\nparameters, such as cidrRange and networking, are immutable. Therefore, if you want to change\nthese parameters, you must delete the instance and recreate it with the desired configuration.\n\n\nIn most cases, when you recreate an instance, the same instance IP is selected, but getting the\nsame IP is not guaranteed. The VMs that are routing traffic from the load balancer to\nApigee's private IP still have the old IP address; therefore, in cases where a new instance\nIP is generated, you have to manually update the VMs with the new IP.\n\nChanging the instance IP\n------------------------\n\n\nTo update the VMs with a new instance IP, follow these steps:\n\n1. In the Google Cloud console, go to the **Virtual Machines** \\\u003e **Instance templates** page.\n\n [Go to Instance templates](https://console.cloud.google.com/compute/instanceTemplates/list)\n2. Click on the Apigee instance template (the template that you want to copy and update).\n3. Click **Create Similar**.\n4. In the **Name** field, provide a new name for the template. For example, you might add a suffix like \"v2\" at the end of the original name.\n5. Under **Advanced options** , click the **Management** tab.\n6. Scroll down to the **Metadata (Optional)** section and look for the key value pair containing the **ENDPOINT** key. Change the value of the endpoint to match the new instance IP. Use your IP, not the one shown in the screenshot:\n\n7. Click **Create** to create the template.\n8. In the Google Cloud console, go to the **Instance groups** page.\n\n [Go to Instance groups](https://console.cloud.google.com/compute/instanceGroups/list)\n9. Under the **Name** column of the list, click the name of the Apigee instance group that you wish to modify.\n10. Click **Edit** to modify this instance group.\n11. Under **Instance template**, select the new instance template (the one you just created).\n12. Click **Save**.\n13. At the top of the page, click **Rolling update**.\n14. Leave all the defaults/presets as-is and click **Update**.\n15. It takes a few minutes for the new VMs to come up, and the old VMs will be shut down and removed. Once the new VMs are up, all API traffic will resume normally."]]
