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.post9.tar.gz (26.4 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.post9-py3-none-any.whl (31.8 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: aos8_api-8.9.3.post9.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

Hashes for aos8_api-8.9.3.post9.tar.gz
Algorithm Hash digest
SHA256 6117ebddddc36447b1a30b9d106c343e14d6ef03cbc11f2aa5fe952013a3246f
MD5 21b220c3d807cce49aea940a0ea93a3b
BLAKE2b-256 9da0b7103fe336f71eabf439437aeb3dbcc6692ae4e56c333b362a112b533929

See more details on using hashes here.

File details

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

File metadata

  • Download URL: aos8_api-8.9.3.post9-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

Hashes for aos8_api-8.9.3.post9-py3-none-any.whl
Algorithm Hash digest
SHA256 a22228fe135f8d2e834441ff0fb0f1120940a573615873f15eab195c00390aa9
MD5 915a1c42774e59b838e7f4d5bb05beed
BLAKE2b-256 5ff974ea484031c8ec34cfe8735f2d76bb85ed6121bf52d14c2f20611208b9dc

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