Ver y agregar licencias


Este documento le muestra cómo ver las licencias asociadas con 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 has hecho, configura la autenticación. La autenticación es el proceso mediante el cual se verifica su identidad para acceder a Google Cloud servicios y API. 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. After installing the Google Cloud CLI, initialize it by running the following command:

      gcloud init

      If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

    2. Set a default region and zone.
    3. 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.

        After installing the Google Cloud CLI, initialize it by running the following command:

        gcloud init

        If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

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

Ver las licencias asociadas con una VM

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

Consola

  1. En la consola de Google Cloud, vaya a la página de instancias de VM .

    Ir a instancias de VM

  2. Haga clic en el nombre de la VM para verificar la licencia. Se abre la página de detalles de la instancia .

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

  4. Vea el campo licenses para el disco de arranque.

nube de gcloud

  1. Ejecute el siguiente comando gcloud compute instances describe :

    gcloud compute instances describe VM_NAME
    

    Reemplace VM_NAME con el nombre de su VM.

  2. Vea la sección disks de la salida. El campo licenses muestra las licencias asociadas con el disco de arranque.

DESCANSAR

  1. Llame al siguiente método instances.get v1 :

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

    Reemplace 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 devuelve las licencias asociadas con el disco de arranque en la sección disks del campo licenses .

Ver las licencias de usuario asociadas con una VM

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

Consola

  1. En la consola de Google Cloud, vaya a la página de instancias de VM .

    Ir a instancias de VM

  2. Haga clic en el nombre de la VM para verificar las licencias de usuario. Se abre la página de detalles de la instancia .

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

  4. Vea el campo userLicenses para el disco de arranque.

nube de gcloud

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

    gcloud beta compute instances describe VM_NAME
    

    Reemplace VM_NAME con el nombre de su VM.

  2. Vea la sección disks de la salida. El campo licenses muestra las licencias asociadas con el disco de arranque.

DESCANSAR

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

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

    Reemplace 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 devuelve las licencias asociadas con el disco de arranque en la sección disks del campo licenses .

Agregar una licencia al importar una imagen

Para agregar una licencia al importar una imagen, usa el siguiente comando gcloud compute images import .

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

Reemplace lo siguiente:

  • IMAGE_NAME : el nombre de la imagen a crear.
  • SOURCE_FILE : un archivo local o URI de Cloud Storage del disco virtual que se va a importar.
  • OS : el sistema operativo de la imagen del disco a importar. La licencia del sistema operativo se deduce del valor de esta bandera; no hay un indicador explícito para proporcionar información de licencia al importar. Para obtener una lista de los valores admitidos, consulte --os flag .

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

Agregar licencias al crear una imagen

Para agregar licencias al crear una imagen, usa el siguiente comando gcloud compute images create .

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

Reemplace lo siguiente:

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

Para obtener más información sobre la creación de imágenes, consulte Creación, eliminación y desaprobación de imágenes personalizadas y Creación de una imagen de Windows .

Agregar licencias y licencias de usuario al crear una imagen

Para agregar licencias y licencias de usuario al crear 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

Reemplace lo siguiente:

  • IMAGE_NAME : el nombre de la imagen a crear.
  • SOURCE_IMAGE : el nombre de la imagen a partir de la cual crear la nueva imagen.
  • LICENSES : una lista de cadenas de licencia separadas por comas. Por ejemplo, "license1" , "license2" .
  • USER_LICENSES : una lista de cadenas de licencias de usuario separadas por comas. Por ejemplo, "userlicense1" , "userlicense2" .

Para obtener más información sobre la creación de imágenes, consulte Creación, eliminación y desaprobación de imágenes personalizadas y Creación de una imagen de Windows .

Adjuntar y validar una licencia de usuario

Para adjuntar y validar una licencia de usuario, haga lo siguiente:

  1. Detenga la máquina virtual .

  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. Verifique 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, busque 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
    

    Reemplace lo siguiente:

    • BOOT_DISK_NAME : el nombre del disco de arranque al que agregar la licencia

    • LICENSE_URIS : una lista de cadenas de licencia separadas por comas, 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
    

    Reemplace BOOT_DISK_NAME con el nombre del disco de arranque para verificar la licencia adjunta.

  7. Verifique 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. Valide que la licencia de usuario esté adjunta al disco de inicio verificando el resultado del paso anterior para el campo userLicenses para obtener la cadena de licencia adecuada.

    Si el campo userLicenses no contiene las cadenas de licencia deseadas, es posible que deba borrar y luego actualizar la lista de cadenas de licencia. Puedes hacer esto usando el comando gcloud beta compute disks update .

  9. Inicie la máquina virtual .

Ver el historial de actualizaciones de licencias

Vea el historial de actualizaciones de licencias para máquinas virtuales en un proyecto mediante el siguiente procedimiento:

  1. En la consola de Google Cloud, vaya a la página Actividad .

    Ir a actividad

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

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

¿Qué sigue?