瀏覽代碼

更新文档

James Iter 9 年之前
父節點
當前提交
cccb7a900e
共有 2 個文件被更改,包括 66 次插入0 次删除
  1. 49 0
      docs/guest.md
  2. 17 0
      tests/test_guest.py

+ 49 - 0
docs/guest.md

@@ -372,5 +372,54 @@ PUT https://$domain
 ```
 
 
+## 添加磁盘
+> 为 Guest 添加磁盘
+
+``` http
+PUT https://$domain
+  /api/guest/_attach_disk/{uuid}/{disk_uuid}
+```
+
+|参数名称|必须|类型|说明|
+|:--|:--:|:--:|:--|
+|uuid|Y|String|欲添加磁盘的Guest的uuid|
+|disk_uuid|Y|String|将添加至Guest的磁盘uuid|
+
+响应示例
+``` json
+{
+    "state": {
+        "en-us": "OK",
+        "zh-cn": "成功",
+        "code": "200"
+    }
+}
+```
+
+
+## 分离磁盘
+> 从 Guest 分离磁盘。系统通过磁盘的uuid,可得到具体Guest的uuid。
+
+``` http
+PUT https://$domain
+  /api/guest/_detach_disk/{disk_uuid}
+```
+
+|参数名称|必须|类型|说明|
+|:--|:--:|:--:|:--|
+|disk_uuid|Y|String|将被分离的磁盘uuid|
+
+响应示例
+``` json
+{
+    "state": {
+        "en-us": "OK",
+        "zh-cn": "成功",
+        "code": "200"
+    }
+}
+```
+
+
 [返回上一级](../README.md)
 ===

+ 17 - 0
tests/test_guest.py

@@ -209,6 +209,23 @@ class TestGuest(unittest.TestCase):
     #     j_r = json.loads(r.content)
     #     print json.dumps(j_r, ensure_ascii=False)
 
+    # def test_58_attach_disk(self):
+    #     TestGuest.disk_uuid = '234670cb-3ce4-4ef9-ba23-12bed636184c'
+    #     url = TestGuest.base_url + '/guest/_attach_disk/' + TestGuest.uuid + '/' + TestGuest.disk_uuid
+    #     headers = {'content-type': 'application/json'}
+    #     r = requests.put(url, headers=headers)
+    #     j_r = json.loads(r.content)
+    #     print json.dumps(j_r, ensure_ascii=False)
+    #     self.assertEqual('200', j_r['state']['code'])
+
+    # def test_59_detach_disk(self):
+    #     TestGuest.disk_uuid = '234670cb-3ce4-4ef9-ba23-12bed636184c'
+    #     url = TestGuest.base_url + '/guest/_detach_disk/' + TestGuest.disk_uuid
+    #     headers = {'content-type': 'application/json'}
+    #     r = requests.put(url, headers=headers)
+    #     j_r = json.loads(r.content)
+    #     print json.dumps(j_r, ensure_ascii=False)
+    #     self.assertEqual('200', j_r['state']['code'])
 
 if __name__ == '__main__':
     unittest.main()