Neste documento, mostramos como visualizar as licenças associadas a uma instância de máquina virtual (VM), anexar licenças a uma VM e ver 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
-
Configure a autenticação, caso ainda não tenha feito isso.
A autenticação é
o processo de verificação da sua identidade para acesso a serviços e APIs do Google Cloud.
Para executar códigos ou amostras de um ambiente de desenvolvimento local, autentique-se no
Compute Engine da seguinte maneira.
Selecione a guia para como planeja usar as amostras nesta página:
Console
Quando você usa o console do Google Cloud para acessar os serviços e as APIs do Google Cloud, não é necessário configurar a autenticação.
gcloud
-
Instale a Google Cloud CLI e inicialize-a executando o seguinte comando:
gcloud init
- Defina uma região e uma zona padrão.
REST
Para usar as amostras da API REST nesta página em um ambiente de desenvolvimento local, use as credenciais fornecidas para a CLI gcloud.
Instale a Google Cloud CLI e inicialize-a executando o seguinte comando:
gcloud init
-
Ver 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.
Console
No console do Google Cloud, acesse a página Instâncias de VMs.
Clique no nome da VM para verificar a licença. A página Detalhes da instância é aberta.
Na parte inferior da página Detalhes da instância, clique em REST equivalente.
Veja o campo
licenses
para o disco de inicialização.
gcloud
Execute o comando
gcloud compute instances describe
:gcloud compute instances describe VM_NAME
Substitua
VM_NAME
pelo nome da VM.Veja a seção
disks
da saída. O campolicenses
mostra as licenças associadas ao disco de inicialização.
REST
Chame o seguinte método
instances.get
v1:GET https://compute.googleapis.com/compute/v1/projects/PROJECT/zones/ZONE/instances/VM_NAME
Substitua:
PROJECT
: o nome do projeto.ZONE
: a zona que contém a VM;VM_NAME
: O nome da VM.
A API Compute Engine retorna as licenças associadas ao disco de inicialização na seção
disks
do campolicenses
.
Visualizar 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.
Console
No console do Google Cloud, acesse a página Instâncias de VMs.
Clique no nome da VM para verificar as licenças de usuário. A página Detalhes da instância é aberta.
Na parte inferior da página Detalhes da instância, clique em REST equivalente.
Veja o campo
userLicenses
para o disco de inicialização.
gcloud
Execute o comando
gcloud beta compute instances describe
:gcloud beta compute instances describe VM_NAME
Substitua
VM_NAME
pelo nome da VM.Veja a seção
disks
da saída. O campolicenses
mostra as licenças associadas ao disco de inicialização.
REST
Chame o método Beta
instances.get
:GET https://compute.googleapis.com/compute/beta/projects/PROJECT/zones/ZONE/instances/VM_NAME
Substitua:
PROJECT
: o nome do projeto.ZONE
: a zona que contém a VM;VM_NAME
: O nome da VM.
A API Compute Engine retorna as licenças associadas ao disco de inicialização na seção
disks
do campolicenses
.
Incluir uma licença ao importar uma imagem
Para incluir 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:
IMAGE_NAME
: o nome da imagem a ser criada.SOURCE_FILE
: um arquivo local ou o URI do Cloud Storage do disco virtual a ser importado.OS
: o SO da imagem de disco a ser importada. A licença do SO é inferida a partir do valor dessa sinalização. Não há uma sinalização explícita para fornecer informações de licença durante a importação. Para uma lista de valores compatíveis, consulte a sinalização--os
.
Para mais informações sobre como importar imagens, consulte Como importar discos virtuais.
Incluir licenças ao criar uma imagem
Para anexar licenças ao criar uma imagem, use o comando gcloud compute
images create
.
gcloud compute images create IMAGE_NAME \ --source-image=SOURCE_IMAGE \ --licenses=LICENSES
Substitua:
IMAGE_NAME
: o nome da imagem a ser criada.SOURCE_IMAGE
: o nome da imagem a partir da qual a nova imagem vai ser criada.LICENSES
: uma lista separada por vírgulas de strings de licença. Por exemplo:,"license1"
,"license2"
.
Para mais informações sobre como criar imagens, consulte Como criar, excluir e suspender o uso de imagens personalizadas e Como criar uma imagem do Windows.
Incluir licenças e licenças de usuário ao criar uma imagem
Para incluir 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:
IMAGE_NAME
: o nome da imagem a ser criada.SOURCE_IMAGE
: o nome da imagem a partir da qual a nova imagem vai ser criada.LICENSES
: uma lista separada por vírgulas de strings de licença. 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 mais informações sobre como criar imagens, consulte Como criar, excluir e suspender o uso de imagens personalizadas e Como criar uma imagem do Windows.
Incluir e validar uma licença de usuário
Para anexar e validar uma licença de usuário, faça o seguinte:
Liste os discos associados à VM usando o comando
gcloud compute instances describe
:gcloud compute instances describe VM_NAME --format="yaml(disks)"
Verifique se a saída é semelhante a esta:
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
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 dedeviceName
.Inclua 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:
BOOT_DISK_NAME
: nome do disco de inicialização a que a licença será anexadaLICENSE_URIS
: uma lista separada por vírgulas de strings de licença, que substitui todas as licenças de usuário atuais.
Receba 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.Verifique se a saída é semelhante a esta:
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
Confirme se a licença do usuário está incluída ao disco de inicialização, verificando a saída da etapa anterior do campo
userLicenses
para a string de licença apropriada.Se o campo
userLicenses
não contiver as strings de licença desejadas, talvez seja necessário limpar e atualizar a lista de strings de licença. Para isso, use o comandogcloud beta compute disks update
.
Ver o histórico de atualizações de licenças
Veja o histórico de atualizações de licença para VMs em um projeto usando o procedimento a seguir:
No console do Google Cloud, acesse a página Atividade.
No painel Filtros, em Categorias, selecione Configuração para Tipos de atividade.
No painel Filtros, em Categorias, para o Tipo de recurso, selecione Disco.
A seguir
Saiba mais sobre os sistemas operacionais premium: