Google Cloud API エンドポイントの概要

API エンドポイント（またはサービス エンドポイント）は、サービスのネットワーク アドレス（ Google Cloud API サービス（bigquery.googleapis.comなど））を指定する URL です。 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：リージョン名（ Google Cloud us-central1 、europe-west1など）。

プライベート リージョン API エンドポイントの形式は次のとおりです。

SERVICE.REGION.p.rep.googleapis.com

  • SERVICE: Google Cloud サービスの名前（ storage、compute、bigquery など）。
  • REGION：リージョン名（ Google Cloud us-central1 、europe-west1など）。
  • .p.: Private Service Connect 接続用のプライベート ターゲットを示します。

マルチリージョン エンドポイント

マルチリージョン API エンドポイントは、 Google Cloud 同じ国（米国、インド、カナダなど）または管轄区域（ 欧州連合など）内の Google Cloud リージョンのセットにスコープ設定された API エンドポイントを介して サービスへのアクセスを提供します。マルチリージョン エンドポイントに送信されたトラフィックは、指定された管轄区域内で処理され、TLS が終端されます。

ほとんどの Google Cloud サービスでは、マルチリージョン エンドポイントを使用して、指定されたマルチリージョン内のマルチリージョン リソースを操作できます 。通常、グローバル リソース、リージョン リソース、他の管轄区域のマルチリージョン リソースに対するオペレーションはサポートされていません。

マルチリージョン API エンドポイントは、管轄区域をサブドメインとして指定します。パブリック マルチリージョン エンドポイントの形式は次のとおりです。

SERVICE.MULTI_REGION.rep.googleapis.com

  • SERVICE: Google Cloud サービスの名前（ storage、compute、bigquery など）。
  • MULTI_REGION: マルチリージョン名（ us、eu など）。 Google Cloud

プライベート マルチリージョン API エンドポイントの形式は次のとおりです。

SERVICE.MULTI_REGION.p.rep.googleapis.com

  • SERVICE: Google Cloud サービスの名前（ storage、compute、bigquery など）。
  • MULTI_REGION: マルチリージョンの Google Cloud 名前（ us、eu など）。
  • .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: リージョン名（ us-central1、europe-west1、usなど）。 Google Cloud
  • SERVICE: Google Cloud サービスの名前（ storage、compute、bigquery など）。

リファレンス ドキュメント

次のステップ