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

Uniform Resource Identifier (URI) delle VM

La modifica del nome di una VM potrebbe influire sui tuoi progetti. Anziché fare riferimento alle risorse VM in base al nome, puoi fare riferimento a queste in base al loro 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 visualizza il valore del campo id.

Prezzi

La ridenominazione di una VM non modifica l'importo che ti viene fatturato. Inoltre, poiché la fattura mostra le VM in base ai codici SKU e non ai nomi, non vedrai i nomi delle VM nella fattura.

Limitazioni

Quando rinomini una VM, si applicano le seguenti limitazioni:

  • Risorse denominate automaticamente:

    • Quando rinomini una VM, i nomi delle risorse basate sul nome della VM originale non vengono aggiornati. Ad esempio, quando crei una VM, il nome del disco di avvio è uguale 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 nel formato HOSTNAME.c.PROJECT_ID.internal per il DNS globale e HOSTNAME.ZONE.c.PROJECT_ID.internal per il DNS di zona. Per saperne di più, vedi Tipi di nomi DNS interni.

  • ConsoleTrusted Cloud :

    • Devi aggiornare il browser per consentire alla console Trusted Cloud di aggiornare il nome della VM.

  • Nomi host:

    • I nomi host vengono modificati su Linux quando cambi il nome dell'istanza. Su Windows, il nome host non viene aggiornato, anche dopo il riavvio dell'istanza.

    • 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:

    • Non puoi rinominare le istanze che fanno parte di un gruppo di istanze gestite o non gestite.

  • Convenzioni di denominazione:

  • Stati 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

  • Rivedi e, se applicabile, aggiorna quanto segue:
    • Gruppi, grafici e avvisi di Cloud Monitoring: Monitoring corrisponde alle stringhe e, quando rinomini una VM, queste stringhe non vengono aggiornate. 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 ne modifica l'URL della console. Se rinomini una VM, devi aggiornare i link, ad esempio i preferiti del browser che fanno riferimento all'URL della console della VM.
    • Associazioni di ruoli condizionali IAM (Identity and Access Management): 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. Questi binding non vengono aggiornati 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 questi binding.
    • Cache del servizio DNS interno: il servizio DNS interno assegna nomi DNS interni alle VM, in cui il nome host ha il formato HOSTNAME.c.PROJECT_ID.internal per il DNS globale e HOSTNAME.ZONE.c.PROJECT_ID.internal per il DNS 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 ulteriori informazioni sui nomi host DNS globali e DNS di zona, vedi Tipi di nomi DNS interni.
    • Query sui metadati: Dopo aver rinominato una VM, il server dei metadati riporta il nuovo nome. Se rinomini una VM, aggiorna tutti gli script o i programmi che eseguono query sul server dei metadati in modo che eseguano query sul nuovo nome della VM.
    • Criteri dell'organizzazione che limitano gli indirizzi IP esterni: i vincoli per le VM che hanno un riferimento all'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 esterni 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 saperne di più, vedi Rinominare un computer che ospita un'istanza autonoma di SQL Server.
  • Se non l'hai ancora fatto, configura l'autenticazione. L'autenticazione è il processo di verifica dell'identità per poter accedere a Trusted Cloud by S3NS servizi e API. 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 Trusted Cloud console to access Trusted Cloud by S3NS services and APIs, you don't need to set up authentication.

    gcloud

    1. Installa Google Cloud CLI, quindi accedi a gcloud CLI con la tua identità federata. Dopo aver eseguito l'accesso, inizializza Google Cloud CLI eseguendo il seguente comando: 

      gcloud init
    2. Set a default region and zone.

    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.

      Installa Google Cloud CLI, quindi accedi a gcloud CLI con la tua identità federata. Dopo aver eseguito l'accesso, inizializza Google Cloud CLI eseguendo il seguente comando: 

      gcloud init

    Per saperne di più, consulta Autenticarsi per l'utilizzo di REST nella documentazione sull'autenticazione di Trusted Cloud .

Ruoli obbligatori

Per ottenere l'autorizzazione necessaria per rinominare una VM, chiedi all'amministratore di concederti il ruolo IAM Compute Instance Admin (v1) (roles/compute.instanceAdmin.v1) nel progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestisci 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.

Rinomina una VM

Puoi rinominare solo le VM arrestate nello stato TERMINATED.

Console

Per rinominare una VM:

  1. Nella console Trusted 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 ancora fatto, fai clic su Arresta per arrestare la VM. Se non è presente l'opzione Arresta, fai clic su Altre azioni > Arresta.

  4. Fai clic su Modifica.

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

  6. Fai clic su Salva.

    Il completamento della ridenominazione della VM può richiedere fino a un minuto. Se, dopo aver rinominato la VM, ricevi un errore che Trusted Cloud non riesce a trovare la VM, aggiorna il browser.

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

gcloud

Per rinominare una VM:

  1. Se non l'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 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.

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

  3. Se necessario, riavvia la VM.

Passaggi successivi