Merge pull request #46 from Telecominfraproject/ols-821-mclag-schema-correction

ols-821-mclag-schema-correcttion-draft Changes

capabilities/connect.capabilities.yml

@@ -15,18 +15,36 @@ properties:
   version:
     type: object
     description:
-      The ols schema version to be used with this Switch
+      Switch version info, OLS release and schema.
     properties:
-      major:
-        type: integer
-      minor:
-        type: integer
-      patch:
-        type: integer
-    examples:
-      - 'major': 3
-        'minor': 2
-        'patch': 0
+      switch:
+        type: object
+        description: the ols client version for this Switch
+        properties:
+          major:
+            type: integer
+          minor:
+            type: integer
+          patch:
+            type: integer
+        examples:
+        - 'major': 3
+          'minor': 2
+          'patch': 0
+      schema:
+        type: object
+        description: the ols schema version used with the ols client.
+        properties:
+          major:
+            type: integer
+          minor:
+            type: integer
+          patch:
+            type: integer
+        examples:
+        - 'major': 3
+          'minor': 2
+          'patch': 0
   platform:
     type: string
     enum:
@@ -225,6 +243,7 @@ properties:
       - Spanning-Tree-Per-VLAN
       - Spanning-Tree-Per-VLAN-Rapid
       - Spanning-Tree-MSTP
+      - BPDU-Guard
       # L3
       - SVI-StaticIPv4
       - SVI-StaticIPv6
@@ -262,6 +281,7 @@ properties:
       - MAC-ACL
       - IP-ACL
       - Guest-VLAN
+      - Storm-Control
       # Services
       - Service-SSH
       - Service-RSSH
@@ -282,6 +302,7 @@ properties:
       - Service-Online-Check
       - Service-CaptivePortal
       - Service-PublicIpCheck
+      - Service-Global-DNS
       # Tunneling
       - Tunneling-VxLAN
       - Tunneling-GRE

schema.json

@@ -0,0 +1,5 @@
+{
+	"major": 4,
+	"minor": 1,
+	"patch": 0 
+}

schema/ethernet.yml

@@ -367,4 +367,173 @@ properties:
       lldp-notification:
         type: boolean
         description: Enables the transmission of SNMP trap notifications about LLDP changes.
-        default: false
+        default: false
+  ip-arp-inspect-port:
+    type: object
+    description: Configuration for ARP Inspection on specific interfaces or ports in the switch.
+    properties:
+      rate-limit-pps:
+        type: integer
+        description: Sets a rate limit (packets per second) for the ARP packets received on a port. Ensures that the port does not process ARP packets beyond the configured limit.
+        minimum: 0
+        maximum: 65535
+      trusted:
+        type: boolean
+        description: Configures the port as trusted, exempting it from ARP Inspection. Trusted ports bypass ARP validation checks.
+  rate-limit-port:
+    type: object
+    description: Configuration for ingress and egress rate limiting on a specific port (in kbps)
+    properties:
+      ingress-kbps:
+        type: integer
+        description: Sets the maximum allowed ingress (input) traffic rate for the port, in kilobits per second (kbps).
+        minimum: 64
+        maximum: 1000000000
+      egress-kbps:
+        type: integer
+        description: Sets the maximum allowed egress (output) traffic rate for the port, in kilobits per second (kbps).
+        minimum: 64
+        maximum: 1000000000
+  ip-source-guard-port:
+    type: object
+    description: Configuration of IP Source Guard (IPSG) on a physical interface in a Layer 2 switch.
+    properties:
+      rule:
+        type: string
+        description: Configures the switch to filter inbound traffic based on source IP address only, 
+          or source IP address and corresponding MAC address combined.
+        enum:
+          - sip
+          - sip-mac
+      mode:
+        type: string
+        description: Specifies the learning mode to use for validation, either MAC address table or ACL table. 
+          The system searches for source addresses in the specified table.
+        enum:
+          - mac
+          - acl
+      max-binding:
+        type: integer
+        description: Sets the maximum number of address entries that can be mapped to an interface 
+          in the binding table. Includes both static entries and dynamically learned entries 
+          via DHCP Snooping.
+        minimum: 1
+        maximum: 65535
+  acl:
+    description: A collection of access control entries that define the rules for filtering traffic through a network port.
+    type: array
+    items:
+      type: object
+      properties:
+        acl-inf-policy-preference:
+          description: Determines the priority of multiple ACL policies when more than one is applied to an interface, if any.
+          type: integer
+          minimum: 1
+          maximum: 64
+          default: 1
+        acl-inf-policy-ingress:
+          description: Specifies the ACL policy that is applied to incoming traffic on an interface.
+          type: string
+          maxLength: 32
+          minLength: 1
+          examples:
+            - blacklisted-macs
+        acl-inf-counters-ingress:
+          description: Tracks the number and type of packets that match the ingress ACL rules on an interface.
+          type: boolean
+          default: false
+        acl-inf-policy-egress:
+          description: Specifies the ACL policy that is applied to outgoing traffic from an interface.
+          type: string
+          maxLength: 32
+          minLength: 1
+          examples:
+            - blacklisted-macs
+        acl-inf-counters-egress:
+          description: Tracks the number and type of packets that match the egress ACL rules on an interface.
+          type: boolean
+          default: false
+  voice-vlan-intf-config:
+    description: Configure the Voice VLAN feature at the interface level, allowing for VoIP traffic to be prioritized on this specific port.
+    type: object
+    properties:
+      voice-vlan-intf-mode:
+        description: Specify the mode of placing this port on the voice VLAN.
+        type: string
+        default: "auto"
+        enum:
+          - none
+          - manual
+          - auto
+      voice-vlan-intf-priority:
+        description: Define the Class of Service (CoS) priority for VoIP traffic passing through this port, ensuring higher priority over other traffic types.
+        type: integer
+        default: 6
+        minimum: 0
+        maximum: 6
+      voice-vlan-intf-detect-voice:
+        description: Select the detection method for identifying VoIP traffic on this port, such as OUI-based detection or traffic pattern recognition.
+        type: string
+        default: "oui"
+        enum:
+          - oui
+          - lldp
+      voice-vlan-intf-security:
+        description: Enable or configure security filtering for VoIP traffic on the interface to protect against unauthorized devices.
+        type: boolean
+        default: false
+  dhcp-snoop-port:
+    description: Configuration for DHCP Snooping on a port level on a switch
+    type: object
+    properties:
+      dhcp-snoop-port-trust:
+        description: This parameter designates a switch port as ‘trusted’ for DHCP messages, meaning it can forward DHCP offers and acknowledgments, which is essential for connecting to legitimate DHCP servers
+        type: boolean
+        default: false
+      dhcp-snoop-port-client-limit:
+        description: It sets a limit on the number of DHCP clients that can be associated with a single port, helping to prevent a single port from exhausting the network’s IP address pool
+        type: integer
+        minimum: 1
+      dhcp-snoop-port-circuit-id:
+        description: Specifies DHCP Option 82 circuit ID suboption information. Often including information like the interface number and VLAN ID, this can be useful for network management and troubleshooting
+        type: string
+        minLength: 1
+        maxLength: 32
+  bpdu-guard:
+    description: BPDU Guard configuration block. Enables protection against unexpected BPDUs 
+      on edge ports to prevent loops and rogue switch connections.
+    type: object
+    properties:
+      enabled:
+        description: When true, the port will be placed into an error-disabled state if any BPDU is received.
+        type: boolean
+      auto-recovery-secs:
+        description: Time in 'seconds' after which a port that was err-disabled due to BPDU Guard
+          violation will be automatically re-enabled. 
+        type: integer
+        default: 300
+  edge-port:
+    description: When true, the port behaves as an STP Edge Port. When false, the port
+      participates fully in STP and is treated as a normal switch port.
+    type: boolean
+    default: false
+  storm-control:
+    description: Storm Control configuration per storm type. Allows enabling or disabling traffic storm control for broadcast, multicast, and unknown unicast packets,
+      with independent packet-per-second (pps) thresholds. A limit-pps value of 0 implies the control is disabled for that traffic type.
+    type: object
+    properties:
+      broadcast-pps:
+        type: integer
+        minimum: 0
+        default: 0
+        description: Maximum allowed broadcast packets per second. 0 disables broadcast storm control.
+      multicast-pps:
+        type: integer
+        minimum: 0
+        default: 0
+        description: Maximum allowed multicast packets per second. 0 disables multicast storm control.
+      unknown-unicast-pps:
+        type: integer
+        minimum: 0
+        default: 0
+        description:  Maximum allowed unknown unicast packets per second. 0 disables unknown unicast storm control.

schema/interface.acl.yml

@@ -1,33 +0,0 @@
-description: A collection of access control entries that define the rules for filtering traffic through a network interface.
-type: array
-items:
-  type: object
-  properties:
-    acl-inf-policy-preference:
-      description: Determines the priority of multiple ACL policies when more than one is applied to an interface, if any.
-      type: integer
-      minimum: 1
-      maximum: 64
-      default: 1
-    acl-inf-policy-ingress:
-      description: Specifies the ACL policy that is applied to incoming traffic on an interface.
-      type: string
-      maxLength: 32
-      minLength: 1
-      examples:
-        - blacklisted-macs
-    acl-inf-counters-ingress:
-      description: Tracks the number and type of packets that match the ingress ACL rules on an interface.
-      type: boolean
-      default: false
-    acl-inf-policy-egress:
-      description: Specifies the ACL policy that is applied to outgoing traffic from an interface.
-      type: string
-      maxLength: 32
-      minLength: 1
-      examples:
-        - blacklisted-macs
-    acl-inf-counters-egress:
-      description: Tracks the number and type of packets that match the egress ACL rules on an interface.
-      type: boolean
-      default: false

schema/interface.dhcp-snoop-port.yml

@@ -1,16 +0,0 @@
-description: "Configuration for DHCP Snooping on a port level on a switch"
-type: object
-properties:
-  dhcp-snoop-port-trust:
-    description: "This parameter designates a switch port as ‘trusted’ for DHCP messages, meaning it can forward DHCP offers and acknowledgments, which is essential for connecting to legitimate DHCP servers"
-    type: boolean
-    default: false
-  dhcp-snoop-port-client-limit:
-    description: "It sets a limit on the number of DHCP clients that can be associated with a single port, helping to prevent a single port from exhausting the network’s IP address pool"
-    type: integer
-    minimum: 1
-  dhcp-snoop-port-circuit-id:
-    description: "Specifies DHCP Option 82 circuit ID suboption information. Often including information like the interface number and VLAN ID, this can be useful for network management and troubleshooting"
-    type: string
-    minLength: 1
-    maxLength: 32

schema/interface.ipv4.arp-inspect.yml

@@ -0,0 +1,14 @@
+type: object
+description: Configuration for ARP Inspection on specific VLANs in the switch.
+properties:
+  vlan-enable:
+    type: boolean
+    description: Enable or disable ARP Inspection for a specified VLAN.
+  vlan-acl-rule:
+    type: string
+    description: Specifies an ARP ACL to apply to one or more VLANs.
+    maxLength: 32
+    minLength: 1
+  vlan-acl-nodhcp-bindings:
+    type: boolean
+    description: Validate ARP packets against only the specified ACL without checking address bindings in the DHCP snooping database.

schema/interface.ipv4.yml

@@ -200,35 +200,8 @@ properties:
     description: "Enables DHCP Snooping on a VLAN"
     type: boolean
     default: false
-  voice-vlan-intf-config:
-    description: "Configure the Voice VLAN feature at the interface level, allowing for VoIP traffic to be prioritized on this specific port."
-    type: object
-    properties:
-      voice-vlan-intf-mode:
-        description: "Specify the mode of placing this port on the voice VLAN."
-        type: string
-        default: "auto"
-        enum:
-          - none
-          - manual
-          - auto
-      voice-vlan-intf-priority:
-        description: "Define the Class of Service (CoS) priority for VoIP traffic passing through this port, ensuring higher priority over other traffic types."
-        type: integer
-        default: 6
-        minimum: 0
-        maximum: 6
-      voice-vlan-intf-detect-voice:
-        description: "Select the detection method for identifying VoIP traffic on this port, such as OUI-based detection or traffic pattern recognition."
-        type: string
-        default: "oui"
-        enum:
-          - oui
-          - lldp
-      voice-vlan-intf-security:
-        description: "Enable or configure security filtering for VoIP traffic on the interface to protect against unauthorized devices."
-        type: boolean
-        default: false
+  ip-arp-inspect-vlan:
+      $ref: "https://ucentral.io/schema/v1/interface/ipv4/arp-inspect/"
   dhcp:
     $ref: "https://ucentral.io/schema/v1/interface/ipv4/dhcp/"
   dhcp-leases:

schema/interface.vlan.yml

@@ -8,7 +8,15 @@ properties:
       The individual physical network devices contained within the interface
       need to be told explicitly if egress traffic shall be tagged.
     type: integer
-    maximum: 4050
+    maximum: 4094
+  range-start:
+    decription: Start vlan-id of the specified range
+    type: integer
+    maximum: 4094
+  range-end:
+    decription: End vlan-id of the specified range
+    type: integer
+    maximum: 4094
   proto:
     decription:
       The L2 vlan tag that shall be added (1q,1ad)

schema/interface.yml

@@ -68,11 +68,7 @@ properties:
     $ref: "https://ucentral.io/schema/v1/interface/ipv4/"
   ipv6:
     $ref: "https://ucentral.io/schema/v1/interface/ipv6/"
-  acl:
-    $ref: "https://ucentral.io/schema/v1/interface/acl/"
-  dhcp-snoop-port:
-    $ref: "https://ucentral.io/schema/v1/interface/dhcp-snoop-port/"
   broad-band:
     $ref: "https://ucentral.io/schema/v1/interface/broad-band/"
   tunnel:
-    $ref: "https://ucentral.io/schema/v1/interface/tunnel/"
+    $ref: "https://ucentral.io/schema/v1/interface/tunnel/"

schema/switch.acl.yml

@@ -0,0 +1,110 @@
+description: Contains all the access control rule definitions
+type: array
+uniqueItems: true
+items:
+  type: object
+  properties:
+    acl-name:
+      description: The identifier or name for the Access Control List
+      type: string
+      maxLength: 32
+      minLength: 1
+    acl-type:
+      description: Type of the access control list
+      type: string
+      enum:
+        - ipv4
+        - ipv6
+        - ipv4Ext
+        - ipv6Ext
+        - mac
+        - arp
+    acl-rules:
+      description: access control rules under this ACL
+      type: object
+      additionalProperties:
+        type: array
+        uniqueItems: true
+        items:
+          type: object
+          properties:
+            acl-rule-action:
+              description: Defines whether to permit or deny traffic matching the rule
+              type: string
+              enum:
+                - permit
+                - deny
+            acl-source-macaddress:
+              description: Specifies the source MAC address to filter on
+              type: string
+              format: uc-mac
+            acl-source-macbitmask:
+              description: The mask applied to the source MAC address
+              type: string
+              format: uc-mac
+            acl-dest-macaddress:
+              description: Specifies the destination MAC address for the filter
+              type: string
+              format: uc-mac
+            acl-dest-macbitmask:
+              description: The mask applied to the destination MAC address
+              type: string
+              format: uc-mac
+            acl-packet-format:
+              description: Identifies the protocol encapsulated in the Ethernet frame by its EtherType
+              type: string
+              enum:
+                - any
+                - untagged-eth2
+                - untagged-802.3
+                - tagged-eth2
+                - tagged-802.3
+            acl-vlanid:
+              description: Specifies a VLAN ID to filter traffic from a specific VLAN
+              type: integer
+              minimum: 1
+              maximum: 4094
+            acl-vid-bitmask:
+              description: The mask applied to the VLAN ID
+              type: integer
+              minimum: 1
+              maximum: 4095
+            acl-ethertype:
+              description: Filters packets based on the custom EtherType field (HEX) in the Ethernet frame
+              type: string
+              default: "800"
+            acl-ethertype-bitmask:
+              description: The mask applied to the EtherType field
+              type: string
+              default: "FFFF"
+            acl-cos:
+              description: Filters based on the Class of Service (CoS) field in the frame
+              type: integer
+              minimum: 0
+              maximum: 7
+            acl-cos-bitmask:
+              description: The mask applied to the CoS field
+              type: integer
+              minimum: 0
+              maximum: 7
+            acl-ipv4-source-address:
+              description: The IPv4 address of the source to filter on
+              type: string
+              format: ipv4
+            acl-ipv4-source-subnetmask:
+              description: The subnet mask applied to the source IPv4 address
+              type: string
+              format: ipv4
+            acl-ipv4-dest-address:
+              description: The IPv4 address of the destination to filter on
+              type: string
+              format: ipv4
+            acl-ipv4-dest-subnetmask:
+              description: The subnet mask applied to the destination IPv4 address
+              type: string
+              format: ipv4
+            acl-ip-proto:
+              description: Filters based on the IP protocol number
+              type: integer
+              minimum: 0
+              maximum: 255

schema/switch.arp-inspect.yml

@@ -0,0 +1,19 @@
+type: object
+description: Global configuration for ARP Inspection on the switch.
+properties:
+  ip-arp-inspect:
+    type: boolean
+    description: Enable or disable ARP Inspection globally.
+    default: false
+  validate-dst-mac:
+    type: boolean
+    description: Validate that the destination MAC address in the Ethernet header matches the target MAC address in the ARP body for ARP responses.
+  validate-ip:
+    type: boolean
+    description: Validate ARP packets for unexpected or invalid IP addresses, such as 0.0.0.0, 255.255.255.255, and IP multicast addresses.
+  validate-allow-zeros:
+    type: boolean
+    description: Allow ARP packets where the sender IP address is 0.0.0.0.
+  validate-src-mac:
+    type: boolean
+    description: Validate that the source MAC address in the Ethernet header matches the sender MAC address in the ARP body for both ARP requests and responses.

schema/switch.ip-source-guard.yml

@@ -0,0 +1,29 @@
+type: object
+description: Configuration for IP Source Guard global static bindings in a Layer 2 switch.
+properties:
+  bindings:
+    type: array
+    description: List of static bindings for IP Source Guard.
+    items:
+      type: object
+      properties:
+        binding-mode:
+          type: string
+          description: Specifies the mode for adding a static address to the Source Guard ACL or MAC address binding table. It determines whether the binding is based on MAC addresses or ACLs.
+          enum:
+            - mac
+            - acl
+        binding-mac:
+          type: string
+          format: uc-mac
+          description: A valid unicast MAC address for binding to the Source Guard filtering table.
+        binding-vlans:
+          type: integer
+          description: The VLAN ID associated with the static binding for Source Guard filtering. Must be a valid, configured VLAN on the switch.
+        binding-ip:
+          type: string
+          format: ipv4
+          description: A valid unicast IPv4 address to associate with the Source Guard filtering table.
+        binding-port:
+          type: string
+          description: The physical interface (e.g., ethernet0, ethernet1) where the Source Guard binding applies.

schema/switch.rtevent.yml

@@ -0,0 +1,162 @@
+description: Configuration for enabling or disabling specific event categories and their sub-events.
+type: object
+properties:
+  port-status:
+    description: Enable/Disable Port Status events.
+    type: object
+    properties:
+      enabled:
+        description: Enable/Disable Port Status category.
+        type: boolean
+        default: false
+      sub-events:
+        type: object
+        properties:
+          wired.carrier-down:
+            type: boolean
+            description: Enable/Disable carrier down event.
+            default: false
+          wired.carrier-up:
+            type: boolean
+            description: Enable/Disable carrier up event.
+            default: false
+  module:
+    description: Enable/Disable Module events.
+    type: object
+    properties:
+      enabled:
+        type: boolean
+        description: Enable/Disable Module category.
+        default: false
+      sub-events:
+        type: object
+        properties:
+          module.plugout:
+            type: boolean
+            description: Enable/Disable module plugout event.
+            default: false
+          module.plugin:
+            type: boolean
+            description: Enable/Disable module plugin event.
+            default: false
+  stp:
+    description: Enable/Disable STP events.
+    type: object
+    properties:
+      enabled:
+        type: boolean
+        description: Enable/Disable STP category.
+        default: false
+      sub-events:
+        type: object
+        properties:
+          stp.loop-detected:
+            type: boolean
+            description: Enable/Disable loop detected event.
+            default: false
+          stp.loop-cleared:
+            type: boolean
+            description: Enable/Disable loop cleared event.
+            default: false
+          stp.state-change:
+            type: boolean
+            description: Enable/Disable state change event.
+            default: false
+  rstp:
+    description: Enable/Disable RSTP events.
+    type: object
+    properties:
+      enabled:
+        type: boolean
+        description: Enable/Disable RSTP category.
+        default: false
+      sub-events:
+        type: object
+        properties:
+          rstp.loop-detected:
+            type: boolean
+            description: Enable/Disable loop detected event.
+            default: false
+          rstp.loop-cleared:
+            type: boolean
+            description: Enable/Disable loop cleared event.
+            default: false
+          rstp.state-change:
+            type: boolean
+            description: Enable/Disable state change event.
+            default: false
+  fw-upgrade:
+    description: Enable/Disable Firmware Upgrade events.
+    type: object
+    properties:
+      enabled:
+        type: boolean
+        description: Enable/Disable Firmware Upgrade category.
+        default: false
+      sub-events:
+        type: object
+        properties:
+          upg.download-start:
+            type: boolean
+            description: Enable/Disable download start event.
+            default: false
+          upg.download-in-progress:
+            type: boolean
+            description: Enable/Disable download in progress event.
+            default: false
+          upg.download-failed:
+            type: boolean
+            description: Enable/Disable download failed event.
+            default: false
+          upg.validation-start:
+            type: boolean
+            description: Enable/Disable validation start event.
+            default: false
+          upg.validation-success:
+            type: boolean
+            description: Enable/Disable validation success event.
+            default: false
+          upg.validation-failed:
+            type: boolean
+            description: Enable/Disable validation failed event.
+            default: false
+          upg.backup-current-firmware:
+            type: boolean
+            description: Enable/Disable firmware backup event.
+            default: false
+          upg.install-start:
+            type: boolean
+            description: Enable/Disable install start event.
+            default: false
+          upg.install-failed:
+            type: boolean
+            description: Enable/Disable install failed event.
+            default: false
+          upg.reboot-start:
+            type: boolean
+            description: Enable/Disable reboot start event.
+            default: false
+          upg.success:
+            type: boolean
+            description: Enable/Disable upgrade success event.
+            default: false
+  dhcp-snooping:
+    description: Enable/Disable DHCP Snooping events.
+    type: object
+    properties:
+      enabled:
+        type: boolean
+        description: Enable/Disable DHCP Snooping category.
+        default: false
+      sub-events:
+        type: object
+        properties:
+          dhcp-snooping.violation-detected:
+            type: boolean
+            description: Enable/Disable DHCP Snooping violation detected event.
+            default: false
+          dhcp-snooping.violation-cleared:
+            type: boolean
+            description: Enable/Disable DHCP Snooping violation cleared event.
+            default: false
+  # Continue similarly for ARP Inspection, IPSG, PoE Status, PoE Fault, and Device Events.

schema/switch.yml

@@ -1,4 +1,4 @@
-description:
+description: 
   This section defines the switch fabric specific features of a physical switch.
 type: object
 properties:
@@ -279,176 +279,6 @@ properties:
             - drop
             - keep
             - replace
-  acl:
-    description: Contains all the access control rule definitions
-    type: array
-    items:
-      type: object
-      properties:
-        acl-type:
-          description: Type of the access control list
-          type: string
-          enum:
-            - ipv4
-            - ipv6
-            - ipv4Ext
-            - ipv6Ext
-            - mac
-            - arp
-        acl-name:
-          description: The identifier or name for the Access Control List
-          type: string
-          maxLength: 32
-          minLength: 1
-        acl-rule-action:
-          description: Defines whether to permit or deny traffic matching the rule
-          type: string
-          enum:
-            - permit
-            - deny
-        acl-source-macaddress:
-          description: Specifies the source MAC address to filter on
-          type: string
-          format: uc-mac
-        acl-source-macbitmask:
-          description: The mask applied to the source MAC address
-          type: string
-          format: uc-mac
-        acl-dest-macaddress:
-          description: Specifies the destination MAC address for the filter
-          type: string
-          format: uc-mac
-        acl-dest-macbitmask:
-          description: The mask applied to the destination MAC address
-          type: string
-          format: uc-mac
-        acl-packet-format:
-          description: Identifies the protocol encapsulated in the Ethernet frame by its EtherType
-          type: string
-          enum:
-            - any
-            - untagged-eth2
-            - untagged-802.3
-            - tagged-eth2
-            - tagged-802.3
-        acl-vlanid:
-          description: Specifies a VLAN ID to filter traffic from a specific VLAN
-          type: integer
-          minimum: 1
-          maximum: 4094
-        acl-vid-bitmask:
-          description: The mask applied to the VLAN ID
-          type: integer
-          minimum: 1
-          maximum: 4095
-        acl-ethertype:
-          description: Filters packets based on the custom EtherType field (HEX) in the Ethernet frame
-          type: string
-          default: "800"
-        acl-ethertype-bitmask:
-          description: The mask applied to the EtherType field
-          type: string
-          default: "FFFF"
-        acl-cos:
-          description: Filters based on the Class of Service (CoS) field in the frame
-          type: integer
-          minimum: 0
-          maximum: 7
-        acl-cos-bitmask:
-          description: The mask applied to the CoS field
-          type: integer
-          minimum: 0
-          maximum: 7
-        # IP-ACL (IPv4/IPv6) Parameters
-        acl-ipv4-source-address:
-          description: The IPv4 address of the source to filter on
-          type: string
-          format: ipv4
-        acl-ipv4-source-subnetmask:
-          description: The subnet mask applied to the source IPv4 address
-          type: string
-          format: ipv4
-        acl-ipv4-dest-address:
-          description: The IPv4 address of the destination to filter on
-          type: string
-          format: ipv4
-        acl-ipv4-dest-subnetmask:
-          description: The subnet mask applied to the destination IPv4 address
-          type: string
-          format: ipv4
-        acl-ipv6-source-address:
-          description: The IPv6 address of the source to filter on
-          type: string
-          format: ipv6
-        acl-ipv6-source-prefix-length:
-          description: Defines the length of the prefix used in filtering IPv6 source addresses
-          type: integer
-          minimum: 0
-          maximum: 128
-        acl-ipv6-dest-address:
-          description: The IPv6 address of the destination to filter on
-          type: string
-          format: ipv6
-        acl-ipv6-dest-prefix-length:
-          description: Defines the length of the prefix used in filtering IPv6 destination addresses
-          type: integer
-          minimum: 0
-          maximum: 128
-        acl-ip-proto:
-          description: Filters based on the IP protocol number
-          type: integer
-          minimum: 0
-          maximum: 255
-        acl-ipv6-next-header:
-          description: Specifies the next header type in IPv6 traffic, such as TCP, UDP, or ICMPv6
-          type: integer
-          minimum: 0
-          maximum: 255
-        acl-ipv6-flow-label:
-          description: Filters packets based on the IPv6 Flow Label field
-          type: integer
-          minimum: 0
-          maximum: 1048575
-        acl-ip-source-port:
-          description: Specifies the source port number for filtering
-          type: integer
-          minimum: 0
-          maximum: 65535
-        acl-ip-source-port-bitmask:
-          description: The mask applied to the source port number
-          type: integer
-          minimum: 0
-          maximum: 65535
-        acl-ip-dest-port:
-          description: Specifies the destination port number for filtering
-          type: integer
-          minimum: 0
-          maximum: 65535
-        acl-ip-dest-port-bitmask:
-          description: The mask applied to the destination port number
-          type: integer
-          minimum: 0
-          maximum: 65535
-        acl-ipv4-fragment-offset:
-          description: Filters based on IPv4 fragment offset for fragmented packets
-          type: integer
-          minimum: 0
-          maximum: 8191
-        acl-ipv6-fragment-offset:
-          description: Filters based on IPv6 fragment offset for fragmented packets
-          type: integer
-          minimum: 0
-          maximum: 8191
-        acl-ip-ttl:
-          description: Filters IPv4 traffic based on the TTL (Time to Live) value
-          type: integer
-          minimum: 0
-          maximum: 255
-        acl-ipv6-hop-limit:
-          description: Filters IPv6 traffic based on the hop limit value, equivalent to IPv4 TTL
-          type: integer
-          minimum: 0
-          maximum: 255
   mvr-config:
     description: This section defines the Multicast VLAN Registration (MVR) general configuration.
     type: object
@@ -609,58 +439,66 @@ properties:
               description: Configures the peer-link, which could be a physical port or a trunk group that connects the two MC-LAG peer switches.
               type: object
               properties:
-                type:
+                link-type:
                   description: Defines the type of peer-link, either 'port' or 'trunk-group'
                   type: string
                   enum:
                     - port
                     - trunk-group
                   default: trunk-group
-                value:
-                  description: Specifies the port or trunk-group ID for the peer-link.
+                port-id:
+                  description: Specifies the physical port name used as peer-link (only valid if type = port).
+                  type: string
+                  examples:
+                    - "Ethernet1"
+                    - "Ethernet2"
+                trunk-id:
+                  description: Specifies the trunk group ID used as peer-link (only valid if type = trunk-group).
                   type: integer
                   minimum: 1
                   maximum: 64
             mclag-group:
-              description: Configures the MC-LAG group, which binds the interfaces into a multi-chassis LAG.
-              type: object
-              properties:
-                group-id:
-                  description: Defines the unique MC-LAG group identifier.
-                  type: integer
-                  minimum: 1
-                  maximum: 128
-                members:
-                  description: List of interfaces that participate in the MC-LAG group.
-                  type: array
-                  items:
-                    type: string
-                    description: Interface names that are part of the MC-LAG group.
-                    examples:
-                      - eth0
-                      - eth1
-                lacp-config:
-                  description: LACP configuration settings for the MC-LAG group.
-                  type: object
-                  properties:
-                    lacp-enable:
-                      description: Enables or disables LACP for the MC-LAG group.
-                      type: boolean
-                      default: true
-                    lacp-role:
-                      description: Configures the LACP role as 'actor' or 'partner'
+              description: Configures the MC-LAG group(s), which binds the interfaces into a multi-chassis LAG.
+              type: array
+              items:
+                type: object
+                properties:
+                  group-id:
+                    description: Defines the unique MC-LAG group identifier.
+                    type: integer
+                    minimum: 1
+                    maximum: 128
+                  members:
+                    description: List of interfaces that participate in the MC-LAG group.
+                    type: array
+                    items:
                       type: string
-                      enum:
-                        - actor
-                        - partner
-                      default: actor
-                    lacp-timeout:
-                      description: Sets the LACP timeout as either 'short' or 'long'.
-                      type: string
-                      enum:
-                        - short
-                        - long
-                      default: long
+                      description: Interface names that are part of the MC-LAG group.
+                      examples:
+                        - Ethernet0
+                        - Ethernet1
+                  lacp-config:
+                    description: LACP configuration settings for the MC-LAG group.
+                    type: object
+                    properties:
+                      lacp-enable:
+                        description: Enables or disables LACP for the MC-LAG group.
+                        type: boolean
+                        default: true
+                      lacp-role:
+                        description: Configures the LACP role as 'actor' or 'partner'
+                        type: string
+                        enum:
+                          - actor
+                          - partner
+                        default: actor
+                      lacp-timeout:
+                        description: Sets the LACP timeout as either 'short' or 'long'.
+                        type: string
+                        enum:
+                          - short
+                          - long
+                        default: long
             system-priority:
               description: Specifies the system priority used by the switch for LACP negotiations.
               type: integer
@@ -672,38 +510,51 @@ properties:
               type: boolean
               default: true
   voice-vlan-config:
-    description: "This parameter enables or disables the overall configuration of the Voice VLAN feature on the switch. When enabled, it allows the system to classify and prioritize voice traffic."
+    description: This parameter enables or disables the overall configuration of the Voice VLAN feature on the switch. When enabled, it allows the system to classify and prioritize voice traffic.
     type: object
     properties:
       voice-vlan-id:
-        description: "Specifies the VLAN ID assigned to the Voice VLAN. This is the unique identifier for the VLAN that will be used for prioritizing voice traffic."
+        description: Specifies the VLAN ID assigned to the Voice VLAN. This is the unique identifier for the VLAN that will be used for prioritizing voice traffic.
         type: integer
         minimum: 1
         maximum: 4094
       voice-vlan-ageing-time:
-        description: "Defines the time, in minutes, that a dynamic Voice VLAN entry remains in the VLAN after voice traffic is no longer detected. It helps manage resources by removing inactive voice devices from the VLAN after this time elapses."
+        description: Defines the time, in minutes, that a dynamic Voice VLAN entry remains in the VLAN after voice traffic is no longer detected. It helps manage resources by removing inactive voice devices from the VLAN after this time elapses.
         type: integer
         minimum: 5
         maximum: 43200
         default: 1440
       voice-vlan-oui-config:
-        description: "Configures the Organizationally Unique Identifier (OUI) for identifying the voice devices (like IP phones)."
+        description: Configures the Organizationally Unique Identifier (OUI) for identifying the voice devices (like IP phones).
         type: array
         items:
           type: object
           properties:
             voice-vlan-oui-mac:
-              description: "The specific MAC address pattern that corresponds to voice devices, as determined by the OUI. It is used for identifying and classifying voice traffic."
+              description: The specific MAC address pattern that corresponds to voice devices, as determined by the OUI. It is used for identifying and classifying voice traffic.
               type: string
               format: uc-mac
             voice-vlan-oui-mask:
-              description: "A mask applied to the MAC address to help match the OUI more precisely. It ensures that the correct portion of the MAC address is evaluated to identify a device as a voice device."
+              description: A mask applied to the MAC address to help match the OUI more precisely. It ensures that the correct portion of the MAC address is evaluated to identify a device as a voice device.
               type: string
               format: uc-mac
             voice-vlan-oui-description:
-              description: "A descriptive label or comment for the OUI configuration. This can help administrators keep track of which OUI belongs to which type of voice device or vendor."
+              description: A descriptive label or comment for the OUI configuration. This can help administrators keep track of which OUI belongs to which type of voice device or vendor.
               type: string
               maxLength: 32
               minLength: 1
               examples:
-                - "A VoIP Phone"
+                - "A VoIP Phone"
+  arp-inspect:
+    $ref: "https://ucentral.io/schema/v1/switch/arp-inspect/"
+  ip-source-guard:
+    $ref: "https://ucentral.io/schema/v1/switch/ip-source-guard/"
+  rt-events:
+    $ref: "https://ucentral.io/schema/v1/switch/rtevent/"
+  acl:
+    $ref: "https://ucentral.io/schema/v1/switch/acl/"
+  dns:
+    description: Define a global list of dns servers.
+    type: array
+    items:
+      type: string

state/interface.yml

@@ -15,8 +15,11 @@ items:
     name:
       type: string
       description:
-        The administrative name of this logical interface. This field is
-        freetext
+        The administrative name of this logical interface. This field is freetext
+    vlan_id:
+      description: VLAN-ID of the logical interface
+      type: integer
+      maximum: 4094
     ntp_server:
       type: string
       description:

state/link-state.yml

@@ -191,3 +191,96 @@ properties:
         description:
           Max power (in Watts) module can drain.
         type: number
+  loop-detect-protocol:
+    description: Status and protocol information for loop detection or prevention mechanisms 
+      active on this interface. Includes STP/xSTP/MSTP, Loopback Detection (LBD), etc.
+    type: object
+    properties:
+      stp:
+        description: Spanning Tree Protocol (IEEE 802.1D/RSTP/MSTP) state on the port.
+        type: object
+        properties:
+          protocol:
+            type: string
+            description: Variant of STP running (e.g., STP, RSTP, MSTP, RPVST+).
+            examples:
+              - RSTP
+              - MSTP
+          state:
+            type: string
+            description: STP state of the port.
+            enum:
+              - disabled
+              - blocking
+              - listening
+              - learning
+              - forwarding
+          role:
+            type: string
+            description: Role of the port in STP topology.
+            enum:
+              - root
+              - designated
+              - alternate
+              - backup
+              - disabled
+          bridge-id:
+            type: string
+            description: STP Bridge ID
+          root-bridge-id:
+            type: string
+            description: STP Root Bridge ID for the instance.
+          oper-edge-port:
+            type: boolean
+            description: Whether the port is operating as an edge port (no BPDU expected).
+          cost:
+            type: integer
+            description: Operational path cost of the port.
+          designated-cost:
+            type: integer
+            description: Cost advertised by the designated port.
+          transitions:
+            type: integer
+            description: Number of STP state transitions (forwarding/discarding) on this port.
+          bpdu-guard:
+            type: string
+            description: Runtime status of BPDU Guard on the port, when it detects any issue. 
+              - `errdisabled`- Port is shutdown due to BPDU violation.
+              - `recovering`- Temporarily disabled and in auto-recovery interval.
+            enum:
+              - errdisabled
+              - recovering
+      lbd:
+        description: Loopback Detection (LBD) status on this port.
+        type: object
+        properties:
+          enabled:
+            type: boolean
+            description: Whether LBD is enabled on this port.
+          state:
+            type: string
+            description: Current loop detection status.
+            enum:
+              - no_loop
+              - loop_detected
+              - disabled
+          action:
+            type: string
+            description: Action taken when loop is detected (e.g., block, shutdown).
+            enum:
+              - none
+              - block
+              - shutdown
+  storm-status:
+    description: Runtime status of Storm Control feature on the port for each storm type.
+    type: object
+    properties:
+      broadcast:
+        type: boolean
+        description: Runtime status of Broadcast Storm Control on the port. Return `true`if Storm condition is detected.
+      multicast:
+        type: boolean
+        description: Runtime status of Multicast Storm Control on the port. Return `true`if Storm condition is detected.
+      unknown-unicast:
+        type: boolean
+        description: Runtime status of Unknown Unicast Storm Control on the port. Return `true`if Storm condition is detected.

state/lldp-peers.yml

@@ -49,6 +49,10 @@ items:
           type: string
           description: Provides a textual description of the remote port, typically describing the interface or its purpose.
           example: "Ethernet Port on unit 1, port 2"
+        lldp-remote-sys-name:
+          type: string
+          description: Provides a textual description of the system name string (as defined by the sending device)
+          example: "Datacenter Switch-1"
         lldp-remote-port-max-mtu:
           type: string
           description: Displays the maximum transmission unit (MTU) size that the remote port supports, indicating the largest packet size the port can handle.
@@ -117,6 +121,19 @@ items:
               type: string
               description: Displays the PoE class of the remote device, indicating its power consumption classification.
               enum: ["Class-1", "Class-2", "Class-3", "Class-4","Class-5", "Class-6", "Class-7", "Class-8"]
+            lldp-remote-port-power-priority:
+              type: string
+              description: Indicates the power priority level assigned to the PD.
+              enum:
+                - low
+                - high
+                - critical
+            lldp-remote-port-pd-requested-power:
+              type: number
+              description: Power requested by the PD in watts (0.1W resolution possible). The values must be presented with real values like 25.5, 20.5 etc.
+            lldp-remote-port-pse-available-power:
+              type: number
+              description: Power that the PSE port is able to provide in watts (0.1W resolution).
         lldp-remote-port-lag-info:
           type: object
           description: Provides information about the remote port’s involvement in Link Aggregation Groups (LAG), if applicable.
@@ -129,4 +146,40 @@ items:
               description: Shows whether Link Aggregation is enabled on the remote port.
             lldp-remote-port-lag-port-id:
               type: integer
-              description: Displays the identifier of the Link Aggregation Group (LAG) that the remote port belongs to.
+              description: Displays the identifier of the Link Aggregation Group (LAG) that the remote port belongs to.
+        lldp-remote-port-location:
+          type: object
+          description: Location information provided by LLDP-MED.
+          properties:
+            location-subtype:
+              type: string
+              description: Indicates the type of location information being conveyed.
+              enum:
+                - coordinate
+                - civic-address
+                - elin
+            civic-addr:
+              type: array
+              description: Civic address information consisting of CA-Type and CA-Value pairs as per LLDP-MED.
+              items:
+                type: object
+                properties:
+                  ca-type:
+                    type: integer
+                    description: Civic Address Type identifier (e.g., 1 = Language, 3 = Country, 6 = A1 state/province, etc.)
+                  ca-value:
+                    type: string
+                    description: Civic Address Value corresponding to the type.
+            coordinates:
+              type: object
+              description: Location coordinates information.
+              properties:
+                latitude:
+                  type: string
+                  description: Latitude in decimal degrees (e.g., +37.7749).
+                longitude:
+                  type: string
+                  description: Longitude in decimal degrees (e.g., -122.4194).
+            elin:
+              type: string
+              description: Emergency Location Identification Number (ELIN) assigned to endpoint location

state/state.yml

@@ -60,3 +60,131 @@ properties:
     type: string
     description:
       Current interface that serves as the Uplink. Example Ethernet2.
+  arp-inspect-stats:
+    type: object
+    description: Statistics related to ARP Inspection activity in the switch.
+    properties:
+      arp-pkt-rcvd:
+        type: integer
+        description: Total number of ARP packets received.
+      arp-pkt-dropped-rate-limit:
+        type: integer
+        description: Number of ARP packets dropped due to rate limiting.
+      arp-pkt-processed:
+        type: integer
+        description: Total number of ARP packets processed by ARP Inspection.
+      arp-pkt-dropped-src-mac:
+        type: integer
+        description: Number of ARP packets dropped due to source MAC address validation failures.
+      arp-pkt-dropped-dst-mac:
+        type: integer
+        description: Number of ARP packets dropped due to destination MAC address validation failures.
+      arp-pkt-dropped-ip:
+        type: integer
+        description: Number of ARP packets dropped due to IP address validation failures."
+      arp-pkt-dropped-acl:
+        type: integer
+        description: Number of ARP packets dropped due to ARP ACL rules.
+      arp-pkt-dropped-dhcp:
+        type: integer
+        description: Number of ARP packets dropped due to DHCP snooping validation failures.
+  ip-source-guard:
+    type: object
+    description: Represents the configuration and state of IP Source Guard.
+    properties:
+      blocked-entries:
+        type: array
+        description: Displays a list of entries that are currently blocked by IP Source Guard (IPSG).
+        items:
+          type: object
+          properties:
+            blocked-mac:
+              type: string
+              description: The MAC address that has been blocked by IP Source Guard.
+              format: "mac-address"
+            blocked-ip:
+              type: string
+              description: The IP address that has been blocked by IP Source Guard.
+              format: "ipv4"
+            blocked-vlan:
+              type: integer
+              description: The VLAN ID associated with the blocked IP/MAC entry.
+              minimum: 1
+              maximum: 4095
+            blocked-interface:
+              type: string
+              description: The interface (e.g., port) where the blocked entry was detected.
+  stp:
+    description: Global status and configuration of the Spanning Tree Protocol (STP) across the switch.
+      Supports variants like STP, RSTP, MSTP. Includes bridge-wide parameters and protocol behavior.
+    type: object
+    properties:
+      enabled:
+        type: boolean
+        description: Whether STP is enabled globally on the switch.
+      mode:
+        type: string
+        description: Operational STP mode used across the switch.
+        enum:
+          - stp
+          - rstp
+          - mstp
+          - pvst
+          - rpvstp
+      transmission-limit:
+          type: integer
+          description: Maximum number of BPDUs that can be transmitted per hello time.
+      path-cost-method:
+          type: string
+          description: Indicates whether "Short" or "Long" path cost method is in use.
+          enum:
+            - short
+            - long
+      max-hops:
+          type: integer
+          description: Maximum hop count used in MSTP.
+      instances:
+        type: array
+        description: List of STP instances (e.g., MSTP instances).
+        items:
+          type: object
+          properties:
+            instance-id:
+              type: integer
+              description: Instance number (for MSTP or multiple-instance support).
+          vlans:
+            type: string
+            description: VLAN ranges associated with the STP instance.
+            example: "1-4094"
+          bridge-priority:
+            type: integer
+            description: Bridge priority value for STP election.
+          bridge-hello-time:
+            type: integer
+            description: Hello Time interval (in seconds) configured on the bridge.
+          bridge-max-age:
+            type: integer
+            description: Max Age value (in seconds) used for aging STP information.
+          bridge-forward-delay:
+            type: integer
+            description: Delay (in seconds) before transitioning port to forwarding state.
+          remaining-hops:
+            type: integer
+            description: Remaining hop count from the Root Bridge to this bridge.
+          root-bridge-id:
+            type: string
+            description: Bridge ID of the current Root Bridge.
+          root-port:
+            type: string
+            description: Local interface acting as Root Port.
+            example:
+              - Ëthernet1
+          root-cost:
+            type: integer
+            description: Cumulative cost to reach the Root Bridge.
+          topology-changes:
+            type: integer
+            description: Total number of topology changes detected.
+          last-topology-change-seconds:
+            type: integer
+            description: Time (in seconds) since the last topology change.

ucentral.capabilities.pretty.json

@@ -17,25 +17,53 @@
         },
         "version": {
             "type": "object",
-            "description": "The ols schema version to be used with this Switch",
+            "description": "Switch version info, OLS release and schema.",
             "properties": {
-                "major": {
-                    "type": "integer"
+                "switch": {
+                    "type": "object",
+                    "description": "the ols client version for this Switch",
+                    "properties": {
+                        "major": {
+                            "type": "integer"
+                        },
+                        "minor": {
+                            "type": "integer"
+                        },
+                        "patch": {
+                            "type": "integer"
+                        }
+                    },
+                    "examples": [
+                        {
+                            "major": 3,
+                            "minor": 2,
+                            "patch": 0
+                        }
+                    ]
                 },
-                "minor": {
-                    "type": "integer"
-                },
-                "patch": {
-                    "type": "integer"
+                "schema": {
+                    "type": "object",
+                    "description": "the ols schema version used with the ols client.",
+                    "properties": {
+                        "major": {
+                            "type": "integer"
+                        },
+                        "minor": {
+                            "type": "integer"
+                        },
+                        "patch": {
+                            "type": "integer"
+                        }
+                    },
+                    "examples": [
+                        {
+                            "major": 3,
+                            "minor": 2,
+                            "patch": 0
+                        }
+                    ]
                 }
-            },
-            "examples": [
-                {
-                    "major": 3,
-                    "minor": 2,
-                    "patch": 0
-                }
-            ]
+            }
         },
         "platform": {
             "type": "string",
@@ -282,6 +310,7 @@
                     "Spanning-Tree-Per-VLAN",
                     "Spanning-Tree-Per-VLAN-Rapid",
                     "Spanning-Tree-MSTP",
+                    "BPDU-Guard",
                     "SVI-StaticIPv4",
                     "SVI-StaticIPv6",
                     "Interface-StaticIPv4",
@@ -314,6 +343,7 @@
                     "MAC-ACL",
                     "IP-ACL",
                     "Guest-VLAN",
+                    "Storm-Control",
                     "Service-SSH",
                     "Service-RSSH",
                     "Service-Telnet",
@@ -333,6 +363,7 @@
                     "Service-Online-Check",
                     "Service-CaptivePortal",
                     "Service-PublicIpCheck",
+                    "Service-Global-DNS",
                     "Tunneling-VxLAN",
                     "Tunneling-GRE",
                     "Tunneling-GRE6",

ucentral.state.pretty.json

@@ -85,6 +85,177 @@
         "uplink_interface": {
             "type": "string",
             "description": "Current interface that serves as the Uplink. Example Ethernet2."
+        },
+        "arp-inspect-stats": {
+            "type": "object",
+            "description": "Statistics related to ARP Inspection activity in the switch.",
+            "properties": {
+                "arp-pkt-rcvd": {
+                    "type": "integer",
+                    "description": "Total number of ARP packets received."
+                },
+                "arp-pkt-dropped-rate-limit": {
+                    "type": "integer",
+                    "description": "Number of ARP packets dropped due to rate limiting."
+                },
+                "arp-pkt-processed": {
+                    "type": "integer",
+                    "description": "Total number of ARP packets processed by ARP Inspection."
+                },
+                "arp-pkt-dropped-src-mac": {
+                    "type": "integer",
+                    "description": "Number of ARP packets dropped due to source MAC address validation failures."
+                },
+                "arp-pkt-dropped-dst-mac": {
+                    "type": "integer",
+                    "description": "Number of ARP packets dropped due to destination MAC address validation failures."
+                },
+                "arp-pkt-dropped-ip": {
+                    "type": "integer",
+                    "description": "Number of ARP packets dropped due to IP address validation failures.\""
+                },
+                "arp-pkt-dropped-acl": {
+                    "type": "integer",
+                    "description": "Number of ARP packets dropped due to ARP ACL rules."
+                },
+                "arp-pkt-dropped-dhcp": {
+                    "type": "integer",
+                    "description": "Number of ARP packets dropped due to DHCP snooping validation failures."
+                }
+            }
+        },
+        "ip-source-guard": {
+            "type": "object",
+            "description": "Represents the configuration and state of IP Source Guard.",
+            "properties": {
+                "blocked-entries": {
+                    "type": "array",
+                    "description": "Displays a list of entries that are currently blocked by IP Source Guard (IPSG).",
+                    "items": {
+                        "type": "object",
+                        "properties": {
+                            "blocked-mac": {
+                                "type": "string",
+                                "description": "The MAC address that has been blocked by IP Source Guard.",
+                                "format": "mac-address"
+                            },
+                            "blocked-ip": {
+                                "type": "string",
+                                "description": "The IP address that has been blocked by IP Source Guard.",
+                                "format": "ipv4"
+                            },
+                            "blocked-vlan": {
+                                "type": "integer",
+                                "description": "The VLAN ID associated with the blocked IP/MAC entry.",
+                                "minimum": 1,
+                                "maximum": 4095
+                            },
+                            "blocked-interface": {
+                                "type": "string",
+                                "description": "The interface (e.g., port) where the blocked entry was detected."
+                            }
+                        }
+                    }
+                }
+            }
+        },
+        "stp": {
+            "description": "Global status and configuration of the Spanning Tree Protocol (STP) across the switch. Supports variants like STP, RSTP, MSTP. Includes bridge-wide parameters and protocol behavior.",
+            "type": "object",
+            "properties": {
+                "enabled": {
+                    "type": "boolean",
+                    "description": "Whether STP is enabled globally on the switch."
+                },
+                "mode": {
+                    "type": "string",
+                    "description": "Operational STP mode used across the switch.",
+                    "enum": [
+                        "stp",
+                        "rstp",
+                        "mstp",
+                        "pvst",
+                        "rpvstp"
+                    ]
+                },
+                "transmission-limit": {
+                    "type": "integer",
+                    "description": "Maximum number of BPDUs that can be transmitted per hello time."
+                },
+                "path-cost-method": {
+                    "type": "string",
+                    "description": "Indicates whether \"Short\" or \"Long\" path cost method is in use.",
+                    "enum": [
+                        "short",
+                        "long"
+                    ]
+                },
+                "max-hops": {
+                    "type": "integer",
+                    "description": "Maximum hop count used in MSTP."
+                },
+                "instances": {
+                    "type": "array",
+                    "description": "List of STP instances (e.g., MSTP instances).",
+                    "items": {
+                        "type": "object",
+                        "properties": {
+                            "instance-id": {
+                                "type": "integer",
+                                "description": "Instance number (for MSTP or multiple-instance support)."
+                            }
+                        },
+                        "vlans": {
+                            "type": "string",
+                            "description": "VLAN ranges associated with the STP instance.",
+                            "example": "1-4094"
+                        },
+                        "bridge-priority": {
+                            "type": "integer",
+                            "description": "Bridge priority value for STP election."
+                        },
+                        "bridge-hello-time": {
+                            "type": "integer",
+                            "description": "Hello Time interval (in seconds) configured on the bridge."
+                        },
+                        "bridge-max-age": {
+                            "type": "integer",
+                            "description": "Max Age value (in seconds) used for aging STP information."
+                        },
+                        "bridge-forward-delay": {
+                            "type": "integer",
+                            "description": "Delay (in seconds) before transitioning port to forwarding state."
+                        },
+                        "remaining-hops": {
+                            "type": "integer",
+                            "description": "Remaining hop count from the Root Bridge to this bridge."
+                        },
+                        "root-bridge-id": {
+                            "type": "string",
+                            "description": "Bridge ID of the current Root Bridge."
+                        },
+                        "root-port": {
+                            "type": "string",
+                            "description": "Local interface acting as Root Port.",
+                            "example": [
+                                "\u00cbthernet1"
+                            ]
+                        },
+                        "root-cost": {
+                            "type": "integer",
+                            "description": "Cumulative cost to reach the Root Bridge."
+                        },
+                        "topology-changes": {
+                            "type": "integer",
+                            "description": "Total number of topology changes detected."
+                        },
+                        "last-topology-change-seconds": {
+                            "type": "integer",
+                            "description": "Time (in seconds) since the last topology change."
+                        }
+                    }
+                }
+            }
         }
     },
     "$defs": {
@@ -451,6 +622,11 @@
                         "type": "string",
                         "description": "The administrative name of this logical interface. This field is freetext"
                     },
+                    "vlan_id": {
+                        "description": "VLAN-ID of the logical interface",
+                        "type": "integer",
+                        "maximum": 4094
+                    },
                     "ntp_server": {
                         "type": "string",
                         "description": "The upstream NTP server being used by this interface."
@@ -733,6 +909,11 @@
                                 "description": "Provides a textual description of the remote port, typically describing the interface or its purpose.",
                                 "example": "Ethernet Port on unit 1, port 2"
                             },
+                            "lldp-remote-sys-name": {
+                                "type": "string",
+                                "description": "Provides a textual description of the system name string (as defined by the sending device)",
+                                "example": "Datacenter Switch-1"
+                            },
                             "lldp-remote-port-max-mtu": {
                                 "type": "string",
                                 "description": "Displays the maximum transmission unit (MTU) size that the remote port supports, indicating the largest packet size the port can handle."
@@ -838,6 +1019,23 @@
                                             "Class-7",
                                             "Class-8"
                                         ]
+                                    },
+                                    "lldp-remote-port-power-priority": {
+                                        "type": "string",
+                                        "description": "Indicates the power priority level assigned to the PD.",
+                                        "enum": [
+                                            "low",
+                                            "high",
+                                            "critical"
+                                        ]
+                                    },
+                                    "lldp-remote-port-pd-requested-power": {
+                                        "type": "number",
+                                        "description": "Power requested by the PD in watts (0.1W resolution possible). The values must be presented with real values like 25.5, 20.5 etc."
+                                    },
+                                    "lldp-remote-port-pse-available-power": {
+                                        "type": "number",
+                                        "description": "Power that the PSE port is able to provide in watts (0.1W resolution)."
                                     }
                                 }
                             },
@@ -858,6 +1056,56 @@
                                         "description": "Displays the identifier of the Link Aggregation Group (LAG) that the remote port belongs to."
                                     }
                                 }
+                            },
+                            "lldp-remote-port-location": {
+                                "type": "object",
+                                "description": "Location information provided by LLDP-MED.",
+                                "properties": {
+                                    "location-subtype": {
+                                        "type": "string",
+                                        "description": "Indicates the type of location information being conveyed.",
+                                        "enum": [
+                                            "coordinate",
+                                            "civic-address",
+                                            "elin"
+                                        ]
+                                    },
+                                    "civic-addr": {
+                                        "type": "array",
+                                        "description": "Civic address information consisting of CA-Type and CA-Value pairs as per LLDP-MED.",
+                                        "items": {
+                                            "type": "object",
+                                            "properties": {
+                                                "ca-type": {
+                                                    "type": "integer",
+                                                    "description": "Civic Address Type identifier (e.g., 1 = Language, 3 = Country, 6 = A1 state/province, etc.)"
+                                                },
+                                                "ca-value": {
+                                                    "type": "string",
+                                                    "description": "Civic Address Value corresponding to the type."
+                                                }
+                                            }
+                                        }
+                                    },
+                                    "coordinates": {
+                                        "type": "object",
+                                        "description": "Location coordinates information.",
+                                        "properties": {
+                                            "latitude": {
+                                                "type": "string",
+                                                "description": "Latitude in decimal degrees (e.g., +37.7749)."
+                                            },
+                                            "longitude": {
+                                                "type": "string",
+                                                "description": "Longitude in decimal degrees (e.g., -122.4194)."
+                                            }
+                                        }
+                                    },
+                                    "elin": {
+                                        "type": "string",
+                                        "description": "Emergency Location Identification Number (ELIN) assigned to endpoint location"
+                                    }
+                                }
                             }
                         }
                     }
@@ -1081,6 +1329,126 @@
                             "type": "number"
                         }
                     }
+                },
+                "loop-detect-protocol": {
+                    "description": "Status and protocol information for loop detection or prevention mechanisms active on this interface. Includes STP/xSTP/MSTP, Loopback Detection (LBD), etc.",
+                    "type": "object",
+                    "properties": {
+                        "stp": {
+                            "description": "Spanning Tree Protocol (IEEE 802.1D/RSTP/MSTP) state on the port.",
+                            "type": "object",
+                            "properties": {
+                                "protocol": {
+                                    "type": "string",
+                                    "description": "Variant of STP running (e.g., STP, RSTP, MSTP, RPVST+).",
+                                    "examples": [
+                                        "RSTP",
+                                        "MSTP"
+                                    ]
+                                },
+                                "state": {
+                                    "type": "string",
+                                    "description": "STP state of the port.",
+                                    "enum": [
+                                        "disabled",
+                                        "blocking",
+                                        "listening",
+                                        "learning",
+                                        "forwarding"
+                                    ]
+                                },
+                                "role": {
+                                    "type": "string",
+                                    "description": "Role of the port in STP topology.",
+                                    "enum": [
+                                        "root",
+                                        "designated",
+                                        "alternate",
+                                        "backup",
+                                        "disabled"
+                                    ]
+                                },
+                                "bridge-id": {
+                                    "type": "string",
+                                    "description": "STP Bridge ID"
+                                },
+                                "root-bridge-id": {
+                                    "type": "string",
+                                    "description": "STP Root Bridge ID for the instance."
+                                },
+                                "oper-edge-port": {
+                                    "type": "boolean",
+                                    "description": "Whether the port is operating as an edge port (no BPDU expected)."
+                                },
+                                "cost": {
+                                    "type": "integer",
+                                    "description": "Operational path cost of the port."
+                                },
+                                "designated-cost": {
+                                    "type": "integer",
+                                    "description": "Cost advertised by the designated port."
+                                },
+                                "transitions": {
+                                    "type": "integer",
+                                    "description": "Number of STP state transitions (forwarding/discarding) on this port."
+                                },
+                                "bpdu-guard": {
+                                    "type": "string",
+                                    "description": "Runtime status of BPDU Guard on the port, when it detects any issue. - `errdisabled`- Port is shutdown due to BPDU violation. - `recovering`- Temporarily disabled and in auto-recovery interval.",
+                                    "enum": [
+                                        "errdisabled",
+                                        "recovering"
+                                    ]
+                                }
+                            }
+                        },
+                        "lbd": {
+                            "description": "Loopback Detection (LBD) status on this port.",
+                            "type": "object",
+                            "properties": {
+                                "enabled": {
+                                    "type": "boolean",
+                                    "description": "Whether LBD is enabled on this port."
+                                },
+                                "state": {
+                                    "type": "string",
+                                    "description": "Current loop detection status.",
+                                    "enum": [
+                                        "no_loop",
+                                        "loop_detected",
+                                        "disabled"
+                                    ]
+                                },
+                                "action": {
+                                    "type": "string",
+                                    "description": "Action taken when loop is detected (e.g., block, shutdown).",
+                                    "enum": [
+                                        "none",
+                                        "block",
+                                        "shutdown"
+                                    ]
+                                }
+                            }
+                        }
+                    }
+                },
+                "storm-status": {
+                    "description": "Runtime status of Storm Control feature on the port for each storm type.",
+                    "type": "object",
+                    "properties": {
+                        "broadcast": {
+                            "type": "boolean",
+                            "description": "Runtime status of Broadcast Storm Control on the port. Return `true`if Storm condition is detected."
+                        },
+                        "multicast": {
+                            "type": "boolean",
+                            "description": "Runtime status of Multicast Storm Control on the port. Return `true`if Storm condition is detected."
+                        },
+                        "unknown-unicast": {
+                            "type": "boolean",
+                            "description": "Runtime status of Unknown Unicast Storm Control on the port. Return `true`if Storm condition is detected."
+                        }
+                    }
                 }
             }
         },