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ódigo ou exemplos em um ambiente de desenvolvimento local, faça a autenticação no Compute Engine com um destes métodos:

    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. Instale a CLI do Google Cloud. Após a instalação, inicialize a CLI do Google Cloud executando o seguinte comando: 

      gcloud init

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

    2. Set a default region and zone.

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 necessária para a versão anterior do SO, por exemplo, "windows-server-2022-dc" ou "rhel-9".
  • NEW_LICENSE: a referência de licença necessária para a nova versão do SO, por exemplo, "windows-server-2025-dc" ou "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, "windows-server-2025-dc" ou "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