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 empezar
-
Configura la autenticación si aún no lo hiciste.
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 de la siguiente manera.
Selecciona la pestaña para saber cómo planeas usar las muestras en esta página:
Consola
Cuando usas la consola de Google Cloud para acceder a los servicios y las APIs de Google Cloud, no necesitas configurar la autenticación.
gcloud
-
Instala Google Cloud CLI y, luego, inicializa la ejecución del siguiente comando:
gcloud init
- Configura una región y una zona predeterminadas.
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.
Instala Google Cloud CLI y, luego, inicializa la ejecución del siguiente comando:
gcloud init
-
Visualiza las licencias asociadas a una VM
Para ver las licencias asociadas a una VM, usa la consola de Google Cloud, 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 cuya licencia verificarás. Se abrirá la página Detalles de la instancia.
En la parte inferior de la página Detalles de la instancia, haz clic en REST equivalente.
Ve el campo
licenses
del disco de arranque.
gcloud
Ejecuta el siguiente comando
gcloud compute instances describe
:gcloud compute instances describe VM_NAME
Reemplaza
VM_NAME
por el nombre de tu VM.Visualiza la sección
disks
del resultado. En el campolicenses
, se muestran las licencias asociadas con el disco de arranque.
REST
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 proyectoZONE
: la zona que contiene la VMVM_NAME
: El nombre de la VM
La API de Compute Engine muestra las licencias asociadas con el disco de arranque en la sección
disks
del campolicenses
.
Ve las licencias de usuario asociadas con una VM
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.
Consola
En la consola de Google Cloud, ve a la página Instancias de VM.
Haz clic en el nombre de la VM que deseas verificar las licencias de usuario. Se abrirá la página Detalles de la instancia.
En la parte inferior de la página Detalles de la instancia, haz clic en REST equivalente.
Ve el campo
userLicenses
del disco de arranque.
gcloud
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.Visualiza la sección
disks
del resultado. En el campolicenses
, se muestran las licencias asociadas con el disco de arranque.
REST
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 proyectoZONE
: la zona que contiene la VMVM_NAME
: El nombre de la VM
La API de Compute Engine muestra las licencias asociadas con el disco de arranque en la sección
disks
del campolicenses
.
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 cómo crear 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
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 cómo crear 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
Para agregar y validar una licencia de usuario, haz lo siguiente:
Enumera los discos asociados con la VM mediante el comando
gcloud compute instances describe
:gcloud compute instances describe VM_NAME --format="yaml(disks)"
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
En el resultado del paso anterior, busca el nombre del disco de arranque. Para el disco de arranque, el valor de
boot
estrue
, y el nombre del disco de arranque es el valor dedeviceName
.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.
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.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
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 comandogcloud beta compute disks update
.
Ve el historial de actualizaciones de licencias
Ve el historial de actualizaciones de licencias para las VM de un proyecto mediante el siguiente procedimiento:
En la consola de Google Cloud, ve a la página Actividad.
En el panel Filtros, en Categorías, para Tipos de actividad, selecciona Configuración.
En el panel Filtros, en Categorías, para Tipo de recurso, selecciona Disco.
¿Qué sigue?
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: