Mettre à jour les licences après une mise à niveau de l'OS

Cette page explique comment mettre à jour les chaînes de licence sur vos instances de machine virtuelle (VM) après avoir effectué une mise à niveau sur place du système d'exploitation (OS). Cette procédure s'applique aux systèmes d'exploitation suivants :

  • Red Hat Enterprise Linux (RHEL)
  • RHEL pour SAP
  • SUSE Linux Enterprise Server (SLES)
  • SLES pour SAP
  • Windows Server

Pour en savoir plus sur les références et les codes de licence, consultez Modifications et restrictions de licence.

Avant de commencer

  • Si ce n'est pas déjà fait, configurez l'authentification. L'authentification permet 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 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

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

    2. Set a default region and zone.

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

Mettre à jour la licence du disque

Pour mettre à jour la licence d'un disque, utilisez la Google Cloud CLI ou l'API Compute Engine. Ce processus remplace l'URI de licence existant par le nouvel URI correspondant à la version mise à niveau de votre OS.

gcloud

Pour remplacer la licence d'un disque par une nouvelle référence de licence, utilisez la commande gcloud compute disks update :

gcloud compute disks update DISK_NAME \
    --replace-license=PREVIOUS_LICENSE,NEW_LICENSE

Remplacez les éléments suivants :

  • DISK_NAME : nom du disque à mettre à jour.
  • PREVIOUS_LICENSE : référence de licence requise pour la version précédente de l'OS, par exemple "windows-server-2022-dc" ou "rhel-9".
  • NEW_LICENSE : référence de licence requise pour la nouvelle version de l'OS, par exemple "windows-server-2025-dc" ou "rhel-10".

REST

Pour remplacer la licence d'un disque, ajoutez la nouvelle licence au corps de la requête et omettez l'ancienne 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/NEW_LICENSE"]}'

Remplacez les éléments suivants :

  • PROJECT : nom du projet.
  • ZONE : zone contenant le disque.
  • DISK_NAME : nom du disque.
  • NEW_LICENSE : nouvelle référence de licence, par exemple "windows-server-2025-dc" ou "rhel-10".

Valider le changement de licence

Pour vérifier que votre licence a été modifiée sur le disque de démarrage, procédez comme suit :

  1. Obtenez des informations sur le disque de démarrage en exécutant la commande gcloud compute disks describe :

    gcloud compute disks describe DISK_NAME \
    --zone=ZONE \
    --format="value(licenses)"

    Remplacez les éléments suivants :

    • DISK_NAME : nom du disque de démarrage dont vous souhaitez valider la licence
    • ZONE : zone contenant le disque de démarrage dont vous souhaitez valider la licence

  2. Vérifiez que le résultat ressemble à ce qui suit :

    https://www.googleapis.com/compute/v1/projects/windows-cloud/global/licenses/windows-server-2025-dc