华为云用户手册

操作场景 本文以云服务器的操作系统为“Windows Server 2008 R2 Standard 64bit”、磁盘容量为3 TiB举例，提供容量大于2 TiB的Windows数据盘的初始化操作指导。 MBR格式分区支持的磁盘最大容量为2 TiB，GPT分区表最大支持的磁盘容量为18 EiB，因此当为容量大于2 TiB的磁盘分区时，请采用GPT分区方式。具体操作请参见初始化容量大于2TiB的Windows数据盘（Windows 2008）。关于磁盘分区形式的更多介绍，请参见初始化数据盘场景及磁盘分区形式介绍。

手动执行脚本初始化Windows数据盘 登录云服务器，访问https://ecs-instance-driver.obs.cn-north-1.myhuaweicloud.com/datadisk/WinVMDataDiskAutoInitialize.ps1获取自动初始化磁盘脚本，并将其保存在C:\Windows\System32路径下。 在云服务器桌面，单击“开始”，选中“Windows PowerShell”后右键单击“以管理员身份运行”。 图1 以管理员身份运行Windows PowerShell 在对话框中输入以下命令，设置脚本执行策略。 Set-ExecutionPolicy -ExecutionPolicy Bypass -Force 在对话框中输入以下命令，执行自动化脚本。 C:\Windows\System32\WinVMDataDiskAutoInitialize.ps1 回显类似如下信息： 如果回显PowerShell无法加载文件，原因是通过网络下载的PowerShell脚本在未签名的情况下，Windows系统策略会禁止执行。 您可以通过以下方法解决：首先执行命令set-ExecutionPolicy RemoteSigned，然后重启PowerShell即可。 （可选）在“磁盘管理”页面，可以查看初始化结果。 图2 磁盘管理

修订记录 发布日期 修订记录 2022-7-30 第四次正式发布。 本次变更说明如下： 优化描述。 2018-09-26 第三次正式发布。 本次变更说明如下： 根据界面变更，修改“购买云硬盘”参数列表。 2018-06-30 第二次正式发布。 本次变更说明如下： 增加“初始化容量大于2TiB的Windows数据盘（Windows 2008）”章节。 增加“初始化容量大于2TiB的Windows数据盘（Windows 2012）”章节。 增加“初始化容量大于2TiB的Linux数据盘（parted）”章节。 2018-06-15 第一次正式发布。

操作场景 本文以云服务器的操作系统为“Windows Server 2008 R2 Enterprise 64bit”为例，提供磁盘的初始化操作指导。 MBR格式分区支持的磁盘最大容量为2 TiB，GPT分区表最大支持的磁盘容量为18 EiB，因此当为容量大于2 TiB的磁盘分区时，请采用GPT分区方式。具体操作请参见初始化容量大于2TiB的Windows数据盘（Windows 2008）。关于磁盘分区形式的更多介绍，请参见初始化数据盘场景及磁盘分区形式介绍。 不同云服务器的操作系统的格式化操作可能不同，本文仅供参考，具体操作步骤和差异请参考对应的云服务器操作系统的产品文档。 首次使用磁盘时，如果您未参考本章节对磁盘执行初始化操作，主要包括创建分区和文件系统等操作，那么当后续扩容磁盘时，新增容量部分的磁盘可能无法正常使用。

操作场景 单独新购买的云硬盘为数据盘，可以在云硬盘列表中看到磁盘属性为“数据盘”，磁盘状态为“可用”。此时需要将该数据盘挂载给云服务器使用。 系统盘必须随弹性云服务器一同购买创建，并且会自动挂载，可以在云硬盘列表中看到磁盘属性为“系统盘”，磁盘状态为“正在使用”。当系统盘从弹性云服务器上卸载后，此时系统盘的磁盘属性变为“启动盘”，磁盘状态变为“可用”。 卸载后的系统盘即为启动盘，根据您选择的挂载点不同，启动盘可以重新挂载给云服务器用作系统盘或者数据盘。具体请参见挂载已有数据的系统盘。 本章节指导用户挂载非共享云硬盘，非共享云硬盘只可以挂载至1台云服务器。

计费示例 示例一：云硬盘采用包年/包月计费模式 客户在购买通用型SSD V2云硬盘时，容量选择100GiB，预配置性能为5000 IOPS、325MiBps吞吐量。 假设包年/包月容量价钱为0.5元/GiB/月，按需IOPS单价为0.0000153元/IOPS/小时，按需吞吐量单价为0.00194元/MiBps/小时。 购买1个月（30天）的总费用为：容量费用+IOPS费用+吞吐量费用=100*0.5*1+(5000-3000)*0.0000153*24*30+(325-125)*0.00194*24*30=50+22.032+279.36=351.392元 容量费用=包年/包月容量费用 IOPS费用=（预配置IOPS-基准IOPS)*IOPS单价*时长 吞吐量费用=（预配置吞吐量-基准吞吐量)*吞吐单价*时长 示例二：云硬盘采用按需计费模式 客户在购买通用型SSD V2云硬盘时，容量选择100GiB，预配置性能为5000 IOPS、325MiBps吞吐量。 假设按需容量价钱为0.000695元/GiB/小时，按需IOPS单价为0.0000153元/IOPS/小时，按需吞吐量单价为0.00194元/MiBps/小时。 购买24小时的总费用为：容量费用+IOPS费用+吞吐量费用=100*0.000695*24+(5000-3000)*0.0000153*24+(325-125)*0.00194*24=1.668+0.7344+9.312=11.7344元 容量费用=容量*容量单价*时长 IOPS费用=（预配置IOPS-基准IOPS)*IOPS单价*时长 吞吐量费用=（预配置吞吐量-基准吞吐量)*吞吐单价*时长

云硬盘性能 表1 通用型SSD V2性能数据表 参数 通用型SSD V2 云硬盘最大容量 系统盘：1024 GiB 数据盘：32768 GiB 描述 用于均衡各种事务型工作负载的价格和性能的通用SSD云硬盘 。 典型应用场景 各种主流的高性能、低延迟交互应用场景。 企业办公、虚拟桌面 大型开发测试 转码类业务 系统盘 大中型规模的数据库（SQL Server 、 Oracle 、NoSQL、PostgreSQL） 最大IOPS 128000 最大吞吐量 1000 MiB/s IOPS突发上限 NA 云硬盘IOPS性能计算公式 IOPS值由用户预配置，范围为3000~128000，具体可配置值≤(500*容量) 云硬盘吞吐量性能计算公式 吞吐量值由用户配置，范围为125~1000MiB/s，具体可配置值≤(IOPS/4) 单队列访问时延 1 ms API名称 GPSSD2

什么是磁盘模式 根据是否支持高级的S CS I命令来划分磁盘模式，分为VBD(虚拟块存储设备 , Virtual Block Device)类型和SCSI (小型计算机系统接口, Small Computer System Interface) 类型。 VBD类型：磁盘模式默认为VBD类型。VBD类型的磁盘只支持简单的SCSI读写命令。 SCSI类型：SCSI类型的磁盘支持SCSI指令透传，允许云服务器操作系统直接访问底层存储介质。除了简单的SCSI读写命令，SCSI类型的磁盘还可以支持更高级的SCSI命令。 磁盘模式在购买磁盘时配置，购买完成后无法修改。

SCSI磁盘的常见使用场景和建议 SCSI磁盘：BMS仅支持使用SCSI磁盘，用作系统盘和数据盘。 SCSI共享盘：当您使用共享盘时，需要结合分布式文件系统或者集群软件使用。由于多数常见集群需要使用SCSI锁，例如Windows MSCS集群、Veritas VCS集群和CFS集群，因此建议您结合SCSI使用共享盘。 如果将SCSI共享盘挂载至ECS时，需要结合云服务器组的反亲和性一同使用，SCSI锁才会生效，关于更多共享盘的内容，请参见共享云硬盘及使用方法。

故障恢复 EVS提供多种云硬盘故障后数据恢复方式，详情见表1。 表1 故障恢复 故障恢复 描述 详细介绍 云硬盘备份 您可以通过云备份（Cloud Backup and Recovery，CBR）中的云硬盘备份功能为云硬盘创建在线备份，无需关闭云服务器。针对病毒入侵、人为误删除、软硬件故障等导致数据丢失或者损坏的场景，可通过任意时刻的备份恢复数据，以保证用户数据正确性和安全性，确保您的数据安全 使用云硬盘备份恢复数据 恢复回收站中的云硬盘 回收站功能开启后，删除的云硬盘会放入到回收站中保存，以防止误删除导致云硬盘数据丢失。 云硬盘在回收站内最多可保存7天，在到期之前，您可以从回收站内恢复已删除的云硬盘。 恢复回收站中的云硬盘 从快照创建云硬盘 通过快照创建新的云硬盘，可以使云硬盘在初始状态就具有快照中的数据。 从快照创建云硬盘 从快照回滚数据 如果云硬盘的数据发生错误或者损坏，可以回滚快照数据至创建该快照的云硬盘，从而恢复数据。 从快照回滚数据 父主题： 安全

与其他服务的关系 云硬盘与其他服务之间的关系，具体如图1所示。 图1 云硬盘与其他服务的关系示意图 表1 与其他服务的关系 交互功能 相关服务 位置 云硬盘可以挂载至弹性云服务器，提供可弹性扩展的块存储设备。 弹性云服务器（ECS, Elastic Cloud Server） 挂载非共享云硬盘 挂载共享云硬盘 SCSI类型的云硬盘可以挂载至裸金属服务器，提供可弹性扩展的块存储设备。 裸金属服务器（BMS, Bare Metal Server） 通过云备份服务可以备份云硬盘中的数据，保证云服务器数据的可靠性和安全性。 云备份（Cloud Backup and Recovery，CBR） 云硬盘备份 管理备份云硬盘 云硬盘的加密功能依赖于 数据加密 服务中的密钥管理功能（KMS）。您可以使用密钥管理功能提供的密钥来加密云硬盘，包括系统盘和数据盘，从而提升云硬盘中数据的安全性。 数据加密服务（DEW，Data Encryption Workshop） 云硬盘加密 管理加密云硬盘 当用户开通云硬盘服务后，无需额外安装其他插件，即可通过 云监控 查看云硬盘的性能指标，包括云硬盘读速率、云硬盘写速率、云硬盘读操作速率以及云硬盘写操作速率。 云监控（Cloud Eye） 查看云硬盘监控数据 云硬盘服务支持通过 云审计 服务对云硬盘资源的操作进行记录，以便用户可以查询、审计和回溯。 云审计服务（ CTS , Cloud Trace Service） 查看云硬盘追踪事件 标签用于标识云资源，可通过标签实现对云硬盘资源的分类和搜索。 标签管理服务（TMS，Tag Management Service） 添加标签

什么是区域、可用区？ 区域和可用区用来描述数据中心的位置，您可以在特定的区域、可用区创建资源。 区域（Region）：从地理位置和网络时延维度划分，同一个Region内共享弹性计算、块存储、对象存储、VPC网络、弹性公网IP、镜像等公共服务。Region分为通用Region和专属Region，通用Region指面向公共租户提供通用云服务的Region；专属Region指只承载同一类业务或只面向特定租户提供业务服务的专用Region。 可用区（AZ，Availability Zone）：一个AZ是一个或多个物理数据中心的集合，有独立的风火水电，AZ内逻辑上再将计算、网络、存储等资源划分成多个集群。一个Region中的多个AZ间通过高速光纤相连，以满足用户跨AZ构建高可用性系统的需求。 图1阐明了区域和可用区之间的关系。 图1 区域和可用区 目前，华为云已在全球多个地域开放云服务，您可以根据需求选择适合自己的区域和可用区。更多信息请参见华为云全球站点。

如何选择区域？ 选择区域时，您需要考虑以下几个因素： 地理位置 一般情况下，建议就近选择靠近您或者您的目标用户的区域，这样可以减少网络时延，提高访问速度。 在除中国大陆以外的亚太地区有业务的用户，可以选择“中国-香港”、“亚太-曼谷”或“亚太-新加坡”区域。 在非洲地区有业务的用户，可以选择“非洲-约翰内斯堡”区域。 在拉丁美洲地区有业务的用户，可以选择“拉美-圣地亚哥”区域。 “拉美-圣地亚哥”区域位于智利。 资源的价格 不同区域的资源价格可能有差异，请参见华为云服务价格详情。

审计 云审计服务（Cloud Trace Service，CTS），是华为 云安全 解决方案中专业的日志审计服务，提供对各种云资源操作记录的收集、存储和查询功能，可用于支撑安全分析、合规审计、资源跟踪和问题定位等常见应用场景。用户开通云审计服务并创建和配置追踪器后，CTS可记录EVS的管理事件用于审计。 CTS的详细介绍和开通配置方法，请参见CTS快速入门。 CTS支持追踪的EVS管理事件，请参见审计。 父主题： 安全

数据保护技术 EVS通过云硬盘加密技术，保护存储在EVS云硬盘中的静态数据的机密性。 表1 EVS的数据保护手段和特性 数据保护手段 简要说明 详细介绍 云硬盘加密 1、支持创建空白加密云硬盘 2、支持通过快照、备份、镜像创建加密云硬盘 3、支持默认使用AES-256服务端加密静态数据； 4、支持使用KMS密钥加密静态数据； 5、支持 EVS数据盘和ECS系统盘加密； 6、从加密云硬盘创建的快照、备份、镜像默认加密。 云硬盘加密 父主题： 安全

云硬盘基本概念 表1 云硬盘基本概念 概念 说明 保留期 资源到期前，未续费或账户余额低于0，则到期后资源会进入保留期。保留期内资源会被冻结，业务中断。 IOPS 云硬盘每秒进行读写的操作次数。 吞吐量 云硬盘每秒成功传送的数据量，即读取和写入的数据量。 IO读写时延 云硬盘连续两次进行读写操作所需要的最小时间间隔。 突发能力 小容量云硬盘可以在一定时间内达到IOPS突发上限，超过IOPS上限的能力。 VBD 磁盘模式，VBD类型的云硬盘只支持简单的SCSI读写命令。 SCSI 磁盘模式，SCSI类型的云硬盘支持SCSI指令透传，允许云服务器操作系统直接访问底层存储介质。 父主题： 基本概念

云硬盘备份与快照的区别 云硬盘备份以及快照为存储在云硬盘中的数据提供冗余备份，确保高可靠性，两者的主要区别如表1所示。 表1 备份和快照的区别 指标 存储方案 数据同步 容灾范围 业务恢复 备份 与云硬盘数据分开存储，存储在对象存储（OBS）中，可以实现在云硬盘存储损坏情况下的数据恢复。 保存云硬盘指定时刻的数据，可以设置自动备份。如果将创建备份的云硬盘删除，那么对应的备份不会被同时删除。 与云硬盘位于不同AZ内 通过恢复备份至云硬盘，或者通过备份创建新的云硬盘，找回数据，恢复业务。数据持久性高。 快照 与云硬盘数据存储在一起 说明： 备份由于数据搬迁会耗费一定的时间，创建快照和回滚快照数据的速度比备份快。 保存云硬盘指定时刻的数据。如果将创建快照的云硬盘删除，那么对应的快照也会被同时删除。重装操作系统或切换操作系统后，系统盘快照会自动删除；数据盘快照不受影响，可以照常使用。 与云硬盘位于同一个AZ内 通过回滚快照至云硬盘，或者通过快照创建新的云硬盘，找回数据，恢复业务。

云硬盘加密的使用场景 对于一个租户而言，区域以及项目下的用户关系示意图如图1所示。以区域B为例，根据首次使用加密功能的用户是否拥有“Security Administrator”权限分为以下两个场景： 图1 用户关系示意图 如果安全管理员首次使用加密功能，则操作流程如下： 授权EVS访问KMS。 授权成功后，系统会为您创建默认主密钥“evs/default”，此密钥用来加密云硬盘。 云硬盘的加密依赖KMS，首次使用加密功能时，需要授权EVS访问KMS。当授权成功后，用户组中的所有用户使用加密功能均无需再次进行授权操作。 选择密钥。 您可以选择使用的密钥如下： 默认主密钥“evs/default”。 用户主密钥，即您在使用云硬盘加密功能前已经创建的密钥，或者新创建密钥，创建方法请参见创建密钥。 安全管理员成功使用加密功能后，则区域B中的所有用户都可以直接使用加密功能。 如果是用户E（普通用户）首次使用加密功能，则操作流程如下： 用户E使用加密功能，系统提示权限不足，无法授权EVS访问KMS。 联系安全管理员，让安全管理员授权EVS访问KMS。 授权成功后，用户E以及区域B中的所有用户都可以直接使用加密功能，无需再联系安全管理员进行授权。

资源和成本规划 该解决方案主要部署如下资源，以下花费仅供参考，具体请参考华为云官网价格详情，实际收费以账单为准： 表1 资源和成本规划 华为云服务 计费说明 每月花费（调用1000次） 对象存储服务 OBS 区域：华北-北京四 存储空间：数据存储（多AZ存储） 默认存储类别：标准存储 桶策略：私有 请求费用：0.0100元/万次 存储空间：0.1390元/GB/月 流量费用： 内/公网流入流量（数据上传到OBS） 0元 内网流出流量 0元 预计每月新增1GB数据量，花费0.1490元。 该方案存储费用消耗较低，详细请参考每月账单 函数工作流 FunctionGraph 区域：华北-北京四 产品：函数 请求次数： 0-100万次： 0元/100万次 100万次以上 ： 1.33元/100万次 计量时间： 0-400,000 GB/秒： 0元/GB-秒 400,000 GB/秒以上 ：0.00011108元/GB-秒 0元 总计： - 约0.1490元

快速部署 本章节主要指导用户如何自动化部署“CDN日志定时转储解决方案”。 表1 参数说明 参数名称 类型 是否可选 参数解释 默认值 target_bucket_name string 必填 OBS桶名称，全局唯一，用于存储CDN日志。取值范围：3~63个字符，支持小写字母、数字、中划线（-）、英文句号（.）。 空 domain_name string 必填 需要转存日志的 CDN加速 域名，取值范围：域名用字母（A-Z，a-z，大小写等价）、数字（0-9）和连接符（-）组成，各级域名之间用实点（.）连接，国际域名75个字符。注意连接符（-）不能作为域名的开头或结尾字符。示例：download.game-apk1.com。 空 dump_cron string 必填 定时转储cron表达式。格式为：秒 分 时 日 月 周(可选)，例如：0 15 2 * * ?（表示每天凌晨02：15：00执行）；0 30 8 ? * Mon（表示每周一上午08:30:00执行）；0 0 7 1 * ?（表示每月1号上午07:00:00执行），可参考cron表达式规则了解，填写Cron表达式。 0 0 8 * * ? 登录华为云解决方案实践，选择"CDN日志定时转储解决方案"，单击“一键部署”，跳转至解决方案创建资源栈界面。 图1 解决方案实施库 在选择模板界面中，单击“下一步”。 图2 选择模板 在配置参数界面中，参考表1 参数说明完成自定义参数填写，单击“下一步”。 图3 配置参数 在资源设置界面中，在权限委托下拉框中选择“rf_admin_trust”委托，单击“下一步”。 图4 资源栈设置 在配置确认界面中，单击“创建执行计划”。 图5 配置确认 在弹出的创建执行计划框中，自定义填写执行计划名称，单击“确定”。 图6 创建执行计划 单击“部署”，并且在弹出的执行计划确认框中单击“执行”。 图7 执行计划 图8 执行计划确认 待“事件”中出现“Apply required resource success”，表示该解决方案已经部署完成。 图9 部署完成 父主题： 实施步骤

登录前鉴权 在您的系统中使用云客服前，我们需要通过基于Ak/Sk的认证接口（tokenByAkSk）进行鉴权与认证。 调用云客服侧API Fabric校验接口tokenByAkSk进行认证，获取AccessToken。 选择一种接口测试工具，发起请求来获取云客服返回的Token。 按以下格式要求获取URL，选择POST方式。 HTTPS方法：POST URL：https://Domain Address/apigovernance/api/oauth/tokenByAkSk Domain Address请根据云客服实际的地址或域名进行替换。 例如，在华为公有云生产环境，请将Domain Address替换为service.besclouds.com，则调用URL为https://service.besclouds.com/apigovernance/api/oauth/tokenByAkSk HTTP协议是不安全协议，可能会对系统带来风险，不推荐使用。建议使用安全的HTTPS协议 将app_key和app_secret的值按调用样例的格式输入到Body，获得AccessToken值，如图1所示，您可以通过表1和表2了解请求参数属性和返回参数属性的要求。 图1 AccessToken调用 表1 RequestBody说明 参数名 参数类型 参数位置 是否必填 说明 app_key string body True API Fabric（云客服接口管理中心）上创建的App对应的APP Key。 开租成功后，云客服运营管理员会同时发送该Key值，请妥善保存。 app_secret string body True API Fabric的创建的App对应的APP Secret。 开租成功后，云客服运营管理员会同时发送该secret值，请妥善保存。 Example {"app_key": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX","app_secret": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"} 表2 ResponseBody说明 参数名 参数类型 参数位置 是否必填 说明 AccessToken string body True 通过API Fabric 上创建的APP Key和APP Secret，获取的输出参数token，后续用于调用同步信息。 ApplyType string body True Token类型，当前只支持Bearer。 CreateTime string body True Token创建时间。 Expires string body True Token过期时间。 Scope string body True Token能够访问的API范围。 AppKey string body True App对应的APP Key。 UserID string body True 用户标识。 Example {"AccessToken": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX","ApplyType": "Bearer","CreateTime": "1543395801","Expires": "600","Scope": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX","AppKey": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX","UserID": "sysAdmin"} 父主题： 集成开发

监听接续事件 监听接续事件，即可以在您的企业系统中，对希望关注的通话事件进行监听，例如座席状态事件与音视频通话事件。如果您期望能在您的系统中能利用这些事件进行日志记录、弹屏提示等功能的开发，请您继续阅读本章节内容，我们提供的主要可监听事件如表1所示。 表1 事件说明 事件 事件标示符 作用说明 座席忙 AgentState_Busy 表示座席正在进行呼叫处理。 工作中 AgentState_Work 表示某个座席进入工作整理态中。 示闲 AgentState_Ready 表示某个座席进入空闲状态。 示忙成功 AgentState_SetNotReady_Success 表示某个座席示忙成功。 取消示忙成功 AgentState_CancelNotReady_Success 表示某个座席取消示忙成功。 休息成功 AgentState_SetRest_Success 表示某个座席请求休息成功。 取消休息成功 AgentState_CancelRest_Success 表示某个座席取消请求休息成功。 休息超时提醒 AgentState_Rest_Timeout 表示某个座席请求休息后已经超时，提醒用户超时信息（此事件为提醒，并不代表座席退出休息态）。 进入工作态 AgentState_SetWork_Success 表示某个座席请求进入工作态成功。 退出工作态 AgentState_CancelWork_Success 示某个座席请求退出工作态成功。 座席进入talking AgentEvent_Talking 表示某个座席进入Talking状态。 保持成功 AgentEvent_Customer_Alerting 表示当前座席已处于保持状态。 外呼失败 AgentEvent_Call_Out_Fail 座席发起外呼呼叫失败，可能失败的原因为电话号码不对等。 座席退出呼叫 AgentEvent_Call_Release 表示座席从指定callId的呼叫中退出。 客户退出呼叫 AgentEvent_Customer_Release 表示客户从指定的callId呼叫中退出。 座席物理话机振铃 AgentOther_PhoneAlerting 表示某个座席的物理话机正在振铃。 您可以通过我们以下示例在您的页面对所需的事件进行监听，以下以“座席物理话机振铃”为例。 某页面集成了轻量接续条，需要在座席收到来话时，在页面上进行振铃提示，可以通过设置回调方法callback，捕获"AgentOther_PhoneAlerting"事件，实现来话提醒功能。参考代码如下： callback = function(data){ alert("来电话啦")}window.onload = function(){ var param = new Array; param.push("AgentOther_PhoneAlerting"); var json={name:"eventpost",param:param} window.frames["ccbarclient"].postMessage(JSON.stringify(json),$aicc_ContextPath);}if (window.addEventListener) { window.addEventListener('message', callback); } else { window.attachEvent('onmessage', callback); } callback：回调方法，实现具体的业务功能。 $aicc_ContextPath:域名，会在集成js加载成功后在页面中生成。 ccbarclient：被集成的集成接续条的iframe名称。 eventpost：注册在集成接续条中的获取接续事件的方法的名称。 addEventListener：添加接续事件监听。 父主题： （可选）其他功能开发

概述 云客服提供可被直接集成的轻量级接续条，您可以轻松的将人工座席的语音处理能力集成在员工的常用操作界面上，来填补原有客户服务系统中人工语音/视频服务渠道的缺失，无需考虑排队机、计算机电信集成平台等基础设施的构建和维护成本。 轻量级接续条提供主要的语音/视频呼叫处理和座席状态控制的功能，具有如下特点： 轻量级，容易集成到不同的平台中，不占用门户和工作台的主要页面。 易于操作，客服人员签入平台、接听来话、转移呼叫、静音、状态切换或求助等操作均可通过一次点击完成。 您可通过本手册将云客服的核心功能嵌入到第三方系统中，通过iframe的方式集成座席签入签出、接续控制的界面（即轻量级接续条），如图1和图2所示。 轻量级集成不支持同一个座席多地登录、多浏览器与多环境签入，会造成事件丢失或者异常返回。若因此出现页面异常，需要退出或关闭多地登录、多浏览器与多环境签入，再刷新页面即可恢复正常。 图1 音频通话界面 图2 视频通话界面

集成步骤 了解完集成原理后，您可以根据图1进行集成开发。 图1 集成步骤 完成开发前资源准备，配置云客服上的音视频座席功能，请参见开发前准备。 调用登录鉴权接口TokenByAkSk，请参见登录前鉴权。 您可以选择调用接口QueryAgentInfo，查询所有座席的软电话信息，同时完成与您业务系统中登录账户信息的同步，包括座席工号、软电话号码、软电话密码等，请参见获取云客服的账号信息。 开发Token生成机制并提供认证验证接口提供给AICC，AICC在鉴权通过后，会将Token发回给第三方系统，由第三方系统确认是否为本系统发的请求，具体开发要求请参见开发token生成机制与认证验证接口。 华为方使用HTTPS传输协议确保信息传输通道安全，请第三方系统确保开发的鉴权功能具备“口令复杂度校验”、“防暴力破解”、“防DOS攻击”等安全防护能力。 构造请求参数请求目标js：ccbarclient.js，集成轻量级接续控件，请参见开发集成页面。 测试与验证是否集成成功，您可以使用我们提供的Openeye终端产品进行验证，请参见测试与验证；您也可以通过其他支持SIP软电话的工具进行验证，例如webRTC、手机app等。 当前云客服与企业认证系统之间的认证仅支持OAuth认证。 当前webRTC注册不支持http协议，客户端页面必须是https协议。

操作步骤 调用座席软电话信息查询接口（queryAgentInfo）获取可用于同步的信息。 按以下格式要求获取URL，选择GET方式。 HTTPS方法：GET URL：http(s)://Domain Address/apiaccess/CC-Mangemant/v1/queryAgentInfo Domain Address请根据云客服实际的地址或域名进行替换。 例如，在华为公有云生产环境，请将Domain Address替换为service.besclouds.com，则调用URL为https://service.besclouds.com/apigovernance/api/oauth/tokenByAkSk HTTP协议是不安全协议，可能会对系统带来风险，不推荐使用。建议使用安全的HTTPS协议。 将x-app-key和Authorization的值按调用样例的格式输入到Header，获取所需输出参数，如图1所示。您可以通过表1和表2了解请求参数属性和返回参数属性的要求。 图1 queryAgentInfo调用 表1 RequestHeader说明 参数名 参数类型 参数位置 是否必填 说明 x-app-key string header True app标识。即您的app_key Authorization string header True 鉴权信息。为"Bearer "+鉴权接口获得的AccessToken Example {"x-app-key":XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"Authorization":Bearer XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX} 表2 ResponseBody说明 参数名 参数类型 参数位置 是否必填 说明 sipServiceIp string body False 软电话注册地址，IPV4格式。 sipServicePort int body False 软电话注册端口，值为1~65535。 agents list body True 座席集合。 workNo int agents True 座席工号。 sipAccount string agents False 软电话号码。 sipPwd string agents False 软电话密码。 accountCode string agents False 云客服登录账号。 Example { "sipServiceIp":"10.100.10.10", "sipServicePort":1000, "agents": [ { "workNo": 1001, "accountCode": "11", "sipAccount": "1001", "sipPwd": "cti-1234" } ]} 同步到座席相关信息后，您可能还需要在您的系统中完成如下事项： （可选）将您业务系统中的账户与云客服座席对象做关联，在开发集成页面步骤请求云客服时需要用到关联好的账户。如果您期望企业业务系统的用户每次登录时自行选择云客服账号登录云客服，可以跳过该步骤。 （可选）为座席提供软电话号码、软电话密码以及软电话注册地址/端口号，座席需要使用这些信息登录OpenEye客户端，进行呼入呼出操作。如果您使用OpenEye以外的SIP软电话工具进行呼叫操作可以跳过该步骤。

解决办法 出现此错误，一般是因为浏览器安装了安全插件，请用F12检查标头。 浏览器报错后，按F12键打开。 刷新之后，点击左边“Name”（请求名）下面的任何一行。 在“Network”界面找到“Headers”菜单，点开“Request Headers”，查看Origin参数。表示当前请求资源所在页面的协议和域名，用来说明请求的发起来源。有此参数，表示跨域正常。 如果没有Origin参数，请自检浏览器安装的插件。 图1 查看请求头参数

快速部署 本章节主要指导用户如何自动化部署“图片生成缩略图”解决方案。 表1 参数说明 参数名称 类型 是否可选 参数解释 默认值 image_bucket_name string 必填 OBS桶名称，全局唯一，用于上传图片。取值范围：3~63个字符，支持小写字母、数字、中划线（-）、英文句号（.）。 空 result_bucket_name string 必填 OBS桶名称，全局唯一，用于存放生成的缩略图。取值范围：3~63个字符，支持小写字母、数字、中划线（-）、英文句号（.）。 空 登录华为云解决方案实践，选择"无服务器图片生成缩略图"，跳转至该解决方案一键部署界面，单击一键部署，进入选择模板界面。 图1 解决方案实践 在选择模板界面中，单击“下一步”。 图2 选择模板 在配置参数界面中，参考表1 参数说明完成自定义参数填写，单击“下一步”。 图3 配置参数 在资源设置界面中，在权限委托下拉框中选择“rf_admin_trust”委托，单击“下一步”。 图4 资源栈设置 在配置确认界面中，单击“创建执行计划”。 图5 配置确认 在弹出的创建执行计划框中，自定义填写执行计划名称，单击“确定”。 图6 创建执行计划 单击“部署”，并且在弹出的执行计划确认框中单击“执行”。 图7 执行计划 图8 执行计划确认 待“事件”中出现“Apply required resource success”，表示该解决方案已经部署完成。 图9 部署完成 父主题： 实施步骤

资源和成本规划 该解决方案主要部署如下资源，以下花费仅供参考，具体请参考华为云官网价格详情，实际收费以账单为准： 表1 资源和成本规划 华为云服务 计费说明 每月花费（调用1000次） 对象存储服务 OBS 区域：华北-北京四 存储空间：数据存储（多AZ存储） 默认存储类别：标准存储 桶策略：私有 请求费用：0.0100元/万次 存储空间：0.1390元/GB/月 流量费用： 内/公网流入流量（数据上传到OBS） 0元 预计每月新增1GB数据量，花费0.1490元。 该方案存储费用消耗较低，详细请参考每月账单。 函数工作流 FunctionGraph 区域：华北-北京四 产品：函数 请求次数： 0-100万次： 0元/100万次 100万次以上 ： 1.33元/100万次 计量时间： 0-400,000 GB/秒： 0元/GB-秒 400,000 GB/秒以上 ：0.00011108元/GB-秒 0元 总计： - 约0.1490元

快速部署 本章节主要帮助用户快速部署“CDN自动刷新缓存”解决方案。 表1 参数填写说明 参数名称 类型 是否可选 参数解释 默认值 cdn_bucket_name String 必填 OBS桶名称，全局唯一，用于作为OBS源站桶。取值范围：3~55个字符，支持小写字母、数字、中划线（-）、英文句号（.）。 空 domain String 必填 需要刷新缓存的CDN加速域名，取值范围：域名用字母（A-Z，a-z，大小写等价）、数字（0-9）和连接符（-）组成，各级域名之间用实点（.）连接，国际域名75个字符。注意连接符（-）不能作为域名的开头或结尾字符。示例：https://download.game-apk1.com/。 空 登录华为云解决方案实践，选择“CDN自动刷新缓存”模板，数据中心下拉菜单可以选择需要部署的区域，单击“一键部署”，跳转至解决方案创建堆栈界面。。 图1 解决方案实践 在选择模板界面中，单击“下一步”。 图2 选择模板 在配置参数界面中，参考表1完成自定义参数填写，单击“下一步”。 图3 配置参数 在资源设置界面中，在权限委托下拉框中选择“rf_admin_trust”委托，单击“下一步”。 图4 资源栈设置 在配置确认界面中，单击“创建执行计划”。 图5 配置确认 在弹出的创建执行计划框中，自定义填写执行计划名称，单击“确定”。 图6 创建执行计划 单击“部署”，并且在弹出的执行计划确认框中单击“执行”。 图7 执行计划 图8 执行计划确认 待“事件”中出现“Apply required resource success”，表示该解决方案已经部署完成。 图9 部署完成 父主题： 实施步骤

资源和成本规划 该解决方案主要部署如下资源，每月花费如下所示，具体请参考华为云官网价格详情，实际收费以账单为准： 表1 资源和成本规划 华为云服务 配置示例 每月花费 对象存储服务 OBS 区域：华北-北京四 存储空间：数据存储（多AZ存储） 默认存储类别：标准存储 桶策略：私有 请求费用：0.0100元/万次 存储空间：0.1390元/GB/月 流量费用： 内/公网流入流量（数据上传到OBS） 0元 内网流出流量 0元 预计每月新增1GB数据量，花费0.1490元。 该方案存储费用消耗较低，详细请参考每月账单。 函数工作流 FunctionGraph 区域：华北-北京四 产品：函数 请求次数： 0-100万次： 0元/100万次 100万次以上 ： 1.33元/100万次 计量时间： 0-400,000 GB/秒： 0元/GB-秒 400,000 GB/秒以上 ：0.00011108元/GB-秒 0元 合计 约0.1390元