Régions

Une région est l'emplacement physique où tournent le stockage et le calcul de votre projet. Vous la choisissez une fois, à la création du projet ; chaque branche et endpoint sous ce projet en hérite. La région est une propriété du projet, pas quelque chose que vous changez plus tard.

Le catalogue de régions

Voici les régions dans lesquelles vous pouvez créer des projets :

Un tiret cadratin signifie que le catalogue ne porte pas encore ce champ.

GET /v1/regions renvoie la même liste. Il est authentifié — le même bearer qui liste vos projets liste le catalogue. La réponse est un objet unique :

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

Chaque région porte :

• region_id — l'identifiant stable que vous passez à la création d'un projet.
• name — le libellé d'affichage. Il n'existe pas encore de colonne de nom d'affichage, donc il répète region_id.
• default — indique s'il s'agit de la région présélectionnée par la console.
• geo_lat / geo_long — coordonnées pour la sélection basée sur la distance, à 0 tant que l'annuaire n'en porte pas de réelles.

Choisir une région à la création

Dans la console web, New project a une liste déroulante Region. Elle a pour défaut Auto (nearest), qui laisse le choix au plan de contrôle. Pour épingler une région spécifique, sélectionnez-la dans la liste.

Via l'API, passez le champ optionnel region sur POST /v1/projects :

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

Omettez region (ou envoyez null) pour le même comportement « auto » que le défaut de la console. Auto n'est sans ambiguïté que tant qu'exactement une région est active : au-delà, une création qui ne nomme aucune région est rejetée avec region_required (422) plutôt que devinée par le plan de contrôle.

Disponibilité des régions

Le tableau ci-dessus est généré depuis le catalogue, pas maintenu à la main : c'est donc ce dans quoi vous pouvez créer à l'instant. Des régions s'ajoutent à mesure que la demande croît. Rien ne change côté client quand l'une est mise en ligne — le catalogue et le champ region sont déjà en place.

Liens connexes

• Projets — le conteneur pour lequel une région est choisie.
• Branches — héritent de la région de leur projet.