Cet article explique comment modifier l'adresse IP d'une instance Apigee à l'aide d'une mise à jour manuelle des VM.
Présentation
Lorsqu'une instance Apigee est supprimée, puis recréée, une adresse IP est générée pour l'instance nouvellement créée. Par exemple, certains paramètres d'instance, tels que l'élément cidrRange et la mise en réseau, sont immuables. Par conséquent, si vous souhaitez modifier ces paramètres, vous devez supprimer l'instance et la recréer avec la configuration souhaitée.
Dans la plupart des cas, lorsque vous recréez une instance, la même adresse IP d'instance est sélectionnée, mais l'obtention de la même adresse IP n'est pas garantie. Les VM qui acheminent le trafic de l'équilibreur de charge vers l'adresse IP privée d'Apigee conservent la valeur de l'ancienne adresse IP. Par conséquent, dans les cas où une nouvelle adresse IP d'instance est générée, vous devez mettre à jour manuellement ces VM avec la nouvelle adresse IP.
Modifier l'adresse IP d'une instance
Pour mettre à jour les VM avec une nouvelle adresse IP d'instance, procédez comme suit :
Dans la console Google Cloud , accédez à la page Virtual Machines>Instance templates (Machines virtuelles > Modèles d'instances).
Cliquez sur le modèle d'instance Apigee (le modèle que vous souhaitez copier et mettre à jour).
Cliquez sur Créer une instance similaire.
Dans le champ Nom, indiquez un nouveau nom pour le modèle. Par exemple, vous pouvez ajouter un suffixe tel que "v2" à la fin du nom d'origine.
Sous Options avancées, cliquez sur l'onglet Gestion.
Faites défiler la page jusqu'à la section Métadonnées (facultatif) et recherchez la paire clé/valeur contenant la clé ENDPOINT. Modifiez la valeur du point de terminaison pour qu'elle corresponde à la nouvelle adresse IP de l'instance. Utilisez votre propre adresse IP, et non celle affichée dans la capture d'écran :
Cliquez sur Créer pour générer le modèle.
Dans la console Google Cloud , accédez à la page Groupes d'instances.
Dans la colonne Nom de la liste, cliquez sur le nom du groupe d'instances Apigee que vous souhaitez modifier.
Cliquez sur Modifier pour modifier ce groupe d'instances.
Dans la section Modèle d'instance, sélectionnez le nouveau modèle d'instance (celui que vous venez de créer).
Cliquez sur Enregistrer.
En haut de la page, cliquez sur Mise à jour progressive.
Conservez toutes les valeurs par défaut/préréglages sans les modifier et cliquez sur Mettre à jour.
La mise en service des nouvelles VM prend quelques minutes, et les anciennes VM sont arrêtées et supprimées. Une fois que les nouvelles VM sont opérationnelles, l'ensemble du trafic des API reprend normalement.
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/05 (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/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."]]