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.

  • Trusted Cloud console:

    • Atualize o navegador para que o Trusted Cloud console atualize o nome da VM.

  • Nomes de host:

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

    • 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 de instâncias:

    • Não é possível renomear instâncias que fazem parte de um grupo gerenciado ou não gerenciado de instâncias (MIG).

  • 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 Trusted Cloud by S3NS . Para executar códigos ou amostras de um ambiente de desenvolvimento local, autentique-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 Trusted Cloud console to access Trusted Cloud by S3NS services and APIs, you don't need to set up authentication.

    gcloud

    1. Instale a Google Cloud CLI e faça login nela com sua identidade federada. Depois de fazer login, inicialize a Google Cloud CLI executando o seguinte comando: 

      gcloud init
    2. Set a default region and zone.

    REST

    Para usar as amostras da API REST nesta página em um ambiente de desenvolvimento local, use as credenciais fornecidas para a CLI gcloud.

      Instale a Google Cloud CLI e faça login nela com sua identidade federada. Depois de fazer login, inicialize a Google Cloud CLI executando o seguinte comando: 

      gcloud init

    Para mais informações, consulte Autenticar para usar REST na documentação de autenticação do Trusted 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 Trusted Cloud console, acesse a página Instâncias de VM:

    Acessar instâncias de VM

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

  3. Se ainda não tiver feito isso, clique em Parar para interromper a VM. Se não houver uma opção Parar, clique em Mais ações > Parar.

  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 Trusted 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