Changing instance IPs

You're viewing Apigee X documentation.
View Apigee Edge documentation.

This topic explains how to change the IP of an Apigee instance by manually updating the VMs.


When an Apigee instance is deleted and then created again, an IP address is generated for the newly created instance. For example, certain instance parameters, such as cidrRange and networking, are immutable. Therefore, if you want to change these parameters, you must delete the instance and recreate it with the desired configuration.

In most cases, when you recreate an instance, the same instance IP is selected, but getting the same IP is not guaranteed. The VMs that are routing traffic from the load balancer to Apigee's private IP still have the old IP address; therefore, in cases where a new instance IP is generated, you have to manually update the VMs with the new IP.

Changing the instance IP

To update the VMs with a new instance IP, follow these steps:

  1. In the Cloud console, go to the Instance templates page.
  2. Click on the Apigee instance template (the template that you want to copy and update).
  3. Click Create Similar.
  4. 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.
  5. Under Management, Security, Disks, Networking, Sole Tenancy, click the Management tab.
  6. Scroll down to the Metadata (Optional) section and look for the ENDPOINT property. Change the endpoint to match the new instance IP. Use your IP, not the one shown in the screenshot:


  7. Click Create to create the template.
  8. In the Cloud console, go to the Instance groups page.
  9. Under the Name column of the list, click the name of the Apigee instance group that you wish to modify.
  10. Click Edit to modify this instance group.
  11. Under Instance template, select the new instance template (the one you just created).
  12. Click Save.
  13. At the top of the page, click Rolling update.
  14. Leave all the defaults/presets as-is and click Update.
  15. 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.