更新防护策略

功能介绍

部分更新防护策略。

URI

URI格式
 PUT /v1/{project_id}/waf/policy/{policy_id}

参数说明

表1 Path参数说明
名称	是否必选	参数类型	说明
project_id	是	String	用户操作的项目ID。
policy_id	是	String	策略ID。

请求消息

请求参数

表2 请求参数说明
名称	是否必选	参数类型	说明
name	否	String	策略名称。
action	否	表3	Policy规则命中后操作对象。 “block”：拦截。 “log”：仅记录不拦截。
options	否	表4	攻击防护类型开关对象。
level	否	Integer	防护等级。 “1”：表示低。 “2”：表示中。 “3”：表示高。
full_detection	否	Boolean	精准防护中的检测模式。 true：全检测。当用户的请求符合精准防护中的拦截条件时，不会立即拦截，WAF会继续执行其他防护的检测，待其他防护的检测完成后进行拦截。 false：短路检测。当用户的请求符合精准防护中的拦截条件时，便立刻终止检测，进行拦截。

表3 action
名称	是否必选	参数类型	说明
category	是	String	操作类型。 “block”：拦截。 “log”：仅记录不拦截。

表4 options
名称	是否必选	参数类型	说明
webattack	否	Boolean	Web攻击是否开启。 true：表示开启。 false：表示关闭。
common	否	Boolean	Web攻击的常规攻击检测是否开启。 true：表示开启。 false：表示关闭。
crawler	否	Boolean	Web攻击的爬虫检测是否开启。 true：表示开启。 false：表示关闭。
crawler_engine	否	Boolean	Web攻击的搜索引擎是否开启。 true：表示开启。 false：表示关闭。
crawler_scanner	否	Boolean	Web攻击的扫描器是否开启。 true：表示开启。 false：表示关闭。
crawler_script	否	Boolean	Web攻击的脚本工具是否开启。 true：表示开启。 false：表示关闭。
crawler_other	否	Boolean	Web攻击的其他爬虫是否开启。 true：表示开启。 false：表示关闭。
webshell	否	Boolean	Web攻击的Webshell是否开启。 true：表示开启。 false：表示关闭。
cc	否	Boolean	Web攻击的CC防护是否开启。 true：表示开启。 false：表示关闭。
custom	否	Boolean	Web攻击的精准访问防护是否开启。 true：表示开启。 false：表示关闭。
whiteblackip	否	Boolean	Web攻击的IP黑白名单是否开启。 true：表示开启。 false：表示关闭。
privacy	否	Boolean	Web攻击的隐私屏蔽是否开启。 true：表示开启。 false：表示关闭。
Ignore	否	Boolean	Web攻击的误报屏蔽是否开启。 true：表示开启。 false：表示关闭。
antitamper	否	Boolean	Web攻击的网页防篡改是否开启。 true：表示开启。 false：表示关闭。

响应消息

响应参数

表5 响应参数说明
名称	参数类型	说明
id	String	实例ID。
name	String	防护策略的名称。
options	表9	攻击防护类型开关对象。
action	表6	Web基础防护中的防护动作。 “block”：拦截。 “log”：仅记录不拦截。
level	Integer	防护等级。 “1”：表示低。 “2”：表示中。 “3”：表示高。
full_detection	Boolean	精准防护中的检测模式。 true：全检测。当用户的请求符合精准防护中的拦截条件时，不会立即拦截，WAF会继续执行其他防护的检测，待其他防护的检测完成后进行拦截。 false：短路检测。当用户的请求符合精准防护中的拦截条件时，便立刻终止检测，进行拦截。
hosts	Array	防护域名的ID。
timestamp	Long	创建策略的时间。

表6 action
名称	参数类型	说明
category	String	操作类型。 “block”：拦截。 “log”：仅记录不拦截。

表7 options
名称	参数类型	说明
webattack	Boolean	Web攻击是否开启。 true：表示开启。 false：表示关闭。
common	Boolean	Web攻击的常规攻击检测是否开启。 true：表示开启。 false：表示关闭。
crawler	Boolean	Web攻击的爬虫检测是否开启。 true：表示开启。 false：表示关闭。
crawler_engine	Boolean	Web攻击的搜索引擎是否开启。 true：表示开启。 false：表示关闭。
crawler_scanner	Boolean	Web攻击的扫描器是否开启。 true：表示开启。 false：表示关闭。
crawler_script	Boolean	Web攻击的脚本工具是否开启。 true：表示开启。 false：表示关闭。
crawler_other	Boolean	Web攻击的其他爬虫是否开启。 true：表示开启。 false：表示关闭。
webshell	Boolean	Web攻击的Webshell是否开启。 true：表示开启。 false：表示关闭。
cc	Boolean	Web攻击的CC防护是否开启。 true：表示开启。 false：表示关闭。
custom	Boolean	Web攻击的精准访问防护是否开启。 true：表示开启。 false：表示关闭。
whiteblackip	Boolean	Web攻击的IP黑白名单是否开启。 true：表示开启。 false：表示关闭。
privacy	Boolean	Web攻击的隐私屏蔽是否开启。 true：表示开启。 false：表示关闭。
Ignore	Boolean	Web攻击的误报屏蔽是否开启。 true：表示开启。 false：表示关闭。
antitamper	Boolean	Web攻击的网页防篡改是否开启。 true：表示开启。 false：表示关闭。

示例

如下以更新防护策略“policy_1”为例。

请求样例

{
          "name": "policy_1",
          "action": {
              "category": "block"
           },
           "options": {
               "webattack": true,
               "common": true,
               "crawler": true,
               "crawler_engine": true,
               "crawler_scanner": true,
               "crawler_script": true,
               "crawler_other": true,
               "webshell": true,
               "cc": true,
               "custom": true,
               "whiteblackip": true,
               "ignore": true,
               "privacy": true,
               "antitamper": true
            },
           "level": 1,
           "full_detection": false
}

响应样例

{
          "id": "xxxxxxxxxxxxxxxxxxxxxxxxx",
          "name": "policy_1",
          "action": {
              "category": "block"
           },
           "options": {
               "webattack": true,
               "common": true,
               "crawler": true,
               "crawler_engine": true,
               "crawler_scanner": true,
               "crawler_script": true,
               "crawler_other": true,
               "webshell": true,
               "cc": true,
               "custom": true,
               "whiteblackip": true,
               "ignore": true,
               "privacy": true,
               "antitamper": true
            },
           "level": 1,
           "full_detection": false,
           "hosts": [],
           "timestamp": 1499817612
}

状态码

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

表8 状态码
状态码	编码	状态说明
200	OK	客户端请求已处理成功。

异常状态码，请参见状态码。

父主题： 防护策略

上一篇：防护域名应用防护策略

下一篇：删除防护策略

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消