catalystwan 0.41.2.dev9__py3-none-any.whl → 0.41.3__py3-none-any.whl

catalystwan/api/templates/models/cisco_vpn_interface_model.py

@@ -1,14 +1,14 @@
 # Copyright 2023 Cisco Systems, Inc. and its affiliates
 
 import ipaddress
+from enum import Enum
 from pathlib import Path
-from typing import ClassVar, List, Literal, Optional
+from typing import ClassVar, List, Optional
 
 from pydantic import ConfigDict, Field
 
 from catalystwan.api.templates.bool_str import BoolStr
 from catalystwan.api.templates.feature_template import FeatureTemplate, FeatureTemplateValidator
-from catalystwan.models.common import Protocol, StaticNatDirection, TLOCColor
 
 DEFAULT_STATIC_NAT64_SOURCE_VPN_ID = 0
 DEFAULT_STATIC_NAT_SOURCE_VPN_ID = 0
@@ -22,800 +22,443 @@ DEFAULT_IPV6_VRRP_PRIORITY = 100
 DEFAULT_IPV6_VRRP_TIMER = 1000
 
 
-Direction = Literal["in", "out"]
-NatChoice = Literal["Interface", "Pool", "Loopback"]
-CoreRegion = Literal["core", "core-shared"]
-SecondaryRegion = Literal["off", "secondary-only", "secondary-shared"]
-Encap = Literal["gre", "ipsec"]
-Mode = Literal["hub", "spoke"]
-Carrier = Literal[
-    "default", "carrier1", "carrier2", "carrier3", "carrier4", "carrier5", "carrier6", "carrier7", "carrier8"
-]
-MediaType = Literal["auto-select", "rj45", "sfp"]
-Speed = Literal["10", "100", "1000", "2500", "10000"]
-Duplex = Literal["full", "half", "auto"]
-TrackAction = Literal["Decrement", "Shutdown"]
-
-
 class SecondaryIPv4Address(FeatureTemplateValidator):
-    address: Optional[ipaddress.IPv4Interface] = Field(
-        default=None, description="IPv4 address with CIDR notation for the secondary interface."
-    )
+    address: Optional[ipaddress.IPv4Interface] = None
 
 
 class SecondaryIPv6Address(FeatureTemplateValidator):
-    address: Optional[ipaddress.IPv6Interface] = Field(
-        default=None, description="IPv6 address with CIDR notation for the secondary interface."
-    )
+    address: Optional[ipaddress.IPv6Interface] = None
+
+
+class Direction(str, Enum):
+    IN = "in"
+    OUT = "out"
 
 
 class AccessList(FeatureTemplateValidator):
-    direction: Direction = Field(..., description="Direction of the traffic flow for applying the ACL ('in' or 'out').")
-    acl_name: str = Field(
-        ..., json_schema_extra={"vmanage_key": "acl-name"}, description="Name of the access control list."
-    )
-    model_config: ClassVar[ConfigDict] = ConfigDict(populate_by_name=True)
+    direction: Direction
+    acl_name: str = Field(json_schema_extra={"vmanage_key": "acl-name"})
+    model_config = ConfigDict(populate_by_name=True)
 
 
 class DhcpHelperV6(FeatureTemplateValidator):
-    address: ipaddress.IPv6Address = Field(..., description="IPv6 address of the DHCP server or relay.")
-    vpn: Optional[int] = Field(default=None, description="Optional VPN ID where the DHCP helper is configured.")
+    address: ipaddress.IPv6Address
+    vpn: Optional[int] = None
+
+
+class NatChoice(str, Enum):
+    INTERFACE = "Interface"
+    POOL = "Pool"
+    LOOPBACK = "Loopback"
 
 
 class StaticNat66(FeatureTemplateValidator):
-    source_prefix: ipaddress.IPv6Interface = Field(
-        ...,
-        json_schema_extra={"vmanage_key": "source-prefix"},
-        description="IPv6 network prefix that is to be translated.",
-    )
-    translated_source_prefix: str = Field(
-        ...,
-        json_schema_extra={"vmanage_key": "translated-source-prefix"},
-        description="IPv6 network prefix to which the source prefix is translated.",
-    )
-    source_vpn_id: int = Field(
-        default=DEFAULT_STATIC_NAT64_SOURCE_VPN_ID,
-        json_schema_extra={"vmanage_key": "source-vpn-id"},
-        description="VPN ID associated with the source network prefix.",
-    )
-    model_config: ClassVar[ConfigDict] = ConfigDict(populate_by_name=True)
+    source_prefix: ipaddress.IPv6Interface = Field(json_schema_extra={"vmanage_key": "source-prefix"})
+    translated_source_prefix: str = Field(json_schema_extra={"vmanage_key": "translated-source-prefix"})
+    source_vpn_id: int = Field(DEFAULT_STATIC_NAT64_SOURCE_VPN_ID, json_schema_extra={"vmanage_key": "source-vpn-id"})
+    model_config = ConfigDict(populate_by_name=True)
+
+
+class StaticNatDirection(str, Enum):
+    INSIDE = "inside"
+    OUTSIDE = "outside"
 
 
 class Static(FeatureTemplateValidator):
-    source_ip: ipaddress.IPv4Address = Field(
-        ..., json_schema_extra={"vmanage_key": "source-ip"}, description="IPv4 address of the source IP for static NAT."
-    )
-    translate_ip: ipaddress.IPv4Address = Field(
-        ...,
-        json_schema_extra={"vmanage_key": "translate-ip"},
-        description="IPv4 address used for translation in static NAT.",
-    )
+    source_ip: ipaddress.IPv4Address = Field(json_schema_extra={"vmanage_key": "source-ip"})
+    translate_ip: ipaddress.IPv4Address = Field(json_schema_extra={"vmanage_key": "translate-ip"})
     static_nat_direction: StaticNatDirection = Field(
-        default="inside",
-        json_schema_extra={"vmanage_key": "static-nat-direction"},
-        description="Direction of static NAT mapping ('inside' or 'outside').",
-    )
-    source_vpn: int = Field(
-        default=DEFAULT_STATIC_NAT_SOURCE_VPN_ID,
-        json_schema_extra={"vmanage_key": "source-vpn"},
-        description="VPN ID associated with the source IP for static NAT.",
+        StaticNatDirection.INSIDE, json_schema_extra={"vmanage_key": "static-nat-direction"}
     )
-    model_config: ClassVar[ConfigDict] = ConfigDict(populate_by_name=True)
+    source_vpn: int = Field(DEFAULT_STATIC_NAT_SOURCE_VPN_ID, json_schema_extra={"vmanage_key": "source-vpn"})
+    model_config = ConfigDict(populate_by_name=True)
+
+
+class Proto(str, Enum):
+    TCP = "tcp"
+    UDP = "udp"
 
 
 class StaticPortForward(FeatureTemplateValidator):
-    source_ip: ipaddress.IPv4Address = Field(
-        ...,
-        json_schema_extra={"vmanage_key": "source-ip"},
-        description="IPv4 address of the source IP for port forwarding.",
-    )
-    translate_ip: ipaddress.IPv4Address = Field(
-        ...,
-        json_schema_extra={"vmanage_key": "translate-ip"},
-        description="IPv4 address used for translation in port forwarding.",
-    )
+    source_ip: ipaddress.IPv4Address = Field(json_schema_extra={"vmanage_key": "source-ip"})
+    translate_ip: ipaddress.IPv4Address = Field(json_schema_extra={"vmanage_key": "translate-ip"})
     static_nat_direction: StaticNatDirection = Field(
-        default="inside",
-        json_schema_extra={"vmanage_key": "static-nat-direction"},
-        description="Direction of port forwarding mapping ('inside' or 'outside').",
-    )
-    source_port: int = Field(
-        default=DEFAULT_STATIC_PORT_FORWARD_SOURCE_PORT,
-        json_schema_extra={"vmanage_key": "source-port"},
-        description="Source port number for port forwarding.",
+        StaticNatDirection.INSIDE, json_schema_extra={"vmanage_key": "static-nat-direction"}
     )
+    source_port: int = Field(DEFAULT_STATIC_PORT_FORWARD_SOURCE_PORT, json_schema_extra={"vmanage_key": "source-port"})
     translate_port: int = Field(
-        default=DEFAULT_STATIC_PORT_FORWARD_TRANSLATE_PORT,
-        json_schema_extra={"vmanage_key": "translate-port"},
-        description="Translated port number for port forwarding.",
-    )
-    proto: Protocol = Field(..., description="Protocol used for port forwarding (TCP/UDP).")
-    source_vpn: int = Field(
-        default=DEFAULT_STATIC_PORT_FORWARD_SOURCE_VPN,
-        json_schema_extra={"vmanage_key": "source-vpn"},
-        description="VPN ID associated with the source IP for port forwarding.",
+        DEFAULT_STATIC_PORT_FORWARD_TRANSLATE_PORT, json_schema_extra={"vmanage_key": "translate-port"}
     )
-    model_config: ClassVar[ConfigDict] = ConfigDict(populate_by_name=True)
+    proto: Proto
+    source_vpn: int = Field(DEFAULT_STATIC_PORT_FORWARD_SOURCE_VPN, json_schema_extra={"vmanage_key": "source-vpn"})
+    model_config = ConfigDict(populate_by_name=True)
+
+
+class CoreRegion(str, Enum):
+    CORE = "core"
+    CORE_SHARED = "core-shared"
+
+
+class SecondaryRegion(str, Enum):
+    OFF = "off"
+    SECONDARY_ONLY = "secondary-only"
+    SECONDARY_SHARED = "secondary-shared"
+
+
+class Encap(str, Enum):
+    GRE = "gre"
+    IPSEC = "ipsec"
 
 
 class Encapsulation(FeatureTemplateValidator):
-    encap: Encap = Field(..., description="Type of encapsulation used for the VPN tunnel (GRE/IPsec).")
-    preference: Optional[int] = Field(
-        default=None, description="Preference value for the encapsulation type (lower values have higher priority)."
-    )
-    weight: int = Field(
-        default=DEFAULT_ENCAPSULATION_WEIGHT,
-        description="Weight for the encapsulation type used in load balancing decisions.",
-    )
+    encap: Encap
+    preference: Optional[int] = None
+    weight: int = DEFAULT_ENCAPSULATION_WEIGHT
+
+
+class Mode(str, Enum):
+    HUB = "hub"
+    SPOKE = "spoke"
+
+
+class Value(str, Enum):
+    DEFAULT = "default"
+    MPLS = "mpls"
+    METRO_ETHERNET = "metro-ethernet"
+    BIZ_INTERNET = "biz-internet"
+    PUBLIC_INTERNET = "public-internet"
+    LTE = "lte"
+    THREEG = "3g"
+    RED = "red"
+    GREEN = "green"
+    BLUE = "blue"
+    GOLD = "gold"
+    SILVER = "silver"
+    BRONZE = "bronze"
+    CUSTOM1 = "custom1"
+    CUSTOM2 = "custom2"
+    CUSTOM3 = "custom3"
+    PRIVATE1 = "private1"
+    PRIVATE2 = "private2"
+    PRIVATE3 = "private3"
+    PRIVATE4 = "private4"
+    PRIVATE5 = "private5"
+    PRIVATE6 = "private6"
+
+
+class Carrier(str, Enum):
+    DEFAULT = "default"
+    CARRIER1 = "carrier1"
+    CARRIER2 = "carrier2"
+    CARRIER3 = "carrier3"
+    CARRIER4 = "carrier4"
+    CARRIER5 = "carrier5"
+    CARRIER6 = "carrier6"
+    CARRIER7 = "carrier7"
+    CARRIER8 = "carrier8"
+
+
+class MediaType(str, Enum):
+    AUTO_SELECT = "auto-select"
+    RJ45 = "rj45"
+    SFP = "sfp"
+
+
+class Speed(str, Enum):
+    TEN = "10"
+    HUNDRED = "100"
+    THOUSAND = "1000"
+    TWOANDAHALFTHOUSAND = "2500"
+    TENTHOUSAND = "10000"
+
+
+class Duplex(str, Enum):
+    FULL = "full"
+    HALF = "half"
+    AUTO = "auto"
 
 
 class Ip(FeatureTemplateValidator):
-    addr: ipaddress.IPv4Address = Field(..., description="IPv4 address for the interface.")
-    mac: str = Field(..., description="MAC address associated with the IPv4 address.")
+    addr: ipaddress.IPv4Address
+    mac: str
 
 
 class Ipv4Secondary(FeatureTemplateValidator):
-    address: ipaddress.IPv4Address = Field(..., description="IPv4 address for the secondary interface.")
+    address: ipaddress.IPv4Address
+
+
+class TrackAction(str, Enum):
+    DECREMENT = "Decrement"
+    SHUTDOWN = "Shutdown"
 
 
 class TrackingObject(FeatureTemplateValidator):
-    name: int = Field(..., description="Unique identifier for the tracking object.")
-    track_action: TrackAction = Field(
-        default="Decrement",
-        json_schema_extra={"vmanage_key": "track-action"},
-        description="Action to take when the tracked object state changes (e.g., decrement priority or shutdown).",
-    )
-    decrement: int = Field(
-        ..., description="Value by which to decrement the VRRP priority when the tracked object is down."
-    )
-    model_config: ClassVar[ConfigDict] = ConfigDict(populate_by_name=True)
+    name: int
+    track_action: TrackAction = Field(TrackAction.DECREMENT, json_schema_extra={"vmanage_key": "track-action"})
+    decrement: int
+    model_config = ConfigDict(populate_by_name=True)
 
 
 class Vrrp(FeatureTemplateValidator):
-    grp_id: int = Field(..., json_schema_extra={"vmanage_key": "grp-id"}, description="VRRP group ID.")
-    priority: int = Field(
-        default=DEFAULT_VRRP_PRIORITY, description="Priority value for the VRRP group (higher values take precedence)."
-    )
-    timer: int = Field(default=DEFAULT_VRRP_TIMER, description="VRRP advertisement interval timer in milliseconds.")
-    track_omp: BoolStr = Field(
-        default=False,
-        json_schema_extra={"vmanage_key": "track-omp"},
-        description="Flag to track Overlay Management Protocol (OMP) session state.",
-    )
-    track_prefix_list: Optional[str] = Field(
-        default=None,
-        json_schema_extra={"vmanage_key": "track-prefix-list"},
-        description="Name of the prefix-list used for tracking specific routes.",
-    )
+    grp_id: int = Field(json_schema_extra={"vmanage_key": "grp-id"})
+    priority: int = DEFAULT_VRRP_PRIORITY
+    timer: int = DEFAULT_VRRP_TIMER
+    track_omp: BoolStr = Field(default=False, json_schema_extra={"vmanage_key": "track-omp"})
+    track_prefix_list: Optional[str] = Field(default=None, json_schema_extra={"vmanage_key": "track-prefix-list"})
     address: Optional[ipaddress.IPv4Address] = Field(
-        default=None,
-        json_schema_extra={"data_path": ["ipv4"], "vmanage_key": "address"},
-        description="Virtual IP address used by the VRRP group.",
+        default=None, json_schema_extra={"data_path": ["ipv4"], "vmanage_key": "address"}
     )
     ipv4_secondary: Optional[List[Ipv4Secondary]] = Field(
-        default=None,
-        json_schema_extra={"vmanage_key": "ipv4-secondary"},
-        description="List of secondary IPv4 addresses for the VRRP group.",
-    )
-    tloc_change_pref: BoolStr = Field(
-        default=False,
-        json_schema_extra={"vmanage_key": "tloc-change-pref"},
-        description="Flag to change preference based on TLOC status.",
+        default=None, json_schema_extra={"vmanage_key": "ipv4-secondary"}
     )
-    value: int = Field(..., description="VRRP value to determine the primary node for the VRRP group.")
+    tloc_change_pref: BoolStr = Field(default=False, json_schema_extra={"vmanage_key": "tloc-change-pref"})
+    value: int
     tracking_object: Optional[List[TrackingObject]] = Field(
-        default=None,
-        json_schema_extra={"vmanage_key": "tracking-object"},
-        description="List of tracking objects associated with the VRRP configuration.",
+        default=None, json_schema_extra={"vmanage_key": "tracking-object"}
     )
-    model_config: ClassVar[ConfigDict] = ConfigDict(populate_by_name=True)
+    model_config = ConfigDict(populate_by_name=True)
 
 
 class Ipv6(FeatureTemplateValidator):
-    ipv6_link_local: ipaddress.IPv6Address = Field(
-        ...,
-        json_schema_extra={"vmanage_key": "ipv6-link-local"},
-        description="IPv6 link-local address for the interface.",
-    )
-    prefix: Optional[ipaddress.IPv6Interface] = Field(
-        default=None, description="Optional IPv6 prefix for the interface, with CIDR notation."
-    )
+    ipv6_link_local: ipaddress.IPv6Address = Field(json_schema_extra={"vmanage_key": "ipv6-link-local"})
+    prefix: Optional[ipaddress.IPv6Interface] = None
     model_config = ConfigDict(populate_by_name=True)
 
 
 class Ipv6Vrrp(FeatureTemplateValidator):
-    grp_id: int = Field(..., json_schema_extra={"vmanage_key": "grp-id"}, description="IPv6 VRRP group ID.")
-    priority: int = Field(
-        default=DEFAULT_IPV6_VRRP_PRIORITY,
-        description="Priority value for the IPv6 VRRP group (higher values take precedence).",
-    )
-    timer: int = Field(
-        default=DEFAULT_IPV6_VRRP_TIMER, description="IPv6 VRRP advertisement interval timer in milliseconds."
-    )
-    track_omp: BoolStr = Field(
-        default=False,
-        json_schema_extra={"vmanage_key": "track-omp"},
-        description="Flag to track Overlay Management Protocol (OMP) session state for IPv6.",
-    )
-    track_prefix_list: Optional[str] = Field(
-        default=None,
-        json_schema_extra={"vmanage_key": "track-prefix-list"},
-        description="Name of the IPv6 prefix-list used for tracking specific routes.",
-    )
-    ipv6: Optional[List[Ipv6]] = Field(
-        default=None, description="List of IPv6 configurations associated with the VRRP group."
-    )
+    grp_id: int = Field(json_schema_extra={"vmanage_key": "grp-id"})
+    priority: int = DEFAULT_IPV6_VRRP_PRIORITY
+    timer: int = DEFAULT_IPV6_VRRP_TIMER
+    track_omp: BoolStr = Field(default=False, json_schema_extra={"vmanage_key": "track-omp"})
+    track_prefix_list: Optional[str] = Field(default=None, json_schema_extra={"vmanage_key": "track-prefix-list"})
+    ipv6: Optional[List[Ipv6]] = None
     model_config = ConfigDict(populate_by_name=True)
 
 
 class CiscoVpnInterfaceModel(FeatureTemplate):
     model_config = ConfigDict(arbitrary_types_allowed=True, populate_by_name=True)
-    _docs_description: str = "Cisco VPN Interface Feature Template configuration"
 
-    if_name: Optional[str] = Field(
-        default=None, description="The name of the interface.", json_schema_extra={"vmanage_key": "if-name"}
-    )
-    interface_description: Optional[str] = Field(
-        default=None, description="A description for the interface.", json_schema_extra={"vmanage_key": "description"}
-    )
-    poe: Optional[BoolStr] = Field(
-        default=None,
-        description="Power over Ethernet setting for the interface. True if enabled, False otherwise.",
-    )
-    ipv4_address: Optional[str] = Field(
-        default=None,
-        description="The primary IPv4 address assigned to the interface.",
-        json_schema_extra={"data_path": ["ip"], "vmanage_key": "address"},
-    )
+    if_name: Optional[str] = Field(default=None, json_schema_extra={"vmanage_key": "if-name"})
+    interface_description: Optional[str] = Field(default=None, json_schema_extra={"vmanage_key": "description"})
+    poe: Optional[BoolStr] = None
+    ipv4_address: Optional[str] = Field(default=None, json_schema_extra={"data_path": ["ip"], "vmanage_key": "address"})
     secondary_ipv4_address: Optional[List[SecondaryIPv4Address]] = Field(
-        default=None,
-        description="A list of secondary IPv4 addresses assigned to the interface.",
-        json_schema_extra={"data_path": ["ip"], "vmanage_key": "secondary-address"},
+        default=None, json_schema_extra={"data_path": ["ip"], "vmanage_key": "secondary-address"}
     )
     dhcp_ipv4_client: Optional[BoolStr] = Field(
-        default=None,
-        description=(
-            "Whether DHCP client is enabled on the interface for IPv4 addressing. True if enabled, False otherwise."
-        ),
-        json_schema_extra={"data_path": ["ip"], "vmanage_key": "dhcp-client"},
-    )
-    dhcp_distance: Optional[int] = Field(
-        default=None,
-        description="Administrative distance for DHCP routes on the interface.",
-        json_schema_extra={"vmanage_key": "dhcp-distance"},
+        default=None, json_schema_extra={"data_path": ["ip"], "vmanage_key": "dhcp-client"}
     )
+    dhcp_distance: Optional[int] = Field(default=None, json_schema_extra={"vmanage_key": "dhcp-distance"})
     ipv6_address: Optional[ipaddress.IPv6Interface] = Field(
-        default=None,
-        description="The primary IPv6 address assigned to the interface.",
-        json_schema_extra={"data_path": ["ipv6"], "vmanage_key": "address"},
+        default=None, json_schema_extra={"data_path": ["ipv6"], "vmanage_key": "address"}
     )
     dhcp_ipv6_client: Optional[BoolStr] = Field(
-        default=None,
-        description=(
-            "Whether DHCP client is enabled on the interface for IPv6 addressing. True if enabled, False otherwise."
-        ),
-        json_schema_extra={"data_path": ["ipv6"], "vmanage_key": "dhcp-client"},
+        default=None, json_schema_extra={"data_path": ["ipv6"], "vmanage_key": "dhcp-client"}
     )
     secondary_ipv6_address: Optional[List[SecondaryIPv6Address]] = Field(
-        default=None,
-        description="A list of secondary IPv6 addresses assigned to the interface.",
-        json_schema_extra={"data_path": ["ipv6"], "vmanage_key": "secondary-address"},
-    )
-    access_list_ipv4: Optional[List[AccessList]] = Field(
-        default=None,
-        description="A list of IPv4 access control lists (ACLs) applied to the interface.",
-        json_schema_extra={"vmanage_key": "access-list"},
+        default=None, json_schema_extra={"data_path": ["ipv6"], "vmanage_key": "secondary-address"}
     )
+    access_list_ipv4: Optional[List[AccessList]] = Field(default=None, json_schema_extra={"vmanage_key": "access-list"})
     dhcp_helper: Optional[List[ipaddress.IPv4Address]] = Field(
-        default=None,
-        description="A list of DHCP helper addresses configured on the interface.",
-        json_schema_extra={"vmanage_key": "dhcp-helper"},
+        default=None, json_schema_extra={"vmanage_key": "dhcp-helper"}
     )
     dhcp_helper_v6: Optional[List[DhcpHelperV6]] = Field(
-        default=None,
-        description="A list of DHCPv6 helper configurations applied to the interface.",
-        json_schema_extra={"vmanage_key": "dhcp-helper-v6"},
-    )
-    tracker: Optional[List[str]] = Field(
-        default=None,
-        description="A list of tracker identifiers associated with the interface.",
+        default=None, json_schema_extra={"vmanage_key": "dhcp-helper-v6"}
     )
+    tracker: Optional[List[str]] = None
     auto_bandwidth_detect: Optional[BoolStr] = Field(
-        default=None,
-        description=(
-            "Whether automatic bandwidth detection is enabled on the interface. True if enabled, False otherwise."
-        ),
-        json_schema_extra={"vmanage_key": "auto-bandwidth-detect"},
+        default=None, json_schema_extra={"vmanage_key": "auto-bandwidth-detect"}
     )
     iperf_server: Optional[ipaddress.IPv4Address] = Field(
-        default=None,
-        description="The IP address of the iPerf server used for performance testing from this interface.",
-        json_schema_extra={"vmanage_key": "iperf-server"},
-    )
-    nat: Optional[BoolStr] = Field(
-        default=None,
-        description="Indicates whether Network Address Translation (NAT) is enabled on the interface.",
-    )
-    nat_choice: Optional[NatChoice] = Field(
-        default=None,
-        description="The type of NAT configured on the interface, if applicable.",
-        json_schema_extra={"vmanage_key": "nat-choice"},
-    )
-    udp_timeout: Optional[int] = Field(
-        default=None,
-        description="The timeout value in seconds for UDP connections through the NAT on this interface.",
-        json_schema_extra={"vmanage_key": "udp-timeout"},
-    )
-    tcp_timeout: Optional[int] = Field(
-        default=None,
-        description="The timeout value in seconds for TCP connections through the NAT on this interface.",
-        json_schema_extra={"vmanage_key": "tcp-timeout"},
+        default=None, json_schema_extra={"vmanage_key": "iperf-server"}
     )
+    nat: Optional[BoolStr] = None
+    nat_choice: Optional[NatChoice] = Field(default=None, json_schema_extra={"vmanage_key": "nat-choice"})
+    udp_timeout: Optional[int] = Field(default=None, json_schema_extra={"vmanage_key": "udp-timeout"})
+    tcp_timeout: Optional[int] = Field(default=None, json_schema_extra={"vmanage_key": "tcp-timeout"})
     nat_range_start: Optional[ipaddress.IPv4Address] = Field(
-        default=None,
-        description="The starting IP address in the range used for NAT on this interface.",
-        json_schema_extra={"vmanage_key": "range-start"},
-    )
-    nat_range_end: Optional[ipaddress.IPv4Address] = Field(
-        default=None,
-        description="The ending IP address in the range used for NAT on this interface.",
-        json_schema_extra={"vmanage_key": "range-end"},
-    )
-    overload: Optional[BoolStr] = Field(
-        default=None,
-        description="Indicates if NAT overload (PAT - Port Address Translation) is enabled.",
-    )
-    loopback_interface: Optional[str] = Field(
-        default=None,
-        description="The associated loopback interface, if any, for the VPN interface.",
-        json_schema_extra={"vmanage_key": "loopback-interface"},
-    )
-    prefix_length: Optional[int] = Field(
-        default=None,
-        description="The prefix length for the interface's IP address, indicating the size of the subnet.",
-        json_schema_extra={"vmanage_key": "prefix-length"},
-    )
-    enable: Optional[BoolStr] = Field(
-        default=None,
-        description="Indicates whether the interface is enabled or disabled.",
-    )
-    nat64: Optional[BoolStr] = Field(
-        default=None,
-        description=(
-            "Indicates whether NAT64 is enabled on the interface, "
-            "allowing IPv6 addresses to communicate with IPv4 services."
-        ),
-    )
-    nat66: Optional[BoolStr] = Field(
-        default=None,
-        description=(
-            "Indicates whether NAT66 is enabled on the interface, translating IPv6 addresses into IPv6 addresses."
-        ),
-    )
-    static_nat66: Optional[List[StaticNat66]] = Field(
-        default=None,
-        description="List of static NAT66 entries for translating IPv6 addresses into other IPv6 addresses.",
-        json_schema_extra={"vmanage_key": "static-nat66"},
-    )
-
+        default=None, json_schema_extra={"vmanage_key": "range-start"}
+    )
+    nat_range_end: Optional[ipaddress.IPv4Address] = Field(default=None, json_schema_extra={"vmanage_key": "range-end"})
+    overload: Optional[BoolStr] = None
+    loopback_interface: Optional[str] = Field(default=None, json_schema_extra={"vmanage_key": "loopback-interface"})
+    prefix_length: Optional[int] = Field(default=None, json_schema_extra={"vmanage_key": "prefix-length"})
+    enable: Optional[BoolStr] = None
+    nat64: Optional[BoolStr] = None
+    nat66: Optional[BoolStr] = None
+    static_nat66: Optional[List[StaticNat66]] = Field(default=None, json_schema_extra={"vmanage_key": "static-nat66"})
     static: Optional[List[Static]] = Field(
-        default=None,
-        description="List of static NAT entries for configuring one-to-one address mappings.",
-        json_schema_extra={"data_path": ["nat"], "vmanage_key": "static"},
+        default=None, json_schema_extra={"data_path": ["nat"], "vmanage_key": "static"}
     )
     static_port_forward: Optional[List[StaticPortForward]] = Field(
-        default=None,
-        description="List of static port forwarding entries for the interface.",
-        json_schema_extra={"vmanage_key": "static-port-forward"},
-    )
-    enable_core_region: Optional[BoolStr] = Field(
-        default=None,
-        description="Indicates if the interface is part of the core network region for centralized services.",
-        json_schema_extra={"vmanage_key": "enable-core-region"},
-    )
-    core_region: Optional[CoreRegion] = Field(
-        default=None,
-        json_schema_extra={"vmanage_key": "core-region"},
-        description="Configuration details for the core region.",
+        default=None, json_schema_extra={"vmanage_key": "static-port-forward"}
     )
+    enable_core_region: Optional[BoolStr] = Field(default=None, json_schema_extra={"vmanage_key": "enable-core-region"})
+    core_region: Optional[CoreRegion] = Field(default=None, json_schema_extra={"vmanage_key": "core-region"})
     secondary_region: Optional[SecondaryRegion] = Field(
-        default=None,
-        json_schema_extra={"vmanage_key": "secondary-region"},
-        description="Configuration details for a secondary region.",
+        default=None, json_schema_extra={"vmanage_key": "secondary-region"}
     )
     tloc_encapsulation: Optional[List[Encapsulation]] = Field(
-        default=None,
-        json_schema_extra={"vmanage_key": "encapsulation", "data_path": ["tunnel-interface"]},
-        description="Transport Location (TLOC) encapsulation settings.",
-    )
-    border: Optional[BoolStr] = Field(
-        default=None,
-        json_schema_extra={"data_path": ["tunnel-interface"]},
-        description="Defines if the interface is at the border of a network segment.",
-    )
-    per_tunnel_qos: Optional[BoolStr] = Field(
-        default=None,
-        json_schema_extra={"vmanage_key": "per-tunnel-qos"},
-        description="Enable or disable per-tunnel Quality of Service (QoS).",
+        default=None, json_schema_extra={"vmanage_key": "encapsulation", "data_path": ["tunnel-interface"]}
     )
+    border: Optional[BoolStr] = Field(default=None, json_schema_extra={"data_path": ["tunnel-interface"]})
+    per_tunnel_qos: Optional[BoolStr] = Field(default=None, json_schema_extra={"vmanage_key": "per-tunnel-qos"})
     per_tunnel_qos_aggregator: Optional[BoolStr] = Field(
-        default=None,
-        json_schema_extra={"vmanage_key": "per-tunnel-qos-aggregator"},
-        description="Enable or disable per-tunnel QoS aggregator.",
-    )
-    mode: Optional[Mode] = Field(default=None, description="Defines the operating mode for the interface.")
-    tunnels_bandwidth: Optional[int] = Field(
-        default=None,
-        json_schema_extra={"vmanage_key": "tunnels-bandwidth"},
-        description="Specifies the total bandwidth available across all tunnels.",
-    )
-    group: Optional[List[int]] = Field(
-        default=None,
-        json_schema_extra={"data_path": ["tunnel-interface"]},
-        description="Identifies the group or groups the interface belongs to.",
-    )
-    value: Optional[TLOCColor] = Field(
-        default=None,
-        json_schema_extra={"data_path": ["tunnel-interface", "color"]},
-        description=(
-            "The value field often corresponds to a specific attribute or setting, such as color in this context."
-        ),
+        default=None, json_schema_extra={"vmanage_key": "per-tunnel-qos-aggregator"}
     )
+    mode: Optional[Mode] = None
+    tunnels_bandwidth: Optional[int] = Field(default=None, json_schema_extra={"vmanage_key": "tunnels-bandwidth"})
+    group: Optional[List[int]] = Field(default=None, json_schema_extra={"data_path": ["tunnel-interface"]})
+    value: Optional[Value] = Field(default=None, json_schema_extra={"data_path": ["tunnel-interface", "color"]})
     max_control_connections: Optional[int] = Field(
-        default=None,
-        json_schema_extra={"vmanage_key": "max-control-connections", "data_path": ["tunnel-interface"]},
-        description="Maximum number of control connections that can be established on the interface.",
+        default=None, json_schema_extra={"vmanage_key": "max-control-connections", "data_path": ["tunnel-interface"]}
     )
     control_connections: Optional[BoolStr] = Field(
-        default=None,
-        json_schema_extra={"vmanage_key": "control-connections", "data_path": ["tunnel-interface"]},
-        description="Enables or disables control connections on the interface.",
+        default=None, json_schema_extra={"vmanage_key": "control-connections", "data_path": ["tunnel-interface"]}
     )
     vbond_as_stun_server: Optional[BoolStr] = Field(
-        default=None,
-        json_schema_extra={"vmanage_key": "vbond-as-stun-server", "data_path": ["tunnel-interface"]},
-        description="Configures the vBond orchestrator to act as a STUN server for the interface.",
+        default=None, json_schema_extra={"vmanage_key": "vbond-as-stun-server", "data_path": ["tunnel-interface"]}
     )
     exclude_controller_group_list: Optional[List[int]] = Field(
         default=None,
         json_schema_extra={"vmanage_key": "exclude-controller-group-list", "data_path": ["tunnel-interface"]},
-        description="List of controller groups to exclude from connections.",
     )
     vmanage_connection_preference: Optional[int] = Field(
         default=None,
         json_schema_extra={"vmanage_key": "vmanage-connection-preference", "data_path": ["tunnel-interface"]},
-        description="Preference value for establishing vManage connections.",
     )
     port_hop: Optional[BoolStr] = Field(
-        default=None,
-        json_schema_extra={"vmanage_key": "port-hop", "data_path": ["tunnel-interface"]},
-        description="Enables or disables port hopping for the interface to evade port blocking.",
-    )
-    restrict: Optional[BoolStr] = Field(
-        default=None,
-        json_schema_extra={"data_path": ["tunnel-interface", "color"]},
-        description="Indicates whether the interface color is restricted for use.",
+        default=None, json_schema_extra={"vmanage_key": "port-hop", "data_path": ["tunnel-interface"]}
     )
+    restrict: Optional[BoolStr] = Field(default=None, json_schema_extra={"data_path": ["tunnel-interface", "color"]})
     dst_ip: Optional[ipaddress.IPv4Address] = Field(
         default=None,
         json_schema_extra={"vmanage_key": "dst-ip", "data_path": ["tunnel-interface", "tloc-extension-gre-to"]},
-        description="Destination IP address for GRE (Generic Routing Encapsulation) tunnel extension.",
-    )
-    carrier: Optional[Carrier] = Field(
-        default=None,
-        json_schema_extra={"data_path": ["tunnel-interface"]},
-        description="Specifies the carrier information for the tunnel interface.",
     )
+    carrier: Optional[Carrier] = Field(default=None, json_schema_extra={"data_path": ["tunnel-interface"]})
     nat_refresh_interval: Optional[int] = Field(
-        default=None,
-        json_schema_extra={"vmanage_key": "nat-refresh-interval", "data_path": ["tunnel-interface"]},
-        description="Interval in seconds to refresh NAT (Network Address Translation) mappings.",
+        default=None, json_schema_extra={"vmanage_key": "nat-refresh-interval", "data_path": ["tunnel-interface"]}
     )
     hello_interval: Optional[int] = Field(
-        default=None,
-        json_schema_extra={"vmanage_key": "hello-interval", "data_path": ["tunnel-interface"]},
-        description="Time interval in seconds between successive hello packets sent over the tunnel interface.",
+        default=None, json_schema_extra={"vmanage_key": "hello-interval", "data_path": ["tunnel-interface"]}
     )
     hello_tolerance: Optional[int] = Field(
-        default=None,
-        json_schema_extra={"vmanage_key": "hello-tolerance", "data_path": ["tunnel-interface"]},
-        description="Time in seconds to wait before declaring a neighbor down due to missing hello packets.",
-    )
-    bind: Optional[str] = Field(
-        default=None,
-        json_schema_extra={"data_path": ["tunnel-interface"]},
-        description="Interface or IP address to which the tunnel interface is bound.",
+        default=None, json_schema_extra={"vmanage_key": "hello-tolerance", "data_path": ["tunnel-interface"]}
     )
+    bind: Optional[str] = Field(default=None, json_schema_extra={"data_path": ["tunnel-interface"]})
     last_resort_circuit: Optional[BoolStr] = Field(
-        default=None,
-        json_schema_extra={"vmanage_key": "last-resort-circuit", "data_path": ["tunnel-interface"]},
-        description="Marks the interface as a last resort circuit for traffic to fall back to.",
+        default=None, json_schema_extra={"vmanage_key": "last-resort-circuit", "data_path": ["tunnel-interface"]}
     )
     low_bandwidth_link: Optional[BoolStr] = Field(
-        default=None,
-        json_schema_extra={"vmanage_key": "low-bandwidth-link", "data_path": ["tunnel-interface"]},
-        description="Indicates if the link is considered a low bandwidth link.",
+        default=None, json_schema_extra={"vmanage_key": "low-bandwidth-link", "data_path": ["tunnel-interface"]}
     )
     tunnel_tcp_mss_adjust: Optional[int] = Field(
-        default=None,
-        json_schema_extra={"vmanage_key": "tunnel-tcp-mss-adjust", "data_path": ["tunnel-interface"]},
-        description="Adjusts the Maximum Segment Size (MSS) value for TCP connections over the tunnel.",
+        default=None, json_schema_extra={"vmanage_key": "tunnel-tcp-mss-adjust", "data_path": ["tunnel-interface"]}
     )
     clear_dont_fragment: Optional[BoolStr] = Field(
-        default=None,
-        json_schema_extra={"vmanage_key": "clear-dont-fragment", "data_path": ["tunnel-interface"]},
-        description="Enables or disables the clearing of the 'Don't Fragment' (DF) bit in the IP header.",
+        default=None, json_schema_extra={"vmanage_key": "clear-dont-fragment", "data_path": ["tunnel-interface"]}
     )
     propagate_sgt: Optional[BoolStr] = Field(
-        default=None,
-        json_schema_extra={"data_path": ["tunnel-interface"], "vmanage_key": "propagate-sgt"},
-        description="Enables or disables the propagation of Security Group Tags (SGTs) across the tunnel interface.",
+        default=None, json_schema_extra={"data_path": ["tunnel-interface"], "vmanage_key": "propagate-sgt"}
     )
     network_broadcast: Optional[BoolStr] = Field(
-        default=None,
-        json_schema_extra={"vmanage_key": "network-broadcast", "data_path": ["tunnel-interface"]},
-        description="Allows or disallows network broadcast traffic through the tunnel interface.",
-    )
-    all: Optional[BoolStr] = Field(
-        default=None,
-        json_schema_extra={"data_path": ["tunnel-interface", "allow-service"]},
-        description="Permits or denies all services through the tunnel interface.",
-    )
-    bgp: Optional[BoolStr] = Field(
-        default=None,
-        json_schema_extra={"data_path": ["tunnel-interface", "allow-service"]},
-        description="Allows or disallows Border Gateway Protocol (BGP) traffic through the tunnel interface.",
+        default=None, json_schema_extra={"vmanage_key": "network-broadcast", "data_path": ["tunnel-interface"]}
     )
+    all: Optional[BoolStr] = Field(default=None, json_schema_extra={"data_path": ["tunnel-interface", "allow-service"]})
+    bgp: Optional[BoolStr] = Field(default=None, json_schema_extra={"data_path": ["tunnel-interface", "allow-service"]})
     dhcp: Optional[BoolStr] = Field(
-        default=None,
-        json_schema_extra={"data_path": ["tunnel-interface", "allow-service"]},
-        description="Enables or disables Dynamic Host Configuration Protocol (DHCP) on the tunnel interface.",
-    )
-    dns: Optional[BoolStr] = Field(
-        default=None,
-        json_schema_extra={"data_path": ["tunnel-interface", "allow-service"]},
-        description="Allows or disallows Domain Name System (DNS) queries through the tunnel interface.",
+        default=None, json_schema_extra={"data_path": ["tunnel-interface", "allow-service"]}
     )
+    dns: Optional[BoolStr] = Field(default=None, json_schema_extra={"data_path": ["tunnel-interface", "allow-service"]})
     icmp: Optional[BoolStr] = Field(
-        default=None,
-        json_schema_extra={"data_path": ["tunnel-interface", "allow-service"]},
-        description=(
-            "Enables or disables Internet Control Message Protocol (ICMP) "
-            "for ping and traceroute through the tunnel interface."
-        ),
+        default=None, json_schema_extra={"data_path": ["tunnel-interface", "allow-service"]}
     )
     sshd: Optional[BoolStr] = Field(
-        default=None,
-        json_schema_extra={"data_path": ["tunnel-interface", "allow-service"]},
-        description="Allows or disallows Secure Shell (SSH) daemon access through the tunnel interface.",
+        default=None, json_schema_extra={"data_path": ["tunnel-interface", "allow-service"]}
     )
     netconf: Optional[BoolStr] = Field(
-        default=None,
-        json_schema_extra={"data_path": ["tunnel-interface", "allow-service"]},
-        description="Enables or disables NETCONF protocol support on the tunnel interface.",
-    )
-    ntp: Optional[BoolStr] = Field(
-        default=None,
-        json_schema_extra={"data_path": ["tunnel-interface", "allow-service"]},
-        description="Allows or disallows Network Time Protocol (NTP) synchronization through the tunnel interface.",
+        default=None, json_schema_extra={"data_path": ["tunnel-interface", "allow-service"]}
     )
+    ntp: Optional[BoolStr] = Field(default=None, json_schema_extra={"data_path": ["tunnel-interface", "allow-service"]})
     ospf: Optional[BoolStr] = Field(
-        default=None,
-        json_schema_extra={"data_path": ["tunnel-interface", "allow-service"]},
-        description=(
-            "Permits or denies Open Shortest Path First (OSPF) routing protocol traffic through the tunnel interface."
-        ),
+        default=None, json_schema_extra={"data_path": ["tunnel-interface", "allow-service"]}
     )
     stun: Optional[BoolStr] = Field(
-        default=None,
-        json_schema_extra={"data_path": ["tunnel-interface", "allow-service"]},
-        description="Enables or disables Session Traversal Utilities for NAT (STUN) on the tunnel interface.",
+        default=None, json_schema_extra={"data_path": ["tunnel-interface", "allow-service"]}
     )
     snmp: Optional[BoolStr] = Field(
-        default=None,
-        json_schema_extra={"data_path": ["tunnel-interface", "allow-service"]},
-        description="Allows or disallows Simple Network Management Protocol (SNMP) through the tunnel interface.",
+        default=None, json_schema_extra={"data_path": ["tunnel-interface", "allow-service"]}
     )
     https: Optional[BoolStr] = Field(
-        default=None,
-        json_schema_extra={"data_path": ["tunnel-interface", "allow-service"]},
-        description="Permits or denies HTTPS traffic through the tunnel interface.",
-    )
-    media_type: Optional[MediaType] = Field(
-        default=None,
-        json_schema_extra={"vmanage_key": "media-type"},
-        description="Specifies the media type used by the interface, such as copper or fiber.",
-    )
-    intrf_mtu: Optional[int] = Field(
-        default=None,
-        json_schema_extra={"vmanage_key": "intrf-mtu"},
-        description="Sets the Maximum Transmission Unit (MTU) size for the interface.",
-    )
-    mtu: Optional[int] = Field(default=None, description="Specifies the MTU size for the tunnel or logical interface.")
-    tcp_mss_adjust: Optional[int] = Field(
-        default=None,
-        json_schema_extra={"vmanage_key": "tcp-mss-adjust"},
-        description="Adjusts the TCP Maximum Segment Size (MSS) value for connections over the interface.",
-    )
-    tloc_extension: Optional[str] = Field(
-        default=None,
-        json_schema_extra={"vmanage_key": "tloc-extension"},
-        description="Defines the Transport Location (TLOC) extension for the interface.",
-    )
-    load_interval: Optional[int] = Field(
-        default=None,
-        json_schema_extra={"vmanage_key": "load-interval"},
-        description="Sets the time interval in seconds for calculating interface load statistics.",
-    )
+        default=None, json_schema_extra={"data_path": ["tunnel-interface", "allow-service"]}
+    )
+    media_type: Optional[MediaType] = Field(default=None, json_schema_extra={"vmanage_key": "media-type"})
+    intrf_mtu: Optional[int] = Field(default=None, json_schema_extra={"vmanage_key": "intrf-mtu"})
+    mtu: Optional[int] = None
+    tcp_mss_adjust: Optional[int] = Field(default=None, json_schema_extra={"vmanage_key": "tcp-mss-adjust"})
+    tloc_extension: Optional[str] = Field(default=None, json_schema_extra={"vmanage_key": "tloc-extension"})
+    load_interval: Optional[int] = Field(default=None, json_schema_extra={"vmanage_key": "load-interval"})
     src_ip: Optional[ipaddress.IPv4Address] = Field(
-        default=None,
-        json_schema_extra={"vmanage_key": "src-ip", "data_path": ["tloc-extension-gre-from"]},
-        description="Source IP address for GRE tunnel extension.",
-    )
-    xconnect: Optional[str] = Field(
-        default=None,
-        json_schema_extra={"data_path": ["tloc-extension-gre-from"]},
-        description="Cross-connect identifier for the GRE tunnel extension.",
-    )
-    mac_address: Optional[str] = Field(
-        default=None,
-        json_schema_extra={"vmanage_key": "mac-address"},
-        description="Specifies the MAC address for the interface.",
-    )
-    speed: Optional[Speed] = Field(
-        default=None, description="Defines the speed of the interface, such as 10Mbps, 100Mbps, or 1Gbps."
-    )
-    duplex: Optional[Duplex] = Field(
-        default=None, description="Sets the duplex mode for the interface, such as full or half duplex."
-    )
-    shutdown: Optional[BoolStr] = Field(default=False, description="Enables or disables (shuts down) the interface.")
-    arp_timeout: Optional[int] = Field(
-        default=None,
-        json_schema_extra={"vmanage_key": "arp-timeout"},
-        description="Time in seconds before an ARP cache entry is timed out.",
-    )
-    autonegotiate: Optional[BoolStr] = Field(
-        default=None, description="Enables or disables autonegotiation of speed and duplex settings on the interface."
-    )
+        default=None, json_schema_extra={"vmanage_key": "src-ip", "data_path": ["tloc-extension-gre-from"]}
+    )
+    xconnect: Optional[str] = Field(default=None, json_schema_extra={"data_path": ["tloc-extension-gre-from"]})
+    mac_address: Optional[str] = Field(default=None, json_schema_extra={"vmanage_key": "mac-address"})
+    speed: Optional[Speed] = None
+    duplex: Optional[Duplex] = None
+    shutdown: Optional[BoolStr] = False
+    arp_timeout: Optional[int] = Field(default=None, json_schema_extra={"vmanage_key": "arp-timeout"})
+    autonegotiate: Optional[BoolStr] = None
     ip_directed_broadcast: Optional[BoolStr] = Field(
-        default=None,
-        json_schema_extra={"vmanage_key": "ip-directed-broadcast"},
-        description="Allows or disallows IP directed broadcasts on the interface.",
+        default=None, json_schema_extra={"vmanage_key": "ip-directed-broadcast"}
     )
     icmp_redirect_disable: Optional[BoolStr] = Field(
-        default=None,
-        json_schema_extra={"vmanage_key": "icmp-redirect-disable"},
-        description="Enables or disables ICMP redirect messages on the interface.",
-    )
-    qos_adaptive: Optional[BoolStr] = Field(
-        default=None,
-        json_schema_extra={"vmanage_key": "qos-adaptive"},
-        description="Activates or deactivates adaptive QoS on the interface.",
-    )
-    period: Optional[int] = Field(
-        default=None,
-        json_schema_extra={"data_path": ["qos-adaptive"]},
-        description="Time period in seconds for measuring and adapting QoS settings.",
+        default=None, json_schema_extra={"vmanage_key": "icmp-redirect-disable"}
     )
+    qos_adaptive: Optional[BoolStr] = Field(default=None, json_schema_extra={"vmanage_key": "qos-adaptive"})
+    period: Optional[int] = Field(default=None, json_schema_extra={"data_path": ["qos-adaptive"]})
     bandwidth_down: Optional[int] = Field(
-        default=None,
-        json_schema_extra={"vmanage_key": "bandwidth-down", "data_path": ["qos-adaptive", "downstream"]},
-        description="Specifies the downstream bandwidth in Kbps for adaptive QoS calculations.",
-    )
-    dmin: Optional[int] = Field(
-        default=None,
-        json_schema_extra={"data_path": ["qos-adaptive", "downstream", "range"]},
-        description="Specifies the minimum downstream bandwidth in Kbps for adaptive QoS.",
-    )
-    dmax: Optional[int] = Field(
-        default=None,
-        json_schema_extra={"data_path": ["qos-adaptive", "downstream", "range"]},
-        description="Specifies the maximum downstream bandwidth in Kbps for adaptive QoS.",
+        default=None, json_schema_extra={"vmanage_key": "bandwidth-down", "data_path": ["qos-adaptive", "downstream"]}
     )
+    dmin: Optional[int] = Field(default=None, json_schema_extra={"data_path": ["qos-adaptive", "downstream", "range"]})
+    dmax: Optional[int] = Field(default=None, json_schema_extra={"data_path": ["qos-adaptive", "downstream", "range"]})
     bandwidth_up: Optional[int] = Field(
-        default=None,
-        json_schema_extra={"vmanage_key": "bandwidth-up", "data_path": ["qos-adaptive", "upstream"]},
-        description="Specifies the upstream bandwidth in Kbps for adaptive QoS calculations.",
-    )
-    umin: Optional[int] = Field(
-        default=None,
-        json_schema_extra={"data_path": ["qos-adaptive", "upstream", "range"]},
-        description="Specifies the minimum upstream bandwidth in Kbps for adaptive QoS.",
-    )
-    umax: Optional[int] = Field(
-        default=None,
-        json_schema_extra={"data_path": ["qos-adaptive", "upstream", "range"]},
-        description="Specifies the maximum upstream bandwidth in Kbps for adaptive QoS.",
-    )
-    shaping_rate: Optional[int] = Field(
-        default=None,
-        json_schema_extra={"vmanage_key": "shaping-rate"},
-        description="Defines the traffic shaping rate for the interface.",
-    )
-    qos_map: Optional[str] = Field(
-        default=None,
-        json_schema_extra={"vmanage_key": "qos-map"},
-        description="Associates a QoS map with the interface for traffic classification and prioritization.",
-    )
-    qos_map_vpn: Optional[str] = Field(
-        default=None,
-        json_schema_extra={"vmanage_key": "qos-map-vpn"},
-        description="Associates a QoS map with a VPN for traffic classification and prioritization within the VPN.",
-    )
-    service_provider: Optional[str] = Field(
-        default=None,
-        json_schema_extra={"vmanage_key": "service-provider"},
-        description="Identifies the service provider associated with the interface.",
-    )
-    bandwidth_upstream: Optional[int] = Field(
-        default=None,
-        json_schema_extra={"vmanage_key": "bandwidth-upstream"},
-        description="Specifies the upstream bandwidth in Kbps available on the interface.",
-    )
-    bandwidth_downstream: Optional[int] = Field(
-        default=None,
-        json_schema_extra={"vmanage_key": "bandwidth-downstream"},
-        description="Specifies the downstream bandwidth in Kbps available on the interface.",
-    )
+        default=None, json_schema_extra={"vmanage_key": "bandwidth-up", "data_path": ["qos-adaptive", "upstream"]}
+    )
+    umin: Optional[int] = Field(default=None, json_schema_extra={"data_path": ["qos-adaptive", "upstream", "range"]})
+    umax: Optional[int] = Field(default=None, json_schema_extra={"data_path": ["qos-adaptive", "upstream", "range"]})
+    shaping_rate: Optional[int] = Field(default=None, json_schema_extra={"vmanage_key": "shaping-rate"})
+    qos_map: Optional[str] = Field(default=None, json_schema_extra={"vmanage_key": "qos-map"})
+    qos_map_vpn: Optional[str] = Field(default=None, json_schema_extra={"vmanage_key": "qos-map-vpn"})
+    service_provider: Optional[str] = Field(default=None, json_schema_extra={"vmanage_key": "service-provider"})
+    bandwidth_upstream: Optional[int] = Field(default=None, json_schema_extra={"vmanage_key": "bandwidth-upstream"})
+    bandwidth_downstream: Optional[int] = Field(default=None, json_schema_extra={"vmanage_key": "bandwidth-downstream"})
     block_non_source_ip: Optional[BoolStr] = Field(
-        default=None,
-        json_schema_extra={"vmanage_key": "block-non-source-ip"},
-        description="Enables or disables blocking of traffic with non-matching source IP addresses.",
+        default=None, json_schema_extra={"vmanage_key": "block-non-source-ip"}
     )
     rule_name: Optional[str] = Field(
-        default=None,
-        json_schema_extra={"vmanage_key": "rule-name", "data_path": ["rewrite-rule"]},
-        description="Specifies the name of the rewrite rule applied to the interface.",
+        default=None, json_schema_extra={"vmanage_key": "rule-name", "data_path": ["rewrite-rule"]}
     )
     access_list_ipv6: Optional[List[AccessList]] = Field(
-        default=None,
-        json_schema_extra={"data_path": ["ipv6"], "vmanage_key": "access-list"},
-        description="Defines a list of access control entries for IPv6 traffic filtering.",
-    )
-    ip: Optional[List[Ip]] = Field(
-        default=None,
-        json_schema_extra={"data_path": ["arp"]},
-        description="A list of IP configurations for Address Resolution Protocol (ARP) settings.",
-    )
-    vrrp: Optional[List[Vrrp]] = Field(
-        default=None,
-        json_schema_extra={"vmanage_key": "vrrp"},
-        description="A list of Virtual Router Redundancy Protocol (VRRP) configurations for IPv4.",
-    )
-    ipv6_vrrp: Optional[List[Ipv6Vrrp]] = Field(
-        default=None,
-        json_schema_extra={"vmanage_key": "ipv6-vrrp"},
-        description="A list of Virtual Router Redundancy Protocol (VRRP) configurations for IPv6.",
+        default=None, json_schema_extra={"data_path": ["ipv6"], "vmanage_key": "access-list"}
     )
+    ip: Optional[List[Ip]] = Field(default=None, json_schema_extra={"data_path": ["arp"]})
+    vrrp: Optional[List[Vrrp]] = Field(default=None, json_schema_extra={"vmanage_key": "vrrp"})
+    ipv6_vrrp: Optional[List[Ipv6Vrrp]] = Field(default=None, json_schema_extra={"vmanage_key": "ipv6-vrrp"})
     enable_sgt_propagation: Optional[BoolStr] = Field(
-        default=None,
-        json_schema_extra={"data_path": ["trustsec", "propagate"], "vmanage_key": "sgt"},
-        description="Enables or disables Security Group Tag (SGT) propagation.",
+        default=None, json_schema_extra={"data_path": ["trustsec", "propagate"], "vmanage_key": "sgt"}
     )
     security_group_tag: Optional[int] = Field(
-        default=None,
-        json_schema_extra={"data_path": ["trustsec", "static"], "vmanage_key": "sgt"},
-        description="Specifies a static Security Group Tag (SGT) for the interface.",
-    )
-    trusted: Optional[BoolStr] = Field(
-        default=None,
-        json_schema_extra={"data_path": ["trustsec", "static"]},
-        description="Marks the interface as trusted or untrusted for TrustSec.",
+        default=None, json_schema_extra={"data_path": ["trustsec", "static"], "vmanage_key": "sgt"}
     )
+    trusted: Optional[BoolStr] = Field(default=None, json_schema_extra={"data_path": ["trustsec", "static"]})
     enable_sgt_authorization_and_forwarding: Optional[BoolStr] = Field(
-        default=None,
-        json_schema_extra={"data_path": ["trustsec"], "vmanage_key": "enable"},
-        description="Enables or disables Security Group Tag (SGT) authorization and forwarding.",
+        default=None, json_schema_extra={"data_path": ["trustsec"], "vmanage_key": "enable"}
     )
     enable_sgt_enforcement: Optional[BoolStr] = Field(
-        default=None,
-        json_schema_extra={"data_path": ["trustsec", "enforcement"], "vmanage_key": "enable"},
-        description="Activates or deactivates Security Group Tag (SGT) enforcement.",
+        default=None, json_schema_extra={"data_path": ["trustsec", "enforcement"], "vmanage_key": "enable"}
     )
     enforcement_sgt: Optional[int] = Field(
-        default=None,
-        json_schema_extra={"data_path": ["trustsec", "enforcement"], "vmanage_key": "sgt"},
-        description="Specifies the Security Group Tag (SGT) to be enforced on the interface.",
+        default=None, json_schema_extra={"data_path": ["trustsec", "enforcement"], "vmanage_key": "sgt"}
     )
 
     payload_path: ClassVar[Path] = Path(__file__).parent / "DEPRECATED"