Aggregate Interface Models

Overview

The Aggregate Interface models provide structured validation for aggregate (bonded) ethernet interface configuration. These models support Layer 2 and Layer 3 modes with LACP (Link Aggregation Control Protocol) configuration.

Models

• AggregateInterfaceCreateModel: For creating new aggregate interfaces
• AggregateInterfaceUpdateModel: For updating existing interfaces (includes id)
• AggregateInterfaceResponseModel: Response model from API operations
• AggregateLayer2: Layer 2 mode configuration
• AggregateLayer3: Layer 3 mode configuration

All models use extra="forbid" to reject undefined fields.

Model Attributes

AggregateInterfaceBaseModel

Attribute	Type	Required	Default	Description
name	str	Yes	None	Interface name (e.g., "ae1")
comment	str	No	None	Description (max 1023 chars)
layer2	AggregateLayer2	No*	None	Layer 2 mode configuration
layer3	AggregateLayer3	No*	None	Layer 3 mode configuration
folder	str	No**	None	Folder container
snippet	str	No**	None	Snippet container
device	str	No**	None	Device container

* Only one mode can be configured (oneOf validation) ** Exactly one container required for create operations

AggregateLayer2

Attribute	Type	Required	Default	Description
vlan_tag	str	No	None	VLAN tag (1-4096)
lacp	LacpConfig	No	None	LACP configuration

AggregateLayer3

Attribute	Type	Required	Default	Description
ip	List[StaticIp]	No*	None	Static IP addresses
dhcp_client	DhcpClient	No*	None	DHCP client configuration
mtu	int	No	1500	MTU (576-9216)
interface_management_profile	str	No	None	Management profile
arp	List[ArpEntry]	No	None	Static ARP entries
ddns_config	DdnsConfig	No	None	Dynamic DNS config
lacp	LacpConfig	No	None	LACP configuration

* Only one IP mode can be configured (oneOf validation)

LacpConfig

Attribute	Type	Default	Description
enable	bool	False	Enable LACP
fast_failover	bool	False	Enable fast failover
mode	str	"passive"	LACP mode (passive/active)
transmission_rate	str	"slow"	Rate (fast/slow)
system_priority	int	32768	System priority (1-65535)
max_ports	int	8	Max ports (1-8)

Model Validators

Interface Mode Validation

Ensures only one of layer2 or layer3 is configured:

@model_validator(mode="after")
def validate_interface_mode(self) -> "AggregateInterfaceBaseModel":
    modes = [self.layer2, self.layer3]
    configured = [m for m in modes if m is not None]
    if len(configured) > 1:
        raise ValueError("Only one interface mode allowed: layer2 or layer3")
    return self

Usage Examples

Layer 3 with LACP

from scm.models.network import AggregateInterfaceCreateModel

interface = AggregateInterfaceCreateModel(
    name="ae1",
    layer3={
        "ip": [{"name": "10.0.0.1/24"}],
        "mtu": 9000,
        "lacp": {
            "enable": True,
            "mode": "active",
            "fast_failover": True
        }
    },
    folder="Interfaces"
)
payload = interface.model_dump(exclude_unset=True)

Layer 2 with VLAN

interface = AggregateInterfaceCreateModel(
    name="ae2",
    layer2={
        "vlan_tag": "100",
        "lacp": {"enable": True, "mode": "passive"}
    },
    folder="Interfaces"
)