Aggiornare le licenze dopo un upgrade del sistema operativo

Questa pagina spiega come aggiornare le stringhe di licenza sulle istanze di macchine virtuali (VM) dopo aver eseguito un upgrade in loco del sistema operativo (SO). Questa procedura si applica ai seguenti sistemi operativi:

  • Red Hat Enterprise Linux (RHEL)
  • RHEL per SAP
  • SUSE Linux Enterprise Server (SLES)
  • SLES per SAP
  • Windows Server

Per informazioni dettagliate su riferimenti e codici delle licenze, vedi Modifiche e limitazioni delle licenze.

Prima di iniziare

  • Se non l'hai ancora fatto, configura l'autenticazione. L'autenticazione verifica la tua identità per l'accesso ad API e 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. Installa Google Cloud CLI. Dopo l'installazione, inizializza Google Cloud CLI eseguendo il comando seguente: 

      gcloud init

      Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

    2. Set a default region and zone.

Prepararsi ad aggiornare la licenza di un disco

Per aggiornare la licenza del disco mentre è collegato a un'istanza in esecuzione, arresta l'istanza o scollega il disco.

  • Arresta l'istanza. Arresta temporaneamente l'istanza prima di aggiornare la licenza del disco.
  • Scollega il disco. In questo modo il disco viene scollegato dall'istanza prima di aggiornare la licenza del disco.

Aggiorna la licenza sul disco

Per aggiornare la licenza su un disco, utilizza Google Cloud CLI o l'API Compute Engine. Questo processo sostituisce l'URI della licenza esistente con quello nuovo corrispondente alla versione del sistema operativo aggiornata.

gcloud

Per sostituire la licenza di un disco con un nuovo riferimento alla licenza, utilizza il comando gcloud compute disks update:

gcloud compute disks update DISK_NAME \
    --replace-license=PREVIOUS_LICENSE,NEW_LICENSE

Sostituisci quanto segue:

  • DISK_NAME: il nome del disco da aggiornare.
  • PREVIOUS_LICENSE: il riferimento alla licenza richiesto per la versione precedente del sistema operativo, ad esempio "windows-server-2022-dc" o "rhel-9".
  • NEW_LICENSE: il riferimento alla licenza richiesto per la nuova versione del sistema operativo, ad esempio "windows-server-2025-dc" o "rhel-10".

REST

Per sostituire la licenza di un disco, aggiungi la nuova licenza al corpo della richiesta e ometti la licenza precedente. Chiama il seguente metodo disks.update v1:

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT/zones/ZONE/disks/DISK_NAME?paths=licenses --data '{"name":"DISK_NAME", "licenses":["https://www.googleapis.com/compute/v1/NEW_LICENSE"]}'

Sostituisci quanto segue:

  • PROJECT: il nome del progetto.
  • ZONE: la zona contenente il disco.
  • DISK_NAME: il nome del disco.
  • NEW_LICENSE: il nuovo riferimento alla licenza, ad esempio "windows-server-2025-dc" o "rhel-10".

Convalida la modifica della licenza

Per verificare che la licenza sia stata modificata sul disco di avvio, utilizza la seguente procedura:

  1. Per informazioni sul disco di avvio, esegui il comando gcloud compute disks describe:

    gcloud compute disks describe DISK_NAME \
    --zone=ZONE \
    --format="value(licenses)"

    Sostituisci quanto segue:

    • DISK_NAME: il nome del disco di avvio di cui desideri verificare la licenza
    • ZONE: la zona contenente il disco di avvio di cui desideri verificare la licenza

  2. Verifica che l'output sia simile al seguente:

    https://www.googleapis.com/compute/v1/projects/windows-cloud/global/licenses/windows-server-2025-dc