Party registration sharing for multiple instances

You can share an AML AI instance's registered parties with up to two additional instances in the same Google Cloud region for predictions. This allows your organization to train models on real data without impacting performance of the main AML AI instance that you use to generate AML alerts and without paying twice for registering the same parties.

The main AML AI instance is the host where you register your parties. The additional instance or instances, referred to as consumers, don't need to register parties. Instead, you can generate predictions for any party registered in the host instance. Typically these instances are used for less critical tasks, such as training and evaluating new models prior to deployment to the main instance.

Before you begin

Select an instance to use as the host. This is usually the instance that you use to generate production alerts.

Select one or two instances to use as consumers. These are usually the instances you use to create, evaluate, and analyze AML AI models.

The host and consumer instances must reside in the same Google Cloud region and belong to the same project or projects within the same organization.

Configure the host instance

To configure an instance to be the host instance for registration sharing, designate up to two instances as the chosen consumer instances in the valid_party_registration_sharing_consumer_instances field.

You can set this field when you create the host Instance , or you can update this field in an existing instance using the projects.locations.instances.patch request.

This field is a string list, with a maximum length of 2.

Before using any of the request data, make the following replacements:

LOCATION : the location of the host and consumer instances.
HOST_PROJECT_ID : a user-defined identifier for the project that contains the host instance.
HOST_INSTANCE_ID : a user-defined identifier for the host instance.
CONSUMER_PROJECT_ID : a user-defined identifier for the project that contains the consumer instance.
CONSUMER_INSTANCE_ID : a user-defined identifier for the consumer instance.

Save the request body in a file named request.json. Run the following command in the terminal to create or overwrite this file in the current directory:

 cat > request.json << 'EOF'
{
  "valid_party_registration_sharing_consumer_instances": [
    "projects/ CONSUMER_PROJECT_ID 
/locations/ LOCATION 
/instances/ CONSUMER_INSTANCE_ID 
"
 ]
}
EOF

Use a curl command to call its HTTP endpoint, as shown in the following example.

  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"

Configure the consumer instance

Configure each consumer instance using the party_registration_sharing_host_instance field. This field is a string.