このページは Cloud Translation API によって翻訳されました。

Apigee ハイブリッドでのデータ所在地の使用

このトピックでは、データ所在地のコンプライアンスのために新しい Apigee ハイブリッドインストールを構成する方法について説明します。

データ所在地について

ハイブリッドバージョン 1.12 以降では、新しい Apigee ハイブリッドインストールでデータ所在地を使用できます。データ所在地を使用するように既存のインストールを変換することはできません。

データ所在地では、コンプライアンスと規制の要件を満たせるよう、Apigee データが保存される地理的位置（リージョン）をユーザーが指定できるようになっています。データ所在地でコントロールプレーンのロケーションを選択すると、お客様のすべてのコンテンツが指定されたリージョンに保存されます。データ所在地の概要もご覧ください。

データ所在地の構成の基本手順

データ所在地用に Apigee ハイブリッドを構成するには、次の基本順を実施する必要があります。

データ所在地を指定して Apigee 組織を作成する
Apigee API を使用して環境を作成する
新しいデータパイプラインを有効にする
オーバーライドファイルを構成する

データ所在地を指定して Apigee 組織を作成する

Apigee 組織を作成するときに、データ所在地を指定して組織を有効にできます。データ所在地を指定して組織を作成するには、コントロールプレーンのロケーションとコンシューマーデータリージョンの 2 つの主要なロケーション属性を指定する必要があります。また、課金タイプも指定する必要があります。詳細については、ステップ 2: 組織を作成するをご覧ください。

コントロールプレーンのロケーション: プロキシバンドルなどのお客様のコアコンテンツが保存されるロケーションを指定する必要があります。リストについては、使用可能な Apigee API コントロールプレーンのリージョンをご覧ください。

コントロールプレーンのロケーションは、サービスエンドポイントのロケーションです（米国の場合は us など）。

次の表に、Apigee コントロールプレーンで使用可能なホスティング法域とリージョンを示します。

南北アメリカ

コントロールプレーンのホスティング法域の説明	コントロールプレーンのホスティング法域の名前	詳細
米国	`us (multiple regions in United States)`	サービスエンドポイント: `us-apigee.googleapis.com`
カナダ	`ca (multiple regions in Canada)`	サービスエンドポイント: `ca-apigee.googleapis.com`

消費者データリージョンの説明	消費者データリージョン名	詳細
アイオワ	`us-central1`	低 CO₂
オレゴン	`us-west1`	低 CO₂
ロサンゼルス	`us-west2`
ソルトレイクシティ	`us-west3`
ラスベガス	`us-west4`
サウスカロライナ	`us-east1`
北バージニア	`us-east4`
コロンバス	`us-east5`
ダラス	`us-south1`
モントリオール	`northamerica-northeast1`	低 CO₂
トロント	`northamerica-northeast2`	低 CO₂

ヨーロッパ

コントロールプレーンのホスティング法域の説明	コントロールプレーンのホスティング法域の名前	詳細
EU	`eu (multiple regions in the European Union)`	サービスエンドポイント: `eu-apigee.googleapis.com`
ドイツ	`de (multiple regions in Germany)`	サービスエンドポイント: `de-apigee.googleapis.com`
フランス	`fr (single region europe-west9)`	サービスエンドポイント: `fr-apigee.googleapis.com`
スイス	`ch (single region europe-west6)`	サービスエンドポイント: `ch-apigee.googleapis.com`

消費者データリージョンの説明	消費者データリージョン名	詳細
ベルギー	`europe-west1`	低 CO₂
フランクフルト	`europe-west3`	低 CO₂
オランダ	`europe-west4`
チューリッヒ	`europe-west6`	低 CO₂
ミラノ	`europe-west8`
パリ	`europe-west9`	低 CO₂
トリノ	`europe-west12`
ワルシャワ	`europe-central2`
マドリッド	`europe-southwest1`	低 CO₂
フィンランド	`europe-north1`	低 CO₂

アジア太平洋

コントロールプレーンのホスティング法域の説明	コントロールプレーンのホスティング法域の名前	詳細
オーストラリア	`au (multiple regions in Australia)`	サービスエンドポイント: `au-apigee.googleapis.com`
インド	`in (multiple regions in India)`	サービスエンドポイント: `in-apigee.googleapis.com`
日本	`jp (multiple regions in Japan)`	サービスエンドポイント: `jp-apigee.googleapis.com`

消費者データリージョンの説明	消費者データリージョン名	詳細
シドニー	`australia-southeast1`
メルボルン	`australia-southeast2`
ムンバイ	`asia-south1`
デリー	`asia-south2`
東京	`asia-northeast1`
大阪	`asia-northeast2`

中東

コントロールプレーンのホスティング法域の説明	コントロールプレーンのホスティング法域の名前	詳細
サウジアラビア	`sa (single region me-central2)`	サービスエンドポイント: `sa-apigee.googleapis.com`
イスラエル	`il (single region me-west1)`	サービスエンドポイント: `il-apigee.googleapis.com`

消費者データリージョンの説明	消費者データリージョン名	詳細
ダンマーム	`me-central2`
テルアビブ	`me-west1`

コンシューマーデータのリージョン: API コンシューマーデータが保存されるリージョンを指定する必要があります。これは、コントロールプレーンリージョンのサブリージョンにする必要があります。使用可能なコンシューマーデータリージョンのリストについては、Apigee のロケーションをご覧ください。
課金タイプ: データ所在地は、有料サブスクリプション組織でのみ使用できます。

Apigee API を使用して環境を作成する

Apigee API を使用して新しい環境を作成する場合は、コントロールプレーンのロケーションを指定する必要があります。環境を作成するをご覧ください。UI を使用して環境を作成する場合、特別な手順は必要ありません。

新しいデータパイプラインを有効にする

新しい組織でデータ所在地が有効になっている場合は、新しいデータパイプライン機能を有効にする必要があります。この機能を使用すると、アナリティクスデータとデバッグデータを Apigee コントロールプレーンに送信できます。データパイプラインを有効にするには、データ所在地によるアナリティクスデータとデバッグデータの収集の手順を実施します。

変更をオーバーライドして新しいデータパイプラインを有効にする

次の構成プロパティを各オーバーライドファイルに追加して適用します。

contractProvider: Apigee の管理用 API のサービスエンドポイント。例: https://us-apigee.googleapis.com。
newDataPipeline.debugSession: 新しいデータパイプラインを使用するには、これを true に設定します。
newDataPipeline.analytics: アナリティクスで新しいデータパイプラインを使用できるようにするには、これを true に設定します。

次に例を示します。

instanceID: "my_hybrid_example"
namespace: apigee

gcp:
  projectID: hybrid-example
  region: us-central1

k8sCluster:
  name: apigee-hybrid
  region: us-central1

org: hybrid-example

contractProvider: https://us-apigee.googleapis.com
newDataPipeline:
  debugSession: true
  analytics: true

ステップ 6: オーバーライドを作成するをご覧ください。

Apigee API を呼び出す場合

ハイブリッドインストールでタスクを実行するために Apigee API に対して curl 呼び出しを行う場合、コントロールプレーンのロケーション内から API を呼び出す必要があります。

curl -H "Authorization: Bearer $TOKEN" \
  "https://CONTROL_PLANE_LOCATION-apigee.googleapis.com/v1/organizations/ORG_NAME/envgroups"

次に例を示します。

curl -H "Authorization: Bearer $TOKEN" \
  "https://us-apigee.googleapis.com/v1/organizations/my-hybrid-org/envgroups"

URL 許可リスト

データ所在地を指定して転送プロキシを使用している場合は、転送プロキシで次のものを許可リストに登録する必要があります。

CONTROL_PLANE_LOCATION.apigee-googleapis.com
ANALYTICS_REGION-pubsub.googleapis.com
Apigee ハイブリッドで必要な URL。ハイブリッドを可能にする Google Cloud URL をご覧ください。

データ所在地によるアナリティクスデータとデバッグデータの収集を有効にする

アナリティクスデータとデバッグデータの収集を有効にするには、データ所在地によるアナリティクスデータとデバッグデータの収集の手順を実施します。