NetBox icon

NetBox

Consume NetBox API

Actions243

Module Bay → List

AI-generated

Overview

This node interacts with the NetBox API to list module bays within the DCIM domain. It is useful for retrieving information about module bays in network devices, such as their IDs, associated device IDs, names, and positions. This can help network administrators manage and audit hardware components in their infrastructure.

Use Case Examples

  1. List all module bays in the DCIM domain to get an overview of available module bays.
  2. Filter module bays by device ID to see all module bays associated with a specific device.
  3. Limit the number of module bays returned to a specific count for pagination or performance reasons.

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 module bay results to return when 'Return All' is false.
Filters Filters to narrow down the list of module bays based on specific criteria such as module bay ID, device ID, name, or position.

Output

JSON

  • id - The unique identifier of the module bay.
  • device_id - The identifier of the device to which the module bay belongs.
  • name - The name of the module bay.
  • position - The position of the module bay within the device.

Dependencies

  • NetBox API with appropriate credentials

Troubleshooting

  • Ensure the NetBox API credentials are correctly configured and have the necessary permissions to access the DCIM domain and module bays resource.
  • If the node returns an error, check the filter values for correctness and ensure they match existing module bay attributes.
  • If no results are returned, verify that the filters are not too restrictive or that the module bays exist in the NetBox instance.

Links

Discussion