HomeGuidesAPI ReferenceGuidesMRT APIConfiguration API
GitHubAirheads Developer Community
Guides

Introduction

What is PyCentral?

PyCentral is a Python software development kit (SDK) that makes it easier to interact with HPE Aruba Networking Central and the HPE GreenLake Platform (GLP) through REST APIs. Instead of building and managing low-level HTTP requests, developers can:

  • Authenticate securely
  • Configure and manage devices and subscriptions
  • Monitor performance and collect analytics
  • Run troubleshooting workflows

PyCentral handles authentication, request formatting, and error handling, while exposing simple Python functions. This lets you configure, monitor, and troubleshoot your network without dealing with raw REST API calls.

Key Benefits of PyCentral

PyCentral(v2) is the latest version of the SDK, designed for compatibility and simplicity:

  • Backwards Compatible → Works with PyCentral v1 scripts, with no breaking changes.
  • Multi-Platform Support → Works across Classic Central, Central, and GLP.
  • Simplified Token Management → Built-in OAuth2.0 support (no manual refresh needed).
  • Simplified Automation → Modules for configuration, monitoring, devices, subscriptions, troubleshooting, and streaming.

Two Ways to Use the SDK

There are two usage patterns. The right one depends on what you're doing.

  1. command() on NewCentralBase — call any New Central/GLP API endpoint directly. Best when you're exploring the API, calling an endpoint not yet covered by a module, or building something custom.
  2. Module classes — pre-built classes that wrap common API operations, handling pagination, parameter defaults, and response parsing for you. Best when a module already covers the endpoint you need.

Not sure which to use? Start with command() and migrate to module classes once you know which endpoints you're hitting repeatedly. The Quickstart Guide uses command() to keep things simple.

Versions

🚧

Note

PyCentral-v2 is currently in pre-release. Feedback is welcome and can be provided here as we continue improving it.

Today, there are two versions of PyCentral, each designed for different versions of HPE Aruba Networking Central -

VersionSupportsNotes
v1HPE Aruba Networking Central (Classic Central)Legacy Version
v2(pre-release)HPE Aruba Networking Central, GLP, HPE Aruba Networking Central (Classic Central)Backwards compatible with v1

Next Steps

AuthenticationSet up credentials before running your first script
Quickstart GuideInstall PyCentral and make your first API call
Module referenceBrowse class and method documentation on ReadtheDocs
Example workflowsReady-to-run automation scripts on GitHub
GitHubSource code, issues, and release notes