Sensitive Data Protection のグローバル エンドポイントとリージョン エンドポイント

このドキュメントでは、Sensitive Data Protection で使用できるさまざまなタイプの API エンドポイントについて説明します。また、Sensitive Data Protection リクエストで使用するエンドポイントのタイプを決定する際に考慮すべき点についても説明します。さまざまなタイプの API エンドポイントの概要については、 Google Cloud API エンドポイントの概要をご覧ください。

API エンドポイント（またはサービス エンドポイント）は、Sensitive Data Protection などの API サービスのネットワーク アドレスを指定するベース URL です。 Google Cloud Sensitive Data Protection には、グローバル エンドポイントとリージョン エンドポイントがあります。

グローバル API エンドポイント

Sensitive Data Protection のグローバル エンドポイントは dlp.googleapis.com です。

グローバル スコープのエンドポイントは、可能な限りクライアントに近い場所で TLS セッションを終端する高可用性サービス エンドポイントを提供します。これにより、分散したクライアント群からのインターネット経由での API 呼び出しを処理する際のレイテンシを最小限に抑えることができます。

グローバル エンドポイントにリクエストを送信するときに、リクエストを処理するロケーションを指定できます。

ロケーションが指定されていないグローバル エンドポイントへのリクエスト

リクエストでロケーションを指定しない場合、または global リージョンを指定した場合、リクエストは global リージョンで処理されます。たとえば、次の URL に POST リクエストを送信すると、リクエストはグローバル エンドポイントに送信され、global リージョンで処理されます。

https://dlp.googleapis.com/v2/projects/example-project/content:inspect

ロケーションが指定されているグローバル エンドポイントへのリクエスト

グローバル エンドポイントへのリクエストでロケーションを指定すると、リクエストはグローバル エンドポイントに送信され、指定したリージョンまたはマルチリージョンで処理されます。 たとえば、次の URL に POST リクエストを送信すると、リクエストはグローバル エンドポイントに送信され、us-west1 リージョンで処理されます。

https://dlp.googleapis.com/v2/projects/example-project/locations/us-west1/content:inspect

転送中のデータが指定した処理リージョンに保持される保証はありません。転送中のデータを特定のリージョンに保持する必要がない場合は、この方法でグローバル エンドポイントを呼び出すだけで十分です。

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

リージョン エンドポイントを使用すると、転送中のデータを特定のリージョンに保持できます。リージョン エンドポイントは、ロケーションをサブドメインとして指定します（例: dlp.us-west1.rep.googleapis.com）。

Sensitive Data Protection のリージョン エンドポイントは次の形式です。

dlp.REGION.rep.googleapis.com

REGION を、Sensitive Data Protection で使用できる リージョン エンドポイント に置き換えます。

リージョン エンドポイントは、パブリック インターネットまたはプライベート接続から受信したリクエストに対して、エンドポイントで指定されたロケーションで TLS セッションを終端します。

リージョンエンドポイントは、データ 所在地を、保存中、使用中、転送中のデータが エンドポイントで指定されたロケーションから移動しないようにすることで保証します。この保証にはサービスデータは含まれません。詳細については、 顧客データとサービス データに関する注意事項をご覧ください。

グローバル エンドポイントとリージョン エンドポイントのどちらかを選択する

グローバル エンドポイントとリージョン エンドポイントのどちらかを選択する際は、次の点を考慮してください。

  • 組織で保存データ、使用中、転送中のデータを特定のリージョンに保持する必要がある場合は、リージョン エンドポイントを使用する必要があります。転送中のデータを特定のリージョンに保持する必要がない場合は、グローバル エンドポイントを使用できます。

  • リージョン エンドポイントは、限られた数のロケーションでサポートされています。Sensitive Data Protection が利用可能なリージョンとマルチリージョンの完全な リストについては、Sensitive Data Protection のロケーションをご覧ください。

  • Sensitive Data Protection には、次のものに対して個別の 割り当てセットがあります。

    • ロケーションが指定されていないグローバル エンドポイントへのリクエスト（global リージョンで処理）
    • 処理ロケーションが指定されているグローバル エンドポイントへのリクエスト（指定されたリージョンで処理）
    • リージョン エンドポイントへのリクエスト

    リージョン エンドポイントの割り当ては、他の 2 つの割り当てよりも少なくなります。

  • クライアント アプリケーションがグローバル エンドポイントを使用するように構成されていて、リージョン エンドポイントの使用を開始する場合は、リクエストで使用する各ホスト名のサブドメインとパスでリージョンまたはマルチリージョンを指定するようにクライアント アプリケーションを構成する必要があります。詳細については、リージョン エンドポイントへのリクエストでリージョンを指定する をご覧ください。

グローバル API エンドポイントの使用を制限する

リージョナル エンドポイントの使用を強制するには、constraints/gcp.restrictEndpointUsage 組織のポリシーの制約を使用して、グローバル API エンドポイントへのリクエストをブロックします。詳細については、Assured Workloads ドキュメントの エンドポイントの使用を制限するをご覧ください。

次のステップ