调用ModifyProtectionModuleStatus开启或关闭指定的WAF防护功能模块。

使用说明

本接口用于开启或关闭指定的WAF防护功能模块。

您可以通过设置DefenseType参数值指定要操作的某个防护功能模块。具体参数值的含义,请参见请求参数DefenseType的描述。

QPS限制

本接口的单用户QPS限制为20次/秒。超过限制,API调用将会被限流,这可能影响您的业务,请合理调用。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String ModifyProtectionModuleStatus

要执行的操作。取值:ModifyProtectionModuleStatus

Domain String www.aliyundoc.com

要操作的网站域名。

说明 您可以调用DescribeDomainList查询所有已接入WAF防护的域名。
DefenseType String waf

要操作的WAF防护功能模块。取值:

  • waf:表示规则防护引擎。
  • dld:表示深度学习引擎。
  • tamperproof:表示网站防篡改。
  • dlp:表示防敏感信息泄漏。
  • normalized:表示主动防御。
  • bot_crawler:表示合法爬虫。
  • bot_intelligence:表示爬虫威胁情报。
  • antifraud:表示数据风控。
  • bot_algorithm:表示智能算法。
  • bot_wxbb:表示App防护。
  • bot_wxbb_pkg:表示App防护中的版本防护。
  • ac_cc:表示CC安全防护。
  • ac_blacklist:表示IP黑名单。
  • ac_highfreq:表示扫描防护中的高频Web攻击封禁。
  • ac_dirscan:表示扫描防护中的目录遍历防护。
  • ac_scantools:表示扫描防护中的扫描工具封禁。
  • ac_collaborative:表示扫描防护中的协同防御。
  • ac_custom:表示自定义防护策略。
说明 只支持设置一个功能模块。
ModuleStatus Integer 1

设置防护功能模块的开关状态。取值:

  • 0:表示关闭功能模块。
  • 1:表示开启功能模块。
InstanceId String waf-cn-zz11sr5****

要操作的WAF实例的ID。

说明 您可以调用DescribeInstanceInfo查询当前WAF实例的ID。

调用API时,除了本文中该API的请求参数,还需加入阿里云API公共请求参数。公共请求参数的详细介绍,请参见公共参数

调用API的请求格式,请参见本文示例中的请求示例。

返回数据

名称 类型 示例值 描述
RequestId String D7861F61-5B61-46CE-A47C-6B19160D5EB0

本次请求的ID。

示例

请求示例

http(s)://[Endpoint]/?Action=ModifyProtectionModuleStatus
&Domain=www.aliyundoc.com
&DefenseType=waf
&ModuleStatus=1
&InstanceId=waf-cn-zz11sr5****
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<ModifyProtectionModuleStatusResponse>
    <RequestId>D7861F61-5B61-46CE-A47C-6B19160D5EB0</RequestId>
</ModifyProtectionModuleStatusResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "D7861F61-5B61-46CE-A47C-6B19160D5EB0"
}

错误码

访问错误中心查看更多错误码。