Access guidelines

This topic describes the steps of accessing EDAS APIs, including instructions on how to obtain the SDK and descriptions of initialization parameters, and provides an example of a specific API call.

Obtain the SDK

1. For Maven users

   In the pom.xml file, add the SDK dependency on the Open API:

   <dependency>
      <groupId>com.aliyun</groupId>
      <artifactId>aliyun-java-sdk-edas</artifactId>
      <version>2.16.1-SNAPSHOT</version>
   </dependency>

   Note: If you cannot obtain the SDK after the dependency is added, add the following profile to the setting.xml file of the local repository (Usually found under .m2 of the user directory). If you still cannot obtain the SDK, please create a ticket.

   <profiles>
    <profile>
         <id>allow-snapshots</id>
         <activation><activeByDefault>true</activeByDefault></activation>
         <repositories>
           <repository>
             <id>snapshots-repo</id>
             <url>https://oss.sonatype.org/content/repositories/snapshots</url>
             <releases><enabled>false</enabled></releases>
             <snapshots><enabled>true</enabled></snapshots>
           </repository>
         </repositories>
    </profile>
   </profiles>
   <activeProfiles>
    <activeProfile>allow-snapshots</activeProfile>
   </activeProfiles>

2. For non-Maven users

   Download the JAR package from the following version list and add the package to the project:

   Version 2.16.0-SNAPSHOT: http://edas.oss-cn-hangzhou.aliyuncs.com/edas-pop-api/2.16.0-SNAPSHOT/aliyun-java-sdk-edas-2.16.0-snapshot.jar

Public request parameters

Supported regions

Sample request

To use Open APIs, launch the Open API client, configure an endpoint, and set public parameters such as regionId and accessKeyId. Here is a sample API request.

    public static void main(String[] args) throws ClientException{
        /**
         *Endpoint used to access the Open API. Set it based on the list of EDAS supported regions and the region where your instance is located.
         */
        String regionId = "XXXXX";
        /**
         *Access Key ID used for authentication. Obtain it in the Alibaba Cloud console.
         */
        String accessKeyId = "XXXXXXXXXXXXXXXXX";
        /**
         *Access Key Secret used for authentication. Obtain it in the Alibaba Cloud console.
         */
        String accessKeySecret = "XXXXXXXXXXXXXXXXX";
        /**
        *Name of the cloud product that you access using the Open API. Set it to EDAS.
        */
        String productName ="Edas";
        /**
         *Domain of the endpoint. For more information, see the domains in the list of EDAS supported regions.
         */
        String domain ="edas.XXXXX.aliyuncs.com";
        // Construct the Open API client
        DefaultProfile.addEndpoint(regionId,regionId,productName,domain);
        DefaultProfile defaultProfile = DefaultProfile.getProfile(regionId, accessKeyId, accessKeySecret);
        DefaultAcsClient defaultAcsClient = new DefaultAcsClient(defaultProfile);
        defaultAcsClient.setAutoRetry(false);
 
        // Construct the API request for listing application deployment groups. For more information about the input parameters, see API description.
        String appId = "xxxxxxxxx";
        ListDeployGroupRequest request = new ListDeployGroupRequest();
        // For more information about the input parameters, see API description.
        request.setAppId(appId);
        ListDeployGroupResponse response = defaultAcsClient.getAcsResponse(request);
        // Result parsing (If Code 200 is returned, the API call is successful; if any other code is returned, the API call fails. For more information, see the error code list.)
        if (response.getCode() == 200) {
            // Parse the returned result (For more information, see the return value description of the API.)
            List<DeployGroup> deployGroups = response.getDeployGroupList();
            if (CollectionUtils.isNotEmpty(deployGroups)) {
                for (DeployGroup deployGroup : deployGroups) {
                    System.out.println(deployGroup.getGroupName());
                    System.out.println(deployGroup.getGroupId());
                }
            }
        } else {
            // Print the cause of the error
            System.out.println(response.getMessage());
        }
    }