Apache CloudStack 4.20.0.0 Root Admin API Reference

listIsos

Lists all available ISO files.

Request parameters

Parameter NameDescriptionRequired
accountlist resources by account. Must be used with the domainId parameter.false
archthe CPU arch of the ISO. Valid options are: x86_64, aarch64false
bootabletrue if the ISO is bootable, false otherwisefalse
domainidlist only resources belonging to the domain specifiedfalse
hypervisorthe hypervisor for which to restrict the searchfalse
idlist ISO by IDfalse
imagestoreidID of the image or image cache storefalse
isofilterpossible values are "featured", "self", "selfexecutable","sharedexecutable","executable", and "community". * featured : templates that have been marked as featured and public. * self : templates that have been registered or created by the calling user. * selfexecutable : same as self, but only returns templates that can be used to deploy a new VM. * sharedexecutable : templates ready to be deployed that have been granted to the calling user by another user. * executable : templates that are owned by the calling user, or public templates, that can be used to deploy a VM. * community : templates that have been marked as public but not featured. * all : all templates (only usable by admins).false
ispublictrue if the ISO is publicly available to all users, false otherwise.false
isreadytrue if this ISO is ready to be deployedfalse
isrecursivedefaults to false, but if true, lists all resources from the parent specified by the domainId till leaves.false
keywordList by keywordfalse
listallIf 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. Resources dedicated to a project are listed only if using the projectid parameter.false
namelist all ISOs by namefalse
pagefalse
pagesizefalse
projectidlist objects by project; if projectid=-1 lists All VMsfalse
showiconflag to display the resource image for the isosfalse
showremovedshow removed ISOs as wellfalse
showuniqueIf set to true, list only unique isos across zonesfalse
storageidID of the storage poolfalse
tagsList resources by tags (key/value pairs)false
zoneidthe ID of the zonefalse

Response Tags

Response NameDescription
idthe template ID
accountthe account name to which the template belongs
accountidthe account id to which the template belongs
archCPU Arch of the template
bitsthe processor bit size
bootabletrue if the ISO is bootable, false otherwise
checksumchecksum of the template
childtemplatesif root disk template, then ids of the datas disk templates this template owns
createdthe date this template was created
crossZonestrue if the template is managed across all Zones, false otherwise
deployasisVMware only: true if template is deployed without orchestrating disks and networks but "as-is" defined in the template.
deployasisdetailsVMware only: additional key/value details tied with deploy-as-is template
detailsadditional key/value details tied with template
directdownloadKVM Only: true if template is directly downloaded to Primary Storage bypassing Secondary Storage
displaytextthe template display text
domainthe name of the domain to which the template belongs
domainidthe ID of the domain to which the template belongs
domainpathpath of the Domain the template belongs to
downloaddetailsLists the download progress of a template across all secondary storages
formatthe format of the template.
hostidthe ID of the secondary storage host for the template
hostnamethe name of the secondary storage host for the template
hypervisorthe hypervisor on which the template runs
iconBase64 string representation of the resource icon
isdynamicallyscalabletrue if template contains XS/VMWare tools inorder to support dynamic scaling of VM cpu/memory
isextractabletrue if the template is extractable, false otherwise
isfeaturedtrue if this template is a featured template, false otherwise
ispublictrue if this template is a public template, false otherwise
isreadytrue if the template is ready to be deployed from, false otherwise.
namethe template name
ostypeidthe ID of the OS type for this template.
ostypenamethe name of the OS type for this template.
parenttemplateidif Datadisk template, then id of the root disk template this template belongs to
passwordenabledtrue if the reset password feature is enabled, false otherwise
physicalsizethe physical size of the template
projectthe project name of the template
projectidthe project id of the template
removedthe date this template was removed
requireshvmtrue if template requires HVM enabled, false otherwise
sizethe size of the template
sourcetemplateidthe template ID of the parent template if present
sshkeyenabledtrue if template is sshkey enabled, false otherwise
statusthe status of the template
templatetagthe tag of this template
templatetypethe type of the template
urlthe URL which the template/iso is registered from
userdataidthe id of userdata linked to this template
userdatanamethe name of userdata linked to this template
userdataparamslist of parameters which contains the list of keys or string parameters that are needed to be passed for any variables declared in userdata
userdatapolicythe userdata override policy with the userdata provided while deploying VM
zoneidthe ID of the zone for this template
zonenamethe name of the zone for this template
jobidthe ID of the latest async job acting on this object
jobstatusthe current status of the latest async job acting on this object