Python is a high-level programming language that is used widely across various disciplines. Highly regarded for its simplified syntax, beginner-friendliness, and abundance of third-party libraries, Python is among the most popular programming languages in the world. The networking community especially embraces Python due in no small part to extensive vendor support as well as a low barrier of entry for getting started with automation and scripting.
pyaoscx package contains Python modules that can be called upon to access the REST API and configure various features on the switches. In order to use
pyaoscx, Python 3 must be installed on your system. You can download and install Python here.
pyaoscxpackage is compatible with Python 3 only. Python 2 is not officially supported.
Pyaoscx v2 vs v1
Pyaoscx v2 is not backwards compatible with v1. We are in the process of updating the documentation below to match the pyaoscx v2 with the launch of the AOS-CX version 10.10 coming in the near future. Be aware the difference in documentation specifying v1.
session.pyare also in the package, but they don't correspond with features and have been omitted from this table.
pyaoscx │ README.md │ Contributing.md │ ... │ └───pyaoscx │ │ access_security.py │ │ acl.py │ │ ... │ └───docs │ │ ... │ └───workflows │ cleanup_l2_l3_vlans.py │ configure_l2_l3_vlans.py └───print_system_info.py
pyaoscx package is a directory containing files and subdirectories. Contained directly within the top level
pyaoscx directory are informative files such as the readme, licensing information, contribution guidelines, and release notes. Also contained directly within the top level directory are the relevant code-containing directories
pyaoscx subfolder contains the AOS-CX Python modules. Each module contains function definitions which either make a single REST API call or multiple REST API calls. Each function that makes multiple REST API calls is written as such to perform a small logical low-level process (e.g. one call creates a VLAN and the next creates a corresponding VLAN interface). The REST API calls are performed using the Python
requests library, which provides functions to make HTTP GET, PUT, POST, and DELETE requests. Information about the
requests library can be found here.
Workflows are scripts that combine calls to functions in the
pyaoscx modules to emulate large higher-level network configuration processes (e.g. create ACL and ACL entries, apply ACL on interface, and lastly enable interface). The
workflows subfolder contains three example workflows. Each contains comments that describe step-by-step the operations being performed. If you'd like to try these out, you can make copies of these workflows in your own user directory and run them directly. In addition, you may find them to be useful references when creating your own workflows.
Updated 8 months ago