参数 类型 是否必传 名称 描述 ipv4 string 否 ipv4 最多支持10个ip查询，多IP使用逗号分隔。ipv4和ipv6至少传一个参数，也可同时传两个参数 ipv6 string 否 ipv6 最多支持10个ip查询，多IP使用逗号分隔。ipv4和ipv6至少传一个参数，也可同时传两个参数

省份 省份编码 :: 安徽 340000 浙江 330000 上海 310000 江苏 320000 福建 350000 山东 370000 广东 440000 广西 450000 海南 460000 江西 360000 河南 410000 湖南 430000 湖北 420000 辽宁 210000 吉林 220000 黑龙江 230000 陕西 610000 甘肃 620000 青海 630000 宁夏 640000 新疆 650000 北京 110000 天津 120000 河北 130000 山西 140000 内蒙古 150000 重庆 500000 四川 510000 贵州 520000 云南 530000 西藏 540000 香港 810000 澳门 820000 台湾 710000

eopdate yyyymmddTHHMMSSZ（20211221T163614Z）(年月日T时分秒Z) Ktime 使用eopdate作为数据，sk作为密钥，算出ktime。 Ktime hmacSha256(eopdate,sk) kAk 使用ak作为数据，ktime作为密钥，算出kAk。 kAk hmacsha256(ak,ktime) kdate 使用eopdate的 年月日值 作为数据，kAk作为密钥，算出kdate。 kdate hmacsha256(eopdate,kAk)

本文介绍日志下载。 客户控制台可选择域名和时间范围查询日志，最多支持近15天的日志下载，同时支持单个日志下载和批量下载。 单日志下载：选中单个域名后面的文件下载键进行单个日志文件下载。 批量下载：第一列选中多个域名，并点击【批量下载】可进行批量日志下载。

参数 类型 是否必传 名称及描述 code int 是 状态码 message string 是 描述信息

参数 类型 是否必传 名称及描述 code int 是 状态码 message string 是 描述信息 submitid string 否 提交id result list< object> 否 返回包含任务id的列表 result[].taskid string 否 任务id result[].url string 否 刷新的URL

本文解释CDN和镜像站点的区别。 CDN关注于把内容放在离用户最近的地方，让用户访问更快。CDN的内容由用户请求触发回源获取后才能缓存下来，且无法保证内容一直存储在CDN服务器上，有可能会被更热的内容覆盖掉，此时如果下次再有同个文件访问，需要再回源站获取。 而镜像站点是将网站文件放在多个不同服务器站点上，不同站点之间做实时文件同步，保障数据一致性。镜像站点的文件是保存完整的，且彼此之间同步是自动的，无需用户请求触发。

本文介绍本地网络速度正常但访问HTTPS网站速度慢的问题原因及解决方案。 问题现象 域名接入CDN后，本地网络速度正常，但访问HTTPS网站速度慢。 问题原因 本地网络速度正常情况下，出现该问题，可能是因为HTTPS访问过程中TLS(SSL)建连慢造成。 解决方案 排查方法： 1. 使用HTTP访问，确认HTTP请求有无访问速度慢问题。 在浏览器访问HTTP请求，若页面请求响应快，则确认HTTP请求无访问慢问题。 说明 若HTTPS请求URL为 ，则对应HTTP请求URL为 。 2. 使用HTTPS访问，查看HTTPS请求的TLS(SSL)建连耗时。 步骤一：打开浏览器（以Chrome浏览器为例），按F12进入开发者模式，单击【Network】，在浏览器地址栏输入https访问地址，单击【Waterfall】查看各阶段响应时间： 步骤二：Waterfall中，有一项名为“SSL”的项，即为TLS(SSL)建连时间： 若TLS(SSL)建连时间长，则确认本地网络速度正常情况下，HTTPS慢是由于TLS建连慢导致（图中SSL即指TLS）。 该问题原因，很大可能是TLS握手过程中，客户端需要通过OCSP协议来验证服务器证书耗时过长导致。解决方案是开启OCSP装订功能，OCSP装订功能介绍以及开启，详情请见：OCSP装订。

本文介绍如何确认域名CNAME解析是否正常。 问题概述 本文主要介绍如何确认域名CNAME解析是否符合预期且工作正常。 验证方式 Windows PC客户端：同时按住Windows+R键，输入cmd，敲回车以打开命令提示符窗口，输入命令“nslookup 域名”，查看返回的结果中是否显示正确的CNAME信息。 MAC OS 或者 Linux 客户端：打开终端工具，输入命令“dig 域名”，查看返回的结果中是否显示正确的的CNAME信息。 相关概念 关于CNAME、DNS的相关基本概念解释，详情请见：基本概念。

本文介绍如何验证IP地址是否属于天翼云CDN节点IP。 问题概述 本文主要介绍针对指定的IP，如何验证该IP是否为天翼云CDN节点的IP地址。 验证说明 1. 登录CDN控制台。 2. 单击左侧导航栏【诊断工具】，进入【IP归属查询】页面，输入查询的地址。 3. 输入查询后将显示该地址是否为天翼云CDN节点以及对应归属地。

更新日期 更新内容 20221130 第一次正式发布。 本次更新说明如下： 上线IPA域名管理、IPA统计分析、IPA账单服务等API。 2023421 第二次正式发布。 本次更新说明如下： 上线辅助工具等API。

code code含义 message示例（仅供参考） ::: 100000 正确返回 success 100001 认证失败 用户认证失败，RequestId是 100002 找不到指定路径的API 当前调用的api不存在:${api} 100003 无请求指定API的权限 当前用户对api:${api}无权限 100004 调用超限 超过调用频率限制，请稍后重试 100005 请求类型错误 当前调用的api请求方式错误 100012 底层错误 请求错误，（底层返回结果） 100013 系统错误 系统错误 100014 底层超时 请求底层超时 110001 操作类添加防连击检测 请求已提交，请勿重复操作！ 200001 资源没有权限 请求参数域名校验失败，当前用户对域名%s无权限 200002 参数校验失败 请求参数校验失败，参数为必填 200003 参数不合法 请求参数校验失败，参数不合法 200004 统计分析类接口查询不到clientid 无法获取您已开通CDN相关产品的账号，请开通产品后再调用 200005 产品有效性校验 操作失败，当前用户未开通产品类型{}的服务 200006 查询失败 无法获取到证书数据

参数 参数类型 说明 示例 下级对象 statusCode Integer 状态码 100000 returnObj Object 返回对象 {} message String 结果简述 正确返回/参数不合法 error String 错误码 CDN200002 errorMessage String 错误详情 请求参数校验失败，参数domain为必填，且不能为空

示例： 请求路径： 示例1： 请求参数： json { "reportTemplateId":272 } 返回结果： json { "code": 100000, "message": "success", "data": { "accountId": "0dba69812ab444c4adc90edbf080b210", "clientId": 1418, "reportName": "TestReport9", "sendType": 1, "sendFrequency": 1, "oneTimeEndTime": "20221122 08:01:05", "reportTemplateId": 273, "thisDate": "20221122 08:57:00", "email": "@qq.com", "oneTimeStartTime": "20221101 17:01:05", "chartData": { "domain": [ { "domainName": "test.ctyun.cn", "list": [ { "name": "TOP10 URL统计图", "id": 3 } ] } ], "dir": [], "allDomain": [], "productDomain": [] } } } 错误码请参考：参数code和message含义

接口描述：调用本接口可根据报表ID更新报表订阅信息 请求方式：post 请求路径：/reportmanage/updatereport 使用说明： 单个用户一分钟限制调用10000次，并发不超过100； 请求参数说明： 参数 类型 是否必传 名称 描述 reportTemplateId number 是 报表订阅ID reportName string 是 报表名称 长度不超过200字符 thisDate string 是 本次发送时间 格式：yyyyMMdd HH:mm:ss sendFrequency number 是 发送频率 1(仅一次), 2(一天), 3(一星期), 4(一个月), 5(三个月), 6(六个月), 7(一年) oneTimeStartTime string 否 报表统计开始时间 格式：yyyyMMdd HH:mm:ss oneTimeEndTime string 否 报表统计结束时间 格式：yyyyMMdd HH:mm:ss email string 是 订阅邮箱 多个英文分号;分割 chartData object 是 报表图表集 chartData.domain list 是 域名级图表 chartData.domain[].domainName string 是 客户域名 chartData.domain[].list list 是 域名级图表 chartData.domain[].list[ ].id number 是 图表编号 1（带宽流量图），2（请求数据统计图），3（TOP10 URL统计图），4（TOP10 IP统计图），5（状态码统计图），6（命中率统计图），7（用户所属运营商统计图），8（用户所属省份统计图） 返回参数说明： 参数 类型 是否必传 名称及描述 code number 是 状态码 message string 是 状态信息描述 data object 否 响应结果集 data.reportTemplateId number 否 报表订阅ID 示例： 请求路径：

示例： 请求路径： 请求参数： { "reportName": "TestReport9", "thisDate": "20221122 08:22:00", "sendType": 1, "sendFrequency": 1, "oneTimeStartTime": "20221101 17:01:05", "oneTimeEndTime": "20221122 08:01:05", "email": "@qq.com", "chartData": { "domain": [ { "domainName": "test.ctyun.cn", "list": [ { "id": 3 } ] } ] } } 返回结果： { "code": 100000, "message": "success", "data": { "reportTemplateId": 272 } } 错误码请参考：参数code和message含义

本文介绍用户分析。 功能说明 用户分析可展示用户的区域分布、运营商分布、独立IP访问数。并展示每个区域/运营商的带宽、流量、连接数。 操作指引 进入【统计分析】【用户分析】功能模块，即可选择域名、时间范围进行查询。并可以切换带宽、流量、连接数等指标进行展示。如下图： 访问区域分布 根据用户所在区域，分别展示每个省份的带宽、流量、连接数，并在地图中用不同的颜色进行展示。 访问运营商分布 根据用户所属运营商，分别展示每个运营商的带宽、流量、连接数信息。 独立IP访问数 可展示独立IP访问数的趋势图，并展示独立IP访问峰值。

地区运营商 界面中展示的是您所选域名、运营商、地区的用量排名，默认按照峰值带宽降序排列，也可点击流量、并发连接数、连接数后面的箭头更改为使用流量、并发连接数、连接数排序。

参数 类型 是否必传 名称及描述 code int 是 状态码 message string 是 描述信息 result list< object> 否 统计结果 result[].rank int 否 排名 result[].channel string 否 域名 result[].uri string 否 uri值 result[].port string 否 url的端口 result[].protocol string 否 协议，合并协议时不返回 result[].request long 否 请求数 result[].flow long 否 流量

接口描述：调用本接口查询刷新任务额度 请求方式：get 请求路径：/refreshtask/queryrefreshtaskquota 使用说明： 单个用户一分钟限制调用10000次，并发不超过100 请求参数说明： 无 返回参数说明： 参数 类型 是否必传 名称及描述 code int 是 状态码 message string 是 描述信息 result object 否 返回结果数组 result.quotas list 否 每日配额使用信息 result.quotas[].domains list 否 域名列表,按配置分组，如果域名没有配置，将使用default的配额 result.quotas[].dirused int 否 每日刷新目录已使用条数 result.quotas[].dirmax int 否 每日刷新目录最大条数 result.quotas[].dirsurplus int 否 每日刷新目录剩余条数 result.quotas[].urlused int 否 每日刷新url已使用条数 result.quotas[].urlsurplus int 否 每日刷新url剩余条数 result.quotas[].urlmax int 否 每日刷新url最大条数 示例： 请求路径： 示例1： 请求： 返回结果： { "code": 100000, "message": "success", "result": { "quotas": [ { "urlused": 0, "dirused": 0, "urlmax": 10000000, "dirsurplus": 100000, "domains": [ "default" ], "urlsurplus": 10000000, "dirmax": 100000 } ] } } 错误码请参考：参数code和message含义

关于天翼云CDN服务协议的详细介绍。 天翼云CDN服务协议，详情请见：天翼云CDN服务协议。

关于天翼云CDN服务等级协议的详细介绍。 天翼云CDN服务等级协议，详情请见：天翼云CDN服务等级协议。

更新日期 更新内容 20220430 第一次正式发布。 本次更新说明如下： 官网正式上线API文档，包含：域名管理、证书管理、刷新预热、统计分析、屏蔽解封、日志下载、辅助工具等类别的API。 20220831 第二次正式发布。 本次更新说明如下： 上线账单服务API，包含：查询计费账单、查询资源包、查询开通服务基本信息、域名计费值查询。 20220930 第三次正式发布。 本次更新说明如下： 上线标签管理API，包含：新增标签、查看标签、删除标签、标签关联域名。 20221031 第四次正式发布。 本次更新说明如下： 上线报表管理API，包含：新增报表订阅、更新报表订阅、查询报表订阅详情、删除报表订阅。 20221130 第五次正式发布。 本次更新说明如下： 上线边缘脚本API，包含：创建或修改预部署环境脚本、查询预部署环境的编译结果、获取预部署节点VIP、查询预部署环境的边缘脚本配置、 预部署环境配置转生产、预部署环境配置回滚、删除脚本配置、查询预部署环境异常运行情况。 2023730 第六次正式发布。 本次更新说明如下： 上线日志配置相关API，包含：根据域名查询日志配置、查询日志配置ID列表、根据ID查询域名列表、根据ID查询日志配置。

接口描述：调用本接口将将预部署环境的脚本回滚成和生产环境相同的配置。 请求方式：post 请求路径：/icdn/udfscript/rollbackudfscriptfromproduction 使用说明：单个用户一分钟限制调用10000次，并发不超过100。 请求参数说明（json）： 参数 是否必填 参数类型 说明 示例 下级对象 domain 是 String 域名，有效且合法，域名必须属于当前账户下 ctyun.cn scriptname 是 String 函数脚本名，为264位的小写字母、数字、下划线组合，以小写字母、数字开头结尾 luatest 返回参数说明： 参数 参数类型 说明 示例 下级对象 statusCode Integer 状态码 100000 returnObj Object 返回对象 {} message String 结果简述 正确返回/参数不合法 error String 错误码 CDN200002 errorMessage String 错误详情 请求参数校验失败，参数scriptname为必填，且不能为空 示例： 请求路径： 请求参数： {     "domain":"ctyun.cn",     "scriptname":"luatest" } 返回结果： {     "statusCode":100000,     "message":"正确返回",     "returnObj":{     } } 错误码请参考：参数code和message含义

参数 类型 是否必传 名称 描述 reportTemplateId number 是 报表订阅ID

参数 参数类型 说明 示例 下级对象 statusCode Integer 状态码 100000 returnObj Object 返回对象 returnObj message String 结果简述 正确返回/参数不合法 error String 错误码 CDN200002 errorMessage String 错误详情 请求参数校验失败，参数domain为必填，且不能为空

接口描述：查询domain对应的预部署测试节点的有效VIP。 请求方式：post 请求路径：/icdn/udfscript/queryudfscripttestvip 使用说明：单个用户一分钟限制调用10000次，并发不超过100。 请求参数说明（json）： 参数 是否必填 参数类型 说明 示例 下级对象 domain 是 String 有效且合法的域名，该域名在当前账户下 ctyun.cn 返回参数说明： 参数 参数类型 说明 示例 下级对象 statusCode Integer 状态码 100000 returnObj Object 返回对象 returnObj message String 结果简述 正确返回/参数不合法 error String 错误码 CDN200002 errorMessage String 错误详情 请求参数校验失败，参数domain为必填，且不能为空 表 returnObj 参数 参数类型 说明 示例 下级对象 vips Array of Strings 边缘VIP数组 ["171.105.185.45","240e:951:2c10:600::3","240e:951:2c10:600::5"] 示例： 请求路径： 请求参数： {     "domain":"ctyun.cn" } 返回结果： {     "statusCode":100000,     "message":"正确返回",     "returnObj":{         "vips":[             "171.105.185.45",             "240e:951:2c10:600::3",             "240e:951:2c10:600::5"         ]     } } 错误码请参考：参数code和message含义

参数名 配置值 类型 后缀名 内容 flv,mp4 待改写PATH ^(/[^/]+/)(.)$ 目标PATH $scheme://host/$2 跳转状态码 302 优先级 10

参数 类型 是否必传 名称及描述 code int 是 状态码 message string 是 描述信息 result list< object> 否 返回结果数组 result[].areacode int 否 地区编码 result[].areacnname string 否 中文名称 result[].level int 否 区域级别

本文为您介绍UDFScript内置函数的分类和各个分类包含的函数。 函数分类 函数 lua原生函数 提供全局、math、os、string、table五种lua函数库的函数。 请求处理相关函数 ctyun.req.starttime、ctyun.req.rawheader、ctyun.req.getmethod、ctyun.req.getheaders、ctyun.req.setheader、ctyun.req.getfullbodydata、ctyun.req.getoriginurl、ctyun.req.seturi、ctyun.req.geturiargs、ctyun.req.seturiargs、ctyun.req.setupstreamurl、ctyun.req.setcache、ctyun.req.enrollheaderback。 响应处理相关函数 ctyun.resp.getheaders、ctyun.resp.getcode、ctyun.resp.setheader、ctyun.resp.setlimitrate、ctyun.resp.setoutput、ctyun.resp.setcode、ctyun.resp.exit。 时间相关函数 ctyun.now、ctyun.time、ctyun.localtime、ctyun.utctime、ctyun.today、ctyun.updatetime、ctyun.cookietime、ctyun.httptime、ctyun.parsehttptime、ctyun.sleep。 编解码相关函数 ctyun.json.encode、ctyun.json.decode、ctyun.encodeargs、ctyun.decodeargs、ctyun.unescapeuri、ctyun.escapeuri、ctyun.decodebase64、ctyun.encodebase64。 加解密相关函数 ctyun.crc32long、ctyun.crc32short、ctyun.sha1bin、ctyun.md5、ctyun.md5bin、ctyun.hmacsha1。 正则表达式相关函数 ctyun.re.match、ctyun.re.find、ctyun.re.gmatch、ctyun.re.sub、ctyun.re.gsub。 访问远程数据相关函数 ctyun.queryremote、ctyun.querygetcache。 全局字典相关函数 ctyun.dict.set、ctyun.dict.get、ctyun.dict.delete、ctyun.dict.capacity、ctyun.dict.freespace。 异步处理相关函数 ctyun.thread.run。 其他功能函数 ctyun.getiplocation、ctyun.splitstring。

本文介绍网站提示证书存在风险的相关场景及解决方案。 背景说明 网站已经在天翼云CDN控制台开启了HTTPS功能，并配置对应证书，但是用户使用浏览器访问该网站时提示证书存在风险。本文主要介绍可能的原因及应对方案。 可能原因及方案 场景一：域名配置的对应证书已过期 处理方式：您可以前往CDN控制台更换新的证书。具体操作时，可先上传新的证书，再在【域名管理】中的【HTTPS配置】中选择新证书对应的备注名，单击【提交保存】即可。详情请见：新增证书，HTTPS配置。 场景二：配置了自签名HTTPS证书 自签名证书是由个人或企业自行签署的证书，而不是由受信任的证书机构签发的证书。此类证书容易被伪造、安全系数低、有效期不稳定，各大浏览器基本都不信任此类证书。 处理方式：通过正规证书机构购买相应证书，购买后到CDN控制台重新上传证书并关联对应域名。 场景三：系统时间错误 请检查浏览器系统时间是否准确。如果系统时间不在ssl证书开始截止日期之内，则可能导致浏览器提示ssl证书过期或不生效。 处理方式： 更新浏览器本地系统时间。 场景四：使用了过低的TLS版本 处理方式：天翼云默认开启了TLS 1.0/1.1/1.2/1.3，目前公认的安全性更高的协议是TLSv1.2和TLSv1.3，您可选择关闭TLS 1.0/1.1，只开启 TLSv1.2 和 TLSv1.3。

回源探测机制 CDN不会主动进行回源探测。如回到某个源站请求失败时，CDN不会将失败结果直接返回给客户端，而是会进行重试，通过重试来规避因源站不稳定带来的访问体验受损问题。如果某个源站在一定周期内失败次数超过一定阈值（阈值可配），则CDN会将该源站放入不可用列表，并持续一段时间（时长可配），直到该时长过后才将对应源站记录重新放回可用列表。即CDN可基于每个源站对请求的响应来判断源站是否可用。 对源站进行不可用判定时，与回源重试粒度相同，也分为两种，一种是基于源站记录来判断是否可用，即无论某个源站是域名还是IP，如果在一定周期内返回失败次数超过一定阈值，即认为该源站不可用；另外一种是基于具体IP，即如果某个源站是域名，只有该域名中所有IP不可用，才认为该源站不可用。CDN默认为基于源站记录来判断是否可用。