Administrar licencias

En este documento, se explica cómo administrar las licencias asociadas a una instancia de Compute Engine. Esto incluye cómo agregar, quitar, reemplazar y ver el historial de actualizaciones de licencias. Para obtener más información sobre las licencias en Compute Engine, consulta Acerca de las licencias.

Restricciones para administrar licencias:

• Solo puedes agregar una licencia a un disco si AppendableToDisk es true.
• Solo puedes quitar (sin proporcionar reemplazo) si RemovableFromDisk es true.
• Solo puedes reemplazar una licencia por uno de los reemplazos que se indican en AllowedReplacementLicenses.

En el caso de Ubuntu LTS, para actualizar tu licencia a Ubuntu Pro y habilitar el Mantenimiento de seguridad extendido (ESM), consulta Actualiza de Ubuntu a Ubuntu Pro.

Para actualizar tu licencia de RHEL bajo demanda y que incluya asistencia extendida, consulta Cómo agregar el complemento de asistencia durante ciclo de vida extendido (ELS) de RHEL a tu licencia.

Antes de comenzar

• Si aún no lo hiciste, configura la autenticación. La autenticación es el proceso mediante el cual se verifica tu identidad para acceder a los servicios y las APIs de Trusted Cloud by S3NS . 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 Trusted Cloud console to access Trusted Cloud by S3NS services and APIs, you don't need to set up authentication.

  gcloud

  1. Instala Google Cloud CLI y, luego, accede a gcloud CLI con tu identidad federada. Después de acceder, inicializa Google Cloud CLI ejecutando el siguiente comando:

     gcloud init

  2. Set a default region and zone.

  REST

  Para usar las muestras de la API de REST en esta página en un entorno de desarrollo local, debes usar las credenciales que proporcionas a gcloud CLI.

  Instala Google Cloud CLI y, luego, accede a gcloud CLI con tu identidad federada. Después de acceder, inicializa Google Cloud CLI ejecutando el siguiente comando:

  gcloud init

  Si deseas obtener más información, consulta Autentica para usar REST en la Trusted Cloud documentación de autenticación.

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.

Visualiza las licencias asociadas a una VM

Para ver las licencias asociadas a una VM, usa la Trusted Cloud consola, gcloud CLI o la API de Compute Engine.

GET https://compute.googleapis.com/compute/v1/projects/PROJECT/zones/ZONE/instancesVM_NAME

Agrega una licencia durante la importación de una imagen

Para agregar una licencia durante el proceso de importación de la imagen, usa el siguiente comando gcloud compute images import.

gcloud compute images import IMAGE_NAME \
  --source-file=SOURCE_FILE
  --os=OS

Reemplaza lo siguiente:

• IMAGE_NAME: Es el nombre de la imagen que se creará.
• SOURCE_FILE: Es un archivo local o un URI de Cloud Storage del disco virtual que se importará.
• OS: Es el SO de la imagen de disco que se importará. La licencia para el SO se infiere del valor de esta marca. No hay una marca explícita para proporcionar información de licencia cuando se importa. Para obtener una lista de los valores admitidos, consulta Marca --os.

Para obtener más información sobre la importación de imágenes, consulta Importa discos virtuales.

Agrega licencias cuando crees una imagen

Para agregar licencias cuando creas una imagen, usa el siguiente comando gcloud compute images create.

gcloud compute images create IMAGE_NAME \
  --source-image=SOURCE_IMAGE \
  --licenses=LICENSES

Reemplaza lo siguiente:

• IMAGE_NAME: Es el nombre de la imagen que se creará.
• SOURCE_IMAGE: Es el nombre de la imagen a partir de la cual se creará la imagen nueva.
• LICENSES: Es una lista separada por comas de cadenas de licencia. Por ejemplo: "license1", "license2".

Para obtener más información sobre la creación de imágenes, consulta Crea, borra y da de baja imágenes personalizadas y Crea una imagen de Windows.

Para obtener más información sobre la creación de imágenes, consulta Crea, borra y da de baja imágenes personalizadas y Crea una imagen de Windows.

Agrega licencias a un disco

Para agregar licencias asociadas a una VM, usa gcloud CLI o la API de Compute Engine.

gcloud compute disks update DISK_NAME \
--append-licenses=LICENSES

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

Reemplazar licencias en un disco

Para reemplazar las licencias asociadas a una VM, usa gcloud CLI o la API de Compute Engine.

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

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

Cómo quitar licencias de un disco

Para quitar licencias individuales asociadas a una VM, usa gcloud CLI y la API de Compute Engine.

gcloud compute disks update DISK_NAME \
--remove-licenses=LICENSES

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT/zones/ZONE/disks/DISK_NAME?paths=licenses --data '{"name":"DISK_NAME", "licenses":[]}'

Ve el historial de actualizaciones de licencias

Ve el historial de actualizaciones de licencias para las VM de un proyecto mediante el siguiente procedimiento:

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

   Ir al Explorador de registros

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

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. Reemplaza PROJECT_NAME por el nombre del proyecto.

5. Haz clic en Ejecutar consulta.

¿Qué sigue?

• Soluciona problemas de licencias

• Obtén más información sobre las licencias de Microsoft en Compute Engine.

• Revisa los cambios y las restricciones de la licencia

• Obtén más información sobre los sistemas operativos premium:

  • Consulta las Preguntas frecuentes de RHEL

  • Consulta las Preguntas frecuentes de Ubuntu Pro