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 nützlich sein:
- Eine bessere Darstellung der auf der VM ausgeführten Arbeitslast.
- Auf das auf der VM ausgeführte Betriebssystem verweisen.
- Um die Namenskonventionen Ihrer Organisation einzuhalten.
Einheitliche VM-Ressourcenkennungen (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 prüfen Sie dann den Wert des Feldsid
.
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 undHOSTNAME.ZONE.c.PROJECT_ID.internal
für zonales DNS. Weitere Informationen finden Sie unter Typen von internen DNS-Namen.
- Nach dem Umbenennen einer VM antwortet der DHCP-Server auf DHCP-Anfragen mit dem aktualisierten Hostnamen im Format
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.
- Sie können keine Instanzen in verwalteten Instanzgruppen (MIGs) umbenennen, da diese Instanzen automatisch und unwiderruflich ihre Namen vom Attribut
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 StatusSUSPENDED
umzubenennen.
- Beenden Sie die Instanz, bevor Sie sie umbenennen, da Sie nur VMs mit dem Status
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 undHOSTNAME.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.
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
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- Set a default region and zone.
Rufen Sie in der Google Cloud Console die Seite VM-Instanzen auf.
Klicken Sie in der Spalte Name auf den Namen der VM.
Beenden Sie die VM, falls noch nicht geschehen. Gehen Sie dazu so vor:
Klicken Sie auf
Beenden.Klicken Sie zur Bestätigung auf Beenden.
Das Beenden der VM kann bis zu 90 Sekunden dauern.
Klicken Sie auf
Bearbeiten.Geben Sie im Feld Name der VM-Instanz einen neuen Namen für die VM ein.
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.
Falls nötig, starten Sie die VM neu. Klicken Sie dazu auf
Starten / Fortsetzen.Beenden Sie die VM, falls noch nicht geschehen.
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.
Falls nötig, können Sie die VM neu starten.
Beenden Sie die VM, falls noch nicht geschehen.
Senden Sie zum Umbenennen der VM eine
POST
-Anfrage an die Methodeinstances.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.
Falls nötig, können Sie die VM neu starten.
Weitere Informationen zum Lebenszyklus von VMs
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 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 beendete VMs mit dem Status
TERMINATED
umbenennen.Console
So benennen Sie eine VM um:
gcloud
So benennen Sie eine VM um:
REST
So benennen Sie eine VM um:
Wie geht es weiter?
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2024-11-21 (UTC).
-