Google Cloud API 엔드포인트 개요

API 엔드포인트 또는 서비스 엔드포인트는 Google Cloud API 서비스의 네트워크 주소를 지정하는 URL입니다. 예를 들면 bigquery.googleapis.com입니다. Google Cloud 서비스를 사용하면 리전, 멀티 리전, 전역, 위치를 비롯한 다양한 유형의 API 엔드포인트를 사용하여 리소스에 액세스할 수 있습니다. 각 엔드포인트 유형에 대한 지원은 서비스에 따라 다릅니다.

이 문서에서는 각 엔드포인트 유형을 간략하게 설명하여 엔드포인트 유형 간의 차이점을 명확히 하고 사용할 엔드포인트 유형에 대한 안내를 제공합니다.

리전 엔드포인트

리전 API 엔드포인트는 단일 Google Cloud 리전으로 범위가 지정된 API 엔드포인트를 통해서비스에 대한 액세스를 제공합니다. Google Cloud 리전 엔드포인트로 전송된 트래픽은 지정된 리전 내에서 완전히 처리되고 TLS가 종료됩니다.

대부분의 Google Cloud 서비스에서 리전 엔드포인트를 사용하여 지정된 리전 내의 리전 리소스를 사용할 수 있습니다. 전역 리소스, 멀티 리전 리소스, 리전 외 리전 리소스에 대한 작업은 일반적으로 리전 엔드포인트에서 지원되지 않습니다.

리전 API 엔드포인트는 위치를 하위 도메인으로 지정합니다. 공개 리전 엔드포인트의 형식은 다음과 같습니다.

SERVICE.REGION.rep.googleapis.com

  • SERVICE: 서비스 이름(예: Google Cloud , storage, compute, bigquery)
  • REGION: 리전 이름(예: us-central1 또는 europe-west1) Google Cloud

비공개 리전 API 엔드포인트의 형식은 다음과 같습니다.

SERVICE.REGION.p.rep.googleapis.com

  • SERVICE: 서비스 이름(예: Google Cloud , storage, compute, bigquery)
  • REGION: 리전 이름(예: us-central1 또는 europe-west1) Google Cloud
  • .p.: Private Service Connect 연결을 위한 비공개 대상을 나타냅니다.

멀티 리전 엔드포인트

멀티 리전 API 엔드포인트는 미국, 인도, 캐나다와 같은 동일한 국가 내의 리전 집합 또는 유럽연합과 같은 관할권으로 범위가 지정된 API 엔드포인트를 통해서비스에 대한 액세스를 제공합니다. Google Cloud Google Cloud 멀티 리전 엔드포인트로 전송된 트래픽은 지정된 관할권 내에서 완전히 처리되고 TLS가 종료됩니다.

대부분의 Google Cloud 서비스에서 멀티 리전 엔드포인트를 사용하여 지정된 멀티 리전 내의 멀티 리전 리소스를 사용할 수 있습니다. 전역 리소스, 리전 리소스, 다른 관할권의 멀티 리전 리소스에 대한 작업은 일반적으로 지원되지 않습니다.

멀티 리전 API 엔드포인트는 관할권을 하위 도메인으로 지정합니다. 공개 멀티 리전 엔드포인트의 형식은 다음과 같습니다.

SERVICE.MULTIREGION.rep.googleapis.com

  • SERVICE: 서비스 이름(예: Google Cloud , storage, compute, bigquery)
  • MULTIREGION: 멀티 리전 이름(예: us 또는 eu) Google Cloud

비공개 멀티 리전 API 엔드포인트의 형식은 다음과 같습니다.

SERVICE.MULTIREGION.p.rep.googleapis.com

  • SERVICE: 서비스 이름(예: Google Cloud , storage, compute, bigquery)
  • MULTIREGION: 멀티 리전 이름(예: us, eu) Google Cloud
  • .p.: Private Service Connect 연결을 위한 비공개 대상을 나타냅니다.

전역 엔드포인트

전역 API 엔드포인트는 URL 호스트 이름에서 위치를 지정하지 않습니다. 이러한 전역 범위 엔드포인트는 가능한 한 클라이언트와 가까운 곳에서 TLS 세션을 종료하는 고가용성 서비스 엔드포인트를 제공하므로 인터넷을 통해 분산된 클라이언트 집합에서 API 호출을 제공할 때 지연 시간을 최소화합니다. 하지만 이러한 엔드포인트는 리전 격리 또는 데이터 상주 규정 준수를 제공하지 않습니다.

전역 종속 항목을 처리할 수 있고 Google의 글로벌 네트워크에서 빠른 성능이 필요한 애플리케이션의 경우 전역 엔드포인트를 사용할 수 있습니다.

전역 엔드포인트의 형식은 다음과 같습니다.

SERVICE.googleapis.com

여기서 SERVICE는 Google Cloud 서비스 이름(예: storage, compute, 또는 bigquery)입니다.

위치 엔드포인트

리전 API 엔드포인트가 위치 엔드포인트를 대체하고 있습니다. 위치 엔드포인트는 특정 위치의 데이터에 액세스하는 데 사용할 수 있는 리전 또는 멀티 리전 서비스 호스트 이름입니다.

하지만 위치 엔드포인트는 다음 기능을 지원하지 않습니다.

  • 인터넷을 통한 온프레미스의 데이터 상주 규정 준수 연결
  • 장애 도메인 격리

위치 엔드포인트는 URL 호스트 이름에서 위치를 지정하며 형식은 다음과 같습니다.

LOCATION-SERVICE.googleapis.com

  • LOCATION: Google Cloud 리전 이름(예: us-central1, europe-west1, us)
  • SERVICE: 서비스 이름(예: Google Cloud , storage, compute, bigquery)

참조 문서

다음 단계