Skip to main content

Abiquo API Python Client

Project description

This is a Python client for the Abiquo API. It allows to consume the API in a dynamic way and to navigate its resources using its built-in linking features.

The project depends on requests and optionally on requests_oauthlib, if you prefer to use OAuth instead of Basic Authentication.

Installation

You can easily install the module with:

pip install abiquo-api

Usage

Using the client is pretty straightforward. Here are some examples:

Using HTTP Basic Authentication

This example shows how to get the list of existing datacenters and how to navigate its links to create a rack in each of them:

import json
from abiquo.client import Abiquo

api = Abiquo(API_URL, auth=(username, password))
code, datacenters = api.admin.datacenters.get(
    headers={'Accept':'application/vnd.abiquo.datacenters+json'})

print "Response code is: %s" % code
for dc in datacenters:
    print "Creating rack in datacenter %s [%s]" % (dc.name, dc.location)
    code, rack = datacenter.follow('racks').post(
            data=json.dumps({'name': 'New rack'}),
            headers={'Accept':'application/vnd.abiquo.rack+json',
                     'Content-type':'application/vnd.abiquo.rack+json'})
    print "Response code is: %s" % code
    print "Created Rack: %s" % rack.name

Note that you don’t need to care about pagination, the client handles it internally for you.

Using OAuth

To use OAuth first you have to register your client application in the Abiquo API. To do that, you can use the register.py script as follows, and it will register the application and generate the access tokens:

$ python register.py
Abiquo API endpoint: http://localhost/api
Username: your-username
Password: your-password
Application name: My Cool App

App key: 54e00f27-6995-40e8-aefe-75f76f514d89
App secret: eayP6ll3G02ypBhQBmg0398HYBldkf3B5Jqti73Z
Access token: c9c9bd44-6812-4ddf-b39d-a27f86bf03da
Access token secret: MifYOffkoPkhk33ZTiGOYnIg8irRjw7BlUCR2GUh7IQKv4omfENlMi/tr+gUdt5L8eRCSYKFQVhI4Npga6mXIVl1tCMHqTldYfqUJZdHr0c=

Once you have the tokens, you just have to create the authentication object and pass it to the Abiquo client as follows:

from requests_oauthlib import OAuth1
from abiquo.client import Abiquo

APP_KEY = '54e00f27-6995-40e8-aefe-75f76f514d89'
APP_SECRET = 'eayP6ll3G02ypBhQBmg0398HYBldkf3B5Jqti73Z'
ACCESS_TOKEN = 'c9c9bd44-6812-4ddf-b39d-a27f86bf03da'
ACCESS_TOKEN_SECRET = 'MifYOffkoPkhk33ZTiGOYnIg8irRjw7BlUCR2GUh7IQKv4omfENlMi/tr+gUdt5L8eRCSYKFQVhI4Npga6mXIVl1tCMHqTldYfqUJZdHr0c='

oauth=OAuth1(APP_KEY,
        client_secret=APP_SECRET,
        resource_owner_key=ACCESS_TOKEN,
        resource_owner_secret=ACCESS_TOKEN_SECRET)

api = Abiquo(API_URL, auth=oauth)

And that’s it! Now you can use the Abiquo client as shown in the Basic Authentication examples.

Contributing

This project is still in an early development stage and is still incomplete. All contributions are welcome, so feel free to raise a pull request.

License

The Abiquo API Java Client is licensed under the Apache License version 2. For further details, see the LICENSE file.

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

abiquo-api-0.1.7.tar.gz (4.8 kB view hashes)

Uploaded Source

Built Distribution

abiquo_api-0.1.7-py2.7.egg (7.5 kB view hashes)

Uploaded Source

Supported by

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