Nesta página, você aprenderá como definir uma região ou zona padrão para seu projeto do console do Google Cloud .
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 do Google Cloud para acessar os serviços e as APIs do 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.
Funções exigidas
Para receber as permissões necessárias para visualizar ou alterar as configurações padrão de região e zona, peça ao administrador para conceder a você os seguintes papéis do IAM no projeto:
-
Ver as configurações padrão de região e zona:
Leitor do Compute (
roles/compute.viewer) -
Mude as configurações padrão de região e zona:
- Administrador da instância do Compute (v1) (
roles/compute.instanceAdmin.v1) - Administrador do Compute (
roles/compute.admin)
- Administrador da instância do Compute (v1) (
Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.
Esses papéis predefinidos contêm as permissões necessárias para visualizar ou alterar as configurações padrão de região e zona. Para acessar as permissões exatas necessárias, expanda a seção Permissões necessárias:
Permissões necessárias
As permissões a seguir são necessárias para visualizar ou alterar as configurações padrão de região e zona:
-
Ver as configurações padrão de região e zona:
compute.projects.get -
Mude as configurações padrão de região e zona:
-
compute.projects.get -
compute.projects.setCommonInstanceMetadata
-
Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.
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 do 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 do 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 do Google Cloud .
Como procurar a região ou zona padrão
O servidor de metadados contém informações de metadados sobre um projeto, incluindo o ID e o nome do projeto. 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 estas configurações durante a criação e o gerenciamento dos 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