Apache CloudStack v4.5.0 User API Reference

registerTemplate

Registers an existing template into the CloudStack cloud.

Request parameters

Parameter NameDescriptionRequired
displaytextthe display text of the template. This is usually used for display purposes.true
formatthe format for the template. Possible values include QCOW2, RAW, and VHD.true
hypervisorthe target hypervisor for the templatetrue
namethe name of the templatetrue
ostypeidthe ID of the OS Type that best represents the OS of this template.true
urlthe URL of where the template is hosted. Possible URL include http:// and https://true
zoneidthe ID of the zone the template is to be hosted ontrue
accountan optional accountName. Must be used with domainId.false
bits32 or 64 bits support. 64 by defaultfalse
checksumthe MD5 checksum value of this templatefalse
detailsTemplate details in key/value pairs.false
domainidan optional domainId. If the account parameter is used, domainId must also be used.false
isdynamicallyscalabletrue if template contains XS/VMWare tools inorder to support dynamic scaling of VM cpu/memoryfalse
isextractabletrue if the template or its derivatives are extractable; default is falsefalse
isfeaturedtrue if this template is a featured template, false otherwisefalse
ispublictrue if the template is available to all accounts; default is truefalse
isroutingtrue if the template type is routing i.e., if template is used to deploy routerfalse
passwordenabledtrue if the template supports the password reset feature; default is falsefalse
projectidRegister template for the projectfalse
requireshvmtrue if this template requires HVMfalse
sshkeyenabledtrue if the template supports the sshkey upload feature; default is falsefalse
templatetagthe tag for this template.false

Response Tags

Response NameDescription
idthe template ID
accountthe account name to which the template belongs
accountidthe account id to which the template belongs
bootabletrue if the ISO is bootable, false otherwise
checksumchecksum of the template
createdthe date this template was created
crossZonestrue if the template is managed across all Zones, false otherwise
detailsadditional key/value details tied with template
displaytextthe template display text
domainthe name of the domain to which the template belongs
domainidthe ID of the domain to which the template belongs
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
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.
passwordenabledtrue if the reset password feature is enabled, false otherwise
projectthe project name of the template
projectidthe project id of the template
removedthe date this template was removed
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
zoneidthe ID of the zone for this template
zonenamethe name of the zone for this template
tags(*)the list of resource tags associated with tempate
accountthe account associated with the tag
customercustomer associated with the tag
domainthe domain associated with the tag
domainidthe ID of the domain associated with the tag
keytag key name
projectthe project name where tag belongs to
projectidthe project id the tag belongs to
resourceidid of the resource
resourcetyperesource type
valuetag value
jobidthe ID of the latest async job acting on this object
jobstatusthe current status of the latest async job acting on this object