OmniSwitch RestFUL API for Python
Project description
OmniSwitch AOS 8.x RestFul API Builder for Python - Aos8ApiBuilder
Aos8ApiBuilder is a lightweight python library that enables developers to interact seamlessly with the OmniSwitch RESTful API running version 8.x releases.
✨ Supported APIs
- System
- Chassis
- Interface
- LACP
- VLAN
- MVRP
- VPA
- MAC
- IP
🛠️ Built With
- python 3.8
dependencies = [
anyio==4.9.0
certifi==2025.6.15
click==8.2.1
colorama==0.4.6
ghp-import==2.1.0
griffe==1.7.3
h11==0.16.0
httpcore==1.0.9
httpx==0.28.1
idna==3.10
Jinja2==3.1.6
Markdown==3.8.2
MarkupSafe==3.0.2
mergedeep==1.3.4
mkdocs==1.6.1
mkdocs-autorefs==1.4.2
mkdocs-get-deps==0.2.0
mkdocstrings==0.29.1
mkdocstrings-python==1.16.12
packaging==25.0
pathspec==0.12.1
platformdirs==4.3.8
pymdown-extensions==10.16
python-dateutil==2.9.0.post0
PyYAML==6.0.2
pyyaml_env_tag==1.1
six==1.17.0
sniffio==1.3.1
watchdog==6.0.0
]
🚀 Installation
- pip install aos8x-api
📦 Usage Guide
Step 1: Create an object of AosApiClient
from aos8_api.ApiBuilder import AosApiClientBuilder
client = (
AosApiClientBuilder()
.setBaseUrl("https://<switch-ip-address>")
.setUsername("<username>")
.setPassword("<password>")
.build()
)
Step 2: Start calling the respective API in your application
result = client.vlan.create_vlan(vlan_id=999)
if result.success:
print("✅ Vlan operation successfully")
else:
print(f"❌ VLAN creation failed (diag={result.diag}): {result.error}")
📚 Documentation
Please check out the details documentation at https://samuelyip74.github.io/Aos8ApiBuilder/intro/#
📦 Releases
| Version | Date | Notes |
|---|---|---|
| v8.9.03 | 2025-05-28 | Initial release |
| v8.9.03post1 | 2025-05-28 | Interface, IP API added |
| v8.9.03post2 | 2025-05-28 | MVRP, System, MAC added |
| v8.9.03post3 | 2025-06-01 | chassis API added |
| v8.9.03post4 | 2025-06-02 | CLI API added |
📄 License
Copyright (c) Samuel Yip Kah Yean <2025>
This software is licensed for personal, non-commercial use only.
You are NOT permitted to:
- Use this software for any commercial purposes.
- Modify, adapt, reverse-engineer, or create derivative works.
- Distribute, sublicense, or share this software.
All rights are reserved by the author.
For commercial licensing or permission inquiries, please contact:
kahyean.yip@gmail.com
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
aos8_api-8.9.3.post12.tar.gz
(26.4 kB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file aos8_api-8.9.3.post12.tar.gz.
File metadata
- Download URL: aos8_api-8.9.3.post12.tar.gz
- Upload date:
- Size: 26.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.13.4
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
2d992381552cf9a282da9f647b292a5d9792e77354bd469c7a353cc03f745a27
|
|
| MD5 |
8a5e6a58b9e5aa8f8a5b37cbd3bf0409
|
|
| BLAKE2b-256 |
98af3cf5eb6d5755642806b9096918baaf4849d37465623b7516849409190923
|
File details
Details for the file aos8_api-8.9.3.post12-py3-none-any.whl.
File metadata
- Download URL: aos8_api-8.9.3.post12-py3-none-any.whl
- Upload date:
- Size: 31.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.13.4
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
29ee3b13bb1b987ed20d0064e846fca6b78a8cf47b12294fde2f101b55efaf7c
|
|
| MD5 |
84c59749d1e612af0542b4b64641a521
|
|
| BLAKE2b-256 |
3b9b6c45a74cd2fc25ca8dde748c3d099a308bc048da7d7a7e30478bcb6db36d
|