Visualizzare e aggiungere licenze

Linux Windows

---

Questo documento illustra come visualizzare le licenze associate a un'istanza di una macchina virtuale (VM), aggiungere licenze a una VM e visualizzare la cronologia degli aggiornamenti delle licenze. Per ulteriori informazioni sulle licenze su Compute Engine, consulta Informazioni sulle licenze.

Prima di iniziare

• 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

     Note: If you installed the gcloud CLI previously, make sure you have the latest version by running gcloud components update.
  2. Set a default region and zone.

  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 saperne di più, consulta Eseguire l'autenticazione per l'utilizzo di REST nella documentazione sull'autenticazione di Google Cloud.

Visualizzare le licenze associate a una VM

Autorizzazioni richieste per questa attività

Per eseguire questa attività, devi disporre delle seguenti autorizzazioni:

• compute.instances.get

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 controllare la licenza. Viene visualizzata la pagina Dettagli dell'istanza.

3. Nella parte inferiore della pagina Dettagli istanza, fai clic su Equivalente REST.

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

gcloud

1. Esegui il seguente gcloud compute instances describe comando:

   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

1. Chiama il seguente metodo instances.get v1:

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

   Sostituisci quanto segue:

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

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

Visualizzare le licenze utente associate a una VM

Anteprima

Questa funzionalità è soggetta ai "Termini delle Offerte pre-GA" nella sezione Termini generali del servizio dei Termini specifici dei servizi. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per saperne di più, consulta le descrizioni della fase di lancio.

Autorizzazioni richieste per questa attività

Per eseguire questa attività, devi disporre delle seguenti autorizzazioni:

• compute.instances.get

Per visualizzare le licenze utente 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 controllare le licenze utente. Viene visualizzata la pagina Dettagli dell'istanza.

3. Nella parte inferiore della pagina Dettagli istanza, fai clic su Equivalente REST.

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

gcloud

1. Esegui il seguente gcloud beta compute instances describe comando:

   gcloud beta 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

1. Chiama il seguente metodo beta instances.get:

   GET https://compute.googleapis.com/compute/beta/projects/PROJECT/zones/ZONE/instances/VM_NAME
   

   Sostituisci quanto segue:

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

2. 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 l'importazione di un'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 del disco da importare. La licenza per il sistema operativo viene dedotta dal valore di questo flag; non esiste un flag esplicito per fornire 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.

Aggiungere 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 la nuova immagine.
• LICENSES: un elenco separato da virgole di stringhe di licenza. Ad esempio, "license1", "license2".

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

Appendere licenze e licenze utente durante la creazione di un'immagine

Anteprima

Questa funzionalità è soggetta ai "Termini delle Offerte pre-GA" nella sezione Termini generali del servizio dei Termini specifici dei servizi. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per saperne di più, consulta le descrizioni della fase di lancio.

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

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

Sostituisci quanto segue:

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

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

Aggiungere e convalidare una licenza utente

Anteprima

Questa funzionalità è soggetta ai "Termini delle Offerte pre-GA" nella sezione Termini generali del servizio dei Termini specifici dei servizi. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per saperne di più, consulta le descrizioni della fase di lancio.

Autorizzazioni richieste per questa attività

Per eseguire questa attività, devi disporre delle seguenti autorizzazioni:

• compute.disks.update e compute.disks.get sul disco di avvio

Per aggiungere e convalidare una licenza utente:

1. Arresta la VM.

2. Elenca i dischi associati alla VM utilizzando il gcloud compute instances describe comando:

   gcloud compute instances describe VM_NAME --format="yaml(disks)"
   

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

   disks:
   - autoDelete: true
     boot: true
     deviceName: BOOT_DISK_NAME
     diskSizeGb: '20'
     guestOsFeatures:
     - type: UEFI_COMPATIBLE
     index: 0
     interface: SCSI
     kind: compute#attachedDisk
     licenses:
     - BOOT_DISK_LICENSE_STRING
     mode: READ_WRITE
     source: https://www.googleapis.com/compute/v1/projects/PROJECT_NAME/zones/ZONE/disks/BOOT_DISK_NAME
     type: PERSISTENT
   

4. Nell'output del passaggio precedente, trova il nome del disco di avvio. Per il disco di avvio, il valore di boot è true e il nome del disco di avvio è il valore di deviceName.

5. Aggiungi una licenza utente al disco di avvio utilizzando il comando gcloud beta compute disks update:

   gcloud beta compute disks update BOOT_DISK_NAME \
      --update-user-licenses=LICENSE_URIS
   

   Sostituisci quanto segue:

   • BOOT_DISK_NAME: il nome del disco di avvio a cui aggiungere la licenza

   • LICENSE_URIS: un elenco separato da virgole di stringhe di licenza, che sostituisce tutte le licenze utente esistenti

6. Per informazioni sul disco di avvio, utilizza il comando gcloud beta compute disks describe:

   gcloud beta compute disks describe BOOT_DISK_NAME
   

   Sostituisci BOOT_DISK_NAME con il nome del disco di avvio per verificare la presenza della licenza aggiunta.

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

   creationTimestamp: '2021-05-05T15:26:27.835-07:00'
   guestOsFeatures:
   - type: UEFI_COMPATIBLE
   id: '727854272460268924'
   interface: SCSI
   kind: compute#disk
   labelFingerprint: 42WmSpB8rSM=
   lastAttachTimestamp: '2021-05-05T15:26:27.836-07:00'
   licenseCodes:
   - '1000006'
   - '6213885950785916969'
   licenses:
   - BOOT_DISK_LICENSE_STRING
   multiWriter: false
   name: VM_NAME
   physicalBlockSizeBytes: '4096'
   selfLink: https://www.googleapis.com/compute/beta/projects/PROJECT_NAME/zones/ZONE/disks/DISK_NAME
   selfLinkWithId: https://www.googleapis.com/compute/beta/projects/PROJECT_NAME/zones/ZONE/disks/727854272460268924
   sizeGb: '20'
   sourceImage: https://www.googleapis.com/compute/beta/projects/IMAGE_PROJECT/global/images/IMAGE
   sourceImageId: '7397991294075835597'
   status: READY
   type: https://www.googleapis.com/compute/beta/projects/PROJECT_NAME/zones/ZONE/diskTypes/pd-standard
   userLicenses:
   - LICENSE_URI
   users:
   - https://www.googleapis.com/compute/beta/projects/PROJECT_NAME/zones/ZONE/instances/VM_NAME
   zone: https://www.googleapis.com/compute/beta/projects/PROJECT_NAME/zones/ZONE
   

8. Verifica che la licenza utente sia aggiunta al disco di avvio controllando l'output del passaggio precedente per il campo userLicenses per la stringa di licenza appropriata.

   Se il campo userLicenses non contiene le stringhe di licenza previste, potrebbe essere necessario cancellare e aggiornare l'elenco delle stringhe di licenza. Puoi farlo utilizzando il comando gcloud beta compute disks update.

9. Avvia la VM.

Visualizzare la cronologia degli aggiornamenti delle licenze

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

1. Nella console Google Cloud, vai alla pagina Attività.

   Vai ad Attività

2. Nel riquadro Filtri in Categorie, per Tipi di attività, seleziona Configurazione.

3. Nel riquadro Filtri in Categorie, per Tipo di risorsa, seleziona Disco.

Passaggi successivi

• Risolvere i problemi relativi alle licenze

• Scopri di più sulle licenze Microsoft su Compute Engine

• Scopri di più sui sistemi operativi premium:

  • Consulta le domande frequenti su RHEL

  • Consulta le domande frequenti su SLES

  • Consulta le domande frequenti su Ubuntu Pro