renaming SliceAttribute into SliceTag and InterfaceSetting into InterfaceTag
[plcapi.git] / PLC / Methods / UpdateInterfaceTag.py
1 # $Id#
2 #
3 # Thierry Parmentelat - INRIA
4 #
5 # $Revision$
6 #
7
8 from PLC.Faults import *
9 from PLC.Method import Method
10 from PLC.Parameter import Parameter, Mixed
11 from PLC.Auth import Auth
12
13 from PLC.InterfaceTags import InterfaceTag, InterfaceTags
14 from PLC.Interfaces import Interface, Interfaces
15
16 from PLC.Nodes import Nodes
17 from PLC.Sites import Sites
18
19 class UpdateInterfaceTag(Method):
20     """
21     Updates the value of an existing interface setting
22
23     Access rights depend on the tag type.
24
25     Returns 1 if successful, faults otherwise.
26     """
27
28     roles = ['admin', 'pi', 'tech', 'user']
29
30     accepts = [
31         Auth(),
32         InterfaceTag.fields['interface_tag_id'],
33         InterfaceTag.fields['value']
34         ]
35
36     returns = Parameter(int, '1 if successful')
37
38     object_type = 'Interface'
39
40     def call(self, auth, interface_tag_id, value):
41         interface_tags = InterfaceTags(self.api, [interface_tag_id])
42         if not interface_tags:
43             raise PLCInvalidArgument, "No such interface setting %r"%interface_tag_id
44         interface_tag = interface_tags[0]
45
46         ### reproducing a check from UpdateSliceTag, looks dumb though
47         interfaces = Interfaces(self.api, [interface_tag['interface_id']])
48         if not interfaces:
49             raise PLCInvalidArgument, "No such interface %r"%interface_tag['interface_id']
50         interface = interfaces[0]
51
52         assert interface_tag['interface_tag_id'] in interface['interface_tag_ids']
53
54         # check permission : it not admin, is the user affiliated with the right site
55         if 'admin' not in self.caller['roles']:
56             # locate node
57             node = Nodes (self.api,[interface['node_id']])[0]
58             # locate site
59             site = Sites (self.api, [node['site_id']])[0]
60             # check caller is affiliated with this site
61             if self.caller['person_id'] not in site['person_ids']:
62                 raise PLCPermissionDenied, "Not a member of the hosting site %s"%site['abbreviated_site']
63             
64             required_min_role = tag_type ['min_role_id']
65             if required_min_role is not None and \
66                     min(self.caller['role_ids']) > required_min_role:
67                 raise PLCPermissionDenied, "Not allowed to modify the specified interface setting, requires role %d",required_min_role
68
69         interface_tag['value'] = value
70         interface_tag.sync()
71
72         self.object_ids = [interface_tag['interface_tag_id']]
73         return 1