NetBox icon

NetBox

Consume NetBox API

Actions243

Platform → List

AI-generated

Overview

This node interacts with the NetBox API to list platform resources within the DCIM domain. It is useful for retrieving information about hardware platforms managed in NetBox, such as device platforms, including filtering and pagination options.

Use Case Examples

  1. Retrieve a list of all platforms in the DCIM domain.
  2. Fetch up to 50 platforms with specific filters like manufacturer name or platform ID.

Properties

Name Meaning
Domain Specifies the domain of the NetBox API to interact with, 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 platform results to return when 'Return All' is false.
Filters Collection of filters to narrow down the list of platforms, such as platform ID, name, slug, description, manufacturer ID, manufacturer name, NAPALM driver, and tag.

Output

JSON

  • id - Unique identifier of the platform.
  • name - Name of the platform.
  • slug - Slug identifier for the platform.
  • description - Description of the platform.
  • manufacturer_id - Identifier of the manufacturer associated with the platform.
  • manufacturer - Name or slug of the manufacturer.
  • napalm_driver - NAPALM driver name associated with the platform.
  • tag - Tags associated with the platform.

Dependencies

  • NetBox API
  • an API key credential for authentication

Troubleshooting

  • Common issues include API authentication failures, incorrect domain or resource names, and invalid filter parameters.
  • Error messages may indicate network issues, permission errors, or invalid input parameters. Ensure the API key is valid and the domain/resource names match NetBox API specifications.

Links

  • NetBox API Documentation - Official documentation for the NetBox API, useful for understanding available endpoints and parameters.

Discussion