VM umbenennen

Wenn Sie eine VM-Instanz erstellen, müssen Sie einen Namen angeben. Nach dem Erstellen der VM können Sie sie optional umbenennen. Das Ändern des Namens einer VM kann in den folgenden Fällen nützlich sein:

  • Bessere Darstellung der Arbeitslast, die auf der VM ausgeführt wird.
  • Verweis auf das Betriebssystem, das auf der VM ausgeführt wird.
  • Einhaltung der Namenskonventionen Ihrer Organisation

URIs (Uniform Resource Identifiers) der VM

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 sehen Sie sich dann den Wert des Felds id an.

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 aller Ressourcen, die auf dem ursprünglichen VM-Namen basieren, nicht aktualisiert. Wenn Sie beispielsweise eine VM erstellen, ist der Name des Bootlaufwerks mit dem Namen der VM identisch. 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 Namen der SQL Server-VM 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 bei Compute Engine authentifizieren. Wählen Sie dazu eine der folgenden Optionen aus:

    Select the tab for how you plan to use the samples on this page:

    Console

    When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

    gcloud

    1. Install the Google Cloud CLI, then initialize it by running the following command: 

      gcloud init
    2. Set a default region and zone.

      3. REST

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

        Install the Google Cloud CLI, then initialize it by running the following command: 

        gcloud init

      Weitere Informationen finden Sie unter Für die Verwendung von REST authentifizieren in der Dokumentation zur Google Cloud-Authentifizierung.

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 auf Projekte, Ordner und Organisationen 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 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:

    1. Klicken Sie auf Beenden.

    2. Klicken Sie zur Bestätigung auf Beenden.

      Es kann bis zu 90 Sekunden dauern, bis die VM angehalten wurde.

  4. Klicken Sie auf  Bearbeiten.

  5. Geben Sie im Feld Name der VM-Instanz 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 Ihren Browser.

  7. Starten Sie die VM bei Bedarf neu, indem Sie auf Starten / Fortsetzen klicken.

gcloud

So benennen Sie eine VM um:

  1. Beenden Sie die VM, falls Sie dies noch nicht getan haben.

  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: 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. Starten Sie die VM neu.

REST

So benennen Sie eine VM um:

  1. Beenden Sie die VM, falls Sie dies noch nicht getan haben.

  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: 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. Starten Sie die VM neu.

Wie geht es weiter?