routeros 1.83.0, Apr 16 25

routeros 1.83.0 published on Wednesday, Apr 16, 2025 by terraform-routeros

terraform-routeros/terraform-provider-routeros

routeros.BridgePort

Explore with Pulumi AI

routeros 1.83.0 published on Wednesday, Apr 16, 2025 by terraform-routeros

terraform-routeros/terraform-provider-routeros

# routeros.BridgePort (Resource)

This is an alias for backwards compatibility between plugin versions.

Please see documentation for routeros.InterfaceBridgePort

Create BridgePort Resource

Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

Constructor syntax

new BridgePort(name: string, args: BridgePortArgs, opts?: CustomResourceOptions);

@overload
def BridgePort(resource_name: str,
               args: BridgePortArgs,
               opts: Optional[ResourceOptions] = None)

@overload
def BridgePort(resource_name: str,
               opts: Optional[ResourceOptions] = None,
               bridge: Optional[str] = None,
               interface: Optional[str] = None,
               comment: Optional[str] = None,
               path_cost: Optional[str] = None,
               bpdu_guard: Optional[bool] = None,
               ___skip_: Optional[str] = None,
               bridge_port_id: Optional[str] = None,
               broadcast_flood: Optional[bool] = None,
               ___id_: Optional[float] = None,
               disabled: Optional[bool] = None,
               edge: Optional[str] = None,
               fast_leave: Optional[bool] = None,
               frame_types: Optional[str] = None,
               horizon: Optional[str] = None,
               hw: Optional[bool] = None,
               ingress_filtering: Optional[bool] = None,
               auto_isolate: Optional[bool] = None,
               ___path_: Optional[str] = None,
               priority: Optional[str] = None,
               multicast_router: Optional[str] = None,
               mvrp_applicant_state: Optional[str] = None,
               mvrp_registrar_state: Optional[str] = None,
               internal_path_cost: Optional[float] = None,
               point_to_point: Optional[str] = None,
               learn: Optional[str] = None,
               pvid: Optional[float] = None,
               restricted_role: Optional[bool] = None,
               restricted_tcn: Optional[bool] = None,
               tag_stacking: Optional[bool] = None,
               trusted: Optional[bool] = None,
               unknown_multicast_flood: Optional[bool] = None,
               unknown_unicast_flood: Optional[bool] = None)

func NewBridgePort(ctx *Context, name string, args BridgePortArgs, opts ...ResourceOption) (*BridgePort, error)

public BridgePort(string name, BridgePortArgs args, CustomResourceOptions? opts = null)

public BridgePort(String name, BridgePortArgs args)
public BridgePort(String name, BridgePortArgs args, CustomResourceOptions options)

type: routeros:BridgePort
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 BridgePortArgs: 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 BridgePortArgs: 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 BridgePortArgs: The arguments to resource properties.
opts ResourceOption: Bag of options to control resource's behavior.

name string: The unique name of the resource.
args BridgePortArgs: The arguments to resource properties.
opts CustomResourceOptions: Bag of options to control resource's behavior.

name String: The unique name of the resource.
args BridgePortArgs: The arguments to resource properties.
options CustomResourceOptions: Bag of options to control resource's behavior.

BridgePort 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 BridgePort resource accepts the following input properties:

Bridge string
Interface string: Name of the interface.
AutoIsolate bool: When enabled, prevents a port moving from discarding into forwarding state if no BPDUs are received from the neighboring bridge. The port will change into a forwarding state only when a BPDU is received. This property only has an effect when protocol-mode is set to rstp or mstp and edge is set to no.
BpduGuard bool: This property has no effect when protocol-mode is set to none.
BridgePortId string
BroadcastFlood bool: When enabled, bridge floods broadcast traffic to all bridge egress ports. When disabled, drops broadcast traffic on egress ports.
Comment string
Disabled bool
Edge string: Set port as edge port or non-edge port, or enable edge discovery. Edge ports are connected to a LAN that has no other bridges attached.
FastLeave bool: Enables IGMP Fast leave feature on the port.
FrameTypes string: Specifies allowed ingress frame types on a bridge port. This property only has effect when vlan-filtering is set to yes.
Horizon string: Use split horizon bridging to prevent bridging loops. Set the same value for group of ports, to prevent them from sending data to ports with the same horizon value. Split horizon is a software feature that disables hardware offloading. This value is integer '0'..'429496729' or 'none'.
Hw bool: Enable or disable Hardware Offloading of the interface.
IngressFiltering bool: Enables or disables VLAN ingress filtering, which checks if the ingress port is a member of the received VLAN ID in the bridge VLAN table. Should be used with frame-types to specify if the ingress traffic should be tagged or untagged. This property only has effect when vlan-filtering is set to yes.
InternalPathCost double: Path cost to the interface for MSTI0 inside a region. This property only has effect when protocol-mode is set to mstp.
Learn string: Changes MAC learning behaviour on a bridge port
MulticastRouter string: Changes the state of a bridge port whether IGMP membership reports are going to be forwarded to this port.
MvrpApplicantState string: MVRP applicant options (available since RouterOS 7.15): - non-participant - port does not send any MRP messages; - normal-participant - port participates normally in MRP exchanges.
MvrpRegistrarState string: MVRP registrar options (available since RouterOS 7.15): - fixed - port ignores all MRP messages, and remains Registered (IN) in all configured vlans. - normal - port receives MRP messages and handles them according to the standard.
PathCost string: Path cost to the interface, used by STP to determine the "best" path, used by MSTP todetermine "best" path between regions. This property has no effect when protocol-mode is set to none.
PointToPoint string: Specifies if a bridge port is connected to a bridge using a point-to-point link for faster convergence in case of failure. This property has no effect when protocol-mode is set to none.
Priority string: The priority of the interface, used by STP to determine the root port, used by MSTP to determine root port between regions.
Pvid double: ort VLAN ID (pvid) specifies which VLAN the untagged ingress traffic is assigned to. This property only has effect when vlan-filtering is set to yes.
RestrictedRole bool: Enable the restricted role on a port, used by STP to forbid a port becoming a root port. This property only has effect when protocol-mode is set to mstp.
RestrictedTcn bool: Disable topology change notification (TCN) sending on a port, used by STP to forbid network topology changes to propagate. This property only has effect when protocol-mode is set to mstp.
TagStacking bool: Forces all packets to be treated as untagged packets. Packets on ingress port will be tagged with another VLAN tag regardless if a VLAN tag already exists, packets will be tagged with a VLAN ID that matches the pvid value and will use EtherType that is specified in ether-type. This property only has effect when vlan-filtering is set to yes.
Trusted bool: When enabled, it allows to forward DHCP packets towards DHCP server through this port. Mainly used to limit unauthorized servers to provide malicious information for users. This property only has effect when dhcp-snooping is set to yes.
UnknownMulticastFlood bool: When enabled, bridge floods unknown multicast traffic to all bridge egress ports.
UnknownUnicastFlood bool: When enabled, bridge floods unknown unicast traffic to all bridge egress ports.
___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.

Bridge string
Interface string: Name of the interface.
AutoIsolate bool: When enabled, prevents a port moving from discarding into forwarding state if no BPDUs are received from the neighboring bridge. The port will change into a forwarding state only when a BPDU is received. This property only has an effect when protocol-mode is set to rstp or mstp and edge is set to no.
BpduGuard bool: This property has no effect when protocol-mode is set to none.
BridgePortId string
BroadcastFlood bool: When enabled, bridge floods broadcast traffic to all bridge egress ports. When disabled, drops broadcast traffic on egress ports.
Comment string
Disabled bool
Edge string: Set port as edge port or non-edge port, or enable edge discovery. Edge ports are connected to a LAN that has no other bridges attached.
FastLeave bool: Enables IGMP Fast leave feature on the port.
FrameTypes string: Specifies allowed ingress frame types on a bridge port. This property only has effect when vlan-filtering is set to yes.
Horizon string: Use split horizon bridging to prevent bridging loops. Set the same value for group of ports, to prevent them from sending data to ports with the same horizon value. Split horizon is a software feature that disables hardware offloading. This value is integer '0'..'429496729' or 'none'.
Hw bool: Enable or disable Hardware Offloading of the interface.
IngressFiltering bool: Enables or disables VLAN ingress filtering, which checks if the ingress port is a member of the received VLAN ID in the bridge VLAN table. Should be used with frame-types to specify if the ingress traffic should be tagged or untagged. This property only has effect when vlan-filtering is set to yes.
InternalPathCost float64: Path cost to the interface for MSTI0 inside a region. This property only has effect when protocol-mode is set to mstp.
Learn string: Changes MAC learning behaviour on a bridge port
MulticastRouter string: Changes the state of a bridge port whether IGMP membership reports are going to be forwarded to this port.
MvrpApplicantState string: MVRP applicant options (available since RouterOS 7.15): - non-participant - port does not send any MRP messages; - normal-participant - port participates normally in MRP exchanges.
MvrpRegistrarState string: MVRP registrar options (available since RouterOS 7.15): - fixed - port ignores all MRP messages, and remains Registered (IN) in all configured vlans. - normal - port receives MRP messages and handles them according to the standard.
PathCost string: Path cost to the interface, used by STP to determine the "best" path, used by MSTP todetermine "best" path between regions. This property has no effect when protocol-mode is set to none.
PointToPoint string: Specifies if a bridge port is connected to a bridge using a point-to-point link for faster convergence in case of failure. This property has no effect when protocol-mode is set to none.
Priority string: The priority of the interface, used by STP to determine the root port, used by MSTP to determine root port between regions.
Pvid float64: ort VLAN ID (pvid) specifies which VLAN the untagged ingress traffic is assigned to. This property only has effect when vlan-filtering is set to yes.
RestrictedRole bool: Enable the restricted role on a port, used by STP to forbid a port becoming a root port. This property only has effect when protocol-mode is set to mstp.
RestrictedTcn bool: Disable topology change notification (TCN) sending on a port, used by STP to forbid network topology changes to propagate. This property only has effect when protocol-mode is set to mstp.
TagStacking bool: Forces all packets to be treated as untagged packets. Packets on ingress port will be tagged with another VLAN tag regardless if a VLAN tag already exists, packets will be tagged with a VLAN ID that matches the pvid value and will use EtherType that is specified in ether-type. This property only has effect when vlan-filtering is set to yes.
Trusted bool: When enabled, it allows to forward DHCP packets towards DHCP server through this port. Mainly used to limit unauthorized servers to provide malicious information for users. This property only has effect when dhcp-snooping is set to yes.
UnknownMulticastFlood bool: When enabled, bridge floods unknown multicast traffic to all bridge egress ports.
UnknownUnicastFlood bool: When enabled, bridge floods unknown unicast traffic to all bridge egress ports.
___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.

bridge String
interface_ String: Name of the interface.
___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.
autoIsolate Boolean: When enabled, prevents a port moving from discarding into forwarding state if no BPDUs are received from the neighboring bridge. The port will change into a forwarding state only when a BPDU is received. This property only has an effect when protocol-mode is set to rstp or mstp and edge is set to no.
bpduGuard Boolean: This property has no effect when protocol-mode is set to none.
bridgePortId String
broadcastFlood Boolean: When enabled, bridge floods broadcast traffic to all bridge egress ports. When disabled, drops broadcast traffic on egress ports.
comment String
disabled Boolean
edge String: Set port as edge port or non-edge port, or enable edge discovery. Edge ports are connected to a LAN that has no other bridges attached.
fastLeave Boolean: Enables IGMP Fast leave feature on the port.
frameTypes String: Specifies allowed ingress frame types on a bridge port. This property only has effect when vlan-filtering is set to yes.
horizon String: Use split horizon bridging to prevent bridging loops. Set the same value for group of ports, to prevent them from sending data to ports with the same horizon value. Split horizon is a software feature that disables hardware offloading. This value is integer '0'..'429496729' or 'none'.
hw Boolean: Enable or disable Hardware Offloading of the interface.
ingressFiltering Boolean: Enables or disables VLAN ingress filtering, which checks if the ingress port is a member of the received VLAN ID in the bridge VLAN table. Should be used with frame-types to specify if the ingress traffic should be tagged or untagged. This property only has effect when vlan-filtering is set to yes.
internalPathCost Double: Path cost to the interface for MSTI0 inside a region. This property only has effect when protocol-mode is set to mstp.
learn String: Changes MAC learning behaviour on a bridge port
multicastRouter String: Changes the state of a bridge port whether IGMP membership reports are going to be forwarded to this port.
mvrpApplicantState String: MVRP applicant options (available since RouterOS 7.15): - non-participant - port does not send any MRP messages; - normal-participant - port participates normally in MRP exchanges.
mvrpRegistrarState String: MVRP registrar options (available since RouterOS 7.15): - fixed - port ignores all MRP messages, and remains Registered (IN) in all configured vlans. - normal - port receives MRP messages and handles them according to the standard.
pathCost String: Path cost to the interface, used by STP to determine the "best" path, used by MSTP todetermine "best" path between regions. This property has no effect when protocol-mode is set to none.
pointToPoint String: Specifies if a bridge port is connected to a bridge using a point-to-point link for faster convergence in case of failure. This property has no effect when protocol-mode is set to none.
priority String: The priority of the interface, used by STP to determine the root port, used by MSTP to determine root port between regions.
pvid Double: ort VLAN ID (pvid) specifies which VLAN the untagged ingress traffic is assigned to. This property only has effect when vlan-filtering is set to yes.
restrictedRole Boolean: Enable the restricted role on a port, used by STP to forbid a port becoming a root port. This property only has effect when protocol-mode is set to mstp.
restrictedTcn Boolean: Disable topology change notification (TCN) sending on a port, used by STP to forbid network topology changes to propagate. This property only has effect when protocol-mode is set to mstp.
tagStacking Boolean: Forces all packets to be treated as untagged packets. Packets on ingress port will be tagged with another VLAN tag regardless if a VLAN tag already exists, packets will be tagged with a VLAN ID that matches the pvid value and will use EtherType that is specified in ether-type. This property only has effect when vlan-filtering is set to yes.
trusted Boolean: When enabled, it allows to forward DHCP packets towards DHCP server through this port. Mainly used to limit unauthorized servers to provide malicious information for users. This property only has effect when dhcp-snooping is set to yes.
unknownMulticastFlood Boolean: When enabled, bridge floods unknown multicast traffic to all bridge egress ports.
unknownUnicastFlood Boolean: When enabled, bridge floods unknown unicast traffic to all bridge egress ports.

bridge string
interface string: Name of the interface.
___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.
autoIsolate boolean: When enabled, prevents a port moving from discarding into forwarding state if no BPDUs are received from the neighboring bridge. The port will change into a forwarding state only when a BPDU is received. This property only has an effect when protocol-mode is set to rstp or mstp and edge is set to no.
bpduGuard boolean: This property has no effect when protocol-mode is set to none.
bridgePortId string
broadcastFlood boolean: When enabled, bridge floods broadcast traffic to all bridge egress ports. When disabled, drops broadcast traffic on egress ports.
comment string
disabled boolean
edge string: Set port as edge port or non-edge port, or enable edge discovery. Edge ports are connected to a LAN that has no other bridges attached.
fastLeave boolean: Enables IGMP Fast leave feature on the port.
frameTypes string: Specifies allowed ingress frame types on a bridge port. This property only has effect when vlan-filtering is set to yes.
horizon string: Use split horizon bridging to prevent bridging loops. Set the same value for group of ports, to prevent them from sending data to ports with the same horizon value. Split horizon is a software feature that disables hardware offloading. This value is integer '0'..'429496729' or 'none'.
hw boolean: Enable or disable Hardware Offloading of the interface.
ingressFiltering boolean: Enables or disables VLAN ingress filtering, which checks if the ingress port is a member of the received VLAN ID in the bridge VLAN table. Should be used with frame-types to specify if the ingress traffic should be tagged or untagged. This property only has effect when vlan-filtering is set to yes.
internalPathCost number: Path cost to the interface for MSTI0 inside a region. This property only has effect when protocol-mode is set to mstp.
learn string: Changes MAC learning behaviour on a bridge port
multicastRouter string: Changes the state of a bridge port whether IGMP membership reports are going to be forwarded to this port.
mvrpApplicantState string: MVRP applicant options (available since RouterOS 7.15): - non-participant - port does not send any MRP messages; - normal-participant - port participates normally in MRP exchanges.
mvrpRegistrarState string: MVRP registrar options (available since RouterOS 7.15): - fixed - port ignores all MRP messages, and remains Registered (IN) in all configured vlans. - normal - port receives MRP messages and handles them according to the standard.
pathCost string: Path cost to the interface, used by STP to determine the "best" path, used by MSTP todetermine "best" path between regions. This property has no effect when protocol-mode is set to none.
pointToPoint string: Specifies if a bridge port is connected to a bridge using a point-to-point link for faster convergence in case of failure. This property has no effect when protocol-mode is set to none.
priority string: The priority of the interface, used by STP to determine the root port, used by MSTP to determine root port between regions.
pvid number: ort VLAN ID (pvid) specifies which VLAN the untagged ingress traffic is assigned to. This property only has effect when vlan-filtering is set to yes.
restrictedRole boolean: Enable the restricted role on a port, used by STP to forbid a port becoming a root port. This property only has effect when protocol-mode is set to mstp.
restrictedTcn boolean: Disable topology change notification (TCN) sending on a port, used by STP to forbid network topology changes to propagate. This property only has effect when protocol-mode is set to mstp.
tagStacking boolean: Forces all packets to be treated as untagged packets. Packets on ingress port will be tagged with another VLAN tag regardless if a VLAN tag already exists, packets will be tagged with a VLAN ID that matches the pvid value and will use EtherType that is specified in ether-type. This property only has effect when vlan-filtering is set to yes.
trusted boolean: When enabled, it allows to forward DHCP packets towards DHCP server through this port. Mainly used to limit unauthorized servers to provide malicious information for users. This property only has effect when dhcp-snooping is set to yes.
unknownMulticastFlood boolean: When enabled, bridge floods unknown multicast traffic to all bridge egress ports.
unknownUnicastFlood boolean: When enabled, bridge floods unknown unicast traffic to all bridge egress ports.

bridge str
interface str: Name of the interface.
___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.
auto_isolate bool: When enabled, prevents a port moving from discarding into forwarding state if no BPDUs are received from the neighboring bridge. The port will change into a forwarding state only when a BPDU is received. This property only has an effect when protocol-mode is set to rstp or mstp and edge is set to no.
bpdu_guard bool: This property has no effect when protocol-mode is set to none.
bridge_port_id str
broadcast_flood bool: When enabled, bridge floods broadcast traffic to all bridge egress ports. When disabled, drops broadcast traffic on egress ports.
comment str
disabled bool
edge str: Set port as edge port or non-edge port, or enable edge discovery. Edge ports are connected to a LAN that has no other bridges attached.
fast_leave bool: Enables IGMP Fast leave feature on the port.
frame_types str: Specifies allowed ingress frame types on a bridge port. This property only has effect when vlan-filtering is set to yes.
horizon str: Use split horizon bridging to prevent bridging loops. Set the same value for group of ports, to prevent them from sending data to ports with the same horizon value. Split horizon is a software feature that disables hardware offloading. This value is integer '0'..'429496729' or 'none'.
hw bool: Enable or disable Hardware Offloading of the interface.
ingress_filtering bool: Enables or disables VLAN ingress filtering, which checks if the ingress port is a member of the received VLAN ID in the bridge VLAN table. Should be used with frame-types to specify if the ingress traffic should be tagged or untagged. This property only has effect when vlan-filtering is set to yes.
internal_path_cost float: Path cost to the interface for MSTI0 inside a region. This property only has effect when protocol-mode is set to mstp.
learn str: Changes MAC learning behaviour on a bridge port
multicast_router str: Changes the state of a bridge port whether IGMP membership reports are going to be forwarded to this port.
mvrp_applicant_state str: MVRP applicant options (available since RouterOS 7.15): - non-participant - port does not send any MRP messages; - normal-participant - port participates normally in MRP exchanges.
mvrp_registrar_state str: MVRP registrar options (available since RouterOS 7.15): - fixed - port ignores all MRP messages, and remains Registered (IN) in all configured vlans. - normal - port receives MRP messages and handles them according to the standard.
path_cost str: Path cost to the interface, used by STP to determine the "best" path, used by MSTP todetermine "best" path between regions. This property has no effect when protocol-mode is set to none.
point_to_point str: Specifies if a bridge port is connected to a bridge using a point-to-point link for faster convergence in case of failure. This property has no effect when protocol-mode is set to none.
priority str: The priority of the interface, used by STP to determine the root port, used by MSTP to determine root port between regions.
pvid float: ort VLAN ID (pvid) specifies which VLAN the untagged ingress traffic is assigned to. This property only has effect when vlan-filtering is set to yes.
restricted_role bool: Enable the restricted role on a port, used by STP to forbid a port becoming a root port. This property only has effect when protocol-mode is set to mstp.
restricted_tcn bool: Disable topology change notification (TCN) sending on a port, used by STP to forbid network topology changes to propagate. This property only has effect when protocol-mode is set to mstp.
tag_stacking bool: Forces all packets to be treated as untagged packets. Packets on ingress port will be tagged with another VLAN tag regardless if a VLAN tag already exists, packets will be tagged with a VLAN ID that matches the pvid value and will use EtherType that is specified in ether-type. This property only has effect when vlan-filtering is set to yes.
trusted bool: When enabled, it allows to forward DHCP packets towards DHCP server through this port. Mainly used to limit unauthorized servers to provide malicious information for users. This property only has effect when dhcp-snooping is set to yes.
unknown_multicast_flood bool: When enabled, bridge floods unknown multicast traffic to all bridge egress ports.
unknown_unicast_flood bool: When enabled, bridge floods unknown unicast traffic to all bridge egress ports.

bridge String
interface String: Name of the interface.
___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.
autoIsolate Boolean: When enabled, prevents a port moving from discarding into forwarding state if no BPDUs are received from the neighboring bridge. The port will change into a forwarding state only when a BPDU is received. This property only has an effect when protocol-mode is set to rstp or mstp and edge is set to no.
bpduGuard Boolean: This property has no effect when protocol-mode is set to none.
bridgePortId String
broadcastFlood Boolean: When enabled, bridge floods broadcast traffic to all bridge egress ports. When disabled, drops broadcast traffic on egress ports.
comment String
disabled Boolean
edge String: Set port as edge port or non-edge port, or enable edge discovery. Edge ports are connected to a LAN that has no other bridges attached.
fastLeave Boolean: Enables IGMP Fast leave feature on the port.
frameTypes String: Specifies allowed ingress frame types on a bridge port. This property only has effect when vlan-filtering is set to yes.
horizon String: Use split horizon bridging to prevent bridging loops. Set the same value for group of ports, to prevent them from sending data to ports with the same horizon value. Split horizon is a software feature that disables hardware offloading. This value is integer '0'..'429496729' or 'none'.
hw Boolean: Enable or disable Hardware Offloading of the interface.
ingressFiltering Boolean: Enables or disables VLAN ingress filtering, which checks if the ingress port is a member of the received VLAN ID in the bridge VLAN table. Should be used with frame-types to specify if the ingress traffic should be tagged or untagged. This property only has effect when vlan-filtering is set to yes.
internalPathCost Number: Path cost to the interface for MSTI0 inside a region. This property only has effect when protocol-mode is set to mstp.
learn String: Changes MAC learning behaviour on a bridge port
multicastRouter String: Changes the state of a bridge port whether IGMP membership reports are going to be forwarded to this port.
mvrpApplicantState String: MVRP applicant options (available since RouterOS 7.15): - non-participant - port does not send any MRP messages; - normal-participant - port participates normally in MRP exchanges.
mvrpRegistrarState String: MVRP registrar options (available since RouterOS 7.15): - fixed - port ignores all MRP messages, and remains Registered (IN) in all configured vlans. - normal - port receives MRP messages and handles them according to the standard.
pathCost String: Path cost to the interface, used by STP to determine the "best" path, used by MSTP todetermine "best" path between regions. This property has no effect when protocol-mode is set to none.
pointToPoint String: Specifies if a bridge port is connected to a bridge using a point-to-point link for faster convergence in case of failure. This property has no effect when protocol-mode is set to none.
priority String: The priority of the interface, used by STP to determine the root port, used by MSTP to determine root port between regions.
pvid Number: ort VLAN ID (pvid) specifies which VLAN the untagged ingress traffic is assigned to. This property only has effect when vlan-filtering is set to yes.
restrictedRole Boolean: Enable the restricted role on a port, used by STP to forbid a port becoming a root port. This property only has effect when protocol-mode is set to mstp.
restrictedTcn Boolean: Disable topology change notification (TCN) sending on a port, used by STP to forbid network topology changes to propagate. This property only has effect when protocol-mode is set to mstp.
tagStacking Boolean: Forces all packets to be treated as untagged packets. Packets on ingress port will be tagged with another VLAN tag regardless if a VLAN tag already exists, packets will be tagged with a VLAN ID that matches the pvid value and will use EtherType that is specified in ether-type. This property only has effect when vlan-filtering is set to yes.
trusted Boolean: When enabled, it allows to forward DHCP packets towards DHCP server through this port. Mainly used to limit unauthorized servers to provide malicious information for users. This property only has effect when dhcp-snooping is set to yes.
unknownMulticastFlood Boolean: When enabled, bridge floods unknown multicast traffic to all bridge egress ports.
unknownUnicastFlood Boolean: When enabled, bridge floods unknown unicast traffic to all bridge egress ports.

Outputs

All input properties are implicitly available as output properties. Additionally, the BridgePort resource produces the following output properties:

DesignatedBridge string: Root bridge ID (bridge priority and the bridge MAC address).
DesignatedCost string: Designated cost.
DesignatedPortNumber double: Designated port number.
Dynamic bool: Configuration item created by software, not by management interface. It is not exported, and cannot be directly modified.
EdgePort bool: Whether port is an edge port or not.
EdgePortDiscovery bool: Whether port is set to automatically detect edge ports.
ExternalFdbStatus bool: Whether registration table is used instead of forwarding data base.
Forwarding bool: Shows if the port is not blocked by (R/M)STP.
HwOffload bool: Hardware offloading state.
HwOffloadGroup string: Switch chip used by the port.
Id string: The provider-assigned unique ID for this managed resource.
Inactive bool
Learning bool: Shows whether the port is capable of learning MAC addresses.
Nextid string
PointToPointPort bool: Whether the port is connected to a bridge port using full-duplex (true) or half-duplex (false).
Role string: (R/M)STP algorithm assigned role of the port
RootPathCost double: The total cost of the path to the root-bridge.
SendingRstp string: Whether the port is sending RSTP or MSTP BPDU types. A port will transit to STP type when RSTP/MSTP enabled port receives a STP BPDU
Status string: Port status ('in-bridge' - port is enabled).

DesignatedBridge string: Root bridge ID (bridge priority and the bridge MAC address).
DesignatedCost string: Designated cost.
DesignatedPortNumber float64: Designated port number.
Dynamic bool: Configuration item created by software, not by management interface. It is not exported, and cannot be directly modified.
EdgePort bool: Whether port is an edge port or not.
EdgePortDiscovery bool: Whether port is set to automatically detect edge ports.
ExternalFdbStatus bool: Whether registration table is used instead of forwarding data base.
Forwarding bool: Shows if the port is not blocked by (R/M)STP.
HwOffload bool: Hardware offloading state.
HwOffloadGroup string: Switch chip used by the port.
Id string: The provider-assigned unique ID for this managed resource.
Inactive bool
Learning bool: Shows whether the port is capable of learning MAC addresses.
Nextid string
PointToPointPort bool: Whether the port is connected to a bridge port using full-duplex (true) or half-duplex (false).
Role string: (R/M)STP algorithm assigned role of the port
RootPathCost float64: The total cost of the path to the root-bridge.
SendingRstp string: Whether the port is sending RSTP or MSTP BPDU types. A port will transit to STP type when RSTP/MSTP enabled port receives a STP BPDU
Status string: Port status ('in-bridge' - port is enabled).

designatedBridge String: Root bridge ID (bridge priority and the bridge MAC address).
designatedCost String: Designated cost.
designatedPortNumber Double: Designated port number.
dynamic Boolean: Configuration item created by software, not by management interface. It is not exported, and cannot be directly modified.
edgePort Boolean: Whether port is an edge port or not.
edgePortDiscovery Boolean: Whether port is set to automatically detect edge ports.
externalFdbStatus Boolean: Whether registration table is used instead of forwarding data base.
forwarding Boolean: Shows if the port is not blocked by (R/M)STP.
hwOffload Boolean: Hardware offloading state.
hwOffloadGroup String: Switch chip used by the port.
id String: The provider-assigned unique ID for this managed resource.
inactive Boolean
learning Boolean: Shows whether the port is capable of learning MAC addresses.
nextid String
pointToPointPort Boolean: Whether the port is connected to a bridge port using full-duplex (true) or half-duplex (false).
role String: (R/M)STP algorithm assigned role of the port
rootPathCost Double: The total cost of the path to the root-bridge.
sendingRstp String: Whether the port is sending RSTP or MSTP BPDU types. A port will transit to STP type when RSTP/MSTP enabled port receives a STP BPDU
status String: Port status ('in-bridge' - port is enabled).

designatedBridge string: Root bridge ID (bridge priority and the bridge MAC address).
designatedCost string: Designated cost.
designatedPortNumber number: Designated port number.
dynamic boolean: Configuration item created by software, not by management interface. It is not exported, and cannot be directly modified.
edgePort boolean: Whether port is an edge port or not.
edgePortDiscovery boolean: Whether port is set to automatically detect edge ports.
externalFdbStatus boolean: Whether registration table is used instead of forwarding data base.
forwarding boolean: Shows if the port is not blocked by (R/M)STP.
hwOffload boolean: Hardware offloading state.
hwOffloadGroup string: Switch chip used by the port.
id string: The provider-assigned unique ID for this managed resource.
inactive boolean
learning boolean: Shows whether the port is capable of learning MAC addresses.
nextid string
pointToPointPort boolean: Whether the port is connected to a bridge port using full-duplex (true) or half-duplex (false).
role string: (R/M)STP algorithm assigned role of the port
rootPathCost number: The total cost of the path to the root-bridge.
sendingRstp string: Whether the port is sending RSTP or MSTP BPDU types. A port will transit to STP type when RSTP/MSTP enabled port receives a STP BPDU
status string: Port status ('in-bridge' - port is enabled).

designated_bridge str: Root bridge ID (bridge priority and the bridge MAC address).
designated_cost str: Designated cost.
designated_port_number float: Designated port number.
dynamic bool: Configuration item created by software, not by management interface. It is not exported, and cannot be directly modified.
edge_port bool: Whether port is an edge port or not.
edge_port_discovery bool: Whether port is set to automatically detect edge ports.
external_fdb_status bool: Whether registration table is used instead of forwarding data base.
forwarding bool: Shows if the port is not blocked by (R/M)STP.
hw_offload bool: Hardware offloading state.
hw_offload_group str: Switch chip used by the port.
id str: The provider-assigned unique ID for this managed resource.
inactive bool
learning bool: Shows whether the port is capable of learning MAC addresses.
nextid str
point_to_point_port bool: Whether the port is connected to a bridge port using full-duplex (true) or half-duplex (false).
role str: (R/M)STP algorithm assigned role of the port
root_path_cost float: The total cost of the path to the root-bridge.
sending_rstp str: Whether the port is sending RSTP or MSTP BPDU types. A port will transit to STP type when RSTP/MSTP enabled port receives a STP BPDU
status str: Port status ('in-bridge' - port is enabled).

designatedBridge String: Root bridge ID (bridge priority and the bridge MAC address).
designatedCost String: Designated cost.
designatedPortNumber Number: Designated port number.
dynamic Boolean: Configuration item created by software, not by management interface. It is not exported, and cannot be directly modified.
edgePort Boolean: Whether port is an edge port or not.
edgePortDiscovery Boolean: Whether port is set to automatically detect edge ports.
externalFdbStatus Boolean: Whether registration table is used instead of forwarding data base.
forwarding Boolean: Shows if the port is not blocked by (R/M)STP.
hwOffload Boolean: Hardware offloading state.
hwOffloadGroup String: Switch chip used by the port.
id String: The provider-assigned unique ID for this managed resource.
inactive Boolean
learning Boolean: Shows whether the port is capable of learning MAC addresses.
nextid String
pointToPointPort Boolean: Whether the port is connected to a bridge port using full-duplex (true) or half-duplex (false).
role String: (R/M)STP algorithm assigned role of the port
rootPathCost Number: The total cost of the path to the root-bridge.
sendingRstp String: Whether the port is sending RSTP or MSTP BPDU types. A port will transit to STP type when RSTP/MSTP enabled port receives a STP BPDU
status String: Port status ('in-bridge' - port is enabled).

Look up Existing BridgePort Resource

Get an existing BridgePort 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?: BridgePortState, opts?: CustomResourceOptions): BridgePort

@staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        ___id_: Optional[float] = None,
        ___path_: Optional[str] = None,
        ___skip_: Optional[str] = None,
        auto_isolate: Optional[bool] = None,
        bpdu_guard: Optional[bool] = None,
        bridge: Optional[str] = None,
        bridge_port_id: Optional[str] = None,
        broadcast_flood: Optional[bool] = None,
        comment: Optional[str] = None,
        designated_bridge: Optional[str] = None,
        designated_cost: Optional[str] = None,
        designated_port_number: Optional[float] = None,
        disabled: Optional[bool] = None,
        dynamic: Optional[bool] = None,
        edge: Optional[str] = None,
        edge_port: Optional[bool] = None,
        edge_port_discovery: Optional[bool] = None,
        external_fdb_status: Optional[bool] = None,
        fast_leave: Optional[bool] = None,
        forwarding: Optional[bool] = None,
        frame_types: Optional[str] = None,
        horizon: Optional[str] = None,
        hw: Optional[bool] = None,
        hw_offload: Optional[bool] = None,
        hw_offload_group: Optional[str] = None,
        inactive: Optional[bool] = None,
        ingress_filtering: Optional[bool] = None,
        interface: Optional[str] = None,
        internal_path_cost: Optional[float] = None,
        learn: Optional[str] = None,
        learning: Optional[bool] = None,
        multicast_router: Optional[str] = None,
        mvrp_applicant_state: Optional[str] = None,
        mvrp_registrar_state: Optional[str] = None,
        nextid: Optional[str] = None,
        path_cost: Optional[str] = None,
        point_to_point: Optional[str] = None,
        point_to_point_port: Optional[bool] = None,
        priority: Optional[str] = None,
        pvid: Optional[float] = None,
        restricted_role: Optional[bool] = None,
        restricted_tcn: Optional[bool] = None,
        role: Optional[str] = None,
        root_path_cost: Optional[float] = None,
        sending_rstp: Optional[str] = None,
        status: Optional[str] = None,
        tag_stacking: Optional[bool] = None,
        trusted: Optional[bool] = None,
        unknown_multicast_flood: Optional[bool] = None,
        unknown_unicast_flood: Optional[bool] = None) -> BridgePort

func GetBridgePort(ctx *Context, name string, id IDInput, state *BridgePortState, opts ...ResourceOption) (*BridgePort, error)

public static BridgePort Get(string name, Input<string> id, BridgePortState? state, CustomResourceOptions? opts = null)

public static BridgePort get(String name, Output<String> id, BridgePortState state, CustomResourceOptions options)

resources:  _:    type: routeros:BridgePort    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.

The following state arguments are supported:

AutoIsolate bool: When enabled, prevents a port moving from discarding into forwarding state if no BPDUs are received from the neighboring bridge. The port will change into a forwarding state only when a BPDU is received. This property only has an effect when protocol-mode is set to rstp or mstp and edge is set to no.
BpduGuard bool: This property has no effect when protocol-mode is set to none.
Bridge string
BridgePortId string
BroadcastFlood bool: When enabled, bridge floods broadcast traffic to all bridge egress ports. When disabled, drops broadcast traffic on egress ports.
Comment string
DesignatedBridge string: Root bridge ID (bridge priority and the bridge MAC address).
DesignatedCost string: Designated cost.
DesignatedPortNumber double: Designated port number.
Disabled bool
Dynamic bool: Configuration item created by software, not by management interface. It is not exported, and cannot be directly modified.
Edge string: Set port as edge port or non-edge port, or enable edge discovery. Edge ports are connected to a LAN that has no other bridges attached.
EdgePort bool: Whether port is an edge port or not.
EdgePortDiscovery bool: Whether port is set to automatically detect edge ports.
ExternalFdbStatus bool: Whether registration table is used instead of forwarding data base.
FastLeave bool: Enables IGMP Fast leave feature on the port.
Forwarding bool: Shows if the port is not blocked by (R/M)STP.
FrameTypes string: Specifies allowed ingress frame types on a bridge port. This property only has effect when vlan-filtering is set to yes.
Horizon string: Use split horizon bridging to prevent bridging loops. Set the same value for group of ports, to prevent them from sending data to ports with the same horizon value. Split horizon is a software feature that disables hardware offloading. This value is integer '0'..'429496729' or 'none'.
Hw bool: Enable or disable Hardware Offloading of the interface.
HwOffload bool: Hardware offloading state.
HwOffloadGroup string: Switch chip used by the port.
Inactive bool
IngressFiltering bool: Enables or disables VLAN ingress filtering, which checks if the ingress port is a member of the received VLAN ID in the bridge VLAN table. Should be used with frame-types to specify if the ingress traffic should be tagged or untagged. This property only has effect when vlan-filtering is set to yes.
Interface string: Name of the interface.
InternalPathCost double: Path cost to the interface for MSTI0 inside a region. This property only has effect when protocol-mode is set to mstp.
Learn string: Changes MAC learning behaviour on a bridge port
Learning bool: Shows whether the port is capable of learning MAC addresses.
MulticastRouter string: Changes the state of a bridge port whether IGMP membership reports are going to be forwarded to this port.
MvrpApplicantState string: MVRP applicant options (available since RouterOS 7.15): - non-participant - port does not send any MRP messages; - normal-participant - port participates normally in MRP exchanges.
MvrpRegistrarState string: MVRP registrar options (available since RouterOS 7.15): - fixed - port ignores all MRP messages, and remains Registered (IN) in all configured vlans. - normal - port receives MRP messages and handles them according to the standard.
Nextid string
PathCost string: Path cost to the interface, used by STP to determine the "best" path, used by MSTP todetermine "best" path between regions. This property has no effect when protocol-mode is set to none.
PointToPoint string: Specifies if a bridge port is connected to a bridge using a point-to-point link for faster convergence in case of failure. This property has no effect when protocol-mode is set to none.
PointToPointPort bool: Whether the port is connected to a bridge port using full-duplex (true) or half-duplex (false).
Priority string: The priority of the interface, used by STP to determine the root port, used by MSTP to determine root port between regions.
Pvid double: ort VLAN ID (pvid) specifies which VLAN the untagged ingress traffic is assigned to. This property only has effect when vlan-filtering is set to yes.
RestrictedRole bool: Enable the restricted role on a port, used by STP to forbid a port becoming a root port. This property only has effect when protocol-mode is set to mstp.
RestrictedTcn bool: Disable topology change notification (TCN) sending on a port, used by STP to forbid network topology changes to propagate. This property only has effect when protocol-mode is set to mstp.
Role string: (R/M)STP algorithm assigned role of the port
RootPathCost double: The total cost of the path to the root-bridge.
SendingRstp string: Whether the port is sending RSTP or MSTP BPDU types. A port will transit to STP type when RSTP/MSTP enabled port receives a STP BPDU
Status string: Port status ('in-bridge' - port is enabled).
TagStacking bool: Forces all packets to be treated as untagged packets. Packets on ingress port will be tagged with another VLAN tag regardless if a VLAN tag already exists, packets will be tagged with a VLAN ID that matches the pvid value and will use EtherType that is specified in ether-type. This property only has effect when vlan-filtering is set to yes.
Trusted bool: When enabled, it allows to forward DHCP packets towards DHCP server through this port. Mainly used to limit unauthorized servers to provide malicious information for users. This property only has effect when dhcp-snooping is set to yes.
UnknownMulticastFlood bool: When enabled, bridge floods unknown multicast traffic to all bridge egress ports.
UnknownUnicastFlood bool: When enabled, bridge floods unknown unicast traffic to all bridge egress ports.
___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.

AutoIsolate bool: When enabled, prevents a port moving from discarding into forwarding state if no BPDUs are received from the neighboring bridge. The port will change into a forwarding state only when a BPDU is received. This property only has an effect when protocol-mode is set to rstp or mstp and edge is set to no.
BpduGuard bool: This property has no effect when protocol-mode is set to none.
Bridge string
BridgePortId string
BroadcastFlood bool: When enabled, bridge floods broadcast traffic to all bridge egress ports. When disabled, drops broadcast traffic on egress ports.
Comment string
DesignatedBridge string: Root bridge ID (bridge priority and the bridge MAC address).
DesignatedCost string: Designated cost.
DesignatedPortNumber float64: Designated port number.
Disabled bool
Dynamic bool: Configuration item created by software, not by management interface. It is not exported, and cannot be directly modified.
Edge string: Set port as edge port or non-edge port, or enable edge discovery. Edge ports are connected to a LAN that has no other bridges attached.
EdgePort bool: Whether port is an edge port or not.
EdgePortDiscovery bool: Whether port is set to automatically detect edge ports.
ExternalFdbStatus bool: Whether registration table is used instead of forwarding data base.
FastLeave bool: Enables IGMP Fast leave feature on the port.
Forwarding bool: Shows if the port is not blocked by (R/M)STP.
FrameTypes string: Specifies allowed ingress frame types on a bridge port. This property only has effect when vlan-filtering is set to yes.
Horizon string: Use split horizon bridging to prevent bridging loops. Set the same value for group of ports, to prevent them from sending data to ports with the same horizon value. Split horizon is a software feature that disables hardware offloading. This value is integer '0'..'429496729' or 'none'.
Hw bool: Enable or disable Hardware Offloading of the interface.
HwOffload bool: Hardware offloading state.
HwOffloadGroup string: Switch chip used by the port.
Inactive bool
IngressFiltering bool: Enables or disables VLAN ingress filtering, which checks if the ingress port is a member of the received VLAN ID in the bridge VLAN table. Should be used with frame-types to specify if the ingress traffic should be tagged or untagged. This property only has effect when vlan-filtering is set to yes.
Interface string: Name of the interface.
InternalPathCost float64: Path cost to the interface for MSTI0 inside a region. This property only has effect when protocol-mode is set to mstp.
Learn string: Changes MAC learning behaviour on a bridge port
Learning bool: Shows whether the port is capable of learning MAC addresses.
MulticastRouter string: Changes the state of a bridge port whether IGMP membership reports are going to be forwarded to this port.
MvrpApplicantState string: MVRP applicant options (available since RouterOS 7.15): - non-participant - port does not send any MRP messages; - normal-participant - port participates normally in MRP exchanges.
MvrpRegistrarState string: MVRP registrar options (available since RouterOS 7.15): - fixed - port ignores all MRP messages, and remains Registered (IN) in all configured vlans. - normal - port receives MRP messages and handles them according to the standard.
Nextid string
PathCost string: Path cost to the interface, used by STP to determine the "best" path, used by MSTP todetermine "best" path between regions. This property has no effect when protocol-mode is set to none.
PointToPoint string: Specifies if a bridge port is connected to a bridge using a point-to-point link for faster convergence in case of failure. This property has no effect when protocol-mode is set to none.
PointToPointPort bool: Whether the port is connected to a bridge port using full-duplex (true) or half-duplex (false).
Priority string: The priority of the interface, used by STP to determine the root port, used by MSTP to determine root port between regions.
Pvid float64: ort VLAN ID (pvid) specifies which VLAN the untagged ingress traffic is assigned to. This property only has effect when vlan-filtering is set to yes.
RestrictedRole bool: Enable the restricted role on a port, used by STP to forbid a port becoming a root port. This property only has effect when protocol-mode is set to mstp.
RestrictedTcn bool: Disable topology change notification (TCN) sending on a port, used by STP to forbid network topology changes to propagate. This property only has effect when protocol-mode is set to mstp.
Role string: (R/M)STP algorithm assigned role of the port
RootPathCost float64: The total cost of the path to the root-bridge.
SendingRstp string: Whether the port is sending RSTP or MSTP BPDU types. A port will transit to STP type when RSTP/MSTP enabled port receives a STP BPDU
Status string: Port status ('in-bridge' - port is enabled).
TagStacking bool: Forces all packets to be treated as untagged packets. Packets on ingress port will be tagged with another VLAN tag regardless if a VLAN tag already exists, packets will be tagged with a VLAN ID that matches the pvid value and will use EtherType that is specified in ether-type. This property only has effect when vlan-filtering is set to yes.
Trusted bool: When enabled, it allows to forward DHCP packets towards DHCP server through this port. Mainly used to limit unauthorized servers to provide malicious information for users. This property only has effect when dhcp-snooping is set to yes.
UnknownMulticastFlood bool: When enabled, bridge floods unknown multicast traffic to all bridge egress ports.
UnknownUnicastFlood bool: When enabled, bridge floods unknown unicast traffic to all bridge egress ports.
___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.
autoIsolate Boolean: When enabled, prevents a port moving from discarding into forwarding state if no BPDUs are received from the neighboring bridge. The port will change into a forwarding state only when a BPDU is received. This property only has an effect when protocol-mode is set to rstp or mstp and edge is set to no.
bpduGuard Boolean: This property has no effect when protocol-mode is set to none.
bridge String
bridgePortId String
broadcastFlood Boolean: When enabled, bridge floods broadcast traffic to all bridge egress ports. When disabled, drops broadcast traffic on egress ports.
comment String
designatedBridge String: Root bridge ID (bridge priority and the bridge MAC address).
designatedCost String: Designated cost.
designatedPortNumber Double: Designated port number.
disabled Boolean
dynamic Boolean: Configuration item created by software, not by management interface. It is not exported, and cannot be directly modified.
edge String: Set port as edge port or non-edge port, or enable edge discovery. Edge ports are connected to a LAN that has no other bridges attached.
edgePort Boolean: Whether port is an edge port or not.
edgePortDiscovery Boolean: Whether port is set to automatically detect edge ports.
externalFdbStatus Boolean: Whether registration table is used instead of forwarding data base.
fastLeave Boolean: Enables IGMP Fast leave feature on the port.
forwarding Boolean: Shows if the port is not blocked by (R/M)STP.
frameTypes String: Specifies allowed ingress frame types on a bridge port. This property only has effect when vlan-filtering is set to yes.
horizon String: Use split horizon bridging to prevent bridging loops. Set the same value for group of ports, to prevent them from sending data to ports with the same horizon value. Split horizon is a software feature that disables hardware offloading. This value is integer '0'..'429496729' or 'none'.
hw Boolean: Enable or disable Hardware Offloading of the interface.
hwOffload Boolean: Hardware offloading state.
hwOffloadGroup String: Switch chip used by the port.
inactive Boolean
ingressFiltering Boolean: Enables or disables VLAN ingress filtering, which checks if the ingress port is a member of the received VLAN ID in the bridge VLAN table. Should be used with frame-types to specify if the ingress traffic should be tagged or untagged. This property only has effect when vlan-filtering is set to yes.
interface_ String: Name of the interface.
internalPathCost Double: Path cost to the interface for MSTI0 inside a region. This property only has effect when protocol-mode is set to mstp.
learn String: Changes MAC learning behaviour on a bridge port
learning Boolean: Shows whether the port is capable of learning MAC addresses.
multicastRouter String: Changes the state of a bridge port whether IGMP membership reports are going to be forwarded to this port.
mvrpApplicantState String: MVRP applicant options (available since RouterOS 7.15): - non-participant - port does not send any MRP messages; - normal-participant - port participates normally in MRP exchanges.
mvrpRegistrarState String: MVRP registrar options (available since RouterOS 7.15): - fixed - port ignores all MRP messages, and remains Registered (IN) in all configured vlans. - normal - port receives MRP messages and handles them according to the standard.
nextid String
pathCost String: Path cost to the interface, used by STP to determine the "best" path, used by MSTP todetermine "best" path between regions. This property has no effect when protocol-mode is set to none.
pointToPoint String: Specifies if a bridge port is connected to a bridge using a point-to-point link for faster convergence in case of failure. This property has no effect when protocol-mode is set to none.
pointToPointPort Boolean: Whether the port is connected to a bridge port using full-duplex (true) or half-duplex (false).
priority String: The priority of the interface, used by STP to determine the root port, used by MSTP to determine root port between regions.
pvid Double: ort VLAN ID (pvid) specifies which VLAN the untagged ingress traffic is assigned to. This property only has effect when vlan-filtering is set to yes.
restrictedRole Boolean: Enable the restricted role on a port, used by STP to forbid a port becoming a root port. This property only has effect when protocol-mode is set to mstp.
restrictedTcn Boolean: Disable topology change notification (TCN) sending on a port, used by STP to forbid network topology changes to propagate. This property only has effect when protocol-mode is set to mstp.
role String: (R/M)STP algorithm assigned role of the port
rootPathCost Double: The total cost of the path to the root-bridge.
sendingRstp String: Whether the port is sending RSTP or MSTP BPDU types. A port will transit to STP type when RSTP/MSTP enabled port receives a STP BPDU
status String: Port status ('in-bridge' - port is enabled).
tagStacking Boolean: Forces all packets to be treated as untagged packets. Packets on ingress port will be tagged with another VLAN tag regardless if a VLAN tag already exists, packets will be tagged with a VLAN ID that matches the pvid value and will use EtherType that is specified in ether-type. This property only has effect when vlan-filtering is set to yes.
trusted Boolean: When enabled, it allows to forward DHCP packets towards DHCP server through this port. Mainly used to limit unauthorized servers to provide malicious information for users. This property only has effect when dhcp-snooping is set to yes.
unknownMulticastFlood Boolean: When enabled, bridge floods unknown multicast traffic to all bridge egress ports.
unknownUnicastFlood Boolean: When enabled, bridge floods unknown unicast traffic to all bridge egress ports.

___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.
autoIsolate boolean: When enabled, prevents a port moving from discarding into forwarding state if no BPDUs are received from the neighboring bridge. The port will change into a forwarding state only when a BPDU is received. This property only has an effect when protocol-mode is set to rstp or mstp and edge is set to no.
bpduGuard boolean: This property has no effect when protocol-mode is set to none.
bridge string
bridgePortId string
broadcastFlood boolean: When enabled, bridge floods broadcast traffic to all bridge egress ports. When disabled, drops broadcast traffic on egress ports.
comment string
designatedBridge string: Root bridge ID (bridge priority and the bridge MAC address).
designatedCost string: Designated cost.
designatedPortNumber number: Designated port number.
disabled boolean
dynamic boolean: Configuration item created by software, not by management interface. It is not exported, and cannot be directly modified.
edge string: Set port as edge port or non-edge port, or enable edge discovery. Edge ports are connected to a LAN that has no other bridges attached.
edgePort boolean: Whether port is an edge port or not.
edgePortDiscovery boolean: Whether port is set to automatically detect edge ports.
externalFdbStatus boolean: Whether registration table is used instead of forwarding data base.
fastLeave boolean: Enables IGMP Fast leave feature on the port.
forwarding boolean: Shows if the port is not blocked by (R/M)STP.
frameTypes string: Specifies allowed ingress frame types on a bridge port. This property only has effect when vlan-filtering is set to yes.
horizon string: Use split horizon bridging to prevent bridging loops. Set the same value for group of ports, to prevent them from sending data to ports with the same horizon value. Split horizon is a software feature that disables hardware offloading. This value is integer '0'..'429496729' or 'none'.
hw boolean: Enable or disable Hardware Offloading of the interface.
hwOffload boolean: Hardware offloading state.
hwOffloadGroup string: Switch chip used by the port.
inactive boolean
ingressFiltering boolean: Enables or disables VLAN ingress filtering, which checks if the ingress port is a member of the received VLAN ID in the bridge VLAN table. Should be used with frame-types to specify if the ingress traffic should be tagged or untagged. This property only has effect when vlan-filtering is set to yes.
interface string: Name of the interface.
internalPathCost number: Path cost to the interface for MSTI0 inside a region. This property only has effect when protocol-mode is set to mstp.
learn string: Changes MAC learning behaviour on a bridge port
learning boolean: Shows whether the port is capable of learning MAC addresses.
multicastRouter string: Changes the state of a bridge port whether IGMP membership reports are going to be forwarded to this port.
mvrpApplicantState string: MVRP applicant options (available since RouterOS 7.15): - non-participant - port does not send any MRP messages; - normal-participant - port participates normally in MRP exchanges.
mvrpRegistrarState string: MVRP registrar options (available since RouterOS 7.15): - fixed - port ignores all MRP messages, and remains Registered (IN) in all configured vlans. - normal - port receives MRP messages and handles them according to the standard.
nextid string
pathCost string: Path cost to the interface, used by STP to determine the "best" path, used by MSTP todetermine "best" path between regions. This property has no effect when protocol-mode is set to none.
pointToPoint string: Specifies if a bridge port is connected to a bridge using a point-to-point link for faster convergence in case of failure. This property has no effect when protocol-mode is set to none.
pointToPointPort boolean: Whether the port is connected to a bridge port using full-duplex (true) or half-duplex (false).
priority string: The priority of the interface, used by STP to determine the root port, used by MSTP to determine root port between regions.
pvid number: ort VLAN ID (pvid) specifies which VLAN the untagged ingress traffic is assigned to. This property only has effect when vlan-filtering is set to yes.
restrictedRole boolean: Enable the restricted role on a port, used by STP to forbid a port becoming a root port. This property only has effect when protocol-mode is set to mstp.
restrictedTcn boolean: Disable topology change notification (TCN) sending on a port, used by STP to forbid network topology changes to propagate. This property only has effect when protocol-mode is set to mstp.
role string: (R/M)STP algorithm assigned role of the port
rootPathCost number: The total cost of the path to the root-bridge.
sendingRstp string: Whether the port is sending RSTP or MSTP BPDU types. A port will transit to STP type when RSTP/MSTP enabled port receives a STP BPDU
status string: Port status ('in-bridge' - port is enabled).
tagStacking boolean: Forces all packets to be treated as untagged packets. Packets on ingress port will be tagged with another VLAN tag regardless if a VLAN tag already exists, packets will be tagged with a VLAN ID that matches the pvid value and will use EtherType that is specified in ether-type. This property only has effect when vlan-filtering is set to yes.
trusted boolean: When enabled, it allows to forward DHCP packets towards DHCP server through this port. Mainly used to limit unauthorized servers to provide malicious information for users. This property only has effect when dhcp-snooping is set to yes.
unknownMulticastFlood boolean: When enabled, bridge floods unknown multicast traffic to all bridge egress ports.
unknownUnicastFlood boolean: When enabled, bridge floods unknown unicast traffic to all bridge egress ports.

___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.
auto_isolate bool: When enabled, prevents a port moving from discarding into forwarding state if no BPDUs are received from the neighboring bridge. The port will change into a forwarding state only when a BPDU is received. This property only has an effect when protocol-mode is set to rstp or mstp and edge is set to no.
bpdu_guard bool: This property has no effect when protocol-mode is set to none.
bridge str
bridge_port_id str
broadcast_flood bool: When enabled, bridge floods broadcast traffic to all bridge egress ports. When disabled, drops broadcast traffic on egress ports.
comment str
designated_bridge str: Root bridge ID (bridge priority and the bridge MAC address).
designated_cost str: Designated cost.
designated_port_number float: Designated port number.
disabled bool
dynamic bool: Configuration item created by software, not by management interface. It is not exported, and cannot be directly modified.
edge str: Set port as edge port or non-edge port, or enable edge discovery. Edge ports are connected to a LAN that has no other bridges attached.
edge_port bool: Whether port is an edge port or not.
edge_port_discovery bool: Whether port is set to automatically detect edge ports.
external_fdb_status bool: Whether registration table is used instead of forwarding data base.
fast_leave bool: Enables IGMP Fast leave feature on the port.
forwarding bool: Shows if the port is not blocked by (R/M)STP.
frame_types str: Specifies allowed ingress frame types on a bridge port. This property only has effect when vlan-filtering is set to yes.
horizon str: Use split horizon bridging to prevent bridging loops. Set the same value for group of ports, to prevent them from sending data to ports with the same horizon value. Split horizon is a software feature that disables hardware offloading. This value is integer '0'..'429496729' or 'none'.
hw bool: Enable or disable Hardware Offloading of the interface.
hw_offload bool: Hardware offloading state.
hw_offload_group str: Switch chip used by the port.
inactive bool
ingress_filtering bool: Enables or disables VLAN ingress filtering, which checks if the ingress port is a member of the received VLAN ID in the bridge VLAN table. Should be used with frame-types to specify if the ingress traffic should be tagged or untagged. This property only has effect when vlan-filtering is set to yes.
interface str: Name of the interface.
internal_path_cost float: Path cost to the interface for MSTI0 inside a region. This property only has effect when protocol-mode is set to mstp.
learn str: Changes MAC learning behaviour on a bridge port
learning bool: Shows whether the port is capable of learning MAC addresses.
multicast_router str: Changes the state of a bridge port whether IGMP membership reports are going to be forwarded to this port.
mvrp_applicant_state str: MVRP applicant options (available since RouterOS 7.15): - non-participant - port does not send any MRP messages; - normal-participant - port participates normally in MRP exchanges.
mvrp_registrar_state str: MVRP registrar options (available since RouterOS 7.15): - fixed - port ignores all MRP messages, and remains Registered (IN) in all configured vlans. - normal - port receives MRP messages and handles them according to the standard.
nextid str
path_cost str: Path cost to the interface, used by STP to determine the "best" path, used by MSTP todetermine "best" path between regions. This property has no effect when protocol-mode is set to none.
point_to_point str: Specifies if a bridge port is connected to a bridge using a point-to-point link for faster convergence in case of failure. This property has no effect when protocol-mode is set to none.
point_to_point_port bool: Whether the port is connected to a bridge port using full-duplex (true) or half-duplex (false).
priority str: The priority of the interface, used by STP to determine the root port, used by MSTP to determine root port between regions.
pvid float: ort VLAN ID (pvid) specifies which VLAN the untagged ingress traffic is assigned to. This property only has effect when vlan-filtering is set to yes.
restricted_role bool: Enable the restricted role on a port, used by STP to forbid a port becoming a root port. This property only has effect when protocol-mode is set to mstp.
restricted_tcn bool: Disable topology change notification (TCN) sending on a port, used by STP to forbid network topology changes to propagate. This property only has effect when protocol-mode is set to mstp.
role str: (R/M)STP algorithm assigned role of the port
root_path_cost float: The total cost of the path to the root-bridge.
sending_rstp str: Whether the port is sending RSTP or MSTP BPDU types. A port will transit to STP type when RSTP/MSTP enabled port receives a STP BPDU
status str: Port status ('in-bridge' - port is enabled).
tag_stacking bool: Forces all packets to be treated as untagged packets. Packets on ingress port will be tagged with another VLAN tag regardless if a VLAN tag already exists, packets will be tagged with a VLAN ID that matches the pvid value and will use EtherType that is specified in ether-type. This property only has effect when vlan-filtering is set to yes.
trusted bool: When enabled, it allows to forward DHCP packets towards DHCP server through this port. Mainly used to limit unauthorized servers to provide malicious information for users. This property only has effect when dhcp-snooping is set to yes.
unknown_multicast_flood bool: When enabled, bridge floods unknown multicast traffic to all bridge egress ports.
unknown_unicast_flood bool: When enabled, bridge floods unknown unicast traffic to all bridge egress ports.

___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.
autoIsolate Boolean: When enabled, prevents a port moving from discarding into forwarding state if no BPDUs are received from the neighboring bridge. The port will change into a forwarding state only when a BPDU is received. This property only has an effect when protocol-mode is set to rstp or mstp and edge is set to no.
bpduGuard Boolean: This property has no effect when protocol-mode is set to none.
bridge String
bridgePortId String
broadcastFlood Boolean: When enabled, bridge floods broadcast traffic to all bridge egress ports. When disabled, drops broadcast traffic on egress ports.
comment String
designatedBridge String: Root bridge ID (bridge priority and the bridge MAC address).
designatedCost String: Designated cost.
designatedPortNumber Number: Designated port number.
disabled Boolean
dynamic Boolean: Configuration item created by software, not by management interface. It is not exported, and cannot be directly modified.
edge String: Set port as edge port or non-edge port, or enable edge discovery. Edge ports are connected to a LAN that has no other bridges attached.
edgePort Boolean: Whether port is an edge port or not.
edgePortDiscovery Boolean: Whether port is set to automatically detect edge ports.
externalFdbStatus Boolean: Whether registration table is used instead of forwarding data base.
fastLeave Boolean: Enables IGMP Fast leave feature on the port.
forwarding Boolean: Shows if the port is not blocked by (R/M)STP.
frameTypes String: Specifies allowed ingress frame types on a bridge port. This property only has effect when vlan-filtering is set to yes.
horizon String: Use split horizon bridging to prevent bridging loops. Set the same value for group of ports, to prevent them from sending data to ports with the same horizon value. Split horizon is a software feature that disables hardware offloading. This value is integer '0'..'429496729' or 'none'.
hw Boolean: Enable or disable Hardware Offloading of the interface.
hwOffload Boolean: Hardware offloading state.
hwOffloadGroup String: Switch chip used by the port.
inactive Boolean
ingressFiltering Boolean: Enables or disables VLAN ingress filtering, which checks if the ingress port is a member of the received VLAN ID in the bridge VLAN table. Should be used with frame-types to specify if the ingress traffic should be tagged or untagged. This property only has effect when vlan-filtering is set to yes.
interface String: Name of the interface.
internalPathCost Number: Path cost to the interface for MSTI0 inside a region. This property only has effect when protocol-mode is set to mstp.
learn String: Changes MAC learning behaviour on a bridge port
learning Boolean: Shows whether the port is capable of learning MAC addresses.
multicastRouter String: Changes the state of a bridge port whether IGMP membership reports are going to be forwarded to this port.
mvrpApplicantState String: MVRP applicant options (available since RouterOS 7.15): - non-participant - port does not send any MRP messages; - normal-participant - port participates normally in MRP exchanges.
mvrpRegistrarState String: MVRP registrar options (available since RouterOS 7.15): - fixed - port ignores all MRP messages, and remains Registered (IN) in all configured vlans. - normal - port receives MRP messages and handles them according to the standard.
nextid String
pathCost String: Path cost to the interface, used by STP to determine the "best" path, used by MSTP todetermine "best" path between regions. This property has no effect when protocol-mode is set to none.
pointToPoint String: Specifies if a bridge port is connected to a bridge using a point-to-point link for faster convergence in case of failure. This property has no effect when protocol-mode is set to none.
pointToPointPort Boolean: Whether the port is connected to a bridge port using full-duplex (true) or half-duplex (false).
priority String: The priority of the interface, used by STP to determine the root port, used by MSTP to determine root port between regions.
pvid Number: ort VLAN ID (pvid) specifies which VLAN the untagged ingress traffic is assigned to. This property only has effect when vlan-filtering is set to yes.
restrictedRole Boolean: Enable the restricted role on a port, used by STP to forbid a port becoming a root port. This property only has effect when protocol-mode is set to mstp.
restrictedTcn Boolean: Disable topology change notification (TCN) sending on a port, used by STP to forbid network topology changes to propagate. This property only has effect when protocol-mode is set to mstp.
role String: (R/M)STP algorithm assigned role of the port
rootPathCost Number: The total cost of the path to the root-bridge.
sendingRstp String: Whether the port is sending RSTP or MSTP BPDU types. A port will transit to STP type when RSTP/MSTP enabled port receives a STP BPDU
status String: Port status ('in-bridge' - port is enabled).
tagStacking Boolean: Forces all packets to be treated as untagged packets. Packets on ingress port will be tagged with another VLAN tag regardless if a VLAN tag already exists, packets will be tagged with a VLAN ID that matches the pvid value and will use EtherType that is specified in ether-type. This property only has effect when vlan-filtering is set to yes.
trusted Boolean: When enabled, it allows to forward DHCP packets towards DHCP server through this port. Mainly used to limit unauthorized servers to provide malicious information for users. This property only has effect when dhcp-snooping is set to yes.
unknownMulticastFlood Boolean: When enabled, bridge floods unknown multicast traffic to all bridge egress ports.
unknownUnicastFlood Boolean: When enabled, bridge floods unknown unicast traffic to all bridge egress ports.

Package Details

Repository: routeros terraform-routeros/terraform-provider-routeros
License
Notes: This Pulumi package is based on the routeros Terraform Provider.

routeros 1.83.0 published on Wednesday, Apr 16, 2025 by terraform-routeros

terraform-routeros/terraform-provider-routeros

routeros.BridgePort

On this page

On this page

# routeros.BridgePort (Resource)

This is an alias for backwards compatibility between plugin versions.

Create BridgePort Resource

Constructor syntax

Parameters

BridgePort Resource Properties

Inputs

Outputs

Look up Existing BridgePort Resource

Package Details

On this page

On this page