interface.query

Sent on interface changes.

Type: object

ADDED

InterfaceAddedEvent

Type: object
No Additional Properties

id Required

Id

Type: string

fields Required

InterfaceEntry

Type: object

id Required

Id

Type: string

Unique identifier for the network interface.

name Required

Name

Type: string

Name of the network interface.

fake Required

Fake

Type: boolean

Whether this is a fake/simulated interface for testing purposes.

type Required

Type

Type: string

Type of interface (PHYSICAL, BRIDGE, LINK_AGGREGATION, VLAN, etc.).

state Required

InterfaceEntryState

Type: object

Current runtime state information for the interface.

No Additional Properties

name Required

Name

Type: string

Current name of the network interface.

orig_name Required

Orig Name

Type: string

Original name of the network interface before any renaming.

description Required

Description

Type: string

Human-readable description of the network interface.

mtu Required

Mtu

Type: integer

Maximum transmission unit size for the interface.

cloned Required

Cloned

Type: boolean

Whether the interface is a cloned/virtual interface.

flags Required

Flags

Type: array of string

List of interface flags indicating various states and capabilities. Common flags include UP, DOWN, RUNNING, MULTICAST, BROADCAST, LOOPBACK, and POINTOPOINT.

No Additional Items

Each item of this array must be:

Type: string

nd6_flags Required

Nd6 Flags

Type: array

IPv6 neighbor discovery flags. These control IPv6 autoconfiguration behavior and include flags like AUTOLINKLOCAL, ACCEPTRTADV, and PERFORMNUD.

No Additional Items

Each item of this array must be:

Type: object

capabilities Required

Capabilities

Type: array

List of hardware capabilities supported by the interface. Common capabilities include VLANMTU, JUMBOMTU, VLANHWTAGGING, VLANHWCSUM, and TSO4.

No Additional Items

Each item of this array must be:

Type: object

link_state Required

Link State

Type: string

Current link state of the interface (up, down, etc.).

media_type Required

Media Type

Type: string

Type of media/connection for the interface. Examples include Ethernet, 802.11, or loopback.

media_subtype Required

Media Subtype

Type: string

Subtype of media/connection for the interface. Examples include 1000baseT, 100baseTX, or autoselect.

active_media_type Required

Active Media Type

Type: string

Currently active media type. This may differ from configured media_type during autonegotiation.

active_media_subtype Required

Active Media Subtype

Type: string

Currently active media subtype. This reflects the actual negotiated connection speed and type.

supported_media Required

Supported Media

Type: array

List of supported media types for the interface. Contains media descriptors like '1000baseT <full-duplex>' or 'autoselect'.

No Additional Items

Each item of this array must be:

Type: object

media_options Required

Media Options

Available media options for the interface. Options may include 'full-duplex', 'half-duplex', 'flowcontrol', or 'rxpause'.

Any of

• Option 1
• Option 2

Type: array
No Additional Items

Each item of this array must be:

Type: object

Type: null

link_address Required

Link Address

Type: string

MAC address of the interface.

permanent_link_address Required

Permanent Link Address

Permanent MAC address of the interface if different from current.

Any of

• Option 1
• Option 2

Type: string

Type: null

hardware_link_address Required

Hardware Link Address

Type: string

Hardware MAC address of the interface.

rx_queues

Rx Queues

Type: integer

Number of receive queues configured for the interface.

tx_queues

Tx Queues

Type: integer

Number of transmit queues configured for the interface.

aliases Required

Aliases

Type: array of object

List of IP address aliases configured on the interface.

No Additional Items

Each item of this array must be:

InterfaceEntryStateAlias

Type: object
No Additional Properties

type Required

Type

Type: string

The type of IP address (INET for IPv4, INET6 for IPv6).

address Required

Address

Type: string

The IP address value.

netmask

Netmask

Any of

• Option 1
• Option 2

Type: string

Type: integer

broadcast

Broadcast

Type: string

vrrp_config

Vrrp Config

Default: []

VRRP (Virtual Router Redundancy Protocol) configuration for the interface.

Any of

• Option 1
• Option 2

Type: array
No Additional Items

Each item of this array must be:

Type: object

Type: null

protocol

Protocol

Link aggregation protocol used (LACP, FAILOVER, etc.).

Any of

• Option 1
• Option 2

Type: string

Type: null

ports

Ports

Type: array of object Default: []

List of ports that are members of this link aggregation group.

No Additional Items

Each item of this array must be:

InterfaceEntryStatePort

Type: object
No Additional Properties

name Required

Name

Type: string

The name of the port interface.

flags Required

Flags

Type: array of string

List of flags associated with the port.

No Additional Items

Each item of this array must be:

Type: string

xmit_hash_policy

Xmit Hash Policy

Default: null

Transmit hash policy for load balancing in link aggregation. LAYER2 uses MAC addresses, LAYER2+3 adds IP addresses, and LAYER3+4 includes TCP/UDP ports for distribution.

Any of

• Option 1
• Option 2

Type: string

Type: null

lacpdu_rate

Lacpdu Rate

Default: null

LACP data unit transmission rate. SLOW sends LACPDUs every 30 seconds, FAST sends every 1 second for quicker link failure detection.

Any of

• Option 1
• Option 2

Type: string

Type: null

parent

Parent

Parent interface for VLAN configuration.

Any of

• Option 1
• Option 2

Type: string

Type: null

tag

Tag

VLAN tag number.

Any of

• Option 1
• Option 2

Type: integer

Type: null

pcp

Pcp

Priority Code Point for VLAN traffic prioritization. Values 0-7 map to different QoS priority levels, with 0 being lowest and 7 highest priority.

Any of

• Option 1
• Option 2

Type: integer

Type: null

aliases Required

Aliases

Type: array of object

List of IP address aliases configured on the interface.

No Additional Items

Each item of this array must be:

InterfaceEntryAlias

Type: object
No Additional Properties

type Required

Type

Type: string

The type of IP address (INET for IPv4, INET6 for IPv6).

address Required

Address

Type: string

The IP address value.

netmask Required

Netmask

The network mask for the IP address, either as a string or CIDR notation integer.

Any of

• Option 1
• Option 2

Type: string

Type: integer

ipv4_dhcp Required

Ipv4 Dhcp

Type: boolean

Whether IPv4 DHCP is enabled for automatic IP address assignment.

ipv6_auto Required

Ipv6 Auto

Type: boolean

Whether IPv6 autoconfiguration is enabled.

description Required

Description

Type: string

Human-readable description of the interface.

mtu Required

Mtu

Maximum transmission unit size for the interface.

Any of

• Option 1
• Option 2

Type: integer

Type: null

vlan_parent_interface

Vlan Parent Interface

Parent interface for VLAN configuration.

Any of

• Option 1
• Option 2

Type: string

Type: null

vlan_tag

Vlan Tag

VLAN tag number for VLAN interfaces.

Any of

• Option 1
• Option 2

Type: integer

Type: null

vlan_pcp

Vlan Pcp

Priority Code Point for VLAN traffic prioritization.

Any of

• Option 1
• Option 2

Type: integer

Type: null

lag_protocol

Lag Protocol

Type: string

Link aggregation protocol (LACP, FAILOVER, LOADBALANCE, etc.).

lag_ports

Lag Ports

Type: array of string Default: []

List of interface names that are members of this link aggregation group.

No Additional Items

Each item of this array must be:

Type: string

bridge_members

Bridge Members

Type: array of string Default: []

List of interface names that are members of this bridge.

No Additional Items

Each item of this array must be:

Type: string

enable_learning

Enable Learning

Type: boolean

Whether MAC address learning is enabled for bridge interfaces.

Additional Properties

Additional Properties of any type are allowed.

Type: object

CHANGED

InterfaceChangedEvent

Type: object
No Additional Properties

id Required

Id

Type: string

fields Required

InterfaceEntry

Type: object

id Required

Id

Type: string

Unique identifier for the network interface.

name Required

Name

Type: string

Name of the network interface.

fake Required

Fake

Type: boolean

Whether this is a fake/simulated interface for testing purposes.

type Required

Type

Type: string

Type of interface (PHYSICAL, BRIDGE, LINK_AGGREGATION, VLAN, etc.).

state Required

InterfaceEntryState

Type: object

Current runtime state information for the interface.

No Additional Properties

name Required

Name

Type: string

Current name of the network interface.

orig_name Required

Orig Name

Type: string

Original name of the network interface before any renaming.

description Required

Description

Type: string

Human-readable description of the network interface.

mtu Required

Mtu

Type: integer

Maximum transmission unit size for the interface.

cloned Required

Cloned

Type: boolean

Whether the interface is a cloned/virtual interface.

flags Required

Flags

Type: array of string

List of interface flags indicating various states and capabilities. Common flags include UP, DOWN, RUNNING, MULTICAST, BROADCAST, LOOPBACK, and POINTOPOINT.

No Additional Items

Each item of this array must be:

Type: string

nd6_flags Required

Nd6 Flags

Type: array

IPv6 neighbor discovery flags. These control IPv6 autoconfiguration behavior and include flags like AUTOLINKLOCAL, ACCEPTRTADV, and PERFORMNUD.

No Additional Items

Each item of this array must be:

Type: object

capabilities Required

Capabilities

Type: array

List of hardware capabilities supported by the interface. Common capabilities include VLANMTU, JUMBOMTU, VLANHWTAGGING, VLANHWCSUM, and TSO4.

No Additional Items

Each item of this array must be:

Type: object

link_state Required

Link State

Type: string

Current link state of the interface (up, down, etc.).

media_type Required

Media Type

Type: string

Type of media/connection for the interface. Examples include Ethernet, 802.11, or loopback.

media_subtype Required

Media Subtype

Type: string

Subtype of media/connection for the interface. Examples include 1000baseT, 100baseTX, or autoselect.

active_media_type Required

Active Media Type

Type: string

Currently active media type. This may differ from configured media_type during autonegotiation.

active_media_subtype Required

Active Media Subtype

Type: string

Currently active media subtype. This reflects the actual negotiated connection speed and type.

supported_media Required

Supported Media

Type: array

List of supported media types for the interface. Contains media descriptors like '1000baseT <full-duplex>' or 'autoselect'.

No Additional Items

Each item of this array must be:

Type: object

media_options Required

Media Options

Available media options for the interface. Options may include 'full-duplex', 'half-duplex', 'flowcontrol', or 'rxpause'.

Any of

• Option 1
• Option 2

Type: array
No Additional Items

Each item of this array must be:

Type: object

Type: null

link_address Required

Link Address

Type: string

MAC address of the interface.

permanent_link_address Required

Permanent Link Address

Permanent MAC address of the interface if different from current.

Any of

• Option 1
• Option 2

Type: string

Type: null

hardware_link_address Required

Hardware Link Address

Type: string

Hardware MAC address of the interface.

rx_queues

Rx Queues

Type: integer

Number of receive queues configured for the interface.

tx_queues

Tx Queues

Type: integer

Number of transmit queues configured for the interface.

aliases Required

Aliases

Type: array of object

List of IP address aliases configured on the interface.

No Additional Items

Each item of this array must be:

InterfaceEntryStateAlias

Type: object
No Additional Properties

type Required

Type

Type: string

The type of IP address (INET for IPv4, INET6 for IPv6).

address Required

Address

Type: string

The IP address value.

netmask

Netmask

Any of

• Option 1
• Option 2

Type: string

Type: integer

broadcast

Broadcast

Type: string

vrrp_config

Vrrp Config

Default: []

VRRP (Virtual Router Redundancy Protocol) configuration for the interface.

Any of

• Option 1
• Option 2

Type: array
No Additional Items

Each item of this array must be:

Type: object

Type: null

protocol

Protocol

Link aggregation protocol used (LACP, FAILOVER, etc.).

Any of

• Option 1
• Option 2

Type: string

Type: null

ports

Ports

Type: array of object Default: []

List of ports that are members of this link aggregation group.

No Additional Items

Each item of this array must be:

InterfaceEntryStatePort

Type: object
No Additional Properties

name Required

Name

Type: string

The name of the port interface.

flags Required

Flags

Type: array of string

List of flags associated with the port.

No Additional Items

Each item of this array must be:

Type: string

xmit_hash_policy

Xmit Hash Policy

Default: null

Transmit hash policy for load balancing in link aggregation. LAYER2 uses MAC addresses, LAYER2+3 adds IP addresses, and LAYER3+4 includes TCP/UDP ports for distribution.

Any of

• Option 1
• Option 2

Type: string

Type: null

lacpdu_rate

Lacpdu Rate

Default: null

LACP data unit transmission rate. SLOW sends LACPDUs every 30 seconds, FAST sends every 1 second for quicker link failure detection.

Any of

• Option 1
• Option 2

Type: string

Type: null

parent

Parent

Parent interface for VLAN configuration.

Any of

• Option 1
• Option 2

Type: string

Type: null

tag

Tag

VLAN tag number.

Any of

• Option 1
• Option 2

Type: integer

Type: null

pcp

Pcp

Priority Code Point for VLAN traffic prioritization. Values 0-7 map to different QoS priority levels, with 0 being lowest and 7 highest priority.

Any of

• Option 1
• Option 2

Type: integer

Type: null

aliases Required

Aliases

Type: array of object

List of IP address aliases configured on the interface.

No Additional Items

Each item of this array must be:

InterfaceEntryAlias

Type: object
No Additional Properties

type Required

Type

Type: string

The type of IP address (INET for IPv4, INET6 for IPv6).

address Required

Address

Type: string

The IP address value.

netmask Required

Netmask

The network mask for the IP address, either as a string or CIDR notation integer.

Any of

• Option 1
• Option 2

Type: string

Type: integer

ipv4_dhcp Required

Ipv4 Dhcp

Type: boolean

Whether IPv4 DHCP is enabled for automatic IP address assignment.

ipv6_auto Required

Ipv6 Auto

Type: boolean

Whether IPv6 autoconfiguration is enabled.

description Required

Description

Type: string

Human-readable description of the interface.

mtu Required

Mtu

Maximum transmission unit size for the interface.

Any of

• Option 1
• Option 2

Type: integer

Type: null

vlan_parent_interface

Vlan Parent Interface

Parent interface for VLAN configuration.

Any of

• Option 1
• Option 2

Type: string

Type: null

vlan_tag

Vlan Tag

VLAN tag number for VLAN interfaces.

Any of

• Option 1
• Option 2

Type: integer

Type: null

vlan_pcp

Vlan Pcp

Priority Code Point for VLAN traffic prioritization.

Any of

• Option 1
• Option 2

Type: integer

Type: null

lag_protocol

Lag Protocol

Type: string

Link aggregation protocol (LACP, FAILOVER, LOADBALANCE, etc.).

lag_ports

Lag Ports

Type: array of string Default: []

List of interface names that are members of this link aggregation group.

No Additional Items

Each item of this array must be:

Type: string

bridge_members

Bridge Members

Type: array of string Default: []

List of interface names that are members of this bridge.

No Additional Items

Each item of this array must be:

Type: string

enable_learning

Enable Learning

Type: boolean

Whether MAC address learning is enabled for bridge interfaces.

Additional Properties

Additional Properties of any type are allowed.

Type: object

REMOVED

InterfaceRemovedEvent

Type: object
No Additional Properties

id Required

Id

Type: string

Required roles: NETWORK_INTERFACE_READ