全部产品
弹性计算 会员服务 网络 安全 移动云 数加·大数据分析及展现 数加·大数据应用 管理与监控 云通信 阿里云办公 培训与认证 更多
存储与CDN 数据库 域名与网站(万网) 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网 智能硬件
阿里云SDK开发指南

快速开始

更新时间:2018-02-24 09:26:13

欢迎使用阿里云开发者工具套件(SDK)。阿里云Java SDK让您不用复杂编程即可访问云服务器、云监控等多个阿里云服务。这里向您介绍如何获取阿里云Java SDK并开始调用。如果您在使用SDK的过程中遇上任何问题,欢迎加入 钉钉群: 11771185(阿里云官方SDK客户服务群) 咨询。

环境准备

  1. 要使用阿里云Java SDK,您需要一个RAM账号以及一对AccessKey IDAccessKey Secret。 请在阿里云控制台中的AccessKey管理页面上创建和查看您的AccessKey,或联系您的系统管理员。

  2. 要使用阿里云SDK访问某个产品的API,您需要事先在阿里云控制台中开通这个产品。

  3. 阿里云Java SDK需要1.6以上的JDK。

安装SDK

如果您使用Apache Maven来管理Java项目,只需在项目的pom.xml文件加入相应的依赖项即可。您可以在阿里云SDK频道中下载各云产品的Maven依赖。

无论您要使用哪个产品的开发工具包,都必须安装SDK核心库。比如,对云服务器ECS的SDK调用,您需要安装SDK核心库和云服务器ECS的SDK。

以3.5.0版本的SDK核心库和3.0.0版本的ECS SDK为例,您只需在pom.xml中声明这两个开发工具包,如下所示:

  1. <dependency>
  2. <groupId>com.aliyun</groupId>
  3. <artifactId>aliyun-java-sdk-core</artifactId>
  4. <version>3.5.0</version>
  5. </dependency>
  6. <dependency>
  7. <groupId>com.aliyun</groupId>
  8. <artifactId>aliyun-java-sdk-ecs</artifactId>
  9. <version>3.0.0</version>
  10. </dependency>

使用Java SDK

以下这个代码示例向您展示了调用阿里云Java SDK的3个主要步骤:

  1. 创建DefaultAcsClient实例并初始化。

  2. 创建API请求并设置参数。

  3. 发起请求并处理应答或异常。

  1. package com.testprogram;
  2. import com.aliyuncs.profile.DefaultProfile;
  3. import com.aliyuncs.DefaultAcsClient;
  4. import com.aliyuncs.IAcsClient;
  5. import com.aliyuncs.exceptions.ClientException;
  6. import com.aliyuncs.exceptions.ServerException;
  7. import com.aliyuncs.ecs.model.v20140526.*;
  8. public class Main {
  9. public static void main(String[] args) {
  10. // 创建DefaultAcsClient实例并初始化
  11. DefaultProfile profile = DefaultProfile.getProfile(
  12. "<your-region-id>", // 地域ID
  13. "<your-access-key-id>", // RAM账号的AccessKey ID
  14. "<your-access-key-secret>"); // RAM账号Access Key Secret
  15. IAcsClient client = new DefaultAcsClient(profile);
  16. // 创建API请求并设置参数
  17. DescribeInstancesRequest request = new DescribeInstancesRequest();
  18. request.setPageSize(10);
  19. // 发起请求并处理应答或异常
  20. DescribeInstancesResponse response;
  21. try {
  22. response = client.getAcsResponse(request);
  23. for (DescribeInstancesResponse.Instance instance:response.getInstances()) {
  24. System.out.println(instance.getPublicIpAddress());
  25. }
  26. } catch (ServerException e) {
  27. e.printStackTrace();
  28. } catch (ClientException e) {
  29. e.printStackTrace();
  30. }
  31. }
  32. }
本文导读目录