Configure data discovery

You can perform a data discovery for existing data items on demand. Data discovery is initiated through REST calls and it is tied to a specific discovery Id, which you can either specify or let the adapter generate it.

There are several actions you can take around data items or event types using discovery, such as:

• Retrieve the discovery results

• Query the discovery status

• Cancel or delete discoveries

• Merge discovery results with the data selection configuration

• Retrieve results from a current discovery and compare it with results from a previous or discovery

• Retrieve results from a current discovery and compare it with results from a current data selection configuration

A discovery against the data source of a Structured Data Files adapter allows you to specify the optional query parameter. The query discovers the contents of the data source and narrows the scope of the discovery. You can add the discovered items to the data selection. See Data discovery query examples for additional information regarding the query parameter and query strings.

Postman

To configure discovery using Postman:

1. Start any of the Configuration tools capable of making HTTP requests.

2. Run a POST command with the Id of the discovery and autoSelect set to either true or false to the following endpoint: http://localhost:5590/api/v1/configuration/<ComponentId>/Discoveries.

   Note: Including an Id is optional. If you do not include one, the adapter automatically generates one. Additionally, 5590 is the default port number. If you selected a different port number, replace it with that value.

   Example using Postman:

   POST http://localhost:5590/api/v1/configuration/<ComponentId>/Discoveries

   {

   "Id": "TestDiscovery",

   "autoSelect": true

   }

For a list of other REST operations you can perform, like updating or deleting a data source configuration, see the REST URLs section below.