华为云用户手册

新增数据模型 在AppStage首页右上区域单击“运营中心”快捷入口，进入运营中心工作台。 在左侧导航栏选择“数据模型”，进入数据建模页面。 在数据建模页面，单击“新增数据模型”。 配置数据模型基础信息，参数说明如表1所示。 表1 基础信息 参数 说明 模型名称 必填。数据模型的名称，用来区分不同的数据模型。 只能包含英文字母、数字和下划线，且以英文字母开头，长度不超过20个字符。 模型显示名 必填。数据可视化所显示的模型名称。 任务类型 指定配置的任务类型。 周期任务 说明： 任务启用后每日运行一次。 一次性任务 是否存在历史数据 根据实际情况选择“是”或“否”。周期性任务数据不会导入以前的数据，如果需要查看以前的数据，该参数需配置为“是”。 仅当“任务类型”为“周期性任务”时，该参数为必填参数。 描述（可选） 对数据模型进行详细说明和解释的文字描述。 配置数据模型表字段。单击“新增行”，配置字段名称、字段显示名、数据类型、描述和操作，如表2所示。 表2 表字段 参数 说明 字段名称 必填。在数据库表中，用于表示不同数据类型的列的名称。 字段显示名 必填。字段可视化所显示的字段名称。 数据类型 必填。数据的种类和格式。 string interger float boolean 描述 可选。对表字段的简要描述，用于说明该行的含义和用途。 操作 单击操作列“删除”，可以删除该行表字段。 单击操作列“上移”，可以将该行表字段上移一行。 单击操作列“下移”，可以将该行表字段下移一行。 配置完成后，单击“下一步”。 在“新建数据模型”页面，完成字段映射，如表3所示。 表3 字段映射 参数 说明 源表 指需要从中抽取数据的源数据表。选择源表后，单击源表后面的，可添加引用表，如表4所示。 字段映射 指将源表和引用表中的字段，与模板字段进行映射。 表4 引用表 参数 说明 源表 指需要从中抽取数据的源数据表。 引用表 指需要与源表进行关联的参考数据表。 字段关系 指源表和引用表之间的字段关系。 说明： 最少需输入1个字段关系。 单击“保存”或“发布”，完成数据模型配置。 单击“发布”时，数据模型状态为“已发布”。 单击“保存”时，数据模型状态为“草稿”。

逆向数据库 运营中心提供逆向数据库能力，即通过对已有的数据表进行分析、处理和转换生成数据模型。 在数据建模页面，单击“逆向数据库”。 在弹出的“逆向数据库”弹框中，填写数据库信息，参数说明如表5所示。 表5 数据库信息 参数 说明 模型名称 必填。在数据分析系统中使用的模型标识符，通常是一个短字符串或缩写，用于标识一个特定的模型。 只能包含英文字母、数字和下划线，且以英文字母开头，长度不超过20个字符。 模型显示名 必填。在数据分析系统中显示的模型名称，通常是一个更易于理解和识别的字符串。 数据表 必填。数据表用于存储和管理数据。 该参数值来源于“通用数据接入”页面配置的数据名称。 配置完成后，单击“确认”。 配置数据模型基础信息。可根据需要修改参数“模型名称”、“模型显示名”、“任务类型”、“描述”，参数说明请参见表1。 配置数据模型表字段。可根据需要新增/修改/删除表字段，字段参数说明请参见表2。 配置完成后，单击“下一步”。 配置字段映射。可根据需要修改参数，参数说明请参见表3和表4。 单击“保存”或“发布”，完成数据模型配置。 单击“发布”时，数据模型状态为“已发布”。 单击“保存”时，数据模型状态为“草稿”。

使用流程 按照不同的使用场景，运营中心使用流程如图1所示。 图1 使用流程 使用场景一：数据工程师/分析师支撑或配合业务提出的数据相关需求，完成一些相对复杂的数据接入、数据建模以及数据指标开发的工作。 新建数据接入：运营中心提供通用数据接入能力，通过与数据源连接，可以建立数据源中数据表的迁移任务，将源端数据迁移到运营中心，为后续业务做数据准备。 新建数据模型：运营中心提供数据建模能力，运营人员可以自定义数据模型，也可以通过逆向数据库生成数据模型。通过提供多表关联建模整合表能力，一个数据模型可以映射多个数据表数据。 新建指标：运营中心提供指标自定义灵活配置能力，可以配置普通指标和复合指标，基于数据模型，通过计算方式、计算时间单位、统计维度、筛选条件组合配置指标。 自定义运营看板：通过自定义运营看板，可以把产品运营中的关键数据统一呈现出来，可按人员权限和业务类型展示不同的数据看板，可视化展现产品运营现状。 看板：运营中心提供看板功能，产品运营人员能直观查看关键数据，分析产品运营过程中取得的成效和潜在问题。 使用场景二：业务分析者/执行者（如产品经理、运营人员等）根据业务诉求快速生成、查看各类数据报表。 新建数据接入：运营中心提供通用数据接入能力，通过与数据源连接，可以建立数据源中数据表的迁移任务，将源端数据迁移到运营中心，为后续业务做数据准备。 应用指标模板：运营中心提供指标模板应用能力，模板中内置数据模型、指标定义、图表卡片等经验内容。运营中心通过提供多场景模板，以场景驱动一键应用，赋能用户低门槛、高效率地构建指标体系。 自定义运营看板：通过自定义运营看板，可以把产品运营中的关键数据统一呈现出来，可按人员权限和业务类型展示不同的数据看板，可视化展现产品运营现状。 看板：运营中心提供看板功能，产品运营人员能直观查看关键数据，分析产品运营过程中取得的成效和潜在问题。 使用场景三：业务决策者（如领导、业务负责人等）基于全场景看板随时随地直观查看关键数据，分析产品运营过程中取得的成效和潜在问题。 父主题： 运营中心简介

修订记录 发布日期 修订记录 2024-03-30 第五次正式发布。 新增如下章节： 数据表管理 用户基础分析 店铺销售分析 应用事件分析 应用销售分析 元数据管理 运营分析 公共屏幕模板 修改如下章节： 数据模型 指标管理 2024-03-08 第四次正式发布。 修改如下章节： 指标模板库 数据模型 指标管理 看板管理 2024-01-05 第三次正式发布。 新增埋点数据接入 2023-12-31 第二次正式发布。 新增数据管理 2023-11-25 第一次正式发布。

指标体系 表1 指标体系 指标名称 指标描述 启动次数近1天 统计周期内，用户启动应用的次数。 启动次数近7天 统计周期内，用户启动应用的次数。 订阅用户数近1天 统计周期内，订阅应用的用户数。 订阅用户数近7天 统计周期内，订阅应用的用户数。 Banner点击次数近1天 统计周期内，用户点击广告条Banner的次数。 Banner点击次数近7天 统计周期内，用户点击广告条Banner的次数。 Tab点击次数近1天 统计周期内，用户点击标签页Tab的次数。 Tab点击次数近7天 统计周期内，用户点击标签页Tab的次数。 人均使用频次近1天 统计周期内，用户操作使用应用的平均次数。 人均使用频次近7天 统计周期内，用户操作使用应用的平均次数。

应用场景 运营中心在AppStage服务应用的全生命周期的背景下，以应用运营为主线，主要面向应用运营者提供应用运营的分析底座、领域或行业经验资产以及可视化看板等能力，帮助用户高效率、低门槛的展开应用运营，支撑业务的成功。 用户可以通过应用数据接入、数据模型构建、指标配置管理，以及自定义运营看板，分析产品运营过程中取得的成效和潜在问题。 运营中心使用场景： 业务决策者（如领导、业务负责人等）可以基于全场景运营看板随时随地了解业务情况。 业务分析者/执行者（如产品经理、运营人员等）可以根据业务诉求快速生成、查看各类数据报表。 数据工程师/分析师支撑或配合业务提出的数据相关需求，完成一些相对复杂的数据接入、数据建模以及数据指标开发的工作。 父主题： 运营中心简介

指标体系 表1 指标体系 指标名称 指标描述 reg_day 注册用户数日新增 指在一天内注册的新用户数量。这个指标可以用来跟踪一天内注册用户的数量，以及比较不同日期的注册用户数。 reg_month 注册用户数月新增 指在一个月内注册的新用户数量。这个指标可以用来跟踪一个月内注册用户的数量，以及比较不同月份的注册用户数。 reg_total 注册用户数总数 指从网站或应用程序启动以来注册的总用户数量。这个指标可以用来跟踪用户数量的整体趋势，以及比较不同时间段的注册用户数。

指标体系 表1 指标体系 指标名称 指标描述 注册用户数近7天 最近一周内注册的用户数量。 注册用户数总数 统计周期内，总共注册的用户数量。 平均访问时长近7天 最近一周内每个用户平均访问网站或APP的时长。 平均访问时长总值 统计周期内，所有用户平均访问网站或APP的时长。 人均浏览页面数近7天 最近一周内每个用户平均浏览网站或APP的页面数量。 人均浏览页面数总值 统计周期内，所有用户平均浏览网站或APP的页面数量。

使用建议 可以通过这些指标来了解用户的基础情况，比如用户数量、用户活跃度等。 可以通过比较近7天和总数的数据来了解用户的增长趋势。 可以通过比较平均访问时长和人均浏览页面数的数据来了解用户的使用习惯，比如用户是否喜欢浏览更多的页面，是否喜欢花更长的时间在网站或APP上等。 可以通过这些指标来评估网站或APP的用户体验，比如用户是否喜欢在网站或APP上停留更长的时间，是否对网站或APP的内容感兴趣等。

指标体系 表1 指标体系 指标名称 指标描述 GMV日活 统计周期内，拍下的订单金额或支付订单的金额总和(Gross Merchandise Volume)，包含付款和未付款的部分。 GMV月活 统计周期内，拍下的订单金额或支付订单的金额总和(Gross Merchandise Volume)，包含付款和未付款的部分。 销售额日活 统计周期内，纳税人销售货物、提供应税劳务或服务，从购买或接受应税劳务方或服务方收取的全部价款和价外费用，但是不包括向购买方收取的销项税。 销售额月活 统计周期内，纳税人销售货物、提供应税劳务或服务，从购买或接受应税劳务方或服务方收取的全部价款和价外费用，但是不包括向购买方收取的销项税。 利润日活 统计周期内，店铺的实际利润，即销售额减去成本和费用。 利润月活 统计周期内，店铺的实际利润，即销售额减去成本和费用。

更多操作 添加事件属性成功后，您还可以在事件属性页签页面执行如下操作。 表2 更多操作 操作 说明 停用事件属性 当事件属性为“自定义”类型且状态为“启用”时，单击操作列“停用”，可以停用该事件属性。停用以后，元事件不可以关联该属性，该属性也不会再采集上报数据。 说明： “系统预置”的属性不能执行停用操作。 启用事件属性 当事件属性为“草稿”或“停用”状态时，单击操作列“启用”，可以该启用事件属性。启用以后，当元事件关联该属性，该属性将会采集上报数据。

功能介绍 看板 产品运营人员能直观查看关键数据，分析产品运营过程中取得的成效和潜在问题。 看板管理 通过自定义运营看板，可以把产品运营中的关键数据统一呈现出来，可按人员权限和业务类型展示不同的数据看板，可视化展现产品运营现状。产品运营人员能直观查看关键数据，分析产品运营过程中取得的成效和潜在问题。 数据模型 运营中心提供数据建模能力，运营人员可以自定义数据模型，也可以通过逆向数据库生成数据模型。通过提供多表关联建模整合表能力，一个数据模型可以映射多个数据表数据。 指标管理 运营中心提供指标自定义灵活配置能力，可以配置普通指标、复合型指标和静态指标，基于数据模型，通过计算方式、计算时间单位、统计维度、筛选条件组合配置指标。 指标模板库 运营中心提供指标模板应用能力，模板中内置数据模型、指标定义、图表卡片等经验内容。运营中心通过提供多场景模板，以场景驱动一键应用，赋能用户低门槛、高效率地构建指标体系。 数据管理 运营中心提供通用数据接入能力，通过与数据源连接，可以建立数据源中数据表的迁移任务，将源端数据迁移到运营中心，为后续业务做数据准备。 元数据管理 元数据管理作为业务产品业务分析的数据来源基础，提供元事件配置、事件属性配置、用户属性配置等功能，以便使用者对业务产品进行业务分析。 运营分析 当前运营分析只包含事件分析。通过事件分析模型，您可以对各类动态数据进行多指标多维度展示，其中包括：字段的筛选能力，自定义计算以及多指标之间的对比。 审计日志 审计日志是记录系统活动的记录，以便检查和审查这些活动。它包含操作对象、操作IP、操作人、操作时间等。 父主题： 运营中心简介

Token校验 客户端在使用Token校验的流程如下。 已获取大屏分享链接和Token。 例如，分享链接https://console.ulanqab.huawei.com/sve/preview.html?region=cn-north-7#/screen/share/18cd21df7bc-WPgj_GqRc。其中“region”的值为“cn-north-7”，“pageId”的值为“18cd21df7bc-WPgj_GqRc”。 使用代码开发工具将大屏分享链接中的pageId和region拼接成如下格式的字符串。 pageId|region； 使用HmacSHA256算法对拼接的字符串进行签名，并将签名后的字符串使用Base64进行转换。签名时需要使用对应的Token。 HmacSHA256签名和Base64转换的示例如下： import java.security.*; import javax.crypto.*; import javax.crypto.spec.SecretKeySpec; import org.apache.commons.codec.binary.Base64; import java.net.URLEncoder; public class ShareWithTokenTest { public static void main(String[] args) throws Exception { System.out.println(getShareUrlWithToken("********722467a9477b5b*******", "cn-7", "*******r1tyy1C7Jenni3p*********")); } public static String getShareUrlWithToken(String pageId, String region, String token){ String data = pageId + "|" + region; String signature = HMACSHA256(data.getBytes(), token.getBytes()); String url = "https://console.huaweicloud.com/sve/share/page.html?id=" + pageId + "®ion=" + region + "&sve_signature=" + signature; return url; } //采用HmacSHA256进行签名并进行Base64转换 public static String HMACSHA256(byte[] data, byte[] key) { try { SecretKeySpec signingKey = new SecretKeySpec(key, "HmacSHA256"); Mac mac = Mac.getInstance("HmacSHA256"); mac.init(signingKey); return URLEncoder.encode(Base64.encodeBase64String(mac.doFinal(data))); } catch (NoSuchAlgorithmException e) { e.printStackTrace(); } catch (InvalidKeyException e) { e.printStackTrace(); } return null; } } 将转换后的字符串赋值给sveSignature，sveSignature参数拼接到大屏分享链接中获取新的访问链接。 例如，新的访问链接https://console.ulanqab.huawei.com/sve/preview.html?sveSignature=1OP99N6yxCDmEiH4aNMU1GAwtKspSg4fJ/zh0679k=®ion=cn-north-7#/screen/share/18cd21df7bc-WPgj_GqRc

新建指标 在AppStage首页右上区域单击“运营中心”快捷入口，进入运营中心工作台。 在左侧导航栏选择“指标管理”，进入指标管理页面。 单击“新建指标”。 配置指标信息，参数说明如表1、表2、表3所示。 表1 基础信息 参数 说明 名称 必填。在数据分析或监控系统中使用的指标标识符，通常是一个短字符串或缩写。 指标显示名 必填。在数据分析或监控系统中显示的指标名称，通常是一个更易于理解和识别的字符串。 描述 可选。对指标进行详细说明和解释的文字描述。 表2 指标配置 参数 说明 指标类型 必填。要统计的指标的种类。 固定值：普通型指标。 普通型指标 复合型指标 静态指标 说明： 将多个普通指标合并在一个图展示，即为复合型指标。组合型指标只能选择已发布的普通指标组合而成，且最多可以选择8个。 数据模型 选择已发布的数据模型，该参数的取值在“数据模型”页面配置。 仅当“指标类型”为“普通型指标”时，该参数显示且为必填参数。 计算方式 指标的计算方法。 仅当“指标类型”为“普通型指标”时，该参数显示，此时，“函数”为选填，“字段”为必填。 说明： 简易模式可选择常用聚合函数。 高级模式支持自定义计算公式。 计算时间单位 指标的统计时间单位。 仅当“指标类型”为“普通型指标”时，该参数显示且为可选参数。 不选时表示全部数据。 按天：表示统计昨天的数据，数据存到昨天。 按周：表示统计上周数据，数据存到上周日。 按月：表示统计上月数据，数据存到上月1号。 近1天：表示统计前1天的数据，不包含当天，数据存到当天。 近3天：表示统计前3天的数据，不包含当天，数据存到当天。 近7天：表示统计前7天的数据，不包含当天，数据存到当天。 近10天：表示统计前10天的数据，不包含当天，数据存到当天。 近15天：表示统计前15天的数据，不包含当天，数据存到当天。 近30天：表示统计前30天的数据，不包含当天，数据存到当天。 近60天：表示统计前60天的数据，不包含当天，数据存到当天。 近90天：表示统计前90天的数据，不包含当天，数据存到当天。 统计维度 指标的统计维度。 仅当“指标类型”为“普通型指标”时，该参数显示且为可选参数。 筛选条件 指在统计指标时需要满足的筛选条件。 仅当“指标类型”为“普通型指标”或“静态指标”时，该参数显示且为可选参数。 复合类型 指标的类型。仅当“指标类型”为“复合型指标”时，该参数为必填参数。 组合型：指标体系中由多个指标组合而成的指标。 同比增长率：指某个指标在当前时期与同期相比的增长率，通常用于比较不同时间段的数据变化情况。 环比增长率：指某个指标在两个连续时间段内的增长率，通常用于比较同一指标在不同时间段内的变化情况。 组合方式 指多个普通型指标组合成复合型指标的方式。仅当“复合类型”为“组合型”时，该参数为必填参数。 固定值：UNION 选择指标 可以选择2~8个已发布的普通型指标。仅当“复合类型”为“组合型”时，该参数为必填参数。 同比周期 指同比增长率的计算周期。仅当“复合类型”为“同比增长率”时，该参数为必填参数。 年同比：指某一指标与去年同期相比的增长或下降百分比。 月同比：指某一指标与上个月相比的增长或下降百分比。 周同比：指某一指标与上周相比的增长或下降百分比。 环比周期 指环比增长率的计算周期。仅当“复合类型”为“环比增长率”时，该参数为必填参数。 月环比：指某个月份与上一个月份相比，数据的变化百分比。 周环比：指某个星期与上一个星期相比，数据的变化百分比。 日环比：指某一天与前一天相比，数据的变化百分比。 设定普通型指标 选择已发布的普通型指标。仅当“复合类型”为“同比增长率”和“环比增长率”时，该参数为必填参数。 普通型指标作为复合型指标的组成部分，用于综合分析和比较。 静态数据 参数枚举值在“数据表管理”页面配置。仅当“指标类型”为“静态指标”时，该参数显示且为必填参数。 字段 数据表中的特定列。仅当“指标类型”为“静态指标”时，该参数显示且为必填参数。 说明： 该参数值支持多选。 排序 当数据集中有多个字段需要排序，可以指定它们的排序优先级，可以选择升序或降序排序方式。仅当“指标类型”为“静态指标”时，该参数显示且为可选参数。 数量限制 限制数据的数量。仅当“指标类型”为“静态指标”时，该参数显示且为可选参数。 预览数据 选择是否在配置过程中预览数据，以便确认配置的准确性。 表3 任务信息 参数 说明 任务类型 指定配置的任务类型。 周期性任务 一次性任务 运行周期 指定配置任务的运行周期。仅当“任务类型”为“周期性任务”时，该参数为必填参数。 月：表示每月1号运行。 周：表示每周日运行。 天：表示每天运行。 仅当“指标类型”为“普通型指标”时，任务信息显示且为必填参数。 配置完成后单击“发布”或“保存”，新建指标成功。 单击“发布”时，指标状态为“已发布”。 单击“保存”时，指标状态为“草稿”。

基本概念 表1 基本概念说明 基本概念 说明 指标 衡量或评估某个事物的标准。它可以用来衡量和比较不同事物之间的差异，以便更好地了解和管理它们。 OBS 对象存储服务（Object Storage Service，OBS）是一个基于对象的海量存储服务，为客户提供海量、安全、高可靠、低成本的数据存储能力。 AK 访问密钥ID（Access Key ID），华为云通过AK识别用户的身份，通过SK对请求数据进行签名验证，用于确保请求的机密性、完整性和请求者身份的正确性。 SK 秘密访问密钥（Secret Access Key），华为云通过AK识别用户的身份，通过SK对请求数据进行签名验证，用于确保请求的机密性、完整性和请求者身份的正确性。 卡片 卡片是后端服务的前端UI展示形式，可以将一个或者多个UI组件按照业务逻辑组装成卡片或者卡片模板后进行沉淀和使用。用户可以通过公共卡片模板或上传离线卡片的方式构建业务所需要的卡片。 屏幕 用户通过选择屏幕模板可以构建屏幕，业务可视化提供零码、可配置的能力，可二次定义相关的屏幕属性配置。支持新建项目和分组，并在分组下新建屏幕。屏幕构建完成后，可预览屏幕上弹出、联动、区域切换、下钻等卡片交互效果。 父主题： 运营中心简介

操作步骤 在AppStage首页右上区域单击“运营中心”快捷入口，进入运营中心工作台。 在左侧导航栏选择“指标模板库”。 从指标模板库查找所需指标模板，单击选中的模板，当前支持的指标模板如表1所示。 如果指标模板库中未找到所需模板，用户可在“指标管理”页面创建符合业务需要的指标。 表1 指标模板 分类 指标模板名称 描述 通用 页面浏览量（PV）计算模板 页面浏览量（PV）计算模板是用来统计指定的时间段内，某个网站或应用的页面被访问过的数量。 该模板使用指南请参见“页面浏览量（PV）计算模板”。 独立访客数（UV）计算模板 独立访客数（UV）计算模板是用来统计指定时间内，访问某个应用或页面的不同用户数量。每个用户只计算一次，无论他在这段时间内访问了多少次。 该模板使用指南请参见“独立访客数（UV）计算模板”。 新增访客数计算模板 新增访客数计算模板是用来统计指定时间内，网站或应用程序的新增访客数。 该模板使用指南请参见“新增访客数计算模板”。 注册用户数计算模板 注册用户数计算模板是用来统计指定时间内，一个网站或应用程序的注册用户数量。 该模板使用指南请参见“注册用户数计算模板”。 电商 用户基础分析 统计周期内，通过分析新用户注册情况、用户浏览店铺页面情况、用户访问店铺时长等，了解用户的基本情况。 该模板使用指南请参见“用户基础分析”。 店铺销售分析 统计周期内，通过分析GMV、销售额、利润等，了解店铺的销售情况。 该模板使用指南请参见“店铺销售分析”。 互联网应用 应用事件分析 统计周期内，通过分析启动次数、订阅用户数、Banner点击次数、Tab点击次数、人均使用频次等，了解用户使用应用的情况。 该模板使用指南请参见“应用事件分析”。 应用销售分析 统计周期内，通过分析下单次数、下单用户数、支付完成次数、付费用户数等，了解用户使用应用的付费情况。 该模板使用指南请参见“应用销售分析”。 在“模板详情”页面， 单击“应用”，进入“应用模板”页面，选择指标。 选中模板某指标，进入“应用模板”页面。 在“应用模板”页面，完成字段映射，如表2所示。 表2 字段映射 参数 说明 模型显示名 在数据分析或监控系统中显示的模型名称，通常是一个更易于理解和识别的字符串。 源表 指需要从中抽取数据的源数据表。选择源表后，单击源表后面的，可添加引用表，如表3所示。 字段映射 指将源表和引用表中的字段，与模板字段进行映射。 表3 引用表 参数 说明 源表 指需要从中抽取数据的源数据表。 引用表 指需要与源表进行关联的参考数据表。 字段关系 指源表和引用表之间的字段关系。 说明： 最少需输入1个字段关系。 单击“确定”，完成指标模板应用配置。

Token校验 客户端在使用Token校验的流程如下。 已获取大屏分享链接和Token。 例如，分享链接https://console.ulanqab.huawei.com/sve/preview.html?region=cn-north-7#/screen/share/18cd21df7bc-WPgj_GqRc。其中“region”的值为“cn-north-7”，“pageId”的值为“18cd21df7bc-WPgj_GqRc”。 使用代码开发工具将大屏分享链接中的pageId和region拼接成如下格式的字符串。 pageId|region； 使用HmacSHA256算法对拼接的字符串进行签名，并将签名后的字符串使用Base64进行转换。签名时需要使用对应的Token。 HmacSHA256签名和Base64转换的示例如下： import java.security.*; import javax.crypto.*; import javax.crypto.spec.SecretKeySpec; import org.apache.commons.codec.binary.Base64; import java.net.URLEncoder; public class ShareWithTokenTest { public static void main(String[] args) throws Exception { System.out.println(getShareUrlWithToken("********722467a9477b5b*******", "cn-7", "*******r1tyy1C7Jenni3p*********")); } public static String getShareUrlWithToken(String pageId, String region, String token){ String data = pageId + "|" + region; String signature = HMACSHA256(data.getBytes(), token.getBytes()); String url = "https://console.huaweicloud.com/sve/share/page.html?id=" + pageId + "®ion=" + region + "&sve_signature=" + signature; return url; } //采用HmacSHA256进行签名并进行Base64转换 public static String HMACSHA256(byte[] data, byte[] key) { try { SecretKeySpec signingKey = new SecretKeySpec(key, "HmacSHA256"); Mac mac = Mac.getInstance("HmacSHA256"); mac.init(signingKey); return URLEncoder.encode(Base64.encodeBase64String(mac.doFinal(data))); } catch (NoSuchAlgorithmException e) { e.printStackTrace(); } catch (InvalidKeyException e) { e.printStackTrace(); } return null; } } 将转换后的字符串赋值给sveSignature，sveSignature参数拼接到大屏分享链接中获取新的访问链接。 例如，新的访问链接https://console.ulanqab.huawei.com/sve/preview.html?sveSignature=1OP99N6yxCDmEiH4aNMU1GAwtKspSg4fJ/zh0679k=®ion=cn-north-7#/screen/share/18cd21df7bc-WPgj_GqRc

请求消息头 附加请求头字段，如指定的URI和HTTP方法所要求的字段。例如定义消息体类型的请求头“Content-Type”，请求鉴权信息等。 详细的公共请求消息头字段请参见表3。 表3 公共请求消息头 名称 描述 是否必选 示例 Host 请求的服务器信息，从服务API的URL中获取。值为hostname[:port]。端口缺省时使用默认的端口，https的默认端口为443。 否 使用AK/SK认证时该字段必选。 code.test.com or code.test.com:443 Content-Type 消息体的类型（格式）。推荐用户使用默认值application/json，有其他取值时会在具体接口中专门说明。 是 application/json Content-Length 请求body长度，单位为Byte。 否 3495 X-Project-Id project id，项目编号。请参考获取项目ID章节获取项目编号。 否 如果是专属云场景采用AK/SK认证方式的接口请求，或者多project场景采用AK/SK认证的接口请求，则该字段必选。 e9993fc787d94b6c886cbaa340f9c0f4 X-Auth-Token 用户Token。 用户Token也就是调用获取用户Token接口的响应值，该接口是唯一不需要认证的接口。 请求响应成功后在响应消息头（Headers）中包含的“X-Subject-Token”的值即为Token值。 否 使用Token认证时该字段必选。 注：以下仅为Token示例片段。 MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ API同时支持使用AK/SK认证，AK/SK认证使用SDK对请求进行签名，签名过程会自动往请求中添加Authorization（签名认证信息）和X-Sdk-Date（请求发送的时间）请求头。 AK/SK认证的详细说明请参见认证鉴权的“AK/SK认证”。 对于获取用户Token接口，由于不需要认证，所以只添加“Content-Type”即可，添加消息头后的请求如下所示。 1 2 POST https://iam.cn-north-1.myhuaweicloud.com/v3/auth/tokens Content-Type: application/json

请求消息体（可选） 该部分可选。请求消息体通常以结构化格式（如JSON或XML）发出，与请求消息头中Content-Type对应，传递除请求消息头之外的内容。若请求消息体中的参数支持中文，则中文字符必须为UTF-8编码。 每个接口的请求消息体内容不同，也并不是每个接口都需要有请求消息体（或者说消息体为空），GET、DELETE操作类型的接口就不需要消息体，消息体具体内容需要根据具体接口而定。 对于获取用户Token接口，您可以从接口的请求部分看到所需的请求参数及参数说明。将消息体加入后的请求如下所示，加粗的斜体字段需要根据实际值填写，其中username为用户名，domainname为用户所属的账号名称，********为用户登录密码，xxxxxxxxxxxxxxxxxx为project的名称，如“cn-north-1”，您可以从地区和终端节点获取。 scope参数定义了Token的作用域，下面示例中获取的Token仅能访问project下的资源。您还可以设置Token的作用域为某个账号下所有资源或账号的某个project下的资源，详细定义请参见获取用户Token。 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 POST https://iam.cn-north-1.myhuaweicloud.com/v3/auth/tokens Content-Type: application/json { "auth": { "identity": { "methods": [ "password" ], "password": { "user": { "name": "username", "password": "********", "domain": { "name": "domainname" } } } }, "scope": { "project": { "name": "xxxxxxxxxxxxxxxxxx" } } } } 到这里为止这个请求需要的内容就具备齐全了，您可以使用curl、Postman或直接编写代码等方式发送请求调用API。对于获取用户Token接口，返回的响应消息头中的“x-subject-token”就是需要获取的用户Token。有了Token之后，您就可以使用Token认证调用其他API。

请求URI 请求URI由如下部分组成： {URI-scheme}://{Endpoint}/{resource-path}?{query-string} 尽管请求URI包含在请求消息头中，但大多数语言或框架都要求您从请求消息中单独传递它，所以在此单独强调。 表1 URI中的参数说明 参数 描述 URI-scheme 表示用于传输请求的协议，当前所有API均采用HTTPS协议。 Endpoint 指定承载REST服务端点的服务器域名或IP，不同服务不同区域的Endpoint不同，您可以从地区和终端节点获取。 例如IAM服务在“华北-北京四”区域的Endpoint为“iam.cn-north-4.myhuaweicloud.com”。 resource-path 资源路径，即API访问路径。从具体API的URI模块获取，例如“获取用户Token”API的resource-path为“/v3/auth/tokens”。 query-string 查询参数，是可选部分，并不是每个API都有查询参数。查询参数前面需要带一个“?”，形式为“参数名=参数取值”，例如“?limit=10”，表示查询不超过10条数据。 例如您需要获取IAM在“华北-北京四”区域的Token，则需使用“华北-北京四”区域的Endpoint（iam.cn-north-4.myhuaweicloud.com），并在获取用户Token的URI部分找到resource-path（/v3/auth/tokens），拼接起来如下所示。 1 https://iam.cn-north-4.myhuaweicloud.com/v3/auth/tokens 图1 URI示意图 为方便查看，在每个具体API的URI部分，只给出resource-path部分，并将请求方法写在一起。这是因为URI-scheme都是HTTPS，而Endpoint在同一个区域也相同，所以简洁起见将这两部分省略。

请求方法 HTTP请求方法（也称为操作或动词），它告诉服务您正在请求什么类型的操作。 表2 HTTP方法 方法 说明 GET 请求服务器返回指定资源。 PUT 请求服务器更新指定资源。 POST 请求服务器新增资源或执行特殊操作。 DELETE 请求服务器删除指定资源，如删除对象等。 HEAD 请求服务器资源头部。 PATCH 请求服务器更新资源的部分内容。 当资源不存在的时候，PATCH可能会去创建一个新的资源。 在获取用户Token的URI部分，您可以看到其请求方法为“POST”，则其请求为： 1 POST https://iam.cn-north-1.myhuaweicloud.com/v3/auth/tokens

Token认证 Token的有效期为24小时，需要使用一个Token鉴权时，可以先缓存起来，避免频繁调用。 Token在计算机系统中代表令牌（临时）的意思，拥有Token就代表拥有某种权限。Token认证就是在调用API的时候将Token加到请求消息头中，从而通过身份认证，获得操作API的权限。Token可通过调用获取用户Token接口获取。 调用本服务API需要项目级别的Token，即调用获取用户Token接口时，请求body中auth.scope的取值需要选择project，如下所示。 { "auth": { "identity": { "methods": [ "password" ], "password": { "user": { "name": "username", //IAM用户名 "password": "********", //IAM用户密码 "domain": { "name": "domainname" //IAM用户所属账号名 } } } }, "scope": { "project": { "name": "xxxxxxxx" //项目名称 } } } } 获取Token后，再调用其他接口时，您需要在请求消息头中添加“X-Auth-Token”，其值即为Token。例如Token值为“ABCDEFJ....”，则调用接口时将“X-Auth-Token: ABCDEFJ....”加到请求消息头即可，如下所示。 1 2 3 POST https://iam.cn-north-1.myhuaweicloud.com/v3/auth/projects Content-Type: application/json X-Auth-Token: ABCDEFJ.... 您还可以通过这个视频教程了解如何使用Token认证：https://bbs.huaweicloud.com/videos/101333。

AK/SK认证 AK/SK签名认证方式仅支持消息体大小在12MB以内，12MB以上的请求请使用Token认证。 AK/SK认证就是使用AK/SK对请求进行签名，在请求时将签名信息添加到消息头，从而通过身份认证。 AK（Access Key ID）：访问密钥ID。与私有访问密钥关联的唯一标识符；访问密钥ID和私有访问密钥一起使用，对请求进行加密签名。 SK（Secret Access Key）：私有访问密钥。与访问密钥ID结合使用，对请求进行加密签名，可标识发送方，并防止请求被修改。 使用AK/SK认证时，您可以基于签名算法使用AK/SK对请求进行签名，也可以使用专门的签名SDK对请求进行签名。详细的签名方法和SDK使用方法请参见API签名指南。 签名SDK只提供签名功能，与服务提供的SDK不同，使用时请注意。

操作步骤 进入“我的订单”页面。 可以输入订单号搜索查看订单，也可以根据创建时间、产品类型、订单类型、订单状态筛选查看订单。 若查看云服务订单，选中“云服务”页签。单击“包年/包月”可查看包年/包月订单，单击“按需”可查看按需订单。 若查看硬件订单，选中“硬件”页签。 在订单页面找到待查看的订单，单击“详情”。 订单状态为“处理中”有两种情况：表示资源创建中；表示该订单下有资源开通失败。 不同的云服务产品，订单处理的时间不一样，正常情况在10分钟以内完成处理。 当云服务订单中有资源开通失败时，系统会自动退订开通失败的资源。可在订单详情页面查看退款详情。 当云服务订单状态为“待支付”时，订单详情页面客户可支付订单或取消订单。 若订单是客户经理在合同内进行的代客下单，客户可在订单详情页面单击“合同名称”进入合同详情页面查看合同及订单信息。 多个云服务实例一同交易生成组合交易订单。“一同交易”包括多个云服务资源组合开通、批量操作、组合购买等场景。组合交易订单下的各个订单必须一同支付或取消。支付完成后，各个云服务实例后续可单独进行交易。 当为组合交易订单时，客户可在组合交易订单详情页面订单信息处单击“订单号”，进入订单详情页面查看具体云服务实例的订单信息。 当订单归属于组合交易订单时，客户可单击“组合交易订单号”，进入组合交易订单详情，查看组合交易信息以及组合交易订单下包含的所有订单。 当云服务订单状态为“已完成”时，订单详情页面客户可查看资源的详细信息。若资源发生续费、变更、退订，则可查看交易记录跟踪信息。 订单详情页面交易记录跟踪展示数量默认为3条，超过3条（含3条）以上时，均显示“查看全部记录”，可单击“查看全部记录”，弹窗中查看交易记录跟踪数据。支持通过“交易类型、创建时间、订单号”三种筛选条件筛选查询。 当新购硬件订单状态为“待支付”时，订单详情页面客户可以支付订单、申请修改地址、取消订单、设置延后发货等。 当新购硬件订单状态为“待发货”时，订单详情页面客户可以申请取消发货、申请修改地址、设置延后发货等。 当新购硬件订单状态为“已完成”时，订单详情页面客户可以退货、换货，查看交易记录跟踪、安装信息等。 当硬件退货/换货订单处于待审核状态或待快递上门取货状态时，在订单详情页面客户可以取消订单等。

操作步骤 进入“我的订单”页面。 导出订单：设置查询条件后，单击列表左上角的“导出全部”。 若只需导出“云服务”订单：单击“云服务”页签，单击“包年/包月”可导出包年/包月订单，单击“按需”可导出按需订单。设置查询条件后，单击列表左上角的“导出全部”。 若只需导出“硬件”订单：单击“硬件”页签，设置查询条件后，单击列表右上角的“导出全部”。 导出后页面自动跳转到“导出记录”，文件生成完成后，单击操作栏“下载”，下载导出文件。 IAM用户仅能查看/下载自己的导出文件，不能查看/下载其所属账号及账号下其他IAM用户的导出文件。

操作步骤 进入“待支付订单”页面。 可以输入订单号搜索或根据产品类型、订单类型、订单状态筛选需要取消的订单。 在订单页面找到该订单，单击“取消”。 商品组合购买生成的多个订单，需同时取消。如果对商品组合购订单中的一个订单进行取消，系统弹出提示“取消本订单时，关联的订单会同步取消”，确认后所有关联订单一并取消。 取消组合交易订单时，组合交易订单下所有关联的订单会同步取消。 在系统弹出的“提示”对话框中，单击“确定”。

订单状态说明 表1 订单状态说明 订单状态 订单状态说明 待支付 客户提交订单之后，还未支付的状态。 待审核 部分订单下单后需要审核才能支付，下单之后审核之前的状态。 部分资源退订/硬件退换货后需要审核才能完成退款，退订/退换货申请提交之后审核退款或换货之前的状态。 退款中 订单提交申请退订或退货之后，退款给客户之前的状态。 处理中 下单支付之后，资源开通出来之前的状态。 已完成 订购、变更、续费、退订等流程的生命周期走到了尽头。 已取消 客户自己取消或者系统自动取消的订单所处的状态。 待确认 客户经理代客下单之后，处于待确认状态。 待发货 硬件订单支付完成后，卖家发货之前的状态。 待收货 硬件订单卖家发货之后，买家收货之前的状态。 待上门取货 硬件订单申请退货/换货之后，快递上门取货之前的状态。 换新中 硬件订单申请换货后，卖家发货之前的状态。 待卖家签收 硬件订单申请退货/换货并寄出货物后，卖家收货之前的状态。 父主题： 我的订单

操作步骤 进入“待支付订单”页面。 可以输入订单号搜索或根据产品类型、订单类型、订单状态筛选待支付订单。 根据实际情况选择单个支付或合并支付。 单个支付：单击待支付订单列表对应的“支付”。 合并支付：选中待支付订单前的复选框后，单击订单列表左上角“合并支付”。 商品组合购买生成的多个订单，对其中一个订单支付时会自动带出其他关联订单一并支付。若商品组合购订单中的部分订单待审核，部分已审核完成的订单也不能支付，需所有订单都审核通过后才可以一起支付。 商品组合购买生成的多个订单，勾选其中一个订单进行合并支付，同时自动勾选其他关联订单，并提示“已自动选中其他**个关联订单”；取消勾选其中一个订单时，自动取消勾选关联订单，并提示“已取消选中其他**个关联订单”。若商品组合购订单中的部分订单待审核，则无法勾选任何一个订单进行合并支付。 合并支付勾选的订单数最多不能超过30个。 在合并支付订单时，若其中有订单状态发生变更，则订单状态已变更的订单不能再进行支付。例如： 合并支付订单中有部分订单的订单状态已变更，则提示“订单状态已变更的订单不能进行支付”，展示需要移除支付的订单号以及将继续支付的订单号。 合并支付订单中全部订单的订单状态已变更，则提示“全部订单的订单状态已发生变更，不能进行支付操作”。可单击“返回我的订单”，查看订单状态变更详情。 合并支付订单中有订单的订单状态为“待审核”，则提示“以下订单需要通过审核才能支付，请耐心等待审核，审核通过后我们将发送通知您账号绑定的手机和邮件，收到通知后您可以继续支付订单”，并展示具体的订单号。 合并支付订单中有订单的订单状态为“待确认”，则提示订单待确认。如果是客户，请联系客户经理到CRM系统确认订单；如果是客户经理，则可单击“返回CRM”确认订单。 选择优惠和支付方式，单击“确认付款”。 如果客户自主下单的产品规格与客户标准销售合同的产品存在重叠，支付订单时弹框提示“请确认当前下单是否属于合同外下单，否则将无法支付”，确认后可以继续支付，否则无法继续支付。 优惠包含折扣优惠和优惠券。优惠的相关使用说明可参见支付订单时如何使用折扣优惠和优惠券。 使用API查询订单可用优惠券请参见“查询订单可用优惠券”。 使用API查询订单可用折扣请参见“查询订单可用折扣”。 支付方式有：余额支付、在线支付、余额+在线组合支付、合作伙伴代付。 余额支付：选择余额支付，单击“确认付款”，支付完成。 账户余额不足时，客户可以先 充值 后再支付，充值详细操作步骤可参见账户充值。 企业客户可以通过申请线上合同向公司请款。若订单使用了折扣，请确保在折扣有效期内完成请款，避免优惠金额失效。申请线上合同请款详细操作步骤，请参见如何申请请款合同。 在线支付：选择在线支付，单击“去在线支付”，跳转到华为云收银台，选择在线支付方式（支付宝、微信、银联、Huawei Pay等）后，单击“确认支付”。 只有签约主体为“华为云计算技术有限公司”或“华为软件技术有限公司”时才支持在线支付，其他签约主体，不支持在线支付。 平台支付选择支付宝或微信支付确认支付后，弹出二维码，需打开手机支付宝或微信扫码付款，完成支付。 平台支付选择Huawei Pay确认支付后，弹出二维码，需打开华为钱包APP扫码付款，完成支付。仅当签约主体为“华为云计算技术有限公司”时，才支持Huawei Pay支付。 平台支付选择银联在线支付确认支付后，跳转到银联支付页面，输入卡号或登录银联账号付款，完成支付。 个人网银支付时，页面上选择银联支付，确认支付后跳转银联支付页面，选择支付银行，单击“到网上银行支付”，跳转到相应的银行支付平台输入银行卡相关信息后，完成支付。 企业网银支付时，页面上选择银联支付或支付银行，跳转到相应的银行支付平台输入银行卡相关信息后，完成支付。 余额+在线组合支付：选择余额支付时，输入余额支付金额小于订单应付金额时，需同时勾选在线支付剩余应付金额。单击“去在线支付”，跳转到华为云收银台。请参见如何在线支付。 当客户在“安全设置＞敏感操作”里面开启操作保护后，余额+在线组合支付订单，且支付金额都不为零的情况下，需要输入验证码进行身份验证才能支付成功。可参见支付订单需要身份验证吗？如何关闭身份验证？。 合作伙伴代付：选择合作伙伴代付，并单击“请他付款”，申请伙伴支付订单。申请成功后，系统会以短信和邮件形式通知合作伙伴支付。 客户申请由合作伙伴提交并支付订单时，不能使用自己账号下的优惠券。 合作伙伴代付适用范围请参见如何申请合作伙伴支付订单。

相关规则 支付方式： 自动支付支持账户余额（含现金额度和信用额度）或月末结算扣款，若客户支持月末结算，则系统优先选择月末结算方式付款。硬件订单自动支付不支持月末结算。同时也支持使用折扣优惠、代金券、储值卡和现金券，使用顺序如下： 折扣优惠（每次只能使用一项）→代金券（每次只能使用一张）→现金券或储值卡（每次可使用多张，可同时使用）→账户余额（先扣现金额度后扣信用额度）或月末结算（硬件订单除外） 若自动支付时，系统匹配到折扣优惠、代金券、储值卡和现金券都满足要求，则可按使用顺序同时使用。 自动支付折扣使用匹配规则： 系统会从客户名下商务授权折扣、促销折扣（客户该资源的历史订单中使用过促销折扣且促销折扣在有效期内，才会比较促销折扣，且用于比较的促销折扣是历史订单中使用过的，其他场景不能使用促销折扣）中选择最优折扣（计算出来的订单金额最低的折扣）进行打折。 资源的历史订单指现订单创建之前存在的订单，如原来的续费单、变更单、订购单等。若历史订单有使用促销折扣支付，则现订单自动支付才可以使用该促销折扣。 例如：客户下了订单A，随后发起变更规格生成订单B，则订单A为订单B的历史订单。历史订单A中有使用促销折扣，若自动支付订单B时，若折扣仍生效，也可使用该促销折扣。 若商务授权折扣和促销折扣，每种折扣打折后的价格是一样的，系统按“商务授权折扣 → 促销折扣”的顺序使用折扣。 对于包年商品，商务授权折扣匹配基于商品定价周期，与订购周期无关。例如1年定价商品无论订购几年，都匹配1年的商务折扣，只能选择1年的商务折扣。 示例1： 客户A于2020年11月20日下单购买某云服务，此时客户名下有商务授权折扣（8折）、促销折扣（7折），且这些折扣都适用于该云服务，但没有历史订单，不能使用促销折扣，在自动支付时系统会选择自动选择商务授权折扣（8折）进行打折。 示例2： 客户B于2020年11月20日下单购买某云服务，使用商务授权折（8折）扣打折；在2020年12月20日时变更该云服务，此时客户名下有商务授权折扣（8折）、促销折扣（7折），且这些折扣都适用于该云服务，但由于历史订单没有促销折扣可使用，在支付时系统会选择自动选择商务授权折扣（8折）进行打折。 示例3： 客户C于2020年11月20日下单购买某云服务，使用促销折扣（7.5折）打折；在2020年12月20日时变更该云服务，此时客户名下有商务授权折扣（8折）、促销折扣（7.5折）、促销折扣（7折）且这些折扣都适用于该云服务。则在支付时系统选择已使用过的且仍生效的促销折扣（7.5折），结合商务授权折扣（8折）进行比较，选择最优折扣：促销折扣（7.5折）进行打折。 自动支付使用代金券规则： 以下规则说明默认所有代金券都在有效期内。 代金券余额最大原则：系统自动查询客户账号下的所有代金券，从中匹配余额最大的一张代金券。 余额最大代金券 ≥ 自动支付金额 规则：优先抵扣余额最大的代金券。 余额最大代金券＜自动支付金额 规则：优先抵扣余额最大的代金券，再结合账户余额（含现金额度和信用额度）或月末结算（硬件订单除外）进行支付。 若代金券余额相同，则优先使用最早到期的代金券。 自动支付扣款时，系统选择的代金券会自动锁定要使用的额度，支付完成自动抵扣该额度，支付失败或支付超时将自动解锁该额度。

操作步骤 进入“待支付订单”页面。 单击订单记录所在行的“详情”或订单号，进入订单详情页面。 当云服务订单状态为“待支付”时，待支付订单详情页面客户可支付订单或取消订单。 若订单是客户经理在合同内进行的代客下单，客户可在订单详情页面单击“合同名称”进入合同详情页面查看合同及订单信息。 多个云服务实例一同交易生成组合交易订单。“一同交易”包括多个云服务资源组合开通、批量操作、组合购买等场景。组合交易订单下的各个订单必须一同支付或取消。支付完成后，各个云服务实例后续可单独交易。 当为组合交易订单时，客户可在组合交易订单详情页面订单信息处单击“订单号”，进入订单详情页面查看具体云服务实例的订单信息。 当订单归属于组合交易订单时，客户可单击“组合交易订单号”，进入组合交易订单详情，查看组合交易信息以及组合交易订单下包含的所有订单。 当硬件订单状态为“待支付”时，待支付订单详情页面客户可以支付订单、申请修改地址、取消订单、设置延后发货。