AML AI インスタンスの登録済み当事者は、同じ Google Cloud リージョン内の最大 2 つの追加インスタンスと予測用に共有できます。これにより、組織は AML アラートの生成に使用するメインの AML AI インスタンスのパフォーマンスに影響を与えることなく、同じ当事者の登録に 2 回支払うことなく、実際のデータでモデルをトレーニングできます。
メインの AML AI インスタンスは、当事者を登録するホストです。コンシューマーと呼ばれる追加のインスタンスは、パーティを登録する必要はありません。代わりに、ホスト インスタンスに登録されている任意の当事者の予測を生成できます。通常、これらのインスタンスは、メイン インスタンスにデプロイする前に新しいモデルをトレーニングして評価するなど、重要度の低いタスクに使用されます。
始める前に
ホストとして使用するインスタンスを選択します。通常、これは本番環境アラートの生成に使用するインスタンスです。
コンシューマーとして使用するインスタンスを 1 つまたは 2 つ選択します。これらは通常、AML AI モデルの作成、評価、分析に使用するインスタンスです。
ホスト インスタンスとコンシューマー インスタンスは、同じ Google Cloud リージョンに存在し、同じ組織内の同じプロジェクトまたはプロジェクトに属している必要があります。
ホスト インスタンスを構成する
登録共有のホスト インスタンスになるようにインスタンスを構成するには、valid_party_registration_sharing_consumer_instances フィールドで最大 2 つのインスタンスを選択したコンシューマー インスタンスとして指定します。
このフィールドは、ホスト インスタンスを作成するときに設定できます。また、projects.locations.instances.patch リクエストを使用して、既存のインスタンスでこのフィールドを更新することもできます。
このフィールドは文字列リストで、最大長は 2 です。
リクエストのデータを使用する前に、次のように置き換えます。
- LOCATION: ホスト インスタンスとコンシューマー インスタンスのロケーション。
- HOST_PROJECT_ID: ホスト インスタンスを含むプロジェクトのユーザー定義の識別子。
- HOST_INSTANCE_ID: ホスト インスタンスのユーザー定義の識別子。
- CONSUMER_PROJECT_ID: コンシューマー インスタンスを含むプロジェクトのユーザー定義の識別子。
- CONSUMER_INSTANCE_ID: コンシューマー インスタンスのユーザー定義の識別子。
リクエスト本文を request.json という名前のファイルに保存します。ターミナルで次のコマンドを実行して、このファイルを現在のディレクトリに作成または上書きします。
cat > request.json << 'EOF'
{
"valid_party_registration_sharing_consumer_instances": [
"projects/CONSUMER_PROJECT_ID/locations/LOCATION/instances/CONSUMER_INSTANCE_ID"
]
}
EOF
次の例に示すように、curl コマンドを使用して HTTP エンドポイントを呼び出します。
curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://financialservices.googleapis.com/v1/projects/HOST_PROJECT_ID/locations/LOCATION/instances/HOST_INSTANCE_ID?updateMask=valid_party_registration_sharing_consumer_instances"
コンシューマー インスタンスを構成する
party_registration_sharing_host_instance フィールドを使用して、各コンシューマー インスタンスを構成します。このフィールドは文字列です。
リクエスト本文を request.json という名前のファイルに保存します。ターミナルで次のコマンドを実行して、このファイルを現在のディレクトリに作成または上書きします。
cat > request.json << 'EOF'
{
"party_registration_sharing_host_instance": "projects/HOST_PROJECT_ID/locations/LOCATION/instances/HOST_INSTANCE_ID"
}
EOF
次の例に示すように、curl コマンドを使用して HTTP エンドポイントを呼び出します。
curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://financialservices.googleapis.com/v1/projects/CONSUMER_PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID?updateMask=party_registration_sharing_host_instance"
VPC-SC を構成する
ホスト インスタンスとコンシューマー インスタンスが異なる VPC-SC 境界を使用する場合は、インスタンスを含むプロジェクトの VPC-SC 境界ブリッジまたは上り（内向き）/ 下り（外向き）ルールを構成します。