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
expectedState 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.
