全部产品
存储与CDN 数据库 域名与网站(万网) 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网 钉钉智能硬件
阿里云SDK开发指南

如何使用

更新时间:2018-02-02 15:20:17

初始化SDK

在使用阿里云 C++ SDK 服务客户端发起请求前,您必须先使用 AlibabaCloud::InitializeSdk 接口正确进行初始化,最后您还应该使用 AlibabaCloud::ShutdownSdk 释放资源

  1. #include <alibabacloud/core/AlibabaCloud.h>
  2. int main(int argc, char** argv)
  3. {
  4. AlibabaCloud::InitializeSdk();
  5. // ......
  6. AlibabaCloud::ShutdownSdk();
  7. return 0;
  8. }

使用服务客户端

阿里云 C++ SDK 服务客户端类为您提供了该类所代表的阿里云的服务接口。服务客户端通常遵循的名称约定:AlibabaCloud::Service::ServiceClient

例如,使用 AlibabaCloud::Ecs::EcsClient 类构建云服务器 ECS 的客户端。

设置身份验证凭据

当使用阿里云 C++ SDK 访问阿里云服务时,您需要提供阿里云账号进行身份验证。

目前支持以下几种身份验证方式:

验证方式 说明
AccessKey 使用AccessKeyId/Secret访问
StsToken 使用StsToken访问
RamRoleArn 使用Ram子账号的AssumeRole方式访问
EcsRamRole 在ECS实例上通过EcsRamRole实现免密验证

本文以 AK 方式为例说明设置凭据的方法,其他验证方式请点击相关条目查看。

注意: 为了保证您的账号安全,建议您使用 RAM 账号来访问阿里云服务。阿里云账号的 AccessKey 对拥有的资源有完全的权限。RAM 账号由阿里云账号授权创建,仅有对特定资源限定的操作权限。

客户端配置

您可以使用客户端配置类 ClientConfiguration 来控制部分服务客户端运行时功能

  1. // 配置 ecs 实例
  2. ClientConfiguration configuration;
  3. configuration.setRegionId("cn-hangzhou");
  4. configuration.setEndpoint("ecs-cn-hangzhou.aliyuncs.com");
  5. EcsClient client("<your-access-key-id>", "<your-access-key-secret>", configuration);

配置选项

regionId

指定您的地域ID。RegionId 可以从地域列表中获得。

endpoint

指定您的服务节点。(不建议使用)

proxy

指定您的网络代理设置。

使用CMake构建您的应用程序

CMake 是一个开源的跨平台自动化建构系统,它使用一个名为 CMakeLists.txt 的文件来描述构建过程和应用程序依赖关系,并最终生成适合您当前构建平台的项目文件。

以下以 Linux 平台为例,演示如何使用 CMake 构建您的阿里云 C++ SDK 应用程序。

创建CMake项目

创建一个项目文件目录:

  1. mkdir my_example

打开目录并添加一个 CMakeLists.txt 文件,该文件描述您的项目名称,可执行文件,源文件和链接库。

以下是一个简单的例子:

  1. # 为项目设置cmake所需的最低版本
  2. cmake_minimum_required(VERSION 3.0)
  3. # 为整个项目设置名称
  4. project(my-example)
  5. # 设置默认为 C++ 11
  6. set(CMAKE_CXX_STANDARD 11)
  7. # 设置SDK库安装目录
  8. link_directories(/usr/local/lib64)
  9. # 设置应用程序名及原文件
  10. add_executable(my-example
  11. main.cc)
  12. # 动态链接 SDK 库文件
  13. add_definitions(-DALIBABACLOUD_SHARED)
  14. # 指定要链接的 SDK 库文件
  15. target_link_libraries(my-example
  16. alibabacloud-sdk-core
  17. alibabacloud-sdk-ecs)

注意:您可以在 CMakeLists.txt 配置文件中设置许多选项,有关更多选项功能的介绍请参阅 CMake 网站

使用CMake 构建

在您的项目下创建一个编译目录

  1. mkdir build

打开目录并执行 cmake 命令:

  1. cd build
  2. cmake ..

在 cmake 生成 Makefile 文件后,您可以执行 make 命令编译您的应用程序:

  1. make
本文导读目录