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 *Requiredstring
Prism Central host
Required Nutanix Prism Central host or IP address.
vm *Requiredstring
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.
pluginDefaultsRef Non-dynamicstring
Reference (ref) of the pluginDefaults to apply to this task.
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).
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.
