分类 定义 状态码 错误详情 函数错误 脚本异常：用户函数抛出JavaScript异常 500 Error Code: 1111 Function threw exception 函数错误 禁止访问网络 500 Error Code: 1113 Prohibit access to the intranet 函数错误 超出6个子请求限制 500 Error Code: 1115 Too many subrequests 函数错误 函数没有返回 response 500 Error Code: 1117 Illegal response 资源限制 用户函数超出运行时资源限制： CPU执行时长≤配置的函数规格（10ms） 内存≤128M 响应时长≤30s 500 Error Code: 1201 Exceeded resource limits 内部错误 内部错误 500 Error Code: 1301 Internal Error 函数错误 函数被禁用 500 Error Code: 1407 Function Forbidden

本文介绍函数运行时的addEventListener定义与用法。 此函数定义了执行用户函数脚本的触发器。addEventListener仅支持注册一个事件监听器。当前仅支持fetch请求事件，通过注册fetch事件监听器，生成HTTP请求事件FetchEvent，进而实现对HTTP请求的处理。 定义 javascript addEventListener(type: string, listener: (event: FetchEvent) > void): void; 说明 如果注册了多个"fetch"类型的监听器，当一个监听器未调用时event.respondWith()，运行时会将事件传递给下一个已注册的监听器。 如果对某个事件进行多次调用会形成调用链条。当某个回调函数调用了respondWith函数时，调用链条会被终止，后面注册的回调函数不会再被调用。 参数 type string 事件类型，当前仅支持"fetch"，后续会支持"scheduled"。 listener function 事件监听器。用于处理事件回调。 示例 javascript // 注册请求事件监听器 addEventListener("fetch", event > { // 响应客户端请求 return event.respondWith( new Response("Hello world") ) }) 相关参考 示例代码：返回HTML页面 示例代码：返回JSON内容

本文介绍如何根据标头中的已知预共享密钥允许或拒绝请求。 根据标头中的已知预共享密钥允许或拒绝请求。 示例代码 javascript / @param {string} PRESHAREDAUTHHEADERKEY Custom header to check for key @param {string} PRESHAREDAUTHHEADERVALUE Hard coded key value / const PRESHAREDAUTHHEADERKEY "XCustomPSK" const PRESHAREDAUTHHEADERVALUE "mypresharedkey" async function handleRequest(request) { const psk request.headers.get(PRESHAREDAUTHHEADERKEY) if (psk PRESHAREDAUTHHEADERVALUE) { // Correct preshared header key supplied. Fetch request from origin. return fetch(request) } // Incorrect key supplied. Reject the request. return new Response("Sorry, you have supplied an invalid key.", { status: 403, }) } addEventListener("fetch", event > { event.respondWith(handleRequest(event.request)) }) 示例预览 在请求过程中不带密钥访问，请求被拒绝。 相关参考 运行时API：addEventListener 运行时API：FetchEvent 运行时API：Web Standards 运行时API：Response 运行时API：Fetch

本文介绍如何通过Referer防盗链实现访问控制。 通过Referer进行请求防盗链。 示例代码 javascript function verifyReferer(referer) { let regex /ctyun/; return regex.test(referer); } async function verifyHeaderParameters(request) { //401表示鉴权不通过 let statuscode 401 let result 'Referer verification failed!' try { if(verifyReferer(request.headers.get("referer")) true){ statuscode 200 result "Referer verification succeeded!" } } catch (error) { result error } return new Response(result, { "status": statuscode }); } addEventListener('fetch', event > { event.respondWith(verifyHeaderParameters(event.request)) }) 示例预览 访问请求传入鉴权referer，鉴权通过。 相关参考 运行时API：addEventListener 运行时API：FetchEvent 运行时API：Web Standards 运行时API：Response 运行时API：Fetch

本文介绍如何通过边缘函数返回HTML页面。 直接响应边缘函数代码中的HTML页面。 示例代码 javascript const html Hello World This example was generated by Chinatelecom Cloud AccessOne BosonFaaS. ; async function handleRequest(request) { return new Response(html, { headers: { 'contenttype': 'text/html; charsetUTF8', }, }); } addEventListener('fetch', event > { event.respondWith(handleRequest(event.request)); }); 示例预览 在浏览器地址栏中输入匹配到HTTP路由的URL，即可预览示例效果。 相关参考 运行时API：addEventListener 运行时API：Response 运行时API：FetchEvent

本文简述其他章节不包含的功能函数的语法、作用、入参、返回值、示例。 ctyun.getiplocation 函数信息详见下表： 项目 描述 语法 vender, province, city ctyun.getiplocation(remoteip) 作用 返回ip的归属运营商，归属省，归属地市。 入参 ip地址，可以是ipv4，也可以是ipv6。 返回值 依次为ip归属运营商，归属省，归属地市。如果没有找到则返回nil。 示例： reasonml local vender, province, city ctyun.getiplocation("183.38.147.155") if vender ~ nil then ctyun.resp.setoutput(vender..":"..province..":"..city.."n") else ctyun.resp.setoutput("unknown ipn") end 输出结果： CNdianxin:CNguangdong:CNguangdongfoshan ctyun.splitstring 函数信息详见下表： 项目 描述 语法 array ctyun.splitstring(str, splittoken) 作用 根据分隔符，分割字符串。将结果保存到数组中。 入参 str为被分割的字符串，splittoken为分割符。 返回值 返回分割后的结果放到数组中，可以通过ipairs遍历。 示例： applescript local result ctyun.splitstring("aaa,bbb,ccc,ddd", ",") for k,v in ipairs(result) do ctyun.resp.setoutput(v.."n") end 输出结果： aaa bbb ccc ddd ctyun.refreshmode 函数信息详见下表： 项目 描述 语法 isrefreshmode ctyun.refreshmode() 作用 查询该请求是否处于刷新模式。 入参 无。 返回值 返回是否处于刷新模式，bool类型。 示例： awk 设置缓存 local cachekey ctyun.var('uri') ctyun.req.setcache(cachekey, "follow", 3600) 刷新模式下跳过远程鉴权 local isrefreshmode ctyun.refreshmode() if not isrefreshmode then local res, err ctyun.queryremote(" + ctyun.var('uri')) if err then ctyun.exit(403) end if res.status ~ 200 then ctyun.exit(res.status) end end

本文介绍全局字典的添加、查看、编辑、删除等操作。 全局字典是客户粒度的，客户的多个域名可共享全局字典。 添加全局字典 1. 单击全局字典首页右上角的【添加全局字典】来添加全局字典。 2. 进入添加全局字典页面后，输入字典名称和字典大小。最多添加5个全局字典，每个全局字典的大小不超过100MB。全局字典的名称为264位的小写字母、数字、下划线的结合，开头结尾只允许小写字母和数字，多个全局字典的名称不允许相同。添加完成后，单击【确认提交】后进行全局字典的部署。 3. 提交后，会自动跳转到全局字典首页，展示字典部署状态，总共有等待部署、部署中、部署成功、部署失败四种状态，部署失败的可单击操作列的【失败重试】重新部署。部署成功后，可查看、编辑、删除全局字典。 查看全局字典 单击全局字典首页操作列的【查看】，可进入“查看全局字典”页面，可查看每个全局字典的名称和大小。单击【返回】可回到全局字典首页。

项目 描述 语法 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：错误信息。

项目 描述 语法 DICT:delete(keyname) 作用 删除指定的key。 入参 keyname：设置内容的键。 返回值 无。

项目 描述 语法 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,...参数传进去。

项目 描述 语法 iterator, err ctyun.re.gmatch(subject, regex, options?) 作用 类似于ctyun.re.match，但返回一个 Lua 迭代器。 入参 subject：待匹配字符串。 regex：正则表达式。 options：控制如何执行匹配操作。 返回值 iterator： Lua 迭代器，可遍历获取所有匹配项。 err：描述错误信息的字符串。

ctyun.md5 函数信息详见下表： 项目 描述 语法 digest ctyun.md5(str) 作用 计算参数str的MD5摘要，并返回十六进制表示形式。 入参 str：string，待加密字符串。 返回值 digest: md5摘要的十六进制表示形式。 示例： pgsql local src "hello" local digest ctyun.md5(src) digest结果为：5d41402abc4b2a76b9719d911017c592 ctyun.md5bin 函数信息详见下表： 项目 描述 语法 digest ctyun.md5bin(str) 作用 计算参数str的MD5摘要，并返回二进制结果。 入参 str：string，待加密字符串。 返回值 digest: md5摘要的原始二进制形式。 示例： stylus local src "some string we want to sign" local digest ctyun.md5bin(src) ctyun.hmacsha1 函数信息详见下表： 项目 描述 语法 digest ctyun.hmacsha1(secretkey, str) 作用 计算参数str的HMACSHA1摘要，并使用秘钥 得到结果。注意，使用ctyun.hmacsha1生成的是HMACSHA1摘要的原始二进制形式，如果需要，可使用ctyun.encodebase64将结果编码为文本表示形式。 入参 secretkey : string，密钥。 str：string，待加密字符串。 返回值 digest: HMACSHA1摘要的原始二进制形式。 示例： reasonml local key "thisisverysecretstuff" local src "some string we want to sign" local digest ctyun.hmacsha1(key, src) ctyun.resp.setoutput(ctyun.encodebase64(digest)) 结果：R/pvxzHC4NLtj7S+kXFg/NePTmk

项目 描述 语法 rawheader str ctyun.req.rawheader(norequestline?) 作用 用来获取Nginx 服务器接收到的原始 HTTP 协议头。 入参 norequestline? : bool。norequestline：可选参数。参数为 true 可以去除结果中的请求行。 返回值 rawheaderstr: string。Nginx接收到的原始 HTTP 协议头。

项目 描述 语法 jsontext ctyun.json.encode(value) 作用 将Lua值序列化为包含JSON表示的字符串。 入参 value: Lua值或表，支持如下类型：boolean, nil,number,string,table。 返回值 jsontext: UTF8 JSON字符串。

变量名 变量说明 举例 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。

本文介绍边缘函数增值服务的计费规则。 计费规则 边缘函数按函数执行次数计费，资费说明如下： 函数规格 标准资费 单位 10ms 1 元/百万次 50ms 3 元/百万次 100ms 5 元/百万次 计费方式：按需计费。 计费周期：按小时结算，定时扣费。 注意事项 边缘函数不区分中国内地和全球（不含中国内地），价格统一。 函数规格不同，标准资费不同，请根据需要选择函数规格。 因边缘函数为增值服务，涉及计费，如无需使用，请及时退订服务。

参数名 配置值 说明 标签组名 只能输入，英文字母、中文和数字，不允许为空。 标签组，即一组具有相同类别属性标签的统称，在配置关系里面，它是一类标签的集合。 标签名 只能输入，英文字母、中文和数字，多个值用;分隔，不允许为空。 标签，即一组具有相同属性的域名的统称，在配置关系里面，它是一类域名的集合。

参数名 说明 回源连接超时时间 指回源节点与源站服务器建立连接的超时时间。如果回源节点在指定的超时时间内未能与源站服务器建立连接，则会触发节点重试，重试失败后将与源站终止连接并返回502。默认回源连接超时时间为5s。 回源请求超时时间 指回源节点与源站服务器建连成功后，向源站服务器发送请求的超时时间。如果在指定的超时时间内未接收到源站服务器响应的首包，则会触发节点重试，重试失败后将与源站终止连接并返回502。默认回源请求超时时间为15s。

参数名 配置示例 改写参数模式 追加 优先级 默认10 参数名 a 参数值 123

本文介绍基于标签的域名日常管理操作。 功能介绍 在完成域名绑定标签后，您在日常运营时，就可以使用标签快速筛选对应的域名，进行分组管理。 配置说明 1. 登录客户控制台。 2. 单击左侧导航栏【域名管理】【域名列表】。 3. 在【域名列表】页面，找到首行的自定义筛选行。 4. 找到首个筛选框，提示【请选择标签】。 5. 下拉选择您本次计划筛选的【标签组】、【标签】。 6. 在选定标签组和标签之后，系统会自动过滤，并在【域名列表】中只显示符合条件的域名，从而帮助您快速定位到目标域名。 参数名 配置值 说明 标签组 必选项，按标签组筛选域名 如果先勾选某个标签组，则默认筛选出该标签组内全部标签所绑定的域名。 标签 必选项，按标签筛选域名 在选定某个标签组后，可以选择所关联的一个或多个标签进行筛选，选出目标标签绑定的域名。

本文介绍域名解绑标签的操作步骤。 功能介绍 标签为域名分类管理工具，通过标签功能对具有相同属性的域名进行分类管理。如果标签已不再适用于您当前某个或多个域名的用途，您可以解绑域名标签。本文介绍如何为域名解绑标签。 配置说明 1. 登录客户控制台。 2. 单击左侧导航栏【域名管理】【域名列表】。 3. 在【域名列表】页面，找到目标域名的【标签】列。 4. 单击标签图标【】。 5. 在标签管理页面将对应标签【】 6. 确认无误后，单击【确定】提交。

本文通过图文说明如何自定义查询刷新预取任务的执行状态。 功能介绍 当客户完成刷新或预取任务提交后，如要查看任务执行进度和结果，可以通过天翼云客户控制台【刷新预取】页面，分别查看已提交的URL刷新、目录刷新、正则刷新和URL预取任务的执行情况，也可通过URL刷新、目录刷新、正则刷新和URL预取页面快捷跳转到创建任务页面。 操作方式 1. 登录客户控制台。 2. 在【刷新预取】页面。 3. 按实际情况，选择【URL刷新】、【目录刷新】、【正则刷新】或【URL预取】。 4. 选择具体的时间、输入完整域名，或者选择一种特定的任务状态类型。 5. 单击【查询】，查看已创建的对应类型的任务。 6. 也可通过点击【+创建任务】快捷按钮，跳转到创建任务页面创建刷新预取任务。 注意 URL刷新、目录刷新、正则刷新只支持查询最近7天内、时间跨度不超过5天的任务。 URL预取只支持查询最近15天内、时间跨度不超过7天的任务。

本文介绍图片格式转换相关参数及示例。 开通图片处理后，客户可通过URL请求中携带格式转换参数，将原图转换为指定的图片格式。 注意 图片处理为付费服务，目前处于公测期间，暂不收取费用，收费时间另行通知。 参数说明 支持的原图格式：JPEG、PNG、WebP、BMP、GIF、TIFF、JPEG2000（JP2）；未在上述格式范围内，将会返回原图。 参数名称：format。 支持的参数值： 支持转换的图片格式 说明 JPEG 将原图保存为JPEG格式。 PNG 将原图保存为PNG格式。 WEBP 将原图保存为WEBP格式。 BMP 将原图保存为BMP格式。 GIF 将原图保存为GIF格式。 GIF为动图格式，如由其他静态格式转换而来，则仅转换为静图效果。 TIFF 将原图保存为TIFF格式。 JP2 将原图保存为JP2格式。 JXR 将原图保存为JXR格式。 注意 以上参数值不区分大小写。 参数示例

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

本文介绍获取图片信息具体参数及示例。 开通图片处理后，客户可通过请求URL中携带获取图片信息的参数，获取原图的大小、宽、高、图片格式、图片质量和图片方向信息。 注意 图片处理为付费服务，目前处于公测期间，暂不收取费用，收费时间另行通知。 参数说明 参数名称：getinfo。 返回的图片信息为JSON格式，返回的参数包括图片的大小、宽、高、图片格式、图片质量和图片方向。 参数示例： 返回json示例： { "size":1055089, // 文件大小 "width":1920, "height":1080, "quality":100, "format":"JPEG", "orientation":"UNDEFINED" } 注意 若请求URL中同时携带getinfo和其他图片处理参数，则只处理getinfo，其他参数不做处理。

参数 说明 取值范围 brightness 图片亮度 (100,100)，0表示原值，<0 代表亮度下降，>0 代表亮度提升。 contrast 图片对比度 (100,100)，0表示原值，<0 代表对比度下降，>0 代表对比度提升。

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

本文介绍图片置灰功能的具体使用参数及示例。 在某些场景中（例如在特定纪念日时），网站需要对部分图片做置灰处理。 开通图片处理后，客户可通过URL请求中携带相关参数，将原图置灰。 注意 图片处理为付费服务，目前处于公测期间，暂不收取费用，收费时间另行通知。 参数说明及示例 参数名称：grayscale。 访问示例：将原图置灰时，图片处理的访问URL为：

本文介绍如何通过边缘函数返回JSON内容。 直接响应边缘函数代码中的JSON内容。 示例代码 javascript async function handler(event) { const data { hello: "BosonFaaS" } const json JSON.stringify(data, null, 2) return new Response(json, { headers: { "contenttype": "application/json;charsetUTF8" } }) } addEventListener('fetch', (event) > { event.respondWith(handler(event)); }); 示例预览 在浏览器地址栏中输入匹配到HTTP路由的URL，即可预览示例效果。 相关参考 运行时API：addEventListener 运行时API：Response 运行时API：FetchEvent

参数 是否必填 参数类型 说明 示例 下级对象 domain 是 String 域名必须属于当前用户且合法有效 aaa.ctyun.cn scriptname 是 String 为264位的小写字母、数字、下划线组合，以小写字母、数字开头结尾 luatest scriptcontent 是 String lua脚本内容，脚本内容不超过5M ctyun.resp.setoutput('Hello World hmy') ctyun.resp.exit(200)

接口描述：调用本接口查询刷新任务额度 请求方式：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最大条数 示例： 请求路径： 请求： 返回结果： {     "code": 100000,     "message": "success",     "result": {         "quotas": [             {                 "urlused": 0,                 "dirused": 0,                 "urlmax": 10000000,                 "dirsurplus": 100000,                 "domains": [                     "default"                 ],                 "urlsurplus": 10000000,                 "dirmax": 100000             }         ]     } } 错误码请参考：参数code和message含义

示例： 请求路径： 请求： 返回结果： {     "code": 100000,     "message": "success",     "result": [         {             "cdnip": "true",             "nodelevel": " ",             "ipv6": "xxx:xxx:xxx:xxx::xxx",             "roomaddress": " ",             "areacnname": "呼和浩特市",             "ispName": "电信",             "areaenname": "huhehaote"         },         {             "cdnip": "true",             "nodelevel": " ",             "ipv4": "xx.xx.xx.xx",             "roomaddress": " ",             "areacnname": "通州区",             "ispName": "电信",             "areaenname": "tongzhou"         }     ] } 错误码请参考：参数code和message含义