Nutanix CreateVmSnapshot

Nutanix CreateVmSnapshot
Certified
Enterprise Edition
Create AHV VM snapshot

Create a Nutanix AHV VM recovery point via the dataprotection v4 API; supports crash- or application-consistent modes (default crash-consistent), optional expiration, and returns snapshot/task identifiers.

yaml
type: io.kestra.plugin.ee.nutanix.snapshot.CreateVmSnapshot

Examples

Create a crash-consistent VM snapshot

yaml
id: nutanix_create_vm_snapshot
namespace: company.team
tasks:
  - id: create_vm_snapshot
    type: io.kestra.plugin.ee.nutanix.snapshot.CreateVmSnapshot
    host: "{{ secret('NUTANIX_HOST') }}"
    token: "{{ secret('NUTANIX_TOKEN') }}"
    vmExtId: "{{ secret('NUTANIX_VM_EXT_ID') }}"
    snapshotName: "daily-backup-{{ now() | date('yyyyMMdd') }}"
    consistency: CRASH_CONSISTENT

Properties

host *string

Prism Central host

Required Nutanix Prism Central host or IP address.

snapshotName *string

Snapshot name

Name of the recovery point to create.

vmExtId *string

VM extId

Required extId of the VM to snapshot.

apiVersion string

Defaultv4.0.a4

Dataprotection API version

Dataprotection API version to use for recovery point operations.

consistency string

DefaultCRASH_CONSISTENT

Possible Values

CRASH_CONSISTENTAPPLICATION_CONSISTENT

Snapshot consistency

Consistency level; defaults to CRASH_CONSISTENT. APPLICATION_CONSISTENT requires guest tools to quiesce I/O and may take longer or fail if the guest cannot flush.

expirationTime string

Expiration time

Optional expiration timestamp in ISO-8601 format (e.g., 2025-12-31T23: 59: 59Z).

password string

Password

Prism Central password; required when no token is provided.

pluginDefaultsRef string

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

port integerstring

Default9440

Prism Central port

API port for Prism Central; defaults to 9440.

scheme string

Defaulthttps

Scheme

HTTP scheme (https default) for the Prism Central API.

token string

Bearer token

Bearer token for Prism Central; when set, username/password are optional.

username string

Username

Prism Central username; required when no token is provided.

verifySsl booleanstring

Defaulttrue

Verify SSL

Whether to verify SSL certificates; defaults to true. Disabling this (setting to false) causes the client to trust all certificates without validation, exposing connections to man-in-the-middle attacks. Only set to false for trusted, isolated test environments, never in production.

Outputs

snapshotExtId string

Snapshot extId

ExtId of the created snapshot when returned by the API.

taskExtId string

Task extId

ExtId of the asynchronous task when the API returns a task reference.

timestamp integer

Timestamp

The timestamp (in milliseconds since epoch) when the operation completed.