Afficher et ajouter des licences

Linux Windows

---

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 :
  

  Select the tab for how you plan to use the samples on this page:

  Console

  When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

  gcloud

  1. Install the Google Cloud CLI, then initialize it by running the following command:

     gcloud init

     Note: If you installed the gcloud CLI previously, make sure you have the latest version by running gcloud components update.
  2. Set a default region and zone.

  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

  Pour en savoir plus, consultez la section S'authentifier pour utiliser REST dans la documentation sur l'authentification Google Cloud.

Afficher les licences associées à une VM

Autorisations requises pour cette tâche

Pour effectuer cette tâche, vous devez disposer des autorisations suivantes :

• compute.instances.get

Pour afficher les licences associées à une VM, utilisez la console Google Cloud, gcloud CLI ou l'API Compute Engine.

Console

1. Dans la console Google Cloud, accédez à la page Instances de VM.

   Accéder à la page "Instances de VM"

2. Cliquez sur le nom de la VM pour laquelle vous souhaitez vérifier la licence. La page Détails de l'instance s'affiche.

3. Au bas de la page Détails de l'instance, cliquez sur REST équivalent.

4. Affichez le champ licenses pour le disque de démarrage.

gcloud

1. Exécutez la commande gcloud compute instances describe suivante :

   gcloud compute instances describe VM_NAME
   

   Remplacez VM_NAME par le nom de votre VM.

2. Consultez la section disks du résultat. Le champ licenses contient les licences associées au disque de démarrage.

REST

1. 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 VM
   • VM_NAME : nom de la VM

2. L'API Compute Engine renvoie les licences associées au disque de démarrage dans la section disks du champ licenses.

Afficher les licences utilisateur associées à une VM

Preview

Cette fonctionnalité est soumise aux "Conditions des offres de pré-DG" dans la section "Conditions d'utilisation générales" des Conditions spécifiques au service. Les fonctionnalités pré-DG sont disponibles "en l'état" et peuvent avoir une assistance limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

Autorisations requises pour cette tâche

Pour effectuer cette tâche, vous devez disposer des autorisations suivantes :

• compute.instances.get

Pour afficher les licences utilisateur associées à une VM, utilisez la console Google Cloud, gcloud CLI ou l'API Compute Engine.

Console

1. Dans la console Google Cloud, accédez à la page Instances de VM.

   Accéder à la page "Instances de VM"

2. 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.

3. Au bas de la page Détails de l'instance, cliquez sur REST équivalent.

4. Affichez le champ userLicenses pour le disque de démarrage.

gcloud

1. 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.

2. Consultez la section disks du résultat. Le champ licenses contient les licences associées au disque de démarrage.

REST

1. 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 VM
   • VM_NAME : nom de la VM

2. L'API Compute Engine renvoie les licences associées au disque de démarrage dans la section disks du champ licenses.

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éer
• SOURCE_IMAGE : nom de l'image à partir de laquelle vous souhaitez créer l'image
• LICENSES : 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

Preview

Cette fonctionnalité est soumise aux "Conditions des offres de pré-DG" dans la section "Conditions d'utilisation générales" des Conditions spécifiques au service. Les fonctionnalités pré-DG sont disponibles "en l'état" et peuvent avoir une assistance limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

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éer
• SOURCE_IMAGE : nom de l'image à partir de laquelle vous souhaitez créer l'image
• LICENSES : 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

Preview

Cette fonctionnalité est soumise aux "Conditions des offres de pré-DG" dans la section "Conditions d'utilisation générales" des Conditions spécifiques au service. Les fonctionnalités pré-DG sont disponibles "en l'état" et peuvent avoir une assistance limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

Autorisations requises pour cette tâche

Pour effectuer cette tâche, vous devez disposer des autorisations suivantes :

• compute.disks.update et compute.disks.get sur le disque de démarrage

Pour ajouter et valider une licence utilisateur, procédez comme suit :

1. Arrêtez la VM.

2. 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)"
   

3. 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
   

4. 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 est true et le nom du disque de démarrage est la valeur de deviceName.

5. 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 licence

   • LICENSE_URIS : liste des chaînes de licence séparés par une virgule, qui remplace toutes les licences utilisateur existantes

6. 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.

7. 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
   

8. 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 commande gcloud beta compute disks update.

9. Démarrez la VM.

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 :

1. Dans Google Cloud Console, accédez à la page Activité.

   Accéder au tableau de bord Activité

2. Dans le volet Filtres, sous Catégories, sélectionnez Configuration pour Types d'activités.

3. Dans le volet Filtres sous Catégories, sélectionnez Disque pour Type de ressource.

Étape suivante

• Résolvez les problèmes de licence.

• Apprenez-en plus sur les licences Microsoft sur Compute Engine.

• Apprenez-en plus sur les systèmes d'exploitation premium :

  • Consultez les questions fréquentes sur RHEL.

  • Consultez les questions fréquentes sur SLES.

  • Consultez les questions fréquentes sur Ubuntu Pro