위치 엔드포인트

이 페이지에서는 위치 엔드포인트를 사용하여 Cloud Storage에 액세스하는 방법을 설명합니다. 위치 엔드포인트를 사용하는 경우 저장 데이터가 관할권 내에 있도록 데이터 상주 요구사항을 충족할 수 있습니다.

개요

위치 엔드포인트는 영향을 받는 리소스가 엔드포인트에서 지정된 위치에 있는 경우에만 요청 처리를 허용하는 요청 엔드포인트입니다. 예를 들어 버킷 삭제 요청에서 엔드포인트 https://us-central1-storage.googleapis.com을 사용하는 경우 버킷이 US-CENTRAL1에 있는 경우에만 요청이 진행됩니다.

리소스가 있는 곳과 다른 위치에서 요청을 처리할 수 있는 전역 엔드포인트와 달리 위치 엔드포인트는 리소스가 있는 엔드포인트에서 지정한 위치 내에서 요청이 처리되도록 보장합니다.

위치 엔드포인트를 사용하면 다음을 보장할 수 있습니다.

  • Cloud Storage에 저장된 데이터는 지정된 위치를 벗어나지 않습니다.

  • 데이터는 온프레미스에서 Google Cloud로 전송될 때 엔드포인트에서 지정한 리전에서 종료됩니다.

위치 엔드포인트를 사용할 경우 다음 책임을 집니다.

  • 데이터 상주 보증을 얻기 위해서는 위치 엔드포인트에 대한 요청이 엔드포인트에서 지정한 동일한 위치에서 시작되어야 합니다. 예를 들어 Compute Engine 가상 머신을 사용하여 us-central1-storage.googleapis.com 엔드포인트를 통해 US-CENTRAL1에 상주하는 버킷에 대한 요청을 수행하는 경우 가상 머신도 US-CENTRAL1에 상주해야 합니다.

  • 위치 엔드포인트는 지원되는 작업을 수행할 때만 사용해야 합니다. 지원되지 않는 작업을 수행하면 오류가 발생합니다.

위치 엔드포인트는 상호 연결 또는 VPN을 통해 온프레미스에서 Google Cloud 로의 트래픽과 Google Cloud 서비스 간 트래픽을 지원합니다(예: BigQuery에서 Cloud Storage로). 인터넷 트래픽은 지원되지 않습니다.

지원되는 작업

다음 표에는 위치 엔드포인트로 실행할 수 있는 작업과 실행할 수 없는 작업이 요약되어 있습니다. 일반적으로 위치 내 작업은 위치 엔드포인트로 실행할 수 있지만 교차 위치 작업은 실행할 수 없습니다.

위치 엔드포인트를 사용하여 지원되지 않는 작업을 수행하려고 시도하면 Cloud Storage는 다음 메시지와 함께 400 HTTP 오류 코드를 반환합니다. "The endpoint does not implement this operation. Please use the global endpoint."

작업 객