Network Bridge

Network Bridge is the REST representation of the Shared Ethernet Adapters. NetworkBridge is a wrapper around the Shared Ethernet Adapter (SEA) and provides a unique way of managing the network bridge functionality for all configurations such as Failover, LoadBalancing, and Non-Failover.

Resource 
/rest/api/uom/ManagedSystem/{ManagedSystem_uuid}/NetworkBridge/{NetworkBridge_uuid}
/rest/api/uom/ManagedSystem/{ManagedSystem_uuid}/NetworkBridge
Since: Version 1.1.0
The NetworkBridge APIs provide the interface for configuring the SEA(s) without requiring the user to log on to VIOS console. NetworkBridge is a wrapper functionality for SEAs provided as API from Management Console. The API provides configuration of NetworkBridge in the following modes:
  1. NonFailover
  2. Failover
  3. LoadBalancing
To configure Network Bridge, the XML should have the following basic attributes:
  1. FailoverEnabled - Boolean (true/false)
  2. LoadBalancingEnabled - Boolean (true/false)
  3. ControlChannelID - Required when failover is enabled (For 'ManagementVLANForControlChannelCapable' managed systems, this field is optional even if failover is enabled)
  4. PortVLANID - The Untagged VLAN ID for the SEA(s)
  5. SharedEthernetAdapters - A collection of SEAs (For Failover Enabled 2 SEAs, For Failover Disabled 1 SEA)
  6. LoadGroups - A collection of LoadGroup objects
    • Minimum of One LoadGroup for NonFailover and Failover NetworkBridge.
    • For LoadBalancingEnabled, a minimum of two load groups must be specified.
    • One of the LoadGroup's PVID must be same as that of NetworkBridge PortVLANID.

When a VIOS does not have active RMC connection, the Network Bridge information is not returned. For a failover enabled NetworkBridge, if one of the VIOSs does not have active RMC connection or VIOS is shutdown, the MC will provide only one SEA in the NetworkBridge.

Table 1. Supported methods
Method Description Internet media type
GET Fetch the configured/specified NetworkBridges from the Managed System application/vnd.ibm.powervm.uom+xml, type=NetworkBridge
PUT Create a NetworkBridge application/vnd.ibm.powervm.uom+xml, type=NetworkBridge
POST Modify the NetworkBridge configuration viz., Enable Failover, Enable Load Balancing, Add LoadGroup(s), Modify SEA properties, Add/Remove VirtualNetworks to/from NetworkBridge application/vnd.ibm.powervm.uom+xml, type=NetworkBridge
DELETE Delete the NetworkBridge application/vnd.ibm.powervm.uom+xml, type=NetworkBridge