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
assets
Assets this task consumes as inputs or produces as outputs, for lineage tracking and the asset graph (Enterprise Edition). A flow declaring this property on a task is rejected in the open-source edition.
io.kestra.core.models.assets.AssetsDeclaration
IGNOREFAILWARNAsset failure behavior
Behavior applied to the task state when a declared asset fails to render, emit, or be persisted (e.g. a lock conflict): FAIL escalates it to FAILED, WARN (default) warns it if it would otherwise succeed, IGNORE leaves the state untouched.
Whether to auto-register assets referenced dynamically at runtime that are not statically declared in inputs or outputs.
The assets consumed as inputs.
io.kestra.core.models.assets.AssetIdentifier
1The assets produced as outputs.
io.kestra.plugin.ee.assets.Dataset
1150{}1150io.kestra.plugin.ee.assets.File
1150{}1150io.kestra.plugin.ee.assets.Table
1150{}1150io.kestra.plugin.ee.assets.VM
1150{}1150io.kestra.core.models.assets.External
1150{}1150io.kestra.core.models.assets.Custom
11501Custom asset type
{}1150fields 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.
