Parameter Name | Description | Required |
account | list resources by account. Must be used with the domainId parameter. | false |
affinitygroupid | list vms by affinity group | false |
details | comma separated list of host details requested, value can be a list of [all, group, nics, stats, secgrp, tmpl, servoff, diskoff, iso, volume, min, affgrp]. If no parameter is passed in, the details will be defaulted to all | false |
displayvm | list resources by display flag; only ROOT admin is eligible to pass this parameter | false |
domainid | list only resources belonging to the domain specified | false |
forvirtualnetwork | list by network type; true if need to list vms using Virtual Network, false otherwise | false |
groupid | the group ID | false |
haenable | list by the High Availability offering; true if filtering VMs with HA enabled; false for VMs with HA disabled | false |
hostid | the host ID | false |
hypervisor | the target hypervisor for the template | false |
id | the ID of the virtual machine | false |
ids | the IDs of the virtual machines, mutually exclusive with id | false |
isoid | list vms by iso | false |
isrecursive | defaults to false, but if true, lists all resources from the parent specified by the domainId till leaves. | false |
keypair | list vms by ssh keypair name | false |
keyword | List by keyword | false |
listall | If set to false, list only resources belonging to the command's caller; if set to true - list resources that the caller is authorized to see. Default value is false | false |
name | name of the virtual machine (a substring match is made against the parameter value, data for all matching VMs will be returned) | false |
networkid | list by network id | false |
page | | false |
pagesize | | false |
podid | the pod ID | false |
projectid | list objects by project | false |
securitygroupid | the security group ID | false |
serviceofferingid | list by the service offering | false |
state | state of the virtual machine. Possible values are: Running, Stopped, Present, Destroyed, Expunged. Present is used for the state equal not destroyed. | false |
storageid | the storage ID where vm's volumes belong to | false |
tags | List resources by tags (key/value pairs) | false |
templateid | list vms by template | false |
userid | the user ID that created the VM and is under the account that owns the VM | false |
vpcid | list vms by vpc | false |
zoneid | the availability zone ID | false |