Base for dedicated appliance management API. Ref https://github.com/GNS3/gns3-server/issues/1427

gns3server/handlers/api/controller/appliance_handler.py

@@ -20,6 +20,11 @@ from gns3server.controller import Controller
 from gns3server.schemas.node import NODE_OBJECT_SCHEMA
 from gns3server.schemas.appliance import APPLIANCE_USAGE_SCHEMA
 
+from gns3server.schemas.appliance import (
+    APPLIANCE_OBJECT_SCHEMA,
+    APPLIANCE_UPDATE_SCHEMA,
+    APPLIANCE_CREATE_SCHEMA
+)
 
 import logging
 log = logging.getLogger(__name__)
@@ -42,6 +47,74 @@ class ApplianceHandler:
         controller.load_appliance_templates()
         response.json([c for c in controller.appliance_templates.values()])
 
+    @Route.post(
+        r"/appliances",
+        description="Create a new appliance",
+        status_codes={
+            201: "Appliance created",
+            400: "Invalid request"
+        },
+        input=APPLIANCE_CREATE_SCHEMA,
+        output=APPLIANCE_OBJECT_SCHEMA)
+    def create(request, response):
+
+        controller = Controller.instance()
+        appliance = controller.add_appliance(request.json)
+        response.set_status(201)
+        response.json(appliance)
+
+    @Route.get(
+        r"/appliances/{appliance_id}",
+        status_codes={
+            200: "Appliance found",
+            400: "Invalid request",
+            404: "Appliance doesn't exist"
+        },
+        description="Get an appliance",
+        output=APPLIANCE_OBJECT_SCHEMA)
+    def get(request, response):
+
+        controller = Controller.instance()
+        appliance = controller.get_appliance(request.match_info["appliance_id"])
+        response.set_status(200)
+        response.json(appliance)
+
+    @Route.put(
+        r"/appliances/{appliance_id}",
+        status_codes={
+            200: "Appliance updated",
+            400: "Invalid request",
+            404: "Appliance doesn't exist"
+        },
+        description="Update an appliance",
+        input=APPLIANCE_UPDATE_SCHEMA,
+        output=APPLIANCE_OBJECT_SCHEMA)
+    def update(request, response):
+
+        controller = Controller.instance()
+        appliance = controller.get_appliance(request.match_info["appliance_id"])
+        #TODO: update appliance!
+        #appliance.settings = request.json
+        response.set_status(200)
+        response.json(appliance)
+
+    @Route.delete(
+        r"/appliances/{appliance_id}",
+        parameters={
+            "appliance_id": "Node UUID"
+        },
+        status_codes={
+            204: "Appliance deleted",
+            400: "Invalid request",
+            404: "Appliance doesn't exist"
+        },
+        description="Delete an appliance")
+    def delete(request, response):
+
+        controller = Controller.instance()
+        controller.delete_appliance(request.match_info["appliance_id"])
+        response.set_status(204)
+
     @Route.get(
         r"/appliances",
         description="List of appliance",
@@ -50,6 +123,8 @@ class ApplianceHandler:
         })
     def list(request, response):
 
+        #old_etag = request.headers.get('If-None-Match', '')
+        #print("ETAG => ", old_etag)
         controller = Controller.instance()
         response.json([c for c in controller.appliances.values()])
 
@@ -58,11 +133,11 @@ class ApplianceHandler:
         description="Create a node from an appliance",
         parameters={
             "project_id": "Project UUID",
-            "appliance_id": "Appliance template UUID"
+            "appliance_id": "Appliance UUID"
         },
         status_codes={
             201: "Node created",
-            404: "The project or template doesn't exist"
+            404: "The project or appliance doesn't exist"
         },
         input=APPLIANCE_USAGE_SCHEMA,
         output=NODE_OBJECT_SCHEMA)
@@ -71,7 +146,7 @@ class ApplianceHandler:
         controller = Controller.instance()
         project = controller.get_project(request.match_info["project_id"])
         await project.add_node_from_appliance(request.match_info["appliance_id"],
-                                                   x=request.json["x"],
-                                                   y=request.json["y"],
-                                                   compute_id=request.json.get("compute_id"))
+                                              x=request.json["x"],
+                                              y=request.json["y"],
+                                              compute_id=request.json.get("compute_id"))
         response.set_status(201)

gns3server/handlers/api/controller/node_handler.py

@@ -76,7 +76,7 @@ class NodeHandler:
             400: "Invalid request",
             404: "Node doesn't exist"
         },
-        description="Update a node instance",
+        description="Get a node",
         output=NODE_OBJECT_SCHEMA)
     def get_node(request, response):
         project = Controller.instance().get_project(request.match_info["project_id"])
@@ -84,7 +84,6 @@ class NodeHandler:
         response.set_status(200)
         response.json(node)
 
-
     @Route.put(
         r"/projects/{project_id}/nodes/{node_id}",
         status_codes={