org.duracloud.computeprovider.mgmt

Interface ComputeProvider

All Known Implementing Classes:

LocalComputeProviderImpl

public interface ComputeProvider

 This interface exposes basic management capabilities of ComputeProviders:
 start, stop, describe...

 It provides an abstraction layer from implementations such as:
 Amazon-EC2, Rackspace Cloud ...
 

Author:

Andrew Woods

Method Summary

Modifier and Type	Method and Description
InstanceDescription	describeRunningInstance(Credential credential, String instanceId, String xmlProps) This method retrieves description of initiated instance.
URL	getWebappURL(Credential credential, String instanceId, String xmlProps) This method returns the URL of the instancewebapp on the instance with the provided id.
boolean	isInstanceBooting(Credential credential, String instanceId, String xmlProps) This method returns true if the webapp of provided instance is currently booting.
boolean	isInstanceRunning(Credential credential, String instanceId, String xmlProps) This method returns true if the instance is successfully running.
boolean	isWebappRunning(Credential credential, String instanceId, String xmlProps) This method returns true if the webapp of provided instance is successfully running.
String	start(Credential credential, String xmlProps) This method starts an instance-image with provided credential and Compute-provider properties.
void	stop(Credential credential, String instanceId, String xmlProps) This method stops the running instance with provided id.

Method Detail

start

String start(Credential credential,
             String xmlProps)
      throws Exception

This method starts an instance-image with provided credential and Compute-provider properties.

Parameters:

credential -

props - Provider-specific properties

Returns:

ID of running instance.

Throws:

Exception

stop

void stop(Credential credential,
          String instanceId,
          String xmlProps)
   throws Exception

This method stops the running instance with provided id.

Parameters:

credential - Compute-provider credentials

instanceId -

props - Provider-specific properties

Throws:

Exception

isInstanceRunning

boolean isInstanceRunning(Credential credential,
                          String instanceId,
                          String xmlProps)
                   throws Exception

This method returns true if the instance is successfully running.

Parameters:

credential - Compute-provider credentials

instanceId -

props - Provider-specific properties

Returns:

Throws:

Exception

isWebappRunning

boolean isWebappRunning(Credential credential,
                        String instanceId,
                        String xmlProps)
                 throws Exception

This method returns true if the webapp of provided instance is successfully running.

Parameters:

credential - Compute-provider credentials

instanceId -

props - Provider-specific properties

Returns:

Throws:

Exception

isInstanceBooting

boolean isInstanceBooting(Credential credential,
                          String instanceId,
                          String xmlProps)
                   throws Exception

This method returns true if the webapp of provided instance is currently booting.

Parameters:

credential - Compute-provider credentials

instanceId -

props - Provider-specific properties

Returns:

Throws:

Exception

getWebappURL

URL getWebappURL(Credential credential,
                 String instanceId,
                 String xmlProps)
          throws Exception

This method returns the URL of the instancewebapp on the instance with the provided id.

Parameters:

credential - Compute-provider credentials

instanceId -

props - Provider-specific properties

Returns:

Throws:

Exception

describeRunningInstance

InstanceDescription describeRunningInstance(Credential credential,
                                            String instanceId,
                                            String xmlProps)

This method retrieves description of initiated instance.

Parameters:

credential - Compute-provider credentials

instanceId -

props - Provider-specific properties

Returns: