同步操作将从 mirrors_aliyun/aliyun-openapi-cpp-sdk 强制同步,此操作会覆盖自 Fork 仓库以来所做的任何修改,且无法恢复!!!
确定后同步将在后台操作,完成时将刷新页面,请耐心等待。
English | 简体中文
Alibaba Cloud SDK for C++ 让您不用复杂编程即可访问云服务器、负载均衡、云监控等阿里云服务。这里向您介绍如何获取 Alibaba Cloud SDK for C++ 并开始调用。
如果您在使用的过程中遇到任何问题,欢迎前往阿里云SDK问答社区提问,提问前请阅读提问引导。亦可在当前 GitHub 提交 Issues。
Troubleshoot 提供 OpenAPI 使用诊断服务,通过 RequestID
或 报错信息
,帮助开发者快速定位,为开发者提供解决方案。
在使用 Alibaba Cloud SDK for C++ 前,确保您已经:
说明: 为了保证您的账号安全,建议您使用RAM账号来访问阿里云服务。阿里云账号对拥有的资源有全部权限。RAM账号由阿里云账号授权创建,仅有对特定资源限定的操作权限。详情参见RAM。
开通了云产品服务。有些云产品如对象存储(OSS)需要先在阿里云控制台开通服务。
安装支持 C++ 11 或更高版本的编译器:
安装 CMake 3.0 或以上版本
建议 4G 或以上内存
# use yum
yum install jsoncpp-devel openssl-devel uuid-devel libcurl-devel
# use dnf
sudo dnf install libcurl-devel openssl-devel libuuid-devel libjsoncpp-devel
sudo apt-get install libcurl4-openssl-dev libssl-dev uuid-dev libjsoncpp-dev
git clone https://github.com/aliyun/aliyun-openapi-cpp-sdk.git
cd aliyun-openapi-cpp-sdk
mkdir sdk_build
cd sdk_build
cmake -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=/usr ..
make
sudo make install
easyinstall.sh
一键式安装cd aliyun-openapi-cpp-sdk
sudo sh easyinstall.sh <lower name of product (like 'ecs')>
# example
sudo sh easyinstall.sh core
sudo sh easyinstall.sh ecs
Alibaba Cloud SDK for C++ 将被安装在 /usr
.
安装 perl
使用 git-bash 执行以下命令,从 Github 克隆源码
git clone https://github.com/aliyun/aliyun-openapi-cpp-sdk.git
sdk_build
目录Browse Source
为 源代码目录(aliyun-openapi-cpp-sdk)
Browse build
为 构建目录(sdk_build)
configure
BUILD_PRODUCT
参数的值generate
, 构建 VS 解决方案。Release
输出INSTALL
Alibaba Cloud SDK for C++ 将安装在 C:\Program File (x86)\alibabacloud-sdk
目录
注意:请以管理员身份运行 Visual Studio 和 cmake-gui,否则无法安装 SDK
在调用 Alibaba Cloud SDK for C++ 时,您首先需要配置预处理器定义 ALIBABACLOUD_SHARED 以引用阿里云 C++ SDK 的共享库,然后通过创建 Client 实例提供身份验证,并指定云服务的地域,然后发送API请求。
以下代码展示了如何调用 DescribeInstancesAPI 查询指定地域所有 ECS 实例的详细信息。
说明: 您需要替换示例中的 your-region-id、your-access-key-id 和 your-access-key-secret 的值。
#include <iostream>
#include <alibabacloud/core/AlibabaCloud.h>
#include <alibabacloud/ecs/EcsClient.h>
using namespace AlibabaCloud;
using namespace AlibabaCloud::Ecs;
int main(int argc, char** argv) {
// 初始化 SDK
AlibabaCloud::InitializeSdk();
// 配置 ecs 实例
ClientConfiguration configuration("<your-region-id>");
EcsClient client("<your-access-key-id>", "<your-access-key-secret>", configuration);
// 创建API请求并设置参数
Model::DescribeInstancesRequest request;
request.setPageSize(10);
auto outcome = client.describeInstances(request);
if (!outcome.isSuccess()) {
// 异常处理
std::cout << outcome.error().errorCode() << std::endl;
AlibabaCloud::ShutdownSdk();
return -1;
}
std::cout << "totalCount: " << outcome.result().getTotalCount() << std::endl;
// 关闭 SDK
AlibabaCloud::ShutdownSdk();
return 0;
}
复制上述文件到 ecs_test.cc。
Linux 下
~$ g++ -o ecstest ecs_test.cc --std=c++11 -lalibabacloud-sdk-core -l alibabacloud-sdk-ecs
~$ ./ecstest
# 结果或错误返回将在此展示
~$
CPP SDK 使用 libcurl 作为底层 HTTP 传输库。
下面两个参数用来传递超时参数到 libcurl。
默认值
可以在创建 Client 或者发 Requst 设置超时参数。
Requst 设置优先级高于 Client 设置。
输入 0 或者 -1 到 setConnectTimeout
和 setReadTimeout
可以禁用此功能。
下面代码是设置超时参数的例子,由于 Request 优先级高于 Client,所以最终 ConnectTimeout
为 1000ms
, readTimeout
为 6000ms
。
#include <iostream>
#include <alibabacloud/core/AlibabaCloud.h>
#include <alibabacloud/ecs/EcsClient.h>
using namespace AlibabaCloud;
using namespace AlibabaCloud::Ecs;
int main(int argc, char** argv) {
// Initialize the SDK
AlibabaCloud::InitializeSdk();
// Configure the ECS instance
ClientConfiguration configuration("<your-region-id>");
// specify timeout when create client.
configuration.setConnectTimeout(1500);
configuration.setReadTimeout(4000);
EcsClient client("<your-access-key-id>", "<your-access-key-secret>", configuration);
// Create an API request and set parameters
Model::DescribeInstancesRequest request;
request.setPageSize(10);
// specify timeout when request
request.setConnectTimeout(1000);
request.setReadTimeout(6000);
auto outcome = client.describeInstances(request);
if (!outcome.isSuccess()) {
// Handle exceptions
std::cout << outcome.error().errorCode() << std::endl;
AlibabaCloud::ShutdownSdk();
return -1;
}
std::cout << "totalCount: " << outcome.result().getTotalCount() << std::endl;
// Close the SDK
AlibabaCloud::ShutdownSdk();
return 0;
}
更多 例程
提交 Issue, 不符合指南的问题可能会立即关闭。
每个版本的详细更改记录在发行说明中。
提交 Pull Request 之前请阅读贡献指南。
版权所有 1999-2019 阿里巴巴集团
此处可能存在不合适展示的内容,页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容,可点击提交进行申诉,我们将尽快为您处理。