Get the current state of agent interfaces

GET

/agents/{id}/interfaces

Reads the current negotiated Ethernet speed in Mbit/s, the link state, and the duplex mode from the agent. It does not use the speed saved at registration and does not change NIC settings. A missing speed means the value is unknown; linkUp is omitted if the driver cannot report it.

Contract

Parameter	Value
Section	agents
Authentication	CookieAuth
Consumes	not required
Produces	application/json

Parameters

1 parameter

Name	Location	Required	Type	Description
id	path	yes	integer	Agent ID

Responses

6 responses

Status	Description	Type
200	Current interface state	object[]
400	Invalid ID	object
401	Unauthorized	object
404	Agent not found	object
500	Database error	object
502	Agent unavailable or does not support reading port state	object

Response 200: object[]

[
  {
    "address": "<string>",
    "deviceId": "<string>",
    "driver": "<string>",
    "linkDuplex": "<string>",
    "linkSpeedMbps": 0,
    "linkUp": true,
    "name": "<string>",
    "vendor": "<string>"
  }
]

{ "data": {}, "error": "<string>" }
{ "data": {}, "error": "<string>" }
{ "data": {}, "error": "<string>" }
{ "data": {}, "error": "<string>" }
{ "data": {}, "error": "<string>" }