1 from sfa.util.faults import SfaInvalidArgument, InvalidRSpec
2 from sfa.util.xrn import urn_to_hrn
3 from sfa.util.method import Method
4 from sfa.util.sfatablesRuntime import run_sfatables
6 from sfa.trust.credential import Credential
7 from sfa.storage.parameter import Parameter, Mixed
8 from sfa.rspecs.rspec import RSpec
10 class CreateSliver(Method):
12 Allocate resources to a slice. This operation is expected to
13 start the allocated resources asynchornously after the operation
14 has successfully completed. Callers can check on the status of
15 the resources using SliverStatus.
17 @param slice_urn (string) URN of slice to allocate to
18 @param credentials ([string]) of credentials
19 @param rspec (string) rspec to allocate
22 interfaces = ['aggregate', 'slicemgr']
24 Parameter(str, "Slice URN"),
25 Mixed(Parameter(str, "Credential string"),
26 Parameter(type([str]), "List of credentials")),
27 Parameter(str, "RSpec"),
28 Parameter(type([]), "List of user information"),
29 Parameter(dict, "options"),
31 returns = Parameter(str, "Allocated RSpec")
33 def call(self, slice_xrn, creds, rspec, users, options):
34 hrn, type = urn_to_hrn(slice_xrn)
36 self.api.logger.info("interface: %s\ttarget-hrn: %s\tmethod-name: %s"%(self.api.interface, hrn, self.name))
37 # Find the valid credentials
38 valid_creds = self.api.auth.checkCredentials(creds, 'createsliver', hrn)
39 origin_hrn = Credential(string=valid_creds[0]).get_gid_caller().get_hrn()
41 # make sure users info is specified
43 msg = "'users' must be specified and cannot be null. You may need to update your client."
44 raise SfaInvalidArgument(name='users', extra=msg)
46 # flter rspec through sfatables
47 if self.api.interface in ['aggregate']:
48 chain_name = 'INCOMING'
49 elif self.api.interface in ['slicemgr']:
50 chain_name = 'FORWARD-INCOMING'
51 self.api.logger.debug("CreateSliver: sfatables on chain %s"%chain_name)
52 rspec = run_sfatables(chain_name, hrn, origin_hrn, rspec)
53 slivers = RSpec(rspec).version.get_nodes_with_slivers()
55 raise InvalidRSpec("Missing <sliver_type> or <sliver> element. Request rspec must explicitly allocate slivers")
56 result = self.api.manager.CreateSliver(self.api, slice_xrn, creds, rspec, users, options)