Rinomina una VM

Quando crei un'istanza di una macchina virtuale (VM), devi specificare un nome. Dopo il giorno 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 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 individuarlo.

  • 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 modifica l'importo fatturato. Inoltre, poiché i tuoi mostra le VM in base agli SKU (codice identificativo dell'inventario) e non i nomi delle VM non li vedrai nella fattura.

Limitazioni

Quando si rinomina una VM, si applicano le limitazioni seguenti:

  • Risorse con nome automatico:

    • Quando rinomini una VM, i nomi delle risorse che erano basate 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 il 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, consulta Tipi di DNS interni personalizzati.

  • Console Google Cloud:

    • Per aggiornare la console Google Cloud, devi aggiornare il browser 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 un riavvio.

    • VM che hanno un valore i nomi host non vengono aggiornati.

    • La modifica del nome host direttamente sull'host non influisce sul nome del server una risorsa VM.

  • Gruppi di istanze gestite:

    • Non puoi rinominare le istanze che si trovano in gruppi di istanze gestite poiché queste istanze ereditano automaticamente e in modo irreversibile i propri nomi dalla proprietà base instance name del MIG stateless.

  • Convenzioni di denominazione:

  • Stati della VM:

    • Arresta l'istanza prima del giorno rinominandolo perché puoi rinominare solo le VM che si trovano nella zona TERMINATED stato. Ad esempio, non puoi rinominare una VM in stato SUSPENDED.

Prima di iniziare

  • Controlla e, se applicabile, aggiorna quanto segue:
    • Gruppi, grafici e avvisi di Cloud Monitoring: Il monitoraggio associa le stringhe e, quando rinomini una VM, queste stringhe non vengono aggiornate. Se rinomini una VM, aggiorna Regole di monitoraggio per includere le VM rinominate report.
    • URL console: la ridenominazione di una VM ne modifica l'URL console. Se rinomini una VM, devi aggiornare i link, ad esempio il browser preferiti 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 un particolare stringa. Queste associazioni non vengono aggiornate quando modifichi il nome di una VM, pertanto l'accesso di un utente alla risorsa VM potrebbe essere influenzato modificare l'insieme di VM a cui si applica il nome con prefisso. Se rinomini un 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. A questo punto, 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 Rinominare una VM, aggiornare eventuali script o programmi che eseguono query sul server metadati quindi interrogano il 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 IP esterno 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, vedi Rinomina un computer che ospita un'istanza standalone di SQL Server.
  • Se non l'hai ancora fatto, configura l'autenticazione. Autenticazione è Il processo di verifica dell'identità per l'accesso ai servizi e alle API di Google Cloud. Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi autenticarti su Compute Engine come segue.

    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, vedi Esegui 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 compute.instances.setName autorizzazione, che è obbligatorio 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 l'hai già fatto, arresta la VM seguendo questi passaggi:

    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 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.

    Il completamento della ridenominazione della VM può richiedere fino a un minuto.

  3. Se necessario, riavvia la VM.

REST

Per rinominare una VM:

  1. Se non l'hai già fatto, interrompere la VM.

  2. Per rinominare la VM, invia una richiesta POST alla 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 individuarlo.

    • 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 tramite Google Cloud CLI o tramite l'API Compute Engine. Per saperne di più, consulta la sezione Gestione delle risposte dell'API.

  3. Se necessario, riavvia la VM.

Passaggi successivi