Nutanix CreateVm
CertifiedEnterprise EditionCreate AHV VM (optionally power on)
Nutanix CreateVm
Create AHV VM (optionally power on)
Create a Nutanix AHV VM via the VMM v4 API using a full VM payload; can power on immediately, optionally wait for an IP, and returns the async task extId.
type: io.kestra.plugin.ee.nutanix.ahv.CreateVmExamples
Create an AHV VM
id: nutanix_create_vm
namespace: company.team
tasks:
- id: create_vm
type: io.kestra.plugin.ee.nutanix.ahv.CreateVm
host: "{{ secret('NUTANIX_HOST') }}"
username: "{{ secret('NUTANIX_USERNAME') }}"
password: "{{ secret('NUTANIX_PASSWORD') }}"
vm:
name: "kestra-demo"
description: "VM created by Kestra"
cluster:
extId: "{{ secret('NUTANIX_CLUSTER_EXT_ID') }}"
resources:
numSockets: 1
numCoresPerSocket: 2
memorySizeBytes: 2147483648
disks: []
Properties
host *string
Prism Central host
Required Nutanix Prism Central host or IP address.
vm *string
VM definition
Full AHV VM payload compatible with the VMM v4 API.
io.kestra.plugin.ee.nutanix.domain.AhvVm
io.kestra.plugin.ee.nutanix.domain.AhvVm-Resources
assets
Assets this task consumes as inputs or produces as outputs, for lineage tracking and the asset graph (Enterprise Edition). A flow declaring this property on a task is rejected in the open-source edition.
io.kestra.core.models.assets.AssetsDeclaration
IGNOREFAILWARNAsset failure behavior
Behavior applied to the task state when a declared asset fails to render, emit, or be persisted (e.g. a lock conflict): FAIL escalates it to FAILED, WARN (default) warns it if it would otherwise succeed, IGNORE leaves the state untouched.
Whether to auto-register assets referenced dynamically at runtime that are not statically declared in inputs or outputs.
The assets consumed as inputs.
io.kestra.core.models.assets.AssetIdentifier
1The assets produced as outputs.
io.kestra.plugin.ee.assets.Dataset
1150{}1150io.kestra.plugin.ee.assets.File
1150{}1150io.kestra.plugin.ee.assets.Table
1150{}1150io.kestra.plugin.ee.assets.VM
1150{}1150io.kestra.core.models.assets.External
1150{}1150io.kestra.core.models.assets.Custom
11501Custom asset type
{}1150password string
Password
Prism Central password; required when no token is provided.
port integerstring
9440Prism Central port
API port for Prism Central; defaults to 9440.
powerOn booleanstring
falsePower on
Whether to power on the VM as part of the creation request; defaults to false.
scheme string
httpsScheme
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
trueVerify 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.
wait booleanstring
falseWait for VM creation synchronously
Whether to wait for the VM to be created and return its IP address.
When enabled, the task will poll for the VM by name and return the first IPv4 address found.
Only works with powerOn set to true (the IP will be available only once the VM is powered on).
waitInterval string
PT5SWait interval
How long to pause between IP address polls when wait is enabled, default 5 seconds.
waitTimeout string
PT5MWait timeout
How long to keep polling for the VM IP address when wait is enabled, default 5 minutes.
Polling occupies a worker thread for this long, so lower it if the worker pool is contended.
Outputs
taskExtId string
Task extId
ExtId of the asynchronous VM creation task.
timestamp integer
Timestamp
The timestamp (in milliseconds since epoch) when the operation completed.
vm
VM
Minimal VM payload including the IP address when wait is enabled.
