pbs_node_service_control
Manage services on a Proxmox Backup Server node: start, stop, restart, or reload systemd services. Uses dry-run planning by default; set confirm=true to execute.
Instructions
MUTATION: start/stop/restart/reload a service on a PBS node. Dry-run by default — the PLAN flags lockout-class services (proxmox-backup/proxmox-backup-proxy/sshd/networking/ifupdown2/ chrony) as HIGH because stop/restart can sever management access or break backup jobs. There is NO auto-undo. confirm=True executes (POST /nodes/{node}/services/{service}/{action}) and returns {"status": "ok", "result": None}. Check current state first with pbs_node_service_status. Needs PROXIMO_PBS_* config.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| node | No | PBS node name (or 'localhost'). | localhost |
| action | Yes | Control action: 'start', 'stop', 'restart', or 'reload'. | |
| confirm | No | False (default) returns a dry-run PLAN only; True executes the service control. | |
| service | Yes | systemd service name to control, e.g. 'proxmox-backup-proxy' or 'sshd'. | |
| proximo_target | No | Which configured Proxmox target to run this call against — a target name from your multi-target config (a specific PVE/PBS/PMG/PDM box). Omit to use the single/default target from the environment; the selection applies only to this call. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |