华为云用户手册

响应参数 返回状态码为200：查询成功。 表2 DevicePerformanceResp对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string 0~10个字符。 - 错误码。 "0" errmsg string 0~256个字符。 - 错误信息。 "" data ARRAY_REFERENCE 0-2147483647个列表项，详细请参见表3。 查询到的设备性能数据信息。 - 表3 DevicePerformance对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 id string 0~256个字符。 - 设备标识。 "ea25fdbf-8dee-4823-bac2-5bfe8e3359ca" name string 0~256个字符。 - 设备名称。 "device1" esn string 0~256个字符。 - 设备ESN号。 "1102350DMJ1111111111" deviceIp string 0~256个字符。 - 设备IP。 "10.190.12.10" neType string 0~256个字符。 - 具体的设备款型。 "S5320-52P-SI-AC" status integer [0-10] - 设备状态，0---在线、1---告警、2---故障、3---离线、4---未注册。 0 gisLon number [0-340282350000000000000000000000000000000] - 设备位置经度。 120.1 gisLat number [0-340282350000000000000000000000000000000] - 设备位置纬度。 10.2 traffic number [0-340282350000000000000000000000000000000] - 总流量，单位：字节。 10.2 onlineUsers integer [0-2147483647] - 终端连接数。 10 cpuRate integer [0-100] - CPU利用率，单位：百分比。 - memoryRate integer [0-100] - 内存利用率，单位：百分比。 - upwardSpeed number [0-340282350000000000000000000000000000000] - 上行速率，单位：bps。 10.2 downwardSpeed number [0-340282350000000000000000000000000000000] - 下行速率，单位：bps。 10.2 mac string 0~256个字符。 - MAC地址。 "xx:xx:xx:xx:xx:xx" timestamp int64 [0-1988121600] - 最近一次上报的时间戳 1687854074 返回状态码为400：参数非法，查询失败。 详细信息请参见实际响应消息体。

响应示例 返回状态码为200：查询成功。 HTTP/1.1 200 OK Date: Fri,25 Aug 2023 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive { "errcode" : "0", "errmsg" : "", "data" : [ { "id" : "ea25fdbf-8dee-4823-bac2-5bfe8e3359ca", "name" : "device1", "esn" : "1102350DMJ1111111111", "deviceIp" : "10.190.12.10", "neType" : "S5320-52P-SI-AC", "status" : 0, "gisLon" : 120.1, "gisLat" : 10.2, "traffic" : 10.2, "onlineUsers" : 10, "cpuRate" : "", "memoryRate" : "", "upwardSpeed" : 10.2, "downwardSpeed" : 10.2, "mac" : "xx:xx:xx:xx:xx:xx", "timestamp" : 1687854074 } ] } 返回状态码为400：参数非法，查询失败。 HTTP/1.1 400 Bad Request Date: Fri,25 Aug 2023 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive

配置思路 组建堆叠系统。 在华为乾坤云平台添加设备和创建堆叠。 准备IP网络环境，在DHCP服务器中配置选项148。本案例以FW作为DHCP服务器，且AR设备已注册至华为乾坤云平台。 堆叠设备上电启动，确保设备以空配置启动，如果存在配置文件，可以执行reset saved-configuration命令删除配置并重启。 设备获取IP地址后，会尝试通过DHCP option 148与华为乾坤云平台通信。 等待设备注册至华为乾坤云平台，开局成功。 父主题： 配置举例：交换机通过DHCP Option148方式上云（堆叠场景）

快速部署 本章节主要帮助用户快速部署“人证核身”解决方案。 表1 参数填写说明 参数名称 类型 是否必填 参数解释 默认值 api_name String 必填 API名称，该方案使用共享版API网关，对外提供API服务。取值范围：3~53个字符，中英文字符开头，只能由中英文字符、数字、中划线（-）、下划线组成（_），中文字符必须是UTF-8或Unicode格式。 id_verification_demo 登录华为云解决方案实践人证核身解决方案，单击一键部署。 图1 方案主页 在选择模板界面中，单击“下一步：配置参数”。 图2 创建堆栈 在配置参数界面中，自定义填写堆栈名称，根据表1填写配置参数信息，单击“下一步”。 图3 参数配置 在资源设置界面中，在权限委托下拉框中选择“rf_admin_trust”委托，单击“下一步”。 图4 资源栈设置 在配置确认界面中，单击“创建执行计划”。 图5 配置确认 在弹出的创建执行计划框中，自定义填写执行计划名称，单击“确定”。 图6 创建执行计划 单击“部署”，并且在弹出的执行计划确认框中单击“执行”。 图7 执行计划 图8 执行计划确认 待“事件”中出现“Apply required resource success”，表示该解决方案已经部署完成。 图9 部署完成 父主题： 实施步骤

开始使用 表1 参数填写说明 参数名称 类型 是否必填 参数解释 备注 actions String 是 动作代码顺序列表,英文逗号(,)分隔。建议单动作,目前支持的动作有: 1:左摇头 2:右摇头 3:点头 4:嘴部动作（视频录制详见 表2 动作活体视频采集说明） 仅当actions的传参顺序和视频中的动作顺序一致时返回true。例如，视频中人物动作顺序为点头、嘴部动作，传参顺序需为3,4。 如果上传视频动作顺序与填写动作顺序不一致时，活体检测服务校验失败，服务终止。 video_url String 是 视频的URL路径,目前仅支持华为云上OBS的URL,且人脸识别服务有权限读取该OBS桶的数据。 开通读取权限的操作请参见服务授权。 视频要求: 视频Base64编码后大小不超过8MB。 限制视频时长1~15秒。 建议帧率10fps~30fps。 封装格式:mp4、avi、flv、webm、asf、mov。 视频编码格式: h261、h263、h264、hevc、vc1、vp8、vp9、wmv3。 格式：https://访问域名/文件名(带后缀) verification_name String 是 被验证人的姓名。 verification_id String 是 被验证人的身份证号码。 表2 动作活体视频采集说明 活体检测动作 动作示例 视频动作说明 左摇头 √，左摇头幅度正常。 ×，左摇头幅度过大，超出画面。 ×，左摇头幅度过大。 右摇头 √，右摇头幅度正常。 ×，右摇头幅度过大，超出画面。 ×，右摇头幅度过大。 点头 √，点头幅度正常。 ×，点头幅度过大，超出画面。 ×，点头幅度过大，检测不出人脸。 嘴部动作 正确，正常张闭嘴动作。 错误，嘴巴处于张开状态。 视频采集注意事项： 1、保证光线正常，不要出现背光、过亮或过暗等。 2、人脸需尽可能位于手机画面中央，不能太小或太大。 3、人脸尽可能与手机保持水平，避免过于仰视、俯视和侧视。 4、低头、左转或右转时，动作速度保持正常，不要过快或过慢，幅度不宜过大，整个动作过程中，人脸需要保证在手机画面中，不宜移出手机画面。 5、张嘴动作时，开始状态应处于合嘴状态，不宜处于张嘴或半张嘴状态。 6、整个动作期间，动作不宜太快和太慢，一个动作需在2~5秒内完成。不要出现突然动作，如突然转头、突然张大嘴等。 打开浏览器输入“”网址进入华为云官网，单击进入控制台 图1 进入华为云官网打开控制台 进入控制台页面后，在服务搜索中输入“API网关”进入 图2 进入API网关管理页面 单击共享版，进入共享版API网关管理页面 图3 单击进入共享版API网关管理页面 进入共享版API网关管理页面后，单击左侧导航栏“API管理”“API列表”单击已创建的API名称，进入对应API网关管理页面。 图4 进入对应API网关管理页面 单击调试，进入调试页面。 图5 准备调试 请求方法选择“GET”在查询参数中输入对应参数键和值（详见 表1 参数填写说明），单击发起请求，即可看到对应的响应结果。 图6 开始调试 表3 请求响应说明 响应示例 响应说明 [{'meta': {'uuid': '2022-05-16T09:57:00.539597'}, 'result': {'service_name': 'ivs-standard', 'count': 1, 'resp_data': [{'verification_result': 'valid', 'verification_message': 'Successful certification', 'verification_code': 1000, 'similarity': '94'}]}}, {'video-result': {'alive': True, 'actions': [{'action': 2, 'confidence': 0.9420696496963501}, {'action': 1, 'confidence': 0.918700635433197}, {'action': 3, 'confidence': 0.9200282096862793}], 'picture': '/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAMCAgMCAgMDAwMEAwMEBQgFBQQEBQoHBwYIDAoMDAsKCwsNDhIQDQ4RDgsLEBYQERMUFRUVDA8XGBYUGBIUFRT/2wBDAQMEBAUEBQkFBQkUDQsNFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFB...'}'warning-list': []}] 成功响应。 Failed to invoke the FRS service 活体检测服务调用失败，需检查“video_url”视频路径和“actions”动作参数是否输入正确。 living body verification failed 人脸识别活体检测服务校验未通过，服务终止。 Failed to invoke the IVS service 人证核身服务调用失败，需检查“verification_name”姓名和“verification_id”身份证号参数是否输入正确。 Failed to verify the certificate of the applicant 人证核身服务校验未通过，服务终止。 video_url or actions not obtained “video_url ”视频的URL路径，或者 “actions ”动作代码顺序列表，未传参。 verification_name or verification_id not obtained “verification_name ”被验证人的姓名，或者“verification_id ”被验证人的身份证号码，未传参。 父主题： 实施步骤

名词解释 基本概念、云服务简介、专有名词解释 API网关：APIG（Application Programming Interface，应用程序编程接口）是一些预先定义的函数，应用将自身的服务能力封装成API，并通过API网关开放给用户调用。API包括基本信息、前后端的请求路径和参数以及请求相关协议。 函数工作流FunctionGraph：函数工作流FunctionGraph是一项基于事件驱动的函数托管计算服务。使用FunctionGraph函数，只需编写业务函数代码并设置运行的条件，无需配置和管理服务器等基础设施，函数以弹性、免运维、高可靠的方式运行。此外，按函数实际执行资源计费，不执行不产生费用。 人脸识别服务—动作活体检测：动作活体检测是通过判断视频中的人物动作与传入动作列表是否一致来识别视频中人物是否为活体。如果有多张人脸出现，则选取最大的人脸进行判定 人证核身服务：校验用户上传的身份证图片支持正反面同时上传 中的信息的真实性,输出最终的审核结果。 该接口也支持用户直接上传姓名和身份证号码进行合法性校验 。

安全组规则修改（可选） 该解决方案使用22端口用来远程登录弹性云服务器 ECS，默认对该方案创建的VPC子网网段放开，请参考修改安全组规则，配置IP地址白名单，以便能正常访问服务。 安全组实际是网络流量访问策略，包括网络流量入方向规则和出方向规则，通过这些规则为安全组内具有相同保护需求并且相互信任的云服务器、云容器、云数据库等实例提供安全保护。 如果您的实例关联的安全组策略无法满足使用需求，比如需要添加、修改、删除某个TCP端口，请参考以下内容进行修改。 添加安全组规则：根据业务使用需求需要开放某个TCP端口，请参考添加安全组规则添加入方向规则，打开指定的TCP端口。 修改安全组规则：安全组规则设置不当会造成严重的安全隐患。您可以参考修改安全组规则，来修改安全组中不合理的规则，保证云服务器等实例的网络安全。 删除安全组规则：当安全组规则入方向、出方向源地址/目的地址有变化时，或者不需要开放某个端口时，您可以参考删除安全组规则进行安全组规则删除。

资源和成本规划 该解决方案主要部署如下资源，不同产品的花费仅供参考，实际以收费账单为准，具体请参考华为云官网价格： 表1 资源和成本规划-弹性云服务器部署（包年包月） 华为云服务 配置示例 每月预估花费 弹性云服务器 ECS 区域：华北-北京四 计费模式：包年包月 规格：X86计算 | ECS | s6.medium.2 | 1vCPUs | 2GiB 镜像：CentOS 7.6 64bit 系统盘：高IO | 100GB 购买量：1 107.20元 弹性公网IP EIP 按需计费（按带宽计费）：0.34元/5M/小时 区域：华北-北京四 计费模式：按带宽计费 线路：动态BGP 公网带宽：按带宽计费 带宽大小：5Mbit/s 购买时长：1个月 购买量：1 0.34*24*30=244.80元 合计 352.00 元 表2 资源和成本规划-弹性云服务器部署（按需计费） 华为云服务 计费说明 每月花费 弹性云服务器 按需计费：0.24/小时 区域：华北-北京四 计费模式：按需计费 规格：X86计算 | ECS | s6.medium.2 | 1vCPUs | 2GiB 镜像：CentOS 7.6 64bit 系统盘：高IO | 100GB 购买时长：1个月 购买量：1 0.22 * 24 * 30 = 158.40元 弹性公网IP 按需计费（按带宽计费）：0.34元/5M/小时 区域：华北-北京四 计费模式：按带宽计费 线路：动态BGP 公网带宽：按带宽计费 带宽大小：5Mbit/s 购买时长：1个月 购买量：1 0.34*24*30=244.80元 合计 403.20元

快速部署 本章节主要帮助用户快速部署该解决方案。 表1 参数填写说明 参数名称 类型 是否必填 参数解释 默认值 subnet_id String 必填 子网ID，该模板使用已有子网，请选择后端业务服务器相同虚拟私有云VPC下子网，查询并获取子网ID请参考3.1准备工作步骤1。 空 security_group_id String 必填 安全组ID，该模板使用已有安全组，建议选择后端业务服务器相同安全组，查询并获取安区组ID请参考3.1准备工作步骤2。 空 ecs_name String 必填 Web应用防火墙（WAF）云服务器名称，不支持重名。取值范围：1-54个字符组成，包括字母、数字、下划线 (_)、连字符 (-) 和句点 (.)。 waf_on_modsecurity_demo ecs_flavor String 必填 Web应用防火墙（WAF）云服务器规格，具体请参考官网弹性云服务器规格清单。 s6.medium.2 （1vCPUs | 2GiB) ecs_image String 必填 Web应用防火墙（WAF）云服务器镜像，其他镜像请参考官网镜像服务公共镜像。 CentOS 7.6 64bit. ecs_password String 必填 Web应用防火墙（WAF）服务器初始化密码，创建完成后请参考3.3开始使用步骤1重置密码。取值范围：长度为8-26位，密码至少包含大写字母、小写字母、数字和特殊字符（$!@%-_=+[]:./^,{}?）中的三种，密码不能包含用户名或用户名的逆序。管理员账户为root。 空 bandwidth_size Number 必填 带宽大小，该模板计费方式为按带宽计费。取值范围：1-2,000Mbit/s。 5Mbit/s ip_list String 必填 用户后端业务服务器的私有IP地址及Web服务访问端口，格式为：IP1:端口1,IP2:端口2，所有符号均为英文半角符号。例如：192.168.0.1:8080,192.168.0.2:8081,192.168.0.3:8083（在浏览器中访问该环境时，请选择后端端口对应的HTTP协议或者HTTPS协议访问）。 空 ssl_certificate String 必填 用户已有SSL证书(公钥)文件名称，包含后缀名。该模板部署完成后，请在Web应用防火墙（WAF）云服务器指定目录下（/usr/local/nginx/ssl/）上传该证书文件。 空 ssl_certificate_key String 必填 用户已有SSL证书(私钥)文件名称，包含后缀名。该模板部署完成后，请在Web应用防火墙（WAF）云服务器指定目录下（/usr/local/nginx/ssl/）上传该证书文件。 空 登录华为云解决方案实践，选择“基于开源Modsecurity构建WAF”，数据中心下拉菜单可以选择需要部署的区域，单击“一键部署”，跳转至解决方案创建资源栈界面。 图1 解决方案实施库 在选择模板界面中，单击“下一步”。 图2 选择模板 在配置参数界面中，参考表1完成自定义参数填写，单击“下一步”。 图3 配置参数 （可选）在资源设置界面中，在权限委托下拉框中选择“rf_admin_trust”委托，单击“下一步”。 图4 资源栈设置 在配置确认界面中，单击“创建执行计划”。 图5 配置确认 在弹出的创建执行计划框中，自定义填写执行计划名称，单击“确定”。 图6 创建执行计划 单击“部署”，并且在弹出的执行计划确认框中单击“执行”。 图7 执行计划 图8 执行计划确认 待“事件”中出现“Apply required resource success”，表示该解决方案已经部署完成。 图9 部署完成 单击“输出”获取弹性公网IP。 图10 获取弹性公网IP 父主题： 实施步骤

名词解释 基本概念、云服务简介、专有名词解释 弹性云服务器ECS：是一种可随时自助获取、可弹性伸缩的云服务器，可帮助您打造可靠、安全、灵活、高效的应用环境，确保服务持久稳定运行，提升运维效率。 弹性公网EIP：提供独立的公网IP资源，包括公网IP地址与公网出口带宽服务。可以与弹性云服务器、裸金属服务器、虚拟VIP、弹性负载均衡、NAT网关等资源灵活地绑定及解绑。 Nginx：Nginx是十分轻量级的HTTP服务器,Nginx，是一个高性能的HTTP和反向代理服务器，同时也是一个IMAP/POP3/SMTP 代理服务器。具体请参考官网http://nginx.org/en/。 ModSecurity是一个开源的、跨平台的Web应用防火墙（WAF）。它可以通过检查Web服务接收到的数据，以及发送出去的数据来对网站进行安全防护。具体请参考官网http://www.modsecurity.cn/practice/。

安全组规则修改（可选） 该解决方案使用3306端口用来访问云数据库 RDS for MySQL ，默认对该方案创建的VPC子网网段放开，请参考修改安全组规则，配置IP地址白名单，以便能正常访问服务。 安全组实际是网络流量访问策略，包括网络流量入方向规则和出方向规则，通过这些规则为安全组内具有相同保护需求并且相互信任的云服务器、云容器、云数据库等实例提供安全保护。 如果您的实例关联的安全组策略无法满足使用需求，比如需要添加、修改、删除某个TCP端口，请参考以下内容进行修改。 添加安全组规则：根据业务使用需求需要开放某个TCP端口，请参考添加安全组规则添加入方向规则，打开指定的TCP端口。 修改安全组规则：安全组规则设置不当会造成严重的安全隐患。您可以参考修改安全组规则，来修改安全组中不合理的规则，保证云服务器等实例的网络安全。 删除安全组规则：当安全组规则入方向、出方向源地址/目的地址有变化时，或者不需要开放某个端口时，您可以参考删除安全组规则进行安全组规则删除。

开始使用 登录华为云控制台，搜索FunctionGraph单击进入函数列表。 图1 华为云控制台 在函数列表中查看该方案创建的函数。 图2 已创建的函数 进入函数主页，单击“测试”在弹出窗口中选择“空白模板”单击“创建”配置测试事件。 图3 函数主页 图4 配置测试事件 在函数主页，单击“测试”调用函数，实现批量重装或切换操作系统。页面右侧执行结果返回如下信息表示执行成功。 图5 调用函数 图6 执行成功 在函数服务的监控中，可以查看已经完成重装操作系统的请求日志信息。 图7 请求日志 如果有新的弹性云服务器ECS重装或者切换操作系统需求，可进入函数主页依次单击“设置"“环境变量”参照表1在“值”输入框内填入相应的内容，单击“保存”后按照步骤4重新执行调用函数即可。 图8 设置环境变量 父主题： 实施步骤

快速部署 本章节主要帮助用户快速部署“仪表识别”解决方案。 表1 参数说明 配置节点 参数名称 类型 是否可选 参数解释 默认值 运行配置 输出目录 string 必填 选择一个OBS空目录存储训练输出的模型。 空 分割数据集 string 必填 选择从AI Gallery下载水表识别模型分割数据的OBS目录’train_imgs’。 空 正反数据集源路径 string 必填 选择一个OBS空目录存储正反数据集源。 空 资源配置 规格 string 必填 选择配置各个节点运行的资源规格 “切割元素”：默认规格CPU：8核32GB。 “元素分割模型训练”、“正反分类模型训练”、“OCR算法训练”和“智能预标注”节点默认规格GPU:1*NVIDIA-V100（34GB）|CPU：8核64GB 切割元素 seg_pattern_sub_dir_ph0 string 必填 分割图片过滤子目录路径 “raw_image/2000_type1/**/*.json” seg_image_sub_dir_ph1 string 必填 分割图片原图子路径 ‘raw_image/2000_type1/’ seg_target_labels_ph2 number 必填 分割标签 “{"客户":1,"读数":2,"id":3,"二维码":4,"条形码":5}” seg_output_mask_sub_dir_ph3 string 必填 分割输出的mask子目录路径 “label_mask/2000_type1” seg_labels_file_name_ph4 number 必填 分割标签输出的文件名 “labels.txt” split_train_file_name_ph5 string 必填 分割训练文件名 “train.txt” split_eval_file_name_ph6 string 必填 分割验证文件名 “eval.txt” ocr_json_sub_dir_ph7 string 必填 标注json文件子目录 “raw_image/2000_type1” ocr_target_labels_ph8 number 必填 分割标签中哪些是OCR需要处理的标签 “{"客户":1,"读数":2,"id":3}” ocr_output_train_sub_dir_ph9 string 必填 OCR训练集 输出子目录 “label_image/2000_type1/train” ocr_output_eval_sub_dir_ph10 string 必填 OCR验证集输出子目录 label_image/2000_type1/eval” split_ratio_ph11 float 必填 数据切分比例 0.8 元素分割模型训练 seg_labels_file_name_ph4 string 必填 分割标签输出的文件名 “labels.txt” split_train_file_name_ph5 string 必填 分割训练文件名 “train.txt” split_eval_file_name_ph6 string 必填 分割验证文件名 “eval.txt” batch_size_ph12 int 必填 批处理并行训练参数，与显存大小有关 6 epochs_ph13 int 必填 训练的迭代次数 200 num_classes_ph14 int 必填 训练类别数 6 img_dir_ph15 string 必填 训练的原始图像子路径 “raw_image/2000_type1” ann_dir_ph16 string 必填 训练的mask标签图像子路径 label_mask/2000_type1 正反数据集创建 创建或复用数据集名称 string 必填 创建正反数据集名称。 空 正反数据集标注 Label_Task_Name string 必填 创建正反标注任务名称 空 release_dataset train_evaluate_sample_ratio float 必填 正反模型训练训练验证集切分比例 0.9 正反分类模型训练 batch_size_ph17 int 必填 批处理并行训练参数，与显存大小有关 128 epochs_ph18 int 必填 训练的迭代次数 60 num_classes_ph23 int 必填 类别数，必须为2，暂不可修改 2 OCR算法训练 batch_size_ph20 int 必填 批处理并行训练参数，与显存大小有关 8 epochs_ph21 int 必填 训练的迭代次数 60 flip_correction_label_name_ph238 string 必填 此种标注的标签，会在ocr训练时翻转180度矫正 反 import_dataset_path_ph239 string 选填 选择填入经过manifest文件导入的原始类别为反的路径，会将此目下图片进行翻转矫正 空 是否进行模型部署 deploy_service_cond_cond_ph_ph28 string 必填 打开模型部署开关：Workflow会自动运行“创建模型”节点，不会运行“智能预标注”节点。 关闭模型部署开关：Workflow仅会运行至“智能预标注”节点，您需要手动运行“创建模型”节点。 关闭 创建模型 model_step_input string 必填 选择你的基础镜像 空 智能预标注 data_url string 必填 选择从AI Gallery下载水表识别模型分割数据的OBS目录“test_imgs” 空 seg_num_classes_ph25 int 必填 分割数据中的类数 6 flip_num_classes_ph26 int 必填 翻转数据中的类数 2 ocr_target_labels_ph27 string 必填 需要分割到OCR算法训练中的Label要素 “{"客户":1,"读数":2,"id":3}” filter_labels_ph28 string 必填 选择的类别，将使用最大连通区域优化过滤其他区域 “{"读数": 2, "二维码": 4, "条形码": 5}” filter_width_ph29 string 必填 连通区域过滤宽度 10 filter_height_ph30 string 必填 连通区域过滤高度 10 filter_area_ph31 string 必填 连通区域过滤面积 500 登录华为云解决方案实践，选择"基于ModelArts实现仪表盘识别"，单击“查看部署指南”可跳转至该解决方案部署指南界面。 图1 解决方案实践 准备数据 从AI Gallery下载水表识别模型分割数据。 本示例使用AI Gallery中已有的数据集，您可以直接下载使用。 a. 打开水表识别 - 分割模型开源转换数据集页面，单击“下载”。 图2 下载数据 b．在“下载详情”页面，配置以下参数。 “目标区域”：选择“华北-北京四”。 “目标位置”：在“请选择对象存储（OBS）路径”对话框中，选择准备工作中已创建的OBS桶，单击“创建文件夹”，创建一个命名为“segmentation”的文件夹，此处的文件夹名称““segmentation””仅为举例，您可以自定义文件夹名称。 图3 下载详情 c．单击“确定”，开始下载数据集至目标位置。 系统页面将自动跳转至“我的数据”页面，在“我的下载”页签下，可查看对应数据集的下载进度，数据集下载需要几分钟到十几分钟时间，请耐心等待。 图4 下载进度 2.（可选）使用自有分割数据。 如果您想使用自己的数据集，直接将数据上传至OBS文件夹中。具体操作，请参见上传文件。 订阅Workflow 1． 打开Workflow 水表识别工作流页面，单击“订阅”（注意：如需使用，请到立即咨询录入信息联系开通白名单）。 图5 订阅workflow 2．订阅完成后，单击“已订阅”旁的“运行”。 3．在弹出的“从AI Gallery导入工作流”对话框中配置参数。 “资产版本”：选择最新版本。 “云服务区域”：“华北-北京四”。 确保导入页面URL（“https://console.huaweicloud.com/modelarts/?region=cn-north-4#/ai-workflow/subscription/6fc22001-c778-46a7-99f9-154ebb7a9579”）中的region取值为cn-north-4，如果为其他区域，请手动修改为cn-north-4，刷新页面后再进行导入。 图6 导入Workflow 4．单击“导入”。 页面自动跳转至ModelArts管理控制台Workflow运行总览页面。 配置Workflow 1．登录ModelArts管理控制台，在控制台顶部区域下拉框中，选择“华北-北京四”。 图7 进入Workflow 2．在左侧导航栏，选择“Workflow”。 3．在Workflow列表中，单击Workflow所在行操作列的“配置”。 Workflow配置中各个节点的详细配置参数信息，请参见上表3-1 参数说明 图8 配置Workflow 4．完成以上节点参数配置后，在Workflow页面右上角单击“保存配置”。 图9 保存配置 启动Workflow 1．在Workflow页面右上角单击“启动”，自动跳转至工作流运行总览页面。 图10 启动workflow 2．工作流开始从切割元素节点运行，您可以在运行状态区域，查看节点的运行状态，节点运行成功后自动运行下一个训练节点 3．当工作流运行至正反数据集标注节点时，需要手工对正反数据集进行数据标注，每个正反标签至少标注5张图片。您可以单击“运行状况”区域的“详情”，跳转至数据标注页面，具体操作请参见图片标注。 图11 标注正反数据 4．图片标注完成后，返回至工作流运行页面，单击“继续运行”，工作流自动运行至下一个训练节点。 5．部署服务的配置要在所有节点运行完成后，才能进行配置。“创建模型”节点运行成功后，单击“部署服务”节点，在部署服务区域进行参数配置。 选择模型版本：选择模型对应的版本 节点规格：选择“T4-GPU卡” 分流：设置当前AI盈余公版流量占比，服务调用请求根据比例分配到当前版本上。 计算节点个数：设置当前AI版本应用的实例个数。 环境变量：您可以根据业务需求增加环境变量 参考配置图如下： 图12 模型部署 模型评估 节点训练完成之后，可以单击对应的训练节点，单击节点详情，查看对应的训练日志。您可 以根据模型评估指标情况，在Workflow配置中修改模型节点参数，重新启动Workflow进 行模型部署 1．分割模型评估指标 a) “class”: 类别。 b) “IOU”: 交并比。 c) “ACC”: 精准率。 d) “aACC”: 总体的精准率。 e) “mIOU”: 各个类别平均的交并比。 f) “mAcc”: 各个类别平均精准率。 图13 分割模型指标 2．翻转模型评估指标 a) “acc”: 精准率。 图14 翻转模型评估指标 3．识别模型评估指标 a) “word_acc”: 整个单词的精准率。 b) “word_acc_ignore_case”: 忽略大小写后整个单词的精准率。 c) “woed_acc_ignore_case_symbol”: 忽略大小写，空格等符号之后整个单词的精准率。 d) “char_recall”: 单个字符的准确率。 e) “char_precision”: 单个字符的准确率。 f) “1-N.E.D”: 字符的Levenshtein 距离，距离越小，值越大，效果越好。 图15 识别模型评估指标 父主题： 实施步骤

支持的事件列表 表1 云数据库GaussDB 事件来源 事件名称 事件ID 事件级别 事件说明 处理建议 事件影响 GaussDB 进程状态告警 ProcessStatusAlarm 重要 GaussDB关键进程退出，包括：CMS/CMA、ETCD、GTM、CN、DN。 等待进程自动恢复或者自动主备切换，观察业务是否恢复。如果业务未恢复，则提交工单。 主机进程故障，在主机上进行的业务将中断回滚。备机进程故障不影响业务。 组件状态告警 ComponentStatusAlarm 重要 GaussDB关键组件无响应，包括：CMA、ETCD、GTM、CN、DN。 等待进程自动恢复或者自动主备切换，观察业务是否恢复。如果业务未恢复，则提交工单。 主机进程无响应，在主机上进行的业务将无响应。备机进程故障不影响业务。 集群状态告警 ClusterStatusAlarm 重要 集群状态异常，包括： 集群只读、ETCD多数派故障、集群分布不均衡。 提交工单。 集群只读： 业务只读。 ETCD多数派故障：集群不可用。 集群分布不均衡：集群性能/可靠性降低。 硬件资源告警 HardwareResourceAlarm 重要 集群中出现严重的硬件故障，包括：磁盘损坏、GTM网络通信故障。 提交工单。 业务部分/全部受损。 状态转换告警 StateTransitionAlarm 重要 集群出现如下重要事件：DN build/build失败、DN强切、DN主备切换/failover、GTM主备切换/failover。 等待自动恢复，观察业务是否恢复。如果业务未恢复，则提交工单。 部分业务受损。 其他异常告警 OtherAbnormalAlarm 重要 磁盘使用阈值告警等。 关注业务变化，及时计划扩容。 超过使用阈值，将无法扩容。 实例运行状态异常 TaurusInstanceRunningStatusAbnormal 重要 由于灾难或者物理机故障导致实例故障时，会上报该事件，属于关键告警事件。 提交工单。 可能导致数据库服务不可用。 实例运行状态异常已恢复 TaurusInstanceRunningStatusRecovered 重要 针对灾难性的故障，GaussDB有高可用工具会自动进行恢复或者手动恢复，执行完成后会上报该事件。 不需要处理。 无 节点运行状态异常 TaurusNodeRunningStatusAbnormal 重要 由于灾难或者物理机故障导致数据库节点故障时，会上报该事件，属于关键告警事件。 检查数据库服务是否可以正常使用，并提交工单。 可能导致数据库服务不可用。 节点运行状态异常已恢复 TaurusNodeRunningStatusRecovered 重要 针对灾难性的故障，GaussDB有高可用工具会自动进行恢复或者手动恢复，执行完成后会上报该事件。 不需要处理。 无 创建实例业务失败 GaussDBV5CreateInstanceFailed 重要 创建实例失败产生的事件，一般是配额大小不足，底层资源耗尽导致。 先释放不再使用的实例再尝试重新发放，或者提交工单调整配额上限。 无法创建数据库实例。 添加节点失败 GaussDBV5ExpandClusterFailed 重要 一般是由于底层资源不足等原因导致。 提交工单协调资源，删除添加失败的节点，重新尝试添加新节点。 无 存储扩容失败 GaussDBV5EnlargeVolumeFailed 重要 一般是由于底层资源不足等原因导致。 提交工单协调资源再重试扩容操作。 如果磁盘满，会导致业务中断。 重启失败 GaussDBV5RestartInstanceFailed 重要 一般是由于网络问题等原因导致。 重试重启操作或提交工单。 可能导致数据库服务不可用。 全量备份失败 GaussDBV5FullBackupFailed 重要 一般是备份文件导出失败或上传失败等原因导致。 提交工单。 无法备份数据。 差量备份失败 GaussDBV5DifferentialBackupFailed 重要 一般是备份文件导出失败或上传失败等原因导致。 提交工单。 无法备份数据。 删除备份失败 GaussDBV5DeleteBackupFailed 重要 一般是清理备份文件失败导致。 提交工单。 可能导致OBS文件残留。 绑定EIP失败 GaussDBV5BindEIPFailed 重要 弹性公网IP已被占用或IP资源不足等原因导致。 提交工单。 导致实例无法使用公网链接或访问。 解绑EIP失败 GaussDBV5UnbindEIPFailed 重要 网络故障或公网EIP服务故障等原因导致。 重新解绑IP或提交工单。 可能导致IP资源残留。 参数组应用失败 GaussDBV5ApplyParamFailed 重要 一般是由于修改参数组命令超时导致。 重新尝试修改参数组操作。 无 参数修改失败 GaussDBV5UpdateInstanceParamGroupFailed 重要 一般是由于修改参数组命令超时导致。 重新尝试修改参数组操作。 无 备份恢复失败 GaussDBV5RestoreFromBcakupFailed 重要 一般是由底层资源不足或备份文件下载失败等原因导致。 提交工单。 可能导致在恢复失败期间数据库服务不可用。 父主题： 监控与告警

在线测试模板操作步骤 进入模板目录，将目录内的所有内容添加到zip压缩包中，命名为 “xxx.zip”。 进入RFS控制台，创建资源栈并上传 “xxx.zip”，更多详情可参考RFS创建资源栈。 进入“配置参数”页面，按照页面提示填写配置参数后进入下一页。 进入“资源栈设置”页面，完成资源栈设置。 确认配置参数和资源栈设置无误后，点击创建执行计划。 查看费用明细，如下图所示，此处商家需要确保模板中包含的云资源都能正常询出价格，如果不能正常询出价格，可参考：预估执行计划价格。 如费用明细无误，单击部署后，等待资源部署成功。 部署成功后，即基于Terraform和华为云资源编排服务RFS完成了应用软件自动部署模板的开发。 本示例创建的云资源需要商家支付相应的费用，当商家不需要这些资源的时候，请删除资源栈并及时删除这些资源。

为什么调用的API返回“projectId in token is nil”？ 可能是获取token时使用的“project”与调用直播API时使用的“project”不一致导致的。视频直播服务为项目级服务，在获取Token时需获取相同区域的token。 示例：如果token的Endpoint为“cn-north-4”，则token仅在该区域生效，只能通过该token调用“cn-north-4”区域的直播API。获取项目ID的操作请参见获取项目ID。 父主题： API使用

购买了直播CDN出流包，为什么还会从账户余额扣费？ 这可能是由于您的CDN计费方式为“按带宽计费”、“按月结95带宽峰值计费”或“按日峰值月平均计费”导致的。 建议您在视频直播控制台的概览页将计费方式变更为“按流量计费”。 不同计费方式的生效时间存在差异，如下所示： 若由“月结95带宽峰值计费”或“日峰值月均计费”变更为“流量计费”模式，则新的计费方式将在次月1日零点生效。 若由“带宽计费”变更为“流量计费”模式，则新的计费方式将在次日零点生效。 “按流量计费”模式生效后，即可使用直播CDN出流包了。 父主题： 计费购买

为什么调用API的返回信息提示接口不存在？ 可能是由于用户Token获取错误，将参数scope设置成了domain，只有全局服务才能获取此类Token。视频直播为项目级服务，区分区域，需要通过project进行获取。获取用户Token的请求样例如下所示。 说明：加粗的斜体字段需要根据实际值填写，其中username为用户名，domainname为用户所属的账号名称，可以在“我的凭证”页面获取，password为用户登录密码，projectname为项目的名称。 POST https://iam.cn-north-4.myhuaweicloud.com/v3/auth/tokens Content-Type: application/json { "auth": { "identity": { "methods": [ "password" ], "password": { "user": { "name": "username", "password": "password", "domain": { "name": "domainname" } } } }, "scope": { "project": { "name": "projectname" } } } } 父主题： API使用

视频直播有哪些计费项？如何知道自己需要支付哪些费用？ 视频直播计费项可以分为基础费用和增值费用，详情请参见计费项。 基础费用：流量/带宽费用，即您开启直播后，使用直播加速服务产生的流量/带宽费用。您可以在视频直播控制台的概览页自行选择按流量或带宽计费。 增值费用：包含录制、转码、截图等费用，这几项费用仅在您使用这些功能时才产生。 建议您在使用直播服务前，先根据业务的实际情况购买直播套餐包。 父主题： 计费购买

Live ReadOnlyAccess策略内容 { "Version": "1.1", "Statement": [ { "Effect": "Allow", "Action": [ "live:*:get*", "live:*:list*" ] } ] }

调用API获取项目ID 项目ID还用通过调用查询指定条件下的项目列表API获取。 获取项目ID的接口为“GET https://{Endpoint}/v3/projects/”，其中{Endpoint}为IAM的终端节点，可以从地区和终端节点获取。接口的认证鉴权请参见认证鉴权。 响应示例如下，其中projects下的“id”即为项目ID。 { "projects": [ { "domain_id": "65382450e8f64ac0870cd180d14e684b", "is_domain": false, "parent_id": "65382450e8f64ac0870cd180d14e684b", "name": "project_name", "description": "", "links": { "next": null, "previous": null, "self": "https://www.example.com/v3/projects/a4a5d4098fb4474fa22cd05f897d6b99" }, "id": "a4a5d4098fb4474fa22cd05f897d6b99", "enabled": true } ], "links": { "next": null, "previous": null, "self": "https://www.example.com/v3/projects" } }

数据回源 如果数据上传逻辑不做改变，则可使用OBS的“数据回源”功能，在文件访问请求到达OBS而OBS桶里没有该文件时，可通过“数据回源”将客户端请求重定向到设定的源站并异步地从源站将数据拉取到OBS存储下来，架构如下： 详细流程说明： 客户端向华为CDN发起获取文件的请求 华为CDN回源到华为OBS请求文件，OBS侧事先配置好数据回源，当请求的文件不存在时，会响应302重定向到配置的源站（此处为其他云对象存储） 华为CDN接收到OBS返回的302请求 OBS异步从客户配置的源站请求文件 华为CDN处理302跳转到其他云对象存储侧获取数据 其他云对象存储响应华为CDN的文件请求 华为CDN将文件内容返回给客户端，当下次客户端请求同样的文件时，华为CDN直接回源到OBS获取。 “数据回源”功能是被动触发式，即只有向OBS发起请求后OBS才会到设置的源站将数据拉取过来，所以当一个新文件上传到其他云对象存储后，建议业务应用程序向OBS触发一个GET请求来请求数据（发起GET请求后可关闭连接，无需接收实体数据）。另外该架构会在其他云对象存储侧产生两份数据流量（针对同一个文件，CDN拉取一次，OBS拉取一次）。

为什么OBS桶接入CDN后，访问域名会列出所有文件列表？ 如果用户对OBS桶有读权限，就可以读取桶内对象列表。当用户请求的是CDN加速域名的时候，OBS就默认返回桶内对象列表。解决办法如下： 如果您使用的是OBS公有桶，请参考以下操作步骤解决该问题： 在OBS处开启静态网站托管，操作步骤请参考配置静态网站托管。 同时在CDN域名的源站配置页面勾选“静态网站托管”。 在CDN控制台域名管理页面，单击需要配置的域名。 在“基本配置”页签下“源站配置”处单击“编辑”。 勾选“静态网站托管”，完成配置。如图所示。 如果您使用的是OBS私有桶，请参考通过CDN加速OBS视频点播文档中实施步骤的第6步处理。 如果您使用的是OBS私有桶，您还可以通过给“CDNAccessPrivateOBS”委托创建一条拒绝列举桶内对象的策略，达到不会列出桶文件列表的目的，步骤如下： 前往IAM控制台，在左侧菜单栏选择“委托”，在“CDNAccessPrivateOBS”的“操作”列，单击“授权”。 在授权页面单击“新建策略”，配置如下参数： 表1 参数说明 参数 说明 策略名称 输入自定义的桶策略名称，例如：deny ListBucket。 策略配置方式 可视化视图。 策略内容 效力 拒绝。 云服务 对象存储服务（OBS）。 操作项 在列表一栏勾选“obs:bucket:ListBucket”。 资源 所有资源 请求条件 - 单击“下一步”，进入选择策略页面。 勾选刚创建的策略，此处示例为“deny ListBucket”，单击“下一步”，进入设置最小授权范围界面。 单击“确定”，完成授权，授权后15~20分钟生效。 授权生效后，请刷新CDN缓存后重试。

CDN基础数据 基础数据报表可以帮助您快速了解CDN服务的性能，包含以下数据： 缓存命中率：用户请求资源命中CDN缓存的概率（按字节）。 请求命中率：用户请求资源命中CDN缓存的概率（按请求数）。 下载速度：用户通过CDN下载资源的速度。 访问状态：按照返回的状态码（200、4xx、5xx） 统计用户的请求状态及占比。 访问延时分布：不同延时时段的占比。 请求带宽：展示不同时段的用户请求带宽。 访问次数/人数：展示不同时段的访问次数和人数。 访问平均延时：终端用户访问页面延时的平均值。 图3 基础数据

CDN热门资源 热门资源数据可以帮助您了解热门资源详情，也可以从热门数据了解到您的运营活动效果是否正常、热点时间内流量的上涨是否符合预期，以便及时调整运营策略。通过热门资源可以查看以下数据： 域名访问次数Top5：统计用户访问量较多的域名Top5。 域名下载流量Top5：统计用户下载量较多的域名Top5。 热门访问（URI）：统计用户访问量较多的URI Top。 热门访问（来源）：统计热门Referer来源域名，并且记录访问次数、人数、占比。 全国访问次数分布统计：按省份统计全国各地访问的次数。 全国下载网速统计：按省份统计全国各地下载的速度。 省份统计：按省份统计访问次数、下载速度、下载总量。 运营商流量和速度：统计各运营商在不同时段的流量和下载速度。 运营商统计：统计不同运营商的访问次数、下载速度、下载流量。 图5 热门资源

如何开通实时日志 目前已实现对接LTS服务，控制台暂未开通自助配置功能，您可以提交工单申请开通实时日志功能，提交工单时请提供项目（cn-north-4）、项目ID、日志组、日志流信息。示例如下： 项目：cn-north-4。 项目ID：81b6********************bcf543ea。 日志组：test-cdn-log-prod。 日志组ID：95****53-3a81-49ed-9003-c24******de8 日志流：test-cdn-log-data-flow-prod。 日志流ID：a9****63-5b82-4126-80c9-212******534 日志推送成功后可通过云日志服务控制台查看CDN日志，云日志服务为CDN定制了如下功能： 图1 日志服务仪表盘 表1 功能详情 功能 说明 CDN错误分析 支持查看和导出错误访问信息，可按照域名、URI、请求状态、运营商、错误码等维度分析，帮助您快速定位和分析错误信息。 CDN基础数据 支持查看和导出CDN的基础数据，如缓存命中率、下载速度、访问状态、访问延时、请求命中率、请求带宽、访问平均延时等，帮助您了解CDN的整体运行状态，及时发现和处理异常情况。 CDN用户分析 支持查看和导出CDN的用户访问数据，如访问次数、访问人数、访问客户端、运营商次数统计、访问地区分布、有效访问用户TOP、下载量TOP用户等信息，帮助您更好的了解用户特点。 CDN热门资源 支持查看和导出CDN的热门资源，如域名访问次数TOP5、域名下载流量Top5、热门访问（URI）、热门访问（来源）、运营商流量和速度、运营商统计等，帮助您根据热门访问情况及时调整运营策略。 如果以上功能不能满足您的需求，您可以定制仪表盘，请在提交工单时提出您的需求。 您还可以根据业务情况创建告警规则，以便及时跟进和处理异常事件，配置请参考日志告警。

CDN错误分析 通过CDN错误分析报表，您可以查看用户访问异常信息，帮助您快速定位异常访问源头。通过本报表您可以查看以下数据： 错误域名访问Top5：按照域名维度统计访问错误Top域名。 错误URI访问Top5：按照URI维度统计访问错误Top URI。 错误请求状态分布：统计错误请求状态码的数量和占比。 错误按运营商统计：统计各个运营商的错误和占比。 错误按客户端统计：统计客户端访问错误的数量和占比。 错误按省份统计：统计访问错误的省份。 4XX错误详情：统计4XX类错误的次数、占比、运营商及所在省份。 5XX错误详情：统计5XX类错误的次数、占比、运营商及所在省份。 错误按国家统计：按照国家维度统计访问错误所在地。 图2 错误分析

实时日志字段 表2 实时日志字段说明 字段 字段含义 是否一定有值 缺省值 request_time 请求时间戳，单位：毫秒 是 无 domain 请求的域名 是 无 method 请求方法 是 无 scheme 请求协议 是 无 uri 请求资源 是 无 uri_param 请求参数 否 "-" client_ip 用户真实IP 是 无 client_port 和CDN节点建连客户端端口 是 无 refer_protocol HTTP refer中的协议 否 "-" refer_domain HTTP refer中domain信息 否 "-" refer_uri HTTP refer中uri信息 否 "-" refer_param HTTP refer中的参数信息 否 "-" request_size 请求大小 是 无 response_time 请求响应时长，单位：毫秒 是 无 response_size 请求返回大小，单位：字节 是 无 http_code 请求响应码 是 无 response_range 应答头里表示的range信息（由源站创建），如bytes：0~99/200 是 无 request_range 用户请求中Header头中range字段取值，如bytes：0~100 是 无 request_body_bytes 实际发送body大小，单位：字节 是 无 content_type 请求的资源类型 是 无 hit_info 命中信息，取值为HIT（命中）、MISS（未命中） 是 无 user_agent UA 否 "-" uuid 请求唯一标识（全网唯一请求ID，即traceid） 是 无 via_info via头信息 否 "-" X-Forwarded-For 请求头中X-Forwarded-For字段 否 "-"

CDN用户分析 用户行为分析报表可以帮助您快速了解当前用户的结构，主要包含以下数据： 访问次数：总访问次数，PV。 访问人数：总访问人数，UV。 访问客户端统计：统计客户端访问的数量和占比。 运营商次数统计：统计各个营商的访问次数和占比 访问地区分布：统计访问的地区分布及Top值。 有效访问用户TOP：统计有效访问用户的Top值。 下载量TOP用户：统计通过CDN下载的用户Top值。 图4 用户分析

为什么要看实时日志 实时日志可以帮助您分析加速域名遇到的异常问题，也可以帮助您了解用户的访问情况。实时日志的优势如下： 当前CDN控制台可为用户展示的离线日志是延时了6个小时的日志，而实时日志延时较小，可以帮助您更快速的对终端用户访问日志进行分析。 传统离线日志需要您先将离线日志包下载、解压再对日志进行分析处理，过程比较繁琐。华为云已打通与云日志服务间的通信链路，采用流式传输，免去了传统日志繁琐的下载分析流程。 云日志服务已部署CDN专属的可视化仪表盘，您可以一键开启，将CDN原始日志可视化呈现。 离线日志目前默认提供访问时间、状态码等13个字段，实时日志默认提供日志分析常用的25个字段，详见实时日志字段。