/lib/rapi/rlib2.py - Diff - snf-ganeti - Greek Research and Technology Network's projects

Revision c8e0a534 lib/rapi/rlib2.py

       to adapt clients accordingly.
       """
       DOC_URI = "/version"
       def GET(self):
         """Returns the remote API version.
-...
       """Cluster info.
       """
       DOC_URI = "/2/info"
       def GET(self):
         """Returns cluster information.
         Example::
+        {
           "config_version": 2000000,
           "name": "cluster",
           "software_version": "2.0.0~beta2",
           "os_api_version": 10,
           "export_version": 0,
           "candidate_pool_size": 10,
           "enabled_hypervisors": [
             "fake"
           ],
           "hvparams": {
             "fake": {}
            },
           "default_hypervisor": "fake",
           "master": "node1.example.com",
           "architecture": [
             "64bit",
             "x86_64"
           ],
           "protocol_version": 20,
           "beparams": {
             "default": {
               "auto_balance": true,
               "vcpus": 1,
               "memory": 128
+             }
+            }
+          }
         """
         client = luxi.Client()
         return client.QueryClusterInfo()
-...
       """/2/os resource.
       """
       DOC_URI = "/2/os"
       def GET(self):
         """Return a list of all OSes.
-...
       """/2/jobs resource.
       """
       DOC_URI = "/2/jobs"
       def GET(self):
         """Returns a dictionary of jobs.
-...
       """/2/jobs/[job_id] resource.
       """
       DOC_URI = "/2/jobs/[job_id]"
       def GET(self):
         """Returns a job status.
-...
       """/2/nodes resource.
       """
       DOC_URI = "/2/nodes"
       def GET(self):
         """Returns a list of all nodes.
         Example::
+          [
+            {
               "id": "node1.example.com",
               "uri": "\/instances\/node1.example.com"
             },
+            {
               "id": "node2.example.com",
               "uri": "\/instances\/node2.example.com"
+            }
+          ]
         If the optional 'bulk' argument is provided and set to 'true'
         value (i.e '?bulk=1'), the output contains detailed
         information about nodes as a list.
         Example::
+          [
+            {
               "pinst_cnt": 1,
               "mfree": 31280,
               "mtotal": 32763,
               "name": "www.example.com",
               "tags": [],
               "mnode": 512,
               "dtotal": 5246208,
               "sinst_cnt": 2,
               "dfree": 5171712,
               "offline": false
             },
             ...
+          ]
         @return: a dictionary with 'name' and 'uri' keys for each of them
         """
         client = luxi.Client()
-...
       """/2/nodes/[node_name] resources.
       """
       DOC_URI = "/nodes/[node_name]"
       def GET(self):
         """Send information about a node.
-...
       """/2/instances resource.
       """
       DOC_URI = "/2/instances"
       def GET(self):
         """Returns a list of all available instances.
         Example::
+          [
+            {
               "name": "web.example.com",
               "uri": "\/instances\/web.example.com"
             },
+            {
               "name": "mail.example.com",
               "uri": "\/instances\/mail.example.com"
+            }
+          ]
         If the optional 'bulk' argument is provided and set to 'true'
         value (i.e '?bulk=1'), the output contains detailed
         information about instances as a list.
         Example::
+          [
+            {
                "status": "running",
                "disk_usage": 20480,
                "nic.bridges": [
                  "xen-br0"
                 ],
                "name": "web.example.com",
                "tags": ["tag1", "tag2"],
                "beparams": {
                  "vcpus": 2,
                  "memory": 512
                },
                "disk.sizes": [
                ],
                "pnode": "node1.example.com",
                "nic.macs": ["01:23:45:67:89:01"],
                "snodes": ["node2.example.com"],
                "disk_template": "drbd",
                "admin_state": true,
                "os": "debian-etch",
                "oper_state": true
             },
             ...
+          ]
         @return: a dictionary with 'name' and 'uri' keys for each of them.
         """
         client = luxi.Client()
-...
       """/2/instances/[instance_name] resources.
       """
       DOC_URI = "/2/instances/[instance_name]"
       def GET(self):
         """Send information about an instance.
-...
       Implements an instance reboot.
       """
       DOC_URI = "/2/instances/[instance_name]/reboot"
       def POST(self):
         """Reboot an instance.
-...
       Implements an instance startup.
       """
       DOC_URI = "/2/instances/[instance_name]/startup"
       def PUT(self):
         """Startup an instance.
-...
       Implements an instance shutdown.
       """
       DOC_URI = "/2/instances/[instance_name]/shutdown"
       def PUT(self):
         """Shutdown an instance.
-...
     class _R_Tags(baserlib.R_Generic):
       """ Quasiclass for tagging resources
       Manages tags. Inheriting this class you suppose to define DOC_URI and
       Manages tags. When inheriting this class you must define the
       TAG_LEVEL for it.
       """
-...
       Manages per-instance tags.
       """
       DOC_URI = "/2/instances/[instance_name]/tags"
       TAG_LEVEL = constants.TAG_INSTANCE
-...
       Manages per-node tags.
       """
       DOC_URI = "/2/nodes/[node_name]/tags"
       TAG_LEVEL = constants.TAG_NODE
-...
       Manages cluster tags.
       """
       DOC_URI = "/2/tags"
       TAG_LEVEL = constants.TAG_CLUSTER

Also available in: Unified diff

Synnefo » snf-ganeti

Revision c8e0a534 lib/rapi/rlib2.py