Aruba Central icon

Aruba Central

Interact with the Aruba Central API

Actions95

Switch → List Switches

AI-generated

Overview

This node interacts with the Aruba Central API to list network switches within the Monitoring domain. It is useful for network administrators who want to retrieve detailed or filtered information about switches managed by Aruba Central, such as their status, group, labels, stack ID, and other attributes. Practical examples include generating reports on switch inventory, monitoring switch health, or filtering switches by site or status.

Use Case Examples

  1. Retrieve all switches in the Monitoring domain to monitor network health.
  2. Filter switches by group or label to generate targeted reports.
  3. Limit the number of switches returned for performance optimization.
  4. Sort switches by serial number or MAC address for organized display.

Properties

Name Meaning
Domain Specifies the domain of the Aruba Central API to interact with, here set to 'monitoring' for switch monitoring.
Return All Determines whether to return all switch results or limit the number of results.
Limit Maximum number of switch results to return when 'Return All' is false.
Additional Fields Optional filters and parameters to refine the switch list, such as group, label, stack ID, status, fields to return, calculation options, public IP address, site, and sorting preferences.

Output

JSON

  • switches - Array of switch objects with details as per the requested fields and filters.
  • total - Total number of switches if 'Calculate Total' is enabled.
  • clientCount - Client count per switch if 'Calculate Client Count' is enabled.

Dependencies

  • Aruba Central API with OAuth2 authentication

Troubleshooting

  • Ensure the OAuth2 credentials for Aruba Central API are correctly configured and valid.
  • Check that the domain is set to 'monitoring' for the List Switches operation.
  • Verify that filter values such as group, label, and site exist in the Aruba Central environment to avoid empty results.
  • If the node returns an error, check the error message for API rate limits or permission issues.
  • When 'Return All' is false, ensure the limit is within the allowed range (1-1000).

Links

Discussion