本文介绍如何使用EDAS提供的Java SDK调用API创建ECS集群。

前提条件

在创建ECS集群前，您必须提前完成以下准备工作：
  • 安装EDAS的Java SDK。更多信息，请参见Java SDK接入指南。
  • 确定创建ECS集群的地域，假设为cn-hangzhou。
  • 创建微服务空间。具体操作，请参见创建命名空间。

    如果已经存在命名空间，您可以调用ListUserDefineRegion接口查询用户自定义命名空间列表，获取目标命名空间的RegionId。

  • 如果您要在专有网络VPC中创建ECS集群，请先创建VPC。具体操作，请参见搭建IPv4专有网络。

    如果您已经创建了专有网络VPC，则可以调用ListVpc接口查询VPC列表，获取VPC实例ID（VpcId），假设为vpc-bp1hcg467ekqsv****。

背景信息

EDAS提供两类ECS集群：阿里云ECS集群和非阿里云ECS集群（混合云ECS集群）。
  • 阿里云ECS集群：由阿里云的ECS组成的集群。本文介绍如何创建阿里云ECS集群。
  • 非阿里云ECS集群：即混合云ECS集群，可以包含阿里云的ECS、本地IDC内的服务器以及其他云服务提供商的服务器。这些服务器通过专线连通，并添加到EDAS的非阿里云ECS集群中进行管理。关于非阿里云ECS集群的更多信息，请参见创建混合云ECS集群。

创建ECS集群

以下代码用于创建ECS集群。

import com.aliyuncs.DefaultAcsClient;
import com.aliyuncs.exceptions.ClientException;
import com.aliyuncs.exceptions.ServerException;
import com.aliyuncs.profile.DefaultProfile;
import com.aliyuncs.edas.model.v20170801.InsertClusterRequest;
import com.aliyuncs.edas.model.v20170801.InsertClusterResponse;

public class InsertCluster {

    public static void main(String[] args)  {
        //阿里云账号或RAM用户的AccessKey ID。
        String aliyun_user_ak = "<yourAccessKeyId>";
        //阿里云账号或RAM用户的AccessKey Secret。
        String aliyun_user_sk = "<yourAccessKeySecret>";
        //要创建ECS集群的目标地域ID。
        String region_id = "cn-hangzhou";

        DefaultProfile defaultProfile = DefaultProfile.getProfile(region_id, aliyun_user_ak, aliyun_user_sk);
        DefaultAcsClient client = new DefaultAcsClient(defaultProfile);

        //创建API请求，并设置参数。
        InsertClusterRequest request = new InsertClusterRequest();
        //需要创建ECS集群的目标微服务空间的RegionId，例如：cn-hangzhou:doc。
        request.setLogicalRegionId("cn-hangzhou:doc");
        //自定义ECS集群名称，例如：ECSClueter_doc。
        request.setClusterName("ECSClueter_doc");
        //设置集群类型，设置为2,即代表ECS集群。
        request.setClusterType(2);
        //设置集群网络类型，2代表专有网络VPC，1代表经典网络。
        request.setNetworkMode(2);
        //VPC实例ID，当选择专有网络VPC时，此参数必填。
        request.setVpcId("vpc-bp1hcg467ekqsv****");


        try {
            InsertClusterResponse response = client.getAcsResponse(request);
            System.out.println("Message=" + response.getMessage() + "\nClusterName=" + response.getCluster().getClusterName()+ "\nClusterId=" + response.getCluster().getClusterId());
        } catch (ServerException e) {
            e.printStackTrace();
        } catch (ClientException e) {
            e.printStackTrace();
        }
    }
}
运行程序，返回的执行结果如下：
Message=success
ClusterName=ECSClueter_doc
ClusterId=369d06d7-450b-4f3d-bf75-9536fcd9****

结果验证

在创建ECS集群后，您可以调用ListCluster接口查询集群列表，根据返回结果中的集群名称（ClusterName）参数值判断您是否操作成功。

调用ListCluster接口返回的结果如下：
{
  "ClusterList": {
    "Cluster": [
      {
        "OversoldFactor": 1,
        "NodeNum": 0,
        "ResourceGroupId": "rg-acfm3umruf2****",
        "ClusterId": "369d06d7-450b-4f3d-bf75-9536fcd9****",
        "CreateTime": 1618558401855,
        ......
        "VpcId": "vpc-bp1hcg467ekqsv0zr****",
        "UpdateTime": 1618558401855,
        "ClusterName": "ECSClueter_doc",
        "RegionId": "cn-hangzhou:doc",
        "IaasProvider": "ALIYUN",
        "CpuUsed": 0
      }
    ]
  },
  "Message": "success",
  "RequestId": "65C65D19-36BF-40C1-A3D0-23902D2AF49C",
  "Code": 200
}