AvantGuard - Hudu icon

AvantGuard - Hudu

AvantGuard - Hudu
Join our community

Actions109

Overview

This n8n node allows you to retrieve a list of IP addresses from the AvantGuard Hudu API. It is designed for scenarios where you need to fetch, filter, or process IP address records managed in your Hudu environment. Common use cases include network inventory management, auditing, compliance checks, and integrating Hudu IP data with other systems or workflows.

Practical examples:

  • Fetch all IP addresses assigned to a specific network.
  • Retrieve IPs filtered by status (e.g., only active addresses).
  • List IP addresses updated within a certain date range for audit purposes.

Properties

Name Type Meaning
Additional Query Parameters collection Optional query parameters to refine your search for IP addresses. Each field below can be added as needed:
└ Network Id number Filter results by a specific network ID.
└ Address string Filter results by an exact IP address.
└ Status string Filter results by the status of the IP address (e.g., active, reserved).
└ Fqdn string Filter results by Fully Qualified Domain Name associated with the IP address.
└ Asset Id number Filter results by asset ID linked to the IP address.
└ Company Id number Filter results by company ID.
└ Created At string Filter IP addresses created within a specific time range or at an exact time. Use ISO 8601 format. Examples: '2023-06-07T12:34:56Z,' (from this date to now), ',2023-06-07T12:34:56Z' (until this date), or '2023-06-01T12:34:56Z,2023-06-07T12:34:56Z' (between these dates).
└ Updated At string Filter IP addresses updated within a specific time range or at an exact time. Same format as "Created At".

Output

The node outputs a JSON array where each item represents an IP address record retrieved from Hudu. The structure typically includes fields such as:

{
  "id": 123,
  "address": "192.168.1.10",
  "status": "active",
  "fqdn": "host.example.com",
  "network_id": 45,
  "asset_id": 67,
  "company_id": 89,
  "created_at": "2023-06-01T12:34:56Z",
  "updated_at": "2023-06-07T12:34:56Z"
}

Note: The actual output fields may vary depending on the Hudu API schema.

Dependencies

  • External Service: Requires access to the AvantGuard Hudu API.
  • API Credentials: You must configure the avantguardHuduApi credential in n8n, which should include the base URL and authentication details for your Hudu instance.
  • n8n Configuration: No additional configuration required beyond credentials.

Troubleshooting

  • Invalid Credentials: If the API key or base URL is incorrect, you may receive authentication errors (e.g., "401 Unauthorized"). Double-check your credentials in n8n.
  • Missing Required Fields: If mandatory query parameters are omitted or incorrectly formatted, the API may return errors. Ensure date filters use proper ISO 8601 format.
  • Network Issues: Connectivity problems between n8n and the Hudu API endpoint can cause request failures. Verify network/firewall settings.
  • Empty Results: If filters are too restrictive, the result set may be empty. Try broadening your query parameters.

Links and References

Discussion