Visualizza e aggiungi licenze

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 di Compute Engine, consulta Informazioni sulle licenze.

Prima di iniziare

• Se non l'hai ancora fatto, configura l'autenticazione. L'autenticazione è il processo mediante il quale la tua identità viene verificata per l'accesso a servizi e API di Trusted Cloud by S3NS . 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. Install the Google Cloud CLI, and then sign in to the gcloud CLI with your federated identity. After signing in, initialize the Google Cloud CLI by running the following command:

     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.

  Install the Google Cloud CLI, and then sign in to the gcloud CLI with your federated identity. After signing in, initialize the Google Cloud CLI by running the following command:

  gcloud init

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

Visualizza le licenze associate a una VM

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

Visualizza le licenze utente associate a una VM

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

Aggiungi 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 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 ulteriori informazioni sulla creazione di immagini, consulta Creazione, eliminazione e deprecazione di immagini personalizzate e Creazione di un'immagine Windows.

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

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

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 quella nuova.
• 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 Creazione, eliminazione e deprecazione di immagini personalizzate e Creazione di un'immagine Windows.

Aggiungi e convalida una licenza utente

Per aggiungere e convalidare una licenza utente, segui questi passaggi:

1. Arresta la VM.

2. Genera un elenco dei dischi associati alla VM utilizzando il comando gcloud compute instances describe:

   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. Trova il nome del disco di avvio nell'output del passaggio precedente. Per il disco di avvio, il valore di boot è true, mentre 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, usa 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 che la licenza aggiunta sia presente.

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 stata aggiunta al disco di avvio controllando il campo userLicenses della stringa della licenza appropriata nell'output del passaggio precedente.

   Se il campo userLicenses non contiene la stringa della licenza prevista, potrebbe essere necessario eliminare e aggiornare l'elenco delle stringhe di licenza. A questo scopo, utilizza il comando gcloud beta compute disks update.

9. Avvia la VM.

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 Trusted Cloud , vai alla pagina Esplora log.

   Vai a Esplora log

2. Nella barra degli strumenti, assicurati 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.userLicenses:*
   

4. Fai clic su Esegui query.

Passaggi successivi

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