Ver e incluir licenças

Linux Windows

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
1. Instale a Google Cloud CLI e inicialize-a executando o seguinte comando:
```
gcloud init
```
  Observação: se você instalou a CLI gcloud anteriormente, verifique se tem a versão mais recente executando gcloud components update.
2. 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.

Ver as licenças associadas a uma VM

Permissões exigidas para a tarefa

Para executar esta tarefa, é necessário ter as seguintes permissões:

compute.instances.get

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.

Acessar instâncias de VM
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 campo licenses 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 campo licenses.

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

Permissões exigidas para a tarefa

Para executar esta tarefa, é necessário ter as seguintes permissões:

compute.instances.get

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.

Acessar instâncias de VM
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 campo licenses 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 campo licenses.

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

Permissões exigidas para a tarefa

Para executar esta tarefa, é necessário ter as seguintes permissões:

compute.disks.update e compute.disks.get no disco de inicialização

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

Pare a VM.
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 de deviceName.
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á anexada
- LICENSE_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 comando gcloud beta compute disks update.
Iniciar a VM.

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.

Acessar "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

Resolver problemas com licenças
Saiba mais sobre as licenças da Microsoft no Compute Engine
Saiba mais sobre os sistemas operacionais premium: