Renommer une VM

Lorsque vous créez une instance de machine virtuelle (VM), vous devez spécifier un nom. Une fois la VM créée, vous pouvez éventuellement la renommer. Il peut être utile de modifier le nom d'une VM dans les scénarios suivants :

  • Pour décrire plus fidèlement la charge de travail exécutée sur la VM
  • Pour faire référence au système d'exploitation exécuté sur la VM
  • Pour respecter les conventions de dénomination requises par votre organisation

URI (Uniform Resource Identifiers) de VM

La modification du nom d'une VM peut avoir une incidence sur vos projets. Au lieu de référencer les ressources de VM par leur nom, vous pouvez les référencer par leur URI, qui est permanente. L'URI est au format suivant :

projects/PROJECT_ID/zones/ZONE/instances/VM_ID

L'URI inclut les valeurs suivantes :

  • PROJECT_ID : ID du projet dans lequel se trouve la VM.

  • ZONE : zone où se trouve la VM.

  • VM_ID : ID d'une VM existante. Pour afficher l'ID d'une VM existante, affichez les détails de la VM, puis affichez la valeur du champ id.

Tarifs

Le fait de renommer une VM ne modifie pas le montant qui vous est facturé. En outre, étant donné que votre facture indique les VM en fonction de leur unité de gestion des stocks (SKU) et non de leur nom, les noms de vos VM ne s'afficheront pas sur votre facture.

Limites

Les limites suivantes s'appliquent lors du changement de nom d'une VM :

  • Ressources nommées automatiquement

    • Lorsque vous renommez une VM, les noms des ressources basées sur le nom de la VM d'origine ne sont pas mis à jour. Par exemple, lorsque vous créez une VM, le nom du disque de démarrage est identique à celui de la VM. Si vous renommez la VM, le nom du disque de démarrage ne change pas.

  • Serveur DHCP :

    • Après avoir renommé une VM, le serveur DHCP répond aux requêtes DHCP avec le nom d'hôte mis à jour au format HOSTNAME.c.PROJECT_ID.internal pour le DNS global et HOSTNAME.ZONE.c.PROJECT_ID.internal pour le DNS zonal. Pour en savoir plus, consultez la section Types de noms DNS internes.

  • Console Google Cloud :

    • Vous devez actualiser le navigateur pour que la console Google Cloud mette à jour le nom de la VM.

  • Noms d'hôte :

    • Les noms d'hôte sont modifiés lorsque vous modifiez le nom de l'instance. Sous Windows, les mises à jour du nom d'hôte peuvent nécessiter un redémarrage.

    • Les VM disposant de noms d'hôte personnalisés ne sont pas mises à jour.

    • Le fait de modifier le nom d'hôte directement sur l'hôte n'affecte pas le nom de la ressource de VM.

  • Groupes d'instances gérés :

    • Vous ne pouvez pas renommer les instances qui se trouvent dans des groupes d'instances gérés (MIG), car ces instances héritent automatiquement et de manière irréversible de leurs noms depuis la propriété base instance name de leur groupe d'instances géré sans état.

  • Conventions de nommage :

  • États des VM :

    • Arrêtez l'instance avant de la renommer, car vous ne pouvez renommer que les VM dont l'état est TERMINATED. Par exemple, vous ne pouvez pas renommer une VM dont l'état est SUSPENDED.

Avant de commencer

  • Vérifiez et, le cas échéant, mettez à jour les éléments suivants :
    • Groupes, graphiques et alertes Cloud Monitoring : Monitoring applique des correspondances aux chaînes et lorsque vous renommez une VM, ces chaînes ne sont pas mises à jour. Si vous renommez une VM, mettez à jour vos règles de surveillance pour inclure les VM renommées dans vos rapports.
    • URL de la console : la modification du nom d'une VM modifie son URL de la console. Si vous renommez une VM, vous devez mettre à jour les liens, tels que les favoris de navigateur, qui font référence à l'URL de la console de la VM.
    • Liaisons de rôles conditionnelles IAM (Identity and Access Management) : les liaisons conditionnelles de rôle permettent d'accorder des autorisations sur le nom de la ressource. Par exemple, IAM peut accorder un rôle à un utilisateur si le nom d'une VM commence par une chaîne spécifique. Ces liaisons ne sont pas mises à jour lorsque vous modifiez le nom d'une VM. Par conséquent, l'accès d'un utilisateur à la ressource de VM peut être affecté si vous modifiez l'ensemble de VM auquel le nom préfixé s'applique. Si vous renommez une VM, mettez à jour ces liaisons.
    • Cache de service DNS interne : le service DNS interne attribue aux VM des noms DNS internes dont le nom d'hôte est au format HOSTNAME.c.PROJECT_ID.internal pour le DNS global et HOSTNAME.ZONE.c.PROJECT_ID.internal pour le DNS zonal. Ces noms d'hôte changent après la modification du nom d'une VM. Ensuite, le service DNS interne commence à résoudre le nouveau nom d'hôte et les requêtes adressées au nom DNS précédent échouent. Si vous renommez une VM, vous devrez peut-être mettre à jour le cache DNS pour mettre à jour le nom d'hôte. Pour plus d'informations sur les noms d'hôte DNS globaux et DNS zonaux, consultez la section Types de noms DNS internes.
    • Requêtes de métadonnées : après avoir renommé une VM, le serveur de métadonnées signale le nouveau nom. Si vous renommez une VM, mettez à jour tous les scripts ou programmes qui interrogent le serveur de métadonnées afin qu'ils interrogent le nouveau nom de la VM.
    • Règles d'administration limitant les adresses IP externes : contraintes liées aux VM ayant une adresse IP externe faisant référence au nom de la VM. Lorsque vous renommez une VM, cette contrainte n'est pas mise à jour. Si vous renommez une VM, mettez à jour la règle d'administration IP externe avec le nouveau nom de la VM.
    • Noms d'hôte SQL Server : si vous renommez une VM qui héberge SQL Server, vous devez mettre à jour le nom de la VM SQL Server. Pour en savoir plus, consultez la page Renommer un ordinateur qui héberge une instance autonome de SQL Server.
  • Si ce n'est pas déjà fait, configurez l'authentification. L'authentification est le processus permettant de valider votre identité pour accéder aux services et aux API Google Cloud. Pour exécuter du code ou des exemples depuis un environnement de développement local, vous pouvez vous authentifier auprès de Compute Engine comme suit :

    Sélectionnez l'onglet correspondant à la façon dont vous prévoyez d'utiliser les exemples de cette page :

    Console

    Lorsque vous utilisez la console Google Cloud pour accéder aux services et aux API Google Cloud, vous n'avez pas besoin de configurer l'authentification.

    gcloud

    1. Installez Google Cloud CLI, puis initialisez-la en exécutant la commande suivante : 

      gcloud init
    2. Définissez une région et une zone par défaut.

    REST

    Pour utiliser les exemples d'API REST de cette page dans un environnement de développement local, vous devez utiliser les identifiants que vous fournissez à gcloud CLI.

      Installez Google Cloud CLI, puis initialisez-la en exécutant la commande suivante : 

      gcloud init

Rôles requis

Pour obtenir l'autorisation dont vous avez besoin pour renommer une VM, demandez à votre administrateur de vous accorder le rôle IAM Administrateur d'instances Compute (v1) (roles/compute.instanceAdmin.v1) sur le projet. Pour en savoir plus sur l'attribution de rôles, consultez la section Gérer les accès.

Ce rôle prédéfini contient l'autorisation compute.instances.setName, qui est requise pour renommer une VM.

Vous pouvez également obtenir cette autorisation avec des rôles personnalisés ou d'autres rôles prédéfinis.

Renommer une VM

Vous ne pouvez renommer que les VM arrêtées dont l'état est TERMINATED.

Console

Pour renommer une VM, procédez comme suit :

  1. Dans Google Cloud Console, accédez à la page Instances de VM.

    Accéder à la page "Instances de VM"

  2. Dans la colonne Nom, cliquez sur le nom de la VM.

  3. Si vous ne l'avez pas déjà fait, arrêtez la VM en procédant comme suit :

    1. Cliquez sur Arrêter.

    2. Pour confirmer, cliquez sur Arrêter.

      L'arrêt de la VM peut prendre jusqu'à 90 secondes.

  4. Cliquez sur Modifier.

  5. Dans le champ Nom de l'instance de VM, saisissez un nouveau nom pour la VM.

  6. Cliquez sur Enregistrer.

    Le changement de nom de la VM peut prendre jusqu'à une minute. Si, après avoir renommé la VM, vous obtenez un message d'erreur indiquant que Google Cloud ne parvient pas à trouver la VM, actualisez votre navigateur.

  7. Si nécessaire, redémarrez la VM en cliquant sur Démarrer/Reprendre.

gcloud

Pour renommer une VM, procédez comme suit :

  1. Si vous ne l'avez pas déjà fait, arrêtez la VM.

  2. Pour renommer la VM, utilisez la commande gcloud compute instances set-name.

    gcloud compute instances set-name VM_NAME \
    --new-name=NEW_VM_NAME \
    --project=PROJECT_ID \
    --zone=ZONE

    Remplacez les éléments suivants :

    • VM_NAME : nom d'une VM existante.

    • NEW_VM_NAME : nouveau nom de la VM spécifiée.

    • PROJECT_ID : ID du projet dans lequel se trouve la VM.

    • ZONE : zone où se trouve la VM.

    Le changement de nom de la VM peut prendre jusqu'à une minute.

  3. Si nécessaire, redémarrez la VM.

REST

Pour renommer une VM, procédez comme suit :

  1. Si vous ne l'avez pas déjà fait, arrêtez la VM.

  2. Pour renommer la VM, envoyez une requête POST à la méthode instances.setName.

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME/setName

{
  "currentName": "VM_NAME",
  "name": "NEW_VM_NAME"
}

    Remplacez les éléments suivants :

    • PROJECT_ID : ID du projet dans lequel se trouve la VM.

    • ZONE : zone où se trouve la VM.

    • VM_NAME : nom d'une VM existante.

    • NEW_VM_NAME : nouveau nom de la VM spécifiée.

    Le changement de nom de la VM peut prendre jusqu'à une minute. Pour surveiller l'état du changement de nom, interrogez l'ID d'opération renvoyé par l'API de changement de nom. Pour en savoir plus, consultez la page Gérer les réponses de l'API.

  3. Si nécessaire, redémarrez la VM.

Étapes suivantes