示例： 请求路径： 示例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 否 域名

本文解答CDN节点响应4XX状态码时是否计费的问题。 4XX状态码一般为客户端访问错误造成的特殊状态码，最常见的是403和404。404是指客户源站没有请求的资源，而403是指服务端主动拒绝客户端请求，一般是因为客户域名有配置防盗链、防攻击等策略，而用户请求命中相应鉴权策略导致。例如，客户域名为避免恶意访问行为，通常情况下会选择在CDN开启如Referer防盗链、IP黑/白名单、UA黑/白名单、URL鉴权等访问控制功能。此时请求一旦命中相应的403鉴权规则，CDN服务器端即会返回403或其他自定义的特殊状态码。正常情况下，404和403的访问均较少，且响应内容仅包含响应头部，产生的流量也较小。但特殊情况下，客户域名遭受恶意刷量或攻击时，CDN节点会收到大量命中403鉴权规则或源站不存在资源的访问请求，造成CDN节点大量响应403或404，从而产生对应日志及计费数据。因CDN节点在对用户请求进行鉴权以及响应4XX状态码时，确实有产生CPU和带宽资源消耗，故客户需要自行承担此情况下产生的流量带宽费用及可能的请求数费用。

参数名 说明 过期时间 对应状态码的过期时间，值为具体数字；单位可选择秒、分钟、小时、天。 状态码 需要缓存的特殊状态码，支持多个，使用逗号“,”分割；支持范围 3xx,4xx,5xx。 3xx：301、302等（不支持304）； 4xx：401、403、404、405、407、414等； 5xx：500、501、502、503、504、509、514等。

配置示例 示例一：配置黑名单 参数名 配置示例 IP黑白名单 开启 类型 黑名单：101.1.1.1 结果说明：当客户端IP地址为101.1.1.1，不允许访问该域名下的所有资源，响应403状态码。 示例二：配置白名单 参数名 配置示例 IP黑白名单 开启 类型 白名单：101.1.1.2 结果说明：只有客户端IP地址为101.1.1.2时，才能允许访问该域名下的所有资源。

参数 参数类型 说明 示例 下级对象 info String 异常内容 601: No such API: ctyun.resp.setoutput123 time String 运行异常的时间 20230207T15:43:53+08:00 rip String 下发机器 171.105.185.45

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

参数 参数类型 说明 示例 下级对象 scriptname String 函数名 luatest scriptcontent String 函数内容 ctyun.resp.setoutput('Hello World hmy')

功能 说明 天翼云CDN支持URL刷新、目录刷新、正则刷新三种方式。不同刷新方式实现机制稍有不同，但最终都能确保用户访问时获得最新的内容。常用于客户对源站内容做更新后，需要CDN节点上对该内容做同步更新。 执行预取请求后，节点自动触发向源站请求内容并缓存，完成预取之后，节点缓存的是源站最新的内容。此时，如果客户端向CDN节点请求内容，节点会响应缓存的内容给用户。常用于热门文件发布或是大型推广活动前做内容预取，可以降低热点文件发布后源站的回源压力，提升缓存命中率，优化首批用户的访问体验。 支持客户自定义查询刷新或预取任务的执行状态。

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

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

参数 是否必填 参数类型 说明 示例 下级对象 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含义

本文介绍回源HOST带端口功能及其配置说明。 功能介绍 当源站绑定了多个域名，且源站服务运行在非80/443端口（比如8080）时，开启回源HOST带端口功能，回源时可以在回源HOST中带上具体的端口（如test.ctyun.cn:8080），精准找到源站服务。 注意事项 1. 新增域名，默认开启回源HOST带端口功能，如需关闭，请在域名新增完成后编辑域名关闭功能。 2. 回源HOST带端口功能开启后，默认携带所有非80/443的端口。跟随请求端口回源关闭时回源HOST默认带除了80、443外的回源端口；跟随请求端口回源开启时，回源HOST默认带除了80、443外的请求端口。 配置说明 1. 登录++CDN控制台++。 2. 单击左侧导航栏【域名管理】【域名列表】。 3. 在【域名列表】页面，找到目标域名，单击【操作】列的【编辑】。 4. 单击右侧【回源配置】。 5. 开启/关闭【回源HOST带端口】功能。 6. 单击【保存】，完成配置。 参数名 说明 回源HOST带端口 关闭时，回源HOST不携带端口。 开启时，回源HOST携带非80/443的回源端口回源。

预部署回滚 如您在灰度环境对业务脚本进行了修改后，又想将灰度环境的业务脚本回滚成与生产一致的业务脚本内容，可单击操作列的【预部署回滚】来实现该功能。 注意 1. 只有已启用状态的域名才可以进行业务脚本的新增、编辑、预部署转生产、预部署回滚等操作。 2. 删除域名时会将域名绑定的业务脚本一同起删除。

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

注意事项 请确保上传的证书还在有效期范围内。 目前只支持PEM格式，其他格式客户可自行转换，或提交工单向天翼云客服咨询推荐的转换站点。

项目 描述 语法 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()

参数 类型 是否必传 名称及描述 code int 是 状态码 message string 是 描述信息 result list< string> 否 绑定证书的域名列表

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

参数 类型 是否必传 名称及描述 code int 是 状态码，成功100000 message string 是 描述信息，成功返回success，其他返回异常信息描述 verifyresult boolean 否 域名归属权校验结果，true（成功），false(失败)

ctyun.querygetcache 函数信息详见下表： 项目 描述 语法 res, err ctyun.querygetcache(cachehost, cacheurl, cachemode, ttl, uri?, args?, timeouts?) 作用 回源拉取文件并缓存，得到响应内容可编辑。如m3u8改写，请求得到响应体，使用Lua脚本对响应体进行编辑后，重新计算ContentLength头部，调用ngx.print() 响应客户端经过处理后的响应。 入参 cachehost: 缓存host。示例：ctyun.cn。 cacheurl: 缓存url。示例：/static/origin.m3u8。 cachemode: 固定缓存时间/跟随源站缓存（定值 "fixed" / “follow”）。默认为fixed, 非合法输入初始化为默认值。 ttl: 缓存时间，单位秒。如果是固定缓存，设置缓存多久； 如果跟随源站也可以设置默认值（秒)。 uri：请求uri，缺省为当前的请求uri。示例：/static/origin.m3u8。 args：请求参数，缺省为当前的请求参数，支持luastring和luatable两种格式。示例：a1&b2或者{a1,b2}。 timeouts：超时时间，array table格式。分别为connecttimeout、sendtimeout、readtimout，单位ms。缺省为15000 60000 60000。示例：{15000, 15000, 15000}。 返回值 res：响应结果，luatable类型，{ status, headers, body }。 err：错误信息。 示例： reasonml local res, err ctyun.querygetcache("ctyun.cn", "/static/origin.m3u8", "fixed", 86400, "/static/origin.m3u8", "a1&b2", {15000, 15000, 15000}) if err then return end headers for k, v in pairs(res.headers) do ctyun.resp.setheader(k, v) end status ctyun.resp.setcode(res.status) local status res.status if status > 299 or status < 200 then ctyun.resp.setoutput(res.body) end process body local body res.body if body then 对响应的处理, processbody仅用于说明 body processbody(body) 重写ContentLength响应头，输出响应 ctyun.resp.setheader("ContentLength",

名称 描述 是否必选 示例 ContentType 消息体的类型（格式）。推荐用户使用默认值application/json，有其他取值时会在具体接口中专门说明。 是 application/json ctyuneoprequestid 流水号（32位随机数） 是 0ffb9b07d5a84e19b3ce12dfb9705a1d EopAuthorization EopAuthorization 是 4a4bdc57e06542199b5f98d4cd107be2 Headersctyuneoprequestid;eopdate Signatureb2WEo4nh9ewn6SWOP0ii5g8L0z9CT5gprpDWntlCX9I Eopdate 时间，15分钟有效期(实际传时间为北京东八区UTC+8时间。TZ仅为格式，非UTC时间。) 是 20221107T093029Z

运营商 运营商编码（string型） 中国电信 001 中国联通 002 中国移动 003 中国铁通 004 教育网 005 鹏博士 006

功能 说明 为域名绑定标签，方便您对域名进行分组管理。 当标签不再适用于管理和检索域名时，可以将标签和域名进行解绑。 在域名列表中，通过标签快速筛选域名，进行分类管理。 在CDN控制台统计分析的用量查询和热门分析页面中，通过标签快速筛选出某类域名的各类监控数据（如：流量、带宽等）。

本文介绍Common Name白名单功能及其配置说明。 功能介绍 开启Common Name白名单功能后，CDN节点以HTTPS协议与源站建连时，将会对请求的SNI和源站返回证书的Common Name进行校验。若请求SNI（Server Name Indication）是domain1，和源站返回证书的Common Name domain2不一致时（如下图），将会无法建连。此时如果将domain2添加至CDN节点的Common Name白名单中，将能成功建连。 配置说明 该功能暂不支持客户自助配置，如需使用，请通过提交工单给天翼云客服，由其人工操作开启。提交工单时，您需要提供以下信息： 参数名 说明 源站证书的Common Name白名单列表 支持多个域名，域名之间请使用英文逗号分隔。

本文介绍全局task脚本的添加、查看、编辑、删除等操作。 全局task脚本是客户粒度的，客户的多个域名可共享全局task脚本。在添加全局task脚本前，需确保已添加全局字典。 注意 UDFScript目前处于邀测期间，客户控制台默认不开放自助，如有需要，请 添加全局task脚本 1. 登录CDN控制台。 2. 单击左侧导航栏【UDFScript】【全局task脚本】。 3. 单击全局task脚本首页右上角的【添加全局task脚本】来添加全局task脚本，最多可添加3个全局task脚本。 注意 添加全局task脚本前必须得先添加全局字典。 4. 进入添加全局task脚本的页面后，可输入脚本名称和脚本内容，脚本名称为264位的小写字母、数字、下划线的结合，开头结尾只允许小写字母和数字，多个全局task脚本的名称不允许相同。单击【查看已创建的全局字典】可查看已创建的全局字典名称和大小，供编写全局task脚本内容的时候参考。脚本名称和脚本内容确认无误后，单击【确认提交】进行部署，单击【取消】可返回全局task脚本的首页。 5. 每个全局task脚本是独立部署，这个不同于全局字典，全局字典是多个一起部署的。提交部署后，在全局task脚本的首页可看到所有已提交部署的全局task脚本列表及部署状态。全局task脚本的部署状态有等待部署、部署中、部署成功、部署失败四种，部署失败的可单击操作列的【失败重试】重新部署。