Regiones

Una región es la ubicación física en la que se ejecutan el almacenamiento y el cómputo de su proyecto. La elige una vez, cuando crea el proyecto; cada rama y endpoint bajo ese proyecto la hereda. La región es una propiedad del proyecto, no algo que cambie más tarde.

El catálogo de regiones

Estas son las regiones en las que puede crear proyectos:

Una raya indica que el catálogo aún no lleva ese campo.

GET /v1/regions devuelve la misma lista. Está autenticado — el mismo bearer que lista sus proyectos lista el catálogo. La respuesta es un único objeto:

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

Cada región lleva:

• region_id — el identificador estable que pasa al crear un proyecto.
• name — la etiqueta de visualización. Todavía no hay columna de nombre visible, así que repite region_id.
• default — si esta es la región que la consola preselecciona.
• geo_lat / geo_long — coordenadas para la selección basada en distancia, a 0 mientras el directorio no lleve unas reales.

Elegir una región en el momento de crear

En la consola web, New project tiene un desplegable Region. Usa por defecto Auto (nearest), que deja la elección al plano de control. Para fijar una región específica, selecciónela de la lista.

Por la API, pase el campo opcional region en POST /v1/projects:

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

Omita region (o envíe null) para el mismo comportamiento "auto" que el predeterminado de la consola. Auto solo es inequívoco mientras haya exactamente una región activa: con más de una, una creación que no nombre región se rechaza con region_required (422) en lugar de que el plano de control lo adivine.

Disponibilidad de regiones

La tabla de arriba se genera desde el catálogo, no se mantiene a mano, así que es aquello en lo que puede crear ahora mismo. Se añaden regiones a medida que crece la demanda. Nada cambia en el cliente cuando una entra en línea: el catálogo y el campo region ya están en su sitio.

Relacionado

• Proyectos — el contenedor para el que se elige una región.
• Ramas — heredan la región de su proyecto.