RestoreVmFromSnapshot
Restore a VM to a given snapshot on an ESXi host.
This task reverts a virtual machine to a specified snapshot using the ESXi API.
type: "io.kestra.plugin.ee.vmware.esxi.RestoreVmFromSnapshot"
Examples
Restore a VM to a named snapshot
id: restore_vm_snapshot
namespace: company.team
tasks:
- id: restoreSnapshot
type: io.kestra.plugin.ee.vmware.esxi.RestoreVmFromSnapshot
server: "esxi.mycompany.com"
username: "{{ secret('VMWARE_ESXI_USERNAME') }}"
password: "{{ secret('VMWARE_ESXI_PASSWORD') }}"
vmName: "my-vm"
snapshotName: "daily-backup-2025-07-18"
Properties
password *Requiredstring
The password for authentication.
The password used to authenticate with the VMware server.
server *Requiredstring
The URL of the server.
The URL to connect to the VMwareserver. This is a FQDN or an IP address (eg: esxi.mycompany.com), so without any protocol nor port.
snapshotName *Requiredstring
The name of the snapshot to restore.
username *Requiredstring
The username for authentication.
The username used to authenticate with the server. It could be something like '[email protected]' for vCenter or 'root' for ESXi.
vmName *Requiredstring
The name of the virtual machine.
port integerstring
443
The port for the connection.
The port to connect to the server. Default is 443.
suppressPowerOn booleanstring
true
Whether to suppress VM power-on after the restore.
If true (default), the VM will remain powered off after reverting to the snapshot. If false, the VM will be automatically powered on after the restore completes.
trustStorePath string
The path to the trust store file.
The path to the trust store file containing certificates for secure connections. If not provided, an empty keystore will be created and the connection will be insecure.