An Insight instance represents a logical subdivision of data held within the Insight hub – either data for different organisations, or collections of data for different purposes within the same organisation.
The insight instance is loaded using a simple message of the form.
[
{
"instance_uuid": "insightinstance",
"instance_name": "Instance Name"
}
]
The insight instance is a UUID. It is taken from the channel identifier for the connection to the owning client. Within the Insight Hub module, a user is created with this as its id. This is then used to create a JWT which authenticates the call to the data hub. The user id is accessed by the load and search components to ensure data is written to and read from the correct instance.
Using curl as an example, an insight instance could be loaded using
curl -X POST -H "Content-Type: application/json" @instance.json "dhinstance/instance/put?process=true"
You can list all the instances using
curl "dhinstance/instance"