Rinomina una VM

Quando crei un'istanza di una macchina virtuale (VM), devi specificare un nome. Dopo aver creato la VM, puoi facoltativamente rinominarla. La modifica del nome di una VM può essere utile nei seguenti scenari:

per rappresentare meglio il carico di lavoro in esecuzione sulla VM.
Per fare riferimento al sistema operativo in esecuzione sulla VM.
Per rispettare le convenzioni di denominazione richieste dalla tua organizzazione.

URI (Uniform Resource Identifier) delle VM

La modifica del nome di una VM potrebbe influire sui tuoi progetti. Anziché fare riferimento alle risorse VM con il nome, puoi farvi riferimento tramite l'URI, che è permanente. L'URI ha il seguente formato:

projects/PROJECT_ID/zones/ZONE/instances/VM_ID

L'URI include i seguenti valori:

PROJECT_ID: l'ID del progetto in cui si trova la VM.
ZONE: la zona in cui si trova la VM.
VM_ID: l'ID di una VM esistente. Per visualizzare l'ID di una VM esistente, visualizza i dettagli della VM e poi il valore del campo id.

Prezzi

La ridenominazione di una VM non cambia l'importo che ti viene addebitato. Inoltre, poiché la tua fattura mostra le VM in base alle loro unità di conservazione di magazzino (SKU) e non ai loro nomi, i nomi delle VM non verranno visualizzati nella fattura.

Limitazioni

In caso di ridenominazione di una VM si applicano le seguenti limitazioni:

Risorse con nome automatico:
- Quando rinomini una VM, i nomi delle risorse che erano basati sul nome della VM originale non vengono aggiornati. Ad esempio, quando crei una VM, il nome del disco di avvio corrisponde al nome della VM. Se rinomini la VM, il nome del disco di avvio non cambia.
Server DHCP:
- Dopo aver rinominato una VM, il server DHCP risponde alle richieste DHCP con il nome host aggiornato con il formato HOSTNAME.c.PROJECT_ID.internal per il DNS globale e HOSTNAME.ZONE.c.PROJECT_ID.internal per il DNS di zona. Per ulteriori informazioni, consulta Tipi di nomi DNS interni.
Console Google Cloud:
- Devi aggiornare il browser per la console Google Cloud in modo da aggiornare il nome della VM.
Nomi host:
- I nomi host vengono modificati quando cambi il nome dell'istanza. Su Windows, gli aggiornamenti dei nomi host potrebbero richiedere il riavvio.
- Le VM che hanno nomi host personalizzati non vengono aggiornate.
- La modifica del nome host direttamente sull'host non influisce sul nome della risorsa VM.
Gruppi di istanze gestite:
- Non puoi rinominare le istanze che si trovano in gruppi di istanze gestite perché queste istanze ereditano automaticamente e in modo irreversibile i nomi dalla proprietà base instance name del relativo gruppo di istanze gestite stateless.
Convenzioni di denominazione:
- Non puoi rinominare una VM con un nome già utilizzato da un'altra VM nel progetto.
- I nomi delle VM devono rispettare le convenzioni di denominazione delle risorse.
Stati delle VM:
- Arresta l'istanza prima di rinominarla perché puoi rinominare solo le VM che si trovano nello stato TERMINATED. Ad esempio, non puoi rinominare una VM nello stato SUSPENDED.

Prima di iniziare

Controlla e, se applicabile, aggiorna quanto segue:
- Gruppi, grafici e avvisi di Cloud Monitoring: Monitoring corrisponde alle stringhe, che non vengono aggiornate quando rinomini una VM. Se rinomini una VM, aggiorna le regole di Monitoring in modo da includere le VM rinominate nei report.
- URL della console: la ridenominazione di una VM comporta la modifica dell'URL della console. Se rinomini una VM, devi aggiornare i collegamenti, ad esempio i preferiti del browser che fanno riferimento all'URL della console della VM.
- Associazioni di ruoli condizionali di Identity and Access Management (IAM): le associazioni di ruoli condizionali supportano la concessione di autorizzazioni per il nome della risorsa. Ad esempio, IAM potrebbe concedere un ruolo a un utente se il nome di una VM inizia con una stringa specifica. Queste associazioni non vengono aggiornate quando modifichi il nome di una VM, perciò l'accesso di un utente alla risorsa VM potrebbe essere influenzato dalla modifica del set di VM a cui si applica il nome prefisso. Se rinomini una VM, aggiorna queste associazioni.
- Cache di servizio DNS interna: il servizio DNS interno assegna nomi DNS interni alle VM, in cui il nome host è nel formato HOSTNAME.c.PROJECT_ID.internal per il DNS globale e HOSTNAME.ZONE.c.PROJECT_ID.internal per il DNS di zona. Dopo la ridenominazione di una VM, questi nomi host cambiano. Quindi, il servizio DNS interno inizia a risolversi nel nuovo nome host e le richieste al nome DNS precedente non riescono. Se rinomini una VM, potresti dover aggiornare la cache DNS per aggiornare il nome host. Per saperne di più sui nomi host DNS globali e di zona, consulta Tipi di nomi DNS interni.
- Query sui metadati: dopo aver rinominato una VM, il server dei metadati segnala il nuovo nome. Se rinomini una VM, aggiorna gli script o i programmi che eseguono query sul server dei metadati in modo da cercare il nuovo nome della VM.
- Criteri dell'organizzazione che limitano gli indirizzi IP esterni: i vincoli per le VM con un indirizzo IP esterno fanno riferimento al nome della VM. Quando rinomini una VM, questo vincolo non viene aggiornato. Se rinomini una VM, aggiorna il criterio dell'organizzazione IP esterno con il nuovo nome della VM.
- Nomi host SQL Server: se rinomini una VM che ospita SQL Server, devi aggiornare il nome della VM SQL Server. Per maggiori informazioni, consulta Rinominare un computer che ospita un'istanza autonoma di SQL Server.
Se non l'hai ancora fatto, configura l'autenticazione. L'autenticazione è il processo mediante il quale viene verificata l'identità per l'accesso ai servizi e alle API Google Cloud. Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi autenticarti in Compute Engine nel seguente modo.

Seleziona la scheda relativa a come prevedi di utilizzare gli esempi in questa pagina:
Console

Quando utilizzi la console Google Cloud per accedere ai servizi e alle API di Google Cloud, non devi configurare l'autenticazione.
gcloud
1. Installa Google Cloud CLI, quindi initialize eseguendo questo comando:
```
gcloud init
```
  Nota: se hai già installato gcloud CLI in precedenza, assicurati di disporre della versione più recente eseguendo gcloud components update.
2. Imposta una regione e una zona predefinite.
REST

Per utilizzare gli esempi di API REST in questa pagina in un ambiente di sviluppo locale, devi utilizzare le credenziali che fornisci a gcloud CLI.

Ruoli obbligatori

Per ottenere l'autorizzazione necessaria per rinominare una VM, chiedi all'amministratore di concederti il ruolo IAM Amministratore istanze Compute (v1) (roles/compute.instanceAdmin.v1) per il progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso.

Questo ruolo predefinito contiene l'autorizzazione compute.instances.setName, necessaria per rinominare una VM.

Potresti anche essere in grado di ottenere questa autorizzazione con i ruoli personalizzati o altri ruoli predefiniti.

Rinomina una VM

Puoi rinominare solo le VM arrestate che si trovano nello stato TERMINATED.

Console

Per rinominare una VM:

Nella console Google Cloud, vai alla pagina Istanze VM.

Vai a Istanze VM
Nella colonna Nome, fai clic sul nome della VM.
Se non lo hai già fatto, arresta la VM nel seguente modo:
1. Fai clic su Interrompi.
2. Fai clic su Interrompi per confermare.
  
  L'arresto della VM può richiedere fino a 90 secondi.
Fai clic su Modifica.
Nel campo Nome istanza VM, inserisci un nuovo nome per la VM.
Fai clic su Salva.

Il completamento della ridenominazione della VM può richiedere fino a un minuto. Se, dopo aver rinominato la VM, viene visualizzato un errore che indica che Google Cloud non è in grado di trovare la VM, aggiorna il browser.
Se necessario, riavvia la VM facendo clic su Avvia / Riprendi.

gcloud

Per rinominare una VM:

Se non l'hai già fatto, arresta la VM.
Per rinominare la VM, utilizza il comando gcloud compute instances set-name.
```
gcloud compute instances set-name VM_NAME \
    --new-name=NEW_VM_NAME \
    --project=PROJECT_ID \
    --zone=ZONE
```
Sostituisci quanto segue:
- VM_NAME: il nome di una VM esistente.
- NEW_VM_NAME: il nuovo nome per la VM specificata.
- PROJECT_ID: l'ID del progetto in cui si trova la VM.
- ZONE: la zona in cui si trova la VM.
Il completamento della ridenominazione della VM può richiedere fino a un minuto.
Se necessario, riavvia la VM.

REST

Per rinominare una VM:

Se non l'hai già fatto, arresta la VM.
Per rinominare la VM, effettua una richiesta POST al metodo 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"
}
```
Sostituisci quanto segue:
- PROJECT_ID: l'ID del progetto in cui si trova la VM.
- ZONE: la zona in cui si trova la VM.
- VM_NAME: il nome di una VM esistente.
- NEW_VM_NAME: il nuovo nome per la VM specificata.
Il completamento della ridenominazione della VM può richiedere fino a un minuto. Per monitorare lo stato della ridenominazione, esegui il polling dell'ID operazione restituito dall'API di ridenominazione. Per ulteriori informazioni, consulta la sezione Gestione delle risposte dell'API.
Se necessario, riavvia la VM.

Passaggi successivi

Scopri come visualizzare i dettagli della VM.
Scopri come arrestare o riavviare una VM.
Scopri come sospendere o ripristinare una VM.
Scopri di più sul ciclo di vita delle VM.