[Kimchi-devel] [PATCH 1/5] clone template: update API.md

[Aline Manera]

On 02/11/2014 11:58 AM, shaohef at linux.vnet.ibm.com wrote:
> From: ShaoHe Feng <shaohef at linux.vnet.ibm.com>
>
> The user may clone a template from an existing template with different
> name.
> He can update some attributes when he clone a template.
> And he can also customize some parts of the template to save the effort to
> create a full new template later.
>
> Signed-off-by: ShaoHe Feng <shaohef at linux.vnet.ibm.com>
> ---
>   docs/API.md | 27 ++++++++++++++++++++++++++-
>   1 file changed, 26 insertions(+), 1 deletion(-)
>
> diff --git a/docs/API.md b/docs/API.md
> index 580728c..bf4dd78 100644
> --- a/docs/API.md
> +++ b/docs/API.md
> @@ -257,7 +257,32 @@ A interface represents available network interface on VM.
>
>   **Actions (POST):**
>
> -* *No actions defined*
> +* clone: clone a template from an existing template with different name.

To clone a template the user just need to pass the template name to 
clone from.

So I expect:
POST /templates {template: /templates/my-template}

This will create a new template based on /templates/my-template

To change the parameters in new template user can use the edit function.

> +    * name *(optional)*: A name for the new template.
> +    * folder *(optional)*: A virtual path which can be used to organize Templates
> +      in a user interface.  The format is an array of path components.
> +    * icon *(optional)*: A URI to a PNG image representing this template
> +    * os_distro *(optional)*: The operating system distribution
> +    * os_version *(optional)*: The version of the operating system distribution
> +    * cpus *(optional)*: The number of CPUs assigned to the VM
> +    * memory *(optional)*: The amount of memory assigned to the VM
> +    * cdrom *(optional)*: A volume name or URI to an ISO image
> +    * storagepool *(optional)*: URI of the storagepool where template allocates
> +      vm storage.
> +    * networks *(optional)*: list of networks will be assigned to the new VM.
> +    * disks *(optional)*: An array of requested disks with the following optional
> +      fields (either *size* or *volume* must be specified):
> +        * index: The device index
> +        * size: The device size in GB
> +        * volume: A volume name that contains the initial disk contents
> +    * graphcis *(optional)*: A dict of graphics paramenters of this template
> +        * type: The type of graphics. It can be VNC or spice or None.
> +            * vnc: Graphical display using the Virtual Network
> +                   Computing protocol
> +            * spice: Graphical display using the Simple Protocol for
> +                     Independent Computing Environments
> +            * null: Graphics is disabled or type not supported
> +        * listen: The network which the vnc/spice server listens on.
>
>   ### Collection: Storage Pools
>