Canonical MaaS
The MaaS integration reads a MaaS region through its REST API: the region's zones and resource pools, every machine it manages, and the subnets it knows about. It runs on an Integrator, since a MaaS region controller is normally only reachable inside your network.
It is read-only. The integration never allocates, deploys, powers or releases a machine.
What it collects
| Sync | Collects |
|---|---|
| Machine discovery | Every machine with its status, power state, owner, zone, pool, architecture, CPU, memory, deployed OS, addresses and MACs |
| Network discovery | Subnets with their VLAN, fabric, space and gateway |
Machines are kept as their own records, alongside hosts rather than written into them. A machine whose address matches a host a scan has found is linked to it.
Create an API key
- Sign in to MaaS as a user who can see the machines to inventory. An administrator sees every machine; a regular user sees only its own and unallocated ones.
- Under Preferences > API keys, generate a key and copy it. It has the form
consumer:token:secret.
Connect it
- Under Integrations, add Canonical MaaS with the region URL (for example
http://maas.example.com:5240/MAAS) and the API key. - In the integration's settings, assign the Integrator that can reach the region controller.
- Enable the syncs you want.
If the region is served over HTTPS with a self-signed certificate, the first connection records its fingerprint and later connections must present the same certificate.