接口描述：调用本接口创建预热任务 请求方式：post 请求路径：/preloadtask/createpreloadtask 使用说明： 单个用户一分钟限制调用10000次，并发不超过100 请求参数说明： 参数 类型 是否必传 名称 描述 values list 是 预热文件列表 单次最多50条。若域名有做防盗链配置，则相应的预取url需同样带有防盗链。 返回参数说明： 参数 类型 是否必传 名称及描述 code int 是 状态码 message string 是 描述信息 submitid string 否 预热提交id result list 否 创建的预热任务列表 result[].url string 否 预热URL result[].taskid string 否 预热任务id 示例： 请求路径： 请求参数： {     "values": [         "         "     ] } 返回结果： {     "code": 100000,     "message": "success",     "submitid": "cf48cdece3160f174a5f3026d52991ee",     "result": [         {             "taskid": "e12a05dc190045af2645f4b8bbe4135f",             "url": "         },         {             "taskid": "e12a05dc190045af2645f4b8bbe4135f",             "url": "         }     ] } 错误码请参考：参数code和message含义

接口描述：调用本接口创建证书。 请求方式：post 请求路径：/cert/creatcert 使用说明： 单个用户一分钟限制调用10000次，并发不超过100； 请求参数说明（json）： 参数 类型 是否必传 名称 描述 certtype integer 否 证书类型 0（国际标准证书），1（国密证书），不传默认0 name string 是 证书备注名 key string 是 国际标准证书/国密加密证书私钥 仅支持PEM格式 certs string 是 国际标准证书/国密加密证书公钥 仅支持PEM格式 signkey string 否 国密签名证书私钥 仅支持PEM格式，当certtype1时，必传 signcerts string 否 国密签名证书公钥 仅支持PEM格式，当certtype1时，必传 返回参数说明： 参数 类型 是否必传 名称及描述 code int 是 状态码 message string 是 描述信息 id int 是 证书id 示例： 请求路径： 请求参数： json { "certtype": 1, "name": "国密证书", "certs": "certsxxx", "key": "keyxxx", "signkey": "enckeyxxx", "signcerts": "enccertsxxx" } 返回结果： json { "code": 100000, "message": "success", "id":7028 } 错误码请参考：参数code和message含义

本文介绍UDFScript支持的lua原生函数。 UDFScript提供如下lua原生函数，由于是lua原生函数，不再详细解释每个函数的使用方法。 函数库 函数名 全局 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。

参数 是否必填 参数类型 说明 示例 下级对象 domain 是 string 域名，仅支持单个 aa.bb.ctyun.cn

参数 类型 是否必传 名称 描述 name string 是 证书备注名

本文介绍图片旋转的具体使用参数及示例。 开通图片处理后，客户可通过URL请求中携带图片旋转参数，将原图按指定角度进行旋转；同时支持对特定格式的文件做自动回正。 注意 图片处理为付费服务，目前处于公测期间，暂不收取费用，收费时间另行通知。 参数说明及示例 图片旋转 参数名称：rotate。 参数类型 取值范围 示例 顺时针旋转 仅支持90、180、270，超出范围会返回原图。 逆时针旋转 仅支持90、 180、270，超出范围会返回原图。 图片自动回正 参数名称：orientation，值固定为：auto。 访问示例：将原图做自动回正处理时，访问的图片处理URL为： 注意 目前图片自动回正仅支持JPEG（含JPG）和TIFF格式，且图片的EXIF信息中包含Orientation值。

参数名 说明 Referer防盗链 默认关闭，开启后可配置Referer防盗链。 是否允许空Referer访问 默认开启，即允许空Referer访问，若要禁止空Referer访问，需关闭此功能。 是否允许空协议 默认关闭，即不允许空协议访问，若要支持空协议访问，需开启此功能。 匹配所有端口 默认关闭，即根据实际配置Referer进行匹配，若要匹配所有端口，需开启此功能。 忽略大小写 默认关闭，即根据实际配置的Referer大小写字符进行匹配，若要忽略大小写匹配，需开启此功能。 是否追加 默认关闭，即需要全量下发，开启后可增量下发。 类型 可选择配置白名单或者黑名单，二选一。 黑名单：黑名单内的域名无法访问资源。 白名单：只有白名单内的域名可以访问资源。如果有同时开启允许空Referer访问，则空Referer也可访问资源。

接口描述：调用本接口进行域名归属权校验 请求方式：get 请求路径：/domain/verifydomainownership 使用说明： 单个用户一分钟限制调用10000次，并发不超过100 Query参数说明： 参数名 类型 是否必填 名称 说明 domain string 是 域名 域名 verifytype int 否 解析方法 1（DNS解析验证） ；2（文件验证） 。默认1 返回参数说明： 参数 类型 是否必传 名称及描述 code int 是 状态码，成功100000 message string 是 描述信息，成功返回success，其他返回异常信息描述 verifyresult boolean 否 域名归属权校验结果，true（成功），false(失败) 示例： 请求路径： 请求： 返回结果： json { "code": 100000, "message": "success", "verifyresult": false } 错误码请参考：参数code和message含义

名称 描述 是否必选 示例 ContentType 消息体的类型（格式）。推荐用户使用默认值application/json，有其他取值时会在具体接口中专门说明。 是 application/json .... .... .... ....

本产品的终端节点：cdnapiglobal.ctapi.ctyun.cn

大洲 大洲编码 洲大区 洲大区编码 亚洲 200 中亚 303 亚洲 200 东亚 315 亚洲 200 东南亚 311 亚洲 200 南亚 305 亚洲 200 西亚 306 大洋洲 201 澳大利亚和新西兰 314 大洋洲 201 美拉尼西亚 312 大洋洲 201 密克罗尼西亚 320 大洋洲 201 波利尼西亚 309 非洲 202 北非 307 非洲 202 东非 304 非洲 202 中非 319 非洲 202 南部非洲 310 非洲 202 西非 308 欧洲 203 中欧 313 欧洲 203 东欧 301 欧洲 203 北欧 317 欧洲 203 南欧 318 欧洲 203 西欧 316 美洲 204 加勒比 300 美洲 204 中美洲 302 美洲 204 北美 321 美洲 204 南美 322

项目 描述 语法 ctyun.updatetime() 作用 强制更新，当前nginx时间缓存。 入参 无。 返回值 无。

本文为您介绍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。

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

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

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

参数值 说明 取值范围 示例 数字 绝对质量转换的具体数字。按绝对质量进行转换，转换成指定大小的质量。 0<数字<100，如超出范围会返回原图。 如果图片当前质量大于number进行转换，小于不转换。 数字p 相对质量转换的具体数字。根据图片当前质量乘以number%，得到最终的质量。 0<数字<100，如超出范围会返回原图。

参数名 说明 IP黑白名单 默认关闭，开启后可配置IP黑白名单。 类型 可选择配置白名单或者黑名单，二选一。 黑名单：黑名单内的IP无法访问资源。 白名单：只有白名单内的IP可以访问资源。

本文介绍html禁止操作功能。 功能介绍 html禁止操作，支持在客户控制台自助进行html页面的禁止右键操作和禁止复制操作，以防止源站的源码泄露。 配置说明 域名新增完成后，方可配置html禁止操作的功能，操作步骤如下： 1. 在【域名管理】【域名列表】页面，找到目标域名，点击操作列的【编辑】按钮，跳转到域名编辑页面。 2. 在域名编辑页面点击右侧的锚点区域中的“页面优化”，页面会自动定位到页面优化功能模块。 3. 在【页面优化】模块，找到html禁止操作的开关，根据需求配置禁止复制、禁止右键，同时支持在指定后缀名、目录、首页、全部文件、全路径文件中选择任意一种形式来配置功能生效范围。 配置界面 html禁止操作默认关闭，打开开关后，可按后缀名、目录、首页、全部文件、全路径文件粒度开启禁止复制或者禁止右键，也可同时开启禁止复制及禁止右键功能。 html禁止操作开关关闭： html禁止操作开关开启：

本文通过图文说明证书删除的操作步骤及注意事项等。 功能介绍 当证书过期或者不再使用时，可通过客户控制台删除证书。 注意事项 证书删除的前提是未绑定域名，因此在删除证书前，需要先解除证书与域名的绑定关系。 操作步骤 1. 登录客户控制台。 2. 在【证书管理】【证书列表】页面，选定目标证书，确保要删除的证书已无域名适用，然后在操作列单击【删除】。 3. 控制台会弹窗，客户进行二次确认后，单击【确认】即可删除。 注意 删除证书前，请确保证书未绑定任何域名，否则将无法删除。 配置界面 要删除的证书如有域名仍在使用，将无法删除，会弹出如下的确认弹窗，点击【确认】将关闭弹窗。如需继续删除证书，必须先使所有绑定该证书的域名取消证书配置。 要删除的证书如果无域名使用，将弹出如下的弹窗，点击【确认】后即可删除证书。

参数 说明 取值范围 示例 w 按宽固定自适应等比缩放: 固定宽度，高度自适应。 缩放后的宽×高不能超过16777216 px。 h 按高固定自适应等比缩放: 固定高度，宽边自适应。 缩放后的宽×高不能超过16777216 px。 l 按长边固定自适应等比缩放：长边固定长度，短边自适应缩放。 缩放后的宽×高不能超过16777216 px。 s 按短边固定自适应等比缩放：短边固定长度，长边自适应缩放 缩放后的宽×高不能超过16777216 px。 。 fw、fh 指定目标缩放图的宽高。 缩放后的宽×高不能超过16777216 px。 。 p 按原图宽高比例进行缩放。 0

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()

编辑全局字典 单击全局字典首页操作列的【编辑】，可进入“编辑全局字典”页面，可修改每个全局字典的名称和大小，也可以删除或增加一行全局字典。单击【取消】可回到全局字典首页，单击【确认提交】可提交部署。 删除全局字典 单击全局字典首页操作列的【删除】，可删除所有全局字典，在删除之前会有二次确认弹窗提醒，单击【确定】后会删除所有全局字典。如删除失败，可单击操作列的【失败重试】进行重试，直到删除成功为止。 注意 删除全局字典前必须得先删除全局task脚本。

项目 描述 语法 res, err ctyun.queryremote(url, reqinfo, timeout?, direct2client?) 作用 利用cosocket访问第三方网站，得到响应内容。支持简单的单次请求得到响应并处理、响应内容直接发送至客户端两种模式。 入参 url：访问第三方服务的url。示例：" reqinfo：请求信息，包括requestmethod，request body（POST时候需要），request headers，是否打开ssl认证。示例： { method "POST", body "hello world", headers {}, sslverify true } timeout： 超时时间，单位为毫秒。示例：30000，表示超时时间为30s。 direct2client： 是否直接发送至客户端，布尔型。示例：true，标识直接发送至客户端。注：开启时请求第三方的requestmethod需要跟客户端请求一致。 返回值 res：响应结果，luatable类型，{ status, headers, body }。当开启direct2client时此项为字符串done。 err：错误信息。

本文简述全局字典相关函数的语法、作用、入参、返回值、示例。 ctyun.dict.DICT.set 函数信息详见下表： 项目 描述 语法 success, err, forcible DICT:set(keyname, value, ttl?, flags?) 作用 在全局字典ctyun.dict.DICT 中设置一个键值对。 其中value可以是Lua布尔值、数字、字符串，或nil类型的，不可以是table类型的。 入参 keyname：设置内容的键。 value：设置内容的值。 ttl：设置key/value的有效期（单位是秒），为可选参数，默认是不过期的。如果为0（默认）则表示永远不失效。 flags: 用来做用户标识，可以标识set操作的执行者，默认是0。只能设置number类型; 为可选参数。 返回值 success：布尔值，用来表示是否成功set。 err：如果success的值是false，就会将错误信息存放在err中。 forcible：布尔值，用来表示是否有数据被强制删除。在存储数据的过程中，如果内存空间不够就会使用LRU算法清除数据，此时，forcible为true。 示例： applescript 假设全局字典名称为cats local cats ctyun.dict.cats local succ, err, forcible cats:set("Marry", "it is a nice cat!") ctyun.dict.DICT.safeset 函数信息详见下表： 项目 描述 语法 success, err, forcible DICT:safeset(keyname, value, ttl?, flags?) 作用 与set类似，但在内存不足的情况下，它不会覆盖已经存在且没有过期的数据，而会报“no memory”错误并返回nil。 入参 keyname：设置内容的键。 value：设置内容的值。 ttl：设置key/value的有效期（单位是秒），为可选参数，默认是不过期的。如果为0（默认）则表示永远不失效。 flags: 用来做用户标识，可以标识set操作的执行者，默认是0。只能设置number类型; 为可选参数。 返回值 success：布尔值，用来表示是否成功set。 err：如果success的值是false，就会将错误信息存放在err中。 forcible：布尔值，用来表示是否有数据被强制删除。在存储数据的过程中，如果内存空间不够就会使用LRU算法清除数据，此时，forcible为true。 示例： applescript 假设全局字典名称为cats local cats ctyun.dict.cats local succ, err, forcible cats:safeset("Marry", "it is a nice cat!")

本文简述异步处理相关函数的语法、作用、入参、返回值、示例。 ctyun.thread.run 函数信息详见下表： 项目 描述 语法 result，err ctyun.thread.run(callback, arg1, arg2, ...) 作用 创建一个线程， 异步执行lua函数。主要使用场景为异步通知远端处理结果，不阻塞正常的业务流程。 入参 callback 为lua函数，arg1,arg2,...为lua函数的参数。 返回值 创建成功返回true，失败返回false，以及错误信息err。 注意 ：由于是独立的线程执行callback，跟正常的业务请求是独立的环境。在callback中不能使用跟请求属性相关的函数（ctyun.req和ctyun.resp以及ctyun.var)。如果需要用到相关的变量，请通过arg1,arg2,...参数传进去。 示例： stata local function test(url, body) local res, err ctyun.queryremote(url, { method "POST", body body, headers { ["ContentType"] "application/xwwwformurlencoded", }, }, 30000) if err then return end end ctyun.thread.run(test, " "test bodyyyyyyy") ctyun.resp.setoutput("hello world") 结果：hello world

项目 描述 语法 new, n, err ctyun.re.gsub(subject, regex, replace, options?) 作用 类似ctyun.re.gsub，但是会进行全局替换。 入参 subject：待匹配字符串。 regex：正则表达式。 replace：替换匹配的字符串，可以是纯字符串，也可以使用$0$1捕获匹配，也可两者结合来使用。 options：控制如何执行匹配操作。 返回值 new：替换生成的新字符串。 n：成功替换的次数。 err：描述错误信息的字符串。

项目 描述 语法 digest ctyun.hmacsha1(secretkey, str) 作用 计算参数str的HMACSHA1摘要，并使用秘钥<secretkey>得到结果。注意，使用ctyun.hmacsha1生成的是HMACSHA1摘要的原始二进制形式，如果需要，可使用ctyun.encodebase64将结果编码为文本表示形式。 入参 secretkey : string，密钥。 str：string，待加密字符串。 返回值 digest: HMACSHA1摘要的原始二进制形式。

项目 描述 语法 secs ctyun.req.starttime() 作用 用来获取当前请求创建时的时间戳。 入参 无。 返回值 secs: number。浮点类型时间戳，单位为秒（小数部分可表示毫秒）。

项目 描述 语法 newstr ctyun.unescapeuri(str) 作用 对uri进行反转义。 入参 str：string，已转义的uri。 返回值 newstr: 对uri反转义后的结果。

本文介绍图片色彩中亮度和对比度的具体使用参数及示例。 开通图片处理后，客户可通过URL请求中携带图片色彩相关参数，对原图亮度及对比度进行调整，进一步优化视觉效果。 亮度是指图像的明亮程度，对比度是指图像中最亮和最暗部分之间的差异程度。亮度越高，图像看起来越明亮。对比度越高，图像的明暗差异越明显，越能够展现出更多的细节和层次。图片亮度和对比度之间存在一定的关联性，适当的亮度设置可以增强对比度，使图像更加鲜明。 注意 图片处理为付费服务，目前处于公测期间，暂不收取费用，收费时间另行通知。 参数说明及示例 参数名称：brightnesscontrast，为brightness和contrast参数合并的结果，以下为参数相关说明： 参数 说明 取值范围 brightness 图片亮度 (100,100)，0表示原值， 0 代表亮度提升。 contrast 图片对比度 (100,100)，0表示原值， 0 代表对比度提升。 访问示例： 注意 brightness和contrast必须成对出现。

本文介绍图片渐进式加载的具体使用参数及示例。 访问网站时，普通图片的加载是随着下载图片数据的完成度，逐渐从上至下显示完成的。如果浏览器只收到了图片文件数据的一半，则只会显示图片的上半部分。而渐进式图片则是先显示图片整体的模糊效果，随着下载数据的增多，逐渐细化图片中的各个细节，使得图片分辨率逐渐提高，最终还原出完整清晰的图像内容。 开通图片处理后，客户可通过URL请求中携带指定参数，将原图转换为渐进式加载格式，从而优化网站表现。 注意 图片处理为付费服务，目前处于公测期间，暂不收取费用，收费时间另行通知。 参数说明及示例 参数名称：progressive。 访问示例：将原图做渐进式加载时，图片处理的访问URL为： 注意 目前图片渐进式加载仅支持JPEG（含JPG）和PNG格式。