From: Daniel Henrique Barboza <danielhb(a)linux.vnet.ibm.com>
This patch changes API.md with new storage sub-collection/sub-resource
information.
Signed-off-by: Royce Lv <lvroyce(a)linux.vnet.ibm.com>
Signed-off-by: Rodrigo Trujillo <rodrigo.trujillo(a)linux.vnet.ibm.com>
Excluding hard drive support from docs/API.md
Adding externalized string to be used in the new exception
model
Signed-off-by: Daniel Henrique Barboza <danielhb(a)linux.vnet.ibm.com>
---
docs/API.md | 21 +++++++++++++++++++++
src/kimchi/i18n.py | 11 +++++++++++
2 files changed, 32 insertions(+)
diff --git a/docs/API.md b/docs/API.md
index 89acd44..2b60d52 100644
--- a/docs/API.md
+++ b/docs/API.md
@@ -117,6 +117,27 @@ Represents a snapshot of the Virtual Machine's primary monitor.
* **GET**: Redirect to the latest screenshot of a Virtual Machine in PNG format
+
+### Sub-collection: Virtual Machine storages
+**URI:** /vms/*:name*/storages
+* **GET**: Retrieve a summarized list of all storages of specified guest
+* **POST**: Attach a new storage or virtual drive to specified virtual machine.
+ * dev: The name of the storage in the vm.
+ * type: The type of the storage (currently supports 'cdrom' only).
+ * path: Path of cdrom iso.
+
+### Sub-resource: storage
+**URI:** /vms/*:name*/storages/*:dev*
+* **GET**: Retrieve storage information
+ * dev: The name of the storage in the vm.
+ * type: The type of the storage ('cdrom' only for now).
+ * path: Path of cdrom iso.
+* **PUT**: Update storage information
+ * path: Path of cdrom iso. Can not be blank.
+* **DELETE**: Remove the storage.
+
+
+
### Collection: Templates
**URI:** /templates
diff --git a/src/kimchi/i18n.py b/src/kimchi/i18n.py
index d3f9fcf..b9ee5ae 100644
--- a/src/kimchi/i18n.py
+++ b/src/kimchi/i18n.py
@@ -185,4 +185,15 @@ messages = {
"KCHUTILS0001E": _("Invalid URI %(uri)s"),
"KCHUTILS0002E": _("Timeout while running command '%(cmd)s'
after %(seconds)s seconds"),
"KCHUTILS0003E": _("Unable to choose a virutal machine name"),
+ "KCHCDROM0001E": _("Invalid cd-rom device name"),
+ "KCHCDROM0002E": _("Invalid storage type. Types supported:
'cdrom'"),
+ "KCHCDROM0003E": _("CDROM path must be a valid filesystem, http or ftp
path"),
+ "KCHCDROM0004E": _("Device name %(dev_name)s already exists in vm
%(vm_name)s"),
+ "KCHCDROM0005E": _("%(path)s is not valid local/remote path for the
device"),
+ "KCHCDROM0006E": _("Can't specify a directory for a cd-rom device
path"),
+ "KCHCDROM0007E": _("The storage device %(dev_name)s does not exist in
the guest %(vm_name)s"),
+ "KCHCDROM0008E": _("Must specify a device name"),
+ "KCHCDROM0009E": _("Error while updating storage device:
%(error)s"),
+ "KCHCDROM0010E": _("Error while removing storage device:
%(error)s"),
+ "KCHCDROM0011E": _("Error while creating new storage device:
%(error)s"),
}
--
1.8.3.1