Alterando a região ou zona padrão

Esta página explica como definir uma região ou zona padrão para seu projeto do console do Google Cloud.

Ao fazer uma solicitação ao Compute Engine, pode ser necessário fornecer uma região ou zona, dependendo dos requisitos específicos da sua solicitação. Qualquer solicitação que envolva recursos regionais exige que você forneça um nome de região, e qualquer solicitação que envolva recursos zonais exige que você forneça um nome de zona. Por exemplo, você deve especificar uma região ao criar um endereço IP externo estático e deve especificar uma zona ao criar uma instância de máquina virtual (VM).

Quando você cria um projeto, o Compute Engine seleciona automaticamente uma região e uma zona padrão com base no local onde você cria o projeto. O Compute Engine tenta escolher uma região e uma zona próximas de onde o projeto se origina, para que os recursos criados tenham latência reduzida para seus clientes. Se quiser criar recursos em uma região ou zona diferente, você poderá substituir a seleção padrão.

Para obter mais informações sobre regiões e zonas, consulte Regiões e zonas .

Para mais informações sobre recursos globais, regionais e zonais do Compute Engine, consulte Recursos globais, regionais e zonais .

Antes de começar

  • 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.

Como uma região e zona padrão afetam seu projeto

As configurações padrão de região e zona afetam apenas ferramentas de cliente, como a CLI do Google Cloud e o console do Google Cloud. Ao usar essas ferramentas para criar suas solicitações, elas 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ê. Você pode aceitar os valores pré-preenchidos ou alterar explicitamente um ou ambos os valores.

Ao usar a CLI gcloud, omita a configuração dos sinalizadores --region e --zone para usar as propriedades padrão de região e zona para o novo projeto.

Você sempre pode alterar as configurações padrão de região e zona no servidor de metadados, substituir a região e a zona padrão localmente para a CLI gcloud ou substituir as configurações manualmente para cada solicitação usando a CLI gcloud ou o console do Google Cloud.

Procurando 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. Você pode consultar o servidor de metadados para obter e usar informações sobre o projeto.

Se você especificar uma região e uma zona padrão para seu projeto, o Compute Engine definirá esses valores no servidor de metadados do seu projeto.

As regiões e zonas padrão são definidas usando os seguintes valores:

  • google-compute-default-region
  • google-compute-default-zone

Para ver quais são as configurações padrão de região e zona, execute o seguinte comando gcloud , substituindo PROJECT_ID pelo ID do projeto:

gcloud compute project-info describe --project PROJECT_ID

Procure os valores padrão de metadados de região e zona na resposta. Se as chaves e os valores google-compute-default-region e google-compute-default-zone estiverem faltando na resposta, isso significa que nenhuma região ou zona padrão está definida.

Alterando a região ou zona padrão

Não há restrições sobre quais regiões ou zonas você pode definir para suas 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 sua região ou zona padrão, siga estas etapas:

  1. No console do Google Cloud, acesse a página Configurações .

    Vá para Configurações

  2. No menu suspenso Região , selecione uma região padrão.

  3. No menu suspenso Zona , selecione uma zona padrão.

  4. Clique em Salvar .

gcloud

Você pode 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 padrão de região e zona somente depois que você executa o comando gcloud init .

Para obter 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 .

O que vem a seguir