How to use SDK

Last Update: 2024/06/27

The following are examples of SDK using (taking runInstances and describeInstances for example).
Description of the examples: To apply for a VM and keep tracing the condition of the order until the VM is installed.

package chttl.cloud.hws;

import java.util.List;

import chttl.cloud.hws.auth.HwsBasicCredential;
import chttl.cloud.hws.auth.HwsCredential;
import chttl.cloud.hws.exception.HiCloudClientException;
import chttl.cloud.hws.exception.HiCloudServerException;
import chttl.cloud.hws.services.caas.VirtualMachineService;
import chttl.cloud.hws.services.caas.model.DescribeInstancesRequest;
import chttl.cloud.hws.services.caas.model.DescribeInstancesResponse;
import chttl.cloud.hws.services.caas.model.RunInstancesRequest;
import chttl.cloud.hws.services.caas.model.RunInstancesResponse;
import chttl.cloud.hws.services.caas.model.VirtualMachineEntry;

public class ExampleApp
{
	public static void main(String[] args)
			throws HiCloudClientException, HiCloudServerException
	{
		// To add ID
		String accessKey = "U0U0MU5UQXhNREF3TVRFek5qSTVPRFkxTURneU1UWT0";
		String secretKey = "WWpJNU16a3pOV1JsWWpNeU5HVXdOMkkxTURNd1lUbG1OMlEwTXpSaFptST0";
		HwsCredential credential = new HwsBasicCredential(accessKey, secretKey);

		// To add ID (using file Property)
		// HwsCredential credential = new HwsPropertyCredential();

		// To build Client End
		HiCloudWebServiceClient client = new HiCloudWebServiceClient("hws.hicloud.hinet.net", credential);

		// If Proxy Server is used, it can be set up through the following methods.
		client.getConfiguration().setProxyServerIp("proxy.cht.com.tw");
		client.getConfiguration().setProxyServerPort(8080);

		// To build VM Service Proxy and deal with parameter transmitting and data Verification
		VirtualMachineService serviceProxy = client.newServiceProxy(VirtualMachineService.class);

		// Step 1: To add VM
		// To add Run Instance Request.
		RunInstancesRequest request = new RunInstancesRequest();
		request.setImageId("hi-cuium8up");
		request.setCount(1);
		request.setInstanceName("Test HA");
		request.setMonitoringEnabled(false);
		request.setInstanceType("HC1.S.WIN");
		request.setRegionId("region-tw-1");

		// To call for CaaS / CVPC API to build VM and send it back
		RunInstancesResponse runInstancesResult = serviceProxy.runInstances(request);
		// To show the result of Run Instances Response
		System.out.println(runInstancesResult);

		// Step 2: To inquire VM data
		// To add Describe Instance Request
		DescribeInstancesRequest describeRequest = new DescribeInstancesRequest();
		// To inquire VM order condition according to the uuid sent back by RunInstance
		describeRequest.setOrderUuid(runInstancesResult.getOrderUuidList());

		boolean isProvisionFinished = false;
		// To keep inquire for the VM data until it is installed
		while (!isProvisionFinished)
		{
			// To call for CaaS / CVPC API to inquire for VM and send back DescribeInstancesResponse
			DescribeInstancesResponse describeInstancesResult = serviceProxy.describeInstances(describeRequest);
			// To show VM order condition
			System.out.println(describeInstancesResult);

			List<VirtualMachineEntry> instances = describeInstancesResult.getInstanceList();
			for (VirtualMachineEntry instance : instances)
			{
				if (!instance.getProvisionStatus().equals("provisioning"))
				{
					isProvisionFinished = true;
				}
			}

			try
			{
				Thread.sleep(5000);
			}
			catch (InterruptedException e)
			{
				e.printStackTrace();
			}
		}
	}
}

Directions