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.post12.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.post12-py3-none-any.whl (31.7 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: aos8_api-8.9.3.post12.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.post12.tar.gz
Algorithm Hash digest
SHA256 2d992381552cf9a282da9f647b292a5d9792e77354bd469c7a353cc03f745a27
MD5 8a5e6a58b9e5aa8f8a5b37cbd3bf0409
BLAKE2b-256 98af3cf5eb6d5755642806b9096918baaf4849d37465623b7516849409190923

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for aos8_api-8.9.3.post12-py3-none-any.whl
Algorithm Hash digest
SHA256 29ee3b13bb1b987ed20d0064e846fca6b78a8cf47b12294fde2f101b55efaf7c
MD5 84c59749d1e612af0542b4b64641a521
BLAKE2b-256 3b9b6c45a74cd2fc25ca8dde748c3d099a308bc048da7d7a7e30478bcb6db36d

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