Mude o nome de uma VM

Quando cria uma instância de máquina virtual (VM), tem de especificar um nome. Depois de criar a VM, pode mudar-lhe o nome opcionalmente. A alteração do nome de uma VM pode ser útil nos seguintes cenários:

  • Para representar melhor a carga de trabalho em execução na VM.
  • Para se referir ao sistema operativo em execução na VM.
  • Para cumprir as convenções de nomenclatura exigidas pela sua organização.

Identificadores uniformes de recursos (URIs) de VMs

A alteração do nome de uma VM pode afetar os seus projetos. Em vez de fazer referência a recursos de VMs pelo respetivo nome, pode fazer referência aos mesmos pelo respetivo URI, que é permanente. O URI tem o seguinte formato:

projects/PROJECT_ID/zones/ZONE/instances/VM_ID

O URI inclui os seguintes valores:

  • PROJECT_ID: o ID do projeto onde a VM está localizada.

  • ZONE: a zona onde a VM está localizada.

  • VM_ID: o ID de uma VM existente. Para ver o ID de uma VM existente, veja os detalhes da VM e, em seguida, veja o valor do campo id.

Preços

A alteração do nome de uma VM não altera o valor que lhe é faturado. Além disso, uma vez que a fatura mostra as VMs de acordo com as respetivas unidades de gestão de stock (SKUs) e não os respetivos nomes, não vê os nomes das VMs na fatura.

Limitações

Aplicam-se limitações ao seguinte quando muda o nome de uma VM:

  • Recursos com nomes automáticos:

    • Quando muda o nome de uma VM, os nomes de todos os recursos baseados no nome da VM original não são atualizados. Por exemplo, quando cria uma VM, o nome do disco de arranque é o mesmo que o nome da VM. Se mudar o nome da VM, o nome do disco de arranque não é alterado.

  • Servidor DHCP:

    • Depois de mudar o nome de uma VM, o servidor DHCP responde aos pedidos DHCP com o nome do anfitrião atualizado no formato HOSTNAME.c.PROJECT_ID.internal para DNS global e HOSTNAME.ZONE.c.PROJECT_ID.internal para DNS zonal. Para mais informações, consulte o artigo Tipos de nomes de DNS internos.

  • Google Cloud console:

    • Tem de atualizar o navegador para que a consola Google Cloud atualize o nome da VM.

  • Nomes de anfitriões:

    • Os nomes de anfitrião são modificados no Linux quando altera o nome da instância. No Windows, o nome do anfitrião não é atualizado, mesmo depois de reiniciar a instância.

    • As VMs que têm nomes de anfitrião personalizados não são atualizadas.

    • A alteração do nome do anfitrião diretamente no anfitrião não afeta o nome do recurso de VM.

  • Grupos de instâncias:

    • Não pode mudar o nome de instâncias que façam parte de um grupo de instâncias não gerido ou gerido (MIG).

  • Convenções de nomenclatura:

  • Estados da VM:

    • Pare a instância antes de lhe mudar o nome, porque só pode mudar o nome de VMs que se encontram no estado TERMINATED. Por exemplo, não pode mudar o nome de uma VM no estado SUSPENDED.

Antes de começar

  • Reveja e, se aplicável, atualize o seguinte:
    • Grupos, gráficos e alertas do Cloud Monitoring: a monitorização corresponde a strings e, quando muda o nome de uma VM, estas strings não são atualizadas. Se mudar o nome de uma VM, atualize as regras de monitorização para incluir as VMs com o novo nome nos relatórios.
    • URLs da consola: a mudança do nome de uma VM altera o respetivo URL da consola. Se mudar o nome de uma VM, tem de atualizar os links, como os marcadores do navegador, que fazem referência ao URL da consola da VM.
    • Identity and Access Management (IAM) associações de funções condicionais: as associações de funções condicionais suportam a concessão de autorizações no nome do recurso. Por exemplo, o IAM pode conceder uma função a um utilizador se o nome de uma VM começar por uma determinada string. Estas associações não são atualizadas quando altera o nome de uma VM. Por isso, o acesso de um utilizador ao recurso de VM pode ser afetado, uma vez que está a alterar o conjunto de VMs ao qual o nome com prefixo se aplica. Se mudar o nome de uma VM, atualize estas associações.
    • Cache do serviço DNS interno: o serviço DNS interno atribui nomes DNS internos às VMs, em que o nome do anfitrião tem o formato HOSTNAME.c.PROJECT_ID.internal para DNS global e HOSTNAME.ZONE.c.PROJECT_ID.internal para DNS zonal. Depois de mudar o nome de uma VM, estes nomes de anfitrião mudam. Em seguida, o serviço DNS interno começa a resolver para o novo nome do anfitrião e os pedidos para o nome DNS anterior falham. Se mudar o nome de uma VM, pode ter de atualizar a cache de DNS para atualizar o nome do anfitrião. Para mais informações sobre o DNS global e os nomes de anfitriões DNS zonais, consulte Tipos de nomes DNS internos.
    • Consultas de metadados: Depois de mudar o nome de uma VM, o servidor de metadados comunica o novo nome. Se mudar o nome de uma VM, atualize todos os scripts ou programas que consultam o servidor de metadados para que consultem o novo nome da VM.
    • Políticas da organização que restringem endereços IP externos: as restrições contra VMs que têm uma referência de endereço IP externo referem-se ao nome da VM. Quando muda o nome de uma VM, esta restrição não é atualizada. Se mudar o nome de uma VM, atualize a política da organização de IP externo com o novo nome da VM.
    • Nomes de anfitriões do SQL Server: se mudar o nome de uma VM que aloja o SQL Server, tem de atualizar o nome da VM do SQL Server. Para mais informações, consulte o artigo Mude o nome de um computador que aloja uma instância autónoma do SQL Server.
  • Se ainda não o tiver feito, configure a autenticação. A autenticação valida a sua identidade para aceder a Google Cloud serviços e APIs. Para executar código ou exemplos a partir de um ambiente de desenvolvimento local, pode autenticar-se no Compute Engine selecionando uma das seguintes opções:

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

      gcloud init

      Se estiver a usar um fornecedor de identidade (IdP) externo, primeiro tem de iniciar sessão na CLI gcloud com a sua identidade federada.

    2. Set a default region and zone.

    REST

    Para usar os exemplos da API REST nesta página num ambiente de desenvolvimento local, usa as credenciais que fornece à CLI gcloud.

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

      gcloud init

      Se estiver a usar um fornecedor de identidade (IdP) externo, primeiro tem de iniciar sessão na CLI gcloud com a sua identidade federada.

    Para mais informações, consulte o artigo Autenticar para usar REST na Google Cloud documentação de autenticação.

Funções necessárias

Para receber a autorização de que precisa para mudar o nome de uma VM, peça ao seu administrador para lhe conceder a função Administrador de instâncias do Compute (v1) (roles/compute.instanceAdmin.v1) do IAM no projeto. Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.

Esta função predefinida contém a autorização compute.instances.setName , que é necessária para mudar o nome de uma VM.

Também pode obter esta autorização com funções personalizadas ou outras funções predefinidas.

Mude o nome de uma VM

Só pode mudar o nome de VMs paradas que estejam no estado TERMINATED.

Consola

Para mudar o nome de uma VM, faça o seguinte:

  1. Na Google Cloud consola, aceda à página Instâncias de VM.

    Aceder às instâncias de VM

  2. Na coluna Nome, clique no nome da MV.

  3. Se ainda não o tiver feito, clique em Parar para parar a VM. Se não existir a opção Parar, clique em Mais ações > Parar.

  4. Clique em Editar.

  5. No campo Nome da instância de VM, introduza um novo nome para a VM.

  6. Clique em Guardar.

    A mudança do nome da VM pode demorar até um minuto. Se, depois de mudar o nome da VM, receber um erro que indica que não é possível encontrar a VM, atualize o navegador. Google Cloud

  7. Se necessário, reinicie a VM clicando em Iniciar / Retomar.

gcloud

Para mudar o nome de uma VM, faça o seguinte:

  1. Se ainda não o tiver feito, pare a VM.

  2. Para mudar o nome da VM, use o comando gcloud compute instances set-name.

    gcloud compute instances set-name VM_NAME \
    --new-name=NEW_VM_NAME \
    --project=PROJECT_ID \
    --zone=ZONE

    Substitua o seguinte:

    • VM_NAME: o nome de uma VM existente.

    • NEW_VM_NAME: o novo nome da VM especificada.

    • PROJECT_ID: o ID do projeto onde a VM está localizada.

    • ZONE: a zona onde a VM está localizada.

    A mudança do nome da VM pode demorar até um minuto.

  3. Se precisar, reinicie a VM.

REST

Para mudar o nome de uma VM, faça o seguinte:

  1. Se ainda não o tiver feito, pare a VM.

  2. Para mudar o nome da VM, faça um pedido POST ao método instances.setName.

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME/setName

{
  "currentName": "VM_NAME",
  "name": "NEW_VM_NAME"
}

    Substitua o seguinte:

    • PROJECT_ID: o ID do projeto onde a VM está localizada.

    • ZONE: a zona onde a VM está localizada.

    • VM_NAME: o nome de uma VM existente.

    • NEW_VM_NAME: o novo nome da VM especificada.

    A mudança do nome da VM pode demorar até um minuto. Para monitorizar o estado da mudança de nome, consulte o ID da operação devolvido pela API rename. Para mais informações, consulte o artigo Processar respostas da API.

  3. Se precisar, reinicie a VM.

O que se segue?