数据访问-华为云

云客服-第三方下载录音文件:报文样例

报文样例请求头 POST /CCFS/resource/ccfs/ivr/downloadFile HTTP/1.1 Authorization: auth-v2/ak/2021-08-31T09:38:50.872Z/content-length;content-type;host/c12f0ed0******************94941bdd106 Accept: */* Content-Type: application/json;charset=UTF-8 Content-Length: 193 请求参数 { "request": { "version": "2.0" }, "msgBody": { "filePath": "Y:/3rdfile/53/thirdvoicebotfile", "mode":"1" } }

云客服数据访问接口

云客服-第三方下载录音文件:响应说明

响应说明当调用本接口响应成功，则从httpresponse消息中获取文件的二进制数据生成录音文件，文件后缀名为.wav，响应中content-type字段为Application/Octet-stream;charset=UTF-8。当调用本接口响应失败，则返回相应的错误码信息，错误码响应数据结构请查看表响应消息response参数说明，resultData为保留字段，默认为空字符串。表4 响应消息参数说明序号名称参数类型说明 1 resultCode String 请求返回的结果码，详见错误码参考。 2 resultDesc String 请求结果描述。 3 resultData Object 请求响应数据

云客服数据访问接口

云客服-生成座席操作详单索引:报文样例

报文样例请求头 POST /CCFS/resource/ccfs/queryAgentOprInfoData HTTP/1.1 Authorization: auth-v2/ak/2018-07-02T02:42:49Z/content-length;content-type;host /7a8fb9d620e******************5c5df0cce3c6a253 Accept: */* Host: 10.154.198.164 Content-Type: application/json;charset=UTF-8 Content-Length: 297 请求参数 { "request": { "version": "2.0" }, "msgBody": { "beginTime": "2018-06-29 10:42:49", "endTime": "2018-07-02 10:42:49", "accountId": "", "agentId": "", "callBackURL": "https://10.57.118.171:8000" } } 响应头 HTTP/1.1 200 OK Content-Type: application/json;charset=UTF-8 Date: Mon, 02 Jul 2018 02:43:03 GMT 响应参数 { "response": { "version": "2.0", "resultCode": "0", "resultMsg": "success" }, "resultData": { "responseId": "9239cb50a8384bb0ab503441bf089446" }, "resultCode": "0", "resultDesc": "success" } 呼叫中心向回调地址返回的消息示例消息头 POST / HTTP/1.1 Accept: */* Content-Type: application/json;charset=UTF-8 Authorization: auth-v2/ak/2018-07-02T02:43:03Z/content-length;content-type;host /c5bd683******************ef5747bd572c28 Host: 10.57.118.171 Content-Length: 208 消息参数 { "request": { "version": "2.0" }, "msgBody": { "responseId": "9239cb50a8384bb0ab503441bf089446", "agentOprInfoFileName": "20180702_9239cb50a8384bb0ab503441bf089446.zip" } }

云客服数据访问接口

云客服-生成座席操作详单索引:请求说明

请求说明表1 请求Headers参数说明序号名称参数类型是否必选默认值说明 1 Content-Type String True 无固定填 application/json; charset=UTF-8。 2 Authorization String True 无生成方式参见C2 监控/系统外呼/话单/知识库类接口鉴权方式。表2 请求Body中request参数说明序号名称参数类型是否必选默认值说明 1 version String（1-32） True 2.0 协议版本。当前固定值为2.0。表3 请求Body中msgBody参数说明序号名称参数类型是否必选默认值说明 1 beginTime String True 无座席相关操作的起始时间，为租间所在时区的时间，起始时间和截止时间需要做范围限制，最大为3天内。格式为：yyyy-MM-dd HH:mm:ss。 2 endTime String True 无座席相关操作的截止时间，为租间所在时区的时间，起始时间和截止时间需要做范围限制，最大为3天内。格式为：yyyy-MM-dd HH:mm:ss。 3 accountId String（1-20） False 无企业帐号（租间ID）。 4 agentId String（1-20） False 无座席ID（座席工号）。 5 callBackURL String True 无回调地址。平台生成数据记录文件后将fileName返回到该地址。

云客服数据访问接口

云客服-生成座席操作详单索引:响应说明

响应说明调用本接口获得响应分为两部分：（1）调用本接口立即得到响应该响应消息参数说明详见表4。表4 响应消息参数说明序号名称参数类型说明 1 resultCode String 请求返回的结果码， 0：成功非0：详见错误码参考。 2 resultDesc String 请求结果描述。 3 resultData Object 请求响应数据,resultData参数说明详见表6-响应消息resultData参数说明。 4 response Object 请求结果对象，参数说明详见表6 不推荐使用，为兼容老版本保留字段。表5 响应消息resultData参数说明序号名称参数类型说明 3.1 responseId String 调用本接口成功后，生成的唯一标识，是文件名称的组成部分。表6 响应消息response参数说明序号名称参数类型说明 4.1 version String（1-32）协议版本，如2.0。 4.2 resultCode String(1-32) 请求返回的结果码，详见错误码参考。 4.3 resultMsg String 请求结果描述。（2）平台生成数据记录文件后回调第三方的响应。该响应由request，msgBody两部分组成。msgBody参数说明详见表7-回调返回消息请求Body中msgBody参数说明。 request包含响应版本号version（默认2.0）。 msgBody由responseId（座席操作详单文件名组成部分），fileName（待下载座席操作详单zip名称），accountId（租间ID）组成。表7 回调返回消息请求Body中msgBody参数说明序号名称参数类型说明 1 responseId String 调用本接口成功后，生成的唯一标识，是文件名称的组成部分。 2 fileName String 话单和录音索引文件名称。格式：yyyyMMdd_{responseId}.zip。例如：调用本接口的日期为2018-07-02，获取到的responseId为9239cb50a8384bb0ab503441bf089446，则该参数值为20180702_9239cb50a8384bb0ab503441bf089446.zip。 3 accountId String 企业帐号（租间ID），请求参数中带的企业账号，用来将文件名和企业进行关联，如果请求参数中未填accountId，则不会返回该值。若回调没有成功（ccfs没有收到回调地址的成功响应，或没有响应体），ccfs会重试，间隔10分钟重试一次，直到成功或者超过重试次数。

云客服数据访问接口

云客服-生成座席操作详单索引:使用说明

使用说明前提条件开发者环境已经构建，座席正常签入并进行相关操作，开发者有独立服务器并且已经绑定回调地址（callBackURL）。企业帐号（accountId：租间ID）、座席ID（agentId），可自由组合生成座席操作详单索引文件。如果均没有传入，则生成指定时间段内该appId下相应的数据记录。已通过鉴权（Authorization）、获取接入地址。请检查CC-FS配置文件“/home/ccfsapp/webapps/ccfsapp/WEB-INF/classes/config/servicecloud.base.properties”的“aicc.ssl.trustAll”是否配置为false，请配置为false，然后参考下面步骤放置证书。以运维用户登录CC-FS的服务器，切换到root用户下。 su - root 将CC-FS生成索引文件通知回调地址加载的第三方证书上传至AICC的truststore.jks证书的同一目录中，目录为：“$HOME/conf”，具体目录请以实际环境为准。修改上传的第三放证书的属组。 chown ccfsapp:ccfsapp XXX.jks 执行下面的命令将第三方证书导入到truststore.jks中。 keytool -import -alias xxx -file XXX.jks -keystore truststore.jks 请依据界面提示输入truststore.jks证书密码。在环境上删除XXX.jks证书。重启CC-FS。进入“/home/ccfsapp/bin”目录，执行如下命令。 ./shutdown.sh;./startup.sh 使用限制开发者只能访问该帐号下的数据信息，开发者帐号（appId）和企业帐号（accountId）必须对应。开发者账号包含在认证字符串中，详见C2 监控/系统外呼/话单/知识库类接口鉴权方式。

云客服数据访问接口

对象存储服务 OBS-配置加速域名

配置加速域名使用CDN加速域名后，可配置网站加速、文件下载加速和点播加速。详细应用场景请参见应用场景。通过CDN实现OBS文件下载加速的详细配置方法请参见最佳实践。 CDN加速需收费，具体请参见CDN价格说明。同时OBS提供更加优惠的回源流量包，可以减少CDN加速场景下获取数据时产生的流量费用。 CDN加速非实时生效，配置域名后请刷新域名管理列表查看状态。只有当CNAME域名状态为“已开启”时，才表示CDN加速生效。如果开启了自动刷新缓存，在CNAME域名状态变为“已开启”后，还需要等待最长约5分钟，自动刷新缓存配置才生效。在OBS管理控制台左侧导航栏选择“桶列表”。在OBS管理控制台桶列表中，单击待操作的桶，进入“对象”页面。在左侧导航栏选择“域名管理”，进入“域名管理”界面。图1 域名管理界面单击页面上方的“配置加速域名”，如果没有绑定自定义域名也可以在页面下方的配置加速域名卡片中单击“配置加速域名”，弹出“配置加速域名”页面，如图2所示。如果还没有开通CDN服务，单击“配置加速域名”后会出现弹窗，根据弹窗提示，单击开通CDN服务。图2 配置加速域名选择“服务范围”，选择“业务类型”，设置“加速域名”，单击“确定加速”。如果您在填写加速域名时，需要OBS控制台为您呈现已有华为云域名下拉列表，您想要在下拉列表中直接点选，则您需要拥有域名注册服务Domains的Domains:domains:getDetails权限，请联系管理员使用IAM为您授权。如果无该权限，您需要手动输入加速域名。如果您的OBS桶开启了静态网站托管功能，请在配置CDN加速域名时勾选“静态网站托管”，这样用户访问时就不会显示桶中所有文件列表。根据页面提示，支持单击“一键解析”，或手动完成解析CNAME，单击右下角的“我已了解”，如图3所示。华为云域名支持一键解析添加CNAME记录；非华为云域名不支持一键解析，请用户自行配置解析规则。图3 解析CNAME 如果您绑定了域名，还可以在域名管理列表，找到需要开启加速的域名卡片，单击“开启加速”，后续具体操作请参见上文内容。图4 加速域名父主题：数据访问

对象存储服务 OBS 数据访问

对象存储服务 OBS-配置数据回源规则:创建镜像回源规则

创建镜像回源规则在OBS管理控制台左侧导航栏选择“桶列表”。在OBS管理控制台桶列表中，单击待操作的桶，进入“对象”页面。在左侧导航栏选中“数据回源”，进入“数据回源”页面。单击“创建”。图1 创建镜像回源规则配置镜像回源规则参数，参数说明如表1。表1 镜像回源规则参数说明参数说明资源类型设置回源地址（源站）的类型。公有类型：源站数据来源于公有对象存储。私有类型：源站数据来源于部分云厂商的私有对象存储。回源条件设置回源规则的触发条件。回源条件由HTTP状态码和文件名前缀共同确定，表示访问桶中符合文件名前缀要求的对象时，如果对象不存在（返回404错误），则满足回源条件。文件名前缀输入规则：不能超过1023个字符。不能与已有回源规则配置的文件名前缀存在相互包含或重叠的关系。如果不输入，则表示配置到尚未匹配桶内任何回源规则的文件。仅能配置一条文件名前缀为空的回源规则。示例：配置123/前缀，访问桶中123/456.txt文件时会触发回源规则。添加前后缀 OBS向源站请求数据时，在客户端请求的对象名前后增加前后缀。最终返回给OBS与客户端的对象名与此前后缀无关，仍保持客户端请求的对象名。示例：客户端请求abc.txt时触发回源规则，如果添加前缀为123，则OBS向源端请求的对象名变为123abc.txt，该对象下载到OBS中仍以abc.txt名称保存并返回给客户端。替换前缀 OBS向源站请求数据时，替换回源条件中的文件名前缀。最终返回给客户端的对象名与此前缀无关，仍保持客户端请求的对象名。示例：回源条件配置文件前缀为123，替换前缀配置为abc，客户端请求123456.txt时触发回源规则，OBS向源端请求的对象名变为abc456.txt，该对象下载到OBS中仍以123456.txt名称保存并返回给客户端。回源地址设置回源地址（源站地址），支持配置主站和备站。回源时会优先使用主站地址，如果同时配置多个主站，会轮询访问所有主站。如果配置2个及以上主站，第一次请求主站失败，并且满足重试条件时，会选用另一个主站重试一次。至少配置一个主站，最多同时配置5个主站。主站全部回源失败时，会使用备站地址进行重试。格式：http或https://回源域名/静态路径回源域名为源站的域名。如果源端为HTTP公共可访问的桶，则此地址为桶域名地址。如果源端为其他云厂商的私有桶，则此地址为区域域名地址。当前仅支持部分云厂商的私有桶。静态路径为目标文件所在的目录信息，例如静态路径配置123/，表示目标文件在123/目录下。重试条件选择回源地址重试的条件。 4XX和4开头的具体错误码不能同时配置，5XX和5开头的具体错误码不能同时配置。最多支持同时配置20个错误码。携带请求字符串开启后，会将请求URL中查询参数传递到源站。重定向请求响应策略开启后，如果源站配置了重定向，会跟踪源站的3xx重定向请求，前往重定向的目标获取资源，并将该资源保存到OBS上。最多跟随10次重定向。重定向时不携带Referer 开启后，如果源站配置了重定向，处理源站重定向时会去掉请求中的Referer头域。 HTTP header传递规则可以通过设置HTTP header传递规则，规定客户端发送给OBS的请求经过镜像回源由OBS传递给源站时，允许传递的HTTP header参数。相关参考中提供了一个配置示例供参考，同时列出了不支持的HTTP header。允许传递所有参数/允许传递指定参数：设置允许传递的HTTP header参数。禁止传递指定参数：设置禁止传递的HTTP header参数。当客户端请求携带此header时，OBS不会传递给源站。当禁止和允许规则冲突时，禁止规则优先。设置自定义参数：给指定header设置自定义取值，如果客户端请求携带此header，OBS在传递给源站时会将header取值修改为自定义的取值。 IAM委托镜像回源需使用IAM委托功能，委托OBS获取源站数据。委托需要给OBS服务授予“Tenant Administrator”权限，且委托持续时间必须是永久。如果无合适的IAM委托，则可创建一个新的IAM委托，请参考创建IAM委托。单击“确定”。

对象存储服务 OBS 数据访问

对象存储服务 OBS-配置数据回源规则:复制镜像回源规则

复制镜像回源规则在OBS管理控制台左侧导航栏选择“桶列表”。在OBS管理控制台桶列表中，单击待操作的桶，进入“对象”页面。在左侧导航栏选中“数据回源”，进入“数据回源”页面。单击“复制”。选择复制源，即数据回源规则所在的源桶。从源桶复制数据回源规则的操作为增量复制，不会删除当前桶已存在的数据回源规则，与已存在的数据回源规则冲突的规则不会复制。源桶和目标桶的桶版本号都必须是3.0。复制时支持修改回源地址，回源地址配置说明请参见表1。您可以按需移除不需要复制的数据回源规则。单桶数据回源规则上限为5条，如果已有规则+复制规则的数量超过上限，将会复制失败，请先删除多余规则再进行复制。图2 复制数据回源规则单击“确定”，将源桶的数据回源规则复制到当前桶。

对象存储服务 OBS 数据访问

对象存储服务 OBS-配置数据回源规则:相关参考

相关参考镜像回源的HTTP header传递规则参数配置示例假设参数配置如图3所示。图3 HTTP header传递规则配置示例根据上述规则，如果客户端发送到OBS请求的header部分如下所示： GET /ObjectName HTTP/1.1 Host: bucketname.obs.cn-north-4.myhuaweicloud.com aaa:aaa bbb:bbb ccc:ccc 在触发镜像回源规则后，OBS发送给源站的请求如下： GET /ObjectName HTTP/1.1 Host: source.com aaa:aaa ccc:111 镜像回源过程中透传HTTP header情况从源站透传到客户端只支持以下HTTP header： Content-Type Content-Language Content-Encoding Content-Disposition Cache-Control Expires 从客户端透传到源站不支持以下HTTP header：以下前缀开头的HTTP header： x-obs- 所有标准HTTP header，例如： Content-Length Authorization2 Authorization Range Date

对象存储服务 OBS 数据访问

对象存储服务 OBS-静态网站托管:与其他功能的关系

与其他功能的关系功能静态网站托管与该功能的关系参考文档跨域资源共享默认情况下，托管在OBS的静态网站仅允许响应同域网站的访问请求。通过对保存静态网站资源的OBS桶进行跨域资源共享配置，可以实现跨域访问功能。跨域资源共享自定义域名配置 OBS支持通过自定义域名访问托管在OBS上的静态网站，用户无需修改网站代码，即可使用原域名访问网站。自定义域名配置使用自定义域名托管静态网站 CDN加速默认情况下，用户访问托管在OBS的静态网站是通过URL直接从OBS请求数据。一般情况下文件只存储在一个区域，不同区域的用户访问OBS的响应速度存在差异。在需要频繁访问的场景下，直接访问OBS来获取相应文件，还会消耗大量的流量费用。为提升用户访问体验，且降低存储成本，可以选择通过CDN加速访问静态网站。 CDN加速使用自定义域名托管静态网站通过CDN加速访问OBS 防盗链用户将网站托管在OBS后，为了防止网站数据被其他人盗链，OBS支持基于HTTP header中表头字段referer的防盗链方法。防盗链

对象存储服务 OBS 数据访问

对象存储服务 OBS-静态网站托管:注意事项

注意事项基于安全合规要求，华为云对象存储服务OBS禁止通过OBS的默认域名（桶访问域名或静态网站访问域名）使用静态网站托管功能，即使用上述域名从浏览器访问网页类型文件时，不会显示对象内容，而是以附件形式下载。各区域将自以下两个时间点起生效：自2022年1月1日起生效：华北-北京一、华北-北京四、华北-乌兰察布一、华东-上海一、华东-上海二、华南-广州、西南-贵阳一自2022年3月25日起生效：中国-香港、亚太-曼谷、亚太-新加坡、非洲-约翰内斯堡、拉美-墨西哥城一、拉美-墨西哥城二、拉美-圣保罗一、拉美-圣地亚哥通过自定义域名使用静态网站托管功能不受影响，仍然支持文件内容的直接预览。详情请参见如何在浏览器中在线预览OBS中的对象？

对象存储服务 OBS 数据访问

对象存储服务 OBS-静态网站托管:重定向简介

重定向简介在使用静态网站托管功能时，OBS还支持配置重定向请求，即您可以将特定的请求或所有请求实施重定向。当网站结构调整、网站地址变化或者网站的扩展名发生变化时，用户使用旧的网站地址（比如收藏夹中的地址）访问网站会访问失败，用户只能得到404页面错误信息。此时网站配置了重定向后，让访问这些域名的用户跳转到设定的页面以避免404错误访问。重定向典型的应用场景包括：重定向所有请求到另外一个站点。设定特定的重定向规则，对特定的请求实施重定向。

对象存储服务 OBS 数据访问

对象存储服务 OBS-静态网站托管:索引文档支持

索引文档支持索引文档是当对网站的根或任何子文件夹发出请求时返回的网页。例如，如果用户在浏览器中输入http://www.example.com，则该用户没有请求任何特定页面。在这种情况下，OBS将提供索引文档，该文档有时也称为默认页面。当您将您的桶配置为网站时，您应该提供索引文档的名称。您必须上传具有此名称的对象并将其配置为公开可读。根级URL的尾部斜杠是可选的。例如，如果您将具有index.html的网站配置为索引文档，以下任意一个URL将返回index.html。 http://bucketname.obs-website.example.com/ http://bucketname.obs-website.example.com 在OBS中，对象在桶中是水平存储的；它不会像计算机上的文件系统那样提供任何分层组织。您可以通过使用表示文件夹结构的对象名称创建逻辑层级结构。例如，考虑具有三个对象的桶和以下对象名。 sample1.jpg photos/2006/Jan/sample2.jpg photos/2006/Feb/sample3.jpg 虽然它们没有按任何物理分层组织进行存储，但您可以从对象名推断以下逻辑文件夹结构。 sample1.jpg对象位于桶的根级 sample2.jpg对象位于photos/2006/Jan子文件夹中。 sample3.jpg对象位于photos/2006/Feb子文件夹中。

对象存储服务 OBS 数据访问

对象存储服务 OBS-静态网站托管:自定义错误文档支持

自定义错误文档支持表1列出了发生错误时OBS返回的HTTP响应代码的子集。表1 错误码列表 HTTP错误代码说明 301 永久移动当用户将请求直接发送到OBS网站终端节点时，OBS返回301 Moved Permanently (301 永久移动)响应。 302 Found (302 已找到) 当OBS收到对不包含尾部斜杠的键x的请求时，它首先查找键名称为x的对象。如果未找到对象，则OBS确定该请求是针对子文件夹x发出的，并通过在末尾添加斜杠重定向请求并返回302 Found (302 已找到)。 304 Not Modified (304 未修改) OBS用户请求标头If-Modified-Since、If-Unmodified-Since以确定所请求的对象是否与客户端保存的缓存副本相同。如果对象相同，网站终端节点将返回304 Not Modified响应。 403 禁止访问当用户请求转换为不可公开读取的对象时，网站终端节点的响应包含403 Forbidden。对象所有者必须使用桶策略或ACL使该对象公开可读。 404 未找到由于以下原因，网站终端节点的响应包含404 Not Found： OBS确定网站URL引用了不存在的对象键 OBS推断该请求针对不存在的索引文档在URL中指定的桶不存在在URL中指定的桶存在，但它未配置为网站您可以创建为404 Not Found返回的自定义文档。确保该文档已上传到配置为网站的桶，且网站托管配置已设置为使用该文档。 500 Service Error 当出现内部服务器错误时，网站终端节点的响应包含500 Service Error。 503 服务不可用当OBS确定您需要降低请求频率时，网站终端节点的响应包含503 Service Unavailable (503 服务不可用)。

对象存储服务 OBS 数据访问

云服务器内容精选

数据访问

7*24

备案

专业服务

退订

建议反馈

售前咨询热线