7b086af3c80a285160ad935ab70cc372f8b34207
[sfa.git] / sfa / methods / Shutdown.py
1 from sfa.storage.parameter import Parameter
2 from sfa.trust.credential import Credential
3 from sfa.util.method import Method
4
5
6 class Shutdown(Method):
7     """
8     Perform an emergency shut down of a sliver. This operation is intended for administrative use. 
9     The sliver is shut down but remains available for further forensics.
10
11     @param slice_urn (string) URN of slice to renew
12     @param credentials ([string]) of credentials    
13     """
14     interfaces = ['aggregate', 'slicemgr']
15     accepts = [
16         Parameter(str, "Slice URN"),
17         Parameter(type([dict]), "Credentials"),
18     ]
19     returns = Parameter(bool, "Success or Failure")
20
21     def call(self, xrn, creds):
22
23         valid_creds = self.api.auth.checkCredentials(creds, 'stopslice', xrn,
24                                                      check_sliver_callback=self.api.driver.check_sliver_credentials)
25         # log the call
26         origin_hrn = Credential(cred=valid_creds[0]).get_gid_caller().get_hrn()
27         self.api.logger.info("interface: %s\tcaller-hrn: %s\ttarget-hrn: %s\tmethod-name: %s" %
28                              (self.api.interface, origin_hrn, xrn, self.name))
29
30         return self.api.manager.Shutdown(self.api, xrn, creds)