リージョン

プロジェクトのストレージとコンピュートが存在する場所。

リージョン は、プロジェクトのストレージとコンピュートが動作する物理的な場所です。プロジェクトを作成するときに一度だけ選びます。そのプロジェクトの下のすべてのブランチとエンドポイントがそれを継承します。リージョンはプロジェクトのプロパティであり、後で変更するものではありません。

リージョンカタログ

プロジェクトを作成できるリージョンは次のとおりです。

region_id	name	default	geo
gcp-usc1-dev	—	default	—

em ダッシュは、カタログがそのフィールドをまだ保持していないことを意味します。

GET /v1/regions は同じ一覧を返します。これは認証済みです — プロジェクトを一覧するのと同じベアラーがカタログを一覧します。レスポンスは単一のオブジェクトです。

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

各リージョンは次を持ちます。

region_id — プロジェクトを作成するときに渡す安定した識別子。
name — 表示ラベル。表示名の列はまだないため、region_id と同じ値になります。
default — コンソールが既定で選択するリージョンかどうか。
geo_lat / geo_long — 距離ベースの選択のための座標。ディレクトリが実際の値を持つまでは 0 です。

作成時のリージョンの選択

Web コンソールでは、New project に Region ドロップダウンがあります。デフォルトは Auto (nearest) で、選択をコントロールプレーンに委ねます。特定のリージョンに固定するには、リストから選んでください。

API 経由では、POST /v1/projects に任意の region フィールドを渡します。

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

コンソールのデフォルトと同じ「auto」の振る舞いにするには、region を省略します（または null を送ります）。auto が一意に決まるのは、アクティブなリージョンがちょうど 1 つのあいだだけです。2 つ以上ある場合、リージョンを指定しない作成はコントロールプレーンが推測せず region_required（422）で拒否されます。