NetBox icon

NetBox

Consume NetBox API

Overview

This node integrates with the NetBox API, a popular infrastructure resource modeling tool used for managing IP addresses, devices, and related data in network environments. Specifically, the "Device Bay Template" resource's "Get" operation allows users to retrieve detailed information about a particular device bay template by its ID.

Typical use cases include:

  • Fetching metadata about device bay templates to automate inventory or configuration management.
  • Integrating device bay template details into workflows that provision or audit network hardware.
  • Synchronizing device bay template data between NetBox and other systems.

For example, a network automation workflow might use this node to get the specifications of a device bay template before deploying new hardware configurations.

Properties

Name Meaning
Domain The domain of the NetBox API to target. Options: DCIM, IPAM, Tenancy, Extras, Virtualization, Circuits, Core, Users, Plugins, VPN, Wireless, Status. Default is DCIM.
Device Bay Template ID The numeric ID of the device bay template to retrieve. Required when Domain is DCIM, Resource is Device Bay Template, and Operation is Get.

Output

The node outputs JSON data representing the requested device bay template record from NetBox. This includes all fields returned by the NetBox API for that resource, such as template name, description, associated device types, and other metadata.

No binary data output is produced by this operation.

Dependencies

  • Requires an active connection to a NetBox instance via an API key credential configured in n8n.
  • The node depends on the NetBox API being accessible and the provided credentials having permission to read device bay templates.
  • No additional external services are required beyond the NetBox API.

Troubleshooting

  • Common Issues:

    • Invalid or missing Device Bay Template ID will cause the API call to fail.
    • Network connectivity issues or incorrect API endpoint configuration can prevent successful requests.
    • Insufficient permissions on the API token may result in authorization errors.
  • Error Messages:

    • Errors from the NetBox API (e.g., 404 Not Found) indicate the specified device bay template does not exist.
    • Authentication errors suggest invalid or expired API credentials.
    • Timeout or network errors imply connectivity problems.
  • Resolutions:

    • Verify the Device Bay Template ID is correct and exists in NetBox.
    • Check API credentials and ensure they have read access to the DCIM domain.
    • Confirm network connectivity and correct API URL configuration in n8n credentials.

Links and References

Discussion