Rinominare una VM

Quando crei un'istanza di una macchina virtuale (VM), devi specificare un nome. Dopo aver creato la VM, puoi rinominarla. La modifica del nome di una VM potrebbe 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 per nome, puoi farlo tramite il relativo 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 fatturato. Inoltre, poiché la fattura mostra le VM in base ai relativi codici SKU e non ai nomi, non vedrai i nomi delle VM sulla fattura.

Limitazioni

Quando rinomini una VM, si applicano le limitazioni relative a quanto segue:

  • Risorse con nome assegnato automaticamente:

    • Quando rinomini una VM, i nomi di eventuali risorse basate sul nome della VM originale non vengono aggiornati. Ad esempio, quando crei una VM, il nome del disco di avvio corrisponde a quello 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 nel formatoHOSTNAME.c.PROJECT_ID.internal per il DNS globale eHOSTNAME.ZONE.c.PROJECT_ID.internal per il DNS di zona. Per ulteriori informazioni, vedi Tipi di nomi DNS interni.

  • Console Google Cloud:

    • Devi aggiornare il browser affinché la console Google Cloud aggiorni il nome della VM.

  • Nomi host:

    • I nomi host vengono modificati quando cambi il nome dell'istanza. Su Windows, gli aggiornamenti del nome host potrebbero richiedere un riavvio.

    • Le VM con 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 nei gruppi di istanze gestite (MIG) perché ereditano automaticamente e irreversibilmente i nomi dalla proprietà base instance name del loro gruppo di istanze stateless.

  • Convenzioni di denominazione:

  • Stati della VM:

    • Arresta l'istanza prima di rinominarla, perché puoi rinominare solo le VM nello stato TERMINATED. Ad esempio, non puoi rinominare una VM in stato SUSPENDED.

Prima di iniziare

  • Esamina e, se applicabile, aggiorna quanto segue:
    • Gruppi, grafici e avvisi di Cloud Monitoring: il monitoraggio corrisponde alle stringhe e, quando rinomini una VM, queste stringhe non vengono aggiornate. Se rinomini una VM, aggiorna le tue regole di monitoraggio in modo da includere le VM rinominate nei report.
    • URL console: la ridenominazione di una VM ne modifica l'URL console. Se rinomini una VM, devi aggiornare i link, ad esempio i browser segnalibri 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 sul nome della risorsa. Ad esempio, IAM potrebbe concedere un ruolo a un utente se il nome di una VM inizia con una determinata stringa. Queste associazioni non vengono aggiornate quando modifichi il nome di una VM, pertanto l'accesso di un utente alla risorsa VM potrebbe essere interessato perché stai modificando l'insieme di VM a cui si applica il nome con prefisso. Se rinomini una VM, aggiorna queste associazioni.
    • Cache del servizio DNS interno: 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 a livello di zona. Dopo aver rinominato una VM, questi nomi host cambiano. Successivamente, il servizio DNS interno inizia a risolvere il nuovo nome host e le richieste al nome DNS precedente non vanno a buon fine. Se rinomini una VM, potresti dover aggiornare la cache DNS per aggiornare il nome host. Per maggiori informazioni sugli hostname DNS globali e DNS a livello di zona, consulta Tipi di nomi DNS interni.
    • Query sui metadati: dopo aver rinominato una VM, il server metadati segnala il nuovo nome. Se rinomini una VM, aggiorna gli script o i programmi che eseguono query sul server metadati in modo che eseguano query sul nuovo nome della VM.
    • Criteri dell'organizzazione che limitano gli indirizzi IP esterni: i vincoli relativi alle 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 per gli IP esterni con il nuovo nome della VM.
    • Nomi host di SQL Server: se rinomini una VM che ospita SQL Server, devi aggiornare il nome della VM SQL Server. Per ulteriori informazioni, consulta Rinominare un computer che ospita un'istanza autonoma di SQL Server.
  • Se non l'hai ancora fatto, configura l'autenticazione. L'autenticazione è la procedura mediante la quale la tua identità viene verificata per l'accesso alle API e ai servizi Google Cloud. Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi autenticarti su Compute Engine selezionando una delle seguenti opzioni:

    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

      Per utilizzare gli esempi dell'API REST in questa pagina in un ambiente di sviluppo locale, utilizza le credenziali fornite a gcloud CLI.

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

        gcloud init

      Per ulteriori informazioni, consulta Eseguire l'autenticazione per l'utilizzo di REST nella documentazione sull'autenticazione di Google Cloud.

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) nel progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso a progetti, cartelle e organizzazioni.

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

Potresti anche ottenere questa autorizzazione con ruoli personalizzati o altri ruoli predefiniti.

Rinominare una VM

Puoi rinominare solo le VM arrestate nello stato TERMINATED.

Console

Per rinominare una VM:

  1. Nella console Google Cloud, vai alla pagina Istanze VM.

    Vai a Istanze VM

  2. Nella colonna Nome, fai clic sul nome della VM.

  3. Se non lo hai già fatto, arresta la VM nel seguente modo:

    1. Fai clic su Interrompi.

    2. Per confermare, fai clic su Interrompi.

      L'arresto della VM può richiedere fino a 90 secondi.

  4. Fai clic su Modifica.

  5. Nel campo Nome istanza VM, inserisci un nuovo nome per la VM.

  6. Fai clic su Salva.

    La ridenominazione della VM può richiedere fino a un minuto. Se, dopo aver rinominato la VM, viene visualizzato un messaggio di errore che indica che Google Cloud non è in grado di trovarla, aggiorna il browser.

  7. Se necessario, riavvia la VM facendo clic su Avvia / Riprendi.

gcloud

Per rinominare una VM:

  1. Se non lo hai ancora fatto, arresta la VM.

  2. 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 della VM specificata.

    • PROJECT_ID: l'ID del progetto in cui si trova la VM.

    • ZONE: la zona in cui si trova la VM.

    La ridenominazione della VM può richiedere fino a un minuto.

  3. Se necessario, riavvia la VM.

REST

Per rinominare una VM:

  1. Se non lo hai ancora fatto, arresta la VM.

  2. Per rinominare la VM, invia 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 della VM specificata.

    La 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 saperne di più, consulta la sezione Gestione delle risposte dell'API.

  3. Se necessario, riavvia la VM.

Passaggi successivi