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

参数 类型 是否必传 名称 描述 type int 否 查询方式 0（按照时间查询）；1（按照submitid查询）；2（按照taskid查询）。默认为0 starttime int 否 开始时间戳 起始时间，时间戳(秒)，type0时，必填 endtime int 否 结束时间戳 结束时间，时间戳(秒)，type0时，必填 submitid string 否 提交id 刷新提交id，type1时，必填 taskid string 否 任务id 刷新任务id，type2时，必填 url string 否 模糊查询 比如url为 tasktype int 否 刷新类型 筛选项，1（url）；2（目录dir）；3（正则匹配re） page int 否 页数 默认1；当且仅当type0时有效 pagesize int 否 每页条数 默认50，最大300；当且仅当type0时有效

接口描述：调用本接口查询预取任务额度 请求方式：get 请求路径：/preloadtask/querypreloadtaskquota 使用说明： 单个用户一分钟限制调用10000次，并发不超过100 请求参数说明： 无 返回参数说明： 参数 类型 是否必传 名称及描述 :::: code int 是 状态码 message string 是 描述信息 result object 否 返回结果 result.quotas list 否 每日预取配额使用信息 result.quotas[].used int 否 每日预取已使用条数 result.quotas[].surplus int 否 每日预取剩余条数 result.quotas[].max int 否 每日预取最大条数 result.quotas[].domains list 否 预取的域名列表，按配置分组，如果域名没有配置，将使用default的配额 result.concurrencys list 否 每次提交预加载最大条数信息 result.concurrencys[].singlecommitmax int 否 预取并发数 result.concurrencys[].domain string 否 域名 示例： 请求路径： 示例1： 请求： 返回结果： { "code": 100000, "message": "success", "result": { "quotas": [ { "surplus": 9136, "max": 10000, "domains": [ "default" ], "used": 864 } ], "concurrencys": [ { "domain": "default", "singlecommitmax": 10 } ] } } 错误码请参考：参数code和message含义

参数名 说明 HTTP2.0 默认关闭，即不开启HTTP2.0功能。开启HTTP2.0功能之前，需要先完成HTTPS证书配置。

接口描述：调用本接口可校验对该域名是否有归属权，并返回域名的校验内容 请求方式：get 请求路径：/domain/queryverifycontent 使用说明： 单个用户一分钟限制调用10000次，并发不超过100 请求参数说明： 参数 是否必填 参数类型 说明 示例 下级对象 domain 是 string 域名，仅支持单个 test.ctyun.cn 返回参数说明： 参数 是否必填 参数类型 说明 示例 code 是 int 状态码 成功100000 message 是 string 信息描述 成功返回success，其他返回异常信息描述 verifyresult 否 boolean 域名校验结果，false(校验失败)，true（校验通过） true verifydesc 否 string 域名校验失败的原因 顶级域名不存在 domainzone 否 string 域名对应的主域名zone ctyun.cn content 否 string 根据域名生成的记录值 202208201502416f4431f54f7b441b9425dc0e1a6b9d853a8fcd1119e1424294 示例： 请求路径： 示例1： 请求： 返回结果： json { "code": 100000, "message": "success", "verifyresult": false, "domainzone": "ctyun.cn", "content": "20221126200014e8d54584246042a6a571f7039219f95655980c483448488389", "verifydesc": "首次新增域名需要完成归属权验证" } 错误码请参考：参数code和message含义

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

本文概括介绍刷新预取功能的使用场景及功能价值。 概述 为了确保用户获取到的内容始终为最新的，天翼云CDN支持刷新和预取功能，在不同使用场景确保用户能以最短的耗时获得最新的内容。 功能简介 刷新预取模块主要包括内容刷新、内容预取、以及相关任务提交后的任务查看和跟进的功能。具体说明如下： 功能 说明 刷新 天翼云CDN支持URL刷新、目录刷新、正则刷新三种方式。不同刷新方式实现机制稍有不同，但最终都能确保用户访问时获得最新的内容。常用于客户对源站内容做更新后，需要CDN节点上对该内容做同步更新。 预取 执行预取请求后，节点自动触发向源站请求内容并缓存，完成预取之后，节点缓存的是源站最新的内容。此时，如果客户端向CDN节点请求内容，节点会响应缓存的内容给用户。常用于热门文件发布或是大型推广活动前做内容预取，可以降低热点文件发布后源站的回源压力，提升缓存命中率，优化首批用户的访问体验。 查看任务 支持客户自定义查询刷新或预取任务的执行状态。

接口描述：调用本接口根据定义日志配置ID查询日志格式 请求方式：get 请求路径：/usercustomlogconfig/querylogformatbyid 使用说明： 单个用户一分钟限制调用10000次，并发不超过100 请求参数说明： 参数 类型 是否必传 名称 描述 logformatid long 是 日志配置ID 返回参数说明： 参数 类型 是否必传 名称及描述 code int 是 状态码，成功100000 message string 是 描述信息，成功返回success，其他返回异常信息描述 data object 否 返回结果 data.logformat string 否 日志配置格式 data.logsample string 否 日志样例 示例： 请求路径： 示例1： 请求： 返回结果： json { "code": 100000, "message": "success", "data": { "logformat": "${remoteaddr} ${real domain} ${senthttpcontenttype} [${msec}] "${requestmethod} ${newscheme}://${real domain}${uriWithParam} ${serverprotocol}" ${status} ${bytessent} ${httpreferer} "${httpuseragent}"", "logsample": "" } } 错误码请参考：参数code和message含义

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

本文通过图文说明如何自定义查询刷新预取任务的执行状态。 功能介绍 当客户完成刷新或预取任务提交后，如要查看任务执行进度和结果，可以通过天翼云CDN控制台【刷新预取】页面，分别查看已提交的URL刷新、目录刷新、正则刷新和URL预取任务的执行情况。 操作方式 1. 登录CDN控制台。 2. 在【刷新预取】页面。 3. 按实际情况，选择【URL刷新】、【目录刷新】、【正则刷新】或【URL预取】。 4. 选择具体的时间、输入完整域名，或者选择一种特定的任务状态类型。 5. 单击【查询】。

参数 类型 是否必传 名称及描述 code int 是 状态码 message string 是 描述信息 result list< object> 否 返回结果数组 result[].domain string 否 域名 result[].details list< object> 否 域名对应的vip列表信息 result[].details[ ].vips string 否 vip信息，多个用逗号“,”分割 result[].details[ ].cityName string 否 城市名称 result[].details[ ].nodename string 否 节点名称 result[].details[ ].provinceName string 否 省份名 result[].details[ ].ispName string 否 运营商名称

接口描述：调用本接口查询IP可用状态 请求方式：get 请求路径：/ip/queryipstatus 使用说明： 单个用户一分钟限制调用10000次，并发不超过100 请求参数说明： 参数 是否必填 参数类型 说明 示例 下级对象 vips 是 string vip列表，最多支持10个ip查询，多IP使用逗号分隔。若超过限制，则只返回最前面的10个。 1.1.1.1 返回参数说明： 参数 是否必填 参数类型 说明 示例 下级对象 code 是 int 状态码 成功100000 message 是 string 信息描述 成功返回success，其他返回异常信息描述 result 否 list 节点IP地址状态列表 resultsingle 表resultsingle 参数 是否必填 参数类型 说明 示例 下级对象 ip 否 string 节点ip地址 1.1.1.1 status 否 string ip状态，normal（正常），abnormal（非正常），noctyun（非天翼云ip） normal 示例： 请求路径： 示例1： 请求： 返回结果： json { "result": [ { "ip": "1.1.1.1", "status": "noctyun" }, { "ip": "2.2.2.2", "status": "noctyun" } ], "code": 100000, "message": "success" } 错误码请参考：参数code和message含义

参数 类型 是否必传 名称及描述 code int 是 状态码 message string 是 描述信息 result list< object> 否 返回结果数组 result[].ispid int 否 运营商ID result[].ispcode int 否 运营商编码 result[].ispcnname string 否 运营商中文名称 result[].ispenname string 否 运营商英文名称 result[].ispabbr string 否 运营商缩写

参数名 说明 回源HOST带端口 关闭时，回源HOST不携带端口。 开启时，回源HOST携带非80/443的回源端口回源。

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

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

项目 描述 语法 capturestable, err ctyun.re.match(subject, regex, options?) 作用 正则匹配，返回匹配内容。 入参 subject：待匹配字符串。 regex：正则表达式。 options：控制如何执行匹配操作，支持以下选项： a anchored mode (only match from the beginning) d enable the DFA mode (or the longest token match semantics). this requires PCRE 6.0+ or else a Lua exception will be thrown. first introduced in ngxlua v0.3.1rc30. D enable duplicate named pattern support. This allows named subpattern names to be repeated, returning the captures in an arraylike Lua table. for example, local m ngx.re.match("hello, world", "(?w+), (?w+)", "D") m["named"] {"hello", "world"} this option was first introduced in the v0.7.14 release. this option requires at least PCRE 8.12. i case insensitive mode (similar to Perl's /i modifier) j enable PCRE JIT compilation, this requires PCRE 8.21+ which must be built with the enablejit option. for optimum performance, this option should always be used together with the 'o' option. first introduced in ngxlua v0.3.1rc30. J enable the PCRE Javascript compatible mode. this option was first introduced in the v0.7.14 release. this option requires at least PCRE 8.12. m multiline mode (similar to Perl's /m modifier) o compileonce mode (similar to Perl's /o modifier), to enable the workerprocesslevel compiledregex cache s singleline mode (similar to Perl's /s modifier) u UTF8 mode. this requires PCRE to be built with the enableutf8 option or else a Lua exception will be thrown. U similar to "u" but disables PCRE's UTF8 validity check on the subject string. first introduced in ngxlua v0.8.1. x extended mode (similar to Perl's /x modifier) 返回值 capturestable：找到匹配项时，返回一个lua table，其中capturestable[0]保存整个匹配的子字符串，capturestable[1]保存第一个带括号的子模式的捕获，capturestable[2]为第二个，以此类推。未找到匹配项时此项为nil。 err：描述错误信息的字符串。

示例： 请求路径： 示例1： 请求： 返回结果： { "code": 100000, "message": "success", "total": 1, "page": 1, "pagesize": 1, "result": [ { "submittime": "20190506 12:00:00", "url": " "status": "completed", "headers": [ { "name": "test", "value": "111" }, { "name": "test2", "value": "222" } ] } ] } 错误码请参考：参数code和message含义

项目 描述 语法 number ctyun.worker.count() 作用 获取当前Nginx worker进程的数量，即Nginx配置中workerprocesses的值。 入参 无。 返回值 number：当前Nginx worker进程的数量。

接口描述：调用本接口查询绑定某证书的域名列表。 请求方式：get 请求路径：/cert/querycertbind 使用说明： 单个用户一分钟限制调用10000次，并发不超过100。 请求参数说明（json）： 参数 类型 是否必传 名称 描述 ::::: name string 是 证书备注名 返回参数说明： 参数 类型 是否必传 名称及描述 :::: code int 是 状态码 message string 是 描述信息 result list 否 绑定证书的域名列表 示例： 请求路径： 示例1： 请求： 返回结果： json { "code": 100000, "message": "success", "result": [ "a.ctyun.cn", "b.ctyun.cn", "c.ctyun.cn" ] } 错误码请参考：参数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 示例： 请求路径： 示例1： 请求参数： plaintext { "certtype": 1, "name": "国密证书", "certs": "certsxxx", "key": "keyxxx", "signkey": "enckeyxxx", "signcerts": "enccertsxxx" } 返回结果： plaintext { "code": 100000, "message": "success", "id": 7028 } 错误码请参考：参数code和message含义

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

本文通过图文说明修改证书的操作步骤。 功能介绍 客户完成证书新增后，如发现证书信息上传有误，可通过客户控制台自助修改证书信息。 配置说明 修改证书时，客户需要重新填写证书公钥和证书私钥。其中公钥和私钥支持PEM格式。具体操作步骤如下： 1. 登录CDN控制台。 2. 在【证书管理】【证书列表】页面，找到需要修改的证书。 3. 单击操作列的【编辑】。 4. 在弹出的【修改证书】界面，输入证书公钥和证书私钥。填写完成后，单击【下一步】进行新证书校验。 证书类型 参数 说明 国际标准证书 证书备注名 证书备注名，是指在添加自有证书时，为了方便识别和记忆，可以支持客户自定义所上传证书的名称，方便选择时，选定正确的证书与所配置的域名进行关联。 如果已经在【证书管理】上传证书，可直接选择对应域名证书。如果还未上传证书，可单击【点击上传】，添加自有证书。添加完毕后，再选择对应证书。 国际标准证书 证书公钥 指国际标准证书的公钥，只支持PEM格式。以“BEGIN CERTIFICATE”开头，以“END CERTIFICATE”结尾。 国际标准证书 证书私钥 指国际标准证书的私钥，只支持PEM格式。以“BEGIN RSA PRIVATE KEY”开头，“END RSA PRIVATE KEY”结尾。 国密证书 证书备注名 证书备注名，是指在添加自有证书时，为了方便识别和记忆，可以支持客户自定义所上传证书的名称，方便选择时，选定正确的证书与所配置的域名进行关联。 如果已经在【证书管理】上传证书，可直接选择对应域名证书。如果还未上传证书，可单击【点击上传】，添加自有证书。添加完毕后，再选择对应证书。 国密证书 签名证书公钥 指国密签名证书的公钥，只支持PEM格式。以“BEGIN CERTIFICATE”开头，以“END CERTIFICATE”结尾。 国密证书 签名证书私钥 指国密签名证书的私钥，只支持PEM格式。以“BEGIN RSA PRIVATE KEY”开头，“END RSA PRIVATE KEY”结尾。 国密证书 加密证书公钥 指国密加密证书的公钥，只支持PEM格式。以“BEGIN CERTIFICATE”开头，以“END CERTIFICATE”结尾。 国密证书 加密证书私钥 指国密加密证书的私钥，只支持PEM格式。以“BEGIN RSA PRIVATE KEY”开头，“END RSA PRIVATE KEY”结尾。 5. 系统提示证书校验结果，如无异议，单击【下一步】确认证书详细信息。 6. 单击【确认】完成并返回证书列表首页。

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

body) ctyun.resp.setoutput(res.body) end

参数 描述 是否必选 URIscheme 用于传输请求的协议，当前所有API均采用HTTPS协议。 是 Endpoint 当前资源池或者通用的域名。 是 resourcepath 资源路径，也即API访问路径。从具体API的URI模块获取，例如“获取用户1信息”API的resourcepath为“/users/1”。 是 querystring 查询参数，是可选部分，并不是每个API都有查询参数。查询参数前面需要带一个“?”，形式为“参数名参数取值”，例如“?userID1”，表示查询用户ID为1的数据。 是

大洲 大洲编码 洲大区 洲大区编码 亚洲 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

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

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

参数名 说明 源站证书的Common Name白名单列表 支持多个域名，域名之间请使用英文逗号分隔。

查看全局task脚本 单击全局task脚本首页操作列的【查看】，可进入“查看全局task脚本”页面，可查看全局task脚本的名称和脚本内容。单击【返回】可回到全局task脚本首页。 编辑全局task脚本 单击全局task脚本首页操作列的【编辑】，可进入“编辑全局task脚本”页面，可修改全局task脚本内容，脚本名称不允许修改。单击【取消】可返回全局task脚本首页，单击【确认提交】可提交部署。 删除全局task脚本 单击全局task脚本首页操作列的【删除】，可删除对应行的全局task脚本，在删除之前会有二次确认弹窗提醒，单击【确定】后会删除对应的全局task脚本。如删除失败，可单击操作列的【失败重试】进行重试，直到删除成功为止。

本文介绍回源端口的配置说明。 功能介绍 回源端口，是指源站接收CDN请求时所用的端口，一般HTTP协议和HTTPS协议使用不同的回源端口。 配置说明 1. 登录CDN控制台。 2. 单击左侧导航栏【域名管理】【域名列表】。 3. 在【域名列表】页面，找到目标域名，单击【操作】列的【编辑】。 4. 单击右侧【回源配置】。 5. 在【回源端口】模块，配置合适的端口。HTTP端口默认80，支持自定义；HTTPS端口默认443，支持自定义。 6. 单击【保存】，完成配置。 未开启“跟随请求端口回源”时，可以自定义配置HTTP回源端口和HTTPS回源端口，如下图： 开启“跟随请求端口回源”时，HTTP回源端口和HTTPS回源端口置灰不能配置，将使用请求端口回源，如下图： 参数名 说明 HTTP 使用HTTP协议回源时使用的回源端口，默认80，支持自定义，自定义回源端口范围为1~65535。 HTTPS 使用HTTPS协议回源时使用的回源端口，默认443，支持自定义，自定义回源端口范围为1~65535。 跟随请求端口回源 跟随请求端口回源优先生效，开关开启后，使用请求端口回源。