Cosmic Admin API Reference

registerIso

Registers an existing ISO into the CloudStack Cloud.

Request parameters

Parameter Name	Description	Required
displaytext	the display text of the ISO. This is usually used for display purposes.	true
name	the name of the ISO	true
url	the URL to where the ISO is currently being hosted	true
zoneid	the ID of the zone you wish to register the ISO to.	true
account	an optional account name. Must be used with domainId.	false
bootable	true if this ISO is bootable. If not passed explicitly its assumed to be true	false
checksum	the MD5 checksum value of this ISO	false
domainid	an optional domainId. If the account parameter is used, domainId must also be used.	false
imagestoreuuid	Image store UUID	false
isdynamicallyscalable	true if ISO contains XS tools inorder to support dynamic scaling of VM CPU/memory	false
isextractable	true if the ISO or its derivatives are extractable; default is false	false
isfeatured	true if you want this ISO to be featured	false
ispublic	true if you want to register the ISO to be publicly available to all users, false otherwise.	false
maintenancepolicy	either 'LiveMigrate' or 'ShutdownAndStart' when performing hypervisor maintenance	false
manufacturerstring	Manufacturer String to put in hardware info, defaults to 'Mission Critical Cloud'	false
optimisefor	Optimise for 'Windows' or 'Generic'	false
ostypeid	the ID of the OS type that best represents the OS of this ISO. If the ISO is bootable this parameter needs to be passed	false
projectid	Register ISO for the project	false

Response Tags

Response Name	Description
id	the template ID
account	the account name to which the template belongs
accountid	the account id to which the template belongs
bootable	true if the ISO is bootable, false otherwise
checksum	checksum of the template
cpuflags	Any CPU flags to pass to VM
created	the date this template was created
crossZones	true if the template is managed across all Zones, false otherwise
details	additional key/value details tied with template
displaytext	the template display text
domain	the name of the domain to which the template belongs
domainid	the ID of the domain to which the template belongs
format	the format of the template.
hostid	the ID of the secondary storage host for the template
hostname	the name of the secondary storage host for the template
hypervisor	the hypervisor on which the template runs
isdynamicallyscalable	true if template contains XS tools inorder to support dynamic scaling of VM cpu/memory
isextractable	true if the template is extractable, false otherwise
isfeatured	true if this template is a featured template, false otherwise
ispublic	true if this template is a public template, false otherwise
isready	true if the template is ready to be deployed from, false otherwise.
isremotegatewaytemplate	true if the template is allowed to take the network gateway ip, false otherwise
maclearning	Enable MAC learning true or false
maintenancepolicy	The maintenance policy for the VM
manufacturerstring	Manufacturer string in hardware
name	the template name
optimisefor	Optimise for Generic of Windows VMs
ostypeid	the ID of the OS type for this template.
ostypename	the name of the OS type for this template.
passwordenabled	true if the reset password feature is enabled, false otherwise
project	the project name of the template
projectid	the project id of the template
removed	the date this template was removed
size	the size of the template
sourcetemplateid	the template ID of the parent template if present
sshkeyenabled	true if template is sshkey enabled, false otherwise
status	the status of the template
templatetag	the tag of this template
templatetype	the type of the template
url	The URL where the templates originally was downloaded from
zoneid	the ID of the zone for this template
zonename	the name of the zone for this template
*tags()**	the list of resource tags associated with tempate
account	the account associated with the tag
customer	customer associated with the tag
domain	the domain associated with the tag
domainid	the ID of the domain associated with the tag
key	tag key name
project	the project name where tag belongs to
projectid	the project id the tag belongs to
resourceid	id of the resource
resourcetype	resource type
value	tag value
jobid	the ID of the latest async job acting on this object
jobstatus	the current status of the latest async job acting on this object