En este documento se explica cómo gestionar las licencias asociadas a una instancia de Compute Engine. Esto incluye cómo añadir, quitar, sustituir y ver el historial de actualizaciones de licencias. Para obtener más información sobre las licencias en Compute Engine, consulta el artículo Acerca de las licencias.
Restricciones para cambiar licencias
Solo se pueden añadir, quitar o sustituir determinadas licencias de SO. Los cambios de licencia se admiten en Red Hat Enterprise Linux (RHEL), RHEL for SAP, SUSE Linux Enterprise Server (SLES), SLES for SAP, Ubuntu y Ubuntu Pro.
Los cambios de licencia permitidos los determina el propietario de la licencia y pueden cambiar. Para validar los cambios de licencia permitidos en tu máquina virtual, consulta Revisar los cambios y las restricciones de las licencias.
Para cambiar tus licencias de RHEL o SLES entre las opciones de pago por uso (PAYG) y de utiliza tu propia suscripción (BYOS), consulta el artículo Cambiar entre las opciones de pago por uso y utiliza tu propia suscripción.
Si tienes Ubuntu LTS, puedes actualizar tu licencia a Ubuntu Pro para habilitar el mantenimiento de seguridad ampliado (ESM). Para ello, consulta el artículo Actualizar de Ubuntu a Ubuntu Pro.
Para actualizar tu licencia de RHEL bajo demanda e incluir la asistencia ampliada, consulta el artículo Añadir el complemento Extended Lifecycle Support (ELS) de RHEL a tu licencia.
Antes de empezar
-
Si aún no lo has hecho, configura la autenticación.
La autenticación verifica tu identidad para acceder a Google Cloud servicios y APIs. Para ejecutar código o ejemplos 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
-
Instala Google Cloud CLI. Después de la instalación, inicializa la CLI de Google Cloud ejecutando el siguiente comando:
gcloud init
Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.
- Set a default region and zone.
REST
Para usar las muestras de la API REST de esta página en un entorno de desarrollo local, debes usar las credenciales que proporciones a la CLI de gcloud.
Instala Google Cloud CLI. Después de la instalación, inicializa la CLI de Google Cloud ejecutando el siguiente comando:
gcloud init
Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.
Para obtener más información, consulta el artículo Autenticarse para usar REST de la documentación sobre autenticación de Google Cloud .
Prepararse 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.
- Desvincula el disco. De esta forma, se desconecta el disco de la instancia antes de actualizar la licencia del disco.
Ver las licencias asociadas a una VM
Para ver las licencias asociadas a una VM, usa la Google Cloud consola, la CLI de gcloud o la API de Compute Engine.
Consola
En la consola de Google Cloud , ve a la página Instancias de VM.
Haz clic en el nombre de la VM para comprobar su licencia. Se abrirá la página Detalles de la instancia.
En la parte inferior de la página Detalles de la instancia, haz clic en Código equivalente.
Consulta el campo
licenses
del disco de arranque.
gcloud
Ejecuta el siguiente
gcloud compute instances describe
comando:gcloud compute instances describe VM_NAME
Sustituye
VM_NAME
por el nombre de tu VM.Consulta la sección
disks
del resultado. El campolicenses
muestra las licencias asociadas al disco de arranque.
REST
Llama al método v1
instances.get
:GET https://compute.googleapis.com/compute/v1/projects/PROJECT/zones/ZONE/instancesVM_NAME
Haz los cambios siguientes:
PROJECT
: el nombre del proyectoZONE
: la zona que contiene la VMVM_NAME
: el nombre de la VM
La API Compute Engine devuelve las licencias asociadas al disco de arranque en la sección
disks
del campolicenses
.Añadir una licencia durante la importación de una imagen
Para añadir una licencia durante el proceso de importación de imágenes, usa el siguiente comando
gcloud compute images import
.gcloud compute images import IMAGE_NAME \ --source-file=SOURCE_FILE --os=OS
Haz los cambios siguientes:
IMAGE_NAME
: el nombre de la imagen que se va a crear.SOURCE_FILE
: un archivo local o un URI de Cloud Storage del disco virtual que se va a importar.OS
: el SO de la imagen de disco que se va a importar. La licencia del SO se deduce del valor de esta marca. No hay una marca explícita para proporcionar información sobre la licencia al importar. Para ver una lista de los valores admitidos, consulta la marca--os
.
Para obtener más información sobre cómo importar imágenes, consulta Importar discos virtuales.
Añadir licencias al crear una imagen
Para añadir licencias al crear una imagen, usa el siguiente
gcloud compute images create
comando.gcloud compute images create IMAGE_NAME \ --source-image=SOURCE_IMAGE \ --licenses=LICENSES
Haz los cambios siguientes:
IMAGE_NAME
: el nombre de la imagen que se va a crear.SOURCE_IMAGE
: el nombre de la imagen a partir de la que se creará la nueva imagen.LICENSES
: una lista separada por comas de cadenas de licencia. Por ejemplo,"license1"
,"license2"
.
Para obtener más información sobre cómo crear imágenes, consulta los artículos Crear, eliminar y desactivar imágenes personalizadas y Crear una imagen de Windows.
Para obtener más información sobre cómo crear imágenes, consulta Crear, eliminar y desactivar imágenes personalizadas y Crear una imagen de Windows.
Añadir licencias a un disco
Para añadir licencias asociadas a una VM, usa la CLI de gcloud o la API de Compute Engine.
gcloud
Para añadir licencias a un disco mediante una referencia o un código de licencia, usa el siguiente comando
gcloud compute disks update
.gcloud compute disks update DISK_NAME \ --append-licenses=LICENSES
Haz los cambios siguientes:
DISK_NAME
: el nombre del disco que se va a añadir.LICENSES
: una lista de referencias de licencias separadas por comas. Por ejemplo,"projects/rhel-cloud/global/licenses/rhel-9-server"
,"projects/rhel-cloud/global/licenses/rhel-8-server"
.
REST
Para añadir licencias a un disco mediante una referencia o un código de licencia, llama 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/LICENSES"]}'
Haz los cambios siguientes:
PROJECT
: el nombre del proyectoZONE
: la zona que contiene la VMDISK_NAME
: el nombre del discoLICENSES
: una lista de referencias de licencia separadas por comas. Por ejemplo,"projects/rhel-cloud/global/licenses/rhel-9-server"
,"projects/rhel-cloud/global/licenses/rhel-8-server"
.
Sustituir licencias en un disco
Para sustituir las licencias asociadas a una VM, usa la CLI de gcloud o la API de Compute Engine.
gcloud
Para sustituir una licencia en un disco mediante una referencia o un código de licencia, utiliza el siguiente comando
gcloud compute disks update
.gcloud compute disks update DISK_NAME \ --replace-license=PREVIOUS_LICENSE,NEW_LICENSE
Haz los cambios siguientes:
DISK_NAME
: el nombre del disco que se va a añadir.PREVIOUS_LICENSE
: la referencia de licencia anterior que se va a sustituir, por ejemplo,"projects/rhel-cloud/global/licenses/rhel-9-server"
o"projects/rhel-cloud/global/licenses/rhel-8-server"
.NEW_LICENSE
: la nueva referencia de licencia, por ejemplo,"projects/rhel-cloud/global/licenses/rhel-9-server"
o"projects/rhel-cloud/global/licenses/rhel-8-server"
.
REST
Para sustituir una licencia en un disco mediante una referencia o un código de licencia, llama al método
disks.update
v1 y sustituye la licencia anterior por la nueva en el cuerpo de la solicitud de la siguiente manera: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"]}'
Haz los cambios siguientes:
PROJECT
: el nombre del proyectoZONE
: la zona que contiene la VMDISK_NAME
: el nombre del discoNEW_LICENSE
: la nueva referencia de licencia, por ejemplo,"projects/rhel-cloud/global/licenses/rhel-9-server"
o"projects/rhel-cloud/global/licenses/rhel-8-server"
.
Retirar licencias de un disco
Para quitar licencias individuales asociadas a una VM, usa la CLI de gcloud y la API de Compute Engine.
gcloud
Para quitar licencias de un disco mediante una referencia o un código de licencia, usa el comando
gcloud compute disks update
.gcloud compute disks update DISK_NAME \ --remove-licenses=LICENSES
Haz los cambios siguientes:
DISK_NAME
: el nombre del disco que se va a quitar.LICENSES
: una lista de referencias de licencias separadas por comas. Por ejemplo,"projects/rhel-cloud/global/licenses/rhel-9-server"
,"projects/rhel-cloud/global/licenses/rhel-8-server"
.
REST
Para quitar una licencia, proporciona un campo de licencia vacío en la solicitud de llamada junto con el selector de ruta llamando 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":[]}'
Haz los cambios siguientes:
PROJECT
: el nombre del proyectoZONE
: la zona que contiene la VMDISK_NAME
: el nombre del discoLICENSES
: deja este campo en blanco.
Ver el historial de actualizaciones de licencias
Para ver el historial de actualizaciones de licencias de las VMs de un proyecto, sigue este procedimiento:
En la Google Cloud consola, ve a la página Explorador de registros.
En la barra de herramientas, comprueba que la opción Mostrar consulta esté habilitada.
Copia la siguiente expresión en el editor de consultas:
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:*
Sustituye
PROJECT_NAME
por el nombre del proyecto.Haz clic en Realizar una consulta.
Siguientes pasos
Información sobre las licencias de Microsoft en Compute Engine
Consulta más información sobre los sistemas operativos premium:
A menos que se indique lo contrario, el contenido de esta página está sujeto a la licencia Reconocimiento 4.0 de Creative Commons y las muestras de código están sujetas a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio web de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-09-10 (UTC).
-