150f87de144da3234a346c17113674a7ce1f0c38
[plcapi.git] / PLC / Methods / GetNodeNetworks.py
1 from PLC.Faults import *
2 from PLC.Method import Method
3 from PLC.Parameter import Parameter, Mixed
4 from PLC.Filter import Filter
5 from PLC.NodeNetworks import NodeNetwork, NodeNetworks
6 from PLC.Auth import Auth
7
8 class GetNodeNetworks(Method):
9     """
10     Returns an array of structs containing details about node network
11     interfacess. If nodenetworks_filter is specified and is an array
12     of node network identifiers, or a struct of node network
13     fields and values, only node network interfaces matching the filter
14     will be returned.
15
16     If return_fields is given, only the specified details will be returned.
17     """
18
19     roles = ['admin', 'pi', 'user', 'tech', 'node', 'anonymous']
20
21     accepts = [
22         Auth(),
23         Mixed([NodeNetwork.fields['nodenetwork_id']],
24               Parameter (int, "nodenetwork id"),
25               Filter(NodeNetwork.fields)),
26         Parameter([str], "List of fields to return", nullok = True)
27         ]
28
29     returns = [NodeNetwork.fields]
30     
31     def call(self, auth, nodenetwork_filter = None, return_fields = None):
32         return NodeNetworks(self.api, nodenetwork_filter, return_fields)