c sdk-凯发k8国际娱乐官网入口
本章节介绍新版c sdk,您可以参考本章节进行快速集成开发。
准备工作
- 注册华为帐号并开通华为云,并完成实名认证,帐号不能处于欠费或冻结状态。
- 已具备开发环境,支持 c 14 及以上版本,要求安装 cmake 3.10 及以上版本。
- 登录“ > 访问秘钥”页面,依据界面操作指引获取access key(ak)和secret access key(sk)。下载的访问秘钥为credentials.csv文件,包含ak/sk信息。
- 登录“”页面,获取“iam用户名”、“帐号名”以及待使用区域的“项目id”。调用服务时会用到这些信息,请提前保存。
本样例以“华北-北京四”区域为例,获取对应的项目id(project_id)。
图1 我的凭证
安装sdk
- 在linux系统上安装sdk
- 获取依赖包
所需的这些第三方软件包在大部分系统的包管理工具中都有提供,例如基于 debian/ubuntu 的系统。
sudo apt-get install libcurl4-openssl-dev libboost-all-dev libssl-dev libcpprest-dev
spdlog 需要从源码进行安装。
git clone https://github.com/gabime/spdlog.git cd spdlog mkdir build cd build cmake -dcmake_position_independent_code=on .. // 用以生成动态库 make sudo make install
- 编译安装
git clone https://github.com/huaweicloud/huaweicloud-sdk-cpp-v3.git cd huaweicloud-sdk-cpp-v3 mkdir build cd build cmake .. make sudo make install
完成上述操作后,c sdk 安装目录为 /usr/local。
- 获取依赖包
- 在windows系统上安装sdk
- 安装 vcpkg 并使用 vcpkg 安装所需软件包
vcpkg install curl cpprestsdk boost openssl spdlog
- 使用clion进行编译
- 使用clion打开huaweicloud-sdk-cpp-v3 目录。
- 选择 。
- 选择 。
- 在cmake options中加入:
-dcmake_toolchain_file={your vcpkg install dir}/scripts/buildsystems/vcpkg.cmake
- 右键 cmakelists.txt 选择 load cmake project。
- 选择build开始编译。
- 安装c sdk
编译完成后选择
。完成上述操作后,c sdk 安装目录为 c:\program file (x86)\huaweicloud-sdk-cpp-v3。
- 安装 vcpkg 并使用 vcpkg 安装所需软件包
开始使用
- 导入依赖模块
//include
//include //include //include //include //include //include using namespace huaweicloud::sdk::ocr::v1; using namespace huaweicloud::sdk::ocr::v1::model; using namespace huaweicloud::sdk::core; using namespace huaweicloud::sdk::core::exception; using namespace std; - 配置客户端连接参数
- 默认配置
// 使用默认配置 httpconfig httpconfig = httpconfig();
- 网络代理(可选)
// 根据需要配置网络代理 httpconfig.setproxyprotocol("http"); httpconfig.setproxyhost("proxy.huawei.com"); httpconfig.setproxyport("8080"); httpconfig.setproxyuser("username"); httpconfig.setproxypassword("password");
- 超时配置(可选)
// 默认连接超时为60秒,默认读取超时为120秒。可根据需求修改该默认值 httpconfig.setconnecttimeout(60); httpconfig.setreadtimeout(120);
- ssl配置(可选)
// 配置跳过服务端证书验证 httpconfig.setignoresslverification(true);
- 默认配置
- 配置认证信息
配置ak、sk、projectid信息。华为云通过ak识别用户的身份,通过sk对请求数据进行签名验证,用于确保请求的机密性、完整性和请求者身份的正确性。
string ak = getenv("huaweicloud_sdk_ak"); string sk = getenv("huaweicloud_sdk_sk"); string projectid = getenv("project_id"); auto auth = std::make_unique
(); auth->withak(ak) .withsk(sk) .withprojectid(projectid); - 认证用的 ak 和sk 硬编码到代码中或者明文存储都有很大的安全风险,建议在配置文件或者环境变量中密文存放,使用时解密,确保安全。
- 本示例以 ak 和 sk 保存在环境变量中来实现身份验证为例,运行本示例前请先在本地环境中设置环境变量huaweicloud_sdk_ak和huaweicloud_sdk_sk。
认证参数说明:
- 初始化客户端
指定云服务endpoint方式
string endpoint = "https://ocr.cn-north-4.myhuaweicloud.com"; auto client = ocrclient::newbuilder() .withcredentials(std::unique_ptr
(auth.release())) .withhttpconfig(httpconfig) .withendpoint(endpoint) .build(); endpoint:华为云各服务应用区域和各服务的终端节点,详情请查看 。
- 发送请求并查看响应
// 以调用通用表格识别接口 recognizegeneraltable 为例 recognizegeneraltablerequest request; generaltablerequestbody body; body.set; request.setbody(body); std::cout << "-----begin execute request-------" << std::endl;
- 异常处理
表1 异常处理 一级分类
一级分类说明
二级分类
二级分类说明
connectionexception
连接类异常
hostunreachableexception
网络不可达、被拒绝。
sslhandshakeexception
ssl认证异常。
requesttimeoutexception
响应超时异常
calltimeoutexception
单次请求,服务器处理超时未返回。
retryoutageexception
在重试策略消耗完成后,仍无有效的响应。
serviceresponseexception
服务器响应异常
serverresponseexception
服务端内部错误,http响应码:[500,]。
clientrequestexception
请求参数不合法,http响应码:[400, 500)
try { auto reponse = client->recognizegeneraltable(request); std::cout << reponse->gethttpbody() << std::endl; } catch (hostunreachableexception& e) { std::cout << "host unreachable:" << e.what() << std::endl; } catch (sslhandshakeexception& e) { std::cout << "ssl handshake error:" << e.what() << std::endl; } catch (retryoutageexception& e) { std::cout << "retryoutage error:" << e.what() << std::endl; } catch (calltimeoutexception& e) { std::cout << "call timeout:" << e.what() << std::endl; } catch (serviceresponseexception& e) { std::cout << "http status code:" << e.getstatuscode() << std::endl; std::cout << "error code:" << e.geterrorcode() << std::endl; std::cout << "error msg:" << e.geterrormsg() << std::endl; std::cout << "requestid:" << e.getrequestid() << std::endl; } catch (exception& e) { std:cout << "unknown exception:" << e.what() << std::endl; }
使用异步客户端,配置日志等操作,请参见、。
代码示例自动生成
提供api检索及平台调试,支持全量快速检索、可视化调试、帮助文档查看、在线咨询。
您只需要在api explorer中修改接口参数,即可自动生成对应的代码示例。同时,可在集成开发环境cloudide中完成代码的构建、调试、运行等操作。
意见反馈
文档内容是否对您有帮助?
如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨