NetBox icon

NetBox

Consume NetBox API

Actions243

Region → Get Sites

AI-generated

Overview

This node interacts with the NetBox API to retrieve sites associated with a specific region within the DCIM domain. It is useful for network administrators or IT professionals who need to programmatically access site information grouped by region in their NetBox instance. For example, it can be used to fetch all sites under a given region ID, either returning all results or limiting the number of results for performance or pagination purposes.

Use Case Examples

  1. Retrieve all sites for a region to display in a network management dashboard.
  2. Fetch a limited number of sites for a region to process in a workflow that updates site details.

Properties

Name Meaning
Domain Specifies the domain of the NetBox API to use, here it is set to 'dcim' for data center infrastructure management.
Region ID The unique identifier of the region for which to retrieve associated sites.
Return All Boolean flag indicating whether to return all site results or limit the number of results.
Limit Maximum number of site results to return if 'Return All' is false.

Output

JSON

  • sites - Array of site objects associated with the specified region.

Dependencies

  • NetBox API with appropriate credentials

Troubleshooting

  • Ensure the Region ID is valid and exists in the NetBox instance to avoid errors.
  • If the API credentials are incorrect or missing, authentication errors will occur.
  • If 'Return All' is false and 'Limit' is set too low, not all sites will be retrieved, which might cause incomplete data issues.

Links

Discussion