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 le changement de licence
Seules certaines licences d'OS peuvent être ajoutées, supprimées ou remplacées. Les modifications de licence sont acceptées pour Red Hat Enterprise Linux (RHEL), RHEL pour SAP, SUSE Linux Enterprise Server (SLES), SLES pour SAP, Ubuntu et Ubuntu Pro.
Les modifications de licence autorisées sont déterminées par le propriétaire de la licence et peuvent être modifiées. Pour valider les modifications de licence autorisées pour votre VM, consultez Examiner les modifications et les restrictions de licence.
Pour passer des licences RHEL ou SLES du paiement à l'usage (PAYG) à l'utilisation de votre propre abonnement (BYOS), consultez Passer de PAYG à BYOS et inversement.
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 valide 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 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 Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
gcloud
-
Installez la Google Cloud CLI. Une fois que la Google Cloud CLI est installée, initialisez-la en exécutant la commande suivante :
gcloud init
Si vous utilisez un fournisseur d'identité (IdP) externe, vous devez d'abord vous connecter à la gcloud CLI avec votre identité fédérée.
- Set a default region and zone.
REST
Pour utiliser les exemples API REST de cette page dans un environnement de développement local, vous devez utiliser les identifiants que vous fournissez à la gcloud CLI.
Installez la Google Cloud CLI. Une fois que la Google Cloud CLI est installée, initialisez-la en exécutant la commande suivante :
gcloud init
Si vous utilisez un fournisseur d'identité (IdP) externe, vous devez d'abord vous connecter à la gcloud CLI avec votre identité fédérée.
Pour en savoir plus, consultez la section S'authentifier pour utiliser REST dans la documentation sur l'authentification Google 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, commencez par arrêter l'instance ou dissocier 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 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 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, indiquez un champ de licence vide dans la requête d'appel, ainsi que 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 Google 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/09/10 (UTC).
-