리전

리전은 프로젝트의 스토리지와 컴퓨트가 실행되는 물리적 위치입니다. 프로젝트를 생성할 때 한 번 고르며, 그 프로젝트 아래의 모든 브랜치와 엔드포인트가 이를 상속합니다. 리전은 프로젝트의 속성이며, 나중에 변경하는 것이 아닙니다.

리전 카탈로그

프로젝트를 생성할 수 있는 리전은 다음과 같습니다:

엠 대시는 카탈로그가 아직 그 필드를 담고 있지 않다는 뜻입니다.

GET /v1/regions는 같은 목록을 반환합니다. 이것은 인증됩니다 — 프로젝트를 나열하는 동일한 bearer가 카탈로그를 나열합니다. 응답은 단일 객체입니다:

{
  "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입니다.

생성 시 리전 선택

웹 콘솔에서 새 프로젝트에는 리전 드롭다운이 있습니다. **자동(가장 가까운 곳)**으로 기본 설정되며, 이는 선택을 컨트롤 플레인에 맡깁니다. 특정 리전을 고정하려면 목록에서 선택하세요.

API를 통해서는 POST /v1/projects에 선택적 region 필드를 전달하세요:

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

콘솔 기본값과 동일한 "자동" 동작을 원하면 region을 생략하세요(또는 null을 보내세요). 자동이 모호하지 않은 것은 활성 리전이 정확히 하나일 때뿐입니다. 둘 이상이면 리전을 지정하지 않은 생성은 컨트롤 플레인이 추측하지 않고 region_required(422)로 거부됩니다.

리전 가용성

위 표는 카탈로그에서 생성되며 손으로 관리하지 않습니다. 따라서 지금 실제로 생성할 수 있는 대상 그대로입니다. 리전은 수요가 커지면 추가됩니다. 새 리전이 가동되어도 클라이언트에서 바뀌는 것은 없습니다 — 카탈로그와 region 필드는 이미 자리 잡고 있습니다.

관련 문서

• 프로젝트 — 리전이 선택되는 컨테이너.
• 브랜치 — 프로젝트의 리전을 상속합니다.