1. Packages
  2. Routeros Provider
  3. API Docs
  4. BridgePort
routeros 1.83.1 published on Monday, Apr 28, 2025 by terraform-routeros

routeros.BridgePort

Explore with Pulumi AI

routeros logo
routeros 1.83.1 published on Monday, Apr 28, 2025 by terraform-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 logo
    routeros 1.83.1 published on Monday, Apr 28, 2025 by terraform-routeros