Esta página explica como definir uma região ou uma zona predefinida para o seu Google Cloud projeto da consola.
Quando faz um pedido ao Compute Engine, pode ter de fornecer uma região ou uma zona, consoante os requisitos específicos do seu pedido. Qualquer pedido que envolva recursos regionais requer que forneça um nome de região, e qualquer pedido que envolva recursos zonais requer que forneça um nome de zona. Por exemplo, tem de especificar uma região quando cria um endereço IP externo estático e tem de especificar uma zona quando cria uma instância de máquina virtual (VM).
Quando cria um projeto, o Compute Engine seleciona automaticamente uma região e uma zona predefinidas com base na localização a partir da qual cria o projeto. O Compute Engine tenta escolher uma região e uma zona próximas da origem do projeto para que os recursos que criar tenham uma latência reduzida para os seus clientes. Se quiser criar recursos numa região ou zona diferente, pode substituir a seleção predefinida.
Para mais informações sobre regiões e zonas, consulte o artigo Regiões e zonas.
Para mais informações sobre os recursos globais, regionais e zonais do Compute Engine, consulte o artigo Recursos globais, regionais e zonais.
Antes de começar
-
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
-
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.
- Set a default region and zone.
Como uma região e uma zona predefinidas afetam o seu projeto
As predefinições de região e zona afetam apenas as ferramentas de cliente, como a CLI Google Cloud e a Google Cloud consola. Quando usa estas ferramentas para criar os seus pedidos, as ferramentas ajudam a gerir os recursos selecionando automaticamente a região e a zona predefinidas.
Quando usa a Google Cloud consola para criar recursos regionais ou zonais como moradas e instâncias, o Compute Engine define os campos de região e zona por si. Pode aceitar os valores pré-preenchidos ou alterar explicitamente um ou ambos os valores.
Quando usa a CLI gcloud, omita a definição das flags
--region
e--zone
para usar as propriedades de região e zona predefinidas para o novo projeto.Pode sempre alterar as predefinições da região e da zona no servidor de metadados, substituir a região e a zona predefinidas localmente para a CLI gcloud ou substituir as definições manualmente para cada pedido através da CLI gcloud ou da Google Cloud consola.
A procurar a região ou a zona predefinida
O servidor de metadados contém informações de metadados sobre um projeto, incluindo o ID e o nome do projeto. Pode consultar o servidor de metadados para obter e usar informações sobre o projeto.
Se especificar uma região e uma zona predefinidas para o seu projeto, o Compute Engine define estes valores no servidor de metadados do seu projeto.
As regiões e as zonas predefinidas são definidas através dos seguintes valores:
google-compute-default-region
google-compute-default-zone
Para ver quais são as predefinições da região e da zona, execute o seguinte comando
gcloud
, substituindoPROJECT_ID
pelo ID do seu projeto:gcloud compute project-info describe --project PROJECT_ID
Procure os valores de metadados da região e da zona predefinidos na resposta. Se as chaves e os valores
google-compute-default-region
egoogle-compute-default-zone
estiverem em falta na resposta, significa que não está definida nenhuma região nem zona predefinida.Alterar a região ou a zona predefinida
Não existem restrições quanto às regiões ou zonas que pode definir para as suas propriedades predefinidas. Por exemplo, é possível definir uma zona predefinida que esteja fora da sua região predefinida. Verifique as definições de região e zona predefinidas quando criar e gerir os seus recursos.
Consola
Para alterar a região ou a zona predefinida, siga estes passos:
Na Google Cloud consola, aceda à página Definições.
No menu pendente Região, selecione uma região predefinida.
No menu pendente Zona, selecione uma zona predefinida.
Clique em Guardar.
gcloud
Pode alterar a região e a zona predefinidas fazendo um pedido ao servidor de metadados. Por exemplo:
gcloud compute project-info add-metadata \ --metadata google-compute-default-region=europe-west1,google-compute-default-zone=europe-west1-b
Depois de atualizar os metadados predefinidos através de qualquer método, execute o comando
gcloud init
para reinicializar a configuraçãodefault
. A CLI gcloud atualiza as predefinições da região e da zona apenas depois de executar o comandogcloud init
.Para mais informações sobre a utilização das opções da CLI gcloud para definir regiões e zonas predefinidas, consulte o artigo Defina propriedades predefinidas.
O que se segue?
- Saiba mais sobre regiões e zonas.
- Saiba mais sobre os recursos globais, regionais e zonais.
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 2025-09-19 UTC.
-