domotz_power
Control device power actions and manage PDU outlets: list available actions, execute reboot/shutdown, and trigger outlet cycles with attach/detach device options.
Instructions
Manage device power actions and PDU power outlets. Use the "action" parameter to select an operation. Requires agent_id and device_id for all actions.
ACTION REFERENCE:
get_power_actions: List available power actions for a device (e.g. reboot, shutdown)
power_action: Execute a power action (needs "field" param with the action name from get_power_actions)
get_outlets: List power outlets on a PDU device
update_outlet: Update outlet settings (needs power_outlet_id + body)
trigger_outlet: Trigger an outlet action like cycle/on/off (needs power_outlet_id + outlet_action param e.g. "cycle", "on", "off")
attach_device: Attach a device to a power outlet (needs power_outlet_id + attached_device_id)
detach_device: Detach a device from a power outlet (needs power_outlet_id + attached_device_id)
GOTCHAS:
"trigger_outlet" uses "outlet_action" parameter (NOT "action") to specify what the outlet should do. The "action" param is always the tool operation selector.
"power_action" uses "field" parameter to identify which power action to execute
Workflow: get_power_actions first to see what's available, then power_action with the field name
EXAMPLES:
List power actions: {"action": "get_power_actions", "agent_id": 5, "device_id": 15}
List PDU outlets: {"action": "get_outlets", "agent_id": 5, "device_id": 15}
Cycle outlet: {"action": "trigger_outlet", "agent_id": 5, "device_id": 15, "power_outlet_id": 2, "outlet_action": "cycle"}
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| body | No | Request body (JSON object) | |
| field | No | Power action field name | |
| action | Yes | The operation to perform | |
| agent_id | No | Agent/Collector ID | |
| device_id | No | Device ID | |
| outlet_action | No | Outlet action to trigger | |
| power_outlet_id | No | Power Outlet ID | |
| attached_device_id | No | Device ID to attach/detach |