Canonical ListMachines

Canonical ListMachines

Certified
Enterprise Edition

List MAAS machines with filters

Retrieve MAAS machines with optional filters (status, zone, pool, tags) and pagination. Includes full machine details by default; when fields is empty and includeDetails is false, only basic identifiers are returned.

yaml
type: io.kestra.plugin.ee.canonical.maas.ListMachines

List ready machines in a pool

yaml
id: list_ready_machines
namespace: company.team
tasks:
  - id: list_ready_machines
    type: io.kestra.plugin.ee.canonical.maas.ListMachines
    url: "{{ secret('MAAS_URL') }}"
    apiKey: "{{ secret('MAAS_API_KEY') }}"
    filters:
      status:
        - "Ready"
        - "Deployed"
      zone: "zone-a"
      resourcePool: "production"
      tags:
        - "kubernetes-node"
    includeDetails: true
    fields:
      - "system_id"
      - "hostname"
      - "status_name"
      - "ip_addresses"
      - "cpu_count"
      - "memory"
      - "zone"
      - "pool"
Properties

MAAS API key

MAAS API key in the consumer: token: secret format.

MAAS URL

Base URL of the MAAS server, including the MAAS context path. Example: https://maas.example.com/MAAS

SubTypestring

Fields

Optional list of fields to keep in the response; overrides includeDetails when provided.

Filters

Filter map for listing machines; supported keys include status, zone, resourcePool/pool, and tags/tag.

Defaulttrue

Include details

Whether to include full machine details in the output; defaults to true.

Page

Page number for MAAS pagination.

Page size

Page size for MAAS pagination.

Reference (ref) of the pluginDefaults to apply to this task.

SubTypeobject

Machines

List of sanitized MAAS machines matching the filters.

More Plugins in this Category

NetBox (EE)
NetBox
Enterprise

Enterprise NetBox tasks to create, update, and query devices, IP addresses, and sites over the NetBox API.

Infrastructure

7 tasks

4 blueprints

AS400
AS400

Tasks that connect to AS400 via JDBC to run queries and loads.

DataInfrastructure

3 tasks