文档首页/ 边缘安全 EdgeSec/ API参考/ API/ HTTP防护策略管理/ 更新防护策略

更新时间：2026-09-14 GMT+08:00

更新防护策略

功能介绍

更新防护策略

URI

PUT /v1/edgesec/configuration/http/policies/{policy_id}

表1 路径参数
参数	是否必选	参数类型	描述
policy_id	是	String	防护策略id

请求参数

表2 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	是	String	auth token

表3 请求Body参数
参数	是否必选	参数类型	描述
name	否	String	防护策略名
action	否	HttpPolicyAction object	操作
options	否	HttpPolicyOption object	选项
level	否	Integer	防护等级
full_detection	否	Boolean	精准防护中的检测模式
robot_action	否	HttpPolicyAction object	操作
extend	否	Map<String,String>	扩展字段

表4 HttpPolicyOption
参数	是否必选	参数类型	描述
webattack	否	Boolean	基础防护是否开启
common	否	Boolean	常规检测是否开启
bot_enable	否	Boolean	所有反爬虫是否开启
crawler	否	Boolean	特征反爬虫是否开启
crawler_engine	否	Boolean	搜索engine是否开启
crawler_scanner	否	Boolean	扫描器是否开启
crawler_script	否	Boolean	脚本反爬虫是否开启
crawler_other	否	Boolean	其他爬虫是否开启
webshell	否	Boolean	Webshell检测是否开启
cc	否	Boolean	cc规则是否开启
custom	否	Boolean	精准防护是否开启
followed_action	否	Boolean	攻击惩罚是否开启
whiteblackip	否	Boolean	黑白名单防护是否开启
geoip	否	Boolean	地理位置规则是否开启
ignore	否	Boolean	误报屏蔽是否开启
privacy	否	Boolean	隐私屏蔽是否开启
antitamper	否	Boolean	网页防篡改规则是否开启
antileakage	否	Boolean	防敏感信息泄露规则是否开启
anticrawler	否	Boolean	脚本反爬虫规则是否开启
third_bot_river	否	Boolean	三方BOT是否开启

表5 HttpPolicyAction
参数	是否必选	参数类型	描述
category	否	String	防护等级
followed_action_id	否	String	攻击惩罚规则ID

响应参数

状态码：200

表6 响应Body参数
参数	参数类型	描述
id	String	防护策略id
name	String	防护策略名
level	Integer	防护等级
full_detection	Boolean	精准防护中的检测模式
action	HttpPolicyAction object	操作
robot_action	HttpPolicyAction object	操作
options	HttpPolicyOption object	选项
bind_host	Array of HttpPolicyBindHost objects	防护域名的信息
extend	Map<String,String>	扩展字段
wap_managed_ruleset_id	String	web基础防护托管规则集id

表7 HttpPolicyAction
参数	参数类型	描述
category	String	防护等级
followed_action_id	String	攻击惩罚规则ID

表8 HttpPolicyOption
参数	参数类型	描述
webattack	Boolean	基础防护是否开启
common	Boolean	常规检测是否开启
bot_enable	Boolean	所有反爬虫是否开启
crawler	Boolean	特征反爬虫是否开启
crawler_engine	Boolean	搜索engine是否开启
crawler_scanner	Boolean	扫描器是否开启
crawler_script	Boolean	脚本反爬虫是否开启
crawler_other	Boolean	其他爬虫是否开启
webshell	Boolean	Webshell检测是否开启
cc	Boolean	cc规则是否开启
custom	Boolean	精准防护是否开启
followed_action	Boolean	攻击惩罚是否开启
whiteblackip	Boolean	黑白名单防护是否开启
geoip	Boolean	地理位置规则是否开启
ignore	Boolean	误报屏蔽是否开启
privacy	Boolean	隐私屏蔽是否开启
antitamper	Boolean	网页防篡改规则是否开启
antileakage	Boolean	防敏感信息泄露规则是否开启
anticrawler	Boolean	脚本反爬虫规则是否开启
third_bot_river	Boolean	三方BOT是否开启

表9 HttpPolicyBindHost
参数	参数类型	描述
id	String	域名ID
hostname	String	域名

状态码：400

**表10** 响应Body参数
参数	参数类型	描述
error_code	String	标准化错误码：服务名.八位数字编码
error_msg	String	清晰的错误信息
encoded_authorization_message	String	对接IAM5.0的服务，拒绝访问时需要返回IAM的相关响应

状态码：401

**表11** 响应Body参数
参数	参数类型	描述
error_code	String	标准化错误码：服务名.八位数字编码
error_msg	String	清晰的错误信息
encoded_authorization_message	String	对接IAM5.0的服务，拒绝访问时需要返回IAM的相关响应

状态码：500

**表12** 响应Body参数
参数	参数类型	描述
error_code	String	标准化错误码：服务名.八位数字编码
error_msg	String	清晰的错误信息
encoded_authorization_message	String	对接IAM5.0的服务，拒绝访问时需要返回IAM的相关响应

请求示例

无

响应示例

无

状态码

状态码	描述
200	OK
400	请求失败
401	token权限不足
500	服务器内部错误

错误码

请参见错误码。

父主题： HTTP防护策略管理

上一篇：查询防护策略

下一篇：删除防护策略