Renomear uma VM

Ao criar uma instância de máquina virtual (VM), você deve especificar um nome. Depois de criar a VM, você poderá renomeá-la opcionalmente. Alterar um nome de 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 aderir a quaisquer convenções de nomenclatura exigidas pela sua organização.

Identificadores uniformes de recursos (URIs) da VM

Alterar o nome de uma VM pode afetar seus projetos. Em vez de referenciar os recursos da VM pelo nome, você pode referenciá-los pelo 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 visualizar o ID de uma VM existente, visualize os detalhes da VM e, em seguida, visualize o valor do campo id .

Preços

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

Limitações

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

  • Recursos nomeados automaticamente:

    • Ao renomear uma VM, os nomes de quaisquer recursos baseados no nome original da VM não são atualizados. Por exemplo, quando você cria uma VM, o nome do disco de inicialização é igual ao nome 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 às solicitações DHCP com o nome do host atualizado no formato HOSTNAME .c. PROJECT_ID .internal para DNS global e HOSTNAME . ZONE .c. PROJECT_ID .internal para DNS zonal. Para obter mais informações, consulte Tipos de nomes DNS internos .

  • Console do Google Cloud:

    • Você precisa atualizar seu navegador para que o console do Google Cloud atualize o nome da VM.

  • Nomes de host:

    • Os nomes de host são modificados quando você altera o nome da instância. No Windows, as atualizações de nome de host podem exigir uma reinicialização.

    • VMs que possuem nomes de host personalizados não são atualizadas.

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

  • Grupos de instâncias gerenciadas:

    • Você não pode renomear instâncias que estão em grupos de instâncias gerenciadas (MIGs) porque essas instâncias herdam seus nomes de forma automática e irreversível da propriedade base instance name de seu MIG sem estado.

  • Convenções de nomenclatura:

  • VM afirma:

    • Pare a instância antes de renomeá-la porque você só pode renomear VMs que estão no estado TERMINATED . Não é possível, por exemplo, renomear uma VM que esteja no estado SUSPENDED .

Antes de começar

  • Revise e, se aplicável, atualize o seguinte:
    • Grupos, gráficos e alertas do Cloud Monitoring: o monitoramento corresponde a strings e, quando você renomeia uma VM, essas strings não são atualizadas. Se você renomear uma VM, atualize suas regras do Monitoring para incluir as VMs renomeadas em seus relatórios.
    • URLs do console : renomear uma VM altera o URL do console. Se você renomear uma VM, deverá atualizar links, como marcadores do navegador que fazem referência à URL do console da VM.
    • Vinculações de função condicional de gerenciamento de identidade e acesso (IAM) : as vinculações de função condicional oferecem suporte à concessão de permissões no nome do recurso. Por exemplo, o IAM pode conceder uma função a um usuário se o nome de uma VM começar com uma string específica. Essas ligaçõ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 ao qual o nome prefixado se aplica. Se você renomear uma VM, atualize essas ligações.
    • Cache de serviço DNS interno : O serviço DNS interno atribui nomes DNS internos às VMs, nas quais o nome do host está no formato HOSTNAME .c. PROJECT_ID .internal para DNS global e HOSTNAME . ZONE .c. PROJECT_ID .internal para DNS zonal. Depois de renomear uma VM, esses nomes de host mudam. Em seguida, o serviço DNS interno começa a resolver para o novo nome de 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 obter mais informações sobre nomes de host DNS globais e DNS zonais, consulte Tipos de nomes DNS internos .
    • Consultas de metadados : após renomear uma VM, o servidor de metadados informa o novo nome. Se você renomear uma VM, atualize quaisquer scripts ou programas que consultem o servidor de metadados para que eles consultem o novo nome da VM.
    • Políticas da organização que restringem endereços IP externos : restrições contra VMs que possuem um endereço IP externo fazem referência ao nome da VM. Ao renomear uma VM, essa restrição não é atualizada. Se você renomear uma VM, atualize a política da organização de IP externo com o novo nome da VM.
    • Nomes de host do SQL Server : se você renomear uma VM que hospeda o SQL Server, deverá atualizar o nome da VM do SQL Server. Para obter mais informações, consulte Renomear um computador que hospeda uma instância autônoma do SQL Server .
  • Se ainda não o fez, configure a autenticação. Autenticação é o processo pelo qual sua identidade é verificada para acesso a Google Cloud serviços e APIs. Para executar códigos ou amostras em um ambiente de desenvolvimento local, você pode se autenticar 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. After installing the Google Cloud CLI, initialize it by running the following command: 

      gcloud init

      If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

    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.

        After installing the Google Cloud CLI, initialize it by running the following command: 

        gcloud init

        If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

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

Funções obrigatórias

Para obter a permissão necessária para renomear uma VM, peça ao administrador para conceder a você a função do IAM Compute Instance Admin (v1) ( roles/compute.instanceAdmin.v1 ) no projeto. Para obter mais informações sobre a concessão de funções, consulte Gerenciar acesso a projetos, pastas e organizações .

Essa função predefinida contém a permissão compute.instances.setName , que é necessária para renomear uma VM.

Você também poderá obter essa permissão com funções personalizadas ou outras funções predefinidas .

Renomear uma VM

Você só pode 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 de instâncias de VM .

    Acesse as instâncias de VM

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

  3. Se ainda não o fez, interrompa a VM fazendo o seguinte:

    1. Clique em Parar .

    2. Para confirmar, clique em Parar .

  4. Clique em Editar .

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

  6. Clique em Salvar .

    A renomeação da VM pode levar até um minuto para ser concluída. Se, após renomear a VM, você receber um erro que Google Cloud não consegue encontrar a VM, atualize seu navegador.

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

gcloud

Para renomear uma VM, faça o seguinte:

  1. Se ainda não o fez, pare a VM .

  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 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 renomeação da VM pode levar até um minuto para ser concluída.

  3. Se precisar, reinicie a VM .

DESCANSAR

Para renomear uma VM, faça o seguinte:

  1. Se ainda não o fez, pare a VM .

  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 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 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 obter mais informações, consulte Tratamento de respostas de API .

  3. Se precisar, reinicie a VM .

O que vem a seguir