变量名 变量说明 示例 arg参数名 url中的某个具体参数的值。 比如：请求为： http参数名 某个请求头xxx的值。 比如：请求为： H "test: hello" H "headacc: 222"。 调用ctyun.var("httptest")返回“hello”。 调用ctyun.var("httpheadacc") 返回“222”。 注意： 如果xxx有破折号，通过var调用时，用下划线代替。 cookiexxx 请求cookie头中的name值。 使用方式同上。 scheme 请求使用的Web协议，“http” 或 “https”。 ctyun.var("scheme") 返回http。 serverprotocol 服务器的HTTP版本，通常为 “HTTP/1.0” 或 “HTTP/1.1”。 ctyun.var("serverprotocol") 返回HTTP/1.1。 timeiso8601 服务器时间的ISO 8610格式。 ctyun.var("timeiso8601") 返回 20220714T11:13:56+08:00。 timelocal 服务器时间。 ctyun.var("timelocal") 返回14/Jul/2022:11:13:56 +0800。 timehttp 服务器时间的http表示法。 ctyun.var("timehttp") 返回 Thu, 14 Jul 2022 03:13:56 GMT。 host 客户端请求的域名。 ctyun.var("host") 返回ctyun.cn。 requesturi 用户原始请求url包括查询参数。 比如：客户端发送请求uri为： /%E4%BD%A0%E5%A5%BD?tt123。 ctyun.var("requesturi") 返回/%E4%BD%A0%E5%A5%BD?tt123。 uri requesturi变量中不带查询参数部分，且进行urldecode。 比如：客户端发送请求uri为： /%E4%BD%A0%E5%A5%BD?tt123。 ctyun.var("uri") 返回 /你好。 querystring 查询参数, requesturi的参数部分。 比如：请求uri为： /hello?tt123&t2%E4%BD%A0%E5%A5%BD。 ctyun.var("querystring") 返回 tt123&t2%E4%BD%A0%E5%A5%BD。 requestmethod HTTP请求方法，通常为"GET"或"POST"等。 ctyun.var("requestmethod") 返回GET。 remoteaddr 返回客户端ip。 ctyun.var("remoteaddr") 返回172.21.51.44。 remoteport 客户端端口号。 ctyun.var("remoteport") 返回38966。 serveraddr 服务端ip。 ctyun.var("serveraddr") 返回172.21.51.88。 serverport 服务端端口号。 ctyun.var("serverport") 返回80。 isargs 是否有请求参数。 ctyun.var.isargs 返回 "?"或者空字符串。 args 请求参数。 ctyun.var.args 返回 "a1&b2&c3"。

函数库 函数名 全局 assert、error、ipairs、next、pairs、pcall、select、tonumber、tostring、type、unpack、xpcall。 math abs、acos、asin、atan、atan2、ceil、cos、cosh、deg、exp、fmod、floor、frexp、huge、ldexp、log、log10、max、min、modf、pi、pow、rad、random、 sin、sinh、sqrt、tan、tanh。 os clock、difftime、time。 string byte、char、find、format、gmatch、gsub、len、lower、match、reverse、sub、upper。 table insert、maxn、remove、sort。 bit arshift、band、bnot、bor、bswap、bxor、lshift、rol、ror、rsh。

本文介绍用户分析可支持的维度和查询方法。 分析维度说明 用户分析模块，支持客户对访问用户区域分布、访问运营商分布、独立IP访问数等维度，按域名、时间条件进行查询，并基于带宽、流量、访问次数、独立IP访问峰值(1小时统计)、日活跃IP总量进行分析。同时支持数据的下载。 访问用户区域分布 访问用户区域分布支持客户按域名、时间等搜索条件，对用户所在区域基于带宽、流量、访问次数进行分析。 访问运营商分布 访问运营商分布支持客户按域名、时间等搜索条件，对用户所属运营商基于带宽、流量、访问次数进行分析。 独立IP访问数 独立IP访问数支持客户按域名、时间等搜索条件，对独立IP访问峰值(1小时统计)、日活跃IP总量进行分析。

本文通过图文说明证书查看路径和证书详情。 功能介绍 客户完成证书新增后，可通过客户控制台界面查看已添加的证书及其详细信息，包括：证书备注名、证书通用名称、证书品牌、证书状态、颁发时间、到期时间、创建时间、更新时间以及可支持的相关操作等信息。 操作步骤 1. 登录CDN控制台。 2. 在【证书管理】页面，可以看到证书列表，含历史添加过的所有证书。 3. 选定目标证书，在操作列单击【详情】，即可查看证书详情信息。

参数 说明 示例 任务类型 触发云备源的任务类型，分为即时和定时两种： 1.如为即时类型，请说明任务的具体开始时间。 2.如为定时类型，请说明任务的开始时间和结束时间，以及任务间隔周期，间隔周期支持按周、日、小时来进行设置，最小周期为1小时。 1.即时任务示例： 按如下时间开始： 1）开始时间：2023年11月28日17时00分00秒。 效果：该任务于2023年11月28日17时00分00秒开始执行文件同步，后续不再执行。 2.定时任务示例： 按如下周期执行任务： 1）开始时间：2023年11月28日17时00分00秒。 2）结束时间：2025年11月28日17时00分00秒。 3）间隔周期：每日。 效果：该任务于2023年11月28日17时00分00秒开始执行同步，后续会在每天17时00分00秒自动同步新文件至备源。 备份入口地址 待备份内容的入口地址。 例如： 备份层级 备份地址的层级深度。 例如：3，表示从入口地址往下同步三层。 备份域名 待备份网站中需备份内容对应域名。 www.ctyun.cn，img1.ctyun.cn，img2.ctyun.cn，支持多个；默认为入口地址对应域名。 备份资源类型 待备份网站中的文件资源类型。 html、htm、jpeg，支持多个；默认为html、htm、shtml、js、css、jpg、jpeg、png、gif、svg、ico、ttf、woff2、asp、jsp、php、perl、cgi。如需备份无后缀名的文件，请单独说明。 备源地址 媒体存储完整域名，一般由bucket+endpoint组成。 test.jx6oss.ctyunxs.cn，其中test为bucket名称。 是否存在同名文件更新 若存在同名文件更新，请给出对应文件后缀或其他特征。 是，html文件后缀。 备份文件量级 指同步任务需要备份的文件量级大小。 20GB。 AK、SK 如备源的媒体存储桶是私有桶，则需同时提供AK、SK信息。 AK：abc123；SK：xxxxxxx。

本文介绍远程同步鉴权的适用场景和配置方法。 功能介绍 可以通过配置远程同步鉴权功能，在CDN节点收到用户请求后，将请求转发回提前设定的鉴权源站，在源站鉴权许可后，CDN节点才给用户返回对应内容，从而实现用户鉴权规则由源站全权定义。 适用场景 如果希望鉴权规则足够灵活，且能够随时变更而无需与CDN强绑定，则可使用远程同步鉴权功能。 注意事项 1. 远程同步鉴权功能开启后，每个用户请求均会转发回鉴权源站进行鉴权，请确保鉴权源站可承受对应并发量，并可快速返回鉴权结果。 2. 该功能开启后，因为需要等待鉴权源站响应结果，会造成一定的响应时延，建议对时延不敏感的业务使用，如大文件下载等场景。 配置说明 该功能暂不支持客户自助配置，如需使用，请通过提交工单给天翼云客服，由其人工操作开启。 提交工单时，请您提供如下信息： 参数名 说明 鉴权源站 鉴权源站服务器地址，可为IP或域名。支持多个源站，多个源站之间是一主多备关系。 鉴权uri 鉴权请求使用的uri。支持使用用户原始uri请求；支持基于用户原始uri请求做修改和替换。 鉴权参数 鉴权请求使用？后的参数。支持使用用户原始请求参数；支持在用户原始请求参数基础上做增删改。 鉴权请求头 鉴权请求使用的请求头。支持使用用户原始请求头；支持在用户原始请求头基础上做增删改。 鉴权协议+端口 回源鉴权协议和鉴权端口。鉴权协议支持http/https；鉴权端口支持任意端口。 鉴权超时是否通过 鉴权服务时间超时时，是否认为鉴权通过。 鉴权出错是否通过 鉴权服务出错，例如返回5xx时，是否认为鉴权通过。 鉴权规则 什么情况下认为源站鉴权通过： 1.支持基于鉴权源站状态码来设定，可设置黑名单或白名单，例如仅设置403状态码为鉴权不通过，其他状态码放行；或设置仅200状态码为鉴权通过，其他状态码不通过。支持设置多个状态码。 2.支持基于鉴权服务器返回的json串内容做鉴权，需给出明确的鉴权是否通过的特征信息。 3.支持基于响应body鉴权，状态码鉴权通过时，如果有开启“基于响应body鉴权”，还会结合响应body的内容最终判断是否鉴权通过。 除上述必须参数外，该功能相关默认参数如下，如需变更，请在提交工单时一并说明： 参数名 说明 鉴权源站重试状态码 鉴权源站响应状态码符合某个条件时，CDN做鉴权重试；默认情况下源站超时或返回5xx时，CDN进行重试。 鉴权方法 回源鉴权时的请求方法；支持GET/POST/OPTIONS，默认为GET。 鉴权超时时间 鉴权服务超时时间，默认为3s。 鉴权请求连接池大小 连接鉴权服务端的连接池大小，默认为1000。 连接空闲超时时间 超过一定时间没有请求到来，则自动断开连接，避免过多连接，超时时间默认为10s。

参数 说明 限制带宽值 提供需要限制的总带宽大小。 限速时段 可选择全天生效或者固定时段生效。 限制策略 带宽超过限速值后处理方式，可选择单链接限速/拒绝/重定向。选择单链接限速时，所有用户的请求都会按该值来限速；选择拒绝时，超出带宽上限的部分用户请求会被拒绝；选择重定向时，超出带宽上限的部分用户请求会被302重定向至新的地址。 限制策略配置 1.限制策略选择单链接限速，则提供对应的限制值。 2.限制策略选择拒绝，默认拒绝响应403状态码，也可自定义。 3.限制策略选择重定向，则需提供重定向状态码及重定向地址。

本文主要介绍URL鉴权功能。 功能介绍 默认情况下在CDN分发的内容大部分都是公开资源，用户可以直接请求URL获取。为了防止站点资源被恶意下载或者非法盗用，导致产生不必要的带宽浪费，您可以在天翼云CDN上配置URL鉴权功能。配置URL鉴权后，CDN会对加密串及时间戳进行校验，从而有效地保护用户站点资源。 适用场景 需要对站点资源限制用户访问，避免资源被恶意下载或者非法盗用场景。 注意事项 1. 配置URL鉴权需要客户端与CDN配合一起开启。 2. 配置鉴权后，用户将携带鉴权参数访问，建议缓存策略修改为忽略鉴权参数进行缓存，否则将增大回源概率。修改缓存策略文档详情请见：缓存key设置。 3. 如果您的鉴权URL中含有中文或特殊字符，需先进行URL编码（即Encode）后使用。 配置说明 1. 登录CDN控制台。 2. 单击左侧导航栏【域名管理】【域名列表】。 3. 在【域名列表】页面，找到目标域名，单击【操作】列的【编辑】。 4. 单击右侧【访问控制】。 5. 在【URL鉴权】模块，开启功能。 6. 设置鉴权类型，并输入对应详细配置信息。 7. 单击【保存】，完成配置。 天翼云提供三种鉴权方式供您参考配置，详细的鉴权原理及配置说明详情请见： 鉴权方式A 鉴权方式B 鉴权方式C

本文介绍IPv6功能和配置规则。 功能介绍 天翼云CDN节点已经支持接收IPv6协议的请求，开启IPv6后，当您的用户处于IPv6环境，客户端可以通过IPv6协议访问天翼云CDN节点。 配置说明 新增域名： 1. 登录CDN控制台。 2. 单击左侧导航栏【域名管理】【域名列表】，单击【添加域名】。 3. 添加域名时，IPv6开关默认开启，如您不需要IPv6可选择关闭。 修改IPv6解析： 1. 登录CDN控制台。 2. 单击左侧导航栏【域名管理】【域名列表】。 3. 在【域名列表】页面，找到目标域名【IPv6解析】列。 4. 单击【】，弹出提示框。 5. 单击【确定】，完成配置。

本文介绍域名绑定标签的步骤。 功能介绍 标签为域名分类管理工具，通过标签功能对具有相同属性的域名进行分类管理。本文介绍如何为域名绑定标签，实现标记域名或为域名分组。 配置说明 1. 登录CDN控制台。 2. 单击左侧导航栏【域名管理】【域名列表】。 3. 在【域名列表】页面，找到目标域名，单击【标签】列的【新增】。 4. 在弹窗界面，选择标签，如“Businesssystem”标签组下面的“CRM”标签。 5. 核对【已选择标签信息】。 6. 确认无误后，单击【确定】提交。 注意事项 每个域名最多绑定20个标签。 标签选项不允许为空，否则将无法生效。

参数名 类型 是否必填 名称 说明 action string 是 操作参数 取值SetScdnBotInfo domainName string 是 域名 多个用英文逗号隔开，最多同时支持5个 enable string 是 开关类型 取值： 监控：LOG 拦截：BLOCK 关闭：CLOSE

接口描述：调用本接口查询证书详情信息。 请求方式：get 请求路径：/cert/querycertlist 使用说明： 单个用户一分钟限制调用10000次，并发不超过100。 请求参数说明（json）： 无 返回参数说明： 参数 类型 是否必传 名称及描述 code int 是 状态码 message string 是 描述信息 totalrecords int 否 总记录数 totalpage int 否 总页数 page int 否 当前页数 perpage int 否 每页显示的记录条数 result list 否 证书信息列表 result[].expires int 否 证书过期时间 result[].id int 否 证书id result[].issue int 否 证书颁发时间 result[].issuer string 否 证书颁发机构 result[].created int 否 证书创建时间 result[].name string 否 证书备注名称 result[].cn string 否 证书通用名称 result[].sans list 否 主题别名（Subject Alternative Names） 示例 请求路径： 请求参数 无 返回结果 { "code": 100000, "message": "success", "perpage": 1000, "totalrecords": 2, "totalpage": 1, "page": 1, "result": [ { "expires": 1911194411, "issue": 1595834411, "created": 1616749953, "name": "test9", "cn": "logging", "issuer": "Internet Widgits Pty Ltd", "sans": [ "", "" ] }, { "expires": 1911194411, "issue": 1595834411, "created": 1644474871, "name": "test056", "cn": "logging", "issuer": "Internet Widgits Pty Ltd", "sans": [ "", "" ] } ] } 错误码请参考：API返回参数code和message含义

参数 类型 是否必传 名称及描述 code int 是 状态码 message string 是 描述信息 result object 是 返回结果数组 result.quota list 是 每日配额使用信息 result.quota[].domains list 是 域名列表,按配置分组，如果域名没有配置，将使用default的配额 result.quota[].dirused int 是 每日刷新目录已使用条数 result.quota[].dirmax int 是 每日刷新目录最大条数 result.quota[].dirsurplus int 是 每日刷新目录剩余条数 result.quota[].urlused int 是 每次刷新url已使用条数 result.quota[].urlsurplus int 是 每日刷新url剩余条数 result.quota[].urlmax int 是 每次刷新url最大条数

本文介绍如何使用刷新和预取功能。 CDN提供资源的刷新和预取功能。通过刷新功能，您可以强制CDN节点回源并获取最新文件；通过预取功能您可以在业务高峰期预取热门资源，提高资源访问效率。 刷新 刷新功能是指提交URL刷新或目录刷新请求后，CDN节点的缓存内容将会被强制过期，当您向CDN节点请求资源时，CDN会直接回源站获取对应的资源返回给您，并将其缓存。刷新功能会降低缓存命中率。 图 刷新 预取 预取功能是指提交URL预取请求后，源站将会主动将对应的资源缓存到CDN节点，当您首次请求时，就能直接从CDN节点缓存中获取到最新的请求资源，无需再回源站获取。预取功能会提高缓存命中率。 图 预取 任务查看 在天翼云CDN客户控制台的【刷新预取】页面，点击【查看任务】，可以分别看到您已提交的URL刷新、目录刷新和URL预取任务的执行情况； 图 查看任务 注：大批量的缓存推送可能会引发高并发回源，如果源站出口带宽较小，建议分多次小批量操作。

本文介绍如何查看态势感知大屏。 第一步，点击侧面导航—态势感知。 第二步，页面跳转态势感知大屏。

参数名 类型 是否必填 名称 说明 action string 是 操作参数 取值SetScdnBotInfo domainName string 是 域名 多个用英文逗号隔开，最多同时支持5个

本文介绍如何查看安全分析报表。 在天翼云SCDN客户控制台的【安全分析】页面，客户可以查看waf、CC攻击日志和waf报表分析、CC报表分析情况； 界面中展示的是您所选域名、时间的攻击日志情况； 图 安全分析CC攻击日志 图 WAF报表分析 图 CC报表分析 图 抗D报表分析 图 网络层攻击事件

本文介绍如何配置告警规则和查看告警记录。 图 告警配置页面 图 告警记录查询页面

本文介绍如何配置证书。 客户控制台的【证书管理】模块，客户在证书管理模块可以上传证书，查看证书详情、更新证书、证书对应绑定的域名以及删除证书。 证书管理页 图 证书新增页

本文介绍配置WAF防护配置。 操作步骤 1.进入SCDN控制台 2.点击域名列表，可直接编辑安全配置，进入安全配置页面 3.保证WAF防护已开启（需购买对应功能） 4.WAF支持基础配置、高级防护、账户安全防护、访问控制、访问限速、合规检测、域名规则 图 安全防护配置页基础配置 图 高级防护页 图 账户安全防护配置页 图 访问控制配置页 图 合规检测配置页 图 域名规则配置页 5.配置完成后可通过工单列表进行查看对应配置进度

本文介绍配置抗D防护配置。 操作步骤 1.进入SCDN控制台 2.点击域名列表，可直接编辑安全配置，进入安全配置页面 3.保证抗D防护已开启（需购买对应功能） 4.抗D支持DDoS防护、CC防护功能配置 5.配置完成后可通过工单列表进行查看对应配置进度

本文介绍如何校验域名归属权。 客户可根据如下方法一、方法二，任意选择一种方式进行操作验证即可。 方法一：DNS解析验证 示例为ctcdn.cn的解析配置 1、客户需在自己的域名解析服务商，添加天翼云控制台返回的TXT记录值（如下记录值仅为示例）。 记录类型 主机记录 记录值 TXT dnsverify 202207060000002jar4fb2hc79iwjq5cdid87t7rci1sgp33exuyvez4kwonobxt 2、域名解析操作完成后，等待（建议10分钟）DNS解析生效后即可进行解析验证。 解析命令：dig dnsverify.ctcdn.cn txt 3、如解析出来的txt值和天翼云控制台返回的TXT记录值一致，则表示配置正确。 确认配置正确后，可前往天翼云控制台，在新增域名界面点击验证，验证通过就可以正常操作新增域名。 方法二：文件验证 示例为ctcdn.cn的解析配置 1、在您的源站根目录下，创建文件名为：dnsverify.txt的文件，文件内容为天翼云控制台返回的TXT记录值（如下记录值仅为示例） 2、文件在源站根目录下创建完成后，即可进行访问验证（示例为访问 windows验证： linux验证： 3、如访问展示的文件内容和天翼云控制台返回的TXT记录值一致，则表示配置正确。 确认配置正确后，可前往天翼云控制台，在新增域名界面点击验证，验证通过就可以正常操作新增域名。