DescAttackFlow-查询攻击流量信息--DDoS防护-火山引擎

文档中心

立即注册

导航

DescAttackFlow-查询攻击流量信息

最近更新时间：2025.05.28 19:05:42首次发布时间：2024.06.27 22:21:31

根据防护实例 ID 或者攻击事件 ID 查询特定时间范围内的攻击流量数据。

注意事项

参数优先级说明：攻击事件 ID > 防护资源 IP > 实例 ID。
实例 ID 和攻击事件 ID 至少需要传入其一。
调用时请将{region}替换成实际地域 ID，地域详情参见地域信息。

请求说明

请求方式：GET
请求地址：https://origin_defence.{region}.volcengineapi.com/?Action=DescAttackFlow&Version=2022-01-01

请求参数

Query

参数	类型	是否必选	示例值	描述
Action	String	是	`DescAttackFlow`	接口名称。当前 API 的名称为 `DescAttackFlow`。
Version	String	是	`2022-01-01`	接口版本。当前 API 的版本为 `2022-01-01`。
InsId	Integer	否	`20`	防护实例的 ID，攻击事件 ID 为空时必填，可调用DescInstanceList接口获取具体值。说明其请求优先级低于攻击事件 ID。
Ip	String	否	`180.184.180.**`	防护资源 IP，为空时表示查询当前实例下所有防护资源 IP。说明其请求优先级高于实例 ID，但低于攻击事件 ID。
BeginTime	Integer	否	`1716293160`	查询起始时间，秒级时间戳。为空时则表示 30 分钟前。
EndTime	Integer	否	`1718885160`	查询结束时间，秒级时间戳。为空时则表示当前时间。
AtkId	Integer	否	`907`	攻击事件的 ID，防护实例 ID 为空时必填，可调用DescAttackEvent接口获取具体值。说明该参数有传入值时，其他参数可为空，且其请求优先级大于实例 ID 和防护资源 IP。

返回参数

参数	类型	示例值	描述
AtkKBpsFlow	Array of AtkKBpsFlow	`--`	攻击带宽趋势。
AtkPktsFlow	Array of AtkPktsFlow	`--`	攻击包速率趋势。
PeakAtkKBps	Integer	`126320`	攻击带宽峰值。
PeakAtkPps	Integer	`263168`	攻击包速率峰值。

AtkKBpsFlow

参数	类型	示例值	描述
Time	String	`1718872980`	攻击带宽数据采集时间，间隔为 60 秒。
Value	Integer	`126320`	该采集时间点的攻击带宽值，单位为 Kbps。

AtkPktsFlow

参数	类型	示例值	描述
Time	String	`1718872980`	攻击包速率数据采集时间，间隔为 60 秒。
Value	Integer	`263168`	该采集时间点的攻击包速率值，单位为 Pkts。

请求示例

POST https://origin_defence.{region}.volcengineapi.com/?Action=DescAttackEvent&Version=2022-01-01
{
    "BeginTime": 1712642400,
    "CurrPage": 1,
    "EndTime": 1712646000,
    "InsId": 66,
    "IpList": [
        "180.184.86.**",
        "180.184.87.**"
    ],
    "PageSize": 10
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20240620201457****70DA8D83C217409A",
        "Action": "DescAttackFlow",
        "Version": "2022-01-01",
        "Service": "origin_defence",
        "Region": "cn-beijing"
    },
    "Result": {
        "AtkKBpsFlow": [
            {
                "Time": "1718872560",
                "Value": 0
            },
            {
                "Time": "1718872980",
                "Value": 126320
            },
            {
                "Time": "1718873040",
                "Value": 124896
            },
            {
                "Time": "1718873760",
                "Value": 0
            }
        ],
        "AtkPktsFlow": [
            {
                "Time": "1718872560",
                "Value": 0
            },
            {
                "Time": "1718872980",
                "Value": 263168
            },
            {
                "Time": "1718873040",
                "Value": 260202
            },
            {
                "Time": "1718873760",
                "Value": 0
            }
        ],
        "PeakAtkKBps": 126320,
        "PeakAtkPps": 263168
    }
}