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.post13.tar.gz
(26.5 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.post13.tar.gz.
File metadata
- Download URL: aos8_api-8.9.3.post13.tar.gz
- Upload date:
- Size: 26.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.13.4
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
1c4b92012cc4c64e13122195d9ff2f5c4bedf9631b30e1668bf94240ca9834ac
|
|
| MD5 |
465bed059ac37b04e95b294b5db8a22d
|
|
| BLAKE2b-256 |
b907d66d4783b9150aaa63ed4e6ef1263bdc4c2a7beaf7dff521152f43c40ed7
|
File details
Details for the file aos8_api-8.9.3.post13-py3-none-any.whl.
File metadata
- Download URL: aos8_api-8.9.3.post13-py3-none-any.whl
- Upload date:
- Size: 31.8 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 |
b942c2e94d33e8cf4bfa8821387f840aeedf3a928f7084829c3d91c3a2e6611d
|
|
| MD5 |
41c895a6b5cfb8b1f07e8773e99b3699
|
|
| BLAKE2b-256 |
3e196951746fe49d36493ab910acdd2d240ae3f7a866e7810b3d0ff010ae2474
|