Overview

This node operation retrieves multiple VLAN (Virtual Local Area Network) records from the Hudu system. It supports filtering VLANs by various criteria such as archived status, company, VLAN name, VLAN numeric ID, and VLAN zone. Users can choose to return all matching VLANs or limit the number of results. Additionally, the results can be wrapped into a single item containing an array of VLANs and a count, which helps prevent downstream nodes from executing multiple times and potentially hitting rate limits. This operation is useful for network administrators or IT professionals who need to fetch and manage VLAN information programmatically within their workflows.

Use Case Examples

1. Fetch all active VLANs for a specific company to audit network segmentation.
2. Retrieve a limited number of VLANs filtered by VLAN zone to update network documentation.
3. Get all VLANs and wrap results in a single item to efficiently process them in subsequent workflow steps without triggering rate limits.

Properties

Output

JSON

• items - Array of VLAN objects when results are wrapped in a single item.
• count - Number of VLANs returned when results are wrapped.
  - Individual VLAN properties returned as JSON objects when results are not wrapped.

Dependencies

• Hudu REST API

Troubleshooting

• Ensure the API credentials for Hudu are correctly configured to avoid authentication errors.
• If no VLANs are returned, verify that the filter criteria are correct and that VLANs exist matching those filters.
• When using 'Wrap Results in Single Item', downstream nodes expecting individual items may not function as intended; adjust workflow accordingly.

Links

• Hudu API VLANs Documentation - Official API documentation for VLAN operations in Hudu.