Apache CloudStack 4.20.0.0 Root Admin API Reference
registerTemplate
Registers an existing template into the CloudStack cloud.
Request parameters
| Parameter Name | Description | Required |
| format | the format for the template. Possible values include QCOW2, RAW, VHD and OVA. | true |
| hypervisor | the target hypervisor for the template | true |
| name | the name of the template | true |
| url | the URL of where the template is hosted. Possible URL include http:// and https:// | true |
| account | an optional accountName. Must be used with domainId. | false |
| arch | the CPU arch of the template. Valid options are: x86_64, aarch64 | false |
| bits | 32 or 64 bits support. 64 by default | false |
| checksum | the checksum value of this template. The parameter containing the checksum will be considered a MD5sum if it is not prefixed and just a plain ascii/utf8 representation of a hexadecimal string. If it is required to use another algorithm the hexadecimal string is to be prefixed with a string of the form, "{<algorithm>}", not including the double quotes. In this <algorithm> is the exact string representing the java supported algorithm, i.e. MD5 or SHA-256. Note that java does not contain an algorithm called SHA256 or one called sha-256, only SHA-256. | false |
| deployasis | (VMware only) true if VM deployments should preserve all the configurations defined for this template | false |
| details | Template details in key/value pairs using format details[i].keyname=keyvalue. Example: details[0].hypervisortoolsversion=xenserver61 | false |
| directdownload | true if template should bypass Secondary Storage and be downloaded to Primary Storage on deployment | false |
| displaytext | The display text of the template, defaults to 'name'. | false |
| domainid | an optional domainId. If the account parameter is used, domainId must also be used. | false |
| isdynamicallyscalable | true if template contains XS/VMWare tools inorder to support dynamic scaling of VM cpu/memory | false |
| isextractable | true if the template or its derivatives are extractable; default is false | false |
| isfeatured | true if this template is a featured template, false otherwise | false |
| ispublic | true if the template is available to all accounts; default is true | false |
| isrouting | true if the template type is routing i.e., if template is used to deploy router | false |
| ostypeid | the ID of the OS Type that best represents the OS of this template. Not applicable with VMware, as we honour what is defined in the template | false |
| passwordenabled | true if the template supports the password reset feature; default is false | false |
| projectid | Register template for the project | false |
| requireshvm | true if this template requires HVM | false |
| sshkeyenabled | true if the template supports the sshkey upload feature; default is false | false |
| templatetag | the tag for this template. | false |
| templatetype | the type of the template. Valid options are: USER/VNF (for all users) and SYSTEM/ROUTING/BUILTIN (for admins only). | false |
| zoneid | the ID of the zone the template is to be hosted on | false |
| zoneids | A list of zone ids where the template will be hosted. Use this parameter if the template needs to be registered to multiple zones in one go. Use zoneid if the template needs to be registered to only one zone.Passing only -1 to this will cause the template to be registered as a cross zone template and will be copied to all zones. | 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 |
| arch | CPU Arch of the template |
| bits | the processor bit size |
| bootable | true if the ISO is bootable, false otherwise |
| checksum | checksum of the template |
| childtemplates | if root disk template, then ids of the datas disk templates this template owns |
| created | the date this template was created |
| crossZones | true if the template is managed across all Zones, false otherwise |
| deployasis | VMware only: true if template is deployed without orchestrating disks and networks but "as-is" defined in the template. |
| deployasisdetails | VMware only: additional key/value details tied with deploy-as-is template |
| details | additional key/value details tied with template |
| directdownload | KVM Only: true if template is directly downloaded to Primary Storage bypassing Secondary Storage |
| 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 |
| domainpath | path of the Domain the template belongs to |
| downloaddetails | Lists the download progress of a template across all secondary storages |
| 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 |
| icon | Base64 string representation of the resource icon |
| isdynamicallyscalable | true if template contains XS/VMWare 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. |
| name | the template name |
| ostypeid | the ID of the OS type for this template. |
| ostypename | the name of the OS type for this template. |
| parenttemplateid | if Datadisk template, then id of the root disk template this template belongs to |
| passwordenabled | true if the reset password feature is enabled, false otherwise |
| physicalsize | the physical size of the template |
| project | the project name of the template |
| projectid | the project id of the template |
| removed | the date this template was removed |
| requireshvm | true if template requires HVM enabled, false otherwise |
| 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 which the template/iso is registered from |
| userdataid | the id of userdata linked to this template |
| userdataname | the name of userdata linked to this template |
| userdataparams | list of parameters which contains the list of keys or string parameters that are needed to be passed for any variables declared in userdata |
| userdatapolicy | the userdata override policy with the userdata provided while deploying VM |
| zoneid | the ID of the zone for this template |
| zonename | the name of the zone for this template |
| 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 |