Nesta página, você vai aprender a definir uma região ou zona padrão para seu Google Cloud projeto do console.
Ao fazer uma solicitação para o Compute Engine, talvez você precise especificar uma região ou zona, dependendo dos requisitos específicos da solicitação. Se houver solicitações envolvendo recursos por região, é necessário definir o nome da região e, no caso de solicitações envolvendo recursos por zona, o nome da zona. Por exemplo, é preciso especificar uma região ao criar um endereço IP externo estático e uma zona ao criar uma instância do Compute Engine. Para uma lista completa de regiões e zonas, consulte Regiões e zonas.
Para informações sobre recursos globais, regionais e zonais do Compute Engine, consulte Recursos globais, regionais e zonais.
Antes de começar
-
Configure a autenticação, caso ainda não tenha feito isso.
Com isso, você confirma 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 selecionando uma das seguintes opções:
Selecione a guia para como planeja usar as amostras nesta página:
Console
Quando você usa o console Google Cloud para acessar os serviços e as APIs Google Cloud , não é necessário configurar a autenticação.
gcloud
-
Instale a CLI do Google Cloud. Após a instalação, inicialize a Google Cloud CLI executando o seguinte comando:
gcloud initAo usar um provedor de identidade (IdP) externo, primeiro faça login na CLI gcloud com sua identidade federada.
-
- Defina uma região e uma zona padrão.
Como uma região e uma zona padrão afetam seu projeto
As configurações de região e zona padrão afetam apenas as ferramentas de cliente, como a Google Cloud CLI e o console Google Cloud . Quando usadas para criar solicitações, essas ferramentas ajudam a gerenciar recursos, selecionando automaticamente a região e a zona padrão.
Quando você usa o console Google Cloud para criar recursos regionais ou zonais, como endereços e instâncias, o Compute Engine define os campos de região e zona para você. É possível aceitar os valores preenchidos previamente ou alterar explicitamente um ou ambos os valores.
Ao usar a CLI gcloud, omita a configuração das sinalizações --region e --zone para usar as propriedades padrão de região e zona no novo
projeto.
Sempre que você quiser alterar as configurações padrão de região e zona no servidor de metadados, modifique-as localmente com a CLI gcloud. Se preferir, modifique manualmente as configurações de cada solicitação usando a CLI gcloud ou o console Google Cloud .
Como procurar a região ou zona padrão
O servidor de metadados contém informações sobre um projeto, incluindo o ID do projeto e o nome dele. Consulte o servidor para receber e usar essas informações.
Se você especificar região e zona padrão para o projeto, o Compute Engine definirá estes valores no servidor de metadados do projeto.
As regiões e zonas padrão são definidas com os seguintes valores:
google-compute-default-regiongoogle-compute-default-zone
Para ver quais são suas configurações de região e zona padrão, execute o seguinte
comando do gcloud, substituindo
PROJECT_ID pelo ID do projeto:
gcloud compute project-info describe --project PROJECT_ID
Procure os valores de metadados de região e zona padrão na resposta. Se os valores e as chaves
google-compute-default-region e google-compute-default-zone
estiverem ausentes na resposta, é porque não foi feita a definição de nenhuma
região ou zona padrão.
Como alterar a região ou zona padrão
Observação: não há restrições quanto às regiões ou zonas que podem ser definidas para as propriedades padrão. Por exemplo, é possível definir uma zona padrão fora da sua região padrão. Verifique as configurações padrão de região e zona ao criar e gerenciar seus recursos.
Console
Para alterar a região ou zona padrão, siga estas etapas:
No console do Google Cloud , acesse a página Configurações.
No menu suspenso Região, selecione uma região padrão.
No menu suspenso Zona, selecione uma zona padrão.
Clique em Salvar.
gcloud
É possível alterar a região e a zona padrão fazendo uma solicitação 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 padrão usando qualquer método, execute o
comando gcloud init para reinicializar a configuração default.
A CLI gcloud atualiza as configurações de região e zona padrão
somente após a execução do comando gcloud init.
Para mais informações sobre como usar as opções da CLI gcloud para definir regiões e zonas padrão, consulte Definir propriedades padrão.
A seguir
- Saiba mais sobre regiões e zonas.
- Saiba mais sobre Recursos globais, regionais e zonais