Business Critical Services(BCS) Operational Insights API

Place In Network

The Place In Network (PIN) API resource predicts the functional roles and importance of devices in the network based on configuration and feature information; this provides meaningful metadata to enrich customer device information. The combination of the business importance and technical role of the device gives us a better understanding of the device's Place in Network. These attributes can be used to filter and prioritise devices with risks to focus remediation efforts based on devices with highest impact to the business.

Sample Use cases:

  • Security Advisories: use PIN as a prioritization mechanism for developing security remediation plans and software upgrades.
  • Hardware End of Life: identify critical and high importance devices that are no longer supported, or are rapidly approaching Last Date of Support.

These are the resources:

  • /placeInNetwork/details
  • /placeInNetwork/details/:deviceId

Here is an example output of the /placeInNetwork/details endpoint:

json
Copy{
  "items": [
    {
        "deviceId": 14938913,
        "deviceName": "wbucbb-9006lab-gw",
        "predictedImportance": "Medium",
        "predictedRole": "Core"
    },
    ...
  ]
}

In the previous example you can see that the device with id 14938913 is predicted to be a Core device with Medium importance.

Next