AsyncIO client for Extreme Cloud IQ
Project description
Extreme Cloud IQ - Python3 AsyncIO Client
This repository contains a Python3 asyncio based client library for interacting with the Extreme Cloud IQ system (XIQ).
Note that Extreme does provide their own Python SDK client, which can be found in the reference section below.
Installation
pip install aio-xiq
This XIQ asyncio python client is a subclass from httpx.AsyncClient.
QuickStart
Before using the API you must either have an existing token or login with your user-name + password credentials. You can either pass these values into the client constructor, or use these environment variables:
- XIQ_USER - the login user-name
- XIQ_PASSWORD = the login password
-- or -- * XIQ_TOKEN - an existing API token
Username + Password
If you are using your login credentials you must execute the login()
method to obtain an access
token.
from aioxiq import XiqClient
async with XiqClient(xiq_user='bob@corp.com', xiq_password='notarealpassword') as api:
await api.login()
devices = await api.fetch_devices()
API Token
You can create an API token via the XIQ portal by nagivating to the Global Settings page (found under your User profile near the top-right), and then selecting the "API Token Management" option on the left sidebar.
When using the API Token approach, you can use the client diretly without having to perform the login function.
from aioxiq import XiqClient
# presume that XIQ_TOKEN environment variable is set with an existing token.
# you can immediately use the API without login.
async with XiqClient() as api:
devices = api.fetch_devices()
References
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.