SDK的使用方法

上次更新時間: 2024/06/27

以下為SDK使用的實際範例 (以 runInstances 與 describeInstances 為例)
範例說明：申請虛擬機器，並持續追蹤訂單狀態直到虛擬機完成供裝

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
	{
		// 新增憑證
		String accessKey = "U0U0MU5UQXhNREF3TVRFek5qSTVPRFkxTURneU1UWT0";
		String secretKey = "WWpJNU16a3pOV1JsWWpNeU5HVXdOMkkxTURNd1lUbG1OMlEwTXpSaFptST0";
		HwsCredential credential = new HwsBasicCredential(accessKey, secretKey);

		// 新增憑證(使用Property檔案)
		// HwsCredential credential = new HwsPropertyCredential();

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

		// 若使用Proxy Server，可透過以下方式設定
		client.getConfiguration().setProxyServerIp("proxy.cht.com.tw");
		client.getConfiguration().setProxyServerPort(8080);

		// 建立VM Service Proxy，負責代理處理參數傳遞與資料驗證
		VirtualMachineService serviceProxy = client.newServiceProxy(VirtualMachineService.class);

		// 步驟1:新增VM
		// 新增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");

		// 呼叫CaaS / CVPC API建立VM並回傳RunInstancesResponse
		RunInstancesResponse runInstancesResult = serviceProxy.runInstances(request);
		// 顯示RunInstancesResponse結果
		System.out.println(runInstancesResult);

		// 步驟2:查詢虛擬機資訊
		// 新增Describe Instance Request
		DescribeInstancesRequest describeRequest = new DescribeInstancesRequest();
		// 根據建立RunInstance回傳的uuid查詢，虛擬機訂單狀態
		describeRequest.setOrderUuid(runInstancesResult.getOrderUuidList());

		boolean isProvisionFinished = false;
		// 持續查詢虛擬機資訊，直到虛擬機供裝完畢
		while (!isProvisionFinished)
		{
			// 呼叫CaaS / CVPC API查詢VM並回傳DescribeInstancesResponse
			DescribeInstancesResponse describeInstancesResult = serviceProxy.describeInstances(describeRequest);
			// 顯示VM訂單狀態
			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();
			}
		}
	}
}

使用說明