DescAttackEvent-查询攻击事件列表--DDoS防护-火山引擎

文档中心

立即注册

导航

DescAttackEvent-查询攻击事件列表

最近更新时间：2024.03.11 11:54:32首次发布时间：2023.12.13 17:08:15

查询指定原生防护实例下的攻击事件列表。

请求说明

请求方式：POST
请求地址：https://open.volcengineapi.com/?Action=DescAttackEvent&Version=2022-01-01

请求参数

以下为该接口的 Query 参数和 Body 参数，其他公共参数请参见公共参数。

Query

参数	类型	是否必填	示例值	描述
Action	String	是	`DescAttackEvent`	接口名称。与实际业务的接口名称一致。
Version	String	是	`2022-01-01`	接口的版本。DDoS 原生防护提供的 OpenAPI 版本为`2022-01-01`。

Body

参数	类型	是否必填	示例值	描述
CurrPage	Integer	否	`1`	当前页面的页码。例如，`1`表示展示查询到的第 1 页事件信息。默认为`1`。
PageSize	Integer	否	`10`	单个页面显示的事件数量。默认为`10`。
InsId	Integer	是	`44`	需要查询攻击事件的实例 ID。若需要获取实例 ID，可调用DescInstanceList-查询原生防护实例列表接口获取。
BeginTime	Integer	是	`1693560540`	设置查询的起始时间，Unix 秒级时间戳，EndTime 要大于 BeginTime。
EndTime	Integer	是	`1698744600`	设置查询的结束时间，Unix 秒级时间戳，EndTime 要大于 BeginTime。
IpList	Array of strings	否	`["180.184..","180.184.."]`	需要查询攻击事件的防护 EIP。不填写则查询该实例下所有 EIP 发生的攻击事件。

返回参数

参数	类型	示例值	描述
Result	Result object	-	攻击事件列表。
PageInfo	PageInfo object	-	页面信息。

Result

参数	类型	示例值	描述
AttackedIpNum	Integer	`1`	该实例下被攻击的 IP 数量。
TotalIpNum	Integer	`3`	该实例下的 IP 总数。
AttackCount	Integer	`8`	该实例下的攻击事件数量。
Attacks	Array of Attacks objects	-	攻击事件详情。

Attacks

参数	类型	示例值	描述
Id	Integer	`1`	攻击事件 ID。
AttackType	String	`SYN Flood`	攻击类型。
Ip	String	`180.184..`	被攻击的 IP。
Status	Integer	`2`	攻击状态。 1：攻击中。 2：攻击结束。
PeakDropKbps	Integer	`80817`	攻击带宽峰值。单位：Kbps。
PeakDropPps	Integer	`152646`	攻击包速率峰值。单位：pps。
Duration	Integer	`4269`	攻击持续时间。单位：秒。
StartTime	Integer	`1693920180`	攻击开始时间，Unix 秒级时间戳。
EndTime	Integer	`1693924449`	攻击结束时间，Unix 秒级时间戳。

PageInfo

参数	类型	示例值	描述
TotalCount	Integer	`3`	查询到的符合条件的攻击事件总数。
PageSize	Integer	`10`	单个页面显示的事件数量。
CurrentPage	Integer	`1`	当前页面的页码。例如，`1`表示展示查询到的第 1 页事件信息。
Count	Integer	`3`	当前页面中包含的事件数量。

请求示例

POST https://open.volcengineapi.com/?Action=DescAttackEvent&Version=2022-01-01
X-Date: 20230711T035055Z
Authorization: HMAC-SHA256 Credential=AKLTNGU0OGEyMT***/20230711/cn-beijing/origin_defence/request, SignedHeaders=content-type;x-content-sha256;x-date, Signature=da4fac562d00f41ad8***

{
  "CurrPage": 1,
  "PageSize": 10,
  "InsId": 44,
  "BeginTime": 1693560540,
  "EndTime": 1698744600,
  "IpList": [
    "180.184.**.**"
  ]
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "202311161734246BEE1DD4ED914596****",
        "Action": "DescAttackEvent",
        "Version": "2022-01-01",
        "Service": "origin_defence",
        "Region": "cn-beijing"
    },
    "Result": {
        "AttackedIpNum": 1,
        "TotalIpNum": 3,
        "AttackCount": 3,
        "Attacks": [
            {
                "Id": 606,
                "AttackType": "SYN Flood",
                "Ip": "180.184.**.**",
                "Status": 2,
                "PeakDropKbps": 80817,
                "PeakDropPps": 152646,
                "Duration": 4269,
                "StartTime": 1693920180,
                "EndTime": 1693924449
            },
            {
                "Id": 604,
                "AttackType": "SYN Flood",
                "Ip": "180.184.**.**",
                "Status": 2,
                "PeakDropKbps": 32796,
                "PeakDropPps": 61950,
                "Duration": 1869,
                "StartTime": 1693915020,
                "EndTime": 1693916890
            },
            {
                "Id": 603,
                "AttackType": "SYN Flood",
                "Ip": "180.184.**.**",
                "Status": 2,
                "PeakDropKbps": 32998,
                "PeakDropPps": 62005,
                "Duration": 14319,
                "StartTime": 1693832970,
                "EndTime": 1693847290
            }
        ]
    },
    "PageInfo": {
        "TotalCount": 3,
        "PageSize": 10,
        "CurrentPage": 1,
        "Count": 3
    }
}