CreateVmSnapshot
Create a snapshot of a virtual machine on an ESXi host.
This task creates a snapshot for a specified VM on an ESXi host.
type: "io.kestra.plugin.ee.vmware.esxi.CreateVmSnapshot"
Examples
Create a snapshot of a VM by name
id: create_vm_snapshot
namespace: company.team
tasks:
- id: createSnapshot
type: io.kestra.plugin.ee.vmware.esxi.CreateVmSnapshot
server: "esxi.mycompany.com"
username: "{{ secret('VMWARE_ESXI_USERNAME') }}"
password: "{{ secret('VMWARE_ESXI_PASSWORD') }}"
vmName: "vm-to-snapshot"
snapshotName: "daily-backup-2025-07-18"
description: "Daily automated backup"
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.
snapshotDescription *Requiredstring
A description for the snapshot.
snapshotName *Requiredstring
The name of the snapshot to be created.
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.
memory booleanstring
false
Include VM memory state in the snapshot.
If true, the snapshot will include the full memory (RAM) state of the VM. This allows an exact restore of the VM as it was, with all processes and sessions. If false, only the disk state will be saved and the VM will boot normally when reverted. Default: false.
port integerstring
443
The port for the connection.
The port to connect to the server. Default is 443.
quiesce booleanstring
false
Quiesce the VM before taking the snapshot.
If true, VMware Tools will pause disk I/O operations before taking the snapshot, ensuring file system consistency (especially useful for DBs or transactional apps). If false, no guarantee on file system consistency is provided. VMware Tools must be installed on the guest for quiescing to work. Default: false.
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.