Actualiza las licencias después de una actualización del SO

En esta página, se explica cómo actualizar las cadenas de licencias en tus instancias de máquina virtual (VM) después de realizar una actualización local del sistema operativo (SO). Este proceso se aplica a los siguientes sistemas operativos:

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

Para obtener detalles sobre las referencias y los códigos de licencias, consulta Cambios y restricciones de licencias.

Antes de comenzar

  • Si aún no lo hiciste, configura la autenticación. La autenticación verifica tu identidad para acceder a los servicios y las APIs de Google Cloud . Para ejecutar código o muestras desde un entorno de desarrollo local, puedes autenticarte en Compute Engine seleccionando una de las siguientes opciones:

    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. Instala Google Cloud CLI. Después de la instalación, inicializa Google Cloud CLI con el siguiente comando: 

      gcloud init

      Si usas un proveedor de identidad externo (IdP), primero debes acceder a la gcloud CLI con tu identidad federada.

    2. Set a default region and zone.

Prepárate para actualizar la licencia de un disco

Para actualizar la licencia del disco mientras está conectado a una instancia en ejecución, primero detén la instancia o desconecta el disco.

  • Detén la instancia. Apaga temporalmente la instancia antes de actualizar la licencia del disco.
  • Desconecta el disco. Esto separa el disco de la instancia antes de actualizar la licencia del disco.

Actualiza la licencia en el disco

Para actualizar la licencia en un disco, usa Google Cloud CLI o la API de Compute Engine. Este proceso reemplaza el URI de licencia existente por el nuevo que corresponde a la versión actualizada del SO.

gcloud

Para reemplazar la licencia de un disco por una referencia de licencia nueva, usa el comando gcloud compute disks update:

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

Reemplaza lo siguiente:

  • DISK_NAME: Es el nombre del disco que se actualizará.
  • PREVIOUS_LICENSE: Es la referencia de licencia requerida para la versión anterior del SO, por ejemplo, "windows-server-2022-dc" o "rhel-9".
  • NEW_LICENSE: Es la referencia de licencia requerida para la nueva versión del SO, por ejemplo, "windows-server-2025-dc" o "rhel-10".

REST

Para reemplazar la licencia de un disco, agrega la nueva licencia al cuerpo de la solicitud y omite la anterior. Realiza una llamada al siguiente método disks.update v1:

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"]}'

Reemplaza lo siguiente:

  • PROJECT: el nombre del proyecto.
  • ZONE: Es la zona que contiene el disco.
  • DISK_NAME: el nombre del disco.
  • NEW_LICENSE: Es la referencia de la licencia nueva, por ejemplo, "windows-server-2025-dc" o "rhel-10".

Valida el cambio de licencia

Para validar que se cambió la licencia en el disco de arranque, usa el siguiente procedimiento:

  1. Para obtener información sobre el disco de arranque, ejecuta el comando gcloud compute disks describe:

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

    Reemplaza lo siguiente:

    • DISK_NAME: Es el nombre del disco de arranque en el que se validará la licencia.
    • ZONE: Es la zona que contiene el disco de arranque para validar la licencia.

  2. Verifica que el resultado sea similar al siguiente:

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