Nutanix ConvertTemplateToVm

Nutanix ConvertTemplateToVm

Certified
Enterprise Edition

Deploy AHV VMs from template

Deploy one or more Nutanix AHV VMs from a template via the VMM v4 API, using a TemplateDeployment payload and returning the async task extId.

yaml
type: io.kestra.plugin.ee.nutanix.ahv.ConvertTemplateToVm

Deploy a VM from a template

yaml
id: nutanix_convert_template_to_vm
namespace: company.team
tasks:
  - id: convert_template_to_vm
    type: io.kestra.plugin.ee.nutanix.ahv.ConvertTemplateToVm
    host: "{{ secret('NUTANIX_HOST') }}"
    token: "{{ secret('NUTANIX_TOKEN') }}"
    templateExtId: "{{ secret('NUTANIX_TEMPLATE_EXT_ID') }}"
    deployment:
      clusterReference: "{{ secret('NUTANIX_CLUSTER_EXT_ID') }}"
      numberOfVms: 1
Properties

Deployment configuration

Required deployment configuration compatible with the TemplateDeployment payload (cluster, count, overrides).

Definitions
clusterReferencestring
numberOfVmsinteger
overrideVmConfigMapobject
guestCustomizationobject
memorySizeBytesinteger
namestring
nicsarray
SubTypeobject
numCoresPerSocketinteger
numSocketsinteger
numThreadsPerCoreinteger
versionIdstring

Prism Central host

Required Nutanix Prism Central host or IP address.

Template extId

Required extId of the source template to deploy.

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.

Definitions
assetFailureBehaviorstring
Possible Values
IGNOREFAILWARN

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

enableAutobooleanstring

Whether to auto-register assets referenced dynamically at runtime that are not statically declared in inputs or outputs.

inputsarray

The assets consumed as inputs.

id*string
Min length1
typestring
outputs

The assets produced as outputs.

id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*string
Min length1

Custom asset type

descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150

Password

Prism Central password; required when no token is provided.

Default9440

Prism Central port

API port for Prism Central; defaults to 9440.

Defaulthttps

Scheme

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

Bearer token

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

Username

Prism Central username; required when no token is provided.

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.

Task extId

ExtId of the asynchronous deployment task.

Timestamp

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