List interfaces
List interfaces that belong to simulations you have read access to. Results are paginated.
Required scope: air:simulation_read (roles: air_org_admin, air_user)
Alternative: role air_trainee also grants access.
Authentication
AuthorizationBearer
Bearer authentication of the form Bearer <token>, where token is your auth token.
Query parameters
has_link
Filter by whether the interface has a connected link (in either direction).
interface_type
* `DATA_PLANE_INTF` - Data Plane Interface
* `PCIE_INTF` - PCIe Interface between emulated nodes
* `OOB_INTF` - Out of Band Management Interface
Allowed values:
is_taken
Filter by whether the interface is taken (connected or outbound).
limit
Number of results to return per page.
mac_address
name
node
offset
The initial index from which to return the results.
ordering
Order objects by field. Prefix with - for descending order.
outbound
search
Search by name.
simulation
Response
count
results
next
previous
Errors
400
Bad Request Error
403
Forbidden Error
500
Internal Server Error