Regionen

Eine Region ist der physische Ort, an dem der Speicher und das Compute Ihres Projekts laufen. Sie wählen sie einmal, wenn Sie das Projekt erstellen; jeder Branch und Endpoint unter diesem Projekt erbt sie. Die Region ist eine Eigenschaft des Projekts, nichts, das Sie später ändern.

Der Regionskatalog

Dies sind die Regionen, in denen Sie Projekte erstellen können:

Ein Geviertstrich bedeutet, dass der Katalog dieses Feld noch nicht führt.

GET /v1/regions gibt dieselbe Liste zurück. Er ist authentifiziert — derselbe Bearer, der Ihre Projekte auflistet, listet den Katalog. Die Antwort ist ein einzelnes Objekt:

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

Jede Region trägt:

• region_id — der stabile Bezeichner, den Sie beim Erstellen eines Projekts übergeben.
• name — das Anzeigelabel. Es gibt noch keine Anzeigenamen-Spalte, also wiederholt es region_id.
• default — ob dies die Region ist, die die Konsole vorauswählt.
• geo_lat / geo_long — Koordinaten für distanzbasierte Auswahl, 0 bis das Verzeichnis echte führt.

Eine Region zur Erstellungszeit wählen

In der Web-Konsole hat New project ein Region-Dropdown. Es ist standardmäßig auf Auto (nearest) gesetzt, was die Wahl der Control Plane überlässt. Um eine bestimmte Region festzulegen, wählen Sie sie aus der Liste.

Über die API übergeben Sie das optionale region-Feld bei POST /v1/projects:

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

Lassen Sie region weg (oder senden Sie null) für dasselbe „Auto"-Verhalten wie der Konsolenstandard. Auto ist nur eindeutig, solange genau eine Region aktiv ist: bei mehreren wird ein Create ohne Regionsangabe mit region_required (422) abgelehnt, statt dass die Control Plane rät.

Regionsverfügbarkeit

Die Tabelle oben wird aus dem Katalog generiert, nicht von Hand gepflegt — sie ist also das, worin Sie gerade jetzt erstellen können. Regionen kommen hinzu, wenn die Nachfrage wächst. Beim Client ändert sich nichts, wenn eine online geht — Katalog und region-Feld sind bereits vorhanden.

Verwandtes

• Projekte — der Container, für den eine Region gewählt wird.
• Branches — erben die Region ihres Projekts.