Ce document explique comment afficher les licences associées à une instance de machine virtuelle (VM), ajouter des licences à une VM et afficher l'historique des mises à jour des licences. Pour en savoir plus sur les licences dans Compute Engine, consultez la section À propos des licences.
Avant de commencer
-
Si ce n'est pas déjà fait, configurez l'authentification.
L'authentification est le processus permettant de valider votre identité pour accéder aux services et aux API Google Cloud.
Pour exécuter du code ou des exemples depuis un environnement de développement local, vous pouvez vous authentifier auprès de Compute Engine comme suit :
Sélectionnez l'onglet correspondant à la façon dont vous prévoyez d'utiliser les exemples de cette page :
Console
Lorsque vous utilisez la console Google Cloud pour accéder aux services et aux API Google Cloud, vous n'avez pas besoin de configurer l'authentification.
gcloud
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- Définissez une région et une zone par défaut.
REST
Pour utiliser les exemples d'API REST de cette page dans un environnement de développement local, vous devez utiliser les identifiants que vous fournissez à gcloud CLI.
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
-
Afficher les licences associées à une VM
Pour afficher les licences associées à une VM, utilisez la console Google Cloud, gcloud CLI ou l'API Compute Engine.
Console
Dans la console Google Cloud, accédez à la page Instances de VM.
Cliquez sur le nom de la VM pour laquelle vous souhaitez vérifier la licence. La page Détails de l'instance s'affiche.
Au bas de la page Détails de l'instance, cliquez sur REST équivalent.
Affichez le champ
licenses
pour le disque de démarrage.
gcloud
Exécutez la commande
gcloud compute instances describe
suivante :gcloud compute instances describe VM_NAME
Remplacez
VM_NAME
par le nom de votre VM.Consultez la section
disks
du résultat. Le champlicenses
contient les licences associées au disque de démarrage.
REST
Appelez la méthode
instances.get
v1 suivante :GET https://compute.googleapis.com/compute/v1/projects/PROJECT/zones/ZONE/instances/VM_NAME
Remplacez les éléments suivants :
PROJECT
: nom du projet.ZONE
: zone contenant la VMVM_NAME
: nom de la VM
L'API Compute Engine renvoie les licences associées au disque de démarrage dans la section
disks
du champlicenses
.
Afficher les licences utilisateur associées à une VM
Pour afficher les licences utilisateur associées à une VM, utilisez la console Google Cloud, gcloud CLI ou l'API Compute Engine.
Console
Dans la console Google Cloud, accédez à la page Instances de VM.
Cliquez sur le nom de la VM pour laquelle vous souhaitez vérifier les licences utilisateur. La page Détails de l'instance s'affiche.
Au bas de la page Détails de l'instance, cliquez sur REST équivalent.
Affichez le champ
userLicenses
pour le disque de démarrage.
gcloud
Exécutez la commande
gcloud beta compute instances describe
suivante :gcloud beta compute instances describe VM_NAME
Remplacez
VM_NAME
par le nom de votre VM.Consultez la section
disks
du résultat. Le champlicenses
contient les licences associées au disque de démarrage.
REST
Appelez la méthode bêta
instances.get
suivante :GET https://compute.googleapis.com/compute/beta/projects/PROJECT/zones/ZONE/instances/VM_NAME
Remplacez les éléments suivants :
PROJECT
: nom du projet.ZONE
: zone contenant la VMVM_NAME
: nom de la VM
L'API Compute Engine renvoie les licences associées au disque de démarrage dans la section
disks
du champlicenses
.
Ajouter une licence lors de l'importation d'une image
Pour ajouter une licence lorsque vous importez une image, utilisez la commande gcloud compute
images import
suivante.
gcloud compute images import IMAGE_NAME \ --source-file=SOURCE_FILE --os=OS
Remplacez les éléments suivants :
IMAGE_NAME
: nom de l'image à créer.SOURCE_FILE
: fichier local ou URI Cloud Storage du disque virtuel à importer.OS
: OS de l'image disque à importer. La licence de l'OS est déduite de la valeur de cette option. Il n'y a pas d'option explicite pour fournir des informations de licence lors de l'importation. Pour obtenir la liste des valeurs acceptées, consultez la section Option--os
.
Pour plus d'informations sur l'importation d'images, consultez la page Importer des disques virtuels.
Ajouter des licences lors de la création d'une image
Pour ajouter des licences lors de la création d'une image, utilisez la commande gcloud compute
images create
suivante.
gcloud compute images create IMAGE_NAME \ --source-image=SOURCE_IMAGE \ --licenses=LICENSES
Remplacez les éléments suivants :
IMAGE_NAME
: nom de l'image à créerSOURCE_IMAGE
: nom de l'image à partir de laquelle vous souhaitez créer l'imageLICENSES
: liste de chaînes de licence séparées par des virgules Exemples :"license1"
,"license2"
.
Pour en savoir plus sur la création d'images, consultez les pages Créer, supprimer et rendre obsolètes des images personnalisées et Créer une image Windows.
Ajouter des licences et des licences utilisateur lors de la création d'une image
Pour ajouter des licences et des licences utilisateur lors de la création d'une image, utilisez la commande gcloud beta compute images create
suivante.
gcloud beta compute images create IMAGE_NAME \ --source-image=SOURCE_IMAGE \ --licenses=LICENSES \ --user-licenses=USER_LICENSES
Remplacez les éléments suivants :
IMAGE_NAME
: nom de l'image à créerSOURCE_IMAGE
: nom de l'image à partir de laquelle vous souhaitez créer l'imageLICENSES
: liste de chaînes de licence séparées par des virgules Exemples :"license1"
,"license2"
.USER_LICENSES
: liste de chaînes de licence utilisateur séparées par des virgules Exemples :"userlicense1"
,"userlicense2"
.
Pour en savoir plus sur la création d'images, consultez les pages Créer, supprimer et rendre obsolètes des images personnalisées et Créer une image Windows.
Ajouter et valider une licence utilisateur
Pour ajouter et valider une licence utilisateur, procédez comme suit :
Répertoriez les disques associés à la VM à l'aide de la commande
gcloud compute instances describe
suivante :gcloud compute instances describe VM_NAME --format="yaml(disks)"
Vérifiez que la sortie ressemble à ce qui suit :
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
Dans la sortie de l'étape précédente, recherchez le nom du disque de démarrage. Pour le disque de démarrage, la valeur de
boot
esttrue
et le nom du disque de démarrage est la valeur dedeviceName
.Ajoutez une licence utilisateur au disque de démarrage à l'aide de la commande
gcloud beta compute disks update
:gcloud beta compute disks update BOOT_DISK_NAME \ --update-user-licenses=LICENSE_URIS
Remplacez les éléments suivants :
BOOT_DISK_NAME
: nom du disque de démarrage auquel ajouter la licenceLICENSE_URIS
: liste des chaînes de licence séparés par une virgule, qui remplace toutes les licences utilisateur existantes
Obtenez des informations sur le disque de démarrage à l'aide de la commande
gcloud beta compute disks describe
suivante :gcloud beta compute disks describe BOOT_DISK_NAME
Remplacez
BOOT_DISK_NAME
par le nom du disque de démarrage pour vérifier la licence ajoutée.Vérifiez que la sortie ressemble à ce qui suit :
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
Vérifiez que la licence utilisateur est ajoutée au disque de démarrage en vérifiant la sortie de l'étape précédente du champ
userLicenses
pour la chaîne de licence appropriée.Si le champ
userLicenses
ne contient pas les chaînes de licence prévues, vous devrez peut-être effacer, puis mettre à jour la liste des chaînes de licence. Pour ce faire, utilisez la commandegcloud beta compute disks update
.
Afficher l'historique des mises à jour des licences
Pour afficher l'historique des mises à jour des licences des VM d'un projet, procédez comme suit :
Dans Google Cloud Console, accédez à la page Activité.
Dans le volet Filtres, sous Catégories, sélectionnez Configuration pour Types d'activités.
Dans le volet Filtres sous Catégories, sélectionnez Disque pour Type de ressource.
Étape suivante
Apprenez-en plus sur les licences Microsoft sur Compute Engine.
Apprenez-en plus sur les systèmes d'exploitation premium :