Afficher et ajouter des licences


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

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

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

  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

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

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

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