华为云用户手册

常用列表查询方法 公共镜像列表查询 GET /v2/cloudimages?__imagetype=gold&visibility=public&protected=true 私有镜像列表查询 GET /v2/cloudimages?owner={project_id} 可以使用的共享镜像列表 GET /v2/cloudimages?member_status=accepted&visibility=shared&__imagetype=shared 被拒绝的共享镜像列表 GET /v2/cloudimages?member_status=rejected&visibility=shared&__imagetype=shared 未接受的共享镜像列表 GET /v2/cloudimages?member_status=pending&visibility=shared&__imagetype=shared 裸金属服务器某规格支持的公共镜像列表 GET /v2/cloudimages?__imagetype=gold&__support_xxx=true&virtual_env_type=Ironic

创建 IAM 用户并授权 使用KooCLI管理和使用您的各类云服务资源时，需提供调用者（IAM用户）的身份信息用于认证鉴权。 IAM用户是由华为帐号在IAM中创建的用户，是云服务的使用人员，具有独立的身份凭证，根据华为帐号授予的权限使用资源，可以确保华为帐号及资源的安全性。IAM用户不进行独立的计费，由所属华为帐号统一付费。 您注册华为云后，系统自动创建华为帐号对应的IAM用户，该用户在IAM中标识为“企业管理员”，其权限无法修改。出于业务需要，您可以另外创建IAM用户，并根据实际需要给IAM用户授权。

在Windows系统上安装KooCLI 点此下载适配Windows系统的KooCLI。 解压后得到hcloud.exe文件，如下图所示。 图1 在Windows系统下载并解压后的hcloud.exe文件 （可选）将KooCLI所在目录加入到系统环境变量Path中，方便在cmd窗口的任意目录下使用hcloud命令。 Windows 10 和 Windows 8 搜索并选择“查看高级系统设置”，然后单击“环境变量”； Windows 7 右键单击桌面上的“计算机”图标，从菜单中选择“属性”。单击“高级系统设置”链接，然后单击“环境变量”。 进入环境变量图形界面，在“用户变量”列表中，选中变量名为“Path”的环境变量，单击“编辑”。 在编辑环境变量界面中单机“新建”，输入hcloud.exe文件所在目录的路径。 单击三次“确定”，即可保存该修改。 （可选）打开cmd窗口，执行如下命令查看环境变量是否包含hcloud.exe文件所在目录，存在即说明配置成功。 set path （可选）打开Windows系统的cmd窗口（若您未执行如上步骤3，需要进入到工具所在的目录中），输入并执行如下命令，验证KooCLI是否安装成功。 hcloud version 系统显示类似如下版本信息，表示安装成功： hcloud version 当前KooCLI版本:3.2.8 父主题： 步骤二：快速安装

操作流程 开通 AOM 2.0并授权。 容器监控：在云容器引擎 CCE购买集群和节点后，自动安装ICAgent插件，将CCE集群指标上报到AOM，用户无需手动接入。 配置告警行动规则：通过创建告警行动规则关联 SMN 主题与消息模板，当CCE的指标数据满足对应的告警条件时，系统根据关联SMN主题与消息模板来发送告警通知。 配置告警：通过创建告警规则对CCE的指标设置告警阈值条件，当指标数据满足设置的告警阈值条件时产生告警。

首次开通AOM 2.0并授权 注册账号并实名认证。 使用AOM 2.0前，需要先注册一个华为账号并进行实名认证。如果您已有一个华为账号，可直接跳过如下操作。 进入华为云官网，单击页面右上角的“注册”。 参考 注册华为账号 并开通华为云中操作，完成注册。 注册后参考实名认证完成个人或企业账号实名认证。 开通AOM 2.0。 使用AOM 2.0前，需要先开通AOM 2.0。如果您已开通AOM 2.0，可直接跳过如下操作。 登录AOM华为云官网。 在AOM产品简介下方单击“AOM2.0控制台”，进入AOM 2.0服务页面。 在弹出的“通知”对话框中仔细阅读从AOM 1.0切换到AOM 2.0计费方式变化的说明。 单击“授权”，然后在“云服务授权”页面中仔细阅读授权声明后，勾选“我已阅读并同意授权声明”。 单击“免费开通服务并授权”，即可免费开通AOM 2.0服务。 为用户添加 应用运维管理 AOM和云容器引擎CCE的操作权限。 您需要有AOM的管理员权限“AOM FullAccess”和CCE的管理员权限“CCE FullAccess”，具体操作请参考创建用户并授权使用AOM和集群权限（IAM授权）。

配置示例 配置场景1：某客户的 域名 “www.example.com”配置了 CDN加速 ，缓存规则配置见下图。 配置结果：网站首页不缓存，所有页面均不会忽略URL参数。 配置场景2：设置某个类型的文件不缓存 某客户的域名“www.example.com”配置了CDN加速，由于业务需求，需要对“.do”格式的文件不缓存，同时所有文件都忽略URL参数。 需要在CDN控制台增加一条文件名后缀为“.do”的缓存规则，缓存过期时间设置为“0”。 新规则仅对后续资源缓存生效，新规则配置完成后，建议您刷新“.do”文件所在的URL或者目录，新规则才可以对所有“.do”文件生效。 某客户配置了CDN加速，发现登录界面无限循环，无法登录，停用CDN加速后，可以正常登录。 这是因为CDN节点缓存了登录界面导致的，需要在控制台增加一条针对登录界面的缓存规则，缓存过期时间设置为“0”。以华为云控制台登录界面为例，华为云控制台的登录页面为“https://auth.huaweicloud.com/authui/login.html#/login”，在控制台增加一条全路径：/authui/login.html#/login，缓存过期时间为“0”的缓存规则。 配置场景3：某客户加速域名www.example.com设置了如下图的缓存规则，不知道哪一个规则生效。 用户访问www.example.com/test/cdn.jpg，虽然所有文件、文件名后缀、全路径三条规则都匹配到了，但是由于全路径的优先级为8，在三条规则里优先级最高，所以系统最终匹配全路径/test/*.jpg这条规则。

背景信息 CDN节点的缓存策略遵循HTTP标准协议，通过HTTP响应头中的Cache-control: max-age的字段来设置CDN节点上数据的缓存时间。添加缓存规则让CDN用户可以对指定的业务做定制化的数据缓存时间管理。合理的配置缓存时间，能够有效的提升命中率，降低回源率，节省用户的带宽。 当用户向CDN节点请求数据时，CDN节点会判断缓存数据是否过期。如果缓存数据未过期，则直接将缓存数据返回给用户，提升获取速度；否则，CDN节点就会向源站发出回源请求，从源站请求最新数据，更新本地缓存，并将最新数据返回给用户。

注意事项 每个域名最多可添加60条缓存规则。 CDN缓存过期时间会对“回源率”产生直接的影响。如果CDN缓存过期时间过短，CDN节点上的数据会经常失效，导致频繁回源，增加了源站的负载，同时也增大了访问延时；如果CDN缓存过期时间过长，会带来数据更新时间慢的问题。 缓存过期时间设置为0时，该文件的所有请求都将回源，可能存在加速业务中断的风险。 节点缓存的资源，可能会由于热度较低而被提前从CDN节点删除。 如果您修改了缓存规则，请注意： 新的规则仅对后面缓存的资源生效，已经缓存的资源需要等缓存过期后，再次缓存才会遵循新的缓存规则。 如果您想要新的规则对所有资源（包括节点已缓存资源）立即生效，请在修改缓存规则后执行缓存刷新操作。

到期与欠费 包年/包月的Flexus L实例 有效期结束即为到期。 按需付费的资源周期性结算费用，当账户中余额不足时，账户将进入欠费状态。 Flexus L实例涉及的按需付费资源有： 超额流量。Flexus L实例中包含了固定的流量包，流量包使用完后，将产生按流量计费（按流量计费为按需计费模式）的超额流量。 Flexus L实例关联的其他按需资源。 Flexus L实例到期或账户欠费后的运行规则及影响如下表所示。 到期后阶段 影响 宽限期 宽限期指包年/包月Flexus L实例资源到期未续订或按需资源欠费时，华为云提供给客户进行续费与充值的时间，宽限期内该资源可以正常使用。 保留期 保留期指宽限期到期后，客户的包年/包月Flexus L实例资源仍未续订或按需资源仍未缴清欠款，将进入保留期。保留期内该资源不能正常使用，但资源仍予以保留。 资源进入宽限期/保留期后，华为云将会通过邮件、短信等方式向您发送提醒，提醒您续订或充值。保留期到期后，包年/包月资源仍未续订或账户仍未充值缴清欠款，所有资源将被释放。为避免对您的业务造成影响，请及时续费和充值。 华为云根据客户等级定义了不同客户的宽限期和保留期时长。

Flexus服务组合计费项 标 * 的计费项为必选计费项。 计费项 计费说明 计费模式 费用 * 实例 Flexus服务组合提供固定配置的两种套餐： 基础套餐计费因子：vCPU/内存、系统盘、流量包、云备份、主机安全。 高可用套餐计费因子：vCPU/内存、系统盘、流量包、云备份、主机安全、Flexus负载均衡。 说明： Flexus L实例仅对出网流量（从服务器流出的流量）计费，入网流量（流入服务器的流量）不计费。 包年/包月 套餐单月费用*购买时长 超额流量（可能费用） 业务流量优先抵扣套餐内的流量包，流量包使用完后将产生超额流量。超额流量以按流量计费的方式收取费用。超额流量的单价为0.8元/GB。 须知： 因超额流量导致账号欠费，可能会引起Flexus L实例的弹性公网IP资源将被释放，请保证账户余额充足。更多信息详见超额流量引起欠费的影响是什么。 按量付费 流量单价*超额流量

退订 Flexus应用服务器L实例以套餐形式整体管理， 套餐内资源统一退订，退订后Flexus应用服务器L实例包含的云硬盘、云备份、主机安全、公网IP地址等所有资源将被释放，数据丢失且不可恢复。 退订包括退订资源和退订续费周期。退订后，华为云将退还相应的款项。 退订资源：当您想终止Flexus应用服务器L实例时，您可退订不需要的Flexus应用服务器L实例（退订资源包括退订续费周期）。详细的退订计费规则请参见退订资源。 退订续费周期：Flexus应用服务器L实例创建成功后，若已进行续费操作，可选择单独退订续费周期。退订续费周期指只能退订未生效的续费周期部分，已生效的续费周期只能退订Flexus应用服务器L实例。详细的退订计费规则请参见退订续费周期。

售卖模式 Flexus L实例以套餐形式售卖管理， 套餐内资源生命周期跟随Flexus L实例，即套餐内资源不支持和Flexus L实例解除关联关系、套餐内资源统一续费/退订。 Flexus L实例套餐内的资源指在Flexus L实例控制台购买的资源。在云备份、主机安全等服务控制台购买并关联到Flexus L实例的资源，支持和Flexus L实例解除关联并退订或删除。 单独购买的Flexus负载均衡和Flexus L实例配套使用，不属于Flexus L实例套餐内资源，可以和Flexus L实例解除关联关系并退订。

Flexus应用服务器L实例计费项 本小节计费项指可灵活选购数据盘、云备份、主机安全的Flexus L实例计费项，该计费项和Flexus服务组合计费项略有差异，Flexus服务组合计费项详见Flexus服务组合计费项。 标 * 的计费项为必选计费项。 计费项 计费说明 计费模式 费用 * 实例 不同规格的实例规格提供不同的计算、存储、网络能力，您可根据实际需要选择合适的实例规格。 计费因子：vCPU/内存、系统盘、流量包。 说明： Flexus L实例仅对出网流量（从服务器流出的流量）计费，入网流量（流入服务器的流量）不计费。 包年/包月 套餐单月费用*购买时长 * 镜像 Flexus L实例中仅系统镜像中的Windows镜像计费，其他镜像免费。 计费因子：镜像 说明： 为方便您操作，Flexus L实例购买页“系统镜像”页签下展示了非华为云自营的Windows操作系统镜像。 包年/包月 镜像单价*购买时长 数据盘 如有额外的存储需求，您需要购买数据盘。 计费因子：数据盘容量。 包年/包月 云硬盘单价 * 购买时长 主机安全 如有主机安全防护需求，您需要随Flexus L实例开启安全防护能力。 计费因子：主机安全基础版。 包年/包月 主机安全单价 * 购买时长 云备份 如有备份需求，您可以随Flexus L实例购买备份存储库，用来存放服务器产生的备份副本。 计费因子：存储库容量。 包年/包月 存储库容量单价 * 购买时长 Flexus负载均衡 您可根据业务需求选择购买Flexus负载均衡，不购买不收费用。 包年/包月 套餐单月费用*购买时长 云监控 云监控服务 基础功能免费，包括查看监控看板、创建告警规则、添加监控项等。同时云监控服务与其他云服务组合使用，为您提供监控数据文件转储、发送告警通知等增值服务，这些增值服务可能产生额外费用，具体由提供该功能的服务结算。 - 基础功能免费，增值服务费用详见 CES 服务资费。 超额流量（可能费用） 业务流量优先抵扣套餐内的流量包，流量包使用完后将产生超额流量。超额流量以按流量计费的方式收取费用。超额流量的单价为0.8元/GB。 须知： 因超额流量导致账号欠费，可能会引起Flexus L实例的弹性公网IP资源将被释放，请保证账户余额充足。更多信息详见超额流量引起欠费的影响是什么。 按量付费 流量单价*超额流量

修订记录 发布日期 修订说明 2021-08-30 SDK迭代更新，提供Java、Python、Node.js、PHP、C++、Go、.NET版本，历史SDK下线，停止维护。 2021-03-12 新增 PHP SDK C++ SDK CS harp SDK 2020-04-30 修改 Java SDK Python SDK iOS SDK Android SDK Node.js SDK 2019-02-02 修改 将 文字识别 对应Endpoint修改为“ocr.cn-north-1.myhuaweicloud.com”。 2018-12-12 新增 文字识别服务SDK环境搭建，新增Python、iOS、Android、Node.js开发环境配置方法。 使用文字识别SDK，新增Python、iOS、Android、Node.js示例。 2018-09-12 修改 申请服务操作步骤参见文档为《文字识别API参考》。 2018-07-30 修改 删除银行卡识别、一维码识别、二维码识别和车牌识别相关内容。 2018-05-10 新增 银行卡识别服务的demo用例 一维码识别服务的demo用例 二维码识别服务的demo用例 车牌识别服务的demo用例 机动车销售发票识别的demo用例 通用文字识别 的demo用例 2017-12-30 第一次正式发布。

文字识别SDK概述 文字识别（Optical Character Recognition，简称OCR）将图片或扫描件中的文字识别成可编辑的文本。可代替人工录入，提升业务效率。支持身份证、驾驶证、行驶证、发票、通用表格、通用文字等场景文字识别。 文字识别以开放API（Application Programming Interface，应用程序编程接口）的方式提供给用户，用户通过实时访问和调用API获取推理结果，帮助用户提升业务效率。 文字识别服务软件开发工具包（OCR SDK，Optical Character Recognition Service Software Development Kit）是对OCR服务提供的REST API进行的封装，以简化用户的开发工作。用户直接调用OCR SDK提供的接口函数即可实现使用OCR服务业务能力的目的。 我们针对不同语言的SDK提供了开发指南： 表1 不同语言SDK的开发指南 编程语言 开发指南 Java Java SDK 开发指南 Python Python SDK 开发指南 Node.js Node.js SDK 开发指南 PHP PHP SDK 开发指南 C++ C++ SDK 开发指南 Go Go SDK 开发指南 NET NET SDK 开发指南

安装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是华为云各服务应用区域和各服务的终端节点，详情请查看 地区和终端节点 。 发送请求并查看响应 // 以调用通用 表格识别 接口 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); }

开始使用 导入依赖模块 import ( "fmt" "github.com/huaweicloud/huaweicloud-sdk-go-v3/core/auth/basic" ocr "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/ocr/v1" "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/ocr/v1/model" region "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/ocr/v1/region" ) 配置认证信息 配置AK、SK信息。华为云通过AK识别用户的身份，通过SK对请求数据进行签名验证，用于确保请求的机密性、完整性和请求者身份的正确性。AK、SK获取方法请参见准备工作。 func main() { ak := os.Getenv("HUAWEICLOUD_SDK_AK") sk := os.Getenv("HUAWEICLOUD_SDK_SK") auth := basic.NewCredentialsBuilder(). WithAk(ak). WithSk(sk). Build() } 认证用的 ak 和sk 硬编码到代码中或者明文存储都有很大的安全风险，建议在配置文件或者环境变量中密文存放，使用时解密，确保安全。 本示例以 ak 和 sk 保存在环境变量中来实现身份验证为例，运行本示例前请先在本地环境中设置环境变量HUAWEICLOUD_SDK_AK和HUAWEICLOUD_SDK_SK。 初始化客户端（二选一） 指定云服务region方式（推荐） // 初始化指定云服务的客户端 New{Service}Client，以初始化华北-北京四（cn-north-4）区域服务为例 func main() { client := ocr.NewOcrClient( ocr.OcrClientBuilder(). WithRegion(region.ValueOf("cn-north-4")). WithCredential(auth). Build()) } 指定云服务endpoint方式 func main() { // 指定终端节点，以OCR服务北京四的endpoint为例 endpoint:="https://ocr.cn-north-4.myhuaweicloud.com" // 使用endpoint方式，在认证信息中需新增projectId auth := basic.NewCredentialsBuilder(). WithAk(ak). WithSk(sk). WithProjectId(projectId). Build() // 初始化指定云服务的客户端 New{Service}Client client := ocr.NewOcrClient( ocr.OcrClientBuilder(). WithEndpoint(endpoint). WithCredential(auth). Build()) } endpoint是华为云各服务应用区域和各服务的终端节点，详情请查看 地区和终端节点 。 发送请求并查看响应 // 以调用通用表格识别接口 RecognizeGeneralTable 为例 request := &model.RecognizeGeneralTableRequest{} urlGeneralTableRequestBody:= "图片的url" request.Body = &model.GeneralTableRequestBody{ Url: &urlGeneralTableRequestBody, } response, err := client.RecognizeGeneralTable(request) if err == nil { fmt.Printf("%+v\n", response) } else { fmt.Println(err) } 异常处理 表1 异常处理 一级分类 一级分类说明 ServiceResponseError 服务响应异常 url.Error url异常 response, err := client.RecognizeGeneralTable(request) if err == nil { fmt.Printf("%+v\n", response) } else { fmt.Println(err) }

安装SDK 推荐使用 Composer 安装 SDK 。 Composer 是 Php 的依赖管理工具，允许您在项目中声明依赖关系并安装这些依赖： // 安装 Composer curl -sS https://getcomposer.org/installer | php // 安装 PHP SDK composer require huaweicloud/huaweicloud-sdk-php 安装完毕后，你需要引入 Composer 的自动加载文件： require 'path/to/vendor/autoload.php';

开始使用 导入依赖模块 from huaweicloudsdkcore.auth.credentials import BasicCredentials from huaweicloudsdkcore.exceptions import exceptions from huaweicloudsdkcore.http.http_config import HttpConfig # 导入指定云服务的库 huaweicloudsdk{service} from huaweicloudsdkocr.v1.region.ocr_region import OcrRegion from huaweicloudsdkocr.v1 import * 配置客户端连接参数 默认配置 # 使用默认配置，如出现'HttpConfig' is not defined报错，请检查是否已正确安装sdk config = HttpConfig.get_default_config() 网络代理（可选） # 根据需要配置网络代理 config.proxy_protocol = 'http' config.proxy_host = 'proxy.huaweicloud.com' config.proxy_port = 80 config.proxy_user = 'username' config.proxy_password = 'password' 超时配置（可选） # 默认连接超时时间为60秒，读取超时时间为120秒，支持统一指定超时时长timeout=timeout，或分别指定超时时长timeout=(connect timeout, read timeout) config.timeout = 120 SSL配置（可选） # 根据需要配置是否跳过SSL证书校验 config.ignore_ssl_verification = True # 配置服务器端CA证书，用于SDK验证服务端证书合法性 config.ssl_ca_cert = ssl_ca_cert 客户端连接参数配置完成后需在初始化客户端client中配置“with_http_config(config)”相应的代码，详情请参见4.初始化客户端（二选一）中的client后的代码。 配置认证信息 配置AK、SK、project_id信息。华为云通过AK识别用户的身份，通过SK对请求数据进行签名验证，用于确保请求的机密性、完整性和请求者身份的正确性。有两种认证方式，分别如下。 初始化认证信息： ak = os.environ.get("HUAWEICLOUD_SDK_AK") sk = os.environ.get("HUAWEICLOUD_SDK_SK") 认证用的 ak 和sk 硬编码到代码中或者明文存储都有很大的安全风险，建议在配置文件或者环境变量中密文存放，使用时解密，确保安全。 本示例以 ak 和 sk 保存在环境变量中来实现身份验证为例，运行本示例前请先在本地环境中设置环境变量HUAWEICLOUD_SDK_AK和HUAWEICLOUD_SDK_SK。 使用永久AK和SK credentials = BasicCredentials(ak, sk, project_id) 使用临时AK和SK credentials = BasicCredentials(ak, sk, project_id).with_security_token(security_token) 认证参数说明： ak、sk：访问密钥信息，获取方法请参见准备工作。 project_id：华为云项目ID，获取方法请参见准备工作。 security_token：临时认证场景下的安全票据，可以通过token获取或者通过委托授权获取。 初始化客户端（二选一） 指定region方式（推荐） # 增加region依赖 from huaweicloudsdkocr.v1.region.ocr_region import OcrRegion # 初始化指定云服务的客户端 {Service}Client ，以初始化OCR服务的 OcrClient 为例 client = OcrClient.new_builder() \ .with_http_config(config) \ .with_credentials(credentials) \ .with_region(OcrRegion.value_of("cn-north-4")) \ .build() 指定云服务endpoint方式 # 指定终端节点，以 OCR 服务北京四的 endpoint 为例 endpoint = "https://ocr.cn-north-4.myhuaweicloud.com" # 初始化指定云服务的客户端 {Service}Client ，以初始化OCR服务的 OcrClient 为例 client = OcrClient.new_builder() \ .with_http_config(config) \ .with_credentials(credentials) \ .with_endpoint(endpoint) \ .build() endpoint是华为云各服务应用区域和各服务的终端节点，详情请查看 地区和终端节点 。 发送请求并查看响应 # 以调用通用表格识别接口 RecognizeGeneralTable 为例 request = RecognizeGeneralTableRequest() request.body = GeneralTableRequestBody( url="图片的url" ) response = client.recognize_general_table(request) print(response) 异常处理 表1 异常处理 一级分类 一级分类说明 二级分类 二级分类说明 ConnectionException 连接类异常 HostUnreachableException 网络不可达、被拒绝。 SslHandShakeException SSL认证异常。 RequestTimeoutException 响应超时异常 CallTimeoutException 单次请求，服务器处理超时未返回。 RetryOutageException 在重试策略消耗完成后，仍无有效的响应。 ServiceResponseException 服务器响应异常 ServerResponseException 服务端内部错误，Http响应码：[500,]。 ClientRequestException 请求参数不合法，Http响应码：[400, 500) # 异常处理 try: request = RecognizeGeneralTableRequest() response = client.recognize_general_table(request) print(response) except exceptions.ClientResponseException as e: print(e.status_code) print(e.request_id) print(e.error_code) print(e.error_msg)

安装SDK 支持Python3及以上版本，执行python --version检查当前Python的版本信息。 使用SDK前，需要安装“huaweicloudsdkcore”和“huaweicloudsdkocr”，有两种安装方式，分别如下。 使用pip安装 #回显Successfully installed xxx表示安装成功 # 安装核心库 pip install huaweicloudsdkcore # 安装OCR服务库 pip install huaweicloudsdkocr 使用源码安装 SDK版本可通过 SDK中心 查询。 # 安装核心库 cd huaweicloudsdkcore-${version} python setup.py install # 安装OCR服务库 cd huaweicloudsdkocr-${version} python setup.py install

开始使用 导入依赖模块 package com.huaweicloud.sdk.test; import com.huaweicloud.sdk.core.auth.ICredential; // 对用户身份进行认证 import com.huaweicloud.sdk.core.auth.BasicCredentials; // 请求异常类 import com.huaweicloud.sdk.core.exception.ConnectionException; import com.huaweicloud.sdk.core.exception.RequestTimeoutException; import com.huaweicloud.sdk.core.exception.ServiceResponseException; // 导入OCR客户端 import com.huaweicloud.sdk.ocr.v1.region.OcrRegion; import com.huaweicloud.sdk.ocr.v1.*; import com.huaweicloud.sdk.ocr.v1.model.*; 配置客户端连接参数 默认配置 // 使用默认配置 HttpConfig config = HttpConfig.getDefaultHttpConfig(); 网络代理（可选） // 根据需要配置网络代理，网络代理默认的协议为 `http` 协议 config.withProxyHost("proxy.huaweicloud.com") .withProxyPort(8080) .withProxyUsername("test") .withProxyPassword("test"); 超时配置（可选） // 默认连接超时时间为60秒，可根据需要调整 config.withTimeout(60); SSL配置（可选） // 根据需要配置是否跳过SSL证书验证 // 执行SDK时出现javax.net.ssl.SSLHandshakeException: Received fatal alert: handshake_failure报错，可添加此代码，跳过SSL证书验证 config.withIgnoreSSLVerification(true); 配置认证信息 配置AK、SK、project_id信息。华为云通过AK识别用户的身份，通过SK对请求数据进行签名验证，用于确保请求的机密性、完整性和请求者身份的正确性。有两种认证方式，分别如下。 初始化认证信息： String ak = System.getenv("HUAWEICLOUD_SDK_AK"); String sk = System.getenv("HUAWEICLOUD_SDK_SK"); 认证用的 ak 和 sk 硬编码到代码中或者明文存储都有很大的安全风险，建议在配置文件或者环境变量中密文存放，使用时解密，确保安全。 本示例以 ak 和 sk 保存在环境变量中来实现身份验证为例，运行本示例前请先在本地环境中设置环境变量HUAWEICLOUD_SDK_AK和HUAWEICLOUD_SDK_SK。 如果没有设置环境变量，可以去掉System.getenv方法调用，直接填写对应的 ak、sk，例如：String ak = "ak"; String sk = "sk"。 使用永久AK和SK BasicCredentials basicCredentials = new BasicCredentials() .withAk(ak) .withSk(sk) .withProjectId(projectId); 使用临时AK和SK BasicCredentials basicCredentials = new BasicCredentials() .withAk(ak) .withSk(sk) .withSecurityToken(securityToken) .withProjectId(projectId) 认证参数说明： ak、sk：访问密钥信息，获取方法请参见准备工作。 projectId：华为云项目ID，获取方法请参见准备工作。 securityToken：临时认证场景下的安全票据，可以通过token获取或者通过委托授权获取。 初始化客户端（二选一） 指定region方式（推荐） // 增加region依赖 import com.huaweicloud.sdk.ocr.v1.region.OcrRegion; // 初始化客户端认证信息，使用当前客户端初始化方式可不填 projectId/domainId ICredential auth = new BasicCredentials() .withAk(ak) .withSk(sk); // 初始化指定云服务的客户端 {Service}Client ，以初始化OCR服务的 OcrClient 为例 OcrClient Client = OcrClient.newBuilder() .withHttpConfig(config) .withCredential(auth) .withRegion(OcrRegion.valueOf("cn-north-4")) .build(); 指定云服务endpoint方式 // 指定终端节点，以OCR服务北京四的 endpoint 为例 String endpoint = "https://ocr.cn-north-4.myhuaweicloud.com"; // 初始化客户端认证信息，需要填写相应 projectId/domainId，以初始化 BasicCredentials 为例 BasicCredentials basicCredentials = new BasicCredentials() .withAk(ak) .withSk(sk) .withProjectId(projectId); // 初始化指定云服务的客户端 {Service}Client ，以初始化 Region 级服务OCR的 OcrClient 为例 OcrClient ocrClient = OcrClient.newBuilder() .withHttpConfig(config) .withCredential(basicCredentials) .withEndpoint(endpoint) .build(); endpoint是华为云各服务应用区域和各服务的终端节点，详情请查看 地区和终端节点 。 发送请求并查看响应 // 以调用通用表格识别接口 RecognizeGeneralTable 为例 RecognizeGeneralTableRequest request = new RecognizeGeneralTableRequest(); GeneralTableRequestBody body = new GeneralTableRequestBody(); body.withUrl("图片的url"); request.withBody(body); try { RecognizeGeneralTableResponse response = client.recognizeGeneralTable(request); System.out.println(response.toString()); } catch (ConnectionException e) { e.printStackTrace(); } catch (RequestTimeoutException e) { e.printStackTrace(); } catch (ServiceResponseException e) { e.printStackTrace(); System.out.println(e.getHttpStatusCode()); System.out.println(e.getErrorCode()); System.out.println(e.getErrorMsg()); } 异常处理 表1 异常处理 一级分类 一级分类说明 二级分类 二级分类说明 ConnectionException 连接类异常 HostUnreachableException 网络不可达、被拒绝。 SslHandShakeException SSL认证异常。 RequestTimeoutException 响应超时异常 CallTimeoutException 单次请求，服务器处理超时未返回。 RetryOutageException 在重试策略消耗完成后，仍无有效的响应。 ServiceResponseException 服务器响应异常 ServerResponseException 服务端内部错误，Http响应码：[500,]。 ClientRequestException 请求参数不合法，Http响应码：[400, 500) // 异常处理 try { RecognizeGeneralTableRequest request = new RecognizeGeneralTableRequest(); RecognizeGeneralTableResponse response = client.recognizeGeneralTable(request); System.out.println(response.toString()); } catch(ServiceResponseException e) { logger.error("HttpStatusCode: " + e.getHttpStatusCode()); logger.error("RequestId: " + e.getRequestId()); logger.error("ErrorCode: " + e.getErrorCode()); logger.error("ErrorMsg: " + e.getErrorMsg()); }

发票状态说明 状态 说明 可进行的操作 待审核 等待发票专员审核。1个工作日可完成审核。 撤销、详情、发票预览 已驳回 发票审核时被驳回，可在发票列表中查看驳回原因，客户也会收到驳回通知。 删除、详情、发票预览 开票中 正在开具发票。纸质票需要1-3个工作日，电子票一般实时开具。 该状态下的纸质票可以申请撤销。 撤销、详情、发票预览 撤销中 纸质票为“开票中”时发起撤销申请，需要发票专员审核，1-3个工作日可完成撤销。 详情、发票预览 已撤销 发票申请已经撤销成功，客户可以重新申请开票。 详情、发票预览 开票中（撤销失败） 客户发起的撤销申请被驳回，会导致发票撤销失败。客户可以在发票列表中查看撤销失败原因，也会收到撤销失败的通知。 详情、发票预览 待签收 纸质票已经邮寄给客户（具体邮寄时长以物流信息为准），客户收到发票后需要进行签收（单击操作列“确认”）。 确认、详情、发票预览 已开票 发票已开具完成。 “已开票”的电子票可以进行下载，也可以申请退票。 “已开票”的纸质票表示客户已经签收成功，该状态下可以申请退票。 下载（电子票）、退票、详情、发票预览 已开票（退票中） 客户发起退票，退票处理中。纸质票需要1-3个工作日。电子票一般实时开具。 下载（电子票）、详情、发票预览。 已开票（退票驳回） 客户发起的退票被驳回，可以在发票列表中查看驳回原因。 下载（电子票）、退票、详情、发票预览 已退票 退票已完成。 详情、发票预览

操作步骤 进入“发票管理”页面。 单击“华为云可开票金额”金额后面的“索取发票”。 选择签约主体(如： 华为云计算 技术有限公司/华为软件技术有限公司)页签。 根据实际需求，选择开票方式，申请开票。 按账单明细开票 选择“按账单明细开票”，勾选要开票的订单号/账期。 按订单/账单消费发生时间由近及远展示每一笔消费明细及对应可开票金额。 若按账单明细开票到达选择上限1000条，建议您尝试选择按月汇总开票。 支持按消费发生时间，选定日期范围、输入单个订单号或账期月份搜索查询消费明细及对应可开票金额。 支持按类型、产品类型和账号查询消费明细及对应可开票金额。 按账单明细开票（类型：订单消费） 预付费用户新购、续费、变配包年/包月产品，订单交易成功后可开具发票。 后付费用户新购、续费、变配包年/包月产品，产生的消费账单在次月3日出账后生成开票金额，建议次月4日10点后索取发票。 按账单明细开票（类型：账单） 按需结算单：按需消费不能实时开票，产生的消费账单在次月3日出账后生成开票金额，建议次月4日10点后索取发票。 月付结算单：客户购买和使用“半预付+月付”计费模式产品产生的账单在次月3日出账后生成开票金额，建议次月4日10点后索取发票。 按月汇总开票 选择“按月汇总开票”。勾选要开票的账单。 按账单月份由近及远展示每个月账单汇总费用情况及对应可开票金额。 支持按账期，选定日期范围搜索查询每个月账单汇总费用情况及对应可开票金额。 支持展开并查看月账单明细。 指定金额开票 选择“指定金额开票”，输入开票金额（输入值不能大于文本框中的提示金额），单击页面空白处。系统根据您输入的开票金额，按照消费时间由远及近进行匹配可开票的账单明细/按月汇总。 （可选）客户也可自行指定需要开票的账单。 单击“自定义修改”，选择消费记录类型（账单明细/按月汇总），在消费明细中选择需要开票的账单并指定开票金额。 当前指定开票总金额（即：客户自定义的开票金额总和-欠票金额）需与“输入开票金额”保持一致。 如下图所示：当前指定开票总金额=(-3.50+3.50+0.15)-0.00=0.15 核对待开票金额，单击“下一步”。 在确认发票信息和地址页面，新增或修改发票抬头信息、选择发票介质，填写备注信息，单击“下一步”。 新增发票抬头信息 单击“新增发票信息”，可新增发票抬头信息。 增值税发票仅面向中国大陆客户，港澳台及海外企业客户无法开具此类发票。 实名认证为个人的客户，只能创建个人或组织抬头的发票模板。 实名认证为企业的客户，只能创建企业或组织抬头的发票模板。开具企业发票时，发票抬头需与实名认证主体保持一致，如果需要开具其他企业抬头的发票，请先修改实名认证信息，或申请后台为您添加新的企业抬头模板，申请规则请参考企业发票抬头规则。 每个云账号只能设置1个有效的发票模板，如果需要新增发票模板，请联系客服进行申请。 修改发票抬头信息 修改发票类型（普通发票和专用发票切换）：从“发票类型”下拉框中选择。 抬头类型为“个人”或“组织”时，只支持普通发票，不支持切换。 发票抬头是“企业”时，从专用发票切换成普通发票，直接从下拉框选择即可。 发票抬头是“企业”时，从普通发票切换成专用发票，从下拉框选择专票时，如果专票信息不完整，需要根据页面提示补充相关信息。 修改发票模板：单击操作列“修改”。 删除发票模板：单击操作列“删除”。 设置默认发票抬头：单击操作列“设置默认”。 选择发票介质 数电发票 客户可单击“设置”，选择数电票的接收邮箱。 如果没有合适的接收人，可进入“消息中心”进行操作。 只有验证过的邮箱才允许使用，如需验证邮箱，请进入消息中心进行操作。 电子票申请通过后，可以直接在费用中心进行下载。 电子发票 客户可单击“设置”，选择电子票的接收邮箱。 如果没有合适的接收人，可进入“消息中心”进行操作。 只有验证过的邮箱才允许使用，如需验证邮箱，请进入消息中心进行操作。 电子票申请通过后，可以直接在费用中心进行下载。 纸质发票 单击“新增收件地址”，可新增收件地址信息。也可单击“修改”或“删除“，对已新增的收件地址进行修改或删除。 纸质票申请通过后，华为云的客服人员会在3个工作日内将发票通过顺丰快递寄出。如果开票金额小于¥10.00，客户需要支付快递费用。 填写备注信息 备注信息会生成在发票的备注内容区域。 在发票预览页面，不同税率的发票会分页展示。 核对发票信息无误后，单击“提交”，完成开票申请。 图2 增值税普通发票样例 图3 增值税专用发票样例

注意事项 增值税发票仅面向中国大陆客户，港澳台及海外企业客户无法开具此类发票。 可开票产品包括 华为云产品 和在云商店购买的联营商品、华为商品。 增值税普通发票开具规则为：为顺应国家税务总局数电发票政策，自2024年11月底开始，当客户签约主体为华为云计算技术有限公司时，增值税普通发票将仅支持开具数电发票，不再支持开具纸质发票。当客户签约主体不是华为云计算技术有限公司时，增值税普通发票支持电子普票和纸质普票。 增值税专用发票开具规则为：为顺应国家税务总局数电发票政策，自2024年11月底开始，当客户签约主体为华为云计算技术有限公司时，增值税专用发票将仅支持开具数电发票，不再支持开具纸质发票。当客户签约主体不是华为云计算技术有限公司时，增值税专用发票仅支持纸质专票。 代金券消费不纳入可开票金额。 购买储值卡可以开票，但是储值卡消费不纳入可开票金额。 开票金额小于10元，且发票介质为纸质票时，客户自行承担快递费用。 一张发票只能有一个税率。当开具发票的产品税率有多个时，系统会自动生成多张发票。 只有同等税率的消费和欠票才可以冲抵。 客户申请合作伙伴代支付时，客户可以直接在费用中心开具发票，开具增值税发票后，不能进行退订操作。 按月汇总索取发票时，如果该账期为欠费状态，则需要还清欠款后才能进行开票操作。 代售类子客户请联系您关联的合作伙伴索取发票。 企业主客户代企业子客户开票，企业主客户和企业子客户关联关系为同一法人时，企业主客户代企业子客户开具的发票可以选择企业主客户创建的发票模板。 抬头类型为企业时，才可以开具增值税专用发票。

步骤四：修改客户端配置文件 开启SSL双向认证后，需要在客户端的“consumer.properties”和“producer.properties”文件中，分别修改服务端证书配置，并增加客户端证书配置。 security.protocol=SSL ssl.truststore.location=/opt/kafka_2.12-2.7.2/config/client.truststore.jks ssl.truststore.password=dms@kafka ssl.endpoint.identification.algorithm= #增加以下的客户端证书配置 ssl.keystore.location=/var/private/ssl/kafka/client.keystore.jks ssl.keystore.password=txxx3 ssl.key.password=txxx3 security.protocol配置证书协议类型，开启SSL双向认证时，必须设置为SSL。 ssl.truststore.location配置为client.truststore.jks证书的存放路径。 ssl.truststore.password为client.truststore.jks的密码。 ssl.endpoint.identification.algorithm为证书域名校验开关，为空则表示关闭。这里需要保持关闭状态，必须设置为空。 ssl.keystore.location配置为client.keystore.jks证书的存放路径。 ssl.keystore.password配置为client.keystore.jks的密码。 ssl.key.password配置为client.keystore.jks的密码。

约束与限制 如果“allow.everyone.if.no.acl.found”设置为“true”，且Topic未授权任何用户，此时所有的用户都可以订阅/发布此Topic。如果Topic已授权某一个或多个用户，此时只有授权的用户可以订阅/发布此Topic，其他未授权的用户不能订阅/发布此Topic。“allow.everyone.if.no.acl.found”在配置参数中修改。 如果“allow.everyone.if.no.acl.found”设置为“false”，此时只有授权的用户可以订阅/发布此Topic，其他未授权的用户不能订阅/发布此Topic。“allow.everyone.if.no.acl.found”在配置参数中修改。 如果Topic同时设置了“默认用户”权限和单个用户权限，取两者的并集。 单机实例不支持设置Topic权限。

步骤三：添加DNAT规则 在“公网NAT网关”页面，在新购买的公网NAT网关后，单击“设置规则”，进入公网NAT网关详情页。 在“DNAT规则”页签，单击“添加DNAT规则”，弹出“添加DNAT规则”对话框。 图3 公网NAT网关详情页 设置如下参数。 使用场景：选择“虚拟私有云” 端口类型：选择“具体端口” 支持协议：选择“TCP” 公网IP类型：选择“弹性公网IP”，在下拉框中选择已购买的弹性公网IP 公网端口：输入“9011” 实例类型：选择“自定义” 私网IP：输入获取Kafka实例的信息中记录的Kafka实例的一个内网连接地址 私网端口：输入“9011” 如果想要了解更多的参数信息，请参考添加DNAT规则。 图4 添加DNAT规则 单击“确定”，完成DNAT规则的添加。 DNAT规则添加成功后，在DNAT规则列表中查看此规则的状态，若“状态”为“运行中”，表示创建成功。 为获取Kafka实例的信息中记录的其他内网连接地址创建DNAT规则，每个DNAT规则需要设置不同的弹性公网IP。 创建DNAT规则的具体步骤参考2~4。 DNAT规则全部创建成功后，在“DNAT规则”页签，查看已创建的DNAT规则，并记录私网IP对应的弹性公网IP。 图5 DNAT规则列表

步骤五：验证接口连通性 参考使用客户端连接Kafka（关闭SASL）或者使用客户端连接Kafka（开启SASL），测试是否可以生产和消费消息。 测试接口连通性时，注意以下几点： 连接Kafka实例的地址为“advertised.listeners IP:9011”，以图6为例，连接Kafka实例的地址为“124.xxx.xxx.167:9011,124.xxx.xxx.174:9011,124.xxx.xxx.57:9011”。 在Kafka实例安全组的入方向规则中放通9011端口。 连接Kafka实例的客户端已开启公网访问功能。

Smart Connect监控指标 表5 Smart Connect支持的监控指标 指标ID 指标名称 指标含义 取值范围 测量对象 监控周期（原始指标） kafka_wait_synchronize_data 待同步Kafka数据量 Kafka任务的待同步数据量。 单位：Count ≥ 0 Kafka实例的Smart Connect任务 1分钟 kafka_synchronize_rate Kafka每分钟同步数据量 Kafka任务每分钟同步的数据量。 单位：Count ≥ 0 Kafka实例的Smart Connect任务 1分钟 task_status 任务状态 当前任务状态。 0：任务异常 1：任务正常 Kafka实例的Smart Connect任务 1分钟 message_delay 消息时延 消息到达源端的时间与到达目标端的时间之差。 单位：ms ≥ 0 Kafka实例的Smart Connect任务 1分钟 使用Smart Connect监控指标时，请注意如下几点： Kafka双向数据复制的Smart Connect任务在监控中会被拆分为2个任务，分别为“Smart Connect任务名_source_0”和“Smart Connect任务名_source_1”。 如果Topic中的消息在进行下一次数据同步前，已经全部老化，此时实际是没有待同步的Kafka数据，但是Kafka数据同步监控指标使用的是包含老化数据的offset值，“待同步Kafka数据量”会显示老化的消息数。