URL:

https://api.liquidweb.com/v1/Cloud/Template/details

Description:

Get information about a specific template. You can query details about inactive templates because backups, existing servers, and images might be tied to one, but you cannot provision to or restore an inactive template. You can, however, restore from a deprecated template.

Here's a rundown of what those fields mean:

	active: a flag indicating whether the template is currently active.  You can
	only create or reimage servers to active templates.

	deprecated: a flag indicating whether the template has been deprecated.
	This means it can't be used for new creates, but can be used to restore
	from backups or images.

	description: the descriptive OS template name

	id: the id of the template

	manage_level: 'self', 'core', or 'full', determined by which template you
	chose when creating the server

		self: Includes support for hardware, network and virtualization layers.

		core: Includes complete support of the base operating system as well as
		Apache, Mysql and PHP. Proactive service restoration is provided.

		full: Includes cPanel + Fantastico as well complete support of base
		operating system and all cPanel services. Proactive service restoration
		is provided.

	name: a unique identifier for the template, used in methods like
	server/create

	os: an internal OS identifier.  There can be multiple templates that have
	the same OS, but differ in other ways (like management level).

Parameters:

Parameter	Type	Notes
id	A positive integer value (i.e. 1 and up).	* Required if: template is not given
template	A string permitting tabs, carriage returns and newlines	* Required if: id is not given

Returns:

Field	Type
deprecated	A boolean value (0 or 1).
description	A string permitting tabs, carriage returns and newlines
id	A positive integer value (i.e. 1 and up).
manage_level	A single word, consisting of only letters and digits.
name	A single word, consisting of only letters, digits, hyphens, and underscores.
os	A single word, consisting of only letters, digits, hyphens, and underscores.
zone_availability	An associative array of arbitrary keys and values.

Possible Errors:

Refer to the Error Handling documentation for the list of exception types

URL:

https://api.liquidweb.com/v1/Cloud/Template/list

Description:

Get a list of useable templates. More information about the fields returned can be found in the documenation for server/template/details

This method returns templates that are currently active, including deprecated templates which may not be used for new instances but may be associated with existing servers or backups.

Parameters:

Parameter	Type	Notes
page_num	A positive integer value (i.e. 1 and up).	* Optional Defaults to: 1
page_size	A positive integer value (i.e. 1 and up).	* Optional Defaults to: 25

Returns:

Field	Type
item_count	A non-negative integer value (i.e. 0 and up).
item_total	A non-negative integer value (i.e. 0 and up).
items	An array of associative arrays containing
	deprecated A boolean value (0 or 1). description A string permitting tabs, carriage returns and newlines id A positive integer value (i.e. 1 and up). manage_level A single word, consisting of only letters and digits. name A single word, consisting of only letters, digits, hyphens, and underscores. os A single word, consisting of only letters, digits, hyphens, and underscores. zone_availability An associative array of arbitrary keys and values.
page_num	A positive integer value (i.e. 1 and up).
page_size	A positive integer value (i.e. 1 and up).
page_total	A positive integer value (i.e. 1 and up).

Possible Errors:

Refer to the Error Handling documentation for the list of exception types

URL:

https://api.liquidweb.com/v1/Cloud/Template/restore

Description:

Re-images a server with the template requested. If the 'force' flag is passed it will rebuild the filesystem on the server before restoring. This option is not usually needed, but if regular restores are failing, it can fix some scenarios.

Parameters:

Parameter	Type	Notes
force	A boolean value (0 or 1).
id	A positive integer value (i.e. 1 and up).	* Required if: template is not given
template	A string permitting tabs, carriage returns and newlines	* Required if: id is not given
uniq_id	A six-character identifier, containing only capital letters and digits.	* Required

Returns:

Field	Type
reimaged	A six-character identifier, containing only capital letters and digits.

Possible Errors:

Refer to the Error Handling documentation for the list of exception types