Enterprise Distributed Application Service:Create an application in an ECS cluster by calling an API operation

Create an application

The following sample code provides an example on how to create an application in an ECS cluster in EDAS. The sample code does not contain the settings of mounted scripts and Java Virtual Machine (JVM) parameters. For more information about operation-specific parameters, see InsertApplication.

// The build package number of EDAS Container. You must specify this parameter when you create an HSF application. You can call the ListBuildPack operation and obtain the build package number from the ConfigId parameter. 
request.setBuildPackId(57);

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.InsertApplicationRequest;
import com.aliyuncs.edas.model.v20170801.InsertApplicationResponse;

public class InsertApplication {

    public static void main(String[] args)  {
        // The AccessKey pair of an Alibaba Cloud account has permissions on all API operations. Using these credentials to perform operations in EDAS is a high-risk operation. We recommend that you use a Resource Access Management (RAM) user to call API operations or perform routine O&M. To create a RAM user, log on to the RAM console. 
        // In this example, the AccessKey ID and AccessKey secret are stored in the environment variables. You can save your AccessKey ID and AccessKey secret in your configuration file based on your business requirements. 
        // To prevent key leaks, we recommend that you do not save your AccessKey ID and AccessKey secret in the code. 
        String aliyun_user_ak = System.getenv("ACCESS_KEY_ID");
        String aliyun_user_sk = System.getenv("ACCESS_KEY_SECRET");
        // The ID of the region where you want to create the application. 
        String region_id = "cn-hangzhou";

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

        // Create an API request and configure the related parameters. 
        InsertApplicationRequest request = new InsertApplicationRequest();
        // The ID of the ECS cluster in which you want to create the application. 
        request.setClusterId("369d06d7-450b-4f3d-bf75-9536fcd993dc");
        // The description of the application. 
        request.setDescription("create by edas pop api");
        // The custom name of the application. The name can be up to 36 characters in length, and can contain letters, digits, underscores (_), and hyphens (-). The name must start with a letter. 
        request.setApplicationName("ECSAPP_API");
        // The ID of the microservice namespace. 
        request.setLogicalRegionId("cn-hangzhou:doc");
        // The ECU IDs of ECS instances in the ECS cluster. An ECU ID uniquely identifies an ECS instance that is imported to EDAS. Separate multiple ECU IDs with commas (,). 
        request.setEcuInfo("82a0ac57-433d-4ad1-ae89-0c6fcb70****,e2674482-1214-4c93-b767-9b6405e2****");
        // The type of the application deployment package. Valid values: war and jar. 
        request.setPackageType("jar");
        // The ID of the application component. You must specify this parameter when you create a Spring Cloud or Dubbo application. You do not need to specify this parameter when you create an HSF application. 
        // A value of 4 specifies Apache Tomcat 7.0.91. A value of 7 specifies Apache Tomcat 8.5.42. A value of 5 specifies OpenJDK 1.8.x. A value of 6 specifies OpenJDK 1.7.x. 
        request.setComponentIds("5");
        // Specifies whether to enable the health check URL. A value of true specifies to enable the URL. A value of false specifies to disable the URL. 
        request.setEnableUrlCheck(true);
        // The health check URL of the application. 
        request.setHealthCheckUrl("http://127.0.0.1:8080/_ehc.html");



        try {
            InsertApplicationResponse response = client.getAcsResponse(request);
            System.out.println("Message=" + response.getMessage() + "\nAppName=" + response.getApplicationInfo().getAppName() + "\nAppId=" + response.getApplicationInfo().getAppId());
        } catch (ServerException e) {
            e.printStackTrace();
        } catch (ClientException e) {
            e.printStackTrace();
        }
    }
}

Message=success
AppName=ECSAPP_API
AppId=6275ffd0-d577-4b5a-894f-e92991b8****

Check the result

After you create the application in the ECS cluster in EDAS, call the ListApplication operation to query applications. View the values of parameters such as AppId and Appname in the response and check whether the application is created.

{
  "Message": "success",
  "RequestId": "9363A94A-96C5-4B41-93A9-001A4E9DDEE1",
  "ApplicationList": {
    "Application": [
      {
        "BuildPackageId": 0,
        "ApplicationType": "FatJar",
        "AppId": "6275ffd0-d577-4b5a-894f-e92991b8****",
        "ResourceGroupId": "rg-acfm3umruf2****",
        "ClusterId": "369d06d7-450b-4f3d-bf75-9536fcd9****",
        "RegionId": "cn-hangzhou:doc",
        "ClusterType": 2,
        "RunningInstanceCount": 0,
        "Name": "ECSAPP_API"
      }
    ]
  },
  "Code": 200
}