get_device_diagnostics
Get Prisma SD-WAN device diagnostics without raw API IDs: LLDP neighbors, MAC table, port/VLAN mappings, BFD peers, and application probe config.
Instructions
Retrieve common device-side diagnostic state without requiring raw API IDs.
Covers LLDP neighbors, MAC table, switch port/VLAN mappings, BFD peers, and application-probe configuration. Site is inferred from the element whenever the element inventory record provides site_id.
Args:
operation: Which diagnostic to fetch. lldp_neighbors and
mac_table need only element. bfd_peers, port_to_vlan,
vlan_to_port, and application_probe also need a resolvable
site (explicit, or inferred from the element's inventory
record) — if neither is available, these four return an error
rather than guessing. port_to_vlan/vlan_to_port additionally
require a switch-capable element model; on other models the
controller rejects the read with a "does not support switch
configuration" message, which means wrong device type, not a
failed lookup — don't retry it against the same element.
element: ION element name, serial number, hardware ID, or exact
controller ID. Always required.
site: Site name or controller ID. Optional for lldp_neighbors/
mac_table; required (explicit or inferable from element)
for bfd_peers, port_to_vlan, vlan_to_port, and
application_probe.
cursor: Opaque pagination token copied from a previous response's
next_cursor. Omit on the first call.
limit: Max items to return in this page. Omit to use the server
default page size (50; max 200).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| site | No | Site name or controller ID. Optional for `lldp_neighbors`/ `mac_table`; required (explicit or inferable from `element`) for `bfd_peers`, `port_to_vlan`, `vlan_to_port`, and `application_probe`. | |
| limit | No | Max items to return in this page. Omit to use the server default page size (50; max 200). | |
| cursor | No | Opaque pagination token copied from a previous response's `next_cursor`. Omit on the first call. | |
| element | Yes | ION element name, serial number, hardware ID, or exact controller ID. Always required. | |
| operation | Yes | Which diagnostic to fetch. `lldp_neighbors` and `mac_table` need only `element`. `bfd_peers`, `port_to_vlan`, `vlan_to_port`, and `application_probe` also need a resolvable `site` (explicit, or inferred from the element's inventory record) — if neither is available, these four return an error rather than guessing. `port_to_vlan`/`vlan_to_port` additionally require a switch-capable element model; on other models the controller rejects the read with a "does not support switch configuration" message, which means wrong device type, not a failed lookup — don't retry it against the same element. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |