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
-
Installa Google Cloud CLI, quindi initialize eseguendo questo comando:
gcloud init
- 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
Nella console Google Cloud, vai alla pagina Istanze VM.
Fai clic sul nome della VM di cui vuoi verificare la licenza. Viene visualizzata la pagina Dettagli istanza.
Nella parte inferiore della pagina Dettagli istanza, fai clic su REST equivalente.
Visualizza il campo
licenses
per il disco di avvio.
gcloud
Esegui questo comando
gcloud compute instances describe
:gcloud compute instances describe VM_NAME
Sostituisci
VM_NAME
con il nome della tua VM.Visualizza la sezione
disks
dell'output. Il campolicenses
mostra le licenze associate al disco di avvio.
REST
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
Per visualizzare le licenze utente associate a una VM, utilizza la console Google Cloud, gcloud CLI o l'API Compute Engine.
Console
Nella console Google Cloud, vai alla pagina Istanze VM.
Fai clic sul nome della VM di cui vuoi controllare le licenze utente. Viene visualizzata la pagina Dettagli istanza.
Nella parte inferiore della pagina Dettagli istanza, fai clic su REST equivalente.
Visualizza il campo
userLicenses
per il disco di avvio.
gcloud
Esegui questo comando
gcloud beta compute instances describe
:gcloud beta compute instances describe VM_NAME
Sostituisci
VM_NAME
con il nome della tua VM.Visualizza la sezione
disks
dell'output. Il campolicenses
mostra le licenze associate al disco di avvio.
REST
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
.
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:
Elenca i dischi associati alla VM utilizzando il comando
gcloud compute instances describe
: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: PERSISTENT
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 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
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.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 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 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, in 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: