Renomear uma VM

Ao criar uma instância de máquina virtual (VM), especifique um nome. Depois de criar a VM, é possível renomeá-la. 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 operacional em execução na VM.
  • Para seguir as convenções de nomenclatura exigidas pela organização.

Identificadores uniformes de recurso da VM (URIs)

Alterar o nome de uma VM pode afetar seus projetos. Em vez de se referir aos recursos da VM pelo nome, é possível fazê-lo usando o 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 em que a VM está localizada.

  • ZONE: a zona em que a VM está localizada.

  • VM_ID: o ID de uma VM atual. Para consultar o ID de uma VM atual, confira os detalhes da VM e o valor do campo id.

Preços

Renomear uma VM não altera o valor cobrado. Além disso, como sua fatura mostra VMs de acordo com as unidades de manutenção de estoque (SKUs) e não os nomes, você não encontrará os nomes das VMs na fatura.

Limitações

As limitações a seguir se aplicam ao renomear uma VM:

  • Recursos nomeados automaticamente

    • Quando você renomeia uma VM, os nomes dos recursos baseados no nome original dela não são atualizados. Por exemplo, quando você cria uma VM, o nome do disco de inicialização é o mesmo da VM. Se você renomear a VM, o nome do disco de inicialização não será alterado.

  • Servidor DHCP

    • Depois de renomear uma VM, o servidor DHCP responde a solicitações DHCP usando o nome de host atualizado com o formato HOSTNAME.c.PROJECT_ID.internal para DNS global e HOSTNAME.ZONE.c.PROJECT_ID.internal para DNS por zona. Para mais informações, consulte Tipos de nomes de DNS internos.

  • Console do Google Cloud:

    • Atualize o navegador do console do Google Cloud para atualizar o nome da VM.

  • Nomes de host:

    • Os nomes de host são modificados ao alterar o nome da instância. O Windows pode precisar de uma reinicialização para atualizar os nomes de host.

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

    • Alterar o nome do host diretamente no host não altera o nome do recurso da VM.

  • Grupos gerenciados de instâncias

    • Não é possível renomear instâncias que estão em grupos gerenciados de instâncias (MIGs, na sigla em inglês) porque elas herdam os nomes da propriedade base instance name do MIG sem estado de forma automática e irreversível.

  • Convenções de nomeação:

  • Estados de VM:

    • Interrompa a instância antes de renomeá-la porque só é possível renomear VMs que estão no estado TERMINATED. Por exemplo, não é possível renomear uma VM que está no estado SUSPENDED.

Antes de começar

  • Revise e, se aplicável, atualize os seguintes itens:
    • Grupos, gráficos e alertas do Cloud Monitoring : o Monitoring corresponde-se a strings e, quando uma instância é renomeada, essas strings não são atualizadas. Se você renomear uma VM, atualize as regras do Monitoring para incluir as VMs renomeadas nos seus relatórios.
    • URLs do console: renomear uma VM altera o URL do console. Se você renomear uma VM, atualize os links, como os favoritos do navegador, que chamam o URL do console da VM.
    • Vinculações de papéis condicionais do Identity and Access Management (IAM): essas vinculações aceitam a concessão de permissões no nome do recurso. Por exemplo, o IAM poderá conceder um papel a um usuário se o nome de uma VM começar com uma string específica. Essas vinculações não são atualizadas quando você altera o nome de uma VM. Portanto, o acesso de um usuário ao recurso da VM pode ser afetado porque você está alterando o conjunto de VMs a que o nome prefixado se aplica. Atualize essas vinculações quando renomear uma VM.
    • Cache de serviço DNS interno: o serviço DNS interno atribui nomes DNS internos às VMs, em que o nome do host está no formato HOSTNAME.c.PROJECT_ID.internal para DNS global e HOSTNAME.ZONE.c.PROJECT_ID.internal para DNS por zona. Após renomear uma VM, esses nomes de host são alterados. Em seguida, o serviço DNS interno começa a resolver para o novo nome do host e as solicitações para o nome DNS anterior falham. Se você renomear uma VM, talvez seja necessário atualizar o cache DNS para atualizar o nome do host. Para mais informações sobre nomes de host DNS globais e DNS por zona, consulte Tipos de nomes de DNS internos.
    • Consultas de metadados: depois de renomear uma VM, o servidor de metadados informará o novo nome. Se você renomear uma VM, atualize qualquer script ou programa que consulte o servidor de metadados para que ele consulte o novo nome da VM.
    • Políticas da organização que restringem endereços IP externos: restrições a VMs que têm um endereço IP externo fazem referência ao nome da VM. Quando você renomeia uma VM, essa restrição não é atualizada. Portanto, quando renomear uma VM, atualize o novo nome dela na política da organização de IP externo.
    • Nomes de host do SQL Server: se você renomear uma VM que hospeda o SQL Server, será preciso atualizar o nome da VM do SQL Server. Para mais informações, consulte Renomear um computador que hospeda uma instância autônoma do SQL Server.
  • 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

    1. Install the Google Cloud CLI, then initialize it by running the following command: 

      gcloud init
    2. Set a default region and zone.

      3. 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.

Funções exigidas

Para receber a permissão necessária para renomear uma VM, peça ao administrador para conceder a você o papel do IAM Administrador da instância da computação (v1) (roles/compute.instanceAdmin.v1) no projeto. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Esse papel predefinido contém a permissão compute.instances.setName, que é necessária para renomear uma VM.

Também é possível conseguir essa permissão com papéis personalizados ou outros papéis predefinidos.

Renomear uma VM

Só é possível renomear VMs interrompidas que estejam no estado TERMINATED.

Console

Para renomear uma VM, faça o seguinte:

  1. No console do Google Cloud, acesse a página Instâncias de VMs.

    Acessar instâncias de VM

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

  3. Faça o seguinte para interromper a VM, caso ainda não tenha feito isso:

    1. Clique em Interromper.

    2. Para confirmar, clique em Interromper.

      A interrupção da VM pode levar até 90 segundos para ser concluída.

  4. Clique em Editar.

  5. No campo Nome da instância de VM, digite um novo nome.

  6. Clique em Salvar.

    A renomeação da VM pode levar até um minuto para ser concluída. Se, depois de renomear a VM, você receber um erro informando que o Google Cloud não conseguiu encontrá-la, atualize o navegador.

  7. Se precisar, reinicie a VM clicando em Iniciar / Retomar.

gcloud

Para renomear uma VM, faça o seguinte:

  1. Interrompa a VM, caso ainda não tenha feito isso.

  2. Para renomear a 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:

    • VM_NAME: o nome de uma VM existente.

    • NEW_VM_NAME: o novo nome da VM especificada.

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

    • ZONE: a zona em que a VM está localizada.

    A renomeação da VM pode levar até um minuto para ser concluída.

  3. Se precisar, Reinicie a VM.

REST

Para renomear uma VM, faça o seguinte:

  1. Interrompa a VM, caso ainda não tenha feito isso.

  2. Para renomear a VM, faça uma solicitação POST para o 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:

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

    • ZONE: a zona em que a VM está localizada.

    • VM_NAME: o nome de uma VM existente.

    • NEW_VM_NAME: o novo nome da VM especificada.

    A renomeação da VM pode levar até um minuto para ser concluída. Para monitorar o status da renomeação, pesquise o ID da operação retornado pela API de renomeação. Para mais informações, consulte Como gerenciar respostas de API.

  3. Se precisar, Reinicie a VM.

A seguir