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

快速开始

更新时间:2018-02-22 11:03:58

欢迎使用阿里云开发者工具套件(SDK)。阿里云C++ SDK让您不用复杂编程即可访问云服务器、云监控等多个阿里云服务。

如果您在使用SDK的过程中遇上任何问题,欢迎加入钉钉群: 11771185(阿里云官方SDK客户服务群) 咨询。

环境准备

  • 要使用阿里云C++ SDK,您需要创建一个RAM用户并获取其AccessKey,详情参见获取AccessKey

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

获取SDK

  1. 在Linux平台中安装第三方库,包括libcurl、libopenssl、libuuid和libjsoncpp。

    在基于Redhat / Fedora的系统上执行以下命令安装第三方库。

    1. sudo dnf install libcurl-devel openssl-devel libuuid-devel libjsoncpp-devel

    在基于Debian / Ubuntu的系统上执行以下命令安装第三方库。

    1. sudo apt-get install libcurl4-openssl-dev libssl-dev uuid-dev libjsoncpp-dev
  2. 执行以下命令,从GitHub中获取源代码。
    1. git clone https://github.com/aliyun/aliyun-openapi-cpp-sdk.git

调用示例

在调用C++ SDK前,您需要首先配置预处理器定义ALIBABACLOUD_SHARED以动态链接阿里云C++ SDK共享库,然后通过创建Client实例,并指定云服务的地域及提供身份验证参数,最后发送API请求。

以下代码展示了如何调用云服务器(ECS)的DescribeInstances接口,查询指定地域所有ECS实例的详细信息。

说明: 您需要替换示例中的your-region-id、your-access-key-id和your-access-key-secret的值。您可以在地域列表中查看各地域的地域ID。

  1. #include <iostream>
  2. #include <alibabacloud/core/AlibabaCloud.h>
  3. #include <alibabacloud/ecs/EcsClient.h>
  4. using namespace AlibabaCloud;
  5. using namespace AlibabaCloud::Ecs;
  6. int main(int argc, char** argv)
  7. {
  8. // 初始化 SDK
  9. AlibabaCloud::InitializeSdk();
  10. // 配置 ECS 实例
  11. ClientConfiguration configuration("<your-region-id>");
  12. EcsClient client("<your-access-key-id>", "<your-access-key-secret>", configuration);
  13. // 创建API请求并设置参数
  14. Model::DescribeInstancesRequest request;
  15. request.setPageSize(10);
  16. auto outcome = client.describeInstances(request);
  17. if (!outcome.isSuccess())
  18. {
  19. // 异常处理
  20. std::cout << outcome.error().errorCode() << std::endl;
  21. AlibabaCloud::ShutdownSdk();
  22. return -1;
  23. }
  24. std::cout << "totalCount: " << outcome.result().getTotalCount() << std::endl;
  25. // 关闭 SDK
  26. AlibabaCloud::ShutdownSdk();
  27. return 0;
  28. }
本文导读目录