Skip to main content

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

  1. 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


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)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

aos8_api-8.9.3.post13-py3-none-any.whl (31.8 kB view details)

Uploaded Python 3

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

Hashes for aos8_api-8.9.3.post13.tar.gz
Algorithm Hash digest
SHA256 1c4b92012cc4c64e13122195d9ff2f5c4bedf9631b30e1668bf94240ca9834ac
MD5 465bed059ac37b04e95b294b5db8a22d
BLAKE2b-256 b907d66d4783b9150aaa63ed4e6ef1263bdc4c2a7beaf7dff521152f43c40ed7

See more details on using hashes here.

File details

Details for the file aos8_api-8.9.3.post13-py3-none-any.whl.

File metadata

File hashes

Hashes for aos8_api-8.9.3.post13-py3-none-any.whl
Algorithm Hash digest
SHA256 b942c2e94d33e8cf4bfa8821387f840aeedf3a928f7084829c3d91c3a2e6611d
MD5 41c895a6b5cfb8b1f07e8773e99b3699
BLAKE2b-256 3e196951746fe49d36493ab910acdd2d240ae3f7a866e7810b3d0ff010ae2474

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page