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

API エンドポイント（またはサービス エンドポイント）は、サービスのネットワーク アドレス（bigquery.googleapis.com など）を指定する URL です。 Google Cloud Google Cloud サービスでは、リージョン、マルチリージョン、グローバル、ロケーションなど、さまざまな種類の API エンドポイントを使用してリソースにアクセスできます。各タイプのエンドポイントのサポートはサービスによって異なります。

このドキュメントでは、各タイプのエンドポイントについて簡単に説明し、その違いと、使用するエンドポイントのタイプに関するガイダンスを提供します。

リージョン エンドポイント

リージョン API エンドポイントは、単一の リージョンをスコープとする API エンドポイントを介して Google Cloud サービスへのアクセスを提供します。 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 エンドポイントは、米国、インド、カナダなどの同じ国内の リージョンセット、または欧州連合などの地域の適用法令をスコープとする 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: リージョン名（ us-central1、europe-west1、usなど）。 Google Cloud
  • SERVICE: Google Cloud サービスの名前（ storage、compute、bigquery など）。

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

次のステップ