
Proxmox VE WaitForTask
CertifiedWait for a Proxmox VE async task to complete
Proxmox VE WaitForTask
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.
type: io.kestra.plugin.proxmox.task.WaitForTaskExamples
Wait for a task
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
host *Requiredstring
Proxmox host
Hostname or IP address of the Proxmox VE node (no scheme, no port).
node *Requiredstring
Proxmox node name
Name of the cluster node that scopes all API calls (e.g. pve, node1).
upid *Requiredstring
Task UPID
Proxmox Unique Process ID to poll.
password string
Password
Password for ticket-based authentication.
pluginDefaultsRef Non-dynamicstring
Reference (ref) of the pluginDefaults to apply to this task.
port integerstring
8006API port
Defaults to 8006.
timeoutSeconds integerstring
600Timeout in seconds
Maximum time to wait for task completion. Defaults to 600 (10 minutes).
tokenId string
API token ID
Full token identifier in the form user@realm!tokenname (e.g. root@pam!mytoken). Use together with tokenSecret.
tokenSecret string
API token secret
The UUID secret associated with the token ID.
username string
Username
PAM or PVE user in the form user@realm (e.g. root@pam). Required when using ticket-based auth.
verifySsl booleanstring
trueVerify SSL
Validate the server TLS certificate. Defaults to true; set to false only for trusted networks with self-signed Proxmox certificates.