文档中心

Web应用防火墙

封禁管理

ListProhibition - 查询封禁 IP 信息

查询符合条件的封禁 IP 列表信息，包括攻击源 IP、攻击次数和 IP 状态等信息。

请求说明

请求方式：POST

请求地址：https://waf.volcengineapi.com/?Action=ListProhibition&Version=2023-12-25

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Query

Action String 必选示例值：ListProhibition

接口名称。当前 API 的名称为 ListProhibition。

Version String 必选示例值：2023-12-25

接口版本。当前 API 的版本为 2023-12-25。

Body

Host String 必选示例值：example.volcwaf001.com

待查询的网站域名。

EndTime Integer 必选示例值：1732689644

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

Ip String 可选示例值：1.2.**.**

IP 地址。默认为空，支持精确搜索、模糊搜索或者网段搜索。

LetterOrderBy String 可选示例值：DESC

按攻击源 IP 排序。默认为 ASC。

ASC：按攻击源 IP 升序。

DESC：按攻击源 IP 降序。

Page Integer 可选示例值：1

查询页码，默认为 1。

PageSize Integer 可选示例值：10

单页条数，默认为 10。范围为 1～100。

PathOrderBy String 可选示例值：ASC

按路径排序。默认为 DESC。

ASC：按路径升序。

DESC：按路径降序。

Reason String[] 可选示例值：["black"]

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

black：访问黑名单。

geo_black：地理位置访问控制。

httpflood：CC 攻击。

web_vulnerability：Web 漏洞攻击

bot：Bot 攻击

sensitive_info：敏感信息泄露

route_abnormal：API 路由异常

param_abnormal：API 参数异常

StartTime Integer 必选示例值：1732599640

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

Status Integer[] 可选示例值：[0]

IP 封禁状态。

0：未处理

1：永久加白

2：取消加白

3：永久封禁

4：取消封禁

TimeOrderBy String 可选示例值：ASC

按 IP 时间排序。默认为 DESC。

ASC：按 IP 时间升序。

DESC：按 IP 时间降序。

ProjectName String 可选示例值：default

资源所属项目名称。获取方式可参考ListProjectResources - 获取项目资源列表。

返回参数

IpAggGroup Object[] 可选示例值：--

封禁 IP 详情。

DropCount Integer 可选示例值：67243

该攻击源 IP 的攻击次数。

Ip String 可选示例值：1.2.**.**

查询的地址或地址段

Reason Object 可选示例值：--

封禁原因。

black Integer 可选示例值：1

访问黑名单次数。

bot Integer 可选示例值：1

Bot 攻击次数。

geo_black Integer 可选示例值：1

地理位置访问控制次数。

httpflood Integer 可选示例值：1

CC 攻击次数。

param_abnormal Integer 可选示例值：1

API 参数异常次数。

route_abnormal Integer 可选示例值：1

API 路由异常次数。

sensitive_info Integer 可选示例值：1

敏感信息泄露次数。

web_vulnerability Integer 可选示例值：1

Web 漏洞攻击次数。

RuleName String 可选示例值：封禁管理快速添加_2023101014****

封禁规则名称。

RuleTag String 可选示例值：F00000000****

封禁规则 ID。

Status Integer 可选示例值：0

IP 封禁状态。

0：未处理

1：永久加白

2：取消加白

3：永久封禁

4：取消封禁

UpdateTime String 可选示例值：2024-02-05T16:05:57+08:00

更新时间。

CurrentPage Integer 可选示例值：1

当前页码。

PageSize Integer 可选示例值：10

当前分页的行数。

TotalCount Integer 可选示例值：15

符合查询条件的总条数。

Count Integer 可选示例值：5

当前数据数量。

错误码

您可访问公共错误码，获取更多错误码信息。

输入示例 1

输入示例

POST https://waf.volcengineapi.com/?Action=ListProhibition&Version=2023-12-25

{
    "Host": "example.volcwaf001.com",
    "EndTime": 1732689644,
    "Ip": "1.2.**.**",
    "LetterOrderBy": "DESC",
    "Page": 1,
    "PageSize": 10,
    "PathOrderBy": "ASC",
    "Reason": [
        "black"
    ],
    "StartTime": 1732599640,
    "Status": [
        0
    ],
    "TimeOrderBy": "ASC",
    "ProjectName": "default"
}

输出示例

{
    "ResponseMetadata": {
        "RequestId": "20230604110420****100232280022D31",
        "Action": "ListProhibition",
        "Version": "2023-12-25",
        "Service": "waf",
        "Region": "cn-beijing"
    },
    "Result": {
        "IpAggGroup": [
            {
                "Ip": "1.2.**.**",
                "Reason": {
                    "bot": 1,
                    "black": 1,
                    "geo_black": 1,
                    "httpflood": 1,
                    "param_abnormal": 1,
                    "route_abnormal": 1,
                    "sensitive_info": 1,
                    "web_vulnerability": 1
                },
                "Status": 0,
                "RuleTag": "F00000000****",
                "RuleName": "封禁管理快速添加_2023101014****",
                "DropCount": 67243,
                "UpdateTime": "2024-02-05T16:05:57+08:00"
            }
        ],
        "CurrentPage": 1,
        "PageSize": 10,
        "TotalCount": 15,
        "Count": 5
    }
}

最近更新时间：2026.01.20 15:17:10

这个页面对您有帮助吗？

有用

无用