get_lsps
List MPLS TE LSP tunnels, or get one tunnel by name.
Description: Each returned path already carries its last CSPF placement outcome: placed (bool), reason (human-readable explanation, null when placed), reason_code (machine-readable failure category, null when placed), binding_constraints (which constraints actually block it), cost (total path metric, null when unplaced).
Act on reason_code, not on the wording of reason:
disconnected -- no path exists even with every constraint lifted;
the topology is severed and must be repaired.
constraints_unsatisfiable -- a path DOES exist, but the request is
too strict. Do not tell the user connectivity is broken; tell them
which of binding_constraints to relax (bandwidth, affinity, srlg).
More than one entry means they block only in combination, so
relaxing just one will fail again.
ero_strict_hop_unreachable -- a strict ERO hop has no direct edge.
endpoint_not_found -- src or dst is not in the graph.
Getting a single tunnel by lsp_name always
includes each path's expanded node-name path; the list form omits it
by default (include_path=True to get it there too, since it can be
large across many tunnels).Input fields: graph_time (str): The graph time identifier lsp_name (str, optional): Get one tunnel by name instead of listing all status (str, optional): "placed" or "unplaced" -- keep only paths matching via_node (str, optional): Keep only paths whose CSPF-computed path visits this node (e.g. "which tunnels cross router X", pre-maintenance impact check) via_edge (str, optional): "srcNode,dstNode" -- keep only paths traversing this hop via_edge_key (str, optional): Exact stable edge_key (from get_edges(include=["edge_key"])) -- disambiguates parallel/ECMP edges that via_edge alone cannot include_path (bool, optional): Also return each path's expanded node-name path in the list form
Equivalent to GET /graph/{graph_time}/lsps[/{lsp_name}].
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"graph_time": "<graph_time>"
},
"name": "get_lsps"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| status | No | ||
| lsp_name | No | ||
| via_edge | No | ||
| via_node | No | ||
| graph_time | Yes | ||
| include_path | No | ||
| via_edge_key | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||