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 è il processo mediante il quale la tua identità viene verificata per l'accesso a servizi e API. 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:
When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- 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 ulteriori informazioni, consulta Eseguire l'autenticazione per l'utilizzo di REST nella documentazione Google Cloud sull'autenticazione.
-
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.
Nella console Google Cloud, vai alla pagina Istanze VM.
Fai clic sul nome della VM di cui controllare la licenza. Viene visualizzata la pagina Dettagli dell'istanza.
Nella parte inferiore della pagina Dettagli istanza, fai clic su Codice equivalente.
Visualizza il campo
licenses
per il disco di avvio.
Esegui il seguente
gcloud compute instances describe
comando:gcloud compute instances describe
VM_NAME Sostituisci
VM_NAME
con il nome della VM.Visualizza la sezione
disks
dell'output. Il campolicenses
mostra le licenze associate al disco di avvio.
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 progettoZONE
: la zona contenente la VMVM_NAME
: il nome della VM
L'API Compute Engine restituisce le licenze associate al disco di avvio nella sezione
disks
del campolicenses
.
Visualizzare le licenze utente 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 utente associate a una VM, utilizza la console Google Cloud, gcloud CLI o l'API Compute Engine.
Nella console Google Cloud, vai alla pagina Istanze VM.
Fai clic sul nome della VM di cui controllare le licenze utente. Viene visualizzata la pagina Dettagli dell'istanza.
Nella parte inferiore della pagina Dettagli istanza, fai clic su Codice equivalente.
Visualizza il campo
userLicenses
per il disco di avvio.
Esegui il seguente
gcloud beta compute instances describe
comando:gcloud beta compute instances describe
VM_NAME Sostituisci
VM_NAME
con il nome della VM.Visualizza la sezione
disks
dell'output. Il campolicenses
mostra le licenze associate al disco di avvio.
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 progettoZONE
: la zona contenente la VMVM_NAME
: il nome della VM
L'API Compute Engine restituisce le licenze associate al disco di avvio nella sezione
disks
del campolicenses
.
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 importIMAGE_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 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 createIMAGE_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
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 createIMAGE_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 di Windows.
Aggiungere e convalidare una licenza utente
Autorizzazioni richieste per questa attività
Per eseguire questa attività, devi disporre delle seguenti autorizzazioni:
-
compute.disks.update
ecompute.disks.get
sul disco di avvio
Per aggiungere e convalidare una licenza utente:
Elenca i dischi associati alla VM utilizzando il
gcloud compute instances describe
comando:gcloud compute instances describe
VM_NAME --format="yaml(disks)"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: PERSISTENTNell'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 dideviceName
.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 licenzaLICENSE_URIS
: un elenco separato da virgole di stringhe di licenza, che sostituisce tutte le licenze utente esistenti
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.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 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 comandogcloud beta compute disks update
.
Visualizzare la cronologia degli aggiornamenti delle licenze
Visualizza la cronologia degli aggiornamenti delle licenze per le VM in un progetto utilizzando la seguente procedura:
Nella console Google Cloud, vai alla pagina Attività.
Nel riquadro Filtri in Categorie, per Tipi di attività, seleziona Configurazione.
Nel riquadro Filtri in Categorie, per Tipo di risorsa, seleziona Disco.
Passaggi successivi
Scopri di più sui sistemi operativi premium: