华为云用户手册

操作指导(Work Instruction/Guideline) Work Instruction/Guideline描述了完成流程活动和任务的方法(How to do)，集成了针对活动的内部和外部最佳实践。指导书中描述的方法或要求是建议的、非强制性的。 它作为Procedure文件的一种可选的支撑文件，用于： 为流程中某个或某些特定的、较复杂活动提供方法指导(How to do)； 为某种或某几种算法(例如数字滤波器标准算法)或方法(例如风险评估方法、数据属性定义)提供详细描述，这些方法来源于企业内部或业界好的实践； 为某个角色或某类角色在一个或一类活动提供方法和指导； 描述某个或每类流程裁剪规则和条件(单独成文的裁剪指南)； 为工作产品或过程绩效度量提供指导(度量指导书)； 针对同一事物，指导书可以提供多种方法以供选择。在确保活动或流程目的的前提下，流程执行人员可以使用未被指导书描述的方法完成流程活动，即指导书中的方法是非强制的。提示：IT系统的产品或操作手册，属于工具附件，不纳入流程文件管理体系。

流程架构(BPA-Business Process Architecture) 流程架构是针对流程的一个结构化的整体框架，描述了企业流程的分类、层级以及边界、范围、输入/输出关系等，反映了企业的运营模式及业务特点。 解释及说明： 不是具体的流程活动描述，主要描述的是流程层级、归类和边界/范围等，流程架构从宏观层面定位了流程的位置； 主要目的是管理流程边界、归属及衔接关系，流程架构是公司统一管理的； 流程的设计必须遵从架构； 流程架构具有相对稳定性。

输入/输出 输入/输出即business item，简称BI。是指流程中各业务活动的输入/输出对象，包括数据实体以及承载数据的表、证、单、书，如：要货需求表、会计凭证、采购订单、工程委托书、工程付款计划、PO验收报告、设计规格书等。输入/输出构成了流程间和流程中活动间的信息链。每一个流程活动都会有输入和输出，每个BI有且只有一个流程活动创建，可在多个流程活动中使用或更新。BI要保证唯一性，即流程中多次出现的同一个BI，其名称必须保持一致。

管理体系手册(Management System Manual) Management System Manual是流程体系(管理体系、流程分类和流程组)的纲领性描述文件，一般包括： 目的 范围 遵从的管理方针、政策 体系的产品质量、流程绩效和其它管理目标 为运作本体系提供的资源 体系的组成、结构、相互间交互关系和接口描述 体系内各流程目的、目标和范围 本体系的管理、控制和持续改进机制 体系的管理组织和授权 管理策略和预算 度量、审核和评估 管理评审 与适用法律、法规或国际标准的遵从关系 版本信息和配套表 华为管理体系的子体系(如质量管理体系、EHS管理体系、BG管理体系、持续改进管理体系等)是华为管理体系的一个剖面或子集，可以通过Mgmt System Manual加以阐述。

检查表(Checklist) Checklist是一种用途广泛的模板工具，是根据流程(Procedure、Regulation/Standard、Template等)及其要求预定义的、结构化的表格，是为保证工作交付的质量能够达到要求的质量标准而设计的检查要素清单。通常是一组针对被检查对象主要特征的问题，或需要搜集的数据项，甚至一系列的活动名称和要点。通过设计的检查要素，检查工作完成情况或交付件内容完备性，以保证工作的质量或输出文档满足输出标准和要求。Checklist可以带有期望的结果，以便对照参考。 在进行交付件或业务过程符合性测试、数据收集、检查或评估时，Checklist为检查者提供提示信息，以防遗漏某些检查点。除非特别说明，检查者在进行交付件或业务过程检查与评估时，依据的标准是Procedure、Regulation/Standard、模板等流程描述，Checklist仅为帮助检查的工具。因此，检查的范围可能超出Checklist中罗列的检查项。

Activity 活动 活动是流程的基本单元，是流程的要素之一。指某个角色(团队或个人)利用特定的工具和资源，按确定的要求和标准，将明确的输入转换为明确的输出的过程。活动的目的即形成符合要求的输出，这种输出是实现流程目的所必须的。活动被用来将流程分解成落实到角色的可执行单元，实现人员的专业分工，提高业务过程的有效性和效率，降低训练成本。 活动具有以下特点： 被单个特定(个体或团队)角色长期重复进行，以便进行专业分工，提高有效性和效率。 流程的每个活动要明确责任角色，某些活动可以有协同参与的角色共同完成，但如果某项工作存在多个责任角色，建议拆分成不同活动，以便各负其责。如果存在多个步骤，其责任角色相同，输入输出相同，则建议对这些活动进行合并。 如果执行活动的是团队角色(如：设计方案评审团队)，则团队的各个体在活动中的行为、所承担的职责、所利用的输入基本一致，个体的交付不完整，甚至难以从活动结果中识别特点个体的交付物。团队角色中的某个或某些个体可能在同一流程中还承担了其他角色。团队角色在流程中不宜过多，且一般需要安排团队的负责人或代表，以免使沟通线路复杂化。 活动是结构化的，有明确的开始、结束、输入、输出和要求，有明确的执行角色，并封装了执行活动的角色、方法和技术。 活动一般以动宾结构来命名(动词+名词)，其中名词一般是活动的操作对象、输入或输出。 流程活动的颗粒度没有严格的标准，对于业务成熟度高(作业相对标准化、自动化率较高、员工技能娴熟等)的流程活动颗粒度可以概括一些，反之则要细化和详细一些；流程活动的颗粒度还与IT相关，如果业务操作的IT化率较高，则流程活动描述相对概括、简单，反之亦然。

流程管理 流程管理是一种以规范化构造满足客户需求的端到端卓越业务流程为中心，以持续的提高组织业务绩效为目的的系统方法。 华为公司流程管理的概念：流程管理是以业务流程为管理对象、关注流程是否给客户和公司增值的管理方法与活动。流程管理的目的是有效支撑业务的发展和持续改进，为公司的业务战略服务。 流程管理的生命周期包括：流程规划与需求管理、设计/优化与推行、执行与监控、评估与度量到流程废止管理。流程设计质量确定流程是否简单、实用和高效；流程的培训与推行是流程落地的关键手段；管理体系是流程有效运作的保障；评估与度量是管理改进的仪表盘。

流程责任人（Process Owner） GPO（Global Process Owner）：全球流程责任人，基于流程架构L1（MBS按L2）设置，代表公司负责所辖流程域的全业务流程管理，GPO由执行该流程域中大部分关键流程活动的业务部门负责人担任，在流程管理中超越部门职责边界。 BPO（Business Process Owner）：业务流程责任人，基于流程组设置，负责对准目标结果驱动流程的建设与运营，指导Local PO工作。BPO负有和GPO类似的职责，主要区别是管理范围、权力不同。 Local PO（Local Process Owner）：领域流程责任人，基于流程落地的组织单元设置，包括BUPO(业务单元流程责任人)、FUPO（功能组织流程责任人）、RPO/CPO(区域流程责任人)等。 对公司标准流程在所辖组织范围内的实施及落地负责，并主动构建匹配客户特点和当地法律法规的流程。

Sub-Process 子流程 子流程是复杂流程的分解，是一个更大流程的一部分。如果必要且可能，子流程可以进一步分解为更小粒度的子流程。若流程较复杂或存在多种可交付的重要输出，流程被分解为子流程，使流程相对简明、输出更为单纯，实现职能单元的分工和解耦，便于开发、维护、理解和执行和进一步授权管理。子流程是相对概念，如果必要且可能，子流程可以进一步分解为更小颗粒度的子流程。子流程与流程没有本质上的区别，遵循流程的设计原则。流程可能是由子流程组成的，也可能直接由活动组成。

流程视图(Process View) 流程视图是表示业务流程信息的一个集合，向某一特定情形或特定用户群提供一个业务总览图。它反映了特定规则下或特定业务场景里，流程之间的关联关系。 绘制流程视图的要求： 流程视图可根据业务需求从不同视角去构建，如：区域、国家、产品线、功能领域、客户、项目组等特定的业务场景或用户群。 通常是由流程架构里的流程组、流程或子流程构成，必要时也可把活动构建在流程视图上。除流程设计和优化过程中外，流程视图中的活动须引用已发布流程或子流程里的活动，不能新建。 通常展示在一个页面上，有时为了便于理解，也可在视图上使用特定的符号或文字说明。

模板(Template) Template是为了节省流程活动执行的时间、保障业务流程活动质量和一致执行而预定义的待填写的格式文件，可能带有预定义宏或软件代码。Template也承载了对活动和流程输入/输出的部分要求，包括对信息和数据质量的要求。 Template的内容和格式体现了流程内部上下游活动、流程与外部(供应商、下游、IT系统、客户或外部机构)流程、系统、管理体系之间的接口。 相对于承载活动输出的Template，承载流程外部输出的Template是判断流程变更范围的重要依据，与流程分层授权关系密切。为确保流程内外部的衔接和集成，Template的内容和格式应受到管控，对Template的裁剪和客户化应当遵循流程裁剪指导。

流程变更需求(Process Change Requirement 简称：CR ) 是指由于业务发生变化或已有流程设计存在缺陷，导致流程不能满足业务运作要求而提出对流程变更的需求。 由于流程是以流程文件方式体现，故流程变更通常体现在对流程文件的变更，包括：管理体系指南、规范、程序、操作指导、模板、检查表。 解释及说明： 有业务没流程或新增业务需设计新流程； 流程的范围、边界、接口关系发生变化； 流程活动、角色、输入/输出、KCP等要素发生变化； 支撑流程运作的业务规则、操作指导、模板/Checklist发生变化。

定制化流程(Customized Process) 公司标准流程是基于公司范围内的典型业务场景而制定的流程，具有普遍的适用性，与之配套的IT建设、岗位赋能、内控管理等均具有全球的一致性。 定制化流程是当公司标准流程在某种特定业务场景下不完全适用而定制的流程。如：《IPD产品开发概念阶段流程》是一个标准的全球流程，而《IPD产品开发概念阶段流程_无线》是这个全球流程的定制化流程。 定制化流程可以基于全球标准流程等已有流程适配产生，也可以基于特定场景新建产生。 流程首先考虑全球通用，一般在当地法律、商业惯例等与全球流程存在冲突时，或确实存在无法统一的业务模式时才考虑定制化。如果一个流程的活动、活动逻辑顺序、角色都是一致的，只是操作指导、业务规则、模板、检查表等支撑文档有差异，不需要定制化流程，只需定制存在差异的支撑文档即可。流程定制化后要保持与前后端流程、其它相关流程的逻辑接口一致。

Process Category 流程域 Process Category流程域是从客户价值实现出发、按照企业价值创造过程和价值定位划分的公司最高阶的流程，整体上体现了公司的业务方向和运营模式。如1.0 IPD 、10.0 MHR、8.0 SUP等。 流程域被用来定义公司管控(如DSTE)和核心价值的创造和交付(如LTC, SD, IPD, SUP等)过程，或者资源管理的主领域(如HR等)，以划分不同GPO的管理范围，确定流程在公司流程架构中的位置和流程的类型(Operating，Enabling，Supporting)。 流程域主要从客户价值实现出发，按照端到端的业务流的逻辑和价值定位的视角进行分类，不是按照业务功能分类。如IPD的价值定位是为客户提供有竞争力的产品和解决方案，其内部业务流程是端到端的，涉及到研发、Marketing、销售、制造、服务、财经等各功能环节。每一个流程分类都有清晰、明确的价值定位，不同的流程分类价值定位既有区别又相互关联，所有的流程分类组合在一起共同构成了一个有机联系的业务运作体系，有效地支撑客户价值的实现和公司目标的达成。

业务规则 业务规则是企业内部定义业务事实、约束和控制业务行为的标准或声明。业务规则应该显性化、结构化，并与流程中的活动建立关联关系。活动是为了实现业务目的、根据业务逻辑而必须做的事，相对稳定；业务规则是由内外部约束、管理诉求而产生的，相对灵活多变。以确保活动序列（流程）简洁、清晰。 权力事项是在业务运作过程中，需要进行审核审批的事项（包括：分层分级的权力事项子项，及其对应的审核审批主体）。授权指为使业务高效运作且风险可控，通过政策/流程将业务权力分配给特定岗位/团队的行为。行权指权力人根据政策/流程要求，行使赋予自身岗位/个人权力的行为。

规范/标准(Regulation/Standard) Regulation/Standard文件是Procedure文件的补充，用来详述那些不便在Procedure文件中描述的、必须遵循要求。它是Procedure文件的一种可选的支撑文件。为保证业务流程的有效执行，规范/标准需描述本流程涉及的政策、管理导向、工作要求，以及质量、内控、数据、IT、网络安全等行业管理要求，还需要概述本流程执行所需的组织、各类角色及职责，授权／行权／监控机制，流程的指标及衡量标准。必须遵守的流程要求(包括对活动、任务、交付件的产品或服务要求)篇幅过大、活动要求间无逻辑顺序关系或含有大量的图/表时，可单独形成Regulation/Standard文件来加以描述。Regulation/Standard文件与Procedure文件拥有同等效力。 一般将对行为方面的要求称为Regulation，对交付件的要求称为Standard。例如客户咨询电话应答规范、防静电作业规范、安全作业规范和电路设计标准、财经数据标准、产品标准、安装服务标准、隐蔽工程标准等。两者的名称可根据语言习惯进行选择。 Regulation/Standard也可以是对国际和行业标准、当地的法律法规的引用，流程Owner必须确保被引用标准文件的时效性。

流程绩效(Process Performance) 是指流程运行的效果和效率。流程绩效有外部效果与内部效率两种维度；外部效果关注的是流程的结果；内部效率关注的是流程的过程。 流程绩效管理的主要收益： 支撑业务目标达成 ：流程绩效支撑业务绩效目标的达成，为业务绩效的达成提供有效的路径； 过程预警与监控 ：通过对流程的效率与效果度量，将容易发现流程执行是否处于管控之内；对分段流程的度量将及时发现分段流程的不稳定性和失效性，起到预警作用，并及时采取措施，以确保E2E流程效率和效果的目标达成; 发现短木板流程：通过流程绩效指标之间的层级结构关系可以诊断出导致上层指标失败的下层责任流程(即短木板)；进而找出该短木板流程指标失败的根因并进行流程改善； 监控流程执行与遵从 ：通过对个体流程的绩效度量，容易发现流程管理中和流程执行中的细节问题，如文件的管理、数据的管理；进而有助于提高流程执行遵从度，提高审计满意； 为变革与优化提供量化评估工具：对流程的效率和效果的度量将为业务变革所引发的流程变革与优化提供量化的评估工具。

数据图层元素介绍 系统预置丰富的数据图层元素供您使用，各元素介绍如表1所示。 表1 元素介绍 类型 元素 说明 通用元素 菱形 菱形元素，在创建数据图层时根据需求添加，如菱形元素可以用于表示决策点或分支。 圆头矩形 圆头矩形元素，在创建数据图层时根据需求添加，如圆头矩形可以用于表示流程起点或结束点。 圆角矩形 圆角矩形元素，在创建数据图层时根据需求添加，如圆角矩形元素可以用于表示特定的步骤或状态。 圆角正方形 圆角正方形元素，在创建数据图层时根据需求添加，如圆角正方形元素可以用于表示特定的步骤或状态，其圆角设计有助于视觉上区分不同的流程节点。 泳道（下） 流程泳道图是一种展示业务流程或工作流程的图表，通过使用不同的泳道来表示不同的业务部门或参与者，以及它们之间的交互和流程。使用泳道元素可以帮助区分流程中的不同参与者或部门，使流程图更加清晰和易于理解。 系统分别预置了上、下、左、右泳道来满足不同的业务需求。 泳道 泳道（上） 泳道（右） 三角形 三角形元素，在创建数据图层报表时根据需求添加，如三角形元素可以用于表示特定的操作或事件，如输入/输出、文档、数据存储等。 矩形 矩形元素，在创建数据图层报表时根据需求添加，如矩形元素可以用于表示流程中的处理步骤或操作。 圆柱 圆柱元素，在创建数据图层报表时根据需求添加，如圆柱元素可以用于表示数据库或数据存储等。 批注 批注元素，在创建数据图层报表时添加内容批注。 文本 文本元素，在创建数据图层报表时添加文本内容。 椭圆形 椭圆形元素，在创建数据图层报表时根据需求添加，如椭圆形元素可以用于表示开始或结束节点。 导航 导航元素，在创建数据图层报表时根据需求添加，如使用导航元素可以帮助用户更好地理解和跟随流程的进展。 正六边形 正六边形元素，在创建数据图层报表时根据需求添加，如使用箭头或连接线将正六边形连接到其他元素，表示不同路径和条件。 平行四边形 平行四边形元素，在创建数据图层报表时根据需求添加，如平行四边形可以用于表示流程中的输入或输出，如数据的输入、文件的读取等。在平行四边形内部描述输入或输出的内容。 圆形 圆形元素，在创建数据图层报表时根据需求添加，如圆形元素可用于表示特定的起点或终点，有时也用于表示重要的事件或节点。 梯形 梯形元素，在创建数据图层报表时根据需求添加，如梯形可用于表示一个预定义的过程，这个过程通常在图层外部有详细的描述，在梯形内部可以标注过程的名称。 旗帜 旗帜元素，旗帜元素通常用于表示特定的注释或标记，来突出显示重要信息或特殊步骤。 EA/Business 价值流阶段 价值流阶段元素，在展示价值流中一个明显、可识别的阶段或步骤时使用。 使用价值流阶段元素，可以绑定在架构管理中创建的价值流阶段。 业务流 业务流元素，在创建组织架构图层报表时，业务流元素可在描绘组织内不同部门和角色之间的业务交互和流程时可使用。 业务能力 业务能力元素，在创建组织架构图层报表时，业务能力元素可在描绘组织的核心能力以及这些能力如何支持业务目标和战略时使用。 使用业务能力元素，可以绑定在架构管理中创建的业务能力。 价值流 价值流元素，价值流是一组端到端的活动集合，能够为用户创造一个有价值的结果。 使用价值流元素，可以绑定在架构管理中创建的价值流。 组织 组织元素。使用组织元素可以标注流程中的某个步骤需要执行的组织。 使用价值流元素，可以绑定在领域管理中创建的组织。 业务节点 业务节点元素，在创建组织架构图层报表时，业务节点元素可以用于描绘组织内不同业务单元、流程和功能的具体节点。 流程 流程元素，可以理解为代表流程里的活动（L5）。 图标 企业 企业元素，在创建组织架构图层报表时，用于标注企业，可以根据需求修改元素名称。 消费者 消费者元素，可以定义消费者在流程中的角色，如潜在客户、购买者、用户等。明确角色有助于理解消费者在流程中的具体行为和需求。 运营商 运营商元素，可以定义运营商在流程中的角色，如客服代表、技术支持、物流人员等。明确角色有助于了解运营商在流程中的具体职责和任务。 EA/Strategy 举措和关键任务 举措和关键任务元素用于表示流程中的重要行动和任务，有助于确保流程的顺利执行和目标达成。 EA/Application 业务平台 业务平台元素，根据报表的目的，展示涉及的业务平台。 使用业务平台元素，可以绑定架构管理中创建的业务平台。 应用 应用元素，应用是IT系统的统称，包括文件应用、业务系统应用、企业应用、 数据仓库 应用等。 使用应用元素，可以绑定架构管理中创建的应用。 EA/Data 主题域 主题域元素，位于信息架构元模型的第二层，主题域元素用于将报表内容按照不同的主题进行分类和组织。主题域可以理解为报表中的主要章节或部分，每个主题域包含与特定主题相关的数据、图表和分析。 使用主题域元素，可以绑定架构管理中创建的主题域。 数据集 数据集元素，数据集代表了数据的集合，通常指数据库中的表/视图等。 使用数据集元素，可以绑定在数据管理中采集到的数据集。 业务对象 业务对象元素，业务对象位于信息架构元模型的第三层，是业务领域重要的人、事、物，承载了业务运作和管理涉及的重要信息。 在创建图层报表时，业务对象元素用于表示业务流程中的关键实体或概念。业务对象可以是具体的物理对象（如产品、订单）、抽象的概念（如客户关系、市场策略）或数据实体（如数据库中的表、记录）。业务对象元素有助于明确报表中的数据来源和分析对象，从而提高报表的清晰度和实用性。 使用业务对象元素，可以绑定架构管理中创建的业务对象。 主题域分组 主题域分组元素，主题域分组可以理解为位于信息架构元模型的第一层，是公司顶层信息分类，通过数据视角体现公司最高层关注的业务领域。例如，在一个业务报告中，将财务数据、市场数据和运营数据分别归入不同的主题域。 使用主题域分组元素，可以绑定架构管理中创建的主题域分组。 逻辑数据实体 逻辑数据实体元素，逻辑数据实体位于信息架构元模型的第四层，是具有一定逻辑关系的数据属性的集合。在创建图层报表时，逻辑数据实体元素用于表示报表中涉及的数据结构和数据关系。 使用逻辑数据实体元素，可以绑定架构管理中创建的逻辑数据实体。 父主题： 管理数据图层

计费说明 DMAP数小二实例的计费项规格分为： 试用版：适用于中小型企业场景，用于企业数字资产统一管理，只面向企业用户，提供试用30天的功能。最大用户数为5。 基础共享版：适用于中小型企业场景，用于企业数字资产统一管理，只面向企业用户。最大用户数为50。 专业共享版：适用于中大型场景，用于数据资产目录统一管理、企业架构管理，为逻辑多组，独享版。最大用户数为200。 计费项 计费项说明 适用的计费模式 计费公式 DMAP数小二实例规格 （仅适用于试用版） 计费因子：规格。 包年/包月 免费 DMAP数小二实例规格 计费因子：规格。 包年/包月 DMAP数小二实例规格单价 * 购买时长

DMAP数小二 DMAP数小二是承载《华为数字化转型之道》、《华为数据之道》理论精华，从业务、数据、应用、技术视角对企业核心信息进行运营和管理的平台，是对企业数字化世界的描述，也是企业数字化资产的入口，致力于帮助政企组织开展企业数字化资产的正向循环和全生命周期运营，最终通过平台预制数字化模板和自助构建模式，助力企业在数字化时代实现高效运营、加速转型。 产品架构 DMAP数小二产品架构如图2所示。 图2 产品架构 产品模块说明： 架构管理 面向架构师提供4A架构资产管理、架构集成管理以及架构报告开发能力等；面向普通用户提供架构资产查看的功能。 流程管理 面向流程设计人员提供流程生命周期管理能力；面向普通用户提供流程资产查看功能。 数据管理 面向数据管家提供数据资产、文件资产等多模态资产管理、数据图层开发等能力；面向普通用户提供数据资产查看、权限申请等功能。 工作流引擎 提供审批工作流的编排能力，支持用户自定义审批流。 元数据编排 提供基于元模型的数字化报告开发、自由画布编排等能力，支持元数据敏捷消费。 元数据开放与集成 通过API、文件等方式支持元数据集成与被集成。 元模型驱动 提供EA元模型、广泛的元数据连接器实现元数据采集，以及海量元数据存储、搜索等核心能力。 资产运营 提供架构、流程、数据等资产的运营，发挥资产价值和提升资产质量。 系统配置 提供用户、角色等基本的系统配置。 用户中心 提供用户待办、消息、申请等与个人相关的工作空间。 实例管理 提供配置审计日志留存时间的能力。

模板应用记录 在模板应用记录模块，可以查看以下内容： 模板应用到了哪些 域名 ：在模板应用记录的“操作”列单击“查看域名”，即可查看当前操作应用到了哪些域名以及应用是否成功。 模板应用是否成功：在模板应用记录的“状态”列，即可查看当前操作在多少个域名上配置成功、失败或配置中。 查看当前模板配置：在模板应用记录的“操作”列单击“模板快照”，即可查看执行当前操作时，该模板包含哪些配置项。 图2 模板应用记录

常见问题 如果kubectl没有配置成功，helm install时会出现如下报错。 # helm install prometheus/ --generate-name WARNING: This chart is deprecated Error: Kubernetes cluster unreachable: Get "http://localhost:8080/version? timeout=32s": dial tcp [::1]:8080: connect: connection refused 解决办法：给节点配置kubeconfig，配置方法请参见使用kubectl连接集群。 同一个集群下需要安装不同的Agent版本，需要怎么处理？ 解决办法：通过labels中的apmJavaAgentVersion指定版本实现。

前提条件 确保接入的节点与 APM 服务网络连通。可使用“curl -kv”命令测试目标机器与APM服务器网络是否连通。 例如，以检查华北-北京四区域，且代码源选择“增强型探针”的连通性为例，请登录应用所部署的机器，并输入命令curl -kv 100.125.12.108:41333，其他区域地址请参考表1。 表1 增强型探针接入地址 区域 接入地址 华北-北京四 https://100.125.12.108:41333 华北-北京一 https://100.125.57.101:41333 华东-上海一 https://100.125.4.27:41333 华东-上海二 https://100.125.140.105:41333 华南-广州 https://100.125.143.102:41333 亚太-新加坡 https://100.125.4.25:41333 华南-广州-友好用户环境 https://100.125.4.30:41333 华北-乌兰察布一 https://100.125.4.30:41333 华北-乌兰察布汽车一 https://100.125.254.17:41333 西南-贵阳一 https://100.125.0.90:41333 中国-香港 https://100.125.6.106:41333 请确保您的Kubernetes集群版本为1.19及以上。 进程所需最大堆内存250 MB，最大CPU使用0.25 Core。

操作步骤 编辑deployment.yaml。 在volumes中增加一个emptyDir。 volumes: - name: paas-apm2 emptyDir: {} 在containers.volumeMounts中增加moutPath。 volumeMounts: - name: paas-apm2 mountPath: /paas-apm2/javaagent/ 在env中增加JAVA_TOOL_OPTIONS环境变量。 env: - name: JAVA_TOOL_OPTIONS value: '-javaagent:/paas-apm2/javaagent/apm-javaagent/apm-javaagent.jar' 新增initContainers。 initContainers: - name: init-javaagent image: {swrAddress}/op_svc_apm/javaagent:{agentVersion} command: - /bin/sh - '-c' - cd /paas-apm2/javaagent/apm-javaagent; /bin/sh init-config.sh -master_address {masterAddress} -app_name {appName} -access_key {accessKey} -access_value {secretKey} -business {business} -env {env} resources: limits: cpu: 250m memory: 250Mi requests: cpu: 250m memory: 250Mi volumeMounts: - name: paas-apm2 mountPath: /var/init/javaagent terminationMessagePath: /dev/termination-log terminationMessagePolicy: File imagePullPolicy: Always monitorGroup: default

配置示例 spec: replicas: 1 selector: matchLabels: app: vmall-admin version: v1 template: metadata: creationTimestamp: null labels: app: vmall-admin version: v1 spec: volumes: - name: vol-171526714525730640 hostPath: path: /vmall/vmall-deploy/vmall-data/app/vmall-admin/logs type: '' - name: paas-apm2 emptyDir: {} initContainers: - name: init-javaagent image: swr.cn-north-4.myhuaweicloud.com/op_svc_apm/javaagent:2.4.8-x86_64 command: - /bin/sh - '-c' - cd /paas-apm2/javaagent/apm-javaagent; /bin/sh init-config.sh -master_address https://100.125.12.108:41333 -app_name vmall-admin -access_key {AK} -access_value {SK} -business vmall-demo resources: limits: cpu: 250m memory: 250Mi requests: cpu: 250m memory: 250Mi volumeMounts: - name: paas-apm2 mountPath: /var/init/javaagent terminationMessagePath: /dev/termination-log terminationMessagePolicy: File imagePullPolicy: Always monitorGroup: default containers: - name: vmall-admin image: swr.cn-north-4.myhuaweicloud.com/vmall-org/vmall-admin:1.0.0 env: - name: PAAS_APP_NAME value: vmall-admin - name: PAAS_NAMESPACE value: default - name: PAAS_PROJECT_ID value: e49731583bc54978aa7b4da1a2196e46 - name: CLOUDDEPLOY_SYS_INCREMENT value: '1719279081896' - name: JAVA_TOOL_OPTIONS value: '-javaagent:/paas-apm2/javaagent/apm-javaagent/apm-javaagent.jar' resources: limits: cpu: '1' memory: 2Gi requests: cpu: 500m memory: 1Gi volumeMounts: - name: vol-171526714525730640 mountPath: /var/logs - name: paas-apm2 mountPath: /paas-apm2/javaagent/ terminationMessagePath: /dev/termination-log terminationMessagePolicy: File imagePullPolicy: Always restartPolicy: Always terminationGracePeriodSeconds: 30 dnsPolicy: ClusterFirst securityContext: {} imagePullSecrets: - name: default-secret schedulerName: default-scheduler tolerations: - key: node.kubernetes.io/not-ready operator: Exists effect: NoExecute tolerationSeconds: 300 - key: node.kubernetes.io/unreachable operator: Exists effect: NoExecute tolerationSeconds: 300

请求示例 “endpoint”即调用API的请求地址，不同服务不同区域的“endpoint”不同，具体请参见终端节点。 上传短音频，快速返回识别结果 POST https://{endpoint}/v1/{project_id}/asr/short-audio Request Header: Content-Type: application/json X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG... Request body: { "config": { "audio_format": "wav", "property": "chinese_16k_general", "add_punc": "yes", "need_word_info": "yes" }, "data": "/+MgxAAUeHpMAUkQAANhuRAC..." } 使用Python3语言上传短音频，快速返回识别结果 # -*- coding: utf-8 -*- # 此demo仅供测试使用，强烈建议使用sdk。需提前安装requests，执行pip install requests import requests import base64 import json def sasr_demo(): url = 'https://{{endpoint}}/v1/{{project_id}}/asr/short-audio' # endpoint和project_id需替换 token = '用户对应region的token' file_path = '将要识别音频的路径' with open(file_path, 'rb') as f: data = f.read() base64_data = str(base64.b64encode(data), 'utf-8') header = { 'Content-Type': 'application/json', 'X-Auth-Token': token } body = { 'data': base64_data, 'config': { 'property': 'chinese_16k_general', 'audio_format': 'pcm16k16bit' } } resp = requests.post(url, data=json.dumps(body), headers=header) print(resp.text) if __name__ == '__main__': sasr_demo() 使用Java语言上传短音频，快速返回识别结果 import java.io.BufferedReader; import java.io.InputStream; import java.io.InputStreamReader; import java.io.OutputStreamWriter; import java.net.HttpURLConnection; import java.net.URL; /** * 此demo仅供测试使用，强烈建议使用SDK */ public class SasrDemo { public void sasrDemo() { try { // endpoint和projectId需要替换成实际信息。 URL url = new URL("https://{{endpoint}}/v1/{{project_id}}/asr/short-audio"); String token = "对应region的token"; String audioBody = "8k wav格式audio对应base64编码"; HttpURLConnection connection = (HttpURLConnection)url.openConnection(); connection.setRequestMethod("POST"); connection.setDoInput(true); connection.setDoOutput(true); connection.addRequestProperty("Content-Type", "application/json"); connection.addRequestProperty("X-Auth-Token", token); OutputStreamWriter osw = new OutputStreamWriter(connection.getOutputStream(), "UTF-8"); String body = "{\"data\":\"" + audioBody + "\", \"config\": { \"audio_format\": \"wav\", " + "\"property\":\"chinese_16k_general\"}}"; osw.append(body); osw.flush(); InputStream is = connection.getInputStream(); BufferedReader br = new BufferedReader(new InputStreamReader(is, "UTF-8")); while (br.ready()) { System.out.println(br.readLine()); } } catch (Exception e) { e.printStackTrace(); } } public static void main(String[] args) { SasrDemo sasrDemo = new SasrDemo(); sasrDemo.sasrDemo(); } }

响应示例 状态码：200 成功响应示例 { "trace_id": "567e8537-a89c-13c3-a882-826321939651", "result":{ "text": "欢迎使用语音云服务。", "score": 0.9, "word_info": [ { "start_time": 150, "end_time": 570, "word": "欢迎" }, { "start_time": 570, "end_time": 990, "word": "使用" }, { "start_time": 990, "end_time": 1380, "word": "语音" }, { "start_time": 1380, "end_time": 1590, "word": "云" }, { "start_time": 1590, "end_time": 2070, "word": "服务" } ] } } 状态码：400 失败响应示例 { "error_code":"SIS.0001", "error_msg":"***" }

响应参数 状态码： 200 表7 响应Body参数 参数 是否必选 参数类型 描述 trace_id 是 String 服务内部的令牌，可用于在日志中追溯具体流程，调用失败无此字段。 在某些错误情况下可能没有此令牌字符串。 result 是 Result object 调用成功表示识别结果，调用失败时无此字段。 表8 Result 参数 是否必选 参数类型 描述 text 是 String 调用成功表示识别出的内容。 score 是 Float 调用成功表示识别出的置信度，取值范围：0~1。 word_info 否 Array of WordInfo objects 分词信息列表。 分词是指将识别出的文本进一步拆分成单独的词语。 表9 WordInfo 参数 是否必选 参数类型 描述 start_time 否 Integer 起始时间。 end_time 否 Integer 结束时间。 word 否 String 分词。 状态码： 400 表10 响应Body参数 参数 参数类型 描述 error_code String 调用失败时的错误码。 调用成功时无此字段。 error_msg String 调用失败时的错误信息。 调用成功时无此字段。

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 用于获取操作API的权限。获取方法请参见认证鉴权。响应消息头中X-Subject-Token的值即为Token。 Enterprise-Project-Id 否 String 企业项目ID。SIS支持通过企业项目管理（EPS）对不同用户组和用户的资源使用，进行分账。 获取方法：进入“企业项目管理”页面，单击企业项目名称，在企业项目详情页获取Enterprise-Project-Id（企业项目ID）。 企业项目创建步骤请参见用户指南。 说明： 账户创建企业项目后，在传参时，有以下三类场景。 携带正确的ID，正常使用SIS服务，账单归到企业ID对应的企业项目中。 携带错误的ID，正常使用SIS服务，账单的企业项目会被分类为“default”。 不携带ID，正常使用SIS服务，账单的企业项目会被分类为“default”。 表3 请求Body参数 参数 是否必选 参数类型 描述 config 是 Config object 配置信息。 data 是 String 语音数据，Base64编码，要求Base64编码后大小不超过4M，音频时长不超过1分钟。Base64编码示例如/+MgxAAUeHpMAUkQAANhuRAC...，如果携带data:audio/mp3;base64,类前缀，会产生报错。 表4 Config 参数 是否必选 参数类型 描述 audio_format 是 String 支持语音的格式，请参考表 audio_format取值范围。 property 是 String 所使用的模型特征串，通常是 “语种_采样率_领域”的形式，采样率需要与音频采样率保持一致，取值范围请参考表 property取值范围。 add_punc 否 String 表示是否在识别结果中添加标点，取值为“yes”和“no”，默认为“no”。 digit_norm 否 String 表示是否将语音中的数字识别为阿拉伯数字，取值为“yes” 和 “no”，默认为“yes”。 vocabulary_id 否 String 热词表id，不使用则不填写。创建热词表信息请参考创建热词表。 need_word_info 否 String 表示是否在识别结果中输出分词结果信息，取值为“yes”和“no”，默认为“no”。 表5 audio_format取值范围 audio_format取值 描述 pcm16k16bit 16k16bit单通道录音数据。 pcm8k16bit 8k16bit单通道录音数据。 ulaw16k8bit 16k8bit ulaw单通道录音数据。 ulaw8k8bit 8k8bit ulaw单通道录音数据。 alaw16k8bit 16k8bit alaw单通道录音数据。 alaw8k8bit 8k8bit alaw单通道录音数据。 mp3 mp3格式音频。目前仅支持单通道的音频。 aac aac格式音频。目前仅支持单通道的音频。 wav 带wav封装头的格式，从封装头中自动确定格式，目前仅支持8k/16k采样率、单通道、pcm, alaw, ulaw三种编码格式。 amr AMR窄带(8k) 压缩录音数据。目前仅支持单通道的音频。 amrwb AMR 宽带(16k) 压缩录音数据。目前仅支持单通道的音频。 auto 由引擎自动判断音频数据的格式并解码，支持自动判断amr，flac，m4a，mp3，ogg，webm，wav，aac，ac3，mov，wma、amrwb格式。 表6 property取值范围 property取值 描述 chinese_16k_general 支持采样率为8k/16k的中文普通话 语音识别 ，采用新一代端到端识别算法，识别准确率更高。 区域支持cn-east-3和cn-north-4。 chinese_16k_travel 支持采样率为16k的中文普通话语音识别，采用新一代端到端识别算法，并针对网约车质检场景进行了优化。 区域支持cn-east-3和cn-north-4。 sichuan_16k_common 支持采样率为8k/16k的四川话方言识别。区域仅支持cn-north-4。 cantonese_16k_common 支持采样率为8k/16k的粤语方言识别。区域仅支持cn-north-4。 shanghai_16k_common 支持采样率为8k/16k的上海话方言识别，区域仅支持cn-north-4。 arabic_16k_general 支持采样率为16k的阿拉伯语语音识别，支持标准阿拉伯语，埃及方言，沙特方言。暂不支持dd_punc, digit_norm，vocabulary_id参数 chinese_8k_common 支持采样率为8k的中文普通话语音识别，此为旧版模型，后期不再维护，建议使用chinese_16k_general。 chinese_16k_common 支持采样率为16k的中文普通话语音识别，此为旧版模型，后期不再维护，建议使用chinese_16k_general。 english_16k_common 支持采样率为8k/16k的英文语音识别，区域仅支持cn-east-3。暂不支持digit_norm参数。 english_8k_common 支持采样率为8k的英文语音识别，此为旧版模型，后期不再维护，建议使用english_16k_common。。

功能介绍 单句模式自动检测一句话的结束，因此适合于需要与您的系统进行交互的场景，例如外呼、控制口令等场景。 实时语音识别 引擎的单句识别模式，和连续识别模式类似，也会进行语音的端点检测，如果检测到静音，将直接丢弃，检测到语音才会馈入核心进行实际的解码工作，如果检测到一段语音的结束点，就会将当前这一段的识别结果返回。和连续识别不同的是，在单句模式下，返回第一段的识别结果后，将不再继续识别后续的音频。这主要是用于和用户进行 语音交互 的场景下，当用户说完一句话后，往往会等待后续的交互操作，例如聆听根据识别结果播报的相关内容，因而没有必要继续识别后续的音频。