Ce document explique comment gérer les licences associées à une instance Compute Engine. Cela inclut l'ajout, la suppression et le remplacement de licences, ainsi que l'affichage de l'historique des mises à jour des licences. Pour en savoir plus sur les licences dans Compute Engine, consultez À propos des licences.
Restrictions concernant la gestion des licences :
- Vous ne pouvez ajouter une licence à un disque que si
AppendableToDisk
est défini surtrue
. - Vous ne pouvez supprimer (sans remplacement) que si
RemovableFromDisk
esttrue
. - Vous ne pouvez remplacer une licence que par l'une des licences de remplacement listées dans
AllowedReplacementLicenses
.
Pour Ubuntu LTS, afin de passer à Ubuntu Pro et d'activer la maintenance de sécurité étendue (ESM), consultez Passer d'Ubuntu à Ubuntu Pro.
Pour mettre à jour votre licence RHEL à la demande afin d'inclure l'assistance étendue, consultez Ajouter le module complémentaire RHEL Extended Lifecycle Support (ELS) à votre licence.
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 Trusted Cloud by S3NS .
Pour exécuter du code ou des exemples depuis un environnement de développement local, vous pouvez vous authentifier auprès de Compute Engine en sélectionnant l'une des options suivantes :
Select the tab for how you plan to use the samples on this page:
Console
When you use the Trusted Cloud console to access Trusted Cloud by S3NS services and APIs, you don't need to set up authentication.
gcloud
-
Installez la Google Cloud CLI, puis connectez-vous à la gcloud CLI avec votre identité fédérée. Après vous être connecté, initialisez Google Cloud CLI en exécutant la commande suivante :
gcloud init
- 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.
Installez la Google Cloud CLI, puis connectez-vous à la gcloud CLI avec votre identité fédérée. Après vous être connecté, initialisez Google Cloud CLI en exécutant la commande suivante :
gcloud init
Pour en savoir plus, consultez la section S'authentifier pour utiliser REST dans la documentation sur l'authentification Trusted Cloud .
Préparer la mise à jour de la licence d'un disque
Pour mettre à jour la licence du disque lorsqu'il est associé à une instance en cours d'exécution, arrêtez d'abord l'instance ou dissociez le disque.
- Arrêtez l'instance. Arrête temporairement l'instance avant de mettre à jour la licence du disque.
- Dissociez le disque. Cela dissocie le disque de l'instance avant de mettre à jour la licence du disque.
Afficher les licences associées à une VM
Pour afficher les licences associées à une VM, utilisez la console Trusted Cloud , gcloud CLI ou l'API Compute Engine.
Console
Dans la console Trusted 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 Code é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 :GET https://compute.googleapis.com/compute/v1/projects/PROJECT/zones/ZONE/instancesVM_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 lors de l'importation d'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 en savoir plus sur l'importation d'images, consultez 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 Exemple :"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.
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 à un disque
Pour ajouter des licences associées à une VM, utilisez gcloud CLI ou l'API Compute Engine.
gcloud
Pour ajouter des licences à un disque à l'aide d'une référence ou d'un code de licence, utilisez la commande
gcloud compute disks update
suivante.gcloud compute disks update DISK_NAME \ --append-licenses=LICENSES
Remplacez les éléments suivants :
DISK_NAME
: nom du disque à ajouter.LICENSES
: liste de références de licence séparées par une virgule, par exemple"projects/rhel-cloud/global/licenses/rhel-9-server"
,"projects/rhel-cloud/global/licenses/rhel-8-server"
.
REST
Pour ajouter des licences à un disque à l'aide d'une référence ou d'un code de licence, appelez la méthode
disks.update
v1 suivante :PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT/zones/ZONE/disks/DISK_NAME?paths=licenses --data '{"name":"DISK_NAME", "licenses":["https://www.googleapis.com/compute/v1/LICENSES"]}'
Remplacez les éléments suivants :
PROJECT
: nom du projet.ZONE
: zone contenant la VMDISK_NAME
: le nom du disqueLICENSES
: liste de références de licence séparées par une virgule, par exemple"projects/rhel-cloud/global/licenses/rhel-9-server"
,"projects/rhel-cloud/global/licenses/rhel-8-server"
.
Remplacer des licences sur un disque
Pour remplacer les licences associées à une VM, utilisez gcloud CLI ou l'API Compute Engine.
gcloud
Pour remplacer une licence sur un disque à l'aide d'une référence ou d'un code de licence, utilisez la commande
gcloud compute disks update
suivante.gcloud compute disks update DISK_NAME \ --replace-license=PREVIOUS_LICENSE,NEW_LICENSE
Remplacez les éléments suivants :
DISK_NAME
: nom du disque à ajouter.PREVIOUS_LICENSE
: référence de licence précédente remplacée, par exemple"projects/rhel-cloud/global/licenses/rhel-9-server"
,"projects/rhel-cloud/global/licenses/rhel-8-server"
.NEW_LICENSE
: nouvelle référence de licence, par exemple"projects/rhel-cloud/global/licenses/rhel-9-server"
,"projects/rhel-cloud/global/licenses/rhel-8-server"
.
REST
Pour remplacer une licence sur un disque à l'aide d'une référence ou d'un code de licence, appelez la méthode
disks.update
v1 et remplacez l'ancienne licence par la nouvelle dans le corps de la requête comme suit :PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT/zones/ZONE/disks/DISK_NAME?paths=licenses --data '{"name":"DISK_NAME", "licenses":["https://www.googleapis.com/compute/v1/NEW_LICENSE"]}'
Remplacez les éléments suivants :
PROJECT
: nom du projet.ZONE
: zone contenant la VMDISK_NAME
: le nom du disqueNEW_LICENSE
: nouvelle référence de licence, par exemple"projects/rhel-cloud/global/licenses/rhel-9-server"
,"projects/rhel-cloud/global/licenses/rhel-8-server"
.
Supprimer des licences d'un disque
Pour supprimer des licences individuelles associées à une VM, utilisez gcloud CLI et l'API Compute Engine.
gcloud
Pour supprimer des licences d'un disque à l'aide d'une référence ou d'un code de licence, utilisez la commande
gcloud compute disks update
.gcloud compute disks update DISK_NAME \ --remove-licenses=LICENSES
Remplacez les éléments suivants :
DISK_NAME
: nom du disque à supprimer.LICENSES
: liste de références de licence séparées par une virgule, par exemple"projects/rhel-cloud/global/licenses/rhel-9-server"
,"projects/rhel-cloud/global/licenses/rhel-8-server"
.
REST
Pour supprimer une licence, fournissez un champ de licence vide dans la requête d'appel avec le sélecteur de chemin en appelant la méthode v1
disks.update
suivante :PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT/zones/ZONE/disks/DISK_NAME?paths=licenses --data '{"name":"DISK_NAME", "licenses":[]}'
Remplacez les éléments suivants :
PROJECT
: nom du projet.ZONE
: zone contenant la VMDISK_NAME
: le nom du disqueLICENSES
: laissez ce champ vide.
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 la console Trusted Cloud , accédez à la page Explorateur de journaux.
Dans la barre d'outils, vérifiez que l'option Afficher la requête est activée.
Copiez l'expression suivante dans l'éditeur de requête :
resource.type="gce_disk" logName="projects/PROJECT_NAME/logs/cloudaudit.googleapis.com%2Factivity" severity>=NOTICE protoPayload.request.@type="type.googleapis.com/compute.disks.update" protoPayload.request.licenses:*
Remplacez
PROJECT_NAME
par le nom du fichier.Cliquez sur Exécuter la requête.
Étapes suivantes
Apprenez-en plus sur les licences Microsoft sur Compute Engine.
Examiner les modifications et les restrictions concernant les licences
Apprenez-en plus sur les systèmes d'exploitation premium :
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/19 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/08/19 (UTC)."],[],[],null,[]] -