Regiões

Uma região é a localização física onde o storage e o compute do seu projeto rodam. Você a escolhe uma vez, quando cria o projeto; todo branch e endpoint sob esse projeto a herda. Região é uma propriedade do projeto, não algo que você muda depois.

O catálogo de regiões

Estas são as regiões nas quais você pode criar projetos:

Um travessão significa que o catálogo ainda não carrega aquele campo.

GET /v1/regions retorna a mesma lista. Ele é autenticado — o mesmo bearer que lista os seus projetos lista o catálogo. A resposta é um único objeto:

{
  "regions": [
    {
      "region_id": "gcp-usc1-dev",
      "name": "gcp-usc1-dev",
      "default": true,
      "geo_lat": 0,
      "geo_long": 0
    }
  ]
}

Cada região carrega:

• region_id — o identificador estável que você passa ao criar um projeto.
• name — o rótulo de exibição. Ainda não existe coluna de nome de exibição, então ele repete region_id.
• default — se esta é a região que o console pré-seleciona.
• geo_lat / geo_long — coordenadas para seleção baseada em distância, 0 até o diretório carregar coordenadas reais.

Escolhendo uma região no momento da criação

No console web, New project tem um dropdown Region. Ele tem como padrão Auto (nearest), que deixa a escolha para o control plane. Para fixar uma região específica, selecione-a na lista.

Pela API, passe o campo opcional region em POST /v1/projects:

{ "name": "my-app", "region": "gcp-usc1-dev" }

Omita region (ou envie null) para o mesmo comportamento "auto" do padrão do console. Auto só é inequívoco enquanto existir exatamente uma região ativa: com mais de uma, uma criação que não nomeie região é recusada com region_required (422) em vez de o control plane adivinhar.

Disponibilidade de regiões

A tabela acima é gerada a partir do catálogo, não mantida à mão, então ela é aquilo em que você pode criar agora. Regiões são adicionadas conforme a demanda cresce. Nada muda no cliente quando uma entra no ar — o catálogo e o campo region já estão no lugar.

Relacionado

• Projetos — o contêiner para o qual uma região é escolhida.
• Branches — herdam a região do seu projeto.