Canonical PowerControlMachine
CertifiedEnterprise EditionChange MAAS machine power state
Canonical PowerControlMachine
Change MAAS machine power state
Invoke MAAS power operations (on, off, cycle, query) for a machine. Cycle issues an off then on with a brief BMC settle delay. Optionally poll until the expected state (default 5m timeout).
type: io.kestra.plugin.ee.canonical.maas.PowerControlMachineExamples
Power cycle a machine
id: power_cycle_server
namespace: company.team
tasks:
- id: power_cycle_server
type: io.kestra.plugin.ee.canonical.maas.PowerControlMachine
url: "{{ secret('MAAS_URL') }}"
apiKey: "{{ secret('MAAS_API_KEY') }}"
systemId: "{{ outputs.deploy_ubuntu_server.systemId }}"
action: "cycle"
waitForPowerState: true
expectedState: "on"
timeout: PT5M
stopMode: "hard"
Properties
action *string
ONOFFCYCLEQUERYAction
Power action to execute: on, off, cycle, or query.
apiKey *string
MAAS API key
MAAS API key in the consumer: token: secret format.
systemId *string
System ID
MAAS system identifier of the machine to control; machine must already exist.
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
{}1150expectedState string
Expected power state
Power state to wait for (on or off); defaults to the action-derived target and ignored for query.
stopMode string
Stop mode
Stop mode to use for power off operations (for example soft or hard); ignored for on or query.
timeout string
PT5MTimeout
Maximum time to wait for the machine to reach the expected power state when waiting; defaults to 5 minutes.
waitForPowerState booleanstring
falseWait for power state
Whether to poll MAAS until the machine reaches the expected power state; defaults to false and is not used for query.
Outputs
powerState string
Power state
Power state reported by MAAS after the action or query.
systemId string
System ID
MAAS system identifier for the machine.
