本文介绍热门分析。 功能说明 支持三个月内、最长时间跨度为一个月的热门数据统计，包括域名排行和TOP客户端IP统计。并支持数据下载导出，表格内容与页面一致。 操作指引 进入【统计分析】【热门分析】功能模块，即可查看域名排行和TOP客户端IP排行。 域名排行 域名排行可按照流量或连接数对域名的访问量进行排行。选择“流量优先”时按照流量大小排序，选择“连接数优先”时按照连接数排序，并支持表格导出。 TOP客户端IP TOP客户端IP可展示TOP客户端IP对应的流量、连接数。可选择域名、地区、流量优先或连接数优先进行查询。选择“流量优先”时按照流量大小排序，选择“连接数优先”时按照连接数排序，并支持表格导出。

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

更新日期 更新内容 20221130 第一次正式发布。 本次更新说明如下： 上线IPA域名管理、IPA统计分析、IPA账单服务等API。 2023421 第二次正式发布。 本次更新说明如下： 上线辅助工具等API。

终端节点： cdnapiglobal.ctapi.ctyun.cn

本文介绍用量查询。 功能说明 该模块可供客户查看带宽流量、连接数、并发连接数、区域运营商统计等指标。 操作指引 进入【统计分析】【用量查询】功能模块，即可通过筛选项进行组合查询带宽、流量、连接数、并发连接数、区域运营商等统计指标。筛选项包括域名、运营商、地区、时间。 带宽 界面中展示的是您所选域名、运营商、地区、时间范围内的带宽统计图表，带宽图中包括了带宽峰值和95带宽峰值，同时给出了查询时间范围内每日总流量、带宽峰值、峰值时间点。 流量 界面中展示的是您所选域名、运营商、地区、时间范围内的流量统计图表，流量图中包括了查询范围内的总流量，同时给出了查询时间范围内每日总流量、带宽峰值、峰值时间点。 连接数 界面中展示的是您所选域名、运营商、地区、时间范围内的连接数和并发连接数统计图表，可通过切换“连接数”和“并发连接数”的按钮查看连接数和并发连接数，连接数图表中包括了总连接数、连接数峰值、连接数谷值，以及查询时间内每日的连接数、并发连接数峰值、峰值时间点；并发连接数图表中包括了并发连接数峰值、并发连接数谷值，以及查询时间内每日的连接数、并发连接数峰值、峰值时间点。

参数 类型 是否必传 名称及描述 code int 是 状态码 message string 是 描述信息 result list<object> 否 统计结果 result[].rank int 否 倒叙排名 result[].channel string 否 域名 result[].uri string 否 uri值 result[].port string 否 result[].request long 否 请求数 result[].flow long 否 流量

更新日期 更新内容 :: 20221027 第一次正式发布 本次更新说明如下： 新增账单服务、域名管理、刷新预热、统计分析、日志下载接口 20221130 第二次正式发布 本次更新说明如下： 查询域名攻击的攻击IP/被攻击URL/攻击来源/攻击类型分布、查询域名攻击概况、 批量域名配置增加/编辑/删除/启用/停用、更新bot防护配置、查询bot防护配置

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

接口描述：调用本接口查询刷新任务额度 请求方式：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 int 是 状态码 message string 是 描述信息 result list<object> 否 返回结果数组 result[].ispid int 否 运营商ID result[].ispcode int 否 运营商编码 result[].ispcnname string 否 运营商中文名称 result[].ispenname string 否 运营商英文名称 result[].ispabbr string 否 运营商缩写

参数名 类型 是否必填 名称 说明 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最大条数

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

参数 类型 是否必返回 名称及描述 attackCount int 是 攻击数量 attackKey string 是 攻击类型；据查询的类型不同对应的值为IP/URL/攻击来源地区/攻击类型

参数 类型 是否必传 名称 描述 page int 否 当前页数 不填默认1 perpage int 否 每页显示的记录条数 不填默认1000

接口描述：调用本接口查询预热任务额度 请求方式：get 请求路径：/preloadtask/querypreloadtaskquota 使用说明： 单个用户一分钟限制调用10000次，并发不超过100 请求参数说明（json）： 无 返回参数说明： 参数 类型 是否必传 名称及描述 code int 是 状态码 message string 是 描述信息 result object 是 返回结果 result.quota list 是 每日预热配额使用信息 result.quota[].used int 是 每日预热已使用条数 result.quota[].surplus int 是 每日预热剩余条数 result.quota[].max int 是 每日预热最大条数 result.quota[].domains list 是 预热的域名列表，按配置分组，如果域名没有配置，将使用default的配额 result.concurrencys list 是 每次提交预加载最大条数信息 result.concurrencys[].concurrency 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 } ] } } 错误码请参考：API返回参数code和message含义

参数 类型 是否必传 名称 描述 domain list<string> 是 域名 域名列表 starttime int 是 开始时间戳 开始时间戳,单位秒 endtime int 是 结束时间戳 结束时间戳,单位秒

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

参数 类型 是否必传 名称及描述 code int 是 状态码 message string 是 描述信息 submitid string 否 解封提交id result list< object > 否 返回结果 result:allowid string 否 解封任务id result:forbidid string 否 封禁任务id result:forbidurl string 否 封禁任务的url

项目 描述 语法 headers, err ctyun.resp.getheaders(maxheaders?, raw?) 作用 获取响应头。 入参 maxheaders : numbe类型，缺省为100， 表示最多返回头部数量，为0表示不限制。 raw : bool类型，缺省为false，false 表示表头名称转成纯小写。 返回值 headers : table，保存全部返回的响应头，重复响应头的值为table。 err：字符串类型，错误描述，正确时为nil。 注意：建议ctyun.req.enrollheaderback 回调函数内使用。

参数 类型 是否必传 名称 描述 domain list 否 域名 域名列表 starttime int 是 开始时间戳 开始时间戳,单位秒 endtime int 是 结束时间戳 结束时间戳,单位秒 httpProtocol int 否 协议类型 协议类型，不传默认全部协议类型。 0（http），1（https）

参数 类型 是否必传 名称 描述 starttime int 是 开始时间戳 起始时间，时间戳(秒)。 endtime int 是 结束时间戳 结束时间，时间戳(秒)。 domain string 是 域名

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

接口描述：调用本接口查询解封任务额度 请求方式：get 请求路径：/allowtask/queryallowtaskquota 使用说明： 单个用户一分钟限制调用10000次，并发不超过100 请求参数说明（json）： 无 返回参数说明： 参数 类型 是否必传 名称及描述 code int 是 状态码 message string 是 描述信息 result dict 否 返回结果 result.max int 否 每日屏蔽最大条数 result.used int 否 每日屏蔽已使用条数 result.surplus int 否 每日屏蔽剩余条数 result.singlecommitmax int 否 每次提交屏蔽最大条数 示例： 请求路径： 请求参数： 无 响应结果： { "code": 100000, "message": "success", "result": { "surplus": 4999, "max": 5000, "used": 1, "singlecommitmax": 200 } } 错误码请参考：参数code和message含义

接口描述：调用本接口获取日志的下载路径，返回的文件大小，MD5（客户按需开启），供核验日志文件完整性。 请求方式：get 请求路径：/log/getofflinedownloadaddress 使用说明： 单个用户一分钟限制调用10000次，并发不超过100 请求参数说明： 参数 类型 是否必传 名称 描述 starttime int 是 开始时间戳 起始时间，时间戳(秒)。 endtime int 是 结束时间戳 结束时间，时间戳(秒)。 domain string 是 域名 返回参数说明： 参数 类型 是否必传 名称及描述 code int 是 状态码 message string 是 描述信息 result list 否 返回结果列表 result[].domain string 否 域名 result[].logs list 否 下载日志地址列表 result[].logs[].timepoint string 否 日志文件包含的时间点，北京时间，格式为： YYYYMMDD HH:MM result[].logs[].size int 否 日志文件大小，单位：B result[].logs[].url string 否 日志文件下载路径 result[].logs[].md5 string 否 日志文件md5值 示例： 请求路径： 请求： 返回结果： {     "code": 100000,     "message": "success",     "result": [         {             "domain": "aaa.ctyun.cn",             "logs": [                 {                     "size": 42923546,                     "url": "                     "md5": null,                     "timepoint": "20220906 05:25"                 },                 {                     "size": 167460282,                     "url": "                     "md5": null,                     "timepoint": "20220906 05:25"                 }             ]         }     ] } 错误码请参考：参数code和message含义

参数 是否必填 参数类型 说明 示例 下级对象 ip 否 string 节点ip地址 1.1.1.1 status 否 string ip状态，normal（正常），abnormal（非正常），noctyun（非天翼云ip） normal

参数 类型 是否必传 名称及描述 code int 是 状态码 message string 是 描述信息 submitid string 是 预热提交id result list 是 创建的预热任务列表 result[].url string 是 预热URL result[].taskid string 是 预热任务id

接口描述：调用本接口创建刷新任务 请求方式：post 请求路径：/refreshtask/createrefreshtask 使用说明： 单个用户一分钟限制调用10000次，并发不超过100 请求参数说明（json）： 参数 类型 是否必传 名称 描述 tasktype int 是 刷新类型 1(url);2(目录dir);3(正则匹配re) values list 是 刷新参数值 刷新类型为url时单次最多1000条，类型为dir和re时单次最多50条。 返回参数说明： 参数 类型 是否必传 名称及描述 code int 是 状态码 message string 是 描述信息 submitid string 是 提交id result list 是 返回包含任务id的列表 result[].taskid string 是 任务id result[].url string 是 刷新的URL 示例： 请求路径： 示例1： 请求参数： { "tasktype": 1, "values": [ " " " ] } 返回结果： { "code": 100000, "message": "success", "submitid": "cf48cdece3160f174a5f3026d52991ee", "result": [ { "taskid": "e12a05dc190045af2645f4b8bbe4135f", "url": " } ] } 错误码请参考：API返回参数code和message含义

2）attackDataList参数 参数 类型 是否必返回 名称及描述 attackKey string 否 攻击对应的具体值 attackNum number 否 攻击次数 示例： 请求路径： 示例1： 请求参数： json { "request":{ "domain":"ctyun.cn", "protectionModule":"CC", "type":"IP", "startTime":"20221108T00:00:00Z", "endTime":"20221108T23:59:59Z", "pageSize":"10", "pageNum":"1" }, 返回结果： json { "respone":{ "code":10000, "message":"success", "data":{ "attackDataList":{ "attackKey":"1.1.1.1", "attackNum":100 }, "total":1 } } 错误码请参考：API返回参数code和message含义

参数 类型 名称及描述 code int 状态码 message string 描述信息 result object 证书信息 resultexpires int 证书过期时间 resultid int 证书ID resultissue int 证书颁发时间 resultcreated int 证书创建时间 resultname string 证书备注名称 resultsans list 证书绑定的域名 resultcn string 证书通用名称 resultcerts string 证书公钥信息 resultkkey string 证书私钥信息

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