機密データの保護オペレーションを実行するリージョンを指定することで、機密データが処理される可能性のある場所を制御できます。このドキュメントでは、機密データの保護の処理を行うロケーションのコンセプトと、リージョンの指定方法について説明します。
サポートされているリージョンとマルチリージョンのリストについては、機密データの保護のロケーションをご覧ください。
リージョンとマルチリージョンについて
リージョンとは、特定の地理的な場所(北米西部や北東アジアなど)のことです。マルチリージョン ロケーション(または単に、マルチリージョン)とは、2 つ以上の地理的リージョンを含む広い地理的領域(欧州連合など)のことです。
ロケーションに関する留意事項
レイテンシ、可用性、帯域幅のコストのバランスがとれた場所が適切なロケーションになります。
リージョンを使用すると、レイテンシとネットワーク帯域幅の最適化に役立ちます。
Google ネットワークの外部にあり、広域に分散しているデータを処理する場合や、リージョン間の冗長化による高可用性を求める場合は、マルチリージョンを使用します。
通常、便利で、データを利用する大半のユーザーが含まれるロケーションでデータを処理する必要があります。
組織で転送中のデータを特定のリージョン内に保持する必要がある場合は、リージョン エンドポイント(REP)をサポートするリージョンのみを使用します。この場合、Google Cloud コンソールで機密データの保護のリージョン エンドポイントを使用できないため、Cloud Data Loss Prevention API を使用する必要があります。
リージョンを指定する
処理リージョンを指定する方法は、リクエストを送信するエンドポイントのタイプ(グローバル エンドポイントまたはリージョン エンドポイント)によって異なります。選択するエンドポイントのタイプは、転送中のデータを指定されたリージョン内に保持する必要があるかどうかによって異なります。詳細については、Sensitive Data Protection のグローバル エンドポイントとリージョン エンドポイントをご覧ください。
グローバル エンドポイントへのリクエストでリージョンを指定する
機密データの保護オペレーションを設定するときにリージョンを選択します。
たとえば、ジョブトリガーを作成するときに、次のように [リソース ロケーション] メニューからロケーションを選択します。

処理場所が問題にならない場合は、Global リージョンを使用すると、Google が処理を行うロケーションを選択します。Global はデフォルトのリージョン選択です。
リクエスト エンドポイントの URL にリージョン情報を挿入します。処理場所が問題にならない場合は、global
リージョンを使用すると、Google が処理を行うロケーションを選択します。global
リージョンを指定するリクエストによって作成されたリソースは、global
リージョンに保存されることに注意してください。
グローバル エンドポイントへのリクエストの例を次に示します。
グローバル リージョンを使用する
次の 2 つのリクエストの結果は同じです。リージョンを含めないことは、locations/global/
を指定することと同じです。
POST https://www.googleapis.com/dlp/v2/projects/PROJECT_ID /locations/global/content:inspect
POST https://www.googleapis.com/dlp/v2/projects/PROJECT_ID /content:inspect
特定のリージョンを使用する
データ処理するリージョンを指定するには、リソース URL 内に locations/
を挿入し、次にリージョン名を挿入します。
POST https://www.googleapis.com/dlp/v2/projects/PROJECT_ID /locations/us-west2/content:inspect
リージョン エンドポイントへのリクエストでリージョンを指定する
機密データの保護では、Google Cloud コンソールでリージョン エンドポイントを使用できません。
機密データの保護用のクライアント ライブラリをインストールして使用する方法については、機密データの保護のクライアント ライブラリをご覧ください。
機密データの保護のために認証するには、アプリケーションのデフォルト認証情報を設定します。 詳細については、ローカル開発環境の認証の設定をご覧ください。
機密データの保護用のクライアント ライブラリをインストールして使用する方法については、機密データの保護のクライアント ライブラリをご覧ください。
機密データの保護のために認証するには、アプリケーションのデフォルト認証情報を設定します。 詳細については、ローカル開発環境の認証の設定をご覧ください。
機密データの保護用のクライアント ライブラリをインストールして使用する方法については、機密データの保護のクライアント ライブラリをご覧ください。
機密データの保護のために認証するには、アプリケーションのデフォルト認証情報を設定します。 詳細については、ローカル開発環境の認証の設定をご覧ください。
次の例では、content.inspect
リクエストをリージョン エンドポイントに送信します。このリクエストに関連付けられたデータは、転送中、使用中、保存中も指定されたリージョンに保持されます。
リクエストのデータを使用する前に、次のように置き換えます。
-
REP_REGION
: 機密データ保護のリージョン エンドポイント(REP)を使用できるリージョン(例:us-west2
)。リージョンの一覧については、Sensitive Data Protection のロケーションをご覧ください。 -
PROJECT_ID
: プロジェクト ID。 Google Cloud プロジェクト ID は英数字からなる文字列です(例:example-project
)。
HTTP メソッドと URL:
POST https://dlp.REP_REGION .rep.googleapis.com/v2/projects/PROJECT_ID /locations/REP_REGION /content:inspect
リクエストの本文(JSON):
{ "inspectConfig": { "infoTypes": [ { "name": "CREDIT_CARD_NUMBER" } ] }, "item": { "value": "hi, my ccn is 4111111111111111" } }
リクエストを送信するには、次のいずれかのオプションを展開します。
curl(Linux、macOS、Cloud Shell)
リクエスト本文を inspect-request.json
という名前のファイルに保存して、次のコマンドを実行します。
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "x-goog-user-project:PROJECT_ID " \
-H "Content-Type: application/json; charset=utf-8" \
-d @inspect-request.json \
"https://dlp.REP_REGION .rep.googleapis.com/v2/projects/PROJECT_ID /locations/REP_REGION /content:inspect"
PowerShell(Windows)
リクエスト本文を inspect-request.json
という名前のファイルに保存して、次のコマンドを実行します。
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_ID " }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile inspect-request.json `
-Uri "https://dlp.REP_REGION .rep.googleapis.com/v2/projects/PROJECT_ID /locations/REP_REGION /content:inspect" | Select-Object -Expand Content
次のような JSON レスポンスが返されます。
{ "result": { "findings": [ { "infoType": { "name": "CREDIT_CARD_NUMBER", "sensitivityScore": { "score": "SENSITIVITY_HIGH" } }, "likelihood": "LIKELY", "location": { "byteRange": { "start": "14", "end": "30" }, "codepointRange": { "start": "14", "end": "30" } }, "createTime": "2024-08-09T19:54:13.348Z", "findingId": "2024-08-09T19:54:13.352163Z4747901452516738787" } ] } }
コロケーションに関する留意事項
Cloud Storage や BigQuery などのストレージ リポジトリをスキャンする場合は、スキャンするリポジトリのロケーションと同じロケーションを機密データの保護リクエストで指定する必要があります。たとえば、BigQuery データセットが欧州連合のマルチリージョン ロケーションにある場合は、機密データの保護ジョブを構成するときに欧州連合のマルチリージョン(europe
)を指定します。
機密データの保護リクエストをスキャン対象のストレージ リポジトリと同じ場所に配置しない場合、リクエストの処理はデータのロケーションとリクエストで指定されたロケーションに分割されます。
次のステップ
- 地理とゾーンについて学習する。
- サポートされているリージョンとマルチリージョンのリストをご覧ください。
- Sensitive Data Protection のグローバル エンドポイントとリージョン エンドポイントの詳細を確認する。