NetBox icon

NetBox

Consume NetBox API

Actions243

Interface Template → List

AI-generated

Overview

This node interacts with the NetBox API to list interface templates within the DCIM domain. It allows users to retrieve a list of interface templates with optional filtering, limiting, and ordering of results. This is useful for network administrators who want to programmatically access and manage interface template data from NetBox, such as fetching templates by device type, name, or interface type.

Use Case Examples

  1. A network engineer wants to retrieve all interface templates related to a specific device type to automate configuration management.
  2. An IT administrator needs to list interface templates with a specific name pattern to audit network configurations.

Properties

Name Meaning
Domain Specifies the domain of the NetBox API to use, here it is set to 'dcim' for data center infrastructure management.
Return All Determines whether to return all results or limit the number of results.
Limit Maximum number of results to return when 'Return All' is false.
Filters Collection of filters to narrow down the list of interface templates, such as by ID, search query, device type ID, module type ID, name, type, management only flag, and ordering field.

Output

JSON

  • id - Unique identifier of the interface template.
  • name - Name of the interface template.
  • type - Type of the interface template.
  • device_type_id - ID of the device type associated with the interface template.
  • module_type_id - ID of the module type associated with the interface template.
  • mgmt_only - Boolean indicating if the interface template is for management only.
  • other_properties - Additional properties returned by the NetBox API for each interface template.

Dependencies

  • NetBox API
  • API key credential for authentication

Troubleshooting

  • Ensure the API key credential is correctly configured and has sufficient permissions to access the DCIM domain and interface templates resource.
  • If the node returns an error, check the filter values for correctness, especially numeric IDs and option values.
  • If no results are returned, verify that the filters are not too restrictive or that the interface templates exist in the NetBox instance.
  • Common error messages may include authentication errors, invalid filter parameters, or network connectivity issues. Resolving these involves checking credentials, input parameters, and network access.

Links

Discussion