[Kimchi-devel] [RFC V2 1/3] Implement integrity verification: verify template integrity, update API.md

[shaohef at linux.vnet.ibm.com]

From: ShaoHe Feng <shaohef at linux.vnet.ibm.com>

Sometimes, user create a template, but networks, cdrom, disks or
storagepool will change later.
So users can not create a vm from this template successfully.
It is necessary to check some paramenters of template.

This patch will check the follow paramenters of template.
networks: check networks exists.
cdrom: check cdrom is available.
disks: check the volume is available.

This patch does not check the storagepool exists. waiting for royce's
disks patch.

Signed-off-by: ShaoHe Feng <shaohef at linux.vnet.ibm.com>
---
 docs/API.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/API.md b/docs/API.md
index fff740d..7940cf2 100644
--- a/docs/API.md
+++ b/docs/API.md
@@ -249,6 +249,10 @@ A interface represents available network interface on VM.
                      Independent Computing Environments
             * null: Graphics is disabled or type not supported
         * listen: The network which the vnc/spice server listens on.
+    * invalid: A dict indicates which paramenters of this template are invalid.
+        * networks *(optional)*: A list of invalid network names.
+        * cdrom *(optional)*: A list of invalid cdrom names.
+        * disks *(optional)*: A list of invalid volume names.
 
 * **DELETE**: Remove the Template
 * **POST**: *See Template Actions*
-- 
1.8.4.2