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 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.post4.tar.gz (2.7 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.post4-py3-none-any.whl (3.1 kB view details)

Uploaded Python 3

File details

Details for the file aos8_api-8.9.3.post4.tar.gz.

File metadata

  • Download URL: aos8_api-8.9.3.post4.tar.gz
  • Upload date:
  • Size: 2.7 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.post4.tar.gz
Algorithm Hash digest
SHA256 a39719c9b0527ae885b2833207bf98ce975180deffcbab2779bd6fc3cd47cee0
MD5 d87c778eb4d4b85175019e67e77b2e73
BLAKE2b-256 775668f36a3a59cbff466ec20f42d80c42040a8a15b9148397d91fe4d04a3a61

See more details on using hashes here.

File details

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

File metadata

  • Download URL: aos8_api-8.9.3.post4-py3-none-any.whl
  • Upload date:
  • Size: 3.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.4

File hashes

Hashes for aos8_api-8.9.3.post4-py3-none-any.whl
Algorithm Hash digest
SHA256 efcbfd669236c76ca6e7057e9c9385f0a9fc6081de0cc4dcaa0f7e429804a7c2
MD5 df8c8d7139626d3bf983dee21d0c9b57
BLAKE2b-256 172f53f2e75475a5840165b9f64d755fe8132600010669ae2ff1c1168644ffcd

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