更新误报屏蔽规则

policy_id

是

String

策略id

rule_id

是

String

防护规则id

X-Auth-Token

是

String

auth token

name

否

String

规则名称

description

否

String

规则描述，最长512字符

status

否

Integer

规则开关状态

url

否

String

误报路径

rule

是

String

需要屏蔽的规则，可屏蔽一个或者多个，屏蔽多个时使用半角符;分隔

• 当需要屏蔽某一条内置规则时，该参数值为该内置规则id,可以在Web应用防火墙控制台的防护策略->策略名称->Web基础防护的高级设置->防护规则中查询；也可以在防护事件的事件详情中查询内置规则id

• 当需要屏蔽web基础防护某一类规则时，该参数值为需要屏蔽的web基础防护某一类规则名。其中，xss：xss攻击；webshell：网站木马；vuln：其他类型攻击；sqli：sql注入攻击；robot：恶意爬虫；rfi：远程文件包含；lfi：本地文件包含；cmdi：命令注入攻击

• 当需要屏蔽Web基础防护模块，该参数值为：all

• 当需要屏蔽规则为所有检测模块时，该参数值为：bypass

mode

是

Integer

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

domains

是

Array of strings

防护域名或防护网站，数组长度为0时，代表规则对全部域名或防护网站生效

url_logic

否

String

屏蔽规则url类型（前缀：prefix，等于：equal）

advanced

否

HttpIgnoreRuleCondition object

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

conditions

是

Array of HttpIgnoreRuleCondition objects

命中条件

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.任意子字段

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

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

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.任意子字段

error_code

String

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

error_msg

String

清晰的错误信息

encoded_authorization_message

String

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

error_code

String

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

error_msg

String

清晰的错误信息

encoded_authorization_message

String

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

error_code

String

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

error_msg

String

清晰的错误信息

encoded_authorization_message

String

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

200

请求成功

400

请求失败

401

token权限不足

500

服务器内部错误