更新时间:2022-02-22 GMT+08:00

查询误报屏蔽规则列表

功能介绍

查询某个策略下所有的误报屏蔽规则列表。

URI

  • URI格式

    GET /v1/{project_id}/waf/policy/{policy_id}/ignore?path={path}&offset={offset}&limit={limit}

  • 参数说明
    表1 Path参数说明

    名称

    是否必选

    参数类型

    说明

    project_id

    String

    用户操作的项目ID。

    policy_id

    String

    策略ID。

    path

    String

    误报路径。

    offset

    Long

    指定返回的页数,取值范围为:[0, 65535],默认值为0。

    limit

    Long

    指定查询返回每页记录的最大条数,取值范围为:(0, 50],默认值为10。

请求消息

请求参数

响应消息

响应参数
表2 响应参数说明

名称

参数类型

说明

total

Integer

Policy的总数量。

items

表3

误报屏蔽规则对象列表。

表3 items

名称

参数类型

说明

id

String

误报屏蔽规则ID。

policy_id

String

策略ID。

path

String

误报路径,完整的URL链接,不包含域名。

event_id

String

防护事件的ID。

event_type

String

事件类型。

rule

String

屏蔽的规则ID,由6位数字组成,不能为空。

timestamp

Long

创建误报屏蔽规则的时间。

示例

如下以查询误报屏蔽规则列表,返回记录条数为“2”为例。

响应样例
{
  "total": 2,
  "items": [{
      "id": "3a9b5c0f96784ec8abd8ba61a98064ef",
      "policy_id": "yuc0e55865544d1f8c95cf71df108c6b",
      "event_id": "02d3ac3cd99f440daf8d38e03cf0e2a6",
      "event_type": "xss",
      "rule": "100001",
      "timestamp": 1499817600,
      "path": "/a"
    }, {
      "id": "44d887434169475794b2717438f7fa78",
      "policy_id": "yuc0e55865544d1f8c95cf71df108c6b",
      "event_id": "f8c74b656a9d4d329dbcefe0969cc427",
      "event_type": "sqli",
      "rule": "100002",
      "timestamp": 1499817600,
      "path": "/a"
    }
  ]
}

状态码

表4描述的是API返回的正常状态码。
表4 状态码

状态码

编码

状态说明

200

OK

客户端请求已处理成功。

异常状态码,请参见状态码