更新时间:2024-11-18 GMT+08:00

查询误报屏蔽规则列表

功能介绍

查询误报屏蔽规则列表

URI

GET /v1/edgesec/configuration/http/policies/{policy_id}/ignore-rule

表1 路径参数

参数

是否必选

参数类型

描述

policy_id

String

策略id

表2 Query参数

参数

是否必选

参数类型

描述

status

Integer

规则开关状态

page

Integer

分页查询参数,第page页

pagesize

Integer

分页查询参数,每页显示pagesize条记录

rule

String

不检测模块类型

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

auth token

响应参数

状态码: 200

表4 响应Body参数

参数

参数类型

描述

total

Integer

策略下防护规则数量

items

Array of ShowHttpIgnoreRuleResponseBody objects

防护规则列表

表5 ShowHttpIgnoreRuleResponseBody

参数

参数类型

描述

id

String

规则id

name

String

规则名称

policy_id

String

规则所在策略id

policy_name

String

规则所在策略名称

timestamp

Long

创建规则时间戳

description

String

规则描述

status

Integer

规则开关状态

url

String

误报路径

rule

String

规则编号

mode

Integer

误报屏蔽模式,默认为0即旧模式

domains

Array of strings

域名列表

url_logic

String

屏蔽规则url类型(前缀:prefix,等于:equal)

advanced

HttpIgnoreRuleCondition object

条件列表参数较为复杂,存在级联关系,建议同时使用控制台上的添加误报屏蔽规则,单击F12键查看路径后缀为/ignore-rule,方法为POST的请求参数,便于理解参数的填写

conditions

Array of HttpIgnoreRuleCondition objects

命中条件

hit_num

Integer

命中次数

update_time

Long

最后更新时间戳

clear_time

Long

上一次命中次数清零时间戳

表6 HttpIgnoreRuleCondition

参数

参数类型

描述

category

String

字段类型,可选值有ip、url、params、cookie、header

index

String

字段类型为ip且子字段为客户端ip时,不需要传index参数;子字段类型为X-Forwarded-For时,值为x-forwarded-for;字段类型为params、header、cookie并且子字段为自定义时,index的值为自定义子字段

contents

Array of strings

内容列表

logic_operation

String

匹配逻辑,匹配逻辑根据字段类型变化,字段类型为ip时,匹配逻辑支持(equal:等于,not_equal:不等于),字段类型为url、header、params、cookie时,匹配逻辑支持(equal:等于,not_equal:不等于,contain:包含,not_contain:不包含,prefix:前缀为,not_prefix:前缀不为,suffix:后缀为,not_suffix:后缀不为,regular_match:正则匹配,regular_not_match:正则不匹配)

value_list_id

String

引用表id

size

Long

若防护规则涉及阈值,即使用该字段

check_all_indexes_logic

Integer

1.所有子字段/2.任意子字段

状态码: 400

表7 响应Body参数

参数

参数类型

描述

error_code

String

标准化错误码:服务名.八位数字编码

error_msg

String

清晰的错误信息

encoded_authorization_message

String

对接IAM5.0的服务,拒绝访问时需要返回IAM的相关响应

状态码: 401

表8 响应Body参数

参数

参数类型

描述

error_code

String

标准化错误码:服务名.八位数字编码

error_msg

String

清晰的错误信息

encoded_authorization_message

String

对接IAM5.0的服务,拒绝访问时需要返回IAM的相关响应

状态码: 500

表9 响应Body参数

参数

参数类型

描述

error_code

String

标准化错误码:服务名.八位数字编码

error_msg

String

清晰的错误信息

encoded_authorization_message

String

对接IAM5.0的服务,拒绝访问时需要返回IAM的相关响应

请求示例

响应示例

状态码

状态码

描述

200

OK

400

请求失败

401

token权限不足

500

服务器内部错误

错误码

请参见错误码