get_interfaces
Retrieve interface configuration and/or live operational status for a Prisma SD-WAN element, with optional filtering by interface name or ID.
Instructions
Retrieve interface configuration and/or operational state for one element.
If interface is omitted and status is requested, the tool enumerates the
element interfaces then fans out to each status endpoint up to the fan-out ceiling
(default 100). Individual interface failures remain inline.
Args:
element: Element name, serial number, hardware ID, or exact
controller ID. If it resolves to exactly one record, site can
be omitted — the element's own site is used.
site: Site name or controller ID that should own element. Optional
when element already resolves uniquely on its own.
mode: config returns only interface configuration (no extra API
calls). status returns only live operational state per
interface. both (default) returns config plus status.
interface: Optional filter to one interface by exact ID, exact name
(case-insensitive), or name substring. Omit to return every
interface on the element. An ambiguous substring returns every
candidate rather than guessing.
cursor: Opaque pagination token copied from a previous response's
next_cursor. Omit on the first call.
limit: Max interfaces to return in this page. Omit to use the server
default page size (50; max 200).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | `config` returns only interface configuration (no extra API calls). `status` returns only live operational state per interface. `both` (default) returns config plus status. | both |
| site | No | Site name or controller ID that should own `element`. Optional when `element` already resolves uniquely on its own. | |
| limit | No | Max interfaces 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 | Element name, serial number, hardware ID, or exact controller ID. If it resolves to exactly one record, `site` can be omitted — the element's own site is used. | |
| interface | No | Optional filter to one interface by exact ID, exact name (case-insensitive), or name substring. Omit to return every interface on the element. An ambiguous substring returns every candidate rather than guessing. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |