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.post11.tar.gz
(26.2 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.post11.tar.gz.
File metadata
- Download URL: aos8_api-8.9.3.post11.tar.gz
- Upload date:
- Size: 26.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.13.4
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
6d35547a6b6804eb57bdbf921a1046899319ff54563f5daa66c91f79aea7d952
|
|
| MD5 |
8895e9d971617bd0eb9504d2f78717cc
|
|
| BLAKE2b-256 |
9049dda2b415e428452e98e704032316066243bb22a6240c77bc4452c11eceaf
|
File details
Details for the file aos8_api-8.9.3.post11-py3-none-any.whl.
File metadata
- Download URL: aos8_api-8.9.3.post11-py3-none-any.whl
- Upload date:
- Size: 31.5 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 |
bd58e22306ea11486ca2c12fab2c7c0c36bbb10485ebdfabe1dadfe1218611bd
|
|
| MD5 |
5ef302b9d5e3862d5ce70869dd9a61d6
|
|
| BLAKE2b-256 |
4fcb6401640fe0e58593665b923598c9fbf06d957146968575163fdc032a5e58
|