You need to enable JavaScript to run this app.
导航
Web应用防火墙
  • 文档首页
    • /Web应用防火墙/API 参考/网站配置/UpdateWafServiceControl - 更新防护网站开关
UpdateWafServiceControl - 更新防护网站开关
最近更新时间：2024.12.10 17:02:12首次发布时间：2024.02.01 14:25:21
我的收藏

调用 UpdateWafServiceControl 接口修改指定防护网站的防护策略和日志服务的开启状态。

请求说明

  • 请求方式：POST
  • 请求地址：https://open.volcengineapi.com/?Action=UpdateWafServiceControl&Version=2023-12-25

调试

API Explorer
您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。
去调试

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Query

参数
类型
是否必填
示例值
描述
Action
String
是

UpdateWafServiceControl

要执行的操作，取值：UpdateWafServiceControl。

Version
String
是

2023-12-25

API的版本，取值：2023-12-25。

Body

参数
类型
是否必填
示例值
描述
BotRepeatEnable
Integer
否

1

是否开启 bot 统计防护策略。

  • 0：关闭
  • 1：开启
BotDytokenEnable
String
否

1

是否开启 bot 动态令牌。

  • 0：关闭
  • 1：开启
AutoCCEnable
Integer
否

1

是否开启智能 CC 防护策略。

  • 0：关闭
  • 1：开启
BotSequenceEnable
Integer
否

1

是否开启 bot 行为地图。

  • 0：关闭
  • 1：开启
BotSequenceDefaultAction
Integer
否

0

设置 bot 行为地图策略默认动作，当 BotSequenceEnable = 1 开启状态时生效。默认为 0 （观察）。

  • 0：观察
  • 2：拦截
  • 6：JS 挑战
  • 7：人机验证
BotFrequencyEnable
Integer
否

1

是否开启 bot 频率限制策略。

  • 0：关闭
  • 1：开启
Host
String
是

www.example.com

需要更新的防护网站。

ProjectName
String
否

default

当前资源关联的项目名称。项目名称获取方式参考ListProjectResources - 获取项目资源列表。

WafEnable
Integer
否

1

是否开启漏洞防护策略。

  • 0：关闭
  • 1：开启
CcEnable
Integer
否

1

是否开启 CC 防护策略。

  • 0：关闭
  • 1：开启
WhiteEnable
Integer
否

1

是否开启允许访问名单策略。

  • 0：关闭
  • 1：开启
BlackIpEnable
Integer
否

1

是否开启禁止访问名单策略。

  • 0：关闭
  • 1：开启
BlackLctEnable
Integer
否

1

是否开启地理位置访问控制策略。

  • 0：关闭
  • 1：开启
WafWhiteReqEnable
Integer
否

1

是否开启漏洞防护请求加白策略。

  • 0：关闭
  • 1：开启
WhiteFieldEnable
Integer
否

1

是否开启漏洞防护字段加白策略。

  • 0：关闭
  • 1：开启
CustomRspEnable
Integer
否

1

是否开启自定义响应拦截策略。

  • 0：关闭
  • 1：开启
SystemBotEnable
Integer
否

1

是否开启托管 Bot 分类策略。

  • 0：关闭
  • 1：开启
CustomBotEnable
Integer
否

1

是否开启自定义 Bot 分类策略。

  • 0：关闭
  • 1：开启
ApiEnable
Integer
否

1

是否开启 API 防护策略。

  • 0：关闭
  • 1：开启
TamperProofEnable
Integer
否

1

是否开启页面防篡改策略。

  • 0：关闭
  • 1：开启
DlpEnable
Integer
否

1

是否开启防敏感信息泄漏策略。

  • 0：关闭
  • 1：开启
TLSEnable
Integer
否

1

是否开启日志服务。

  • 0：关闭
  • 1：开启

返回参数

本接口无特有的返回参数。更多信息请见返回结构。

请求示例

POST /?Action=UpdateWafServiceControl&Version=2023-12-25 HTTP/1.1
Host: open.volcengineapi.com
Content-Type: application/json; charset=UTF-8
X-Date: 20241205T113710Z
X-Content-Sha256: 287e874e******d653b44d21e
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20241205/cn-beijing/waf/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f

{
  "BotRepeatEnable": 1,
  "BotDytokenEnable": "1",
  "AutoCCEnable": 1,
  "BotSequenceEnable": 1,
  "BotSequenceDefaultAction": 0,
  "BotFrequencyEnable": 1,
  "Host": "www.example.com",
  "WafEnable": 1,
  "CcEnable": 1,
  "WhiteEnable": 1,
  "BlackIpEnable": 1,
  "BlackLctEnable": 1,
  "WafWhiteReqEnable": 1,
  "WhiteFieldEnable": 1,
  "CustomRspEnable": 1,
  "SystemBotEnable": 1,
  "CustomBotEnable": 1,
  "ApiEnable": 1,
  "TamperProofEnable": 1,
  "DlpEnable": 1,
  "TLSEnable": 1
}

返回示例

{
  "ResponseMetadata": {
    "RequestId": "20241205193720041155105037441FA1",
    "Action": "UpdateWafServiceControl",
    "Version": "2023-12-25",
    "Service": "waf",
    "Region": "cn-beijing"
  },
  "Result": {}
}

错误码

您可访问公共错误码，获取更多错误码信息。