Nutanix ListVms
CertifiedEnterprise EditionList AHV VMs with filters
Nutanix ListVms
List AHV VMs with filters
Retrieve Nutanix AHV VMs via the VMM v4 API with optional OData filter, sorting, selection, and pagination.
Supports fetchType to return one row, full rows, or store large result sets as JSON in internal storage.
type: io.kestra.plugin.ee.nutanix.ahv.ListVmsExamples
List VMs and store the result
id: nutanix_list_vms
namespace: company.team
tasks:
- id: list_vms
type: io.kestra.plugin.ee.nutanix.ahv.ListVms
host: "{{ secret('NUTANIX_HOST') }}"
token: "{{ secret('NUTANIX_TOKEN') }}"
filter: "startswith(name, 'prod-')"
orderBy: "name desc"
fetchType: STORE
Properties
host *Requiredstring
Prism Central host
Required Nutanix Prism Central host or IP address.
fetchType string
FETCHSTOREFETCHFETCH_ONENONEFetch type
How to return results: FETCH (default) for all rows, FETCH_ONE for the first row, or STORE to write JSON to internal storage (kestra://) for large datasets.
filter string
Filter
OData filter expression applied server-side to the VM list.
limit integerstring
Limit
Maximum VMs per page (1-100); optional, uses API default when unset.
orderBy string
Order by
OData orderBy expression for sorting.
page integerstring
Page
Page number (0-based); optional, uses API default when unset.
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.
scheme string
httpsScheme
HTTP scheme (https default) for the Prism Central API.
select string
Select
OData select expression to return specific VM fields.
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.
Outputs
row
Row
First VM row when fetchType is FETCH_ONE.
io.kestra.plugin.ee.nutanix.domain.AhvVm
io.kestra.plugin.ee.nutanix.domain.AhvVm-Resources
rows array
Rows
Full list of VM rows when fetchType is FETCH.
io.kestra.plugin.ee.nutanix.domain.AhvVm
io.kestra.plugin.ee.nutanix.domain.AhvVm-Resources
size integer
Size
Number of VMs returned by the API.
timestamp integer
Timestamp
The timestamp (in milliseconds since epoch) when the operation completed.
uri string
uriURI
Storage URI when fetchType is STORE.
