3 from sfa.util.xrn import urn_to_hrn
4 from sfa.util.method import Method
5 from sfa.util.sfatablesRuntime import run_sfatables
6 from sfa.util.faults import SfaInvalidArgument
7 from sfa.trust.credential import Credential
9 from sfa.storage.parameter import Parameter, Mixed
11 class Describe(Method):
13 Retrieve a manifest RSpec describing the resources contained by the
14 named entities, e.g. a single slice or a set of the slivers in a
15 slice. This listing and description should be sufficiently
16 descriptive to allow experimenters to use the resources.
17 @param credential list
18 @param options dictionary
21 interfaces = ['aggregate', 'slicemgr']
23 Parameter(type([str]), "List of URNs"),
24 Mixed(Parameter(str, "Credential string"),
25 Parameter(type([str]), "List of credentials")),
26 Parameter(dict, "Options")
28 returns = Parameter(str, "List of resources")
30 def call(self, urns, creds, options):
31 self.api.logger.info("interface: %s\tmethod-name: %s" % (self.api.interface, self.name))
33 # client must specify a version
34 if not options.get('geni_rspec_version'):
35 if options.get('rspec_version'):
36 options['geni_rspec_version'] = options['rspec_version']
38 raise SfaInvalidArgument('Must specify an rspec version option. geni_rspec_version cannot be null')
40 valid_creds = self.api.auth.checkCredentials(creds, 'listnodes', urns, \
41 check_sliver_callback = self.api.manager.driver.check_sliver_credentials)
43 # get hrn of the original caller
44 origin_hrn = options.get('origin_hrn', None)
46 origin_hrn = Credential(cred=valid_creds[0]).get_gid_caller().get_hrn()
47 desc = self.api.manager.Describe(self.api, creds, urns, options)
49 # filter rspec through sfatables
50 if self.api.interface in ['aggregate']:
51 chain_name = 'OUTGOING'
52 elif self.api.interface in ['slicemgr']:
53 chain_name = 'FORWARD-OUTGOING'
54 self.api.logger.debug("ListResources: sfatables on chain %s"%chain_name)
55 desc['geni_rspec'] = run_sfatables(chain_name, '', origin_hrn, desc['geni_rspec'])
57 if options.has_key('geni_compressed') and options['geni_compressed'] == True:
58 desc['geni_rspec'] = zlib.compress(desc['geni_rspec']).encode('base64')