routeros.InterfaceEthernet
Explore with Pulumi AI
Example Usage
import * as pulumi from "@pulumi/pulumi";
import * as routeros from "@pulumi/routeros";
const test = new routeros.InterfaceEthernet("test", {
factoryName: "sfp-sfpplus8",
mtu: 9000,
});
import pulumi
import pulumi_routeros as routeros
test = routeros.InterfaceEthernet("test",
factory_name="sfp-sfpplus8",
mtu=9000)
package main
import (
"github.com/pulumi/pulumi-terraform-provider/sdks/go/routeros/routeros"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := routeros.NewInterfaceEthernet(ctx, "test", &routeros.InterfaceEthernetArgs{
FactoryName: pulumi.String("sfp-sfpplus8"),
Mtu: pulumi.Float64(9000),
})
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Routeros = Pulumi.Routeros;
return await Deployment.RunAsync(() =>
{
var test = new Routeros.InterfaceEthernet("test", new()
{
FactoryName = "sfp-sfpplus8",
Mtu = 9000,
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.routeros.InterfaceEthernet;
import com.pulumi.routeros.InterfaceEthernetArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
var test = new InterfaceEthernet("test", InterfaceEthernetArgs.builder()
.factoryName("sfp-sfpplus8")
.mtu(9000)
.build());
}
}
resources:
test:
type: routeros:InterfaceEthernet
properties:
factoryName: sfp-sfpplus8
mtu: 9000
Create InterfaceEthernet Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new InterfaceEthernet(name: string, args: InterfaceEthernetArgs, opts?: CustomResourceOptions);
@overload
def InterfaceEthernet(resource_name: str,
args: InterfaceEthernetArgs,
opts: Optional[ResourceOptions] = None)
@overload
def InterfaceEthernet(resource_name: str,
opts: Optional[ResourceOptions] = None,
factory_name: Optional[str] = None,
loop_protect: Optional[str] = None,
loop_protect_send_interval: Optional[str] = None,
advertise: Optional[str] = None,
arp: Optional[str] = None,
arp_timeout: Optional[str] = None,
auto_negotiation: Optional[bool] = None,
bandwidth: Optional[str] = None,
cable_settings: Optional[str] = None,
combo_mode: Optional[str] = None,
mac_address: Optional[str] = None,
disable_running_check: Optional[bool] = None,
disabled: Optional[bool] = None,
___path_: Optional[str] = None,
fec_mode: Optional[str] = None,
full_duplex: Optional[bool] = None,
interface_ethernet_id: Optional[str] = None,
l2mtu: Optional[float] = None,
___id_: Optional[float] = None,
___skip_: Optional[str] = None,
loop_protect_disable_time: Optional[str] = None,
comment: Optional[str] = None,
mdix_enable: Optional[bool] = None,
mtu: Optional[float] = None,
name: Optional[str] = None,
poe_lldp_enabled: Optional[bool] = None,
poe_out: Optional[str] = None,
poe_priority: Optional[float] = None,
poe_voltage: Optional[str] = None,
power_cycle_interval: Optional[str] = None,
power_cycle_ping_address: Optional[str] = None,
power_cycle_ping_enabled: Optional[bool] = None,
power_cycle_ping_timeout: Optional[str] = None,
rx_flow_control: Optional[str] = None,
sfp_ignore_rx_los: Optional[bool] = None,
sfp_rate_select: Optional[str] = None,
sfp_shutdown_temperature: Optional[float] = None,
speed: Optional[str] = None,
tx_flow_control: Optional[str] = None)
func NewInterfaceEthernet(ctx *Context, name string, args InterfaceEthernetArgs, opts ...ResourceOption) (*InterfaceEthernet, error)
public InterfaceEthernet(string name, InterfaceEthernetArgs args, CustomResourceOptions? opts = null)
public InterfaceEthernet(String name, InterfaceEthernetArgs args)
public InterfaceEthernet(String name, InterfaceEthernetArgs args, CustomResourceOptions options)
type: routeros:InterfaceEthernet
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
Parameters
- name string
- The unique name of the resource.
- args InterfaceEthernetArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- resource_name str
- The unique name of the resource.
- args InterfaceEthernetArgs
- The arguments to resource properties.
- opts ResourceOptions
- Bag of options to control resource's behavior.
- ctx Context
- Context object for the current deployment.
- name string
- The unique name of the resource.
- args InterfaceEthernetArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args InterfaceEthernetArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args InterfaceEthernetArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
InterfaceEthernet Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.
The InterfaceEthernet resource accepts the following input properties:
- Factory
Name string - The factory name of the identifier, serves as resource identifier. Determines which interface will be updated.
- Advertise string
- Advertised speed and duplex modes for Ethernet interfaces over twisted pair, only applies when auto-negotiation is enabled. Advertising higher speeds than the actual interface supported speed will have no effect, multiple options are allowed.
- Arp string
- Address Resolution Protocol mode: * disabled - the interface will not use ARP * enabled - the interface will use ARP * local-proxy-arp - the router performs proxy ARP on the interface and sends replies to the same interface * proxy-arp - the router performs proxy ARP on the interface and sends replies to other interfaces * reply-only - the interface will only reply to requests originated from matching IP address/MAC address combinations which are entered as static entries in the ARP table. No dynamic entries will be automatically stored in the ARP table. Therefore for communications to be successful, a valid static entry must already exist.
- Arp
Timeout string - ARP timeout is time how long ARP record is kept in ARP table after no packets are received from IP. Value auto equals to
the value of arp-timeout in IP/Settings, default is 30s. Can use postfix
ms
,s
,m
,h
,d
for milliseconds, seconds, minutes, hours or days. If no postfix is set then seconds (s) is used. - Auto
Negotiation bool - When enabled, the interface "advertises" its maximum capabilities to achieve the best connection possible. Note1: Auto-negotiation should not be disabled on one end only, otherwise Ethernet Interfaces may not work properly. Note2: Gigabit Ethernet and NBASE-T Ethernet links cannot work with auto-negotiation disabled.
- Bandwidth string
- Sets max rx/tx bandwidth in kbps that will be handled by an interface. TX limit is supported on all Atheros switch-chip ports. RX limit is supported only on Atheros8327/QCA8337 switch-chip ports.
- Cable
Settings string - Changes the cable length setting (only applicable to NS DP83815/6 cards)
- Combo
Mode string - When auto mode is selected, the port that was first connected will establish the link. In case this link fails, the other port will try to establish a new link. If both ports are connected at the same time (e.g. after reboot), the priority will be the SFP/SFP+ port. When sfp mode is selected, the interface will only work through SFP/SFP+ cage. When copper mode is selected, the interface will only work through RJ45 Ethernet port.
- Comment string
- Disable
Running boolCheck - Disable running check. If this value is set to 'no', the router automatically detects whether the NIC is connected with a device in the network or not. Default value is 'yes' because older NICs do not support it. (only applicable to x86)
- Disabled bool
- Fec
Mode string - Changes Forward Error Correction (FEC) mode for SFP28, QSFP+ and QSFP28 interfaces. Same mode should be used on both link ends, otherwise FEC mismatch could result in non-working link or even false link-ups.
- Full
Duplex bool - Defines whether the transmission of data appears in two directions simultaneously, only applies when auto-negotiation is disabled.
- Interface
Ethernet stringId - L2mtu double
- Layer2 Maximum transmission unit. See.
- Loop
Protect string - Loop
Protect stringDisable Time - Loop
Protect stringSend Interval - Mac
Address string - Media Access Control number of an interface.
- Mdix
Enable bool - Whether the MDI/X auto cross over cable correction feature is enabled for the port (Hardware specific, e.g. ether1 on RB500 can be set to yes/no. Fixed to 'yes' on other hardware.)
- Mtu double
- Layer3 Maximum transmission unit
- Name string
- Name of the ethernet interface.
- Poe
Lldp boolEnabled - An option that enables LLDP for managing devices.
- Poe
Out string - PoE settings: (https://wiki.mikrotik.com/wiki/Manual:PoE-Out)
- Poe
Priority double - PoE settings: (https://wiki.mikrotik.com/wiki/Manual:PoE-Out)
- Poe
Voltage string - An option that allows us to manually control the voltage outputs on the PoE port.
- Power
Cycle stringInterval - An options that disables PoE-Out power for 5s between the specified intervals.
- Power
Cycle stringPing Address - An address to monitor.
- Power
Cycle boolPing Enabled - An option that enables ping watchdog of power cycles on the port if a host does not respond to ICMP or MAC-Telnet packets.
- Power
Cycle stringPing Timeout - If the host does not respond over the specified period, the PoE-Out port is switched off for 5s.
- Rx
Flow stringControl - When set to on, the port will process received pause frames and suspend transmission if required. auto is the same as on except when auto-negotiation=yes flow control status is resolved by taking into account what other end advertises.
- Sfp
Ignore boolRx Los - An option to ignore RX LOS (Loss of Signal) status of the SFP module.
- Sfp
Rate stringSelect - Allows to control rate select pin for SFP ports. Values: high | low
- Sfp
Shutdown doubleTemperature - The temperature in Celsius at which the interface will be temporarily turned off due to too high detected SFP module temperature (introduced v6.48).The default value for SFP/SFP+/SFP28 interfaces is 95, and for QSFP+/QSFP28 interfaces 80 (introduced v7.6).
- Speed string
- Sets interface data transmission speed which takes effect only when
auto_negotiation
is disabled. - Tx
Flow stringControl - When set to on, the port will generate pause frames to the upstream device to temporarily stop the packet transmission. Pause frames are only generated when some routers output interface is congested and packets cannot be transmitted anymore. Auto is the same as on except when auto-negotiation=yes flow control status is resolved by taking into account what other end advertises.
- ___
id_ double - Resource ID type (.id / name). This is an internal service field, setting a value is not required.
- ___
path_ string - Resource path for CRUD operations. This is an internal service field, setting a value is not required.
- ___
skip_ string - A set of transformations for field names. This is an internal service field, setting a value is not required.
- Factory
Name string - The factory name of the identifier, serves as resource identifier. Determines which interface will be updated.
- Advertise string
- Advertised speed and duplex modes for Ethernet interfaces over twisted pair, only applies when auto-negotiation is enabled. Advertising higher speeds than the actual interface supported speed will have no effect, multiple options are allowed.
- Arp string
- Address Resolution Protocol mode: * disabled - the interface will not use ARP * enabled - the interface will use ARP * local-proxy-arp - the router performs proxy ARP on the interface and sends replies to the same interface * proxy-arp - the router performs proxy ARP on the interface and sends replies to other interfaces * reply-only - the interface will only reply to requests originated from matching IP address/MAC address combinations which are entered as static entries in the ARP table. No dynamic entries will be automatically stored in the ARP table. Therefore for communications to be successful, a valid static entry must already exist.
- Arp
Timeout string - ARP timeout is time how long ARP record is kept in ARP table after no packets are received from IP. Value auto equals to
the value of arp-timeout in IP/Settings, default is 30s. Can use postfix
ms
,s
,m
,h
,d
for milliseconds, seconds, minutes, hours or days. If no postfix is set then seconds (s) is used. - Auto
Negotiation bool - When enabled, the interface "advertises" its maximum capabilities to achieve the best connection possible. Note1: Auto-negotiation should not be disabled on one end only, otherwise Ethernet Interfaces may not work properly. Note2: Gigabit Ethernet and NBASE-T Ethernet links cannot work with auto-negotiation disabled.
- Bandwidth string
- Sets max rx/tx bandwidth in kbps that will be handled by an interface. TX limit is supported on all Atheros switch-chip ports. RX limit is supported only on Atheros8327/QCA8337 switch-chip ports.
- Cable
Settings string - Changes the cable length setting (only applicable to NS DP83815/6 cards)
- Combo
Mode string - When auto mode is selected, the port that was first connected will establish the link. In case this link fails, the other port will try to establish a new link. If both ports are connected at the same time (e.g. after reboot), the priority will be the SFP/SFP+ port. When sfp mode is selected, the interface will only work through SFP/SFP+ cage. When copper mode is selected, the interface will only work through RJ45 Ethernet port.
- Comment string
- Disable
Running boolCheck - Disable running check. If this value is set to 'no', the router automatically detects whether the NIC is connected with a device in the network or not. Default value is 'yes' because older NICs do not support it. (only applicable to x86)
- Disabled bool
- Fec
Mode string - Changes Forward Error Correction (FEC) mode for SFP28, QSFP+ and QSFP28 interfaces. Same mode should be used on both link ends, otherwise FEC mismatch could result in non-working link or even false link-ups.
- Full
Duplex bool - Defines whether the transmission of data appears in two directions simultaneously, only applies when auto-negotiation is disabled.
- Interface
Ethernet stringId - L2mtu float64
- Layer2 Maximum transmission unit. See.
- Loop
Protect string - Loop
Protect stringDisable Time - Loop
Protect stringSend Interval - Mac
Address string - Media Access Control number of an interface.
- Mdix
Enable bool - Whether the MDI/X auto cross over cable correction feature is enabled for the port (Hardware specific, e.g. ether1 on RB500 can be set to yes/no. Fixed to 'yes' on other hardware.)
- Mtu float64
- Layer3 Maximum transmission unit
- Name string
- Name of the ethernet interface.
- Poe
Lldp boolEnabled - An option that enables LLDP for managing devices.
- Poe
Out string - PoE settings: (https://wiki.mikrotik.com/wiki/Manual:PoE-Out)
- Poe
Priority float64 - PoE settings: (https://wiki.mikrotik.com/wiki/Manual:PoE-Out)
- Poe
Voltage string - An option that allows us to manually control the voltage outputs on the PoE port.
- Power
Cycle stringInterval - An options that disables PoE-Out power for 5s between the specified intervals.
- Power
Cycle stringPing Address - An address to monitor.
- Power
Cycle boolPing Enabled - An option that enables ping watchdog of power cycles on the port if a host does not respond to ICMP or MAC-Telnet packets.
- Power
Cycle stringPing Timeout - If the host does not respond over the specified period, the PoE-Out port is switched off for 5s.
- Rx
Flow stringControl - When set to on, the port will process received pause frames and suspend transmission if required. auto is the same as on except when auto-negotiation=yes flow control status is resolved by taking into account what other end advertises.
- Sfp
Ignore boolRx Los - An option to ignore RX LOS (Loss of Signal) status of the SFP module.
- Sfp
Rate stringSelect - Allows to control rate select pin for SFP ports. Values: high | low
- Sfp
Shutdown float64Temperature - The temperature in Celsius at which the interface will be temporarily turned off due to too high detected SFP module temperature (introduced v6.48).The default value for SFP/SFP+/SFP28 interfaces is 95, and for QSFP+/QSFP28 interfaces 80 (introduced v7.6).
- Speed string
- Sets interface data transmission speed which takes effect only when
auto_negotiation
is disabled. - Tx
Flow stringControl - When set to on, the port will generate pause frames to the upstream device to temporarily stop the packet transmission. Pause frames are only generated when some routers output interface is congested and packets cannot be transmitted anymore. Auto is the same as on except when auto-negotiation=yes flow control status is resolved by taking into account what other end advertises.
- ___
id_ float64 - Resource ID type (.id / name). This is an internal service field, setting a value is not required.
- ___
path_ string - Resource path for CRUD operations. This is an internal service field, setting a value is not required.
- ___
skip_ string - A set of transformations for field names. This is an internal service field, setting a value is not required.
- factory
Name String - The factory name of the identifier, serves as resource identifier. Determines which interface will be updated.
- ___
id_ Double - Resource ID type (.id / name). This is an internal service field, setting a value is not required.
- ___
path_ String - Resource path for CRUD operations. This is an internal service field, setting a value is not required.
- ___
skip_ String - A set of transformations for field names. This is an internal service field, setting a value is not required.
- advertise String
- Advertised speed and duplex modes for Ethernet interfaces over twisted pair, only applies when auto-negotiation is enabled. Advertising higher speeds than the actual interface supported speed will have no effect, multiple options are allowed.
- arp String
- Address Resolution Protocol mode: * disabled - the interface will not use ARP * enabled - the interface will use ARP * local-proxy-arp - the router performs proxy ARP on the interface and sends replies to the same interface * proxy-arp - the router performs proxy ARP on the interface and sends replies to other interfaces * reply-only - the interface will only reply to requests originated from matching IP address/MAC address combinations which are entered as static entries in the ARP table. No dynamic entries will be automatically stored in the ARP table. Therefore for communications to be successful, a valid static entry must already exist.
- arp
Timeout String - ARP timeout is time how long ARP record is kept in ARP table after no packets are received from IP. Value auto equals to
the value of arp-timeout in IP/Settings, default is 30s. Can use postfix
ms
,s
,m
,h
,d
for milliseconds, seconds, minutes, hours or days. If no postfix is set then seconds (s) is used. - auto
Negotiation Boolean - When enabled, the interface "advertises" its maximum capabilities to achieve the best connection possible. Note1: Auto-negotiation should not be disabled on one end only, otherwise Ethernet Interfaces may not work properly. Note2: Gigabit Ethernet and NBASE-T Ethernet links cannot work with auto-negotiation disabled.
- bandwidth String
- Sets max rx/tx bandwidth in kbps that will be handled by an interface. TX limit is supported on all Atheros switch-chip ports. RX limit is supported only on Atheros8327/QCA8337 switch-chip ports.
- cable
Settings String - Changes the cable length setting (only applicable to NS DP83815/6 cards)
- combo
Mode String - When auto mode is selected, the port that was first connected will establish the link. In case this link fails, the other port will try to establish a new link. If both ports are connected at the same time (e.g. after reboot), the priority will be the SFP/SFP+ port. When sfp mode is selected, the interface will only work through SFP/SFP+ cage. When copper mode is selected, the interface will only work through RJ45 Ethernet port.
- comment String
- disable
Running BooleanCheck - Disable running check. If this value is set to 'no', the router automatically detects whether the NIC is connected with a device in the network or not. Default value is 'yes' because older NICs do not support it. (only applicable to x86)
- disabled Boolean
- fec
Mode String - Changes Forward Error Correction (FEC) mode for SFP28, QSFP+ and QSFP28 interfaces. Same mode should be used on both link ends, otherwise FEC mismatch could result in non-working link or even false link-ups.
- full
Duplex Boolean - Defines whether the transmission of data appears in two directions simultaneously, only applies when auto-negotiation is disabled.
- interface
Ethernet StringId - l2mtu Double
- Layer2 Maximum transmission unit. See.
- loop
Protect String - loop
Protect StringDisable Time - loop
Protect StringSend Interval - mac
Address String - Media Access Control number of an interface.
- mdix
Enable Boolean - Whether the MDI/X auto cross over cable correction feature is enabled for the port (Hardware specific, e.g. ether1 on RB500 can be set to yes/no. Fixed to 'yes' on other hardware.)
- mtu Double
- Layer3 Maximum transmission unit
- name String
- Name of the ethernet interface.
- poe
Lldp BooleanEnabled - An option that enables LLDP for managing devices.
- poe
Out String - PoE settings: (https://wiki.mikrotik.com/wiki/Manual:PoE-Out)
- poe
Priority Double - PoE settings: (https://wiki.mikrotik.com/wiki/Manual:PoE-Out)
- poe
Voltage String - An option that allows us to manually control the voltage outputs on the PoE port.
- power
Cycle StringInterval - An options that disables PoE-Out power for 5s between the specified intervals.
- power
Cycle StringPing Address - An address to monitor.
- power
Cycle BooleanPing Enabled - An option that enables ping watchdog of power cycles on the port if a host does not respond to ICMP or MAC-Telnet packets.
- power
Cycle StringPing Timeout - If the host does not respond over the specified period, the PoE-Out port is switched off for 5s.
- rx
Flow StringControl - When set to on, the port will process received pause frames and suspend transmission if required. auto is the same as on except when auto-negotiation=yes flow control status is resolved by taking into account what other end advertises.
- sfp
Ignore BooleanRx Los - An option to ignore RX LOS (Loss of Signal) status of the SFP module.
- sfp
Rate StringSelect - Allows to control rate select pin for SFP ports. Values: high | low
- sfp
Shutdown DoubleTemperature - The temperature in Celsius at which the interface will be temporarily turned off due to too high detected SFP module temperature (introduced v6.48).The default value for SFP/SFP+/SFP28 interfaces is 95, and for QSFP+/QSFP28 interfaces 80 (introduced v7.6).
- speed String
- Sets interface data transmission speed which takes effect only when
auto_negotiation
is disabled. - tx
Flow StringControl - When set to on, the port will generate pause frames to the upstream device to temporarily stop the packet transmission. Pause frames are only generated when some routers output interface is congested and packets cannot be transmitted anymore. Auto is the same as on except when auto-negotiation=yes flow control status is resolved by taking into account what other end advertises.
- factory
Name string - The factory name of the identifier, serves as resource identifier. Determines which interface will be updated.
- ___
id_ number - Resource ID type (.id / name). This is an internal service field, setting a value is not required.
- ___
path_ string - Resource path for CRUD operations. This is an internal service field, setting a value is not required.
- ___
skip_ string - A set of transformations for field names. This is an internal service field, setting a value is not required.
- advertise string
- Advertised speed and duplex modes for Ethernet interfaces over twisted pair, only applies when auto-negotiation is enabled. Advertising higher speeds than the actual interface supported speed will have no effect, multiple options are allowed.
- arp string
- Address Resolution Protocol mode: * disabled - the interface will not use ARP * enabled - the interface will use ARP * local-proxy-arp - the router performs proxy ARP on the interface and sends replies to the same interface * proxy-arp - the router performs proxy ARP on the interface and sends replies to other interfaces * reply-only - the interface will only reply to requests originated from matching IP address/MAC address combinations which are entered as static entries in the ARP table. No dynamic entries will be automatically stored in the ARP table. Therefore for communications to be successful, a valid static entry must already exist.
- arp
Timeout string - ARP timeout is time how long ARP record is kept in ARP table after no packets are received from IP. Value auto equals to
the value of arp-timeout in IP/Settings, default is 30s. Can use postfix
ms
,s
,m
,h
,d
for milliseconds, seconds, minutes, hours or days. If no postfix is set then seconds (s) is used. - auto
Negotiation boolean - When enabled, the interface "advertises" its maximum capabilities to achieve the best connection possible. Note1: Auto-negotiation should not be disabled on one end only, otherwise Ethernet Interfaces may not work properly. Note2: Gigabit Ethernet and NBASE-T Ethernet links cannot work with auto-negotiation disabled.
- bandwidth string
- Sets max rx/tx bandwidth in kbps that will be handled by an interface. TX limit is supported on all Atheros switch-chip ports. RX limit is supported only on Atheros8327/QCA8337 switch-chip ports.
- cable
Settings string - Changes the cable length setting (only applicable to NS DP83815/6 cards)
- combo
Mode string - When auto mode is selected, the port that was first connected will establish the link. In case this link fails, the other port will try to establish a new link. If both ports are connected at the same time (e.g. after reboot), the priority will be the SFP/SFP+ port. When sfp mode is selected, the interface will only work through SFP/SFP+ cage. When copper mode is selected, the interface will only work through RJ45 Ethernet port.
- comment string
- disable
Running booleanCheck - Disable running check. If this value is set to 'no', the router automatically detects whether the NIC is connected with a device in the network or not. Default value is 'yes' because older NICs do not support it. (only applicable to x86)
- disabled boolean
- fec
Mode string - Changes Forward Error Correction (FEC) mode for SFP28, QSFP+ and QSFP28 interfaces. Same mode should be used on both link ends, otherwise FEC mismatch could result in non-working link or even false link-ups.
- full
Duplex boolean - Defines whether the transmission of data appears in two directions simultaneously, only applies when auto-negotiation is disabled.
- interface
Ethernet stringId - l2mtu number
- Layer2 Maximum transmission unit. See.
- loop
Protect string - loop
Protect stringDisable Time - loop
Protect stringSend Interval - mac
Address string - Media Access Control number of an interface.
- mdix
Enable boolean - Whether the MDI/X auto cross over cable correction feature is enabled for the port (Hardware specific, e.g. ether1 on RB500 can be set to yes/no. Fixed to 'yes' on other hardware.)
- mtu number
- Layer3 Maximum transmission unit
- name string
- Name of the ethernet interface.
- poe
Lldp booleanEnabled - An option that enables LLDP for managing devices.
- poe
Out string - PoE settings: (https://wiki.mikrotik.com/wiki/Manual:PoE-Out)
- poe
Priority number - PoE settings: (https://wiki.mikrotik.com/wiki/Manual:PoE-Out)
- poe
Voltage string - An option that allows us to manually control the voltage outputs on the PoE port.
- power
Cycle stringInterval - An options that disables PoE-Out power for 5s between the specified intervals.
- power
Cycle stringPing Address - An address to monitor.
- power
Cycle booleanPing Enabled - An option that enables ping watchdog of power cycles on the port if a host does not respond to ICMP or MAC-Telnet packets.
- power
Cycle stringPing Timeout - If the host does not respond over the specified period, the PoE-Out port is switched off for 5s.
- rx
Flow stringControl - When set to on, the port will process received pause frames and suspend transmission if required. auto is the same as on except when auto-negotiation=yes flow control status is resolved by taking into account what other end advertises.
- sfp
Ignore booleanRx Los - An option to ignore RX LOS (Loss of Signal) status of the SFP module.
- sfp
Rate stringSelect - Allows to control rate select pin for SFP ports. Values: high | low
- sfp
Shutdown numberTemperature - The temperature in Celsius at which the interface will be temporarily turned off due to too high detected SFP module temperature (introduced v6.48).The default value for SFP/SFP+/SFP28 interfaces is 95, and for QSFP+/QSFP28 interfaces 80 (introduced v7.6).
- speed string
- Sets interface data transmission speed which takes effect only when
auto_negotiation
is disabled. - tx
Flow stringControl - When set to on, the port will generate pause frames to the upstream device to temporarily stop the packet transmission. Pause frames are only generated when some routers output interface is congested and packets cannot be transmitted anymore. Auto is the same as on except when auto-negotiation=yes flow control status is resolved by taking into account what other end advertises.
- factory_
name str - The factory name of the identifier, serves as resource identifier. Determines which interface will be updated.
- ___
id_ float - Resource ID type (.id / name). This is an internal service field, setting a value is not required.
- ___
path_ str - Resource path for CRUD operations. This is an internal service field, setting a value is not required.
- ___
skip_ str - A set of transformations for field names. This is an internal service field, setting a value is not required.
- advertise str
- Advertised speed and duplex modes for Ethernet interfaces over twisted pair, only applies when auto-negotiation is enabled. Advertising higher speeds than the actual interface supported speed will have no effect, multiple options are allowed.
- arp str
- Address Resolution Protocol mode: * disabled - the interface will not use ARP * enabled - the interface will use ARP * local-proxy-arp - the router performs proxy ARP on the interface and sends replies to the same interface * proxy-arp - the router performs proxy ARP on the interface and sends replies to other interfaces * reply-only - the interface will only reply to requests originated from matching IP address/MAC address combinations which are entered as static entries in the ARP table. No dynamic entries will be automatically stored in the ARP table. Therefore for communications to be successful, a valid static entry must already exist.
- arp_
timeout str - ARP timeout is time how long ARP record is kept in ARP table after no packets are received from IP. Value auto equals to
the value of arp-timeout in IP/Settings, default is 30s. Can use postfix
ms
,s
,m
,h
,d
for milliseconds, seconds, minutes, hours or days. If no postfix is set then seconds (s) is used. - auto_
negotiation bool - When enabled, the interface "advertises" its maximum capabilities to achieve the best connection possible. Note1: Auto-negotiation should not be disabled on one end only, otherwise Ethernet Interfaces may not work properly. Note2: Gigabit Ethernet and NBASE-T Ethernet links cannot work with auto-negotiation disabled.
- bandwidth str
- Sets max rx/tx bandwidth in kbps that will be handled by an interface. TX limit is supported on all Atheros switch-chip ports. RX limit is supported only on Atheros8327/QCA8337 switch-chip ports.
- cable_
settings str - Changes the cable length setting (only applicable to NS DP83815/6 cards)
- combo_
mode str - When auto mode is selected, the port that was first connected will establish the link. In case this link fails, the other port will try to establish a new link. If both ports are connected at the same time (e.g. after reboot), the priority will be the SFP/SFP+ port. When sfp mode is selected, the interface will only work through SFP/SFP+ cage. When copper mode is selected, the interface will only work through RJ45 Ethernet port.
- comment str
- disable_
running_ boolcheck - Disable running check. If this value is set to 'no', the router automatically detects whether the NIC is connected with a device in the network or not. Default value is 'yes' because older NICs do not support it. (only applicable to x86)
- disabled bool
- fec_
mode str - Changes Forward Error Correction (FEC) mode for SFP28, QSFP+ and QSFP28 interfaces. Same mode should be used on both link ends, otherwise FEC mismatch could result in non-working link or even false link-ups.
- full_
duplex bool - Defines whether the transmission of data appears in two directions simultaneously, only applies when auto-negotiation is disabled.
- interface_
ethernet_ strid - l2mtu float
- Layer2 Maximum transmission unit. See.
- loop_
protect str - loop_
protect_ strdisable_ time - loop_
protect_ strsend_ interval - mac_
address str - Media Access Control number of an interface.
- mdix_
enable bool - Whether the MDI/X auto cross over cable correction feature is enabled for the port (Hardware specific, e.g. ether1 on RB500 can be set to yes/no. Fixed to 'yes' on other hardware.)
- mtu float
- Layer3 Maximum transmission unit
- name str
- Name of the ethernet interface.
- poe_
lldp_ boolenabled - An option that enables LLDP for managing devices.
- poe_
out str - PoE settings: (https://wiki.mikrotik.com/wiki/Manual:PoE-Out)
- poe_
priority float - PoE settings: (https://wiki.mikrotik.com/wiki/Manual:PoE-Out)
- poe_
voltage str - An option that allows us to manually control the voltage outputs on the PoE port.
- power_
cycle_ strinterval - An options that disables PoE-Out power for 5s between the specified intervals.
- power_
cycle_ strping_ address - An address to monitor.
- power_
cycle_ boolping_ enabled - An option that enables ping watchdog of power cycles on the port if a host does not respond to ICMP or MAC-Telnet packets.
- power_
cycle_ strping_ timeout - If the host does not respond over the specified period, the PoE-Out port is switched off for 5s.
- rx_
flow_ strcontrol - When set to on, the port will process received pause frames and suspend transmission if required. auto is the same as on except when auto-negotiation=yes flow control status is resolved by taking into account what other end advertises.
- sfp_
ignore_ boolrx_ los - An option to ignore RX LOS (Loss of Signal) status of the SFP module.
- sfp_
rate_ strselect - Allows to control rate select pin for SFP ports. Values: high | low
- sfp_
shutdown_ floattemperature - The temperature in Celsius at which the interface will be temporarily turned off due to too high detected SFP module temperature (introduced v6.48).The default value for SFP/SFP+/SFP28 interfaces is 95, and for QSFP+/QSFP28 interfaces 80 (introduced v7.6).
- speed str
- Sets interface data transmission speed which takes effect only when
auto_negotiation
is disabled. - tx_
flow_ strcontrol - When set to on, the port will generate pause frames to the upstream device to temporarily stop the packet transmission. Pause frames are only generated when some routers output interface is congested and packets cannot be transmitted anymore. Auto is the same as on except when auto-negotiation=yes flow control status is resolved by taking into account what other end advertises.
- factory
Name String - The factory name of the identifier, serves as resource identifier. Determines which interface will be updated.
- ___
id_ Number - Resource ID type (.id / name). This is an internal service field, setting a value is not required.
- ___
path_ String - Resource path for CRUD operations. This is an internal service field, setting a value is not required.
- ___
skip_ String - A set of transformations for field names. This is an internal service field, setting a value is not required.
- advertise String
- Advertised speed and duplex modes for Ethernet interfaces over twisted pair, only applies when auto-negotiation is enabled. Advertising higher speeds than the actual interface supported speed will have no effect, multiple options are allowed.
- arp String
- Address Resolution Protocol mode: * disabled - the interface will not use ARP * enabled - the interface will use ARP * local-proxy-arp - the router performs proxy ARP on the interface and sends replies to the same interface * proxy-arp - the router performs proxy ARP on the interface and sends replies to other interfaces * reply-only - the interface will only reply to requests originated from matching IP address/MAC address combinations which are entered as static entries in the ARP table. No dynamic entries will be automatically stored in the ARP table. Therefore for communications to be successful, a valid static entry must already exist.
- arp
Timeout String - ARP timeout is time how long ARP record is kept in ARP table after no packets are received from IP. Value auto equals to
the value of arp-timeout in IP/Settings, default is 30s. Can use postfix
ms
,s
,m
,h
,d
for milliseconds, seconds, minutes, hours or days. If no postfix is set then seconds (s) is used. - auto
Negotiation Boolean - When enabled, the interface "advertises" its maximum capabilities to achieve the best connection possible. Note1: Auto-negotiation should not be disabled on one end only, otherwise Ethernet Interfaces may not work properly. Note2: Gigabit Ethernet and NBASE-T Ethernet links cannot work with auto-negotiation disabled.
- bandwidth String
- Sets max rx/tx bandwidth in kbps that will be handled by an interface. TX limit is supported on all Atheros switch-chip ports. RX limit is supported only on Atheros8327/QCA8337 switch-chip ports.
- cable
Settings String - Changes the cable length setting (only applicable to NS DP83815/6 cards)
- combo
Mode String - When auto mode is selected, the port that was first connected will establish the link. In case this link fails, the other port will try to establish a new link. If both ports are connected at the same time (e.g. after reboot), the priority will be the SFP/SFP+ port. When sfp mode is selected, the interface will only work through SFP/SFP+ cage. When copper mode is selected, the interface will only work through RJ45 Ethernet port.
- comment String
- disable
Running BooleanCheck - Disable running check. If this value is set to 'no', the router automatically detects whether the NIC is connected with a device in the network or not. Default value is 'yes' because older NICs do not support it. (only applicable to x86)
- disabled Boolean
- fec
Mode String - Changes Forward Error Correction (FEC) mode for SFP28, QSFP+ and QSFP28 interfaces. Same mode should be used on both link ends, otherwise FEC mismatch could result in non-working link or even false link-ups.
- full
Duplex Boolean - Defines whether the transmission of data appears in two directions simultaneously, only applies when auto-negotiation is disabled.
- interface
Ethernet StringId - l2mtu Number
- Layer2 Maximum transmission unit. See.
- loop
Protect String - loop
Protect StringDisable Time - loop
Protect StringSend Interval - mac
Address String - Media Access Control number of an interface.
- mdix
Enable Boolean - Whether the MDI/X auto cross over cable correction feature is enabled for the port (Hardware specific, e.g. ether1 on RB500 can be set to yes/no. Fixed to 'yes' on other hardware.)
- mtu Number
- Layer3 Maximum transmission unit
- name String
- Name of the ethernet interface.
- poe
Lldp BooleanEnabled - An option that enables LLDP for managing devices.
- poe
Out String - PoE settings: (https://wiki.mikrotik.com/wiki/Manual:PoE-Out)
- poe
Priority Number - PoE settings: (https://wiki.mikrotik.com/wiki/Manual:PoE-Out)
- poe
Voltage String - An option that allows us to manually control the voltage outputs on the PoE port.
- power
Cycle StringInterval - An options that disables PoE-Out power for 5s between the specified intervals.
- power
Cycle StringPing Address - An address to monitor.
- power
Cycle BooleanPing Enabled - An option that enables ping watchdog of power cycles on the port if a host does not respond to ICMP or MAC-Telnet packets.
- power
Cycle StringPing Timeout - If the host does not respond over the specified period, the PoE-Out port is switched off for 5s.
- rx
Flow StringControl - When set to on, the port will process received pause frames and suspend transmission if required. auto is the same as on except when auto-negotiation=yes flow control status is resolved by taking into account what other end advertises.
- sfp
Ignore BooleanRx Los - An option to ignore RX LOS (Loss of Signal) status of the SFP module.
- sfp
Rate StringSelect - Allows to control rate select pin for SFP ports. Values: high | low
- sfp
Shutdown NumberTemperature - The temperature in Celsius at which the interface will be temporarily turned off due to too high detected SFP module temperature (introduced v6.48).The default value for SFP/SFP+/SFP28 interfaces is 95, and for QSFP+/QSFP28 interfaces 80 (introduced v7.6).
- speed String
- Sets interface data transmission speed which takes effect only when
auto_negotiation
is disabled. - tx
Flow StringControl - When set to on, the port will generate pause frames to the upstream device to temporarily stop the packet transmission. Pause frames are only generated when some routers output interface is congested and packets cannot be transmitted anymore. Auto is the same as on except when auto-negotiation=yes flow control status is resolved by taking into account what other end advertises.
Outputs
All input properties are implicitly available as output properties. Additionally, the InterfaceEthernet resource produces the following output properties:
- Default
Name string - The default name for an interface.
- Id string
- The provider-assigned unique ID for this managed resource.
- Loop
Protect stringStatus - Orig
Mac stringAddress - Original Media Access Control number of an interface. (read only)
- Running bool
- Whether interface is running. Note that some interface does not have running check and they are always reported as "running"
- Slave bool
- Whether interface is configured as a slave of another interface (for example Bonding)
- Switch string
- ID to which switch chip interface belongs to.
- Default
Name string - The default name for an interface.
- Id string
- The provider-assigned unique ID for this managed resource.
- Loop
Protect stringStatus - Orig
Mac stringAddress - Original Media Access Control number of an interface. (read only)
- Running bool
- Whether interface is running. Note that some interface does not have running check and they are always reported as "running"
- Slave bool
- Whether interface is configured as a slave of another interface (for example Bonding)
- Switch string
- ID to which switch chip interface belongs to.
- default
Name String - The default name for an interface.
- id String
- The provider-assigned unique ID for this managed resource.
- loop
Protect StringStatus - orig
Mac StringAddress - Original Media Access Control number of an interface. (read only)
- running Boolean
- Whether interface is running. Note that some interface does not have running check and they are always reported as "running"
- slave Boolean
- Whether interface is configured as a slave of another interface (for example Bonding)
- switch_ String
- ID to which switch chip interface belongs to.
- default
Name string - The default name for an interface.
- id string
- The provider-assigned unique ID for this managed resource.
- loop
Protect stringStatus - orig
Mac stringAddress - Original Media Access Control number of an interface. (read only)
- running boolean
- Whether interface is running. Note that some interface does not have running check and they are always reported as "running"
- slave boolean
- Whether interface is configured as a slave of another interface (for example Bonding)
- switch string
- ID to which switch chip interface belongs to.
- default_
name str - The default name for an interface.
- id str
- The provider-assigned unique ID for this managed resource.
- loop_
protect_ strstatus - orig_
mac_ straddress - Original Media Access Control number of an interface. (read only)
- running bool
- Whether interface is running. Note that some interface does not have running check and they are always reported as "running"
- slave bool
- Whether interface is configured as a slave of another interface (for example Bonding)
- switch str
- ID to which switch chip interface belongs to.
- default
Name String - The default name for an interface.
- id String
- The provider-assigned unique ID for this managed resource.
- loop
Protect StringStatus - orig
Mac StringAddress - Original Media Access Control number of an interface. (read only)
- running Boolean
- Whether interface is running. Note that some interface does not have running check and they are always reported as "running"
- slave Boolean
- Whether interface is configured as a slave of another interface (for example Bonding)
- switch String
- ID to which switch chip interface belongs to.
Look up Existing InterfaceEthernet Resource
Get an existing InterfaceEthernet resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.
public static get(name: string, id: Input<ID>, state?: InterfaceEthernetState, opts?: CustomResourceOptions): InterfaceEthernet
@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
___id_: Optional[float] = None,
___path_: Optional[str] = None,
___skip_: Optional[str] = None,
advertise: Optional[str] = None,
arp: Optional[str] = None,
arp_timeout: Optional[str] = None,
auto_negotiation: Optional[bool] = None,
bandwidth: Optional[str] = None,
cable_settings: Optional[str] = None,
combo_mode: Optional[str] = None,
comment: Optional[str] = None,
default_name: Optional[str] = None,
disable_running_check: Optional[bool] = None,
disabled: Optional[bool] = None,
factory_name: Optional[str] = None,
fec_mode: Optional[str] = None,
full_duplex: Optional[bool] = None,
interface_ethernet_id: Optional[str] = None,
l2mtu: Optional[float] = None,
loop_protect: Optional[str] = None,
loop_protect_disable_time: Optional[str] = None,
loop_protect_send_interval: Optional[str] = None,
loop_protect_status: Optional[str] = None,
mac_address: Optional[str] = None,
mdix_enable: Optional[bool] = None,
mtu: Optional[float] = None,
name: Optional[str] = None,
orig_mac_address: Optional[str] = None,
poe_lldp_enabled: Optional[bool] = None,
poe_out: Optional[str] = None,
poe_priority: Optional[float] = None,
poe_voltage: Optional[str] = None,
power_cycle_interval: Optional[str] = None,
power_cycle_ping_address: Optional[str] = None,
power_cycle_ping_enabled: Optional[bool] = None,
power_cycle_ping_timeout: Optional[str] = None,
running: Optional[bool] = None,
rx_flow_control: Optional[str] = None,
sfp_ignore_rx_los: Optional[bool] = None,
sfp_rate_select: Optional[str] = None,
sfp_shutdown_temperature: Optional[float] = None,
slave: Optional[bool] = None,
speed: Optional[str] = None,
switch: Optional[str] = None,
tx_flow_control: Optional[str] = None) -> InterfaceEthernet
func GetInterfaceEthernet(ctx *Context, name string, id IDInput, state *InterfaceEthernetState, opts ...ResourceOption) (*InterfaceEthernet, error)
public static InterfaceEthernet Get(string name, Input<string> id, InterfaceEthernetState? state, CustomResourceOptions? opts = null)
public static InterfaceEthernet get(String name, Output<String> id, InterfaceEthernetState state, CustomResourceOptions options)
resources: _: type: routeros:InterfaceEthernet get: id: ${id}
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- resource_name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- Advertise string
- Advertised speed and duplex modes for Ethernet interfaces over twisted pair, only applies when auto-negotiation is enabled. Advertising higher speeds than the actual interface supported speed will have no effect, multiple options are allowed.
- Arp string
- Address Resolution Protocol mode: * disabled - the interface will not use ARP * enabled - the interface will use ARP * local-proxy-arp - the router performs proxy ARP on the interface and sends replies to the same interface * proxy-arp - the router performs proxy ARP on the interface and sends replies to other interfaces * reply-only - the interface will only reply to requests originated from matching IP address/MAC address combinations which are entered as static entries in the ARP table. No dynamic entries will be automatically stored in the ARP table. Therefore for communications to be successful, a valid static entry must already exist.
- Arp
Timeout string - ARP timeout is time how long ARP record is kept in ARP table after no packets are received from IP. Value auto equals to
the value of arp-timeout in IP/Settings, default is 30s. Can use postfix
ms
,s
,m
,h
,d
for milliseconds, seconds, minutes, hours or days. If no postfix is set then seconds (s) is used. - Auto
Negotiation bool - When enabled, the interface "advertises" its maximum capabilities to achieve the best connection possible. Note1: Auto-negotiation should not be disabled on one end only, otherwise Ethernet Interfaces may not work properly. Note2: Gigabit Ethernet and NBASE-T Ethernet links cannot work with auto-negotiation disabled.
- Bandwidth string
- Sets max rx/tx bandwidth in kbps that will be handled by an interface. TX limit is supported on all Atheros switch-chip ports. RX limit is supported only on Atheros8327/QCA8337 switch-chip ports.
- Cable
Settings string - Changes the cable length setting (only applicable to NS DP83815/6 cards)
- Combo
Mode string - When auto mode is selected, the port that was first connected will establish the link. In case this link fails, the other port will try to establish a new link. If both ports are connected at the same time (e.g. after reboot), the priority will be the SFP/SFP+ port. When sfp mode is selected, the interface will only work through SFP/SFP+ cage. When copper mode is selected, the interface will only work through RJ45 Ethernet port.
- Comment string
- Default
Name string - The default name for an interface.
- Disable
Running boolCheck - Disable running check. If this value is set to 'no', the router automatically detects whether the NIC is connected with a device in the network or not. Default value is 'yes' because older NICs do not support it. (only applicable to x86)
- Disabled bool
- Factory
Name string - The factory name of the identifier, serves as resource identifier. Determines which interface will be updated.
- Fec
Mode string - Changes Forward Error Correction (FEC) mode for SFP28, QSFP+ and QSFP28 interfaces. Same mode should be used on both link ends, otherwise FEC mismatch could result in non-working link or even false link-ups.
- Full
Duplex bool - Defines whether the transmission of data appears in two directions simultaneously, only applies when auto-negotiation is disabled.
- Interface
Ethernet stringId - L2mtu double
- Layer2 Maximum transmission unit. See.
- Loop
Protect string - Loop
Protect stringDisable Time - Loop
Protect stringSend Interval - Loop
Protect stringStatus - Mac
Address string - Media Access Control number of an interface.
- Mdix
Enable bool - Whether the MDI/X auto cross over cable correction feature is enabled for the port (Hardware specific, e.g. ether1 on RB500 can be set to yes/no. Fixed to 'yes' on other hardware.)
- Mtu double
- Layer3 Maximum transmission unit
- Name string
- Name of the ethernet interface.
- Orig
Mac stringAddress - Original Media Access Control number of an interface. (read only)
- Poe
Lldp boolEnabled - An option that enables LLDP for managing devices.
- Poe
Out string - PoE settings: (https://wiki.mikrotik.com/wiki/Manual:PoE-Out)
- Poe
Priority double - PoE settings: (https://wiki.mikrotik.com/wiki/Manual:PoE-Out)
- Poe
Voltage string - An option that allows us to manually control the voltage outputs on the PoE port.
- Power
Cycle stringInterval - An options that disables PoE-Out power for 5s between the specified intervals.
- Power
Cycle stringPing Address - An address to monitor.
- Power
Cycle boolPing Enabled - An option that enables ping watchdog of power cycles on the port if a host does not respond to ICMP or MAC-Telnet packets.
- Power
Cycle stringPing Timeout - If the host does not respond over the specified period, the PoE-Out port is switched off for 5s.
- Running bool
- Whether interface is running. Note that some interface does not have running check and they are always reported as "running"
- Rx
Flow stringControl - When set to on, the port will process received pause frames and suspend transmission if required. auto is the same as on except when auto-negotiation=yes flow control status is resolved by taking into account what other end advertises.
- Sfp
Ignore boolRx Los - An option to ignore RX LOS (Loss of Signal) status of the SFP module.
- Sfp
Rate stringSelect - Allows to control rate select pin for SFP ports. Values: high | low
- Sfp
Shutdown doubleTemperature - The temperature in Celsius at which the interface will be temporarily turned off due to too high detected SFP module temperature (introduced v6.48).The default value for SFP/SFP+/SFP28 interfaces is 95, and for QSFP+/QSFP28 interfaces 80 (introduced v7.6).
- Slave bool
- Whether interface is configured as a slave of another interface (for example Bonding)
- Speed string
- Sets interface data transmission speed which takes effect only when
auto_negotiation
is disabled. - Switch string
- ID to which switch chip interface belongs to.
- Tx
Flow stringControl - When set to on, the port will generate pause frames to the upstream device to temporarily stop the packet transmission. Pause frames are only generated when some routers output interface is congested and packets cannot be transmitted anymore. Auto is the same as on except when auto-negotiation=yes flow control status is resolved by taking into account what other end advertises.
- ___
id_ double - Resource ID type (.id / name). This is an internal service field, setting a value is not required.
- ___
path_ string - Resource path for CRUD operations. This is an internal service field, setting a value is not required.
- ___
skip_ string - A set of transformations for field names. This is an internal service field, setting a value is not required.
- Advertise string
- Advertised speed and duplex modes for Ethernet interfaces over twisted pair, only applies when auto-negotiation is enabled. Advertising higher speeds than the actual interface supported speed will have no effect, multiple options are allowed.
- Arp string
- Address Resolution Protocol mode: * disabled - the interface will not use ARP * enabled - the interface will use ARP * local-proxy-arp - the router performs proxy ARP on the interface and sends replies to the same interface * proxy-arp - the router performs proxy ARP on the interface and sends replies to other interfaces * reply-only - the interface will only reply to requests originated from matching IP address/MAC address combinations which are entered as static entries in the ARP table. No dynamic entries will be automatically stored in the ARP table. Therefore for communications to be successful, a valid static entry must already exist.
- Arp
Timeout string - ARP timeout is time how long ARP record is kept in ARP table after no packets are received from IP. Value auto equals to
the value of arp-timeout in IP/Settings, default is 30s. Can use postfix
ms
,s
,m
,h
,d
for milliseconds, seconds, minutes, hours or days. If no postfix is set then seconds (s) is used. - Auto
Negotiation bool - When enabled, the interface "advertises" its maximum capabilities to achieve the best connection possible. Note1: Auto-negotiation should not be disabled on one end only, otherwise Ethernet Interfaces may not work properly. Note2: Gigabit Ethernet and NBASE-T Ethernet links cannot work with auto-negotiation disabled.
- Bandwidth string
- Sets max rx/tx bandwidth in kbps that will be handled by an interface. TX limit is supported on all Atheros switch-chip ports. RX limit is supported only on Atheros8327/QCA8337 switch-chip ports.
- Cable
Settings string - Changes the cable length setting (only applicable to NS DP83815/6 cards)
- Combo
Mode string - When auto mode is selected, the port that was first connected will establish the link. In case this link fails, the other port will try to establish a new link. If both ports are connected at the same time (e.g. after reboot), the priority will be the SFP/SFP+ port. When sfp mode is selected, the interface will only work through SFP/SFP+ cage. When copper mode is selected, the interface will only work through RJ45 Ethernet port.
- Comment string
- Default
Name string - The default name for an interface.
- Disable
Running boolCheck - Disable running check. If this value is set to 'no', the router automatically detects whether the NIC is connected with a device in the network or not. Default value is 'yes' because older NICs do not support it. (only applicable to x86)
- Disabled bool
- Factory
Name string - The factory name of the identifier, serves as resource identifier. Determines which interface will be updated.
- Fec
Mode string - Changes Forward Error Correction (FEC) mode for SFP28, QSFP+ and QSFP28 interfaces. Same mode should be used on both link ends, otherwise FEC mismatch could result in non-working link or even false link-ups.
- Full
Duplex bool - Defines whether the transmission of data appears in two directions simultaneously, only applies when auto-negotiation is disabled.
- Interface
Ethernet stringId - L2mtu float64
- Layer2 Maximum transmission unit. See.
- Loop
Protect string - Loop
Protect stringDisable Time - Loop
Protect stringSend Interval - Loop
Protect stringStatus - Mac
Address string - Media Access Control number of an interface.
- Mdix
Enable bool - Whether the MDI/X auto cross over cable correction feature is enabled for the port (Hardware specific, e.g. ether1 on RB500 can be set to yes/no. Fixed to 'yes' on other hardware.)
- Mtu float64
- Layer3 Maximum transmission unit
- Name string
- Name of the ethernet interface.
- Orig
Mac stringAddress - Original Media Access Control number of an interface. (read only)
- Poe
Lldp boolEnabled - An option that enables LLDP for managing devices.
- Poe
Out string - PoE settings: (https://wiki.mikrotik.com/wiki/Manual:PoE-Out)
- Poe
Priority float64 - PoE settings: (https://wiki.mikrotik.com/wiki/Manual:PoE-Out)
- Poe
Voltage string - An option that allows us to manually control the voltage outputs on the PoE port.
- Power
Cycle stringInterval - An options that disables PoE-Out power for 5s between the specified intervals.
- Power
Cycle stringPing Address - An address to monitor.
- Power
Cycle boolPing Enabled - An option that enables ping watchdog of power cycles on the port if a host does not respond to ICMP or MAC-Telnet packets.
- Power
Cycle stringPing Timeout - If the host does not respond over the specified period, the PoE-Out port is switched off for 5s.
- Running bool
- Whether interface is running. Note that some interface does not have running check and they are always reported as "running"
- Rx
Flow stringControl - When set to on, the port will process received pause frames and suspend transmission if required. auto is the same as on except when auto-negotiation=yes flow control status is resolved by taking into account what other end advertises.
- Sfp
Ignore boolRx Los - An option to ignore RX LOS (Loss of Signal) status of the SFP module.
- Sfp
Rate stringSelect - Allows to control rate select pin for SFP ports. Values: high | low
- Sfp
Shutdown float64Temperature - The temperature in Celsius at which the interface will be temporarily turned off due to too high detected SFP module temperature (introduced v6.48).The default value for SFP/SFP+/SFP28 interfaces is 95, and for QSFP+/QSFP28 interfaces 80 (introduced v7.6).
- Slave bool
- Whether interface is configured as a slave of another interface (for example Bonding)
- Speed string
- Sets interface data transmission speed which takes effect only when
auto_negotiation
is disabled. - Switch string
- ID to which switch chip interface belongs to.
- Tx
Flow stringControl - When set to on, the port will generate pause frames to the upstream device to temporarily stop the packet transmission. Pause frames are only generated when some routers output interface is congested and packets cannot be transmitted anymore. Auto is the same as on except when auto-negotiation=yes flow control status is resolved by taking into account what other end advertises.
- ___
id_ float64 - Resource ID type (.id / name). This is an internal service field, setting a value is not required.
- ___
path_ string - Resource path for CRUD operations. This is an internal service field, setting a value is not required.
- ___
skip_ string - A set of transformations for field names. This is an internal service field, setting a value is not required.
- ___
id_ Double - Resource ID type (.id / name). This is an internal service field, setting a value is not required.
- ___
path_ String - Resource path for CRUD operations. This is an internal service field, setting a value is not required.
- ___
skip_ String - A set of transformations for field names. This is an internal service field, setting a value is not required.
- advertise String
- Advertised speed and duplex modes for Ethernet interfaces over twisted pair, only applies when auto-negotiation is enabled. Advertising higher speeds than the actual interface supported speed will have no effect, multiple options are allowed.
- arp String
- Address Resolution Protocol mode: * disabled - the interface will not use ARP * enabled - the interface will use ARP * local-proxy-arp - the router performs proxy ARP on the interface and sends replies to the same interface * proxy-arp - the router performs proxy ARP on the interface and sends replies to other interfaces * reply-only - the interface will only reply to requests originated from matching IP address/MAC address combinations which are entered as static entries in the ARP table. No dynamic entries will be automatically stored in the ARP table. Therefore for communications to be successful, a valid static entry must already exist.
- arp
Timeout String - ARP timeout is time how long ARP record is kept in ARP table after no packets are received from IP. Value auto equals to
the value of arp-timeout in IP/Settings, default is 30s. Can use postfix
ms
,s
,m
,h
,d
for milliseconds, seconds, minutes, hours or days. If no postfix is set then seconds (s) is used. - auto
Negotiation Boolean - When enabled, the interface "advertises" its maximum capabilities to achieve the best connection possible. Note1: Auto-negotiation should not be disabled on one end only, otherwise Ethernet Interfaces may not work properly. Note2: Gigabit Ethernet and NBASE-T Ethernet links cannot work with auto-negotiation disabled.
- bandwidth String
- Sets max rx/tx bandwidth in kbps that will be handled by an interface. TX limit is supported on all Atheros switch-chip ports. RX limit is supported only on Atheros8327/QCA8337 switch-chip ports.
- cable
Settings String - Changes the cable length setting (only applicable to NS DP83815/6 cards)
- combo
Mode String - When auto mode is selected, the port that was first connected will establish the link. In case this link fails, the other port will try to establish a new link. If both ports are connected at the same time (e.g. after reboot), the priority will be the SFP/SFP+ port. When sfp mode is selected, the interface will only work through SFP/SFP+ cage. When copper mode is selected, the interface will only work through RJ45 Ethernet port.
- comment String
- default
Name String - The default name for an interface.
- disable
Running BooleanCheck - Disable running check. If this value is set to 'no', the router automatically detects whether the NIC is connected with a device in the network or not. Default value is 'yes' because older NICs do not support it. (only applicable to x86)
- disabled Boolean
- factory
Name String - The factory name of the identifier, serves as resource identifier. Determines which interface will be updated.
- fec
Mode String - Changes Forward Error Correction (FEC) mode for SFP28, QSFP+ and QSFP28 interfaces. Same mode should be used on both link ends, otherwise FEC mismatch could result in non-working link or even false link-ups.
- full
Duplex Boolean - Defines whether the transmission of data appears in two directions simultaneously, only applies when auto-negotiation is disabled.
- interface
Ethernet StringId - l2mtu Double
- Layer2 Maximum transmission unit. See.
- loop
Protect String - loop
Protect StringDisable Time - loop
Protect StringSend Interval - loop
Protect StringStatus - mac
Address String - Media Access Control number of an interface.
- mdix
Enable Boolean - Whether the MDI/X auto cross over cable correction feature is enabled for the port (Hardware specific, e.g. ether1 on RB500 can be set to yes/no. Fixed to 'yes' on other hardware.)
- mtu Double
- Layer3 Maximum transmission unit
- name String
- Name of the ethernet interface.
- orig
Mac StringAddress - Original Media Access Control number of an interface. (read only)
- poe
Lldp BooleanEnabled - An option that enables LLDP for managing devices.
- poe
Out String - PoE settings: (https://wiki.mikrotik.com/wiki/Manual:PoE-Out)
- poe
Priority Double - PoE settings: (https://wiki.mikrotik.com/wiki/Manual:PoE-Out)
- poe
Voltage String - An option that allows us to manually control the voltage outputs on the PoE port.
- power
Cycle StringInterval - An options that disables PoE-Out power for 5s between the specified intervals.
- power
Cycle StringPing Address - An address to monitor.
- power
Cycle BooleanPing Enabled - An option that enables ping watchdog of power cycles on the port if a host does not respond to ICMP or MAC-Telnet packets.
- power
Cycle StringPing Timeout - If the host does not respond over the specified period, the PoE-Out port is switched off for 5s.
- running Boolean
- Whether interface is running. Note that some interface does not have running check and they are always reported as "running"
- rx
Flow StringControl - When set to on, the port will process received pause frames and suspend transmission if required. auto is the same as on except when auto-negotiation=yes flow control status is resolved by taking into account what other end advertises.
- sfp
Ignore BooleanRx Los - An option to ignore RX LOS (Loss of Signal) status of the SFP module.
- sfp
Rate StringSelect - Allows to control rate select pin for SFP ports. Values: high | low
- sfp
Shutdown DoubleTemperature - The temperature in Celsius at which the interface will be temporarily turned off due to too high detected SFP module temperature (introduced v6.48).The default value for SFP/SFP+/SFP28 interfaces is 95, and for QSFP+/QSFP28 interfaces 80 (introduced v7.6).
- slave Boolean
- Whether interface is configured as a slave of another interface (for example Bonding)
- speed String
- Sets interface data transmission speed which takes effect only when
auto_negotiation
is disabled. - switch_ String
- ID to which switch chip interface belongs to.
- tx
Flow StringControl - When set to on, the port will generate pause frames to the upstream device to temporarily stop the packet transmission. Pause frames are only generated when some routers output interface is congested and packets cannot be transmitted anymore. Auto is the same as on except when auto-negotiation=yes flow control status is resolved by taking into account what other end advertises.
- ___
id_ number - Resource ID type (.id / name). This is an internal service field, setting a value is not required.
- ___
path_ string - Resource path for CRUD operations. This is an internal service field, setting a value is not required.
- ___
skip_ string - A set of transformations for field names. This is an internal service field, setting a value is not required.
- advertise string
- Advertised speed and duplex modes for Ethernet interfaces over twisted pair, only applies when auto-negotiation is enabled. Advertising higher speeds than the actual interface supported speed will have no effect, multiple options are allowed.
- arp string
- Address Resolution Protocol mode: * disabled - the interface will not use ARP * enabled - the interface will use ARP * local-proxy-arp - the router performs proxy ARP on the interface and sends replies to the same interface * proxy-arp - the router performs proxy ARP on the interface and sends replies to other interfaces * reply-only - the interface will only reply to requests originated from matching IP address/MAC address combinations which are entered as static entries in the ARP table. No dynamic entries will be automatically stored in the ARP table. Therefore for communications to be successful, a valid static entry must already exist.
- arp
Timeout string - ARP timeout is time how long ARP record is kept in ARP table after no packets are received from IP. Value auto equals to
the value of arp-timeout in IP/Settings, default is 30s. Can use postfix
ms
,s
,m
,h
,d
for milliseconds, seconds, minutes, hours or days. If no postfix is set then seconds (s) is used. - auto
Negotiation boolean - When enabled, the interface "advertises" its maximum capabilities to achieve the best connection possible. Note1: Auto-negotiation should not be disabled on one end only, otherwise Ethernet Interfaces may not work properly. Note2: Gigabit Ethernet and NBASE-T Ethernet links cannot work with auto-negotiation disabled.
- bandwidth string
- Sets max rx/tx bandwidth in kbps that will be handled by an interface. TX limit is supported on all Atheros switch-chip ports. RX limit is supported only on Atheros8327/QCA8337 switch-chip ports.
- cable
Settings string - Changes the cable length setting (only applicable to NS DP83815/6 cards)
- combo
Mode string - When auto mode is selected, the port that was first connected will establish the link. In case this link fails, the other port will try to establish a new link. If both ports are connected at the same time (e.g. after reboot), the priority will be the SFP/SFP+ port. When sfp mode is selected, the interface will only work through SFP/SFP+ cage. When copper mode is selected, the interface will only work through RJ45 Ethernet port.
- comment string
- default
Name string - The default name for an interface.
- disable
Running booleanCheck - Disable running check. If this value is set to 'no', the router automatically detects whether the NIC is connected with a device in the network or not. Default value is 'yes' because older NICs do not support it. (only applicable to x86)
- disabled boolean
- factory
Name string - The factory name of the identifier, serves as resource identifier. Determines which interface will be updated.
- fec
Mode string - Changes Forward Error Correction (FEC) mode for SFP28, QSFP+ and QSFP28 interfaces. Same mode should be used on both link ends, otherwise FEC mismatch could result in non-working link or even false link-ups.
- full
Duplex boolean - Defines whether the transmission of data appears in two directions simultaneously, only applies when auto-negotiation is disabled.
- interface
Ethernet stringId - l2mtu number
- Layer2 Maximum transmission unit. See.
- loop
Protect string - loop
Protect stringDisable Time - loop
Protect stringSend Interval - loop
Protect stringStatus - mac
Address string - Media Access Control number of an interface.
- mdix
Enable boolean - Whether the MDI/X auto cross over cable correction feature is enabled for the port (Hardware specific, e.g. ether1 on RB500 can be set to yes/no. Fixed to 'yes' on other hardware.)
- mtu number
- Layer3 Maximum transmission unit
- name string
- Name of the ethernet interface.
- orig
Mac stringAddress - Original Media Access Control number of an interface. (read only)
- poe
Lldp booleanEnabled - An option that enables LLDP for managing devices.
- poe
Out string - PoE settings: (https://wiki.mikrotik.com/wiki/Manual:PoE-Out)
- poe
Priority number - PoE settings: (https://wiki.mikrotik.com/wiki/Manual:PoE-Out)
- poe
Voltage string - An option that allows us to manually control the voltage outputs on the PoE port.
- power
Cycle stringInterval - An options that disables PoE-Out power for 5s between the specified intervals.
- power
Cycle stringPing Address - An address to monitor.
- power
Cycle booleanPing Enabled - An option that enables ping watchdog of power cycles on the port if a host does not respond to ICMP or MAC-Telnet packets.
- power
Cycle stringPing Timeout - If the host does not respond over the specified period, the PoE-Out port is switched off for 5s.
- running boolean
- Whether interface is running. Note that some interface does not have running check and they are always reported as "running"
- rx
Flow stringControl - When set to on, the port will process received pause frames and suspend transmission if required. auto is the same as on except when auto-negotiation=yes flow control status is resolved by taking into account what other end advertises.
- sfp
Ignore booleanRx Los - An option to ignore RX LOS (Loss of Signal) status of the SFP module.
- sfp
Rate stringSelect - Allows to control rate select pin for SFP ports. Values: high | low
- sfp
Shutdown numberTemperature - The temperature in Celsius at which the interface will be temporarily turned off due to too high detected SFP module temperature (introduced v6.48).The default value for SFP/SFP+/SFP28 interfaces is 95, and for QSFP+/QSFP28 interfaces 80 (introduced v7.6).
- slave boolean
- Whether interface is configured as a slave of another interface (for example Bonding)
- speed string
- Sets interface data transmission speed which takes effect only when
auto_negotiation
is disabled. - switch string
- ID to which switch chip interface belongs to.
- tx
Flow stringControl - When set to on, the port will generate pause frames to the upstream device to temporarily stop the packet transmission. Pause frames are only generated when some routers output interface is congested and packets cannot be transmitted anymore. Auto is the same as on except when auto-negotiation=yes flow control status is resolved by taking into account what other end advertises.
- ___
id_ float - Resource ID type (.id / name). This is an internal service field, setting a value is not required.
- ___
path_ str - Resource path for CRUD operations. This is an internal service field, setting a value is not required.
- ___
skip_ str - A set of transformations for field names. This is an internal service field, setting a value is not required.
- advertise str
- Advertised speed and duplex modes for Ethernet interfaces over twisted pair, only applies when auto-negotiation is enabled. Advertising higher speeds than the actual interface supported speed will have no effect, multiple options are allowed.
- arp str
- Address Resolution Protocol mode: * disabled - the interface will not use ARP * enabled - the interface will use ARP * local-proxy-arp - the router performs proxy ARP on the interface and sends replies to the same interface * proxy-arp - the router performs proxy ARP on the interface and sends replies to other interfaces * reply-only - the interface will only reply to requests originated from matching IP address/MAC address combinations which are entered as static entries in the ARP table. No dynamic entries will be automatically stored in the ARP table. Therefore for communications to be successful, a valid static entry must already exist.
- arp_
timeout str - ARP timeout is time how long ARP record is kept in ARP table after no packets are received from IP. Value auto equals to
the value of arp-timeout in IP/Settings, default is 30s. Can use postfix
ms
,s
,m
,h
,d
for milliseconds, seconds, minutes, hours or days. If no postfix is set then seconds (s) is used. - auto_
negotiation bool - When enabled, the interface "advertises" its maximum capabilities to achieve the best connection possible. Note1: Auto-negotiation should not be disabled on one end only, otherwise Ethernet Interfaces may not work properly. Note2: Gigabit Ethernet and NBASE-T Ethernet links cannot work with auto-negotiation disabled.
- bandwidth str
- Sets max rx/tx bandwidth in kbps that will be handled by an interface. TX limit is supported on all Atheros switch-chip ports. RX limit is supported only on Atheros8327/QCA8337 switch-chip ports.
- cable_
settings str - Changes the cable length setting (only applicable to NS DP83815/6 cards)
- combo_
mode str - When auto mode is selected, the port that was first connected will establish the link. In case this link fails, the other port will try to establish a new link. If both ports are connected at the same time (e.g. after reboot), the priority will be the SFP/SFP+ port. When sfp mode is selected, the interface will only work through SFP/SFP+ cage. When copper mode is selected, the interface will only work through RJ45 Ethernet port.
- comment str
- default_
name str - The default name for an interface.
- disable_
running_ boolcheck - Disable running check. If this value is set to 'no', the router automatically detects whether the NIC is connected with a device in the network or not. Default value is 'yes' because older NICs do not support it. (only applicable to x86)
- disabled bool
- factory_
name str - The factory name of the identifier, serves as resource identifier. Determines which interface will be updated.
- fec_
mode str - Changes Forward Error Correction (FEC) mode for SFP28, QSFP+ and QSFP28 interfaces. Same mode should be used on both link ends, otherwise FEC mismatch could result in non-working link or even false link-ups.
- full_
duplex bool - Defines whether the transmission of data appears in two directions simultaneously, only applies when auto-negotiation is disabled.
- interface_
ethernet_ strid - l2mtu float
- Layer2 Maximum transmission unit. See.
- loop_
protect str - loop_
protect_ strdisable_ time - loop_
protect_ strsend_ interval - loop_
protect_ strstatus - mac_
address str - Media Access Control number of an interface.
- mdix_
enable bool - Whether the MDI/X auto cross over cable correction feature is enabled for the port (Hardware specific, e.g. ether1 on RB500 can be set to yes/no. Fixed to 'yes' on other hardware.)
- mtu float
- Layer3 Maximum transmission unit
- name str
- Name of the ethernet interface.
- orig_
mac_ straddress - Original Media Access Control number of an interface. (read only)
- poe_
lldp_ boolenabled - An option that enables LLDP for managing devices.
- poe_
out str - PoE settings: (https://wiki.mikrotik.com/wiki/Manual:PoE-Out)
- poe_
priority float - PoE settings: (https://wiki.mikrotik.com/wiki/Manual:PoE-Out)
- poe_
voltage str - An option that allows us to manually control the voltage outputs on the PoE port.
- power_
cycle_ strinterval - An options that disables PoE-Out power for 5s between the specified intervals.
- power_
cycle_ strping_ address - An address to monitor.
- power_
cycle_ boolping_ enabled - An option that enables ping watchdog of power cycles on the port if a host does not respond to ICMP or MAC-Telnet packets.
- power_
cycle_ strping_ timeout - If the host does not respond over the specified period, the PoE-Out port is switched off for 5s.
- running bool
- Whether interface is running. Note that some interface does not have running check and they are always reported as "running"
- rx_
flow_ strcontrol - When set to on, the port will process received pause frames and suspend transmission if required. auto is the same as on except when auto-negotiation=yes flow control status is resolved by taking into account what other end advertises.
- sfp_
ignore_ boolrx_ los - An option to ignore RX LOS (Loss of Signal) status of the SFP module.
- sfp_
rate_ strselect - Allows to control rate select pin for SFP ports. Values: high | low
- sfp_
shutdown_ floattemperature - The temperature in Celsius at which the interface will be temporarily turned off due to too high detected SFP module temperature (introduced v6.48).The default value for SFP/SFP+/SFP28 interfaces is 95, and for QSFP+/QSFP28 interfaces 80 (introduced v7.6).
- slave bool
- Whether interface is configured as a slave of another interface (for example Bonding)
- speed str
- Sets interface data transmission speed which takes effect only when
auto_negotiation
is disabled. - switch str
- ID to which switch chip interface belongs to.
- tx_
flow_ strcontrol - When set to on, the port will generate pause frames to the upstream device to temporarily stop the packet transmission. Pause frames are only generated when some routers output interface is congested and packets cannot be transmitted anymore. Auto is the same as on except when auto-negotiation=yes flow control status is resolved by taking into account what other end advertises.
- ___
id_ Number - Resource ID type (.id / name). This is an internal service field, setting a value is not required.
- ___
path_ String - Resource path for CRUD operations. This is an internal service field, setting a value is not required.
- ___
skip_ String - A set of transformations for field names. This is an internal service field, setting a value is not required.
- advertise String
- Advertised speed and duplex modes for Ethernet interfaces over twisted pair, only applies when auto-negotiation is enabled. Advertising higher speeds than the actual interface supported speed will have no effect, multiple options are allowed.
- arp String
- Address Resolution Protocol mode: * disabled - the interface will not use ARP * enabled - the interface will use ARP * local-proxy-arp - the router performs proxy ARP on the interface and sends replies to the same interface * proxy-arp - the router performs proxy ARP on the interface and sends replies to other interfaces * reply-only - the interface will only reply to requests originated from matching IP address/MAC address combinations which are entered as static entries in the ARP table. No dynamic entries will be automatically stored in the ARP table. Therefore for communications to be successful, a valid static entry must already exist.
- arp
Timeout String - ARP timeout is time how long ARP record is kept in ARP table after no packets are received from IP. Value auto equals to
the value of arp-timeout in IP/Settings, default is 30s. Can use postfix
ms
,s
,m
,h
,d
for milliseconds, seconds, minutes, hours or days. If no postfix is set then seconds (s) is used. - auto
Negotiation Boolean - When enabled, the interface "advertises" its maximum capabilities to achieve the best connection possible. Note1: Auto-negotiation should not be disabled on one end only, otherwise Ethernet Interfaces may not work properly. Note2: Gigabit Ethernet and NBASE-T Ethernet links cannot work with auto-negotiation disabled.
- bandwidth String
- Sets max rx/tx bandwidth in kbps that will be handled by an interface. TX limit is supported on all Atheros switch-chip ports. RX limit is supported only on Atheros8327/QCA8337 switch-chip ports.
- cable
Settings String - Changes the cable length setting (only applicable to NS DP83815/6 cards)
- combo
Mode String - When auto mode is selected, the port that was first connected will establish the link. In case this link fails, the other port will try to establish a new link. If both ports are connected at the same time (e.g. after reboot), the priority will be the SFP/SFP+ port. When sfp mode is selected, the interface will only work through SFP/SFP+ cage. When copper mode is selected, the interface will only work through RJ45 Ethernet port.
- comment String
- default
Name String - The default name for an interface.
- disable
Running BooleanCheck - Disable running check. If this value is set to 'no', the router automatically detects whether the NIC is connected with a device in the network or not. Default value is 'yes' because older NICs do not support it. (only applicable to x86)
- disabled Boolean
- factory
Name String - The factory name of the identifier, serves as resource identifier. Determines which interface will be updated.
- fec
Mode String - Changes Forward Error Correction (FEC) mode for SFP28, QSFP+ and QSFP28 interfaces. Same mode should be used on both link ends, otherwise FEC mismatch could result in non-working link or even false link-ups.
- full
Duplex Boolean - Defines whether the transmission of data appears in two directions simultaneously, only applies when auto-negotiation is disabled.
- interface
Ethernet StringId - l2mtu Number
- Layer2 Maximum transmission unit. See.
- loop
Protect String - loop
Protect StringDisable Time - loop
Protect StringSend Interval - loop
Protect StringStatus - mac
Address String - Media Access Control number of an interface.
- mdix
Enable Boolean - Whether the MDI/X auto cross over cable correction feature is enabled for the port (Hardware specific, e.g. ether1 on RB500 can be set to yes/no. Fixed to 'yes' on other hardware.)
- mtu Number
- Layer3 Maximum transmission unit
- name String
- Name of the ethernet interface.
- orig
Mac StringAddress - Original Media Access Control number of an interface. (read only)
- poe
Lldp BooleanEnabled - An option that enables LLDP for managing devices.
- poe
Out String - PoE settings: (https://wiki.mikrotik.com/wiki/Manual:PoE-Out)
- poe
Priority Number - PoE settings: (https://wiki.mikrotik.com/wiki/Manual:PoE-Out)
- poe
Voltage String - An option that allows us to manually control the voltage outputs on the PoE port.
- power
Cycle StringInterval - An options that disables PoE-Out power for 5s between the specified intervals.
- power
Cycle StringPing Address - An address to monitor.
- power
Cycle BooleanPing Enabled - An option that enables ping watchdog of power cycles on the port if a host does not respond to ICMP or MAC-Telnet packets.
- power
Cycle StringPing Timeout - If the host does not respond over the specified period, the PoE-Out port is switched off for 5s.
- running Boolean
- Whether interface is running. Note that some interface does not have running check and they are always reported as "running"
- rx
Flow StringControl - When set to on, the port will process received pause frames and suspend transmission if required. auto is the same as on except when auto-negotiation=yes flow control status is resolved by taking into account what other end advertises.
- sfp
Ignore BooleanRx Los - An option to ignore RX LOS (Loss of Signal) status of the SFP module.
- sfp
Rate StringSelect - Allows to control rate select pin for SFP ports. Values: high | low
- sfp
Shutdown NumberTemperature - The temperature in Celsius at which the interface will be temporarily turned off due to too high detected SFP module temperature (introduced v6.48).The default value for SFP/SFP+/SFP28 interfaces is 95, and for QSFP+/QSFP28 interfaces 80 (introduced v7.6).
- slave Boolean
- Whether interface is configured as a slave of another interface (for example Bonding)
- speed String
- Sets interface data transmission speed which takes effect only when
auto_negotiation
is disabled. - switch String
- ID to which switch chip interface belongs to.
- tx
Flow StringControl - When set to on, the port will generate pause frames to the upstream device to temporarily stop the packet transmission. Pause frames are only generated when some routers output interface is congested and packets cannot be transmitted anymore. Auto is the same as on except when auto-negotiation=yes flow control status is resolved by taking into account what other end advertises.
Import
#The ID can be found via API or the terminal
#The command for the terminal is -> :put [/interface/ethernet get [print show-ids]]
$ pulumi import routeros:index/interfaceEthernet:InterfaceEthernet test "*0"
To learn more about importing existing cloud resources, see Importing resources.
Package Details
- Repository
- routeros terraform-routeros/terraform-provider-routeros
- License
- Notes
- This Pulumi package is based on the
routeros
Terraform Provider.