Gestisci le licenze

Questo documento spiega come gestire le licenze associate a un'istanza Compute Engine. Sono incluse le istruzioni su come aggiungere, rimuovere, sostituire e visualizzare la cronologia degli aggiornamenti delle licenze. Per ulteriori informazioni sulle licenze di Compute Engine, consulta Informazioni sulle licenze.

Limitazioni per la modifica delle licenze

Solo alcune licenze del sistema operativo sono idonee per essere aggiunte, rimosse o sostituite. Le modifiche alla licenza sono supportate per Red Hat Enterprise Linux (RHEL), RHEL for SAP, SUSE Linux Enterprise Server (SLES), SLES for SAP, Ubuntu e Ubuntu Pro.

Le modifiche alle licenze consentite sono determinate dal proprietario della licenza e sono soggette a modifica. Per convalidare le modifiche consentite alla licenza per la tua VM, consulta Rivedere le modifiche e le limitazioni della licenza.

Per modificare le licenze RHEL o SLES tra pay-as-you-go (PAYG) e bring-your-own-subscription (BYOS), vedi Passare da PAYG a BYOS e viceversa.

Per Ubuntu LTS, per eseguire l'upgrade della licenza a Ubuntu Pro e attivare la manutenzione della sicurezza estesa (ESM), vedi Esegui l'upgrade da Ubuntu a Ubuntu Pro.

Per aggiornare la licenza RHEL on demand in modo da includere il supporto esteso, vedi Aggiungere il componente aggiuntivo RHEL Extended Lifecycle Support (ELS) alla licenza.

Prima di iniziare

  • Se non l'hai ancora fatto, configura l'autenticazione. L'autenticazione verifica la tua identità per l'accesso a Google Cloud 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 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 seguente comando: 

      gcloud init

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

    2. Set a default region and zone.

    REST

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

      Installa Google Cloud CLI. Dopo l'installazione, inizializza Google Cloud CLI eseguendo il seguente comando: 

      gcloud init

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

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

Prepararsi ad aggiornare la licenza di un disco

Per aggiornare la licenza del disco mentre è collegato a un'istanza in esecuzione, arresta prima 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.

Visualizza le licenze associate a una VM

Per visualizzare le licenze associate a una VM, utilizza la console Google Cloud , gcloud CLI o l'API Compute Engine.

Console

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

    Vai a Istanze VM

  2. Fai clic sul nome della VM di cui desideri verificare la licenza. Viene visualizzata la pagina Dettagli istanza.

  3. Nella parte inferiore della pagina Dettagli istanza, fai clic su Codice equivalente.

  4. Visualizza il campo licenses per il disco di avvio.

gcloud

  1. Esegui questo comando gcloud compute instances describe:

    gcloud compute instances describe VM_NAME

    Sostituisci VM_NAME con il nome della VM.

  2. Visualizza la sezione disks dell'output. Il campo licenses mostra le licenze associate al disco di avvio.

REST

Chiama il metodo instances.get v1:

GET https://compute.googleapis.com/compute/v1/projects/PROJECT/zones/ZONE/instancesVM_NAME

Sostituisci quanto segue:

  • PROJECT: il nome del progetto
  • ZONE: la zona che contiene la VM
  • VM_NAME: il nome della VM

L'API Compute Engine restituisce le licenze associate al disco di avvio nella sezione disks del campo licenses.

Aggiungere una licenza durante l'importazione di un'immagine

Per aggiungere una licenza durante il processo di importazione dell'immagine, utilizza il seguente comando gcloud compute images import.

gcloud compute images import IMAGE_NAME \
  --source-file=SOURCE_FILE
  --os=OS

Sostituisci quanto segue:

  • IMAGE_NAME: il nome dell'immagine da creare.
  • SOURCE_FILE: un file locale o un URI Cloud Storage del disco virtuale da importare.
  • OS: il sistema operativo dell'immagine disco da importare. La licenza per il sistema operativo viene dedotta dal valore di questo flag; non esiste un flag esplicito che fornisca informazioni sulla licenza durante l'importazione. Per un elenco dei valori supportati, consulta il flag --os.

Per saperne di più sull'importazione delle immagini, consulta Importazione di dischi virtuali.

Aggiungi le licenze durante la creazione di un'immagine

Per aggiungere le licenze durante la creazione di un'immagine, utilizza il seguente comando gcloud compute images create.

gcloud compute images create IMAGE_NAME \
  --source-image=SOURCE_IMAGE \
  --licenses=LICENSES

Sostituisci quanto segue:

  • IMAGE_NAME: il nome dell'immagine da creare.
  • SOURCE_IMAGE: il nome dell'immagine da cui creare quella nuova.
  • LICENSES: un elenco separato da virgole di stringhe di licenza. Ad esempio, "license1", "license2".

Per saperne di più sulla creazione di immagini, consulta Creare, eliminare e impostare come obsolete le immagini personalizzate e Creare un'immagine Windows.

Per ulteriori informazioni sulla creazione di immagini, consulta Creare, eliminare e impostare come obsolete le immagini personalizzate e Creare un'immagine Windows.

Aggiungere licenze a un disco

Per aggiungere le licenze associate a una VM, utilizza gcloud CLI o l'API Compute Engine.

gcloud

Per aggiungere licenze a un disco utilizzando un riferimento o un codice di licenza, utilizza il seguente comando gcloud compute disks update.

gcloud compute disks update DISK_NAME \
--append-licenses=LICENSES

Sostituisci quanto segue:

  • DISK_NAME: il nome del disco da aggiungere.
  • LICENSES: un elenco separato da virgole di riferimenti alle licenze, ad esempio "projects/rhel-cloud/global/licenses/rhel-9-server", "projects/rhel-cloud/global/licenses/rhel-8-server".

REST

Per aggiungere licenze a un disco utilizzando un riferimento o un codice di licenza, 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/LICENSES"]}'

Sostituisci quanto segue:

  • PROJECT: il nome del progetto
  • ZONE: la zona che contiene la VM
  • DISK_NAME: il nome del disco.
  • LICENSES: un elenco separato da virgole di riferimenti alle licenze, ad esempio "projects/rhel-cloud/global/licenses/rhel-9-server", "projects/rhel-cloud/global/licenses/rhel-8-server".

Sostituire le licenze su un disco

Per sostituire le licenze associate a una VM, utilizza gcloud CLI o l'API Compute Engine.

gcloud

Per sostituire una licenza su un disco utilizzando un riferimento o un codice di licenza, utilizza il comando gcloud compute disks update riportato di seguito.

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

Sostituisci quanto segue:

  • DISK_NAME: il nome del disco da aggiungere.
  • PREVIOUS_LICENSE: il riferimento alla licenza precedente da sostituire, ad esempio "projects/rhel-cloud/global/licenses/rhel-9-server", "projects/rhel-cloud/global/licenses/rhel-8-server".
  • NEW_LICENSE: il nuovo riferimento alla licenza, ad esempio "projects/rhel-cloud/global/licenses/rhel-9-server", "projects/rhel-cloud/global/licenses/rhel-8-server".

REST

Per sostituire una licenza su un disco utilizzando un riferimento o un codice di licenza, chiama il metodo v1 disks.update e sostituisci la licenza precedente con la nuova nel corpo della richiesta come segue:

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 che contiene la VM
  • DISK_NAME: il nome del disco.
  • NEW_LICENSE: il nuovo riferimento alla licenza, ad esempio "projects/rhel-cloud/global/licenses/rhel-9-server", "projects/rhel-cloud/global/licenses/rhel-8-server".

Rimuovere le licenze da un disco

Per rimuovere le singole licenze associate a una VM, utilizza gcloud CLI e l'API Compute Engine.

gcloud

Per rimuovere le licenze da un disco utilizzando un riferimento o un codice di licenza, utilizza il comando gcloud compute disks update.

gcloud compute disks update DISK_NAME \
--remove-licenses=LICENSES

Sostituisci quanto segue:

  • DISK_NAME: il nome del disco da rimuovere.
  • LICENSES: un elenco separato da virgole di riferimenti alle licenze, ad esempio "projects/rhel-cloud/global/licenses/rhel-9-server", "projects/rhel-cloud/global/licenses/rhel-8-server".

REST

Per rimuovere una licenza, fornisci un campo della licenza vuoto nella richiesta di chiamata insieme al selettore di percorso chiamando 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":[]}'

Sostituisci quanto segue:

  • PROJECT: il nome del progetto
  • ZONE: la zona che contiene la VM
  • DISK_NAME: il nome del disco.
  • LICENSES: lascia vuoto.

Visualizza la cronologia degli aggiornamenti delle licenze

Visualizza la cronologia degli aggiornamenti delle licenze per le VM presenti in un progetto utilizzando la seguente procedura:

  1. Nella console Google Cloud , vai alla pagina Esplora log.

    Vai a Esplora log

  2. Nella barra degli strumenti, verifica che l'opzione Mostra query sia attivata.

  3. Copia la seguente espressione nell'Editor di query:

    resource.type="gce_disk"
logName="projects/PROJECT_NAME/logs/cloudaudit.googleapis.com%2Factivity"
severity>=NOTICE
protoPayload.request.@type="type.googleapis.com/compute.disks.update"
protoPayload.request.licenses:*

  4. Sostituisci PROJECT_NAME con il nome del progetto.

  5. Fai clic su Esegui query.

Passaggi successivi