VM umbenennen


Wenn Sie eine VM-Instanz erstellen, müssen Sie einen Namen angeben. Nachdem Sie die VM erstellt haben, können Sie sie optional umbenennen. Das Ändern eines VM-Namens kann in den folgenden Szenarien hilfreich sein:

  • Die Arbeitslast, die auf der VM ausgeführt wird, besser darzustellen.
  • Verweisen auf das Betriebssystem, das auf der VM ausgeführt wird.
  • Halten Sie sich an die Namenskonventionen Ihrer Organisation.

VM Uniform Resource Identifiers (URIs)

Das Ändern des Namens einer VM kann sich auf Ihre Projekte auswirken. Anstatt auf VM-Ressourcen anhand ihres Namens zu verweisen, können Sie anhand ihres URI auf sie verweisen. Der URI hat folgendes Format:

projects/PROJECT_ID/zones/ZONE/instances/VM_ID

Der URI enthält die folgenden Werte:

  • PROJECT_ID: die Projekt-ID des Projekts, in dem sich die VM befindet.

  • ZONE ist die Zone, in der sich die VM befindet.

  • VM_ID: die ID einer vorhandenen VM. Wenn Sie die ID einer vorhandenen VM aufrufen möchten, rufen Sie die Details der VM auf und rufen Sie dann den Wert des Felds id auf.

Preise

Das Umbenennen einer VM ändert nicht den Betrag, der Ihnen in Rechnung gestellt wird. Außerdem werden auf Ihrer Rechnung die VMs nach ihrer Artikelnummer und nicht nach ihren Namen angezeigt. Daher sehen Sie auf Ihrer Rechnung nicht die Namen Ihrer VMs.

Beschränkungen

Beim Umbenennen einer VM-Instanz gelten folgende Einschränkungen:

  • Automatisch benannte Ressourcen:

    • Wenn Sie eine VM umbenennen, werden die Namen von Ressourcen, die auf dem ursprünglichen VM-Namen basieren, nicht aktualisiert. Wenn Sie beispielsweise eine VM erstellen, entspricht der Name des Bootlaufwerks dem Namen der VM. Wenn Sie die VM umbenennen, ändert sich der Name des Bootlaufwerks nicht.
  • DHCP-Server:

    • Nach dem Umbenennen einer VM antwortet der DHCP-Server auf DHCP-Anfragen mit dem aktualisierten Hostnamen im Format HOSTNAME.c.PROJECT_ID.internal für globales DNS und HOSTNAME.ZONE.c.PROJECT_ID.internal für zonales DNS. Weitere Informationen finden Sie unter Typen von internen DNS-Namen.
  • Google Cloud Console

    • Sie müssen Ihren Browser für die Google Cloud Console aktualisieren, um den Namen der VM zu aktualisieren.
  • Hostnamen:

    • Hostnamen werden geändert, wenn Sie den Namen der Instanz ändern. Unter Windows ist zur Aktualisierung des Hostnamen möglicherweise ein Neustart erforderlich.

    • VMs mit benutzerdefinierten Hostnamen werden nicht aktualisiert.

    • Das direkte Ändern des Hostnamens auf dem Host wirkt sich nicht auf den Namen der VM-Ressource aus.

  • Verwaltete Instanzgruppen:

    • Sie können keine Instanzen in verwalteten Instanzgruppen (MIGs) umbenennen, da diese Instanzen automatisch und unwiderruflich ihre Namen vom Attribut base instance name ihrer zustandslosen MIG übernehmen.
  • Namenskonventionen:

    • Sie können eine VM nicht mit einem Namen umbenennen, der bereits von einer anderen VM im Projekt verwendet wird.

    • VM-Namen müssen den Namenskonventionen für Ressourcen entsprechen.

  • VM-Status:

    • Beenden Sie die Instanz, bevor Sie sie umbenennen, da Sie nur VMs mit dem Status TERMINATED umbenennen können. Es ist beispielsweise nicht möglich, eine VM mit dem Status SUSPENDED umzubenennen.

Hinweise

  • Prüfen und aktualisieren Sie gegebenenfalls Folgendes:
    • Cloud Monitoring-Gruppen, -Diagramme und -Benachrichtigungen: Monitoring vergleicht Strings. Wenn Sie eine VM umbenennen, werden diese Strings nicht aktualisiert. Wenn Sie eine VM umbenennen, müssen Sie Ihre Monitoring-Regeln so aktualisieren, dass die umbenannten VMs in Ihre Berichte aufgenommen werden.
    • Konsolen-URLs: Durch das Umbenennen einer VM ändert sich die Konsolen-URL. Wenn Sie eine VM umbenennen, müssen Sie Links wie Browserlesezeichen aktualisieren, die auf die Konsolen-URL der VM verweisen.
    • Bedingte Rollenbindungen Identitäts- und Zugriffsverwaltung (IAM): Bedingte Rollenbindungen unterstützen die Erteilung von Berechtigungen für den Namen der Ressource. Beispielsweise könnte IAM einem Nutzer eine Rolle zugewiesen werden, wenn der Name einer VM mit einem bestimmten String beginnt. Diese Bindungen werden nicht aktualisiert, wenn Sie den Namen einer VM ändern. Daher kann der Zugriff eines Nutzers auf die VM-Ressource betroffen sein, da Sie die Anzahl der VMs ändern, für die der Präfixname gilt. Aktualisieren Sie diese Bindungen, wenn Sie eine VM umbenennen.
    • Interner DNS-Dienst-Cache: Der interne DNS-Dienst weist den internen DNS-Namen VMs zu, wobei der Hostname das Format HOSTNAME.c.PROJECT_ID.internal für globales DNS und HOSTNAME.ZONE.c.PROJECT_ID.internal für zonales DNS hat. Nach dem Umbenennen einer VM ändern sich diese Hostnamen. Der interne DNS-Dienst beginnt dann mit dem neuen Hostnamen. Anfragen an den vorherigen DNS-Namen schlagen fehl. Wenn Sie eine VM umbenennen, müssen Sie möglicherweise den DNS-Cache aktualisieren, um den Hostnamen zu aktualisieren. Weitere Informationen zu globalen DNS- und zonalen DNS-Hostnamen finden Sie unter Arten von internen DNS-Namen.
    • Metadatenabfragen: Nach der Umbenennung einer VM meldet der Metadatenserver den neuen Namen. Wenn Sie eine VM umbenennen, müssen Sie alle Skripts oder Programme aktualisieren, die den Metadatenserver abfragen, damit sie den neuen Namen der VM abfragen.
    • Organisationsrichtlinien, die externe IP-Adressen einschränken: Einschränkungen bei VMs, die eine externe IP-Adresse haben, verweisen auf den VM-Namen. Beim Umbenennen einer VM wird diese Einschränkung nicht aktualisiert. Wenn Sie eine VM umbenennen, aktualisieren Sie die Richtlinie für die externe IP-Organisation mit dem neuen Namen der VM.
    • SQL Server-Hostnamen: Wenn Sie eine VM umbenennen, die SQL Server hostet, müssen Sie den SQL Server-VM-Namen aktualisieren. Weitere Informationen finden Sie unter Computer umbenennen, der eine eigenständige Instanz von SQL Server hostet.
  • Richten Sie die Authentifizierung ein, falls Sie dies noch nicht getan haben. Bei der Authentifizierung wird Ihre Identität für den Zugriff auf Google Cloud-Dienste und APIs überprüft. Zur Ausführung von Code oder Beispielen aus einer lokalen Entwicklungsumgebung können Sie sich so bei Compute Engine authentifizieren.

    Wählen Sie den Tab für die Verwendung der Beispiele auf dieser Seite aus:

    Console

    Wenn Sie über die Google Cloud Console auf Google Cloud-Dienste und -APIs zugreifen, müssen Sie die Authentifizierung nicht einrichten.

    gcloud

    1. Installieren Sie die Google Cloud CLI und initialisieren Sie sie mit folgendem Befehl:

      gcloud init
    2. Legen Sie eine Standardregion und -zone fest.

    REST

    Verwenden Sie die von der gcloud CLI bereitgestellten Anmeldedaten, um die REST API-Beispiele auf dieser Seite in einer lokalen Entwicklungsumgebung zu verwenden.

      Installieren Sie die Google Cloud CLI und initialisieren Sie sie mit folgendem Befehl:

      gcloud init

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die Berechtigung zum Umbenennen einer VM zu erteilen. IAM-Rolle Compute-Instanzadministrator (Version 1) (roles/compute.instanceAdmin.v1 ) für das Projekt hinzufügen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff verwalten.

Diese vordefinierte Rolle enthält die Berechtigung compute.instances.setName, die zum Umbenennen einer VM erforderlich ist.

Sie können diese Berechtigung auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.

VM umbenennen

Sie können nur angehaltene VMs mit dem Status TERMINATED umbenennen.

Console

So benennen Sie eine VM um:

  1. Rufen Sie in der Google Cloud Console die Seite VM-Instanzen auf.

    Zu Seite „VM-Instanzen“

  2. Klicken Sie in der Spalte Name auf den Namen der VM.

  3. Beenden Sie die VM, falls noch nicht geschehen. Gehen Sie dafür so vor:

    1. Klicken Sie auf Beenden.

    2. Klicken Sie zur Bestätigung auf Beenden.

      Das Beenden der VM kann bis zu 90 Sekunden dauern.

  4. Klicken Sie auf  Bearbeiten.

  5. Geben Sie im Feld VM-Instanzname einen neuen Namen für die VM ein.

  6. Klicken Sie auf Speichern.

    Das Umbenennen der VM kann bis zu einer Minute dauern. Wenn Sie nach dem Umbenennen der VM die Fehlermeldung erhalten, dass Google Cloud die VM nicht finden kann, aktualisieren Sie den Browser.

  7. Starten Sie die VM bei Bedarf neu. Klicken Sie dazu auf Starten / Fortsetzen.

gcloud

So benennen Sie eine VM um:

  1. Beenden Sie die VM, falls noch nicht geschehen.

  2. Verwenden Sie den Befehl gcloud compute instances set-name, um die VM umzubenennen.

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

    Ersetzen Sie Folgendes:

    • VM_NAME: Der Name einer vorhandenen VM.

    • NEW_VM_NAME ist der neue Name für die angegebene VM.

    • PROJECT_ID: die Projekt-ID des Projekts, in dem sich die VM befindet.

    • ZONE ist die Zone, in der sich die VM befindet.

    Das Umbenennen der VM kann bis zu einer Minute dauern.

  3. Bei Bedarf können Sie die VM neu starten.

REST

So benennen Sie eine VM um:

  1. Beenden Sie die VM, falls noch nicht geschehen.

  2. Wenn Sie die VM umbenennen möchten, senden Sie eine POST-Anfrage an die Methode 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"
    }
    

    Ersetzen Sie Folgendes:

    • PROJECT_ID: die Projekt-ID des Projekts, in dem sich die VM befindet.

    • ZONE ist die Zone, in der sich die VM befindet.

    • VM_NAME: Der Name einer vorhandenen VM.

    • NEW_VM_NAME ist der neue Name für die angegebene VM.

    Das Umbenennen der VM kann bis zu einer Minute dauern. Fragen Sie den Status der Umbenennung ab, indem Sie die Vorgangs-ID abfragen, die von der Umbenennungs-API zurückgegeben wird. Weitere Informationen finden Sie unter API-Antworten verarbeiten.

  3. Bei Bedarf können Sie die VM neu starten.

Wie geht es weiter?