Visualizar e anexar licenças, Visualizar e anexar licenças

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Este documento mostra como visualizar as licenças associadas a uma instância de máquina virtual (VM), anexar licenças a uma VM e visualizar o histórico de atualizações de licença. Para mais informações sobre licenças no Compute Engine, consulte Sobre licenças .

Antes de começar

• Se ainda não o fez, configure a autenticação. Autenticação é o processo pelo qual sua identidade é verificada para acesso a Google Cloud serviços e APIs. Para executar códigos ou amostras em um ambiente de desenvolvimento local, você pode se autenticar no Compute Engine selecionando uma das seguintes opções:
  

  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.

  REST

  Para usar as amostras da API REST nesta página em um ambiente de desenvolvimento local, use as credenciais fornecidas para gcloud CLI.

  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 mais informações, consulte Autenticar para usar REST na documentação de autenticação do Google Cloud.

Veja as licenças associadas a uma VM

Para visualizar as licenças associadas a uma VM, use o console do Google Cloud, a CLI gcloud ou a API Compute Engine.

Ver as licenças de usuário associadas a uma VM

Para visualizar as licenças de usuário associadas a uma VM, use o console do Google Cloud, a CLI gcloud ou a API Compute Engine.

Anexar uma licença ao importar uma imagem

Para anexar uma licença ao importar uma imagem, use o seguinte comando gcloud compute images import .

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

Substitua o seguinte:

• IMAGE_NAME : o nome da imagem a ser criada.
• SOURCE_FILE : um arquivo local ou URI do Cloud Storage do disco virtual a ser importado.
• OS : o sistema operacional da imagem de disco a ser importada. A licença do SO é inferida do valor deste sinalizador; não há um sinalizador explícito para fornecer informações de licença durante a importação. Para obter uma lista dos valores suportados, consulte --os flag .

Para obter mais informações sobre a importação de imagens, consulte Importando discos virtuais .

Anexar licenças ao criar uma imagem

Para anexar licenças ao criar uma imagem, use o comando gcloud compute images create a seguir.

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

Substitua o seguinte:

• IMAGE_NAME : o nome da imagem a ser criada.
• SOURCE_IMAGE : o nome da imagem a partir da qual criar a nova imagem.
• LICENSES : uma lista separada por vírgulas de sequências de licenças . Por exemplo, "license1" , "license2" .

Para obter mais informações sobre a criação de imagens, consulte Criando, excluindo e descontinuando imagens personalizadas e Criando uma imagem do Windows .

Anexar licenças e licenças de usuário ao criar uma imagem

Para anexar licenças e licenças de usuário ao criar uma imagem, use o seguinte comando gcloud beta compute images create .

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

Substitua o seguinte:

• IMAGE_NAME : o nome da imagem a ser criada.
• SOURCE_IMAGE : o nome da imagem a partir da qual criar a nova imagem.
• LICENSES : uma lista separada por vírgulas de sequências de licenças . Por exemplo, "license1" , "license2" .
• USER_LICENSES : uma lista separada por vírgulas de strings de licença de usuário . Por exemplo, "userlicense1" , "userlicense2" .

Para obter mais informações sobre a criação de imagens, consulte Criando, excluindo e descontinuando imagens personalizadas e Criando uma imagem do Windows .

Anexar e validar uma licença de usuário

Para anexar e validar uma licença de usuário, faça o seguinte:

1. Pare a VM .

2. Liste os discos associados à VM usando o comando gcloud compute instances describe :

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

3. Verifique se a saída é semelhante à seguinte:

   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. Na saída da etapa anterior, encontre o nome do disco de inicialização. Para o disco de inicialização, o valor de boot é true e o nome do disco de inicialização é o valor de deviceName .

5. Anexe uma licença de usuário ao disco de inicialização usando o comando gcloud beta compute disks update :

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

   Substitua o seguinte:

   • BOOT_DISK_NAME : o nome do disco de inicialização ao qual anexar a licença

   • LICENSE_URIS : uma lista separada por vírgulas de sequências de licenças , que substitui todas as licenças de usuário existentes

6. Obtenha informações sobre o disco de inicialização usando o comando gcloud beta compute disks describe :

   gcloud beta compute disks describe BOOT_DISK_NAME
   

   Substitua BOOT_DISK_NAME pelo nome do disco de inicialização para verificar a licença anexada.

7. Verifique se a saída é semelhante à seguinte:

   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 se a licença do usuário está anexada ao disco de inicialização verificando a saída da etapa anterior no campo userLicenses para obter a sequência de licença apropriada.

   Se o campo userLicenses não contiver as sequências de licença pretendidas, talvez seja necessário limpar e atualizar a lista de sequências de licença. Você pode fazer isso usando o comando gcloud beta compute disks update .

9. Inicie a VM .

Veja o histórico de atualizações de licença

Visualize o histórico de atualizações de licença para VMs em um projeto usando o seguinte procedimento:

1. No console do Google Cloud, acesse a página Atividade .

   Vá para a atividade

2. No painel Filtros em Categorias , para Tipos de atividade, selecione Configuração .

3. No painel Filtros em Categorias , para o Tipo de recurso selecione Disco .

O que vem a seguir

• Solucionar problemas de licenças

• Saiba mais sobre as licenças da Microsoft no Compute Engine

• Saiba mais sobre sistemas operacionais premium:

  • Consulte as perguntas frequentes do RHEL

  • Consulte as perguntas frequentes do SLES

  • Consulte as perguntas frequentes do Ubuntu Pro

Este documento mostra como visualizar as licenças associadas a uma instância de máquina virtual (VM), anexar licenças a uma VM e visualizar o histórico de atualizações de licença. Para mais informações sobre licenças no Compute Engine, consulte Sobre licenças .

Antes de começar

• Se ainda não o fez, configure a autenticação. Autenticação é o processo pelo qual sua identidade é verificada para acesso a Google Cloud serviços e APIs. Para executar códigos ou amostras em um ambiente de desenvolvimento local, você pode se autenticar no Compute Engine selecionando uma das seguintes opções:
  

  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.

  REST

  Para usar as amostras da API REST nesta página em um ambiente de desenvolvimento local, use as credenciais fornecidas para gcloud CLI.

  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 mais informações, consulte Autenticar para usar REST na documentação de autenticação do Google Cloud.

Veja as licenças associadas a uma VM

Para visualizar as licenças associadas a uma VM, use o console do Google Cloud, a CLI gcloud ou a API Compute Engine.

Ver as licenças de usuário associadas a uma VM

Para visualizar as licenças de usuário associadas a uma VM, use o console do Google Cloud, a CLI gcloud ou a API Compute Engine.

Anexar uma licença ao importar uma imagem

Para anexar uma licença ao importar uma imagem, use o seguinte comando gcloud compute images import .

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

Substitua o seguinte:

• IMAGE_NAME : o nome da imagem a ser criada.
• SOURCE_FILE : um arquivo local ou URI do Cloud Storage do disco virtual a ser importado.
• OS : o sistema operacional da imagem de disco a ser importada. A licença do SO é inferida do valor deste sinalizador; não há um sinalizador explícito para fornecer informações de licença durante a importação. Para obter uma lista dos valores suportados, consulte --os flag .

Para obter mais informações sobre a importação de imagens, consulte Importando discos virtuais .

Anexar licenças ao criar uma imagem

Para anexar licenças ao criar uma imagem, use o comando gcloud compute images create a seguir.

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

Substitua o seguinte:

• IMAGE_NAME : o nome da imagem a ser criada.
• SOURCE_IMAGE : o nome da imagem a partir da qual criar a nova imagem.
• LICENSES : uma lista separada por vírgulas de sequências de licenças . Por exemplo, "license1" , "license2" .

Para obter mais informações sobre a criação de imagens, consulte Criando, excluindo e descontinuando imagens personalizadas e Criando uma imagem do Windows .

Anexar licenças e licenças de usuário ao criar uma imagem

Para anexar licenças e licenças de usuário ao criar uma imagem, use o seguinte comando gcloud beta compute images create .

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

Substitua o seguinte:

• IMAGE_NAME : o nome da imagem a ser criada.
• SOURCE_IMAGE : o nome da imagem a partir da qual criar a nova imagem.
• LICENSES : uma lista separada por vírgulas de sequências de licenças . Por exemplo, "license1" , "license2" .
• USER_LICENSES : uma lista separada por vírgulas de strings de licença de usuário . Por exemplo, "userlicense1" , "userlicense2" .

Para obter mais informações sobre a criação de imagens, consulte Criando, excluindo e descontinuando imagens personalizadas e Criando uma imagem do Windows .

Anexar e validar uma licença de usuário

Para anexar e validar uma licença de usuário, faça o seguinte:

1. Pare a VM .

2. Liste os discos associados à VM usando o comando gcloud compute instances describe :

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

3. Verifique se a saída é semelhante à seguinte:

   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. Na saída da etapa anterior, encontre o nome do disco de inicialização. Para o disco de inicialização, o valor de boot é true e o nome do disco de inicialização é o valor de deviceName .

5. Anexe uma licença de usuário ao disco de inicialização usando o comando gcloud beta compute disks update :

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

   Substitua o seguinte:

   • BOOT_DISK_NAME : o nome do disco de inicialização ao qual anexar a licença

   • LICENSE_URIS : uma lista separada por vírgulas de sequências de licenças , que substitui todas as licenças de usuário existentes

6. Obtenha informações sobre o disco de inicialização usando o comando gcloud beta compute disks describe :

   gcloud beta compute disks describe BOOT_DISK_NAME
   

   Substitua BOOT_DISK_NAME pelo nome do disco de inicialização para verificar a licença anexada.

7. Verifique se a saída é semelhante à seguinte:

   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 se a licença do usuário está anexada ao disco de inicialização verificando a saída da etapa anterior no campo userLicenses para obter a sequência de licença apropriada.

   Se o campo userLicenses não contiver as sequências de licença pretendidas, talvez seja necessário limpar e atualizar a lista de sequências de licença. Você pode fazer isso usando o comando gcloud beta compute disks update .

9. Inicie a VM .

Veja o histórico de atualizações de licença

Visualize o histórico de atualizações de licença para VMs em um projeto usando o seguinte procedimento:

1. No console do Google Cloud, acesse a página Atividade .

   Vá para a atividade

2. No painel Filtros em Categorias , para Tipos de atividade, selecione Configuração .

3. No painel Filtros em Categorias , para o Tipo de recurso selecione Disco .

O que vem a seguir

• Solucionar problemas de licenças

• Saiba mais sobre as licenças da Microsoft no Compute Engine

• Saiba mais sobre sistemas operacionais premium:

  • Consulte as perguntas frequentes do RHEL

  • Consulte as perguntas frequentes do SLES

  • Consulte as perguntas frequentes do Ubuntu Pro