List device ports

GET

/api/devices/{id}/ports

const url = 'http://localhost:3000/api/devices/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/ports';
const options = {method: 'GET', headers: {cookie: 'session=<session>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url http://localhost:3000/api/devices/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/ports \
  --cookie session=<session>

All ports for one device, ordered by portGroupLabel, portIndex, name. Not paginated.

Authorizations

cookieAuth

Parameters

Path Parameters

required

string format: uuid

Responses

200

Success

application/json

object

data

Array<object>

object

required

string format: uuid

deviceId

required

string format: uuid

name

required

string

portType

required

string

default: 1000base-t

status

required

string

Allowed values: enabled disabled planned

linkStatus

required

string

Allowed values: up down unknown

peer

string

nullable

vlan

string

nullable

lldp

string

nullable

errs

integer

description

string

nullable

portGroupLabel

string

nullable

portIndex

integer

nullable

connectorType

string

nullable

speeds

Array<string>

poeStandard

string

nullable

poeWatts

integer

nullable

transceiver

string

nullable

mgig

boolean

breakoutCapable

boolean

moduleSlot

string

nullable

macAddress

string

nullable

createdAt

required

string format: date-time

updatedAt

required

string format: date-time

Example

{
  "data": [
    {
      "portType": "1000base-t",
      "status": "enabled",
      "linkStatus": "up"
    }
  ]
}

401

Not authenticated

application/json

object

error

required

string

Example

{
  "error": "Not found"
}