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.
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
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- Set a default region and zone.
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.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.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
.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.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.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
.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
.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"
.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"
.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
.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.
Saiba mais sobre os sistemas operacionais premium:
REST
Para usar as amostras da API REST nesta página em um ambiente de desenvolvimento local, use as credenciais fornecidas para gcloud CLI.
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
Para mais informações, consulte Autenticar para usar REST na documentação de autenticação do Google Cloud.
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
gcloud
REST
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
gcloud
REST
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:
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:
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:
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:
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:
A seguir
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2024-09-03 UTC.
[{ "type": "thumb-down", "id": "hardToUnderstand", "label":"Hard to understand" },{ "type": "thumb-down", "id": "incorrectInformationOrSampleCode", "label":"Incorrect information or sample code" },{ "type": "thumb-down", "id": "missingTheInformationSamplesINeed", "label":"Missing the information/samples I need" },{ "type": "thumb-down", "id": "translationIssue", "label":"Problema na tradução" },{ "type": "thumb-down", "id": "otherDown", "label":"Outro" }] [{ "type": "thumb-up", "id": "easyToUnderstand", "label":"Fácil de entender" },{ "type": "thumb-up", "id": "solvedMyProblem", "label":"Meu problema foi resolvido" },{ "type": "thumb-up", "id": "otherUp", "label":"Outro" }] -