You need to enable JavaScript to run this app.
导航

ListProhibition

最近更新时间2023.11.10 18:24:48

首次发布时间2023.11.10 18:24:48

查询符合条件的封禁列表信息。

请求说明

  • 请求方式:POST
  • 请求地址:https://open.volcengineapi.com/?Action=ListProhibition&Version=2020-12-09

请求参数

参数

类型

是否必填

示例值

描述

StartTime

String

1696830193

起始时间。Unix 秒级时间戳,EndTime 要大于StartTime。

EndTime

String

1696920201

结束时间。Unix 秒级时间戳,EndTime 要大于StartTime。

Reason

Array of strings

["black","httpflood"]

攻击类型筛选。如果攻击类型为空,则查询所有攻击类型封禁的 IP。

  • black:访问黑名单。
  • geo_black:地理位置访问控制。
  • httpflood:CC 攻击。
  • web_vulnerability:Web 漏洞攻击
  • bot:Bot 攻击
  • sensitive_info:敏感信息泄露
  • route_abnormal:API 路由异常
  • param_abnormal:API 参数异常

Host

String

example.volcwaf001.com

需要查询的网站域名。

LetterOrderBy

String

ASC

列表显示顺序。

  • ASC:按攻击源 IP 升序。
  • DESC:按攻击源 IP 降序。

Page

Integer

1

查询页码,默认为 1。

PageSize

Integer

20

单页条数,默认为 10。范围为 1~100。

返回参数

参数

类型

示例值

描述

PageInfo

PageInfo object

页面信息。

Result

Result object

返回结果。

PageInfo

参数

类型

示例值

描述

Count

Integer

0

当前页面中匹配的规则数量。

CurrentPage

Integer

1

当前页面的页码。

PageSize

Integer

10

单个页面显示的规则条数。

TotalCount

Integer

1

查询到的符合条件的规则总数。

Result

参数

类型

示例值

描述

IpAggGroup

Array of IpAggGroup objects

攻击 IP 详情。

IpAggGroup

参数

类型

示例值

描述

Ip

String

1.1.1.1

攻击源 IP。

DropCount

Integer

67243

该攻击源 IP 的攻击次数。

Reason

Array of strings

["httpflood": 60197, "web_vulnerability": 7046]

不同攻击类型对应的攻击次数。

  • black:访问黑名单。
  • geo_black:地理位置访问控制。
  • httpflood:CC 攻击。
  • web_vulnerability:Web 漏洞攻击
  • bot:Bot 攻击
  • sensitive_info:敏感信息泄露
  • route_abnormal:API 路由异常
  • param_abnormal:API 参数异常

Status

Integer

0

IP 封禁状态。

  • 0:未处理
  • 1:永久加白
  • 2:取消加白
  • 3:永久封禁
  • 4:取消封禁

UpdateTime

String

2023-10-10T14:59:29+08:00

状态更新时间。

RuleTag

String

A000000004122

封禁规则 ID。

RuleName

String

封禁管理快速添加_20231010144648

封禁规则名称。

请求示例

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

{
  "StartTime": 1696830193,
  "EndTime": 1696920201,
  "Reason": [
    "black"
  ],
  "Host": "example.volcwaf001.com",
  "LetterOrderBy": "ASC",
  "Page": 1,
  "PageSize": 10
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20231013200325B13637DF46E9C7D0****",
        "Action": "ListProhibition",
        "Version": "2020-12-09",
        "Service": "waf",
        "Region": "cn-beijing"
    },
    "PageInfo": {
        "TotalCount": 36,
        "PageSize": 10,
        "CurrentPage": 1,
        "Count": 10
    },
    "Result": {
        "IpAggGroup": [
            {
                "Ip": "19.252.**.**",
                "DropCount": 6806,
                "Reason": {
                    "web_vulnerability": 6806
                },
                "Status": 2,
                "UpdateTime": "2023-10-10T14:59:29+08:00",
                "RuleTag": "A000000004122",
                "RuleName": "封禁管理快速添加_20231010144648"
            },
            {
                "Ip": "19.252.**.**",
                "DropCount": 37820,
                "Reason": {
                    "web_vulnerability": 37820
                },
                "Status": 4,
                "UpdateTime": "2023-10-10T15:14:28+08:00",
                "RuleTag": "B000000025959",
                "RuleName": "封禁管理快速添加_20231010150810"
            }
        ]
    }
}