Atualizar licenças após um upgrade do SO

Nesta página, explicamos como atualizar as strings de licença nas instâncias de máquina virtual (VM) depois de fazer um upgrade local do sistema operacional (SO). Esse processo se aplica aos seguintes sistemas operacionais:

  • Red Hat Enterprise Linux (RHEL)
  • RHEL para SAP
  • SUSE Linux Enterprise Server (SLES)
  • SLES para SAP
  • Windows Server

Para detalhes sobre referências e códigos de licença, consulte Mudanças e restrições de licença.

Antes de começar

  • Configure a autenticação, caso ainda não tenha feito isso. Com isso, você confirma 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 selecionando uma das seguintes opções:

    Selecione a guia para como planeja usar as amostras nesta página:

    Console

    Quando você usa o console Google Cloud para acessar serviços Google Cloud e APIs, não é necessário configurar a autenticação.

    gcloud

    1. Instale a CLI do Google Cloud. Após a instalação, inicialize a Google Cloud CLI executando o seguinte comando: 

      gcloud init

      Ao usar um provedor de identidade (IdP) externo, primeiro faça login na CLI gcloud com sua identidade federada.

  • Defina uma região e uma zona padrão.

Preparar para atualizar a licença de um disco

Para atualizar a licença do disco enquanto ele está anexado a uma instância em execução, primeiro pare a instância ou remova o disco.

Atualizar a licença no disco

Para atualizar a licença em um disco, use a Google Cloud CLI ou a API Compute Engine. Esse processo substitui o URI de licença atual pelo novo, correspondente à versão atualizada do SO.

gcloud

Para substituir a licença de um disco por uma nova referência de licença, use o comando gcloud compute disks update:

gcloud compute disks update DISK_NAME \
    --replace-license=PREVIOUS_LICENSE,NEW_LICENSE

Substitua:

  • DISK_NAME: o nome do disco a ser atualizado.
  • PREVIOUS_LICENSE: a referência de licença da versão anterior do SO, por exemplo, "projects/windows-cloud/global/licenses/windows-server-2022-dc" ou "projects/rhel-cloud/global/licenses/rhel-9".
  • NEW_LICENSE: a referência da licença para a nova versão do SO, por exemplo, "projects/windows-cloud/global/licenses/windows-server-2025-dc" ou "projects/rhel-cloud/global/licenses/rhel-10".

REST

Para substituir a licença de um disco, adicione a nova licença ao corpo da solicitação e omita a anterior. Chame o seguinte método disks.update v1:

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT/zones/ZONE/disks/DISK_NAME?paths=licenses --data '{"name":"DISK_NAME", "licenses":["https://www.googleapis.com/compute/v1/NEW_LICENSE"]}'

Substitua:

  • PROJECT: o nome do projeto.
  • ZONE: a zona que contém o disco.
  • DISK_NAME: o nome do disco.
  • NEW_LICENSE: a nova referência de licença, por exemplo, "projects/windows-cloud/global/licenses/windows-server-2025-dc" ou "projects/rhel-cloud/global/licenses/rhel-10".

Validar a mudança de licença

Para validar se a licença foi alterada no disco de inicialização, use o seguinte procedimento:

  1. Para informações sobre o disco de inicialização, execute o comando gcloud compute disks describe:

    gcloud compute disks describe DISK_NAME \
    --zone=ZONE \
    --format="value(licenses)"

    Substitua:

    • DISK_NAME: o nome do disco de inicialização para validar a licença
    • ZONE: a zona que contém o disco de inicialização para validar a licença.

  2. Verifique se a saída é semelhante a esta:

    https://www.googleapis.com/compute/v1/projects/windows-cloud/global/licenses/windows-server-2025-dc