Visualizza e aggiungi licenze

Questo documento mostra come visualizzare le licenze associate a un'istanza di macchina virtuale (VM), aggiungere licenze a una VM e visualizzare la cronologia degli aggiornamenti delle licenze. Per maggiori informazioni sulle licenze in 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 viene verificata l'identità per l'accesso ai servizi e alle API Google Cloud. Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi autenticarti in Compute Engine nel seguente modo.

    Seleziona la scheda relativa a come prevedi di utilizzare gli esempi in questa pagina:

    Console

    Quando utilizzi la console Google Cloud per accedere ai servizi e alle API di Google Cloud, non devi configurare l'autenticazione.

    gcloud

    1. Installa Google Cloud CLI, quindi initialize eseguendo questo comando:

      gcloud init
    2. Imposta una regione e una zona predefinite.

    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 initialize eseguendo questo comando:

      gcloud init

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 vuoi verificare la licenza. Viene visualizzata la pagina Dettagli istanza.

  3. Nella parte inferiore della pagina Dettagli istanza, fai clic su REST 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 tua 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

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 vuoi controllare le licenze utente. Viene visualizzata la pagina Dettagli istanza.

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

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

gcloud

  1. Esegui questo comando gcloud beta compute instances describe:

    gcloud beta compute instances describe VM_NAME
    

    Sostituisci VM_NAME con il nome della tua 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.

Aggiunta di 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 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 per fornire informazioni sulla licenza durante l'importazione. Per un elenco dei valori supportati, vedi il flag --os.

Per ulteriori informazioni sull'importazione delle immagini, consulta Importazione di dischi virtuali.

Aggiungi licenze durante la creazione di un'immagine

Per aggiungere 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 saperne di più sulla creazione di immagini, consulta gli articoli Creazione, eliminazione e ritiro 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 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 licenze utente. Ad esempio, "userlicense1", "userlicense2".

Per saperne di più sulla creazione di immagini, consulta gli articoli Creazione, eliminazione e ritiro di immagini personalizzate e Creazione di un'immagine Windows.

Aggiungere e convalidare una licenza utente

Per aggiungere e convalidare una licenza utente:

  1. Arresta la VM.

  2. Elenca i 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. Individua il nome del disco di avvio nell'output del passaggio precedente. 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. Ottieni informazioni sul disco di avvio utilizzando 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 venga aggiunta al disco di avvio controllando l'output del passaggio precedente relativo al campo userLicenses per trovare la stringa di licenza appropriata.

    Se il campo userLicenses non contiene le stringhe di licenza previste, potresti dover cancellare e aggiornare l'elenco di 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, in Tipi di attività seleziona Configurazione.

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

Passaggi successivi