PLC/Methods/AddNodeToPCU.py

   1 from PLC.Faults import *
   2 from PLC.Method import Method
   3 from PLC.Parameter import Parameter, Mixed
   4 from PLC.Nodes import Node, Nodes
   5 from PLC.PCUs import PCU, PCUs
   6 from PLC.Auth import PasswordAuth
   7
   8 class AddNodeToPCU(Method):
   9     """
  10     Adds a node to a port on a PCU. Faults if the node has already
  11     been added to the PCU or if the port is already in use.
  12
  13     Non-admins may only update PCUs at their sites.
  14
  15     Returns 1 if successful, faults otherwise.
  16     """
  17
  18     roles = ['admin', 'pi', 'tech']
  19
  20     accepts = [
  21         PasswordAuth(),
  22         Mixed(Node.fields['node_id'],
  23               Node.fields['hostname']),
  24         PCU.fields['pcu_id'],
  25         Parameter(int, 'PCU port number')
  26         ]
  27
  28     returns = Parameter(int, '1 if successful')
  29
  30     def call(self, auth, node_id_or_hostname, pcu_id, port):
  31          # Get node
  32         nodes = Nodes(self.api, [node_id_or_hostname])
  33         if not nodes:
  34             raise PLCInvalidArgument, "No such node"
  35
  36         node = nodes.values()[0]
  37
  38         # Get PCU
  39         pcus = PCUs(self.api, [pcu_id])
  40         if not pcus:
  41             raise PLCInvalidArgument, "No such PCU"
  42
  43         pcu = pcus.values()[0]
  44
  45         if 'admin' not in self.caller['roles']:
  46             ok = False
  47             sites = Sites(self.api, self.caller['site_ids']).values()
  48             for site in sites:
  49                 if pcu['pcu_id'] in site['pcu_ids']:
  50                     ok = True
  51                     break
  52             if not ok:
  53                 raise PLCPermissionDenied, "Not allowed to update that PCU"
  54
  55         # Add node to PCU
  56         if node['node_id'] in pcu['node_ids']:
  57             raise PLCInvalidArgument, "Node already controlled by PCU"
  58
  59         if port in pcu['ports']:
  60             raise PLCInvalidArgument, "PCU port already in use"
  61
  62         pcu.add_node(node, port)
  63
  64         return 1