ebcc59d5d98600ddbd1993c6712626bdcbaf942b
[plcapi.git] / PLC / Methods / GetConfFiles.py
1 # $Id$
2 from PLC.Faults import *
3 from PLC.Method import Method
4 from PLC.Parameter import Parameter, Mixed
5 from PLC.Filter import Filter
6 from PLC.ConfFiles import ConfFile, ConfFiles
7 from PLC.Auth import Auth
8
9 class GetConfFiles(Method):
10     """
11     Returns an array of structs containing details about configuration
12     files. If conf_file_filter is specified and is an array of
13     configuration file identifiers, or a struct of configuration file
14     attributes, only configuration files matching the filter will be
15     returned. If return_fields is specified, only the specified
16     details will be returned.
17     """
18
19     roles = ['admin', 'node']
20
21     accepts = [
22         Auth(),
23         Mixed([ConfFile.fields['conf_file_id']],
24               Filter(ConfFile.fields)),
25         Parameter([str], "List of fields to return", nullok = True)
26         ]
27
28     returns = [ConfFile.fields]
29
30
31     def call(self, auth, conf_file_filter = None, return_fields = None):
32         return ConfFiles(self.api, conf_file_filter, return_fields)