startInstances

startInstances method allows you to start a previously stopped service(s) or server instance(s) in BMC Cloud Lifecycle Management.

This operation can be performed by specifying either of following:

Service ID(s) from BMC Cloud Lifecycle Management.
Service name(s) from BMC Cloud Lifecycle Management.
Server instance ID(s) from BMC Cloud Lifecycle Management.

The following table depicts how startInstances method is used:

Usage Description

To execute using server instance ID(s)

StartInstancesRequest startInstancesRequest = new StartInstancesRequest();
     List&lt;String&gt; instanceIdsList = new ArrayList&lt;String&gt;();
     instanceIdsList.add(&quot;dfbb7d4f-196e-462a-b0c6-4f96e51eccbd&quot;); 
// Pass Server instance id here
     startInstancesRequest.setInstanceIds(instanceIdsList);
     clmEC2Client.startInstances(startInstancesRequest);

To execute using service ID(s)

 StartServicesRequest servicesRequest = new StartServicesRequest();
     List&lt;String&gt; serviceIdList = new ArrayList&lt;String&gt;();
     // Pass Service Ids here
     serviceIdList.add(&quot;ec37bff8-8886-4ed2-bb92-249deae0fcff&quot;);
     servicesRequest.setServiceIds(serviceIdList);
     clmEC2Client.startInstances(servicesRequest);

To execute using service name(s)

StartServicesRequest servicesRequest = new StartServicesRequest();
     List&lt;String&gt; serviceNameList = new ArrayList&lt;String&gt;();
     serviceNameList.add(&quot;WinTestService&quot;);
     servicesRequest.setServiceNames(serviceNameList);
     clmEC2Client.startInstances(servicesRequest);

Before you begin

Prior to using this CLM AWS SDK method, ensure that the following prerequisites are met:

You have supplied the configuration parameters to the CLMEC2Client constructor or have specified in the configuration file. See CLM AWS SDK syntax and usage for details.
Supply either of the three:
- List of valid server ids from BMC Cloud Lifecycle Management. You can obtain the server ids using the getInstanceId() method of com.bmc.cloud.sdk.aws.model.ServerInstance
- List of valid service ids from BMC Cloud Lifecycle Management. You can obtain the service ids using the getServiceId() method of com.bmc.cloud.sdk.aws.model.ServerInstance
- List of valid service names from BMC Cloud Lifecycle Management. You can obtain the service names using the getServiceName() method of com.bmc.cloud.sdk.aws.model.ServerInstance

Request

Using com.amazonaws.services.ec2.model.StartInstancesRequest

Method	Usage as per AWS SDK	Usage as per CLM AWS SDK	Remarks
setInstanceIds(Collection<String> instanceIds)	One or more instance IDs	One or more server IDs from BMC Cloud Lifecycle Management.	This is obtained from the getInstanceId() method from com.bmc.cloud.sdk.aws.model.ServerInstance
withInstanceIds(Collection<String> instanceIds)	One or more instance IDs	One or more server IDs from BMC Cloud Lifecycle Management.	This is obtained from the getInstanceId() method from com.bmc.cloud.sdk.aws.model.ServerInstance

Using com.bmc.cloud.sdk.aws.model.StartServiceInstancesRequest

Extends: com.amazonaws.services.ec2.model.StartInstancesRequest

Method	Usage as per AWS SDK	Usage as per CLM AWS SDK	Remarks
setServiceIds(final List<String> serviceIds)	Not used	One or more service IDs from BMC Cloud Lifecycle Management.	This is obtained from the getServiceId() method from com.bmc.cloud.sdk.aws.model.ServerInstance
setServiceNames(List<String> serviceNames)	Not used	One or more service names from BMC Cloud Lifecycle Management.	This is obtained from the getServiceName() method from com.bmc.cloud.sdk.aws.model.ServerInstance

Response

Method

Belongs To

AWS SDK Usage

CLM SDK Usage

Remarks

getStartingInstances()

AWS

```
getCurrentState()  
```
```
getInstanceId()  
```
```
getPreviousState()
```

```
getCurrentState()  
```
```
getInstanceId()  
```
```
getPreviousState()
```

PENDING,RUNNING,
SHUTTING_DOWN,TERMINATED,
STOPPING,STOPPED

Instance ID is mapped to server ID