Extracting topology data for a limited set of chassis devices

You can use the Topology API to extract topology data from the NCIM topology database for a limited set of chassis devices, such as a single device or a small number of devices.

Syntax

Specify the following parameters within a REST client in order to extract topology data for a limited set of chassis devices.
Table 1. Parameters to extract topology data for a limited set of chassis devices
Parameter Value
Method POST
URL
https://HOST:PORT/ROOT-CONTEXT/nm_rest/topology/devices/entityIds
Where:
  • HOST is the hostname or IP address of the Dashboard Application Services Hub server.
  • PORT is the secure port number of the Dashboard Application Services Hub server. By default, this is 16311.
  • ROOT-CONTEXT is the path from the root of your file system to the Topology API.
Content Type application/json
Payload Comma-separated list representing the entity identifiers of the devices to retrieve; for example,
11649,11654,11661

Retrieving entity identifiers for devices

In order to retrieve an entity identifier for devices for which you know the entity name, execute an SQL query similar to the following against the NCIM database:
select e.entityId from ncim.entityData e
inner join ncim.chassis c on e.entityId = c.entityId 
where e.entityName = 'My Device';
In order to retrieve an entity identifier for devices for which you know the IP address, execute an SQL query similar to the following against the NCIM database:
select entityId from ncim.chassis 
where accessIpAddress = '1.2.3.4';