Administrar licencias


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

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

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

  1. En la consola de Google Cloud , ve a la página Instancias de VM.

    Ir a instancias de VM

  2. Haz clic en el nombre de la VM para comprobar su licencia. Se abrirá la página Detalles de la instancia.

  3. En la parte inferior de la página Detalles de la instancia, haz clic en Código equivalente.

  4. Consulta el campo licenses del disco de arranque.

gcloud

  1. Ejecuta el siguiente gcloud compute instances describe comando:

    gcloud compute instances describe VM_NAME
    

    Sustituye VM_NAME por el nombre de tu VM.

  2. Consulta la sección disks del resultado. El campo licenses 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 proyecto
  • ZONE: la zona que contiene la VM
  • VM_NAME: el nombre de la VM

La API Compute Engine devuelve las licencias asociadas al disco de arranque en la sección disks del campo licenses.

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 proyecto
  • ZONE: la zona que contiene la VM
  • DISK_NAME: el nombre del disco
  • LICENSES: 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 proyecto
  • ZONE: la zona que contiene la VM
  • DISK_NAME: el nombre del disco
  • 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".

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 proyecto
  • ZONE: la zona que contiene la VM
  • DISK_NAME: el nombre del disco
  • LICENSES: 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:

  1. En la Google Cloud consola, ve a la página Explorador de registros.

    Ir a Explorador de registros

  2. En la barra de herramientas, comprueba que la opción Mostrar consulta esté habilitada.

  3. 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:*
    
  4. Sustituye PROJECT_NAME por el nombre del proyecto.

  5. Haz clic en Realizar una consulta.

Siguientes pasos