get_network_by_graph_time
Fetch network data by explicit graph_time.
Description: This tool retrieves network information for a specific graph time. Universal tool that works with both OSPF and IS-IS protocols. Use 'node_id' to find all networks terminated by a specific node. Use 'ip_address' to find which network a specific IP belongs to.
Input fields: graph_time (str): REQUIRED - The specific graph time to query, use the most latest from get_all_graphs to get graph_time. network_w_digit_mask (str, optional): Network with mask (e.g., 10.0.0.0/24). Helpful when needed to find all devices which terminate the network ip_address (str, optional): IP address to find which network it belongs to node_id (str, optional): Universal node identifier to find all networks terminated by this node. Exact match only (no hostname or case-insensitive lookup here). - For OSPF: Use Router ID (e.g., "10.10.10.1") - For IS-IS: Use System ID (e.g., "1921.6800.1001") filter_type (str, optional): all, backuped_only or non_backuped_only; lists the networks of the graph by backup status, not with the three fields above at (str, optional): ISO 8601 moment; state with watcher events applied up to it. Not with the three lookup fields page, per_page (int, optional): page of the list read with filter_type or at; check pagination.total
Output fields: dict: A dictionary containing network information.
Examples: - get_network_by_graph_time("graph123", node_id="10.10.10.1") # All networks terminated by OSPF Router ID - get_network_by_graph_time("graph123", node_id="1921.6800.1001") # All networks terminated by IS-IS System ID - get_network_by_graph_time("graph123", ip_address="192.168.1.5") # Find network for IP 192.168.1.5
Equivalent to GET /network/{graph_time}, or GET /graph/{graph_time}/networks with filter_type or at.
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_network_by_graph_time"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| at | No | ||
| page | No | ||
| node_id | No | ||
| per_page | No | ||
| graph_time | Yes | ||
| ip_address | No | ||
| filter_type | No | ||
| network_w_digit_mask | No |