Proxmox VE WaitForTask

Proxmox VE WaitForTask

Certified

Wait for a Proxmox VE async task to complete

Polls /nodes/{node}/tasks/{upid}/status until exitstatus=OK or the timeout is exceeded. Default timeout is 10 minutes, poll interval is 2 seconds.

yaml
type: io.kestra.plugin.proxmox.task.WaitForTask

Wait for a task

yaml
id: wait_for_task
namespace: company.team

tasks:
  - id: wait
    type: io.kestra.plugin.proxmox.task.WaitForTask
    host: "{{ secret('PROXMOX_HOST') }}"
    username: "{{ secret('PROXMOX_USERNAME') }}"
    password: "{{ secret('PROXMOX_PASSWORD') }}"
    node: pve
    upid: "UPID:pve:00001234:00000000:65000000:qmstart:100:root@pam:"
    timeoutSeconds: 600
Properties

Proxmox host

Hostname or IP address of the Proxmox VE node (no scheme, no port).

Proxmox node name

Name of the cluster node that scopes all API calls (e.g. pve, node1).

Task UPID

Proxmox Unique Process ID to poll.

Password

Password for ticket-based authentication.

Reference (ref) of the pluginDefaults to apply to this task.

Default8006

API port

Defaults to 8006.

Default600

Timeout in seconds

Maximum time to wait for task completion. Defaults to 600 (10 minutes).

API token ID

Full token identifier in the form user@realm!tokenname (e.g. root@pam!mytoken). Use together with tokenSecret.

API token secret

The UUID secret associated with the token ID.

Username

PAM or PVE user in the form user@realm (e.g. root@pam). Required when using ticket-based auth.

Defaulttrue

Verify SSL

Validate the server TLS certificate. Defaults to true; set to false only for trusted networks with self-signed Proxmox certificates.