查询安全总览分类统计TOP信息
功能介绍
查询安全总览分类统计TOP信息，包含受攻击域名 、攻击源ip、受攻击URL、攻击来源区域、攻击事件分布。需要注意的是，安全总览相关的接口，暂时不能支持任意时间的查询。只能支持 console上显示的 昨天，今天，3天，7天和30天 数据查询。
URI
GET /v1/{project_id}/waf/overviews/classification
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
用户操作的项目id |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
enterprise_project_id |
否 |
String |
您可以通过调用企业项目管理服务（EPS）的查询企业项目列表接口（ListEnterpriseProject）查询企业项目id |
|
from |
是 |
Long |
起始时间（13位毫秒时间戳），需要和to同时使用 |
|
to |
是 |
Long |
结束时间（13位毫秒时间戳），需要和from同时使用 |
|
top |
否 |
Integer |
要查询的前几的结果，最大值为10，默认值为5。 |
|
hosts |
否 |
String |
域名id列表，通过查询云模式防护域名列表（ListHost）获取域名id或者通过独享模式域名列表（ListPremiumHost）获取域名id。默认不传，查询该项目下所有防护域名的top业务异常统计信息。当有需要传多个域名时，传参参考请求示例。 |
|
instances |
否 |
String |
要查询引擎实例列表（仅独享或者ELB实例化模式涉及） |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
租户 token |
|
Content-Type |
是 |
String |
内容类型 缺省值：application/json;charset=utf8 |
响应参数
状态码： 200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
domain |
DomainClassificationItem object |
受攻击域名 |
|
attack_type |
AttackTypeClassificationItem object |
攻击事件分布 |
|
ip |
IpClassificationItem object |
攻击源ip |
|
url |
UrlClassificationItem object |
攻击url |
|
geo |
GeoClassificationItem object |
攻击来源区域 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
total |
Integer |
DomainItem的总数量 |
|
items |
Array of DomainItem objects |
DomainItem详细信息 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
total |
Integer |
AttackTypeItem的总数量 |
|
items |
Array of AttackTypeItem objects |
AttackTypeItem详细信息 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
total |
Integer |
IpItem的总数量 |
|
items |
Array of IpItem objects |
IpItem详细信息 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
total |
Integer |
UrlItem的总数量 |
|
items |
Array of UrlItem objects |
UrlItem详细信息 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
total |
Integer |
GeoItem的总数量 |
|
items |
Array of GeoItem objects |
GeoItem详细信息 |
状态码： 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/classification?enterprise_project_id=0&from=1652889600354&to=1655435681354&top=10&hosts=1bac09440a814aa98ed08302c580a48b&hosts=5a532f83a2fb476ba51ca1de7b1ebc43
响应示例
状态码： 200
请求成功
{
"attack_type" : {
"total" : 1,
"items" : [ {
"key" : "custom_custom",
"num" : 2
} ]
},
"domain" : {
"total" : 2,
"items" : [ {
"key" : "www.whitelist.com",
"num" : 2,
"web_tag" : "www.whitelist.com"
}, {
"key" : "zbx002.apayaduo.cn",
"num" : 2,
"web_tag" : ""
} ]
},
"geo" : {
"total" : 1,
"items" : [ {
"key" : "10.142.4.15",
"num" : 2
} ]
},
"ip" : {
"total" : 1,
"items" : [ {
"key" : "10.142.4.15",
"num" : 2
} ]
},
"url" : {
"total" : 1,
"items" : [ {
"key" : "/attack",
"num" : 2,
"host" : "www.whitelist.com"
} ]
}
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
请求成功 |
|
400 |
请求失败 |
|
401 |
token权限不足 |
|
500 |
服务器内部错误 |
错误码
请参见错误码。
