Visualiza y adjunta licencias

Linux Windows

---

En este documento, se muestra cómo ver las licencias asociadas a una instancia de máquina virtual (VM), agregar licencias a una VM 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.

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 API 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. Install the Google Cloud CLI, then initialize it by running the following command:

     gcloud init

     Note: If you installed the gcloud CLI previously, make sure you have the latest version by running gcloud components update.
  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 la CLI de gcloud.

  Install the Google Cloud CLI, then initialize it by running the following command:

  gcloud init

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

Visualiza las licencias asociadas a una VM

Permisos necesarios para esta tarea

Para realizar esta tarea, debes tener los siguientes permisos:

• compute.instances.get

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

Console

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 cuya licencia verificarás. 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. Ve el campo licenses del disco de arranque.

gcloud

1. Ejecuta el siguiente comando gcloud compute instances describe:

   gcloud compute instances describe VM_NAME
   

   Reemplaza VM_NAME por el nombre de tu VM.

2. Visualiza la sección disks del resultado. En el campo licenses, se muestran las licencias asociadas con el disco de arranque.

REST

1. Realiza una llamada al siguiente método instances.get v1:

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

   Reemplaza lo siguiente:

   • PROJECT: el nombre del proyecto
   • ZONE: la zona que contiene la VM
   • VM_NAME: El nombre de la VM

2. La API de Compute Engine muestra las licencias asociadas con el disco de arranque en la sección disks del campo licenses.

Ve las licencias de usuario asociadas con una VM

Vista previa

Esta función está sujeta a las "Condiciones de las Ofertas de Fase Previa a la DG" de la sección Condiciones Generales del Servicio de las Condiciones Específicas del Servicio. Las funciones de fase previa a la DG están disponibles “tal cual” y podrían tener asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

Permisos necesarios para esta tarea

Para realizar esta tarea, debes tener los siguientes permisos:

• compute.instances.get

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

Console

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 que deseas verificar las licencias de usuario. 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. Ve el campo userLicenses del disco de arranque.

gcloud

1. Ejecuta el siguiente comando gcloud beta compute instances describe:

   gcloud beta compute instances describe VM_NAME
   

   Reemplaza VM_NAME por el nombre de tu VM.

2. Visualiza la sección disks del resultado. En el campo licenses, se muestran las licencias asociadas con el disco de arranque.

REST

1. Llama al siguiente método beta instances.get:

   GET https://compute.googleapis.com/compute/beta/projects/PROJECT/zones/ZONE/instances/VM_NAME
   

   Reemplaza lo siguiente:

   • PROJECT: el nombre del proyecto
   • ZONE: la zona que contiene la VM
   • VM_NAME: El nombre de la VM

2. La API de Compute Engine muestra las licencias asociadas con el disco de arranque en la sección disks del campo licenses.

Agrega una licencia cuando importes una imagen

Para agregar una licencia cuando importas una 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 strings 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.

Agrega licencias y licencias de usuario cuando creas una imagen

Vista previa

Esta función está sujeta a las "Condiciones de las Ofertas de Fase Previa a la DG" de la sección Condiciones Generales del Servicio de las Condiciones Específicas del Servicio. Las funciones de fase previa a la DG están disponibles “tal cual” y podrían tener asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

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

gcloud beta compute images create IMAGE_NAME \
  --source-image=SOURCE_IMAGE \
  --licenses=LICENSES \
  --user-licenses=USER_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 strings de licencia. Por ejemplo, "license1", "license2".
• USER_LICENSES: Es una lista separada por comas de strings de licencia de usuario. Por ejemplo, "userlicense1", "userlicense2".

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 y valida una licencia de usuario

Vista previa

Esta función está sujeta a las "Condiciones de las Ofertas de Fase Previa a la DG" de la sección Condiciones Generales del Servicio de las Condiciones Específicas del Servicio. Las funciones de fase previa a la DG están disponibles “tal cual” y podrían tener asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

Permisos necesarios para esta tarea

Para realizar esta tarea, debes tener los siguientes permisos:

• compute.disks.update y compute.disks.get en el disco de arranque

Para agregar y validar una licencia de usuario, haz lo siguiente:

1. Detén la VM.

2. Enumera los discos asociados con la VM mediante el comando gcloud compute instances describe:

   gcloud compute instances describe VM_NAME --format="yaml(disks)"
   

3. Verifica que el resultado sea similar al siguiente:

   disks:
   - autoDelete: true
     boot: true
     deviceName: BOOT_DISK_NAME
     diskSizeGb: '20'
     guestOsFeatures:
     - type: UEFI_COMPATIBLE
     index: 0
     interface: SCSI
     kind: compute#attachedDisk
     licenses:
     - BOOT_DISK_LICENSE_STRING
     mode: READ_WRITE
     source: https://www.googleapis.com/compute/v1/projects/PROJECT_NAME/zones/ZONE/disks/BOOT_DISK_NAME
     type: PERSISTENT
   

4. En el resultado del paso anterior, busca el nombre del disco de arranque. Para el disco de arranque, el valor de boot es true, y el nombre del disco de arranque es el valor de deviceName.

5. Agrega una licencia de usuario al disco de arranque mediante el comando gcloud beta compute disks update:

   gcloud beta compute disks update BOOT_DISK_NAME \
      --update-user-licenses=LICENSE_URIS
   

   Reemplaza lo siguiente:

   • BOOT_DISK_NAME: Es el nombre del disco de arranque al que se agregará la licencia.

   • LICENSE_URIS: Es una lista separada por comas de strings de licencia que reemplaza todas las licencias de usuario existentes.

6. Obtén información sobre el disco de arranque mediante el comando gcloud beta compute disks describe:

   gcloud beta compute disks describe BOOT_DISK_NAME
   

   Reemplaza BOOT_DISK_NAME por el nombre del disco de arranque para verificar la licencia agregada.

7. Verifica que el resultado sea similar al siguiente:

   creationTimestamp: '2021-05-05T15:26:27.835-07:00'
   guestOsFeatures:
   - type: UEFI_COMPATIBLE
   id: '727854272460268924'
   interface: SCSI
   kind: compute#disk
   labelFingerprint: 42WmSpB8rSM=
   lastAttachTimestamp: '2021-05-05T15:26:27.836-07:00'
   licenseCodes:
   - '1000006'
   - '6213885950785916969'
   licenses:
   - BOOT_DISK_LICENSE_STRING
   multiWriter: false
   name: VM_NAME
   physicalBlockSizeBytes: '4096'
   selfLink: https://www.googleapis.com/compute/beta/projects/PROJECT_NAME/zones/ZONE/disks/DISK_NAME
   selfLinkWithId: https://www.googleapis.com/compute/beta/projects/PROJECT_NAME/zones/ZONE/disks/727854272460268924
   sizeGb: '20'
   sourceImage: https://www.googleapis.com/compute/beta/projects/IMAGE_PROJECT/global/images/IMAGE
   sourceImageId: '7397991294075835597'
   status: READY
   type: https://www.googleapis.com/compute/beta/projects/PROJECT_NAME/zones/ZONE/diskTypes/pd-standard
   userLicenses:
   - LICENSE_URI
   users:
   - https://www.googleapis.com/compute/beta/projects/PROJECT_NAME/zones/ZONE/instances/VM_NAME
   zone: https://www.googleapis.com/compute/beta/projects/PROJECT_NAME/zones/ZONE
   

8. Valida que la licencia de usuario se agregue al disco de arranque mediante la verificación del resultado del paso anterior para el campo userLicenses en busca de la string de licencia adecuada.

   Si el campo userLicenses no contiene las strings de licencia previstas, es posible que debas borrar y actualizar la lista de strings de licencia. Puedes hacerlo mediante el comando gcloud beta compute disks update.

9. Inicia la VM.

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 consola de Google Cloud, ve a la página Actividad.

   Ir a la Actividad

2. En el panel Filtros, en Categorías, para Tipos de actividad, selecciona Configuración.

3. En el panel Filtros, en Categorías, para Tipo de recurso, selecciona Disco.

¿Qué sigue?

• Soluciona problemas de licencias

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

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

  • Consulta las Preguntas frecuentes de RHEL

  • Consulta las Preguntas frecuentes de SLES

  • Consulta las Preguntas frecuentes de Ubuntu Pro