查询安全总览中请求次数时间线统计数据
功能介绍
查询安全总览中请求次数时间线统计数据。需要注意的是，安全总览相关的接口，暂时不能支持任意时间的查询。只能支持 console上显示的 昨天，今天，3天，7天和30天 数据查询。
URI
GET /v1/{project_id}/waf/overviews/request/timeline
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
项目ID，对应控制台用户名->我的凭证->项目列表->项目ID |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
enterprise_project_id |
否 |
String |
您可以通过调用企业项目管理服务（EPS）的查询企业项目列表接口（ListEnterpriseProject）查询企业项目id |
|
from |
是 |
Long |
起始时间（13位毫秒时间戳），需要和to同时使用 |
|
to |
是 |
Long |
结束时间（13位毫秒时间戳），需要和from同时使用 |
|
hosts |
否 |
Array |
域名id列表，通过查询云模式防护域名列表（ListHost）获取域名id或者通过独享模式域名列表（ListPremiumHost）获取域名id。默认不传，查询该项目下所有防护域名的top业务异常统计信息。 |
|
instances |
否 |
Array |
要查询引擎实例id列表 |
|
group_by |
否 |
String |
展示维度，按天展示时传"DAY"；默认不传，按照分钟展示 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
用户Token，通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值) |
|
Content-Type |
是 |
String |
内容类型 缺省值：application/json;charset=utf8 |
响应参数
状态码： 200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
[数组元素] |
Array of StatisticsTimelineItem objects |
安全统计的请求时间线数据 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
key |
String |
键值，包括请求总量（ACCESS）、Bot攻击防护（CRAWLER）、攻击总量（ATTACK）、Web基础防护（WEB_ATTACK）、精准防护（PRECISE）、CC攻击防护（CC） |
|
timeline |
Array of TimeLineItem objects |
对应键值的时间线统计数据 |
状态码： 400
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_code |
String |
错误码 |
|
error_msg |
String |
错误信息 |
状态码： 401
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_code |
String |
错误码 |
|
error_msg |
String |
错误信息 |
状态码： 500
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_code |
String |
错误码 |
|
error_msg |
String |
错误信息 |
请求示例
GET https://{Endpoint}/v1/{project_id}/waf/overviews/request/timeline?enterprise_project_id=0&from=1650470400196&to=1650470450000
响应示例
状态码： 200
ok
[ {
"key" : "ACCESS",
"timeline" : [ {
"time" : 1650470400196,
"num" : 0
} ]
}, {
"key" : "PRECISE",
"timeline" : [ {
"time" : 1650470400196,
"num" : 0
} ]
}, {
"key" : "CRAWLER",
"timeline" : [ {
"time" : 1650470400196,
"num" : 0
} ]
}, {
"key" : "CC",
"timeline" : [ {
"time" : 1650470400196,
"num" : 0
} ]
}, {
"key" : "ATTACK",
"timeline" : [ {
"time" : 1650470400000,
"num" : 0
} ]
}, {
"key" : "WEB_ATTACK",
"timeline" : [ {
"time" : 1650470400196,
"num" : 0
} ]
} ]
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
ok |
|
400 |
请求失败 |
|
401 |
token权限不足 |
|
500 |
服务器内部错误 |
错误码
请参见错误码。
