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 campoid
.
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 eHOSTNAME.ZONE.c.PROJECT_ID.internal
para DNS por zona. Para mais informações, consulte Tipos de nomes de DNS internos.
- Depois de renomear uma VM, o servidor DHCP responde a solicitações DHCP
usando o nome de host atualizado com o formato
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.
- 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
Convenções de nomeação:
Não é possível renomear uma VM com um nome que já esteja sendo usado por outra VM no projeto.
Os nomes de instâncias precisam aderir às convenções de nomenclatura de recursos.
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 estadoSUSPENDED
.
- Interrompa a instância antes de
renomeá-la porque só é possível renomear VMs que estão no estado
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 eHOSTNAME.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
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- Set a default region and zone.
No console do Google Cloud, acesse a página Instâncias de VMs.
Na coluna Nome, clique no nome da VM.
Faça o seguinte para interromper a VM, caso ainda não tenha feito isso:
Clique em
Interromper.Para confirmar, clique em Interromper.
A interrupção da VM pode levar até 90 segundos para ser concluída.
Clique em
Editar.No campo Nome da instância de VM, digite um novo nome.
Clique em Save.
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.
Se precisar, reinicie a VM clicando em
Iniciar / Retomar.Interrompa a VM, caso ainda não tenha feito isso.
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.
Se necessário, reinicie a VM.
Interrompa a VM, caso ainda não tenha feito isso.
Para renomear a VM, faça uma solicitação
POST
para o métodoinstances.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.
Se necessário, reinicie a VM.
Saiba como acessar os detalhes da VM.
Saiba como interromper e iniciar uma VM.
Saiba como suspender ou retomar uma VM.
Saiba mais sobre o ciclo de vida das VMs.
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 do Compute (v1) (
roles/compute.instanceAdmin.v1
) no projeto. Para mais informações sobre como conceder papéis, consulte Gerenciar acesso.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:
gcloud
Para renomear uma VM, faça o seguinte:
REST
Para renomear uma VM, faça o seguinte:
A seguir
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2024-09-03 UTC.
[{ "type": "thumb-down", "id": "hardToUnderstand", "label":"Hard to understand" },{ "type": "thumb-down", "id": "incorrectInformationOrSampleCode", "label":"Incorrect information or sample code" },{ "type": "thumb-down", "id": "missingTheInformationSamplesINeed", "label":"Missing the information/samples I need" },{ "type": "thumb-down", "id": "translationIssue", "label":"Problema na tradução" },{ "type": "thumb-down", "id": "otherDown", "label":"Outro" }] [{ "type": "thumb-up", "id": "easyToUnderstand", "label":"Fácil de entender" },{ "type": "thumb-up", "id": "solvedMyProblem", "label":"Meu problema foi resolvido" },{ "type": "thumb-up", "id": "otherUp", "label":"Outro" }] -