API概览

本产品(Web 应用防火墙/2021-10-01)的OpenAPI采用RPC签名风格,签名细节参见签名机制说明我们已经为开发者封装了常见编程语言的SDK,开发者可通过下载SDK直接调用本产品OpenAPI而无需关心技术细节。如果现有SDK不能满足使用需求,可通过签名机制进行自签名对接。由于自签名细节非常复杂,需花费 5个工作日左右。因此建议加入我们的服务钉钉群(11370001915),在专家指导下进行签名对接。
在使用API前,您需要准备好身份账号及访问密钥(AccessKey),才能有效通过客户端工具(SDK、CLI等)访问API。细节请参见获取AccessKey

实例信息

API标题API概述
DescribeInstance获取WAF实例详情获取当前阿里云账号下WAF实例的详情。

接入配置

API标题API概述
CreateDomain添加CNAME接入资源将域名接入WAF实例进行防护。
ModifyDomain修改CNAME接入资源修改CNAME接入域名。
DeleteDomain删除CNAME接入资源删除CNAME接入域名。
DescribeDomainDetail查询CNAME接入详情查询域名接入详情。
DescribeDomains查询CNAME接入列表查询添加到 Web 应用防火墙的域名列表。
DescribeResourcePort查询实例下的所有已接入WAF端口查询实例下的所有已接入WAF端口。
DescribeWafSourceIpSegment获取waf实例的回源IP网段列表查询WAF回源网段。

防护配置

API标题API概述
防护对象防护对象
CreateDefenseResourceGroup创建防护组创建防护对象组。
ModifyDefenseResourceGroup修改防护对象组修改防护对象组配置信息。
DeleteDefenseResourceGroup删除防护对象组删除防护对象组。
DescribeDefenseResourceGroup查询单个防护对象组查询单个防护对象组信息。
DescribeDefenseResources分页查询防护对象分页查询防护对象。
防护规则防护规则
CreateDefenseTemplate创建防护模板创建防护模板。
ModifyDefenseTemplate修改防护模板修改防护模板。
DescribeDefenseTemplate查询单个防护模板查询单个防护模板。
ModifyDefenseTemplateStatus修改防护模板状态修改防护模板状态。
DeleteDefenseTemplate删除防护模板删除防护模板。
CreateDefenseRule创建防护规则创建防护规则。
ModifyDefenseRule修改防护规则修改防护规则配置信息。
ModifyDefenseRuleStatus修改防护规则状态修改防护规则状态。
DeleteDefenseRule删除防护规则删除防护规则。
DescribeDefenseRule查询单个防护规则查询单个防护规则。
DescribeDefenseRules分页查询防护规则分页查询防护规则。
ModifyTemplateResources防护资源绑定或解绑防护模板绑定或解绑防护资源与防护模板的关系。
DescribeTemplateResources查询防护模板绑定的资源查询防护模板绑定的资源。
DescribeRuleGroups分页查询正则规则组分页查询正则规则组。
重保场景重保场景
CreateMajorProtectionBlackIp添加重保场景防护IP黑名单添加WAF重保场景防护IP黑名单。
ModifyMajorProtectionBlackIp修改重保场景防护IP黑名单修改重保场景黑IP。
DeleteMajorProtectionBlackIp删除重保场景防护IP黑名单删除重保场景黑IP。
ClearMajorProtectionBlackIp清空重保场景防护IP黑名单清空重保场景黑IP。
DescribeMajorProtectionBlackIps分页查询重保防护IP黑名单分页查询重保黑IP。

报表信息

API标题API概述
DescribeFlowChart查看流量统计信息查看流量统计信息。
DescribePeakTrend查看QPS变化趋势查看请求QPS的变化趋势。
DescribeResponseCodeTrendGraph查看响应码的趋势图查看WAF返回给客户端、源站返回给WAF的5XX、405、499、302、444等异常响应码的数量变化趋势。
DescribeVisitUas查看流量访问Top 10的UA查看发起请求次数最多的前10个User-Agent。
DescribeVisitTopIp查看流量访问Top 10的IP查看发起请求次数最多的前10个IP。
DescribeRuleHitsTopResource查看命中防护规则的Top 10 防护对象查看触发防护规则次数最多的前10个防护对象。
DescribeRuleHitsTopRuleId查看命中防护规则的Top 10规则ID查看触发防护规则次数最多的前10个规则ID。
DescribeRuleHitsTopTuleType查看命中防护规则的Top 10防护类型查看触发防护规则次数最多的前10个防护类型。
DescribeRuleHitsTopUrl查看命中防护规则的Top 10 URL查看触发防护规则次数最多的前10个URL。
DescribeRuleHitsTopClientIp查看发动攻击次数Top 10的攻击源IP查看发动攻击次数最多的前10个攻击源IP。
DescribeFlowTopResource查看流量访问Top 10的防护对象查看请求量最高的前10个防护对象。
DescribeRuleHitsTopUa查看发动攻击次数Top 10的攻击UA查看发动攻击次数最多的前10个User-Agent。
DescribeFlowTopUrl查看流量访问Top 10的URL查看发起请求次数最多的前10个URL。

日志配置

API标题API概述
ModifyResourceLogStatus修改防护对象日志状态修改防护对象日志状态。
DescribeResourceLogStatus查询防护对象日志状态查询防护对象日志状态。
阿里云首页 Web应用防火墙 相关技术圈