Initial checkin of new API implementation
[plcapi.git] / PLC / Methods / AdmDeleteNode.py
1 from PLC.Faults import *
2 from PLC.Method import Method
3 from PLC.Parameter import Parameter, Mixed
4 from PLC.Auth import PasswordAuth
5 from PLC.Nodes import Node, Nodes
6
7 class AdmDeleteNode(Method):
8     """
9     Mark an existing node as deleted.
10
11     PIs and techs may only delete nodes at their own sites. Admins may
12     delete nodes at any site.
13
14     Returns 1 if successful, faults otherwise.
15     """
16
17     roles = ['admin', 'pi', 'tech']
18
19     accepts = [
20         PasswordAuth(),
21         Mixed(Node.fields['node_id'],
22               Node.fields['hostname'])
23         ]
24
25     returns = Parameter(int, '1 if successful')
26
27     def call(self, auth, node_id_or_hostname):
28         # Get account information
29         nodes = Nodes(self.api, [node_id_or_hostname])
30         if not nodes:
31             raise PLCInvalidArgument, "No such node"
32
33         node = nodes.values()[0]
34
35         # If we are not an admin, make sure that the caller is a
36         # member of the site at which the node is located.
37         if 'admin' not in self.caller['roles']:
38             # Authenticated function
39             assert self.caller is not None
40
41             if node['site_id'] not in self.caller['site_ids']:
42                 raise PLCPermissionDenied, "Not allowed to delete nodes from specified site"
43
44         node.delete()
45
46         return 1