...
- getCartridgeInfo
- getPendingInstanceCount
- getRegisteredCartridges
- registerService
- startInstance
- terminateAllInstances
- terminateInstance
- terminateLastlySpawnedInstance
getCartridgeInfo
| Anchor | ||||
|---|---|---|---|---|
|
| Code Block | ||
|---|---|---|
| ||
public CartridgeInfo getCartridgeInfo(String cartridgeType) throws UnregisteredCartridgeException; |
Method description
Calling this method will return information on the given cartridge if present, otherwise this will return a null value.
...
Return Value | Description |
|---|---|
int | The number of pending instances for this domain is returned. This will return zero if there are no instances for this domain. |
getRegisteredCartridges
| Anchor | ||||
|---|---|---|---|---|
|
| Code Block | ||
|---|---|---|
| ||
public String[] getRegisteredCartridges(); |
Method
...
description
Calling
...
this
...
method
...
will
...
result
...
in
...
returning
...
the
...
types
...
of
...
Cartridges
...
registered
...
in
...
the
...
Cloud
...
Controller.
...
Return value description
Return Value | Description |
String | This will return an array containing the types of registered cartridges. |
registerService
| Anchor | ||||
|---|---|---|---|---|
|
| Code Block | ||
|---|---|---|
| ||
public boolean registerService(String domain, String subDomain, String tenantRange, String cartridgeType,
String hostName, Properties properties, byte[] payload) throws UnregisteredCartridgeException; |
Method description
A service cluster is uniquely identified by it's domain and sub-domain combination. This method registers the details of a newly created service cluster and it will override any existing service clusters.
Parameter description
| Parameter | Description |
|---|---|
domain | Service cluster domain. |
subDomain | Service cluster sub-domain. |
tenantRange | Tenant range (for example: '1-10' or '2'). |
cartridgeType | The registered cartridge type of the new service. |
hostName | Host name of this service instance. |
properties | Set of properties related to this service definition. |
payload | The payload that is passed to the instance to be started. The payload should not contain XML tags. |
...
| Code Block | ||
|---|---|---|
| ||
public String startInstance(String domainName, String subDomainName); |
Method description
An instance belonging to the provided service domain will be started up upon calling this method.
...
| Code Block | ||
|---|---|---|
| ||
public boolean terminateAllInstances(String domainName, String subDomainName); |
Method Description
Calling this method will result in the termination of all instances belonging to the provided service domain and sub-domain.
...
| Code Block | ||
|---|---|---|
| ||
public boolean terminateInstance(String domainName, String subDomainName); |
Method description
Calling this method results in the termination of an instance belonging to the provided service domain and sub-domain .
...
| Code Block | ||
|---|---|---|
| ||
public boolean terminateLastlySpawnedInstance(String domainName, String subDomainName); |
Method description
Calling this method will result in the termination of the lastly spawned instance that belongs to the service domain and sub-domain provided .
...
| Code Block | ||
|---|---|---|
| ||
public boolean unregisterService(String domain, String subDomain) throws UnregisteredServiceException; |
Method description
Calling this method will result in deregistering the service cluster that is represented by the mentioned domain and sub-domain .
...
| Parameter | Description |
|---|---|
domain | Service cluster domain. |
subDomain | Service clustering sub-domain. |
Return value description
Return Value | Description |
boolean | "True" or "false" will be returned to indicate whether the De-registration was successfully or not. |
Exception description
Exception Thrown | Description |
UnregisteredServiceException | Occurs when the requested service cluster has not been registered. |