华为云用户手册

  • 服务优势 统一变更的管控入口,变更管理除支持IaC变更外增加对手工运维变更和ITR紧急变更的统一管控和变更记录。 统一运行时托管平台,将可靠性、韧性、可运维、安全等能力built-in,实现服务部署即可信。 基于IaC3.0声明式,实现资源创建、服务部署、配置变更自动化对接运行时,实现服务可靠运行。 具有丰富的变更评估因素和评估算法,具有高评估召回率和准确率。 支持根据评估结果对变更进行干预(暂停、回滚等),实现系统自动决策。
  • 运维中心工作台介绍 AppStage运维中心工作台如图1所示。 图1 运维中心工作台 AppStage运维中心工作台各模块功能如表1所示。 表1 工作台功能说明 编号 功能区域 说明 1 顶部导航栏 :服务列表按钮,在服务列表可切换运维中心提供的BaaS服务和中间件。 运维中心:单击可切换至运维中心工作台。 站点:可切换站点,当前仅支持“中国区2CBU生产”站点。 自有服务:可切换自有服务,即在业务控制台创建的产品及服务。 专项角色:可切换专项角色,专项角色可在组织内跨租户进行管理,具备跨租户的管理权限,包括基础运维角色、DBA(数据库DBA角色)等,如需申请专项角色权限请参见申请权限。 处于专项角色时,单击可退出专项角色。 :单击可复制分享链接。 EN/简体:可切换语言。 2 个人账号信息管理 审计日志:可查看登录账号在运维中心的所有操作日志,产品管理员可查看对应产品的所有操作日志。 我的信息:可以查看个人信息和已拥有的权限,也可以进行权限申请。 文档中心:可进入查看运维中心文档帮助。 工单管理:支持变更单与事件单的管理,具体介绍请参见工单管理。 服务环境配置:可以录入公有云账号、配置企业项目以及进行环境管理,具体介绍请参见服务环境配置。 租户管理:“我的租户”页面可以查看在业务控制台创建的组织(租户)、产品、服务和微服务信息。“订阅信息”页面可以查看已订阅的服务信息。 退出登录:退出当前登录账号。 3 运维接入一站式地图 可以按照指引完成运维接入,将华为云VPC、E CS 、CCE等接入运维中心进行运维管理,具体操作请参见运维接入。 4 常用功能 最近访问:展示近期已访问的服务,可单击快速访问。 书签:展示已收藏书签内容,可单击快速访问。 单击页面右侧悬浮菜单中的收藏按钮进行收藏,收藏后该页面可展示在已收藏书签列表。 已集成中间件:展示已集成的中间件。 已订阅服务:展示已订阅的服务。 5 告警 展示近期告警数据,将鼠标放置在该区域后单击,可进入监控服务页面查看详情数据。 6 CPU使用率 展示CPU使用情况,将鼠标放置在该区域后单击,可进入实时监控页面查看详细数据。 7 用户信息 显示当前用户信息,可以快捷查看已有权限或进行权限申请。 8 帮助文档 查看运维中心帮助文档。 父主题: 使用前必读
  • 背景信息 租户网络出口网关设备的IP对外暴露在公网上,可能存在安全隐患。互联网暴露面风险监测功能可以帮助租户统计网关设备暴露在公网中的IP,并识别其中存在暴露风险的端口或服务。 租户首次使用互联网暴露面风险监测功能时,可以单击页面右上角的“操作指引”了解使用流程。使用互联网暴露面风险监测功能必须对公网IP进行授权,不支持对未授权的公网IP进行风险评估。 只有边界防护与响应服务专业版套餐才包含互联网暴露面风险监测功能。
  • 配置思路 登录华为乾坤控制台,根据租户内网资产IP地址配置全局白名单,提升安全状态检测的准确性。 配置交换机: 配置Switch的GigabitEthernet0/0/2为观察端口,该端口直连防火墙,Switch将通过镜像将流量上送到防火墙进行检测。 配置Switch的GigabitEthernet0/0/1为镜像端口,开启端口镜像功能。 配置Switch的GigabitEthernet0/0/3为三层端口,与防火墙上 漏洞扫描 云日志 审计接口直连。 配置防火墙: 配置检测接口GE0/0/6为旁路检测模式,该接口与Switch的观察端口直连。 检查default策略的动作是否为“允许”,如果不是,将动作修改为“允许”。 加载云服务特性包。 配置防火墙与云平台对接。 配置边界防护与响应服务的业务参数。 将GE0/0/6加入trust安全域,并配置旁路检测所需要的安全策略。 配置漏洞扫描和云日志审计接口GE0/0/2为三层接口,并加入trust安全域,已购买 漏洞扫描服务 或云日志审计服务时需要配置。 分别配置漏洞扫描服务和云日志审计服务的业务参数,已购买漏洞扫描服务或云日志审计服务时需要配置。
  • 适用产品和版本 设备 版本 备注 防火墙USG65xxF: USG6525F/USG6555F/USG6565F/USG6585F/USG6585F-B/USG6520F-K/USG6560F-K/USG6590F-K/USG6510F-D/USG6530F-D/USG6510F-DK/USG6510F-DL/USG6530F-DL 防火墙USG66xxF:USG6615F/USG6625F/USG6635F/USG6655F/USG6685F/USG6620F-K/USG6650F-K 防火墙USG67xxF:USG6710F/USG6715F/USG6725F/USG6710F-K 边界防护与响应服务:V600R023C00SPC100及之后版本 - 防火墙USG65xxF:USG6525F/USG6555F/USG6565F/USG6585F/USG6520F-K/USG6560F-K/USG6590F-K/USG6510F-D/USG6530F-D/USG6510F-DK/USG6510F-DL/USG6530F-DL 防火墙USG66xxF:USG6615F/USG6625F/USG6635F/USG6655F/USG6685F/USG6620F-K/USG6650F-K 防火墙USG67xxF:USG6710F/USG6715F/USG6725F/USG6710F-K 漏洞扫描服务:V600R023C00SPC100及之后版本 - 防火墙USG65xxF:USG6525F/USG6555F/USG6565F/USG6585F/USG6520F-K/USG6560F-K/USG6590F-K/USG6510F-D/USG6530F-D/USG6510F-DK/USG6510F-DL/USG6530F-DL 防火墙USG66xxF:USG6615F/USG6625F/USG6635F/USG6655F/USG6685F/USG6620F-K/USG6650F-K 防火墙USG67xxF:USG6710F/USG6715F/USG6725F/USG6710F-K 云日志审计服务:V600R023C00SPC100及之后版本 -
  • 背景信息 Metadata是提取设备原始流量中的会话信息、协议信息等生成的流量元数据,华为乾坤可以对Metadata数据进行智能检测,有效防范通过Web进行的攻击行为(包括信息泄露、凭证窃取、注入检测和拒绝服务等)和通过DNS协议请求恶意 域名 的外联行为。 对于内网重要资产,用户可根据实际需要配置Metadata检测防护规则。华为乾坤根据配置的防护网段接收Metadata数据,并基于Metadata数据进行威胁分析,以便更好地保护内网重要资产。 防护网段配置规则如下: 已配置防护网段的设备,采集: HTTP协议并且目的IP在防护网段内的Metadata数据。 DNS协议并且源IP在防护网段内的Metadata数据。 未配置防护网段的设备,不采集Metadata数据。
  • 背景信息 华为乾坤需要识别攻击的发出区域、到达区域属于的安全域类型用于分析威胁事件。 华为乾坤提供以下几种类型的安全域: 信任域:用户信任的安全区域,通常用来定义用户的内部网络,华为乾坤不会对该区域发起的“威胁流量”进行封禁。 混合域:介于信任域和非信任域之间安全区域,属于一个特殊的网络,华为乾坤不会对该区域发起的“威胁流量”进行封禁。 非信任域:属于用户不信任的安全区域,通常用来定义Internet等不安全的网络,华为乾坤会自动封禁从该区域发起的“威胁流量”。
  • 数据规划 项目 数据 说明 租户内网资产IP地址 区域1地址:192.168.55.0-192.168.55.255 区域2地址:172.16.1.0-172.16.1.255、1.1.1.1-1.1.1.5 请向租户获取,此处为示例。 交换机 GigabitEthernet0/0/2 观察端口。 GigabitEthernet0/0/1 镜像端口。 GigabitEthernet0/0/3:192.168.56.20/24 与防火墙上漏扫和云日志审计业务接口直连的三层端口,IP地址请向租户获取,此处为示例。 防火墙 GE0/0/6 流量检测端口。 GE0/0/7:1.1.1.1/24 与云端连接接口,IP地址请向租户获取,此处为示例。 GE0/0/2:192.168.56.10/24 漏洞扫描和云日志审计接口,IP地址请向租户获取,此处为示例。 父主题: 企业边界防火墙旁路镜像流状态检测(USG6000F防火墙)
  • 查看用户操作事件 分别在视频选看、音频选看和辅流选看页签的右侧操作列单击“事件”,可以查看用户在通话过程中的所有操作事件详情。通过分析用户在客户端的操作步骤,复现相应的场景,辅助定位软件问题和分析bug。具体事件类型及ID如表1所示。 图5 操作事件详情 表1 用户操作事件说明 事件ID 事件类型 1 加入房间 2 离开房间 3 视频选看/批量选看 5 静音/取消静音 6 切换网络 7 开启/关闭摄像头 9 切换设备 10 DNS查询、TCP/TLS建链、首帧显示起止时间 11 切换角色 12 开始发送媒体流 13 媒体出流成功 14 辅流共享 16 音频选看/取消选看 17 跨房间 18 信令/媒体通道连接 19 上行视频设置 20 下行音频设置 21 服务器调度失败 22 推流成功率打点 23 拉流成功率打点
  • 查看通话体验质量 在通话体验质量区域中展示的是各个用户作为接收端的通话体验质量(通过接收到的音视频码率进行判断)。将鼠标指针停留在通话体验质量图上,滚动鼠标滚轮可针对某时间跨度范围内的质量图时间横轴进行拉大或缩小整体占比。 说明:通话体验质量面板默认显示所有的发送端数据,若发送端较多,您可以通过在当前面板的下拉框中选择只显示您关注的发送端。 图3 通话体验质量面板 在通话体验质量面板中,横轴表示通话时间,以横轴为界上下分别显示视频和音频的通话体验: 横轴以上为视频接收码率,若有多个发送端,则每个发送端会占一条线,以不同颜色区分。 红色向上的毛刺表示视频卡顿。 横轴以下为音频接收码率,若有多个发送端,则每个发送端会占一条线,以不同颜色区分。 红色向下的毛刺表示音频卡顿。 若发现某个发送端的通话体验质量有问题,您可以通过单击面板右上角的查看详情,进入用户详情页面。分别在视频选看、音频选看和辅流选看页签中选择该发送端,查看相关音视频质量指标详情。各质量指标说明请参见分析通话质量问题。
  • 分析通话质量问题 在用户详情页面可查看通话基本信息、用户画像信息、视频选看数据和音频选看数据和辅流选看数据,如图4所示。 图4 用户详情页面 其中,音视频选看和辅流选看页签中展示的是从特定发送端到接收端的音视频质量指标详情,您可以通过分析各项质量指标,找到通话体验质量问题所在。 通话基本信息:可查看房间ID、应用ID、域名、房间状态、整段通话的起止时间。 用户画像信息:可查看用户在线时长、5s加入房间失败次数、推拉流失败次数。 视频选看:展示选定视频通话的发送端与接收端的质量监控数据,包含视频分辨率、丢包率、卡顿率、帧率、码率数据。 音频选看:展示选定音频通话的发送端与接收端的质量监控数据,包含音频丢包率、卡顿率、码率。 辅流选看:展示选定的发送端用户与对应接收端用户共享屏幕(窗口)的质量监控数据。包含码率、帧率、卡顿率、丢包率、分辨率、抖动和时延。
  • NPU融合算子API和亲和优化器 可对训练代码中的部分API替换成NPU融合算子API和亲和优化器,从而提升训练性能。但需要注意的是,在一些场景下,替换后的算子可能会对模型精度有影响,所以适配后,需要验证精度,如果确认有影响,需要在精度和性能之间做取舍。 NPU融合算子API 识别融合算子和亲和优化器请参考工具使用,当前支持识别的融合算子API和亲和优化器请参考昇腾迁移融合算子API替换样例。 NPU亲和优化器替换 PyTorch原生优化器在训练过程中,一般需要下发多个NPU算子完成梯度和参数的更新计算,过多的算子下发,可能造成NPU空等。可将PyTorch优化器替换成NPU亲和优化器提高训练性能,详情请见此处。
  • 算子二进制调优 PyTorch Adaptor框架提供与算子编译相关的二进制配置参数,可设置模型编译时是否优先在线编译,以此优化模型训练性能。在main函数训练逻辑开始前通过以下函数设置(True为启动优先在线编译、False为取消优先在线编译)。 torch_npu.npu.set_compile_mode(jit_compile=False) 对于固定shape场景和动态shape场景,是否优先在线编译对训练性能带来不同的效果: 固定shape场景:固定shape是指在模型计算过程中,模型的输入和输出的shape是固定的。如果优先在线编译,可根据当前获得的算子信息,进行融合和优化,在线编译出运行性能更优的算子。反之,则编译优化少,性能降低。 动态shape场景:动态shape是指在模型计算过程中,模型的输入和输出存在多种shape。如果对动态shape的算子优先编译,会导致编译时间长训练性能差。如果取消优先编译,会优先查找当前编译好的算子二进制配置文件,如果存在则不在线编译算子;如果不存在,再进行在线编译。此时虽然编译优化少,但是没有编译时间,模型训练性能大概率比配置为优先编译高。 总结: 如果模型中无动态shape,启动优先在线编译,可提高训练性能。 如果模型中只有动态shape(该情况较少),关闭优先在线编译,模型训练性能大概率会更高。 既有动态shape也有固定shape,启动优先在线编译对训练性能是否提升无法确定,因此可以在调整训练代码后,分别尝试开关优先在线编译后根据训练性能的优劣再设置。 Snt9B芯片默认关闭了优先在线编译,可通过以下命令获取当前模式。如果返回为False,代表已启动优先在线编译。 print(torch_npu.npu.is_jit_compile_false()) 算子会根据该开关走不同的代码逻辑,如出现jit_compile切换后,代码运行失败的情况,需要联系昇腾技术支持获取帮助。
  • 多进程绑核 相比于x86服务器,ARM服务器通常CPU核数更多,但单核性能更弱,因此更容易触发内核的负载均衡策略,该策略是通过启用进程迁移来降低繁忙的处理器压力。进程迁移会导致进程上下文切换、降低Cache命中率和跨numa内存访问等,从而影响训练性能。 如果使用docker容器作为训练环境,启动容器的时候,通过cpuset-cpus参数指定当前容器绑定的CPU核(如绑定16个cpu核60~75,命令示例为“docker run -d --cpuset-cpus=60-75 myimage bash”),这样容器中的进程只能在指定的CPU核上运行,达到绑核的效果。
  • 查询银行网点名称 输入参数 输入参数说明如表2所示。 表2 查询银行网点名称输入参数说明 参数 必填 说明 bankType 是 银行类型。支持下拉框和输入框两种模式。 中国工商银行 中国农业银行 中国建设银行 国家开发银行 交通银行 中信银行 中国光大银行 华夏银行 南京银行 queryName 是 关键字。 输出参数 用户可以在之后的执行动作中调用该输出参数,输出参数说明请参见表3。 表3 查询银行网点名称输出参数说明 参数 说明 银行类型 银行类型。 银行名称 银行名称。 银行编号 银行编号。 地址 地址。 网点名称 网点名称。 联系电话 联系电话。
  • 获取用户ID 通过手机号或邮箱获取用户ID。 输入参数 输入参数说明如表4所示。 表4 获取用户ID输入参数说明 参数 必填 说明 用户邮箱 否 用户邮箱。 用户手机号 是 用户手机号。 输出参数 用户可以在之后的执行动作中调用该输出参数,输出参数说明请参见表5。 表5 获取用户ID输出参数说明 参数 说明 错误码 错误码。 非0表示失败。 错误描述 错误描述。 -手机号或者邮箱对应的用户id信息 手机号或者邮箱对应的用户ID信息。 --用户id 用户ID。 --邮箱 邮箱。 --手机号 手机号。
  • 获取用户的OKR列表 根据用户ID提取用户的OKR列表。 输入参数 输入参数说明如表2所示。 表2 获取用户的OKR列表输入参数说明 参数 必填 说明 用户ID类型 否 用户的ID类型。支持下拉框和输入框两种模式。 用户的open id 用户的union id 用户的union id 用户的people_admin_id 请求列表的偏移 是 请求列表的偏移。 示例值:0 列表长度 是 列表长度 。长度范围为0-10。 示例值:5 请求OKR的语言版本 是 请求OKR的语言版本。 示例值:zh_cn user_id 是 user_id。 body 否 支持数组和输入框两种模式。 输出参数 用户可以在之后的执行动作中调用该输出参数,输出参数说明请参见表3。 表3 获取用户的OKR列表输出参数说明 参数 说明 错误码 错误码。 非0表示失败。 -OKR列表 OKR列表。 -OKR周期总数 OKR周期总数。 错误描述 错误描述。
  • 近三天空气质量 提供指定城市近三天的空气质量信息。 输入参数 用户配置近三天空气质量执行动作,相关参数说明如表4所示。 表4 近三天空气质量输入参数说明 参数 必填 说明 城市 是 填写想要查询的城市名称,有输入框和下拉框选择。 输出参数 用户可以在之后的执行动作中调用该输出参数,输出参数说明请参考表5。 表5 近三天空气质量输出参数说明 参数 说明 城市 所查询的城市名。 今天空气质量值 今天空气质量值。 今天空气质量最大值 今天空气质量的最大值。 今天空气质量最小值 今天空气质量的最小值。 今天空气质量等级 今天空气质量的等级。 今天日期 今天日期。 明天空气质量值 明天空气质量值。 明天空气质量最大值 明天空气质量的最大值。 明天空气质量最小值 明天空气质量的最小值。 明天空气质量等级 明天空气质量的等级。 明天日期 明天日期。 后天空气质量值 后天空气质量值。 后天空气质量最大值 后天空气质量的最大值。 后天空气质量最小值 后天空气质量的最小值。 后天空气质量等级 后天空气质量的等级。 后天日期 后天日期。
  • 连接参数 华为空气质量连接器使用OAuth2.0认证,连接参数说明如表1所示。 表1 连接参数说明 名称 必填 说明 示例值/默认值 连接名称 是 设置连接名称。 华为空气质量的连接 描述 否 对于连接的信息描述说明。 description client_id 是 client_id是应用的唯一标识,平台通过client_id来鉴别应用的身份。 name client_secret 是 client_secret是平台给应用分配的密钥。 -
  • 实时查询空气质量 提供需要查询的城市,给出该城市的实时空气质量信息。 输入参数 用户配置实时查询空气质量执行动作,相关参数说明如表2所示。 表2 实时查询空气质量输入参数说明 参数 必填 说明 城市 是 填写想要查询的城市名称,有输入框和下拉框选择。 输出参数 用户可以在之后的执行动作中调用该输出参数,输出参数说明请参考表3。 表3 实时查询空气质量输出参数说明 参数 说明 城市 所查询的城市名。 实时NO2浓度(μg/m³) 实时NO2浓度(μg/m³)。 实时O3浓度(μg/m³) 实时O3浓度(μg/m³)。 实时PM25浓度(μg/m³) 实时PM25浓度(μg/m³)。 实时SO2浓度(μg/m³) 实时SO2浓度(μg/m³)。 实时PM10浓度(μg/m³) 实时PM10浓度(μg/m³)。 实时CO浓度(μg/m³) 实时CO浓度(μg/m³)。 实时空气质量等级 实时空气质量等级。 实时空气质量评分 实时空气质量评分。 实时空气质量 实时空气质量。 出行建议 出行建议。
  • 航班时刻表查询 根据输入的出发地、目的地等信息,给出查询到的票价。 输入参数 用户配置航班时刻表查询执行动作,相关参数说明如表4所示。 表4 航班时刻表查询输入参数说明 参数 必填 说明 示例值/默认值 始发城市机场 是 始发城市的三字码,有输入框和下拉框两种形式。 DIL 到达城市机场 是 到达城市的三字码。 SWZ 日期 是 出发日期(年-月-日)。 2020-09-08 直航/转飞 是 选择直航或者转飞。 直航 是否经停 是 选择是否经停。 是 输出参数 用户可以在之后的执行动作中调用该输出参数,输出参数说明请参考表5。 表5 航班时刻表查询输出参数说明 参数 说明 状态码 状态码。 接口响应结果 接口响应结果。 结果集 结果集。 航班号 航班号。 起飞时刻(时分) 本航段的起飞时刻(时分)。 起飞日期修正 本航段的起飞日期修正。 ASR支持标志 本航段的ASR支持标志。 舱位列表 本航段的舱位列表。 到达时刻 本航段的到达时刻。 到达日期修正 本航段的到达日期修正。 到达城市的三字码 本航段的到达城市的三字码。 有效期限的起始时间 有效期限的起始时间(年-月-日)。 有效期限的起始时间 有效期限的起始时间(年-月-日)。 舱位种类 本航段支持的舱位种类。 电子票标志 本航段的电子票标志。 连接级别 本航段的连接级别。 餐食标志 本航段的餐食标志。 开放对象 本航段的开放对象。 始发城市的三字码 本航段的始发城市的三字码。 机型 本航段使用的机型。 经停次数 本航段的经停次数。 错误码 错误码。
  • 票价查询 根据输入的出发地、目的地等信息,给出查询到的票价。 输入参数 用户配置票价查询执行动作,相关参数说明如表2所示。 表2 票价查询输入参数说明 参数 必填 说明 始发城市机场 是 始发城市的三字码,有输入框和下拉框两种形式。 到达城市机场 是 到达城市的三字码。 日期 是 出发日期(年-月-日)。 输出参数 用户可以在之后的执行动作中调用该输出参数,输出参数说明请参考表3。 表3 票价查询输出参数说明 参数 说明 状态码 状态码。 结果 结果。 结果集 结果集。 舱位类型 舱位类型。 基础舱位(F/C/Y) 基础舱位(F/C/Y)。 货币类型 货币类型。 单程票价 单程票价。 往返票价 往返票价。 折扣率 折扣率。 生效日期 生效日期。 截至日期 截至日期。 航空公司的两字代码 航空公司的两字代码。 机场税 机场税。 燃油税 燃油税。 运价规则 运价规则。 orgCity orgCity。 dstcity dstcity。
  • 查询医院信息 输入参数 输入参数说明如表2所示。 表2 查询医院信息输入参数说明 参数 必填 说明 name 是 查询关键字(省,市,详细地址,医院名称) 输出参数 用户可以在之后的执行动作中调用该输出参数,输出参数说明请参见表3。 表3 查询医院信息输出参数说明 参数 说明 状态码 状态码。 消息 消息。 结果列表 结果列表。 -省份 省份。 -城市 城市。 -类型 类型。 -名称 名称。 -等地 等地。 -地址 地址。 -联系电话 联系电话。 -描述 描述。 条数 条数。
  • 静默活体检测 静默活体检测是基于人脸图片中可能存在的畸变、摩尔纹、反光、倒影、边框等信息,判断图片中的人脸是否来自于真人活体,有效抵御纸质翻拍照、电子翻拍照以及视频翻拍等各种攻击方式。静默活体检测支持单张图片,不支持多人脸图片。新老用户均可用该接口。 接口功能及调用方法请参考活体检测。 输入参数 用户配置静默活体检测执行动作,相关参数说明如表9所示。 表9 静默活体检测输入参数说明 参数 必填 说明 视频的URL路径 与图片文件,图像数据三选一 视频的URL路径,目前仅支持OBS的URL。 图片文件 与视频的URL路径,图像数据三选一 本地图片文件,图片不能超过8MB,建议小于1MB。上传文件时,请求格式为multipart。 图像数据 与视频的URL路径,图像数据三选一 图像数据,Base64编码,要求:Base64编码后大小不超过8MB,建议小于1MB。图片为JPG/JPEG/BMP/PNG格式。 输出参数 用户可以在之后的执行动作中调用该输出参数,输出参数说明请参考表10。 表10 静默活体检测输出参数说明 参数 说明 活体检测结果 是否是活体。 置信度 置信度,取值范围0~1。 检测人脸结果图片 检测出最大人脸的图片base64。 错误码 调用失败时的错误码,调用成功时无此字段。 错误信息 调用失败时的错误信息,调用成功时无此字段。
  • 人脸检测 人脸检测是对输入图片进行人脸检测和分析,输出人脸在图像中的位置、人脸关键属性。如果照片中存在多张人脸,则返回所有符合条件的人脸特征信息。 接口功能及调用方法请参考人脸检测。 输入参数 用户配置人脸检测执行动作,相关参数说明如表3所示。 表3 人脸检测输入参数说明 参数 说明 图片的URL路径 图片的URL路径,当前仅支持OBS路径。例:https://eventobas.obs.cn-north-4.myhuaweicloud.com/人像.png (构成:https://BucketName.obs.example.com/ObjectName) 图像数据 图像数据,Base64编码,要求:Base64编码后大小不超过8MB,建议小于1MB。图片为JPG/JPEG/BMP/PNG格式。 希望返回的人脸属性 多个属性间使用逗号(,)隔开。目前支持的属性有: 2:年龄 4:装束(帽子、眼镜) 6:口罩 7:发型 8:胡须 11:图片类型 12:质量 13:表情 21:人脸图片旋转角(顺时针偏转角度),支持0°、90°、180°和270°图片旋转。 输出参数 用户可以在之后的执行动作中调用该输出参数,输出参数说明请参考表4。 表4 人脸检测输出参数说明 参数 说明 检测到的人脸集合 检测到的人脸。 调用失败时无此字段。 年龄 检测出的人脸年龄。 人脸质量得分 人脸质量总分,取值范围[0-1],分值越大质量越高。 模糊程度 模糊度,取值范围[0-1],分值越大模糊问题越严重。 姿态合规程度 姿态,取值范围[0-1],分值越大姿态问题越严重。 遮挡程度 遮挡,取值范围[0-1],分值越大遮挡问题越严重。 光照程度 光照,取值范围[0-1],分值越大光照问题越严重。 人脸表情类型 人脸表情类型: neutral:中性 happy:高兴 fear:害怕 surprise:惊讶 sad:伤心 angry:生气 disgust:厌恶 unknown:图片质量问题导致未识别 表情置信度 表情置信度,取值范围[0-1]。 错误码 调用失败时的错误码,调用成功时无此字段。 错误信息 调用失败时的错误信息,调用成功时无此字段。
  • 动作活体检测 动作活体检测是通过判断视频中的人物动作与传入动作列表是否一致来识别视频中人物是否为活体。如果有多张人脸出现,则选取最大的人脸进行判定。新老用户均可用该接口。 接口功能及调用方法请参考活体检测。 输入参数 用户配置动作活体检测执行动作,相关参数说明如表7所示。 表7 动作活体检测输入参数说明 参数 必填 说明 视频的URL路径 否 视频的URL路径,目前仅支持OBS的URL。 动作顺序 是 动作代码顺序列表,英文逗号(,)分隔。有输入框或者下拉框输入方式。 输出参数 用户可以在之后的执行动作中调用该输出参数,输出参数说明请参考表8。 表8 动作活体检测输出参数说明 参数 说明 活体检测结果 是否是活体。 动作列表 动作列表。 动作顺序编号 动作编号,取值范围:[1,2,3,4],其中: 1:左摇头 2:右摇头 3:点头 4:嘴部动作。 置信度 置信度,取值范围0~1。 检测人脸结果图片 检测出最大人脸的图片base64。 警告信息 警告信息列表。 警告ID 警告ID。 告警消息 告警消息。 错误码 调用失败时的错误码,调用成功时无此字段。 错误信息 调用失败时的错误信息,调用成功时无此字段。
  • 关键词统计 用户问关键词统计。 输入参数 关键词统计执行动作,相关参数说明如表10所示。 表10 关键词统计输入参数说明 参数 必填 说明 用户问题关键词列表 是 用户问题关键词列表显示的个数。默认值为10,取值范围[1-50]。 查询的起始时间 否 查询的起始时间,long,utc时间,默认值为0。 查询的结束时间 否 查询的结束时间,long,utc时间,默认值为当前时间的毫秒数。 问答机器人 ID 是 通过华为云CBS控制台获取。 输出参数 用户可以在之后的执行动作中调用该输出参数,输出参数说明请参考表11。 表11 关键词统计输出参数说明 参数 说明 用户问题关键词列表 指定时间范围内,用户问题关键词列表。 关键词 关键词。 关键词频次 关键词频次。
  • 获取问题提示 获取用户输入问题的提示问题列表。 输入参数 获取问题提示执行动作,相关参数说明如表8所示。 表8 获取问题提示输入参数说明 参数 必填 说明 用户输入的问题 是 用户输入的问题。 最多提示条数 否 最多提示条数。 问答机器人ID 是 通过华为云CBS控制台获取。 输出参数 用户可以在之后的执行动作中调用该输出参数,输出参数说明请参考表9。 表9 获取问题提示输出参数说明 参数 说明 问题列表 推荐问列表。
  • 访问统计 获取用户会话统计信息。 输入参数 访问统计执行动作,相关参数说明如表6所示。 表6 访问统计输入参数说明 参数 必填 说明 查询的起始时间 否 查询的起始时间,long,utc时间,默认值为0。 查询的结束时间 否 查询的结束时间,long,utc时间,默认值为当前时间的毫秒数。 统计周期 是 统计周期目前支持month、week、day。 请求所在时区 否 请求所在时区,例如:中国东八区为"+08:00";美国西五区为"-05:00";默认为"UTC"。(注意+-:符号需要经过urlEncoder加码)。 问答机器人ID 是 通过华为云CBS控制台获取。 输出参数 用户可以在之后的执行动作中调用该输出参数,输出参数说明请参考表7。 表7 访问统计输出参数说明 参数 说明 统计周期 统计周期目前支持month、week、day。 请求所在时区 请求所在时区,例如:中国东八区为"+08:00";美国西五区为"-05:00";默认为"UTC"。(注意+-:符号需要经过urlEncoder加码)。 会话总计统计数据 会话总计统计数据。 会话总数 会话总数。 独立用户个数 独立用户个数。 平均会话轮数 平均会话轮数,保留小数点后三位。 平均会话时长 平均会话时长,保留小数点后三位。 会话间隔统计数据 会话间隔统计数据。 开始时间 间隔周期开始时间。 会话总数 间隔周期会话总数。 独立用户个数 间隔周期独立用户个数。 平均会话轮数 间隔周期平均会话轮数,保留小数点后三位。 平均会话时长 间隔周期平均会话时长,保留小数点后三位。 开始的utc时间 统计开始的utc时间。 结束的utc时间 统计结束的utc时间。
  • 连接参数 对话机器人服务 CBS连接器使用 IAM 认证,连接参数说明如表1所示。 表1 连接参数说明 名称 必填 说明 示例值/默认值 连接名称 是 设置连接名称。 问答机器人的连接 描述 否 对于连接的信息描述说明。 description 租户名 是 IAM用户所属账号信息。了解账号与IAM用户的关系。 domain 用户名 是 IAM用户名。 name 密码 是 IAM用户的登录密码。 - 区域 是 服务所属区域。 cn-north-4
共100000条