文档

ModifyPolicy - 修改防护策略

更新时间:

修改防护策略。

调试

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

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
Idstring

策略 ID。

c52c2fa6-fdac-40c4-8753-be7c********
ActionTypeinteger

动作类型。取值

  • 10:表示修改名称(Name必填)。
  • 11:表示修改黑名单超时时间(BlackIpListExpireAt必填)。仅 IP 防护策略支持。
  • 12:表示修改 DDoS 高防回源地址加白开关(WhitenGfbrNets必填)。仅 IP 防护策略支持。
  • 13:表示修改禁用 ICMP 协议开关(EnableDropIcmp必填)。仅 IP 防护策略支持。
  • 20:表示添加黑白名单(WhiteIpListBlackIpList选填)。仅 IP 防护策略支持。
  • 21:表示删除黑白名单(WhiteIpListBlackIpList选填)。仅 IP 防护策略支持。
  • 22:表示清空白名单。仅 IP 防护策略支持。
  • 23:表示清空黑名单。仅 IP 防护策略支持。
  • 30:表示修改 AI 智能防护开关和等级(EnableIntelligenceIntelligenceLevel必填)。仅 IP 防护策略支持。
  • 31:表示修改区域封禁配置(RegionBlockCountryListRegionBlockProvinceList选填)。仅 IP 防护策略支持。
  • 32:表示修改源限速配置(SourceLimitSourceBlockList必填)。仅 IP 防护策略支持。
  • 33:表示修改反射端口过滤(ReflectBlockUdpPortList必填)。仅 IP 防护策略支持。
  • 40:表示创建端口封禁规则(PortRuleList必填)。仅 IP 防护策略支持。
  • 41:表示修改端口封禁规则(PortRuleList必填)。仅 IP 防护策略支持。
  • 42:表示删除端口封禁规则(PortRuleList必填)。仅 IP 防护策略支持。
  • 50:表示创建指纹过滤规则(FingerPrintRuleList必填)。仅 IP 防护策略支持。
  • 51:表示修改指纹过滤规则(FingerPrintRuleList必填)。仅 IP 防护策略支持。
  • 52:表示删除指纹过滤规则(FingerPrintRuleList必填)。仅 IP 防护策略支持。
  • 60:表示修改端口防护开关(EnableL4Defense必填)。仅端口防护策略支持。
  • 61:表示创建端口防护规则(L4RuleList必填)。仅端口防护策略支持。
  • 62:表示修改端口防护规则(L4RuleList必填)。仅端口防护策略支持。
  • 63:表示删除端口防护规则(L4RuleList必填)。仅端口防护策略支持。
11
Namestring

策略名称。

demo**
Contentobject

策略内容。

BlackIpListExpireAtlong

IP 黑名单超时时间(unix 时间戳)。

1716878000
EnableIntelligenceboolean

是否开启 AI 智能防护。

true
IntelligenceLevelstring

AI 智能防护的防护等级。取值:

  • default:表示正常。
  • hard:表示严格。
  • weak:表示宽松。
default
WhitenGfbrNetsboolean

是否开启 DDoS 高防(中国内地&非中国内地)回源地址加白。

false
EnableDropIcmpboolean

是否禁用 ICMP 协议。

true
RegionBlockCountryListarray

区域封禁的国家列表。

integer

区域封禁的国家代号。

11
RegionBlockProvinceListarray

区域封禁的省份列表。

integer

区域封禁的省份代号。

2
SourceLimitobject

源限速。

Ppsinteger

源 PPS 限速,单位 Packet/s。

64
Bpsinteger

源带宽限速,单位 Byte/s。

2048
SynPpsinteger

源 SYN PPS 限速,单位 Packet/s。

64
SynBpsinteger

源 SYN 带宽限速,单位 Byte/s。

2048
SourceBlockListarray<object>

源限速拉黑列表。

object
Typeinteger

源限速类型。取值:

  • 3:表示源 PPS 限速。

  • 4:表示源带宽限速。

  • 5:表示源 SYN PPS 限速。

  • 6:表示源 SYN 带宽限速。

3
BlockExpireSecondsinteger

源 IP 加入黑名单的时长。单位秒。

120
EverySecondsinteger

源限速拉黑的统计周期,单位秒。

60
ExceedLimitTimesinteger

源 IP 在 1 个统计周期内超过限速值的次数。

5
ReflectBlockUdpPortListarray

反射攻击防护过滤的端口列表。

integer

反射攻击防护过滤的端口。

说明 仅支持 UDP
123
PortRuleListarray<object>

端口封禁规则列表。

object
Idstring

规则 ID。

c52c2fa6-fdac-40c4-8753-be7c*********
Protocolstring

协议类型。取值:

  • tcp:表示传输控制协议。
  • udp:表示用户数据报协议。
tcp
SrcPortStartinteger

源端口范围的起始值。取值范围:0~65535

0
SrcPortEndinteger

源端口范围的结束值。取值范围:0~65535

65535
DstPortStartinteger

目的端口范围的起始值。取值范围:0~65535

0
DstPortEndinteger

目的端口范围的结束值。取值范围:0~65535

65535
MatchActionstring

匹配动作。取值:

  • drop:表示丢弃。
drop
SeqNointeger

生效顺序号,使用整数表示。

说明 数字越小,越靠前生效。
1
FingerPrintRuleListarray<object>

指纹过滤规则列表。

object
Idstring

规则 ID。

5fbe941f-a0cf-4a49-9c7c-8fac********
Protocolstring

协议类型。取值:

  • tcp:表示传输控制协议。
  • udp:表示用户数据报协议。
udp
SrcPortStartinteger

源端口范围的开始值。取值范围:0~65535

0
SrcPortEndinteger

源端口范围的结束值。取值范围:0~65535

65535
DstPortStartinteger

目的端口范围的起始值。取值范围:0~65535

0
DstPortEndinteger

目的端口范围的结束值。取值范围:0~65535

65535
MinPktLeninteger

最小包长,取值范围:1~1500

1
MaxPktLeninteger

最大包长,取值范围:1~1500

1500
Offsetinteger

偏移量,取值范围:0~1500

0
PayloadBytesstring

检测载荷。使用十六进制字符串格式表示。

abcd
MatchActionstring

匹配动作。取值:

  • accept:表示放行满足指纹特征的流量。
  • drop:表示丢弃满足指纹特征的流量。
  • ip_rate:表示对满足指纹特征的流量来源 IP 进行访问限速。限速值通过 RateValue 参数设置。
  • session_rate:表示对满足指纹特征的流量来源会话进行访问限速。限速值通过 RateValue 参数设置。
drop
RateValueinteger

限速值。取值范围:1~100000

说明 匹配后动作为源 IP 限速或者源 Session 限速时(MacthActionip_ratesession_rate),必须填写该参数。
100
SeqNointeger

生效顺序号,使用整数表示。

说明 数字越小,越靠前生效。
1
EnableL4Defenseboolean

是否开启端口防护。

L4RuleListarray<object>

端口防护规则列表。

object
Namestring

规则名称。

test****
Priorityinteger

规则优先级。取值范围:1~100

说明 数字越小,优先级越高。
1
Methodstring

规则类型。取值:

  • char:表示字符串匹配。

  • hex:表示十六进制匹配。

char
Matchstring

逻辑符。取值:

  • 0:表示命中执行动作。

  • 1:表示未命中执行动作。

0
Actionstring

动作。取值:

  • 2: 表示丢弃。
2
Limitedinteger

会话流启动规则匹配的最小字节数,取值范围:0~2048

0
ConditionListarray<object>

检测条件列表。

object
Argstring

检测内容。

说明 规则类型为 char,必须为 ASCII 字符串;规则类型为 hex,必须为十六进制字符串。最大长度 2048。
abcd
Positioninteger

检测起始位置。取值范围:0~2047

0
Depthinteger

检测窗口长度,取值范围:1~2048

1200
WhiteIpListarray

IP 白名单列表。

string

IP 白名单。

1.1.1.*
BlackIpListarray

IP 黑名单列表。

string

IP 黑名单。

2.2.2.*

返回参数

名称类型描述示例值
object
RequestIdstring

本次调用请求的 ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。

B4B379C2-9319-4C6B-B579-FE36831****

示例

正常返回示例

JSON格式

{
  "RequestId": "B4B379C2-9319-4C6B-B579-FE36831****"
}

错误码

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