.net sdk-凯发k8国际娱乐官网入口
本章节介绍.net sdk,您可以参考本章节进行快速集成开发。
准备工作
- 注册华为帐号并开通华为云,并完成实名认证,帐号不能处于欠费或冻结状态。
- 已具备开发环境,.net sdk 适用于.net standard 2.0 及其以上版本;c# 4.0 及其以上版本。
- 登录“ > 访问秘钥”页面,依据界面操作指引获取access key(ak)和secret access key(sk)。下载的访问秘钥为credentials.csv文件,包含ak/sk信息。
- 登录“”页面,获取“iam用户名”、“帐号名”以及待使用区域的“项目id”。调用服务时会用到这些信息,请提前保存。
本样例以“华北-北京四”区域为例,获取对应的项目id(project_id)。
图1 我的凭证
安装sdk
使用sdk前,需要安装“huaweicloud.sdk.core”和“huaweicloud.sdk.ocr”,有两种安装方式,分别如下。
- 使用 .net cli 工具
dotnet add package huaweicloud.sdk.core dotnet add package huaweicloud.sdk.ocr
- 使用 package manager
install-package huaweicloud.sdk.core install-package huaweicloud.sdk.ocr
开始使用
- 导入依赖模块
using system; using system.collections.generic; using huaweicloud.sdk.core; using huaweicloud.sdk.core.auth; using huaweicloud.sdk.ocr; using huaweicloud.sdk.ocr.v1; using huaweicloud.sdk.ocr.v1.model;
- 配置客户端连接参数
- 默认配置
// 使用默认配置 var config = httpconfig.getdefaultconfig();
- 网络代理(可选)
// 根据需要配置网络代理 config.proxyhost = "proxy.huaweicloud.com"; config.proxyport = 8080; config.proxyusername = "test"; config.proxypassword = "test";
- 超时配置(可选)
// 默认超时时间为120秒,可根据需要调整 config.timeout = 120;
- ssl配置(可选)
// 根据需要配置是否跳过ssl证书验证 config.ignoresslverification = true;
- 默认配置
- 配置认证信息
配置ak、sk信息。华为云通过ak识别用户的身份,通过sk对请求数据进行签名验证,用于确保请求的机密性、完整性和请求者身份的正确性。ak、sk获取方法请参见准备工作。
const string ak = environment.getenvironmentvariable("huaweicloud_sdk_ak"); const string sk = environment.getenvironmentvariable("huaweicloud_sdk_sk"); var auth = new basiccredentials(ak, sk);
- 认证用的 ak 和sk 硬编码到代码中或者明文存储都有很大的安全风险,建议在配置文件或者环境变量中密文存放,使用时解密,确保安全。
- 本示例以 ak 和 sk 保存在环境变量中来实现身份验证为例,运行本示例前请先在本地环境中设置环境变量huaweicloud_sdk_ak和huaweicloud_sdk_sk。
- 初始化客户端(二选一)
- 指定云服务region方式(推荐)
// 初始化指定云服务的客户端 {service}client ,以初始化ocr服务的 ocrclient 为例 var client = ocrclient.newbuilder() .withcredential(auth) .withregion(ocrregion.valueof("cn-north-4")) .withhttpconfig(config) .build();
- 指定云服务endpoint方式
// 指定终端节点,以ocr服务北京四的 endpoint 为例 string endpoint = "https://ocr.cn-north-4.myhuaweicloud.com"; // 初始化客户端认证信息,需要填写相应 projectid,以初始化 basiccredentials 为例 var auth = new basiccredentials(ak, sk, projectid); // 初始化指定云服务的客户端 {service}client,以初始化ocr服务的 ocrclient 为例 var client = ocrclient.newbuilder() .withcredential(auth) .withendpoint(endpoint) .withhttpconfig(config) .build();
endpoint是华为云各服务应用区域和各服务的终端节点,详情请查看 。
- 指定云服务region方式(推荐)
- 发送请求并查看响应
// 以调用通用表格识别接口 recognizegeneraltable 为例 var req = new recognizegeneraltablerequest { }; req.body = new generaltablerequestbody() { url = "图片的url" }; try { var resp = client.recognizegeneraltable(req); var respstatuscode = resp.httpstatuscode; console.writeline(respstatuscode); }
- 异常处理
表1 异常处理 一级分类
一级分类说明
二级分类
二级分类说明
connectionexception
连接类异常
hostunreachableexception
网络不可达、被拒绝。
sslhandshakeexception
ssl认证异常。
requesttimeoutexception
响应超时异常
calltimeoutexception
单次请求,服务器处理超时未返回。
retryoutageexception
在重试策略消耗完成后,仍无有效的响应。
serviceresponseexception
服务器响应异常
serverresponseexception
服务端内部错误,http响应码:[500,]。
clientrequestexception
请求参数不合法,http响应码:[400, 500)
try { var resp = client.recognizegeneraltable(req); var respstatuscode = resp.httpstatuscode; console.writeline(respstatuscode); } catch (requesttimeoutexception requesttimeoutexception) { console.writeline(requesttimeoutexception.errormessage); } catch (serviceresponseexception clientrequestexception) { console.writeline(clientrequestexception.httpstatuscode); console.writeline(clientrequestexception.errorcode); console.writeline(clientrequestexception.errormsg); } catch (connectionexception connectionexception) { console.writeline(connectionexception.errormessage); }
使用异步客户端,配置日志等操作,请参见、。
代码示例自动生成
提供api检索及平台调试,支持全量快速检索、可视化调试、帮助文档查看、在线咨询。
您只需要在api explorer中修改接口参数,即可自动生成对应的代码示例。同时,可在集成开发环境cloudide中完成代码的构建、调试、运行等操作。
意见反馈
文档内容是否对您有帮助?
如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨