List Topology Nodes
cnc_list_topology_nodesList topology nodes as a sorted, paged table to inspect per-node attributes like management IP, TE router ID, reachability, and device family; read-only.
Instructions
List the nodes on the topology map as a sorted, paged table.
Read-only. Topology nodes are the devices CNC has placed on the map (fed by inventory + SR-PCE); their UUIDs match the inventory node UUIDs. Use this for per-node attributes (management IP, TE router-id, reachability, family); use cnc_get_topology for adjacency.
Paging is a row window: startRow = page * page_size,
endRow = startRow + page_size. Past the end the platform returns
totalCount with no rows (reported as an empty page, not an error).
No filtering is available on this endpoint — filter client-side or use
the inventory tools. The platform silently accepts an unknown sort
column (undefined order), so sort_by is validated here first.
Args: page_size: rows per page (1-500). page: 0-based page number. sort_by: column to sort on (see the parameter description). sort_ascending: sort direction. response_format: markdown (default) or json.
Returns:
str: Markdown listing, or JSON:
{"total": int, "count": int, "page": int, "page_size": int,
"items": [{"uuid": str, "name": str, "nodeIp": str, "teRouterId": str,
"reachabilityState": "CONN_STATE_REACHABLE"|..., "productType": str,
"deviceFamily": str, "lastUpdateTime": str, ...}],
"has_more": bool, "next_page": int|null, ...}
Each item is the element's uuid merged with its attributes.
On failure: "Error: " (unknown sort column ->
"Error: Unknown sort column ..."). An HTTP 500 "Internal Server
Error" from /v1/topology-service/... means the service rejected the
request body (viewId/params) — deterministic, do NOT retry.
(It is not the inventory's "NATS request failed" signal.)
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | 0-based page number. | |
| sort_by | No | Column to sort on: 'name' (default), 'nodeIp', 'lastUpdateTime' (all three verified live), 'teRouterId', 'reachabilityState', 'productType' or 'deviceFamily'. | name |
| page_size | No | Rows per page (endRow - startRow). | |
| sort_ascending | No | Sort ascending (true, default) or descending. | |
| response_format | No | 'markdown' for human-readable output, 'json' for complete data. | markdown |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |