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

示例： 请求路径： 示例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含义

参数 类型 是否必传 名称及描述 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含义

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

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

参数 类型 是否必传 名称及描述 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。

参数名 类型 是否必填 名称 说明 toprank int 是 倒序取toprank条数据 取值区间[1, 100] starttime int 是 开始时间戳 起始时间，时间戳(秒) endtime int 是 结束时间戳 结束时间，时间戳(秒) domain list< string> 是 域名列表 可多个域名，作为统计筛选项 sorttype string 否 排序指标 flow或者request，作为统计筛选项，不传默认flow

示例： 请求路径： 示例1： 请求参数： { "starttime": 1662706800, "endtime": 1662708000, "domain": [ "a.ctyun.cn", "b.ctyun.cn" ], "httpProtocol": 1 } 返回结果： { "code": 100000, "message": "success", "result": [ { "pvcount": 3020171, "timestamp": 1662706800 }, { "pvcount": 2993556, "timestamp": 1662707100 }, { "pvcount": 2943798, "timestamp": 1662707400 }, { "pvcount": 2879866, "timestamp": 1662707700 }, { "pvcount": 2865421, "timestamp": 1662708000 } ] } 错误码请参考：参数code和message含义

参数名 类型 是否必填 名称 说明 starttime int 是 开始时间戳 起始时间，时间戳(秒)。 endtime int 是 结束时间戳 结束时间，时间戳(秒)。 isp list< string> 否 运营商编码列表 运营商编码，不传默认所有运营商，可多个运营商编码，作为统计筛选项，

参数 类型 是否必传 名称 描述 starttime int 是 开始时间戳 起始时间，时间戳(秒)。 endtime int 是 结束时间戳 结束时间，时间戳(秒)。 domain string 是 域名

接口描述：调用本接口创建解封任务 请求方式：post 请求路径：/allowtask/createallowtask 使用说明： 单个用户一分钟限制调用10000次，并发不超过100 请求参数说明： 参数 类型 是否必传 名称 描述 ::::: choose int 是 解封方式 0(url方式解封)；1(submitid方式解封) urls list 否 封禁的URL列表 choose取值为0时必填，单次最多200条 submitids list 否 封禁的submitid列表 choose取值为1时必填，单次最多10条 返回参数说明： 参数 类型 是否必传 名称及描述 :::: code int 是 状态码 message string 是 描述信息 submitid string 否 解封提交id result list 否 返回结果 result:allowid string 否 解封任务id result:forbidid string 否 封禁任务id result:forbidurl string 否 封禁任务的url 示例： 请求路径： 示例1： 请求参数： { "choose": 0, "urls": [ " ] } 返回结果： { "code": 100000, "message": "success", "submitid": "16641625802", "result": [ { "allowid": "16641625802", "forbidurl": " "forbidid": "166415928031" } ] } 错误码请参考：参数code和message含义

项目 描述 语法 value, flags, stale DICT:getstale(keyname) 作用 与get类似，但返回的是过期的值，过期的值无法保证一直存在，如当内存不够时会被自动清理。 入参 keyname：要获取内容的键值。 返回值 value: key对应的value。 flags: 用来获取是否对用户做了标识，一般在set时都会加入标识，如果没有，则默认为0。 stale: 代表获取的value是否已经过期，如果是，则返回true。

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

参数 类型 是否必传 名称及描述 code int 是 状态码 message string 是 描述信息 result dict 否 返回结果 result.max int 否 每日屏蔽最大条数 result.used int 否 每日屏蔽已使用条数 result.surplus int 否 每日屏蔽剩余条数 result.singlecommitmax int 否 每次提交屏蔽最大条数

本文介绍设置Apache缓存策略的方法。 免责声明： 本文档包含第三方产品信息，该信息仅供参考。 背景说明 本文主要介绍Apache服务器的缓存策略配置方法，如果源站使用的是Apache，可参考此文进行设置。 详细信息 Apache设置缓存策略的具体方法有两种：使用modheaders模块或modexpires模块。 1. modheaders模块配置 使用modheaders配置源站响应缓存策略可按如下步骤： 1）确保apache安装了modheaders模块。 2）在httpd.conf 中设置LoadModule headersmodule modules/modheaders.so。 3）使用header set配置cachecontrol。 示例如下： 策略 示例 设置一个月 Header set CacheControl "maxage2592000″ 设置一周 Header set CacheControl "maxage604800″ 设置不缓存 Header set Expires "Mon, 01 Jan 2000 10:00:00 GMT" Header set CacheControl "nocache" Header set Pragma "nocache" 2. modexpires模块配置 使用modexpires模块配置源站响应缓存策略： 主要有如下三条指令： ExpiresActive指令：打开或关闭产生Expires和CacheControl标签的功能。 ExpiresByType指令：指定MIME类型文档的过期时间，例如text/html文档。 ExpiresDefault指令：所有文档的默认过期时间。 示例如下： ExpiresActive On：开启modexpires功能。 ExpiresDefault "access plus 1 months"：默认的过期时间是1个月。 ExpiresByType image/ "access plus 1 years"：图片的文件类型缓存时间为1年。 ExpiresByType text/ "access plus 1 years"：text类型缓存时间为1年。 ExpiresByType application/ "access plus 60 minutes"：application文件类型缓存60分钟。 其中，各种时间的表达方式有： 表达式 说明 access plus 1 years 过期时间设置为，访问开始计算的一年后。 now plus 30 days 当前时间的30天后。 modification plus 12 hours 过期时间设置为，文件最后修改时间的12小时后。 A2592000 过期时间设置为，访问开始计算的2592000秒后，即一个月后。 M86400 过期时间设置为，文件最后修改时间的86400秒后，即一天后；该方式只对静态文件起作用，脚本生成的动态页面不起作用。

类型 描述 包含域名增删改查等API 包含证书增删查等API 包含刷新预热任务创建、查询等API 包含带宽、流量、请求数、状态码等统计分析数据查询API 包含封禁解封任务创建、查询等API 包含查询ip列表、查询运营商等API 包含账单、用量查询等API 包含查询下载离线日志、查询日志配置等API 包含标签新增、查询、删除、标签关联域名的查询等API 包含运营报表的订阅、更新、查询、删除等API 包含边缘脚本的新增、更新、删除、灰度转生产、灰度配置回滚、查询有效测试VIP、查询脚本配置、编译情况、运行出错情况等API

示例： 请求路径： 示例1： 请求： 返回结果： json { "code": 10000, "message": "success", "total": 1, "page": 1, "pagesize": 1, "result": [ { "submittime": "20180801 12:00:00.000000", "type": "url", "url": " "status": "completed" } ] } 错误码请参考：参数code和message含义

参数 类型 是否必传 名称及描述 code int 是 状态码 message string 是 描述信息 result object 否 返回结果 result.quotas list< object> 否 每日预取配额使用信息 result.quotas[].used int 否 每日预取已使用条数 result.quotas[].surplus int 否 每日预取剩余条数 result.quotas[].max int 否 每日预取最大条数 result.quotas[].domains list< string> 否 预取的域名列表，按配置分组，如果域名没有配置，将使用default的配额 result.concurrencys list< object> 否 每次提交预加载最大条数信息 result.concurrencys[].singlecommitmax int 否 预取并发数 result.concurrencys[].domain string 否 域名

参数 类型 是否必传 名称 描述 logformatid long 是 日志配置ID

接口描述：调用本接口根据日志配置ID查询域名列表 请求方式：get 请求路径：/usercustomlogconfig/listchannel 使用说明： 单个用户一分钟限制调用10000次，并发不超过100 请求参数说明： 参数 类型 是否必传 名称 描述 logformatid long 是 日志配置ID 返回参数说明： 参数 类型 是否必传 名称及描述 code int 是 状态码，成功100000 message string 是 描述信息，成功返回success，其他返回异常信息描述 data object 否 返回结果 data.domain list 否 域名列表 示例： 请求路径： 示例1： 请求： 返回结果： json { "code": 100000, "message": "success", "data": { "domain": [ "test.ctyun.cn" ] } } 错误码请参考：参数code和message含义

参数 类型 是否必传 名称及描述 code int 是 状态码，成功100000 message string 是 描述信息，成功返回success，其他返回异常信息描述 data object 否 返回结果 data.logformatid list 否 日志配置ID列表

接口描述：调用本接口查询域名的IP地址，及ip对应的区域，运营商信息 请求方式：post 请求路径：/auxiliarytools/queryvipsdetailbydomain 使用说明： 单个用户一分钟限制调用10000次，并发不超过100 请求参数说明（json）： 参数 类型 是否必传 名称 描述 ::::: domain list 是 域名列表 最多支持５个 返回参数说明： 参数 类型 是否必传 名称及描述 :::: code int 是 状态码 message string 是 描述信息 result list 否 返回结果数组 result[].domain string 否 域名 result[].details list 否 域名对应的vip列表信息 result[].details[ ].vips string 否 vip信息，多个用逗号“,”分割 result[].details[ ].cityName string 否 城市名称 result[].details[ ].nodename string 否 节点名称 result[].details[ ].provinceName string 否 省份名 result[].details[ ].ispName string 否 运营商名称 示例： 请求路径： 请求参数： { "domain":[ "test.ctyun.cn" ] } 返回结果： { "code": 100000, "message": "success", "result": [ { "domain": "test.ctyun.cn", "details": [ { "vips": "xx.xx.xx.xx,xx:xx:xx:xx::", "cityName": "呼和浩特市", "nodename": "xxx1", "provinceName": "内蒙古自治区", "ispName": "中国电信" }, { "vips": "xx.xx.xx.xx,xx:xx:xx:xx::", "cityName": "通州区", "nodename": "xxx2", "provinceName": "北京市", "ispName": "中国电信" } ] } ] } 错误码请参考：参数code和message含义

参数 是否必填 参数类型 说明 示例 下级对象 vips 是 string vip列表，最多支持10个ip查询，多IP使用逗号分隔。若超过限制，则只返回最前面的10个。 1.1.1.1

接口描述 ：调用本接口查询所有的运营商信息。 请求方式 ：get 请求路径 ：/auxiliarytools/queryisplist 使用说明： 单个用户一分钟限制调用10000次，并发不超过100 请求参数说明： 无 返回参数说明： 参数 类型 是否必传 名称及描述 :::: code int 是 状态码 message string 是 描述信息 result list 否 返回结果数组 result[].ispid int 否 运营商ID result[].ispcode int 否 运营商编码 result[].ispcnname string 否 运营商中文名称 result[].ispenname string 否 运营商英文名称 result[].ispabbr string 否 运营商缩写 示例： 请求路径： 示例1： 请求： 返回结果： { "code": 100000, "message": "success", "result": [ { "ispid": 10000, "ispabbr": "CTC", "ispcode": 1, "ispenname": "DianXin", "ispcnname": "中国电信" }, { "ispid": 10001, "ispabbr": "CUC", "ispcode": 2, "ispenname": "LianTong", "ispcnname": "中国联通" }, { "ispid": 10002, "ispabbr": "CMC", "ispcode": 3, "ispenname": "YiDong", "ispcnname": "中国移动" }, { "ispid": 10003, "ispabbr": "CRC", "ispcode": 4, "ispenname": "TieTong", "ispcnname": "中国铁通" }, { "ispid": 10004, "ispabbr": "EDU", "ispcode": 5, "ispenname": "JiaoYuWang", "ispcnname": "教育网" }, { "ispid": 10005, "ispabbr": "PBS", "ispcode": 6, "ispenname": "PengBoShi", "ispcnname": "鹏博士" }, { "ispid": 10006, "ispabbr": "other", "ispcode": 100, "ispenname": "other", "ispcnname": "其他" }, { "ispid": 10007, "ispabbr": "DX", "ispcode": 7, "ispenname": "DuoXian", "ispcnname": "多线" }, { "ispid": 10008, "ispabbr": "BGP", "ispcode": 8, "ispenname": "BGP", "ispcnname": "BGP" }, { "ispid": 10009, "ispabbr": "gwbn", "ispcode": 9, "ispenname": "GreatWallBroadbandNetwork", "ispcnname": "长城宽带" }, { "ispid": 10010, "ispabbr": "cbn", "ispcode": 10, "ispenname": "ChinaBroadcastNetwork", "ispcnname": "广电网络" } ] } 错误码请参考：参数code和message含义

本文简述UDFScript的组成及在客户控制台的界面入口。 重要说明 注意 UDFScript目前处于邀测期间，客户控制台默认不开放自助，如有需要，请 UDFScript由全局字典、全局task脚本、业务脚本三部分组成，如下图： 全局字典：用来定义一块共享内存区域，全局task脚本或业务脚本可以从全局字典中读取数据，也可以把结果保存到全局字典中。 全局task脚本：用于定义后台周期性任务（非客户端请求触发），比如周期性同步远端配置数据到本地全局字典中。 业务脚本：可以快速自定义控制台未支持的功能，例如定制化鉴权、请求头改写等。 您可以仅使用业务脚本实现简单的自定义功能，也可以把全局字典、全局task脚本、业务脚本三个结合起来使用，自定义更强大的功能。

项目 描述 语法 from, to, err ctyun.re.find(subject, regex, options?) 作用 正则匹配，返回匹配子字符串的开始索引 ( from) 和结束索引 ( to)。 入参 subject：待匹配字符串。 regex：正则表达式。 options：控制如何执行匹配操作。 返回值 from：匹配子字符串的开始索引，未找到匹配项时值为nil。 to：匹配子字符串的结束索引。 err：描述错误信息的字符串。

参数 类型 是否必填 名称及描述 name string 否 请求头名称，长度限制50个字符 value string 否 请求头值，长度限制100个字符

ctyun.getfilesize 函数信息详见下表： 项目 描述 语法 length, err ctyun.getfilesize(cachehost, cacheurl, requesturl) 作用 根据缓存key查询文件大小。以缓存key为准，若缓存不存在以requesturl回源查询。 入参 cachehost: string。必填，缓存host。 cacheurl: string。必填，缓存url。 requesturl：string。必填，文件的请求url，格式以"/"开头（不含scheme和host）。 返回值 1.文件长度。 2.错误信息。 示例： hsp local length, err ctyun.getfilesize("ctyun.cn", "/test.m3u8", "/test.m3u8") if err then ctyun.log("get file size err: ", err) end ctyun.worker.exiting 函数信息详见下表： 项目 描述 语法 isexiting ctyun.worker.exiting() 作用 判断Nginx的worker进程是否退出。 入参 无。 返回值 isexiting：布尔值，指示worker进程是否退出。 示例： applescript 例如在定时任务中, 检测到nginx进程退出则停止定时任务的执行 local isexiting ctyun.worker.exiting() if isexiting then return end ctyun.worker.count 函数信息详见下表： 项目 描述 语法 number ctyun.worker.count() 作用 获取当前Nginx worker进程的数量，即Nginx配置中workerprocesses的值。 入参 无。 返回值 number：当前Nginx worker进程的数量。 示例： applescript local processnumber ctyun.worker.count()