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

使用CommonRequest进行调用

更新时间:2018-02-24 13:54:21

CommonRequest调用方式

当您要访问的API没有产品SDK提供时,可以采用泛用型的API调用方式(CommonRequest)。使用CommonRequest调用方式可实现任意OpenAPI接口的调用。

CommonRequest有如下特点:

  1. 轻量:只需Core包即可发起调用,无需下载安装各产品的SDK。
  2. 简便:无需更新SDK即可调用最新发布的API。
  3. 快速迭代。

使用CommonRequest

阿里云产品的API有RPC和RESTful两种风格,不同风格的API的CommonRequest的调用方法也不同。

通常API参数中包含Action参数的是RPC风格,包含PathPattern参数的是RESTful风格。一般情况下,每个产品内,所有API的调用风格是统一的。每个API仅支持特定的一种风格调用,传入错误的标识,可能会调用到其他API,或收到ApiNotFound的错误信息。

发起一次CommonRequest请求,您需要获取以下几个参数的值。您可以在文档中心各产品的API文档中获取以下参数的值。此外,部分产品也可以通过OpenAPI Explorer来获取API的参数信息。

  • 域名(domain):该产品的通用访问域名。

  • API版本(version):该API的版本号,格式为YYYY-MM-DD。

    说明:在”公共参数”内容中,API版本号的信息通常是Version参数的值, 但也有些产品的API版本号为x-acs-version参数的值。

  • 当调用的API为RPC风格时(大部分阿里云产品API为RPC风格)如ECS和RDS,需要获取Action参数,使用request.ApiName = "<Action>"的方式来指定API名称。

    例如RunInstances接口的Action为RunInstances,在发起CommonRequest请求时,要使用request.ApiName = "RunInstances"来指定API名称。

  • 当调用的API为RESTful风格时如容器服务, 需要获取PathPattern参数,使用request.PathPattern = "<PathPattern>"的方式来指定RESTful路径。

    例如容器服务的查看所有集群实例的API的PathPattern为/clusters,在发起CommonRequest请求时,要使用request.PathPattern = "/clusters"指定RESTful路径。

代码示例

调用RPC风格的API

以下代码展示了如何使用CommonRequest的方式调用ECS的DescribeInstanceStatus接口:

  1. import com.aliyuncs.CommonRequest;
  2. import com.aliyuncs.CommonResponse;
  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.profile.DefaultProfile;
  8. public class Sample {
  9. public static void main(String[] args) {
  10. // 创建DefaultAcsClient实例并初始化
  11. DefaultProfile profile = DefaultProfile.getProfile(
  12. "<your-region-id>", // 您的地域ID
  13. "<your-access-key-id>", // 您的AccessKey ID
  14. "<your-access-key-secret>"); // 您的AccessKey Secret
  15. IAcsClient client = new DefaultAcsClient(profile);
  16. // 创建API请求并设置参数
  17. CommonRequest request = new CommonRequest();
  18. request.setDomain("ecs.aliyuncs.com");
  19. request.setVersion("2014-05-26");
  20. request.setAction("DescribeInstanceStatus");
  21. request.putQueryParameter("PageNumber", "1");
  22. request.putQueryParameter("PageSize", "30");
  23. try {
  24. CommonResponse response = client.getCommonResponse(request);
  25. System.out.println(response.getData());
  26. } catch (ServerException e) {
  27. // TODO Auto-generated catch block
  28. e.printStackTrace();
  29. } catch (ClientException e) {
  30. // TODO Auto-generated catch block
  31. e.printStackTrace();
  32. }
  33. }
  34. }

调用RESTful风格的API

以下代码展示了如何使用CommonRequest的方式调用容器服务的查看所有集群实例接口:

  1. import com.aliyuncs.CommonRequest;
  2. import com.aliyuncs.CommonResponse;
  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.profile.DefaultProfile;
  8. public class Sample {
  9. public static void main(String[] args) {
  10. // 创建DefaultAcsClient实例并初始化
  11. DefaultProfile profile = DefaultProfile.getProfile(
  12. "<your-region-id>", // 您的地域ID
  13. "<your-access-key-id>", // 您的AccessKey ID
  14. "<your-access-key-secret>"); // 您的AccessKey Secret
  15. IAcsClient client = new DefaultAcsClient(profile);
  16. // 创建API请求并设置参数
  17. CommonRequest request = new CommonRequest();
  18. request.setDomain("cs.aliyuncs.com");
  19. request.setVersion("2015-12-15");
  20. request.setUriPattern("/clusters");
  21. try {
  22. CommonResponse response = client.getCommonResponse(request);
  23. System.out.println(response.getData());
  24. } catch (ServerException e) {
  25. // TODO Auto-generated catch block
  26. e.printStackTrace();
  27. } catch (ClientException e) {
  28. // TODO Auto-generated catch block
  29. e.printStackTrace();
  30. }
  31. }
  32. }
本文导读目录