NetBox icon

NetBox

Consume NetBox API

Actions243

Device Bay → List

AI-generated

Overview

This node interacts with the NetBox API to list device bays within the DCIM domain. It is useful for retrieving information about device bays in a network infrastructure managed by NetBox, allowing users to filter results based on specific criteria such as device bay ID, device ID, name, or installed device ID. This can help network administrators or IT professionals to efficiently query and manage device bay data.

Use Case Examples

  1. List all device bays in the DCIM domain.
  2. Retrieve device bays filtered by a specific device ID or name.

Properties

Name Meaning
Domain Specifies the domain of the NetBox API to interact with, here it is set to 'dcim' for device-related data.
Return All Determines whether to return all results or limit the number of results returned.
Limit Maximum number of results to return when 'Return All' is false.
Filters Filters to narrow down the list of device bays based on criteria such as device bay ID, device ID, name, or installed device ID.

Output

JSON

  • id - The unique identifier of the device bay.
  • device_id - The identifier of the device associated with the device bay.
  • name - The name of the device bay.
  • installed_device_id - The identifier of the installed device in the device bay.

Dependencies

  • NetBox API
  • An API key credential for authentication

Troubleshooting

  • Common issues include authentication errors due to invalid or missing API credentials. Ensure the API key credential is correctly configured.
  • Filtering parameters must be valid; incorrect filter values may result in empty responses.
  • If 'Return All' is set to false and the limit is too low, not all desired results may be returned. Adjust the limit or enable 'Return All' to retrieve more data.

Links

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

Discussion