Canonical ListMachines
CertifiedEnterprise EditionList MAAS machines with filters
Canonical ListMachines
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.
type: io.kestra.plugin.ee.canonical.maas.ListMachinesExamples
List ready machines in a pool
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
apiKey *string
MAAS API key
MAAS API key in the consumer: token: secret format.
url *string
MAAS URL
Base URL of the MAAS server, including the MAAS context path.
Example: https://maas.example.com/MAAS
fields array
Fields
Optional list of fields to keep in the response; overrides includeDetails when provided.
filters object
Filters
Filter map for listing machines; supported keys include status, zone, resourcePool/pool, and tags/tag.
includeDetails booleanstring
trueInclude details
Whether to include full machine details in the output; defaults to true.
page integerstring
Page
Page number for MAAS pagination.
pageSize integerstring
Page size
Page size for MAAS pagination.
Outputs
machines array
Machines
List of sanitized MAAS machines matching the filters.
