华为云用户手册

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

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

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

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

云硬盘基本概念 表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元

开始使用 登录华为云控制台，区域选择“华北-北京四”。 图1 华为云控制台 进入函数工作流FunctionGraph控制台，在函数列表中查看该方案创建的函数。 图2 创建的函数 进入相应函数中，查看该方案创建的触发器信息。 图3 CDN自动刷新缓存函数触发器 进入 统一身份认证 服务控制台，查看已创建的委托信息。 图4 委托信息 在函数服务的监控中，可以查看触发器在文件上传到指定桶后自动创建缓存预热任务。 图5 请求日志 在内容分发网络的预热刷新的历史记录中，可以看到刚创建的刷新缓存任务。 图6 刷新缓存任务 父主题： 实施步骤

配置DIS Source 表1 DIS Source配置项说明 配置项 是否必填 说明 默认值 channels 是 Flume channel的名称。 请根据实际情况配置 type 是 Source的类型。 com.huaweicloud.dis.adapter.flume.source.DISSource streams 是 指定在DIS服务上创建的通道名称。 与DIS控制台“购买接入通道”时配置的“通道名称”取值一致。 ak 是 用户的Access Key。 获取方式请参见检查认证信息。 请根据实际情况配置 sk 是 用户的Secret Key。 获取方式请参见检查认证信息。 请根据实际情况配置 region 是 将数据上传到指定Region的DIS服务。 请根据实际情况配置 projectId 是 用户所属区域的项目ID。 获取方式请参见检查认证信息。 请根据实际情况配置 endpoint 是 DIS对应Region的数据接口地址。 请根据实际情况配置 group.id 是 DIS App名称，用于标识一个消费组，由英文字符、数字、-、_组成。 请根据实际情况配置

支持的事件类别和事件 事件是租户通道状态发生变化的记录。它可以是由用户操作触发的（比如审计事件），也有可能是通道状态变化引起的（比如转储任务异常或转储任务恢复）。以下为当前DIS支持的事件和事件类别列表。 下表显示了事件源类型为通道的事件。 表1 事件源类型为通道的事件 事件源类型 事件级别 事件 通道 警告 流控受限 通道 警告 通道自动扩缩容成功 通道 警告 通道自动扩缩容失败 通道 警告 通道流量异常 通道 警告 通道流量恢复 下表显示了事件源类型为用户的事件。 表2 事件源类型为用户的事件 事件源类型 事件级别 事件 用户 警告 配额异常 下表显示了事件源类型为转储任务的事件。 表3 事件源类型为转储任务的事件 事件源类型 事件级别 事件 转储任务 正常 转储任务恢复 转储任务 警告 转储任务异常

查看事件 介绍用户如何查找通道或转储任务发生的事件。 在“事件管理”页面中单击“事件”，默认显示当前所有通道或转储任务已发生的事件。 在事件列表右上方的下拉列表中通过选择不同的筛选条件搜索事件。可从事件级别和事件源两个维度进行筛选。 在下拉列表中选择“所有事件级别”、“正常”或“警告”。 在下拉列表中选择“事件源”，在输入框中输入通道或转储任务名称，例如“demo”。 单击，显示筛选后的事件查询结果。 单击“事件”右侧的，选择事件名称，例如“转储任务恢复”，可过滤对应的事件。 父主题： 事件通知

源数据类型JSON/CSV 表1 转储相关配置参数 参数 说明 取值 任务名称 用户创建转储任务时，需要指定转储任务名称，同一通道的转储任务名称不可重复。任务名称由英文字母、数字、中划线和下划线组成。长度为1～64个字符。 - DLI 数据库 单击“选择”，在“选择DLI数据库”窗口选择一个数据库。 此配置项仅支持选择，不可手动输入。 - DLI数据表 单击“选择”，在“选择DLI数据表”窗口选择一个数据表。仅支持数据位置为DLI类型的数据表，且用户需具有该表的插入权限。 此配置项仅支持选择，不可手动输入。 配置此项必须已配置“DLI 数据库”。 偏移量 最新：最大偏移量，即获取最新的有效数据。 最早：最小偏移量，即读取最早的有效数据。 最新 数据转储周期 根据用户配置的时间，周期性的将数据导入目的地（OBS， MRS ，DLI，DWS），若某个时间段内无数据，则此时间段不会生成打包文件。 取值范围：30～900。 单位：秒。 默认配置为300秒。 - 数据临时桶 用户数据先临时存储在OBS桶中，再转储到指定的转储服务，转储完成后临时桶中的数据会被清除。 - 数据临时目录 需要转储的数据临时存储在OBS桶下此配置项配置的目录中，转储完成后临时目录中的数据会被清除。 配置为空时，数据直接存储在OBS桶内。 -

查看企业项目 通道创建成功后，您可以在通道列表和通道基本信息页面查看通道关联的企业项目。用户只能查询到有访问权限的项目下的通道资源。 在通道管理页面的列表中，查看通道所属的企业项目。 图1 查看企业项目 在通道列表中，单击通道名称，进入通道“基本信息”页面，可以查看与通道关联的企业项目。单击企业项目的名称，可以跳转到企业管理的控制台页面对该企业项目进行查看或编辑。 图2 查看通道的企业项目 同时，在企业管理的控制台中，查询指定项目中的资源列表时，也可以查询到DIS服务的资源。

绑定企业项目 用户可以在创建通道时为通道选择所属的企业项目，从而将DIS通道与企业项目进行关联，详情请参见步骤1：开通DIS通道。在选择“企业项目”的下拉列表中，将显示用户在企业项目服务中已创建的项目。系统还内置了一个缺省的企业项目“default”，如果用户没有为通道选择企业项目，将使用缺省项目“default”。 在通道创建过程中，如果通道与企业项目绑定成功，则通道创建成功，如果绑定失败，系统会发送告警，通道创建失败。 当删除DIS通道时，DIS通道与企业项目的关联关系就会被自动删除。

自动创建委托 用户创建DIS通道，选择将数据转储到对象存储服务（Object Storage Service，简称OBS）、 MapReduce服务 （MRS）集群、 数据仓库 服务（Data Warehouse Service，简称DWS）或 数据湖探索 （Data Lake Insight，简称DLI）中，需要通过创建 IAM 委托授权DIS服务去访问用户的OBS、MRS、DWS或DLI资源。 使用账号首次进入界面添加转储任务时，系统会自动弹出创建委托界面。 单击 “同意授权”则平台会自动创建委托。 委托授权成功后，隶属于该账号下的IAM子用户也可添加转储任务。 父主题： 入门

功能简介 将用户本地数据通过DIS通道不断上传至DIS服务。 目前数据支持存储至DIS和对象存储服务（Object Storage Service，简称OBS）MapReduce服务（MapReduce Service,简称MRS）、数据仓库服务（Data Warehouse Service，简称DWS）、 数据湖 探索（Data Lake Insight，简称DLI），具体存储位置在新增转储任务的“数据转储”中配置。 DIS为临时存储器，存储在DIS中的数据最长保留时间为步骤 3中配置的“生命周期”的值。

运行程序 出现类似信息表示下载数据成功： 14:55:42.954 [main] INFOcom.bigdata.dis.sdk.DISConfig - get from classLoader14:55:44.103 [main] INFOcom.bigdata.dis.sdk.util.config.ConfigurationUtils - get from classLoader14:55:44.105 [main] INFOcom.bigdata.dis.sdk.util.config.ConfigurationUtils - propertyMapFromFile size : 214:55:45.235 [main] INFOcom.bigdata.dis.sdk.demo.ConsumerDemo - Get stream streamName[partitionId=0] cursor success : eyJnZXRJdGVyYXRvclBhcmFtIjp7InN0cmVhbS1uYW1lIjoiZGlzLTEzbW9uZXkiLCJwYXJ0aXRpb24taWQiOiIwIiwiY3Vyc29yLXR5cGUiOiJBVF9TRVFVRU5DRV9OVU1CRVIiLCJzdGFydGluZy1zZXF1ZW5jZS1udW1iZXIiOiIxMDY4OTcyIn0sImdlbmVyYXRlVGltZXN0YW1wIjoxNTEzNjY2NjMxMTYxfQ14:55:45.305 [main] INFOcom.bigdata.dis.sdk.demo.ConsumerDemo - Get Record [hello world.], partitionKey [964885], sequenceNumber [0].14:55:45.305 [main] INFOcom.bigdata.dis.sdk.demo.ConsumerDemo - Get Record [hello world.], partitionKey [910960], sequenceNumber [1].14:55:46.359 [main] INFOcom.bigdata.dis.sdk.demo.ConsumerDemo - Get Record [hello world.], partitionKey [528377], sequenceNumber [2].

DIS使用流程简介 DIS的使用流程如下： 步骤1：开通DIS通道 用户使用DIS前需要先开通DIS通道。 步骤2：准备DIS应用开发环境 用户开发DIS应用程序前，首先需要安装 应用开发工具 。然后获取SDK和样例工程，并导入到用户的开发环境中。 步骤3：发送数据到DIS 基于数据上传业务开发应用程序，并运行程序，实现数据上传功能。数据上传过程中可在Console控制台查看数据上传通道相关信息。 步骤4：从DIS获取数据 基于数据下载业务开发应用程序，并运行程序，实现数据下载功能。 父主题： 入门