Table of Contents

1. Quickstart
   1. Installing
   2. Using
2. Why?
3. How?

Quickstart

Installing

You can install using pip.

pip install maas-api

Using

You can use the api client the same way you would use the CLI.

from maas_api import Client

client = Client("http://192.0.2.10:/MAAS", api_key="your:api:key")

# allocate a machine
machine = client.machines.allocate()
# start deploy
client.machine.deploy(system_id=machine["system_id"])
# release the machine
client.machine.release(system_id=machine["system_id"])

Why?

The official MAAS api client library python-libmaas did not receive any new functionality that is available with MAAS. There is however a CLI written in python. This allows all the functionality to be used.

How?

By using the same technique as the official CLI. By using the API description available at /MAAS/api/2.0/describe. This allows us to expose the full API exposed by the MAAS server and to keep functional parity with the CLI.