En este tema, se explica cómo cambiar la IP de una instancia de Apigee mediante la actualización manual de las VM.
Descripción general
Cuando una instancia de Apigee se borra y, luego, se crea de nuevo, se genera una dirección IP para la instancia recién creada. Por ejemplo, ciertos parámetros de instancia, como cidrRange y herramientas de redes, son inmutables. Por lo tanto, si deseas cambiar estos parámetros, debes borrar la instancia y volver a crearla con la configuración deseada.
En la mayoría de los casos, cuando vuelves a crear una instancia, se selecciona la misma IP de instancia, pero no se garantiza obtener la misma IP. Las VM que enrutan el tráfico desde el balanceador de cargas a la IP privada de Apigee aún tienen la dirección IP anterior. Por lo tanto, en los casos en los que se genera una IP de instancia nueva, debes actualizar de forma manual las VM con la IP nueva.
Cambia la IP de la instancia
Para actualizar las VM con una IP de instancia nueva, sigue estos pasos:
Haz clic en la plantilla de instancias de Apigee (la plantilla que deseas copiar y actualizar).
Haz clic en Crear una similar.
En el campo Nombre, proporciona un nombre nuevo para la plantilla. Por ejemplo, puedes agregar un sufijo como “v2” al final del nombre original.
En Opciones avanzadas, haz clic en la pestaña Administración.
Desplázate hacia abajo hasta la sección Metadatos (opcional) y busca el par clave-valor que contiene la clave ENDPOINT. Cambia el valor del extremo para que coincida con la IP de la instancia nueva. Usa tu IP, no la que se muestra en la captura de pantalla:
En la columna Nombre de la lista, haz clic en el nombre del grupo de instancias de Apigee que deseas modificar.
Haz clic en Editar para modificar este grupo de instancias no administrado.
En Plantilla de instancias, selecciona la plantilla de instancias nueva (la que acabas de crear).
Haz clic en Guardar.
En la parte superior de la página, haz clic en Actualización progresiva.
Deje todos los valores predeterminados o predeterminados con las opciones tal como están y haga clic en Actualizar.
Las VM nuevas tardan unos minutos en aparecer y las VM antiguas se apagarán y se quitarán. Una vez que las VM nuevas estén en funcionamiento, todo el tráfico de API se reanudará normalmente.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Información o código de muestra incorrectos","incorrectInformationOrSampleCode","thumb-down"],["Faltan la información o los ejemplos que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-09-04 (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."]]