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
password 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.
