Install the Java SDK

Enter the required parameters and click Call.

After a successful API call, click the SDK Sample tab in the right-side panel, select a language, and then click Download Sample Project.

In IntelliJ IDEA, choose File > Open and select the unzipped sample project folder. Maven automatically installs the required dependencies.

Before you call an API operation, you must obtain an AccessKey pair. We recommend using the AccessKey pair of a RAM user. For more information, see Create an AccessKey pair.

Double-click Sample.java and click the Run icon in the upper-right corner.

View the result. In the log window at the bottom, press Ctrl+F and search for statusCode. A "statusCode":200 value indicates a successful API call.

Obtain the SDK.

Open the Elastic Desktop Service (EDS) Enterprise SDK installation page and choose an installation method. This topic uses Apache Maven as an example.

Add the SDK dependency.

In your Maven project, open the pom.xml file and add the following dependency to the <dependencies></dependencies> element.

<dependencies>
  <dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>ecd20200930</artifactId>
    <version>4.3.0</version>
  </dependency>
</dependencies>

Download dependencies.

Right-click the project name and choose Maven > Reload project from the shortcut menu to download the dependencies.

Create a Java class.

Right-click the src/main/java directory, choose New > Java Class, enter Sample as the class name, and press Enter.

Initialize the cloud service client.

import com.aliyun.ecd20200930.Client;
import com.aliyun.teaopenapi.models.Config;

public class Sample {
    public static void main(String[] args) throws Exception {
        Config config = new Config()
                .setAccessKeyId(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"))
                .setAccessKeySecret(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET"));
        config.endpoint = "ecd.cn-shanghai.aliyuncs.com";
        Client client = new Client(config);
    }
}

Call an API operation.

For each API operation, the SDK provides a request class and a response class. The request class defines the parameters and their data types, and the response class defines the structure of the returned data. This design helps prevent parameter spelling errors.

import com.aliyun.ecd20200930.Client;
import com.aliyun.ecd20200930.models.DescribeOfficeSitesRequest;
import com.aliyun.ecd20200930.models.DescribeOfficeSitesResponse;
import com.aliyun.teaopenapi.models.Config;

public class Sample {
    public static void main(String[] args) throws Exception {
            Config config = new Config()
                    .setAccessKeyId(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"))
                    .setAccessKeySecret(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET"));
            config.endpoint = "ecd.cn-shanghai.aliyuncs.com";
            Client client = new Client(config);
            DescribeOfficeSitesRequest describeOfficeSitesRequest = new DescribeOfficeSitesRequest()
                .setRegionId("cn-shanghai");
            DescribeOfficeSitesResponse describeOfficeSitesResponse = client.describeOfficeSites(describeOfficeSitesRequest);
    }
}

Handle exceptions.

The Alibaba Cloud SDK provides unified exception handling.

TeaException: This is the primary exception for errors returned by the service during an SDK request. This exception provides the following properties to help you troubleshoot issues:

• message: The error message of the API operation, which includes the RequestId.

• data: The error details returned by the server.