DescribeThreatEventTopMetric - 查询安全事件Top统计数据 - Web 应用防火墙

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

当前API暂无授权信息透出。

请求参数

名称	类型	必填	描述	示例值
Metric	string	是	统计内容，不同的 Metric 对应不同的统计对象，取值为： time：表示按照攻击时间聚合统计并降序排序后，返回前 5 条数据。 src：表示按照攻击请求的源 IP 聚合统计并按照降序排序后，返回前 5 条数据。 target：表示按照攻击请求的 URL（不包含 query）聚合统计并按照降序排序后，返回前 5 条数据。 type：表示按照攻击类型聚合统计并降序排序后，返回前 5 条数据。 tools：表示按照攻击工具聚合统计并按照降序排序后，返回前 5 条数据。枚举值： src : src time : time type : type tools : tools target : target	time
EventId	string	是	安全事件 ID。	0b7ab137a065aab7656986***11db
InstanceId	string	是	WAF 实例的 ID。说明您可以调用 DescribeInstance 查询当前 WAF 实例的 ID。	waf_elasticity-cn-0xldbqt****
RegionId	string	否	WAF 实例所属地域。取值： cn-hangzhou：表示中国内地。 ap-southeast-1：表示非中国内地。	cn-hangzhou
ResourceManagerResourceGroupId	string	否	阿里云资源组 ID。	rg-acfm***q

返回参数

名称	类型	描述	示例值
	object
TopMetrics	array<object>	统计数据列表。
	object	统计数据。
Cnt	integer	统计的攻击次数。	20
Value	string	攻击值。统计对象（Metric）取值不同，代表的含义有所不同。 Metric 取值为 time 时，该字段表示攻击时间。 Metric 取值为 src 时，该字段表示攻击源 IP。 Metric 取值为 target 时，该字段表示攻击请求 URL。 Metric 取值为 type 时，该字段表示攻击类型。其中：dirscan 表示目录扫描，webscan 表示 Web 扫描，其他攻击类型详见CreateDefenseRule接口中自定义正则规则（regular_custom）中检测类型（detectType）的描述。 Metric 取值为 tools 时，该字段表示攻击工具。	115.28.209.212
Country	string	攻击源 IP 所属国家。说明仅当统计对象（Metric）取值为攻击源 IP（src）时，该字段返回值有意义。	CN
Region	string	攻击源 IP 所属地域。说明仅当统计对象（Metric）取值为攻击源 IP（src）时，该字段返回值有意义。	cn-hangzhou
RequestId	string	本次请求的 ID。	12EF3845-CCEB-4B84-AE60-2B49B*****EE5

示例

正常返回示例

JSON格式

{
  "TopMetrics": [
    {
      "Cnt": 20,
      "Value": "115.28.209.212",
      "Country": "CN",
      "Region": "cn-hangzhou"
    }
  ],
  "RequestId": "12EF3845-CCEB-4B84-AE60-2B49B*****EE5"
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。