Full VM Recovery Fails Due to Proxmox API Duplicate Parameter Conflict

Product version: 11.1

Last modified: 29 April 2026

Problem

Full VM Recovery job fails when restoring a virtual machine to a Proxmox VE environment. The failure typically occurs during the stage when the system attempts to power on the recovered VM. The job log may contain an error similar to:

Proxmox API conflict ("duplicate parameter")

As a result, the recovery job stops, and the virtual machine is not powered on.

Background

During a Full VM Recovery, the system communicates with the Proxmox API to create and start the recovered virtual machine in the target environment.

If the target environment already contains a VM with the same name or VMID, the Proxmox API may detect a parameter conflict during the VM power-on operation and reject the request. This results in the duplicate parameter error and causes the recovery job to fail.

Solution

To work around the issue, apply the following steps:

  1. Edit the Full VM Recovery job.

  2. Enable the option Do not power on recovered VMs.

  3. Run the recovery job again.

  4. After the VM is successfully restored, power it on from the Proxmox interface.

  5. Additionally, ensure that the target recovery environment does not contain another VM with the same name or VMID as the recovered VM. This helps prevent API conflicts during the recovery process.