文档反馈官招募中，报名立赚积分兑换代金券！> HOT
文档中心>边缘安全加速平台 EO>通用参考>配置语法>配置组语法说明

配置组语法说明

最近更新时间：2026-06-01 11:33:02

我的收藏

本页目录：

本文档是对版本管理中各功能模块配置组结构的详细语法解释。其中 Condition 结构和变量定义的细节可在对应文档章节中进一步查阅，链接如下：
条件表达式的嵌套规则及语法细节：Condition。
请求数据的动态提取规则：变量。

通用单位规范

所有表示​​时间​​的数值单位必须为​​秒(s)​​，所有表示​​文件大小​​的数值单位必须为​​字节(B)​​，且​​值仅为纯数字​​。
单位类型
配置示例与说明
​​时间（秒）​​
设置30分钟缓存：30 * 60 = 1800
​​大小（字节）​​
设置10MB 大小限制：10 * 1024 * 1024 = 10485760

配置组概述

每个站点的版本文件包含以下字段，各字段的说明如下：
配置字段
类型
必选
对应配置组
描述
FormatVersion
String
是
全局配置
语法版本，当前默认为 1.0，输入其他值将会报错。
ZoneConfig
否
站点加速配置组
站点级配置，包含「站点加速」中所有配置项，且所有项均为必选，否则配置无效。
Rules
Array of Rules
否
站点加速配置组
规则级配置，包含「规则引擎」中所有规则，且数组可为空，表示不启用任何规则。
WebSecurity
否
Web 防护配置组
Web 安全防护配置，对应控制台中「安全防护 - Web 防护」里支持的功能。详见 WebSecurity。

数据结构

AccelerateMainlandParameters

中国大陆加速优化配置。
名称
类型
必选
描述
Switch
String
否
中国大陆加速优化配置开关，取值有：
on：开启。
off：关闭。

AccessURLRedirectParameters

访问 URL 重定向 配置参数。
名称
类型
必选
描述
StatusCode
Integer
否
状态码，取值为 301、302、303、307、308 之一。
Protocol
String
否
目标请求协议，取值有：
http：目标请求协议 HTTP。
https：目标请求协议 HTTPS。
follow：跟随请求。
HostName
HostName
否
目标 HostName 。
注意：此字段可能返回 null，表示取不到有效值。
URLPath
URLPath
否
目标路径。
注意：此字段可能返回 null，表示取不到有效值。
QueryString
否
携带查询参数。
注意：此字段可能返回 null，表示取不到有效值。

AccessURLRedirectQueryString

访问 URL 重定向 配置参数。
名称
类型
必选
描述
Action
String
否
执行动作，取值有：
full：全部保留。
ignore：全部忽略。

AdaptiveFrequencyControl

自适应频控
名称
类型
必选
描述
Enabled
String
是
自适应频控是否开启。取值有：
on：开启。
off：关闭。
Id
String
否
自适应频控的规则 ID，仅作为出参返回。
Sensitivity
String
否
自适应频控的限制等级，当 Enabled 为 on 时，此字段必填。取值有：
Loose：宽松。
Moderate：适中。
Strict：严格。
Action
否
自适应频控的处置方式，当 Enabled 为 on 时，此字段必填。SecurityAction 的 Name 取值支持：
Monitor：观察。
Deny：拦截。
Challenge：挑战，其中 ChallengeActionParameters.Name 仅支持 JSChallenge。

AICrawlerDetection

AI 爬虫检测的具体配置。
名称
类型
必选
描述
Enabled
String
否
AI 爬虫检测是否开启。取值有：
on：开启。
off：关闭。
Action
否
AI 爬虫检测的执行动作，当 Enabled 为 on 时，此字段必填。SecurityAction 的 Name 取值仅支持：
Deny：拦截；
Monitor：观察；
Allow：放行；
Challenge：挑战，其中 ChallengeActionParameters 中的 ChallengeOption 仅支持 JSChallenge 和 ManagedChallenge。

AllowActionParameters

Web 安全 Allow 的附加参数
名称
类型
必选
描述
MinDelayTime
String
否
最小延迟响应时间，当配置为 0s 时，表示不延迟直接响应。支持的单位有：
s：秒，取值范围 0～5。
MaxDelayTime
String
否
最大延迟响应时间，支持的单位有：
s：秒，取值范围 5～10。

AuthenticationParameters

Token 鉴权 配置参数。
名称
类型
必选
描述
AuthType
String
否
鉴权类型。取值有：
TypeA：鉴权方式 A 类型，具体含义请参考 鉴权方式 A；
TypeB：鉴权方式 B 类型，具体含义请参考 鉴权方式 B；
TypeC：鉴权方式 C 类型，具体含义请参考 鉴权方式 C；
TypeD：鉴权方式 D 类型，具体含义请参考 鉴权方式 D；
TypeVOD：鉴权方式 V 类型，具体含义请参考 鉴权方式 V。
SecretKey
String
否
主鉴权密钥，由 6～40 位大小写英文字母或数字组成，不能包含 " 和 $。
Timeout
Integer
否
鉴权 URL 的有效时长，单位为秒，取值：1～630720000。用于判断客户端访问请求是否过期：
若当前时间超过 “timestamp + 有效时长” 时间，则为过期请求，直接返回 403。
若当前时间未超过 “timestamp + 有效时长” 时间，则请求未过期，继续校验 MD5 字符串。
注意：当 AuthType 为 TypeA、TypeB、TypeC、TypeD 之一时，此字段必填。
BackupSecretKey
String
否
备鉴权密钥，由 6～40 位大小写英文字母或数字组成，不能包含 " 和 $。
AuthParam
String
否
鉴权参数名称，节点将校验此参数名对应的值。由 1～100 位大小写字母、数字或下划线组成。
注意：当 AuthType 为 TypeA、TypeD 之一时，此字段必填。
TimeParam
String
否
鉴权时间戳，和 AuthParam 字段的值不能相同。
注意：当 AuthType 为 TypeD 时，此字段必填。
TimeFormat
String
否
鉴权时间格式，取值有：
dec：十进制。
hex：十六进制。
注意：当 AuthType 为 TypeD 时，此字段必填。默认为 hex。

BandwidthAbuseDefense

流量防盗刷（仅适用中国大陆地区）的具体配置。
名称
类型
必选
描述
Enabled
String
是
流量防盗刷（仅适用中国大陆地区）是否开启。取值有：
on：开启。
off：关闭。
Id
String
否
流量防盗刷的规则 ID，仅作为出参返回。
Action
否
流量防盗刷（仅适用中国大陆地区）的处置方式，当 Enabled 为 on 时，此字段必填。SecurityAction 的 Name 取值支持：
Monitor：观察；
Deny：拦截；
Challenge：挑战，其中 ChallengeActionParameters.Name 仅支持 JSChallenge。

BasicBotSettings

Bot 管理的基础配置，对策略关联的所有域名生效。可以通过 CustomRules 进行精细化定制。
名称
类型
必选
描述
SourceIDC
SourceIDC
否
客户端 IP 的来源 IDC 配置，用于处置来自 IDC（数据中心） 的客户端 IP 的访问请求。此类来源请求不是由移动端或浏览器端直接访问。
SearchEngineBots
否
搜索引擎爬虫配置，用于处置来自搜索引擎爬虫的请求。此类请求的 IP、User-Agent 或 rDNS 结果匹配已知搜索引擎爬虫。
KnownBotCategories
否
商业或开源工具 UA 特征配置（原 UA 特征规则），用于处置来自已知商业工具或开源工具的访问请求。此类请求的 User-Agent 头部符合已知商业或开源工具特征。
IPReputation
否
IP 威胁情报库（原客户端画像分析）配置，用于处置近期访问行为具有特定风险特征的客户端 IP。
BotIntelligence
否
Bot 智能分析的具体配置。

BlockIPActionParameters

Web 安全 IP 封禁的附加参数
名称
类型
必选
描述
Duration
String
是
封禁 IP 的惩罚时长。支持的单位有：
s：秒，取值范围1～120；
m：分，取值范围1～120；
h：小时，取值范围1～48。

BotIntelligence

Bot 智能分析的具体配置。
名称
类型
必选
描述
Enabled
String
否
Bot 智能分析的具体配置开关。取值有：

on：开启；
off：关闭。
Id
String
否
Bot 智能分析的规则 ID，仅作为出参返回。
BotRatings
否
基于客户端和请求特征，将请求来源分为人类来源请求、合法 Bot 请求、疑似 Bot 请求和高风险 Bot 请求，并提供请求处置选项。

BotManagement

Web 安全的 Bot 规则结构。
名称
类型
必选
描述
Enabled
String
否
Bot 管理是否开启。取值有：
on：开启；
off：关闭。
CustomRules
否
Bot 管理的自定义规则，组合各类爬虫和请求行为特征，精准定义 Bot 并配置定制化处置方式。
BasicBotSettings
否
Bot 管理的基础配置，对策略关联的所有域名生效。可以通过 CustomRules 进行精细化定制。
ClientAttestationRules
否
客户端认证规则的定义列表。该功能内测中，如需使用，请 提交工单。
BrowserImpersonationDetection
否
配置浏览器伪造识别规则（原主动特征识别规则）。设置注入 JavaScript 的响应页面范围，浏览器校验选项，以及对非浏览器客户端的处置方式。

BotManagementActionOverrides

Bot 规则项的具体配置，用于覆盖上层的默认配置。
名称
类型
必选
描述
Ids
Array of String
否
Bot 规则组下的具体项，用于改写此单条规则项配置的内容，Ids 所对应的具体信息请参考 DescribeBotManagedRules 接口返回的信息。
Action
否
Ids 中指定 Bot 规则项的处置动作。 SecurityAction 的 Name 取值支持：
Deny：拦截；
Monitor：观察；
Disabled：未启用，不启用指定规则；
Challenge：挑战，其中 ChallengeActionParameters 中的 ChallengeOption 支持 JSChallenge 和 ManagedChallenge；
Allow：放行（仅限 Bot 基础特征管理）。

BotManagementCustomRule

Web 安全的 Bot 自定义规则。
名称
类型
必选
描述
Id
String
否
Bot 自定义规则的 ID。
通过规则 ID 可支持不同的规则配置操作：
增加新规则：ID 为空或不指定 ID 参数；
修改已有规则：指定需要更新/修改的规则 ID；
删除已有规则：BotManagementCustomRules 参数中，Rules 列表中未包含的已有规则将被删除。
Name
String
否
Bot 自定义规则的名称。
Enabled
String
否
Bot 自定义规则是否开启。取值有：
on：开启；
off：关闭。
Priority
Integer
否
Bot 自定义规则的优先级，范围是 1 ~ 100，默认为 50。
Condition
String
否
Bot 自定义规则的具体内容，需符合表达式语法，详细规范参见产品文档。
Action
否
Bot 自定义规则的处置方式。取值有：
Monitor：观察；
Deny：拦截，其中 DenyActionParameters.Name 支持 Deny 和 ReturnCustomPage；
Challenge：挑战，其中 ChallengeActionParameters.Name 支持 JSChallenge 和 ManagedChallenge；
Redirect：重定向至 URL。

BotManagementCustomRules

Bot 自定义规则的配置。
名称
类型
必选
描述
Rules
否
Bot 自定义规则的列表。使用 ModifySecurityPolicy 修改 Web 防护配置时：
若未指定 SecurityPolicy.BotManagement.CustomRules 中的 Rules 参数，或 Rules 参数长度为零：清空所有 Bot 自定义规则配置。
若 SecurityPolicy.BotManagement 参数中，未指定 CustomRules 参数值：保持已有 Bot 自定义规则配置，不做修改。

BotManagementLite

Web 安全的基础 BOT 规则结构。
名称
类型
必选
描述
CAPTCHAPageChallenge
否
人机校验页的具体配置。
AICrawlerDetection
否
AI 爬虫检测的具体配置。

BotRatings

基于客户端和请求特征，将请求来源分为人类来源请求、合法 Bot 请求、疑似 Bot 请求和高风险 Bot 请求，并提供请求处置选项。
名称
类型
必选
描述
HighRiskBotRequestsAction
否
恶意 Bot 请求的执行动作。 SecurityAction 的 Name 取值支持：
Deny：拦截；
Monitor：观察；
Allow：放行；
Challenge：挑战，其中 ChallengeActionParameters 中的 ChallengeOption 支持 JSChallenge 和 ManagedChallenge。
LikelyBotRequestsAction
否
疑似 Bot 请求的执行动作。 SecurityAction 的 Name 取值支持：
Deny：拦截；
Monitor：观察；
Allow：放行；
Challenge：挑战，其中 ChallengeActionParameters 中的 ChallengeOption 支持 JSChallenge 和 ManagedChallenge。
VerifiedBotRequestsAction
否
友好 Bot 请求的执行动作。 SecurityAction 的 Name 取值支持：
Deny：拦截；
Monitor：观察；
Allow：放行；
Challenge：挑战，其中 ChallengeActionParameters 中的 ChallengeOption 支持 JSChallenge 和 ManagedChallenge。
HumanRequestsAction
否
正常 Bot 请求的执行动作。 SecurityAction 的 Name 取值支持：
Allow：放行。

BotSessionValidation

Cookie 校验和会话跟踪行为具体配置。
名称
类型
必选
描述
IssueNewBotSessionCookie
String
否
是否更新 Cookie 并校验。取值有：
on：更新 Cookie 并校验；
off：仅校验。
MaxNewSessionTriggerConfig
否
更新 Cookie 并校验时的触发阈值，仅当 IssueNewBotSessionCookie 为 on 时有效。
SessionExpiredAction
否
未携带 Cookie 或 Cookie 已过期的执行动作。 SecurityAction 的 Name 取值支持：
Deny：拦截，其中 DenyActionParameters 中支持 Stall 配置；
Monitor：观察；
Allow：等待后响应，其中 AllowActionParameters 需要 MinDelayTime 和 MaxDelayTime 配置。
SessionInvalidAction
否
不合法 Cookie 的执行动作。 SecurityAction 的 Name 取值支持：
Deny：拦截，其中 DenyActionParameters 中支持 Stall 配置；
Monitor：观察；
Allow：等待后响应，其中 AllowActionParameters 需要 MinDelayTime 和 MaxDelayTime 配置。
SessionRateControl
否
会话速率和周期特征校验的具体配置。

BrowserImpersonationDetection

浏览器伪造识别规则（原主动特征识别规则）的配置。
名称
类型
必选
描述
Rules
否
浏览器伪造识别规则的列表。使用 ModifySecurityPolicy 修改 Web 防护配置时：
若未指定 SecurityPolicy.BotManagement.BrowserImpersonationDetection 中的 Rules 参数，或 Rules 参数长度为零： 清空所有浏览器伪造识别规则配置。
若 SecurityPolicy.BotManagement 参数中，未指定 BrowserImpersonationDetection 参数值： 保持已有浏览器伪造识别规则配置，不做修改。

BrowserImpersonationDetectionAction

Bot 浏览器校验规则（原主动特征识别规则）的 Action。
名称
类型
必选
描述
BotSessionValidation
否
Cookie 校验和会话跟踪配置。
ClientBehaviorDetection
否
客户端行为校验配置。

BrowserImpersonationDetectionRule

浏览器伪造识别规则（原主动特征识别规则）。
名称
类型
必选
描述
Id
String
否
浏览器伪造识别规则的 ID。

通过规则 ID 可支持不同的规则配置操作：

增加新规则：ID 为空或不指定 ID 参数；
修改已有规则：指定需要更新/修改的规则 ID；
删除已有规则：BrowserImpersonationDetection 参数中，Rules 列表中未包含的已有规则将被删除。
Name
String
否
浏览器伪造识别规则的名称。
Enabled
String
否
浏览器伪造识别规则是否开启。取值有：
on：开启；
off：关闭。
Condition
String
否
浏览器伪造识别规则的具体内容，其中仅支持请求方式（Method）、请求路径（Path）和请求 URL 的配置，需符合表达式语法，详细规范参见产品文档。
Action
否
浏览器伪造识别规则的处置方式，包括 Cookie 校验和会话跟踪配置以及客户端行为校验配置。

CacheConfigCustomTime

节点缓存 TTL 自定义缓存时间配置参数。
名称
类型
必选
描述
Switch
String
否
自定义缓存时间开关，取值有：
on：开启。
off：关闭。
CacheTime
Integer
否
自定义缓存时间数值，单位为秒，取值：0-315360000。
注意：当 Switch 为 on 时，此字段必填；当 Switch 为 off 时，无需填写此字段，若填写则不生效。

CacheConfigParameters

节点缓存 TTL 配置参数。
名称
类型
必选
描述
FollowOrigin
否
遵循源站缓存配置。FollowOrigin、NoCache、CustomTime 最多只能配置一个 Switch 为 on。
注意：此字段可能返回 null，表示取不到有效值。
NoCache
NoCache
否
不缓存配置。FollowOrigin、NoCache、CustomTime 最多只能配置一个 Switch 为 on。
注意：此字段可能返回 null，表示取不到有效值。
CustomTime
否
自定义缓存时间配置。FollowOrigin、NoCache、CustomTime 最多只能配置一个 Switch 为 on。
注意：此字段可能返回 null，表示取不到有效值。

CacheKeyConfigParameters

缓存键配置。
名称
类型
必选
描述
FullURLCache
String
否
是否开启全路径缓存，取值如下：
on：开启全路径缓存（即关闭参数忽略）；
off：关闭全路径缓存（即开启参数忽略）。
IgnoreCase
String
否
是否忽略大小写缓存，取值如下：
on：忽略；
off：不忽略。
QueryString
否
查询字符串保留配置参数。此字段和 FullURLCache 必须同时设置，但不能同为 on。

CacheKeyCookie

自定义 Cache Key Cookie 配置参数。
名称
类型
必选
描述
Switch
String
否
功能开关，取值如下：
on：开启。
off：关闭。
Action
String
否
缓存动作，取值如下：
full：全部保留；
ignore：全部忽略；
includeCustom：保留指定参数；
excludeCustom：忽略指定参数。
注意：当 Switch 为 on 时，此字段必填；当 Switch 为 off 时，无需填写此字段，若填写则不生效。
Values
Array of String
否
自定义 Cache Key Cookie 名称列表。
注意：当 Action 为 includeCustom 或 excludeCustom 时，此字段必填；当 Action 为 full 或 ignore 时，无需填写此字段，若填写则不生效。

CacheKeyHeader

自定义 Cache Key HTTP 请求头配置参数。
名称
类型
必选
描述
Switch
String
否
功能开关，取值如下：
on：开启。
off：关闭。
Values
Array of String
否
自定义 Cache Key HTTP 请求头列表。
注意：当 Switch 为 on 时，此字段必填；当 Switch 为 off 时，无需填写此字段，若填写则不生效。

CacheKeyParameters

自定义 Cache Key 配置参数。
名称
类型
必选
描述
FullURLCache
String
否
查询字符串全部保留开关，取值如下：
on：开启。
off：关闭。
注意：FullURLCache、IgnoreCase、Header、Scheme、Cookie 至少设置一个配置。此字段和 QueryString.Switch 必须同时设置，但不能同为 on。
QueryString
否
查询字符串保留配置参数。此字段和 FullURLCache 必须同时设置，但不能同为 on。
注意：此字段可能返回 null，表示取不到有效值。
IgnoreCase
String
否
忽略大小写开关，取值如下：
on：开启。
off：关闭。
注意：FullURLCache、IgnoreCase、Header、Scheme、Cookie 至少设置一个配置。
Header
否
HTTP 请求头配置参数。FullURLCache、IgnoreCase、Header、Scheme、Cookie 至少设置一个配置。
注意：此字段可能返回 null，表示取不到有效值。
Scheme
String
否
请求协议开关，取值如下：
on：开启。
off：关闭。
注意：FullURLCache、IgnoreCase、Header、Scheme、Cookie 至少设置一个配置。
Cookie
否
Cookie 配置参数。FullURLCache、IgnoreCase、Header、Scheme、Cookie 至少设置一个配置。
注意：此字段可能返回 null，表示取不到有效值。

CacheKeyQueryString

自定义 Cache Key 查询字符串配置参数。
名称
类型
必选
描述
Switch
String
否
查询字符串保留/忽略指定参数开关，取值如下：
on：开启。
off：关闭。
Action
String
否
查询字符串保留/忽略指定参数动作。取值如下：
includeCustom：表示保留部分参数。
excludeCustom：表示忽略部分参数。
注意：当 Switch 为 on 时，此字段必填；当 Switch 为 off 时，无需填写此字段，若填写则不生效。
Values
Array of String
否
查询字符串中需保留/忽略的参数名列表。
注意：当 Switch 为 on 时，此字段必填；当 Switch 为 off 时，无需填写此字段，若填写则不生效。

CacheParameters

节点缓存 TTL 配置参数。
名称
类型
必选
描述
FollowOrigin
否
缓存遵循源站。不填表示不设置该配置，FollowOrigin、NoCache、CustomTime 最多只能配置一个 Switch 为 on。
注意：此字段可能返回 null，表示取不到有效值。
NoCache
NoCache
否
不缓存。不填表示不设置该配置，FollowOrigin、NoCache、CustomTime 最多只能配置一个 Switch 为 on。
注意：此字段可能返回 null，表示取不到有效值。
CustomTime
否
自定义缓存时间。不填表示不设置该配置，FollowOrigin、NoCache、CustomTime 最多只能配置一个 Switch 为 on。
注意：此字段可能返回 null，表示取不到有效值。

CachePrefreshParameters

缓存预刷新 配置参数。
名称
类型
必选
描述
Switch
String
否
缓存预刷新开关，取值如下：
on：开启。
off：关闭。
CacheTimePercent
Integer
否
预刷新时间设置为节点缓存时间的百分比数值，取值：1～99。
注意：当 Switch 为 on 时，此字段必填；当 Switch 为 off 时，无需填写此字段，若填写则不生效。

CAPTCHAPageChallenge

人机校验页的具体配置。
名称
类型
必选
描述
Enabled
String
否
人机校验页是否开启，取值有：
on：开启；
off：关闭。

ChallengeActionParameters

Web 安全 Challenge 挑战的附加参数
名称
类型
必选
描述
ChallengeOption
String
是
安全执行的具体挑战动作。取值如下：
InterstitialChallenge：插页式挑战；
InlineChallenge：内嵌式挑战；
JSChallenge：JavaScript 挑战；
ManagedChallenge：托管挑战。
Interval
String
否
重复挑战的时间间隔，当 Name 为 InterstitialChallenge/InlineChallenge 时，该字段必填。默认值为 300s。支持的单位如下：
s：秒，取值范围1～60；
m：分，取值范围1～60；
h：小时，取值范围1～24。
AttesterId
String
否
客户端认证方式 ID 。当 Name 为 InterstitialChallenge/InlineChallenge 时，该字段必填。

ClientAttestationRule

客户端认证规则
名称
类型
必选
描述
Id
String
否
客户端认证规则的 ID。
通过规则 ID 可支持不同的规则配置操作：
增加新规则：ID 为空或不指定 ID 参数；
修改已有规则：指定需要更新/修改的规则 ID；
删除已有规则：BotManagement 参数中，ClientAttestationRule 列表中未包含的已有规则将被删除。
Name
String
否
客户端认证规则的名称。
Enabled
String
否
规则是否开启。取值如下：
on：开启。
off：关闭。
Priority
Integer
否
规则的优先级，数值越小越优先执行，范围是 0 ~ 100，默认为 0。
Condition
String
否
规则的具体内容，需符合表达式语法，详细规范参见产品文档。
AttesterId
String
否
客户端认证选项 ID。
DeviceProfiles
Array of DeviceProfile
否
客户端设备配置。若 ClientAttestationRules 参数中，未指定 DeviceProfiles 参数值：保持已有客户端设备配置，不做修改。
InvalidAttestationAction
否
客户端认证未通过的处置方式。SecurityAction 的 Name 取值支持：
Deny：拦截；
Monitor：观察；
Redirect：重定向；
Challenge：挑战。
默认值为 Monitor。

ClientAttestationRules

客户端认证的配置。
名称
类型
必选
描述
Rules
否
客户端认证的列表。使用 ModifySecurityPolicy 修改 Web 防护配置时：
若未指定 SecurityPolicy.BotManagement.ClientAttestationRules 中的 Rules 参数，或 Rules 参数长度为零：清空所有客户端认证规则配置。
若 SecurityPolicy.BotManagement 参数中，未指定 ClientAttestationRules 参数值：保持已有客户端认证规则配置，不做修改。

ClientBehaviorDetection

客户端行为校验
名称
类型
必选
描述
CryptoChallengeIntensity
String
否
工作量证明校验强度。取值有：
low：低；
medium：中；
high：高。
CryptoChallengeDelayBefore
String
否
客户端行为校验的执行方式。取值有：
0ms：立即执行；
100ms：延迟 100ms 执行；
200ms：延迟 200ms 执行；
300ms：延迟 300ms 执行；
400ms：延迟 400ms 执行；
500ms：延迟 500ms 执行；
600ms：延迟 600ms 执行；
700ms：延迟 700ms 执行；
800ms：延迟 800ms 执行；
900ms：延迟 900ms 执行；
1000ms：延迟 1000ms 执行。
MaxChallengeCountInterval
String
否
触发阈值统计的时间窗口，取值有：
5s：5 秒内；
10s：10 秒内；
15s：15 秒内；
30s：30 秒内；
60s：60 秒内；
5m：5 分钟内；
10m：10 分钟内；
30m：30 分钟内；
60m：60 分钟内。
MaxChallengeCountThreshold
Integer
否
触发阈值统计的累计次数，取值范围 1 ~ 100000000。
ChallengeNotFinishedAction
否
客户端未启用 JS（未完成检测）时的执行动作。 SecurityAction 的 Name 取值支持：
Deny：拦截，其中 DenyActionParameters 中支持 Stall 配置；
Monitor：观察；
Allow：等待后响应，其中 AllowActionParameters 需要 MinDelayTime 和 MaxDelayTime 配置。
ChallengeTimeoutAction
否
客户端检测超时的执行动作。 SecurityAction 的 Name 取值支持：
Deny：拦截，其中 DenyActionParameters 中支持 Stall 配置；
Monitor：观察；
Allow：等待后响应，其中 AllowActionParameters 需要 MinDelayTime 和 MaxDelayTime 配置。
BotClientAction
否
Bot 客户端的执行动作。 SecurityAction 的 Name 取值支持：
Deny：拦截，其中 DenyActionParameters 中支持 Stall 配置；
Monitor：观察；
Allow：等待后响应，其中 AllowActionParameters 需要 MinDelayTime 和 MaxDelayTime 配置。

ClientFiltering

智能客户端过滤
名称
类型
必选
描述
Enabled
String
是
智能客户端过滤是否开启。取值如下：
on：开启。
off：关闭。
Id
String
否
智能客户端过滤的规则 ID，仅作为出参返回。
Action
否
智能客户端过滤的处置方式，当 Enabled 为 on 时，此字段必填。SecurityAction 的 Name 取值支持：
Monitor：观察；
Deny：拦截；
Challenge：挑战，其中 ChallengeActionParameters.Name 仅支持 JSChallenge。

ClientIPCountryParameters

回源时携带客户端 IP 所属地域信息，值的格式为 ISO-3166-1 两位字母代码。
名称
类型
必选
描述
Switch
String
否
配置开关，取值如下：
on：开启。
off：关闭。
HeaderName
String
否
存放客户端 IP 所属地域信息的请求头名称，当 Switch=on 时有效。为空则使用默认值：EO-Client-IPCountry。

ClientIPHeaderParameters

存储客户端请求 IP 的头部信息配置。
名称
类型
必选
描述
Switch
String
否
配置开关，取值如下：
on：开启。
off：关闭。
HeaderName
String
否
回源时，存放客户端 IP 的请求头名称。当 Switch 为 on 时，该参数必填。该参数不允许填写 X-Forwarded-For。

CompressionParameters

智能压缩配置。
名称
类型
必选
描述
Switch
String
否
智能压缩配置开关，取值如下：
on：开启。
off：关闭。
Algorithms
Array of String
否
支持的压缩算法列表。当 Switch 为 on 时，此字段必填，否则此字段不生效。取值如下：
brotli：brotli 算法。
gzip：gzip 算法。

ContentCompressionParameters

内容压缩配置。
名称
类型
必选
描述
Switch
String
是
内容压缩配置开关，取值如下：
on：开启。
off：关闭。
当 Switch 为 on 时，将同时支持 brotli 和 gzip 压缩算法。

CustomRule

Web 防护功能下的自定义规则。
名称
类型
必选
描述
Name
String
是
自定义规则的名称。
Condition
String
是
自定义规则的具体内容，需符合表达式语法，详细规范参见产品文档。
Action
是
自定义规则的执行动作。 SecurityAction 的 Name 取值支持：
Deny：拦截；
Monitor：观察；
ReturnCustomPage：使用指定页面拦截；
Redirect：重定向至 URL；
BlockIP：IP 封禁；
JSChallenge：JavaScript 挑战；
ManagedChallenge：托管挑战；
Allow：放行。
Enabled
String
是
自定义规则是否开启。取值如下：
on：开启
off：关闭
Id
String
否
自定义规则的 ID。
通过规则 ID 可支持不同的规则配置操作：
增加新规则：ID 为空或不指定 ID 参数；
修改已有规则：指定需要更新/修改的规则 ID；
删除已有规则：CustomRules 参数中，Rules 列表中未包含的已有规则将被删除。
RuleType
String
否
自定义规则的类型。取值有：
BasicAccessRule：基础访问管控；
PreciseMatchRule：精准匹配规则；
ManagedAccessRule：专家定制规则，仅出参支持。
说明：当未指定 RuleType 时，默认为 PreciseMatchRule。
Priority
Integer
否
自定义规则的优先级，范围是 0 ~ 100，默认为 0，仅支持精准匹配规则（PreciseMatchRule）。

CustomRules

Web 安全的自定义规则结构
名称
类型
必选
描述
Rules
Array of CustomRule
否
自定义规则的定义列表。
使用 ModifySecurityPolicy 修改 Web 防护配置时：
若未指定 Rules 参数，或 Rules 参数长度为零：清空所有自定义规则配置。
若 SecurityPolicy 参数中，未指定 CustomRules 参数值：保持已有自定义规则配置，不做修改。

CustomTime

节点缓存 TTL 自定义缓存时间参数配置。
名称
类型
必选
描述
Switch
String
否
自定义缓存时间开关，取值如下：
on：开启。
off：关闭。
IgnoreCacheControl
String
否
忽略源站 CacheControl 开关，取值如下：
on：开启。
off：关闭。
注意：当 Switch 为 on 时，此字段必填；当 Switch 为 off 时，无需填写此字段，若填写则不生效。
CacheTime
Integer
否
自定义缓存时间数值，单位为秒，取值：0～315360000。
注意：当 Switch 为 on 时，此字段必填；当 Switch 为 off 时，无需填写此字段，若填写则不生效。

DefaultDenySecurityActionParameters

默认拦截动作配置。当安全规则命中并触发拦截处置动作时，若 SecurityAction 仅指定了 Name 为 Deny 且未指定 DenyActionParameters，则按功能模块维度匹配并使用此处定义的默认参数配置：
ManagedRules 托管规则默认拦截处置动作配置。
OtherModules 除托管规则外的安全防护规则（自定义规则、速率限制 和 Bot 管理功能）默认拦截处置动作配置。
名称
类型
必选
描述
ManagedRules
否
托管规则默认拦截处置动作配置。 DenyActionParameters 支持的配置参数：
ReturnCustomPage：是否使用自定义页面。
ResponseCode：自定义页面的状态码。
ErrorPageId：自定义页面的 PageId。
OtherModules
否
除托管规则外的安全防护规则（自定义规则、速率限制 和 Bot 管理功能）默认拦截处置动作配置。 DenyActionParameters 支持的配置参数：
ReturnCustomPage：是否使用自定义页面。
ResponseCode：自定义页面的状态码。
ErrorPageId：自定义页面的 PageId。

DenyActionParameters

安全执行动作为封禁的附加参数。
名称
类型
必选
描述
BlockIp
String
否
是否对来源 IP 延长封禁。取值如下：
on：开启。
off：关闭。
启用后，对触发规则的客户端 IP 持续拦截。当启用该选项时，必须同时指定 BlockIpDuration 参数。
注意：该选项不可与 ReturnCustomPage 或 Stall 选项同时启用。
BlockIpDuration
String
否
当 BlockIP 为 on 时 IP 的封禁时长。
ReturnCustomPage
String
否
是否使用自定义页面。取值如下：
on：开启。
off：关闭。
启用后，使用自定义页面内容拦截（响应）请求，当启用该选项时，必须同时指定 ResponseCode 和 ErrorPageId 参数。
注意：该选项不可与 BlockIp 或 Stall 选项同时启用。
ResponseCode
String
否
自定义页面的状态码。
ErrorPageId
String
否
自定义页面的 PageId。
Stall
String
否
是否对请求来源挂起不予处理。取值如下：
on：开启。
off：关闭。
启用后，不再响应当前连接会话内请求，且不会主动断开连接。用于爬虫对抗时，消耗客户端连接资源。
注意：该选项不可与 BlockIp 或 ReturnCustomPage 选项同时启用。

DeviceProfile

客户端设备配置
名称
类型
必选
描述
ClientType
String
是
客户端设备类型。取值有：
iOS；
Android；
WebView；
WeChatMiniProgram。
HighRiskMinScore
Integer
否
判定请求为高风险的最低值，取值范围为 1～99。数值越大请求风险越高越接近 Bot 客户端发起的请求。默认值为 50，对应含义 51～100 为高风险。
HighRiskRequestAction
否
高风险请求的处置方式。SecurityAction 的 Name 取值支持：
Deny：拦截；
Monitor：观察；
Redirect：重定向；
Challenge：挑战。
默认值为 Monitor。
MediumRiskMinScore
Integer
否
判定请求为中风险的最低值，取值范围为 1～99。数值越大请求风险越高越接近 Bot 客户端发起的请求。默认值为 15，对应含义 16～50 为中风险。
MediumRiskRequestAction
否
中风险请求的处置方式。SecurityAction 的 Name 取值支持：
Deny：拦截；
Monitor：观察；
Redirect：重定向；
Challenge：挑战。
默认值为 Monitor。

ErrorPage

自定义错误页面。
名称
类型
必选
描述
StatusCode
Integer
是
状态码。支持范围为 400、403、404、405、414、416、451、500、501、502、503、504。
RedirectURL
String
是
重定向 URL，需要为完整跳转路径，如 https://www.test.com/error.html。

ErrorPageParameters

自定义错误页面配置参数。
名称
类型
必选
描述
ErrorPageParams
Array of ErrorPage
否
自定义错误页面配置列表。
注意：此字段可能返回 null，表示取不到有效值。

ExceptionRule

Web 安全的例外规则
名称
类型
必选
描述
Id
String
否
例外规则的 ID。

通过规则 ID 可支持不同的规则配置操作：

增加新规则：ID 为空或不指定 ID 参数；
修改已有规则：指定需要更新/修改的规则 ID；
删除已有规则：ExceptionRules 参数中，Rules 列表中未包含的已有规则将被删除。
Name
String
否
例外规则的名称。
Condition
String
否
例外规则的具体内容，需符合表达式语法，详细规范参见产品文档。
SkipScope
String
否
例外规则执行选项，取值如下：
WebSecurityModules: 指定例外规则的安全防护模块。
ManagedRules：指定托管规则。
SkipOption
String
否
跳过请求的具体类型，取值如下：
SkipOnAllRequestFields: 跳过所有请求；
SkipOnSpecifiedRequestFields: 跳过指定请求字段。
仅当 SkipScope 为 ManagedRules 时有效。
WebSecurityModulesForException
Array of String
否
指定例外规则的安全防护模块，仅当 SkipScope 为 WebSecurityModules 时有效。取值有：
websec-mod-managed-rules：托管规则；
websec-mod-rate-limiting：速率限制；
websec-mod-custom-rules：自定义规则；
websec-mod-adaptive-control：自适应频控、智能客户端过滤、慢速攻击防护、流量盗刷防护；
websec-mod-bot：Bot 管理。
ManagedRulesForException
Array of String
否
指定例外规则的具体托管规则，仅当 SkipScope 为 ManagedRules 时有效，且此时不能指定 ManagedRuleGroupsForException 。
ManagedRuleGroupsForException
Array of String
否
指定例外规则的托管规则组，仅当 SkipScope 为 ManagedRules 时有效，且此时不能指定 ManagedRulesForException 。
RequestFieldsForException
否
指定例外规则跳过指定请求字段的具体配置，仅当 SkipScope 为 ManagedRules 并且 SkipOption 为 SkipOnSpecifiedRequestFields 时有效。
Enabled
String
否
例外规则是否开启。取值如下：
on：开启
off：关闭

ExceptionRules

Web 安全的例外规则
名称
类型
必选
描述
Rules
Array of ExceptionRule
否
例外规则的定义列表。使用 ModifySecurityPolicy 修改 Web 防护配置时:
若未指定 Rules 参数，或 Rules 参数长度为零：清空所有例外规则配置。
若 SecurityPolicy 参数中，未指定 ExceptionRules 参数值：保持已有例外规则配置，不做修改。

FollowOrigin

缓存遵循源站配置。
名称
类型
必选
描述
Switch
String
是
遵循源站配置开关，取值如下：
on：开启。
off：关闭。
DefaultCache
String
否
源站未返回 Cache-Control 头时，缓存/不缓存开关。当 Switch 为 on 时，此字段必填，当 Switch 为 off 时，无需填写此字段，若填写则不生效。取值如下：
on：缓存。
off：不缓存。
DefaultCacheStrategy
String
否
源站未返回 Cache-Control 头时，使用/不使用默认缓存策略开关。当 DefaultCache 为 on 时，此字段必填，否则此字段不生效；当 DefaultCacheTime 不为 0 时，此字段必须为 off。取值如下：
on：使用默认缓存策略。
off：不使用默认缓存策略。
DefaultCacheTime
Integer
否
源站未返回 Cache-Control 头时，表示默认的缓存时间，单位为秒，取值：0-315360000。当 DefaultCache 为 on 时，此字段必填，否则此字段不生效；当 DefaultCacheStrategy 为 on 时， 此字段必须为 0。

ForceRedirectHTTPSParameters

访问协议强制 HTTPS 跳转配置。
名称
类型
必选
描述
Switch
String
否
访问强制跳转配置开关，取值如下：
on：开启。
off：关闭。
RedirectStatusCode
Integer
否
重定向状态码。当 Switch 为 on 时，此字段必填，否则此字段不生效。取值如下：
301：301跳转。
302：302跳转。

FrequentScanningProtection

高频扫描防护配置选项，当某一访客的请求频繁命中「配置为拦截」的托管规则时，在一段时间内封禁该访客所有请求。
名称
类型
必选
描述
Enabled
String
否
高频扫描防护规则是否开启。取值如下：
on：开启，高频扫描防护规则生效；
off：关闭，高频扫描防护规则不生效。
Id
String
否
高频扫描防护的规则 ID，仅作为出参返回。
Action
否
高频扫描防护的处置动作。 当 Enabled 为 on 时，此字段必填。SecurityAction 的 Name 取值支持：
Deny：拦截，响应拦截页面；
Monitor：观察，不处理请求记录安全事件到日志中；
JSChallenge：JavaScript 挑战，响应 JavaScript 挑战页面。
CountBy
String
否
请求统计的匹配方式，当 Enabled 为 on 时，此字段必填。取值如下：
http.request.xff_header_ip：客户端 IP（优先匹配 XFF 头部）；
http.request.ip：客户端 IP。
BlockThreshold
Integer
否
此参数指定高频扫描防护的阈值，即在 CountingPeriod 所设置时间范围内命中「配置为拦截」的托管规则时的累计拦截次数，取值范围 1 ~ 4294967294，例如 100，当超过此统计值时，后续请求将触发 Action 所设置的处置动作。当 Enabled 为 on 时，此字段必填。
CountingPeriod
String
否
此参数指定高频扫描防护所统计的时间窗口，即命中「配置为拦截」的托管规则的请求的统计时间窗口，取值 5 ~ 1800，单位仅支持秒（s），例如 5s。 当 Enabled 为 on 时，此字段必填。
ActionDuration
String
否
此参数指定高频扫描防护 Action 参数所设置处置动作的持续时长，取值范围 60 ~ 86400，单位仅支持秒（s），例如 60s。当 Enabled 为 on 时，此字段必填。

GrpcParameters

gRPC 配置项。
名称
类型
必选
描述
Switch
String
否
gRPC 配置开关，取值如下：
on：开启。
off：关闭。

HeaderAction

HTTP 头部设置规则。
名称
类型
必选
描述
Action
String
是
HTTP 头部设置方式。取值如下：
set：设置。变更指定头部参数的取值为设置后的值；
del：删除。删除指定的头部参数；
add：增加。增加指定的头部参数。
Name
String
是
HTTP 头部名称。
Value
String
否
HTTP 头部值。当 Action 取值为 set 或者 add 时，该参数必填；当 Action 取值为 del 时，该参数无需填写。

HostHeaderParameters

Host Header 重写配置参数。
名称
类型
必选
描述
Action
String
否
执行动作，取值如下：
followOrigin：跟随源站域名。
custom：自定义。
ServerName
String
否
Host Header 重写，需要填写完整域名。
注意：当 Switch 为 on 时，此字段必填；当 Switch 为 off 时，无需填写此字段，若填写则不生效。

HostName

访问 URL 重定向 HostName 配置参数。
名称
类型
必选
描述
Action
String
否
目标 HostName 配置，取值如下：
follow：跟随请求。
custom：自定义。
Value
String
否
目标 HostName 自定义取值，最大长度 1024。
注意：当 Action 为 custom 时，此字段必填；当 Action 为 follow 时，此字段不生效。

HostPolicy

域名策略绑定配置，定义单个域名所使用的安全策略类型及对应的策略内容。
配置字段
类型
必选
描述
Host
String
是
应用安全策略的域名。需为当前站点下已接入的域名。
PolicyType
String
是
域名使用的策略类型，决定策略配置的来源。取值如下：
ZoneDefault：使用站点级默认策略，即 WebSecurity.ZoneDefaultPolicy 中定义的策略配置，此时 Policy 和 TemplateId 字段无效；
Custom：使用域名级自定义策略，此时必须同时配置 Policy 字段，指定该域名的独立策略配置；
Template：使用策略模板，此时必须同时配置 TemplateId 字段，指定该域名绑定的策略模板 ID。
Policy
否
域名级自定义策略配置。仅当 PolicyType 为 Custom 时有效且必填，该配置仅对当前域名生效。
TemplateId
String
否
域名绑定的策略模板 ID。仅当 PolicyType 为 Template 时有效且必填。该模板必须已定义在 WebSecurity.Templates 列表中。

说明：跨站点引用策略模板时，需在模板 ID 后通过 "@" 分隔符追加目标站点 ID，格式为 {TemplateId}@{ZoneId} 。

HSTSParameters

HSTS 配置参数。
名称
类型
必选
描述
Switch
String
否
HSTS 配置开关，取值如下：
on：开启。
off：关闭。
Timeout
Integer
否
缓存 HSTS 头部时间，单位为秒，取值：1-31536000。
注意：当 Switch 为 on 时，此字段必填；当 Switch 为 off 时，无需填写此字段，若填写则不生效。
IncludeSubDomains
String
否
是否允许其他子域名继承相同的 HSTS 头部，取值如下：
on：允许其他子域名继承相同的 HSTS 头部。
off：不允许其他子域名继承相同的 HSTS 头部。
注意：当 Switch 为 on 时，此字段必填；当 Switch 为 off 时，无需填写此字段，若填写则不生效。
Preload
String
否
是否允许浏览器预加载 HSTS 头部，取值如下：
on：允许浏览器预加载 HSTS 头部。
off：不允许浏览器预加载 HSTS 头部。
注意：当 Switch 为 on 时，此字段必填；当 Switch 为 off 时，无需填写此字段，若填写则不生效。

HTTP2Parameters

HTTP2 接入配置参数。
名称
类型
必选
描述
Switch
String
否
HTTP2 接入配置开关，取值如下：
on：开启。
off：关闭。

HttpDDoSProtection

HTTP DDoS 防护配置。
名称
类型
必选
描述
AdaptiveFrequencyControl
否
自适应频控的具体配置。
ClientFiltering
否
智能客户端过滤的具体配置。
BandwidthAbuseDefense
否
流量防盗刷的具体配置。
SlowAttackDefense
否
慢速攻击防护的具体配置。

HTTPResponseParameters

HTTP 应答配置参数。
名称
类型
必选
描述
StatusCode
Integer
否
响应状态码。支持 2XX、4XX、5XX，不包括 499、514、101、301、302、303、509、520-599。
ResponsePage
String
否
响应页面 ID。

HTTPUpstreamTimeoutParameters

七层回源超时配置。
名称
类型
必选
描述
ResponseTimeout
Integer
否
HTTP 应答超时时间，单位为秒，取值：5～600。

IPReputation

IP 情报库（原客户端画像分析）配置。
名称
类型
必选
描述
Enabled
String
否
IP 情报库（原客户端画像分析）。取值有：
on：开启；
off：关闭。
IPReputationGroup
否
IP 情报库（原客户端画像分析）的具体配置内容。

IPReputationGroup

IP 情报库（原客户端画像分析）的具体配置。
名称
类型
必选
描述
BaseAction
否
IP 情报库（原客户端画像分析）的执行动作。SecurityAction 的 Name 取值支持：
Deny：拦截；
Monitor：观察；
Disabled：未启用，不启用指定规则；
Challenge：挑战，其中 ChallengeActionParameters 中的 ChallengeOption 支持 JSChallenge 和 ManagedChallenge。
BotManagementActionOverrides
否
IP 情报库（原客户端画像分析）的具体配置，用于覆盖 BaseAction 中的默认配置。其中 BotManagementActionOverrides 的 Ids 中可以填写：
IPREP_WEB_AND_DDOS_ATTACKERS_LOW：网络攻击 - 一般置信度；
IPREP_WEB_AND_DDOS_ATTACKERS_MID：网络攻击 - 中等置信度；
IPREP_WEB_AND_DDOS_ATTACKERS_HIGH：网络攻击 - 高置信度；
IPREP_PROXIES_AND_ANONYMIZERS_LOW：网络代理 - 一般置信度；
IPREP_PROXIES_AND_ANONYMIZERS_MID：网络代理 - 中等置信度；
IPREP_PROXIES_AND_ANONYMIZERS_HIGH：网络代理 - 高置信度；
IPREP_SCANNING_TOOLS_LOW：扫描器 - 一般置信度；
IPREP_SCANNING_TOOLS_MID：扫描器 - 中等置信度；
IPREP_SCANNING_TOOLS_HIGH：扫描器 - 高置信度；
IPREP_ATO_ATTACKERS_LOW：账号接管攻击 - 一般置信度；
IPREP_ATO_ATTACKERS_MID：账号接管攻击 - 中等置信度；
IPREP_ATO_ATTACKERS_HIGH：账号接管攻击 - 高置信度；
IPREP_WEB_SCRAPERS_AND_TRAFFIC_BOTS_LOW：恶意 BOT - 一般置信度；
IPREP_WEB_SCRAPERS_AND_TRAFFIC_BOTS_MID：恶意 BOT - 中等置信度；
IPREP_WEB_SCRAPERS_AND_TRAFFIC_BOTS_HIGH：恶意 BOT - 高置信度。

IPv6Parameters

IPv6 访问配置。
名称
类型
必选
描述
Switch
String
否
IPv6 访问功能配置，取值如下：
on：开启 IPv6 访问功能；
off：关闭 IPv6 访问功能。

KnownBotCategories

商业或开源工具 UA 特征配置（原 UA 特征规则）。
名称
类型
必选
描述
BaseAction
否
来自已知商业工具或开源工具的访问请求的处置方式。 SecurityAction 的 Name 取值支持：
Deny：拦截；
Monitor：观察；
Disabled：未启用，不启用指定规则；
Challenge：挑战，其中 ChallengeActionParameters 中的 ChallengeOption 支持 JSChallenge 和 ManagedChallenge；
Allow：放行（待废弃）。
BotManagementActionOverrides
否
指定已知商业工具或开源工具的访问请求的处置方式。

ManagedRuleAction

托管规则的项配置
名称
类型
必选
描述
RuleId
String
是
托管规则组下的具体项，用于改写此单条规则项配置的内容，具体参考产品文档。
Action
是
RuleId 中指定托管规则项的处置动作。 SecurityAction 的 Name 取值支持：
Deny：拦截，响应拦截页面；
Monitor：观察，不处理请求，记录安全事件到日志中；
Disabled：未启用，不扫描请求，跳过该规则。

ManagedRuleAutoUpdate

托管规则自动更新选项
名称
类型
必选
描述
AutoUpdateToLatestVersion
String
是
是否开启自动更新至最新版本。取值如下：
on：开启
off：关闭
RulesetVersion
String
否
当前使用的版本，格式符合 ISO 8601标准，如2023-12-21T12:00:32Z，默认为空，仅出参。

ManagedRuleDetail

托管规则详情
名称
类型
必选
描述
RuleId
String
否
托管规则 ID。
RiskLevel
String
否
托管规则的防护级别。取值如下：
low：低风险，此规则风险较低，适用于非常严格控制环境下的访问场景，该等级规则可能造成较多的误报；
medium：中风险，表示此条规则风险正常，适用较为严格的防护场景；
high：高风险，表示此条规则风险较高，大多数场景不会产生误报；
extreme：超高风险，表示此条规则风险极高，基本不会产生误报；
Description
String
否
规则描述。
Tags
Array of String
否
规则标签。部分类型的规则不存在标签。
RuleVersion
String
否
规则所属版本。

ManagedRuleGroup

托管规则组配置。
名称
类型
必选
描述
GroupId
String
是
托管规则的组名称，未指定配置的规则分组将按照默认配置处理，GroupId 的具体取值参考产品文档。
SensitivityLevel
String
是
托管规则组的防护级别。取值如下：
loose：宽松，只包含超高风险规则，此时需配置 Action，且 RuleActions 配置无效；
normal：正常，包含超高风险和高风险规则，此时需配置 Action，且 RuleActions 配置无效；
strict：严格，包含超高风险、高风险和中风险规则，此时需配置 Action，且 RuleActions 配置无效；
extreme：超严格，包含超高风险、高风险、中风险和低风险规则，此时需配置 Action，且 RuleActions 配置无效；
custom：自定义，精细化策略，按单条规则配置处置方式，此时 Action 字段无效，使用 RuleActions 配置单条规则的精细化策略。
Action
是
托管规则组的处置动作。SecurityAction 的 Name 取值支持：
Deny：拦截，响应拦截页面；
Monitor：观察，不处理请求记录安全事件到日志中；
Disabled：未启用，不扫描请求跳过该规则。
RuleActions
Array of ManagedRuleAction
否
托管规则组下规则项的具体配置，仅在 SensitivityLevel 为 custom 时配置生效。
MetaData
否
托管规则组信息，仅出参。

ManagedRuleGroupMeta

托管规则组信息
名称
类型
必选
描述
GroupDetail
String
否
托管规则组描述，仅出参。
GroupName
String
否
托管规则组名称，仅出参。
RuleDetails
Array of ManagedRuleDetail
否
当前托管规则组下的所有子规则信息，仅出参。

ManagedRules

Web 安全的托管规则
名称
类型
必选
描述
Enabled
String
是
托管规则是否开启。取值如下：
on：开启，所有托管规则按配置生效；
off：关闭，所有托管规则不生效。
DetectionOnly
String
是
评估模式是否开启，仅在 Enabled 参数为 on 时有效。取值如下：
on：开启，表示所有托管规则以观察模式生效；
off：关闭，表示所有托管规则以实际配置生效。
SemanticAnalysis
String
否
托管规则语义分析选项是否开启，仅在 Enabled 参数为 on 时有效。取值如下：
on：开启，对请求进行语义分析后进行处理；
off：关闭，对请求不进行语义分析，直接进行处理。

默认为 off。
AutoUpdate
否
托管规则自动更新选项。
ManagedRuleGroups
Array of ManagedRuleGroup
否
托管规则组的配置。如果此结构传空数组或 GroupId 未包含在列表内将按照默认方式处理。
FrequentScanningProtection
否
高频扫描防护配置选项，当某一访客的请求频繁命中「配置为拦截」的托管规则时，在一段时间内封禁该访客所有请求。

MaxAgeParameters

浏览器缓存 TTL 配置参数。
名称
类型
必选
描述
FollowOrigin
String
否
遵循源站 Cache-Control 开关，取值如下：
on：遵循源站，忽略 CacheTime 时间设置。
off：不遵循源站，使用 CacheTime 时间设置。
CacheTime
Integer
否
自定义缓存时间数值，单位为秒，取值：0～315360000。
注意：当 FollowOrigin 为 off 时，表示不遵循源站，使用 CacheTime 设置缓存时间，否则此字段不生效。

MaxNewSessionTriggerConfig

Bot 管理中校验的触发阈值。
名称
类型
必选
描述
MaxNewSessionCountInterval
String
否
触发阈值统计的时间窗口，取值有：
5s：5 秒内；
10s：10 秒内；
15s：15 秒内；
30s：30 秒内；
60s：60 秒内；
5m：5 分钟内；
10m：10 分钟内；
30m：30 分钟内；
60m：60 分钟内。
MaxNewSessionCountThreshold
Integer
否
触发阈值统计的累计次数，取值范围 1 ~ 100000000。

MinimalRequestBodyTransferRate

正文传输最小速率阈值的具体配置。
名称
类型
必选
描述
MinimalAvgTransferRateThreshold
String
是
正文传输最小速率阈值，单位仅支持 bps。
CountingPeriod
String
是
正文传输最小速率统计时间范围，取值如下：
10s：10秒
30s：30秒
60s：60秒
120s：120秒
Enabled
String
是
正文传输最小速率阈值是否开启。取值如下：
on：开启。
off：关闭。

ModifyOriginParameters

修改源站配置参数。
名称
类型
必选
描述
OriginType
String
否
源站类型。取值如下：
IPDomain：IPv4、IPv6 或域名类型源站；
OriginGroup：源站组类型源站；
LoadBalance：负载均衡，该功能内测中，如需使用，请 提交工单；
COS：腾讯云 COS 对象存储源站；
AWSS3：支持 AWS S3 协议的所有对象存储源站。
Origin
String
否
源站地址，根据 OriginType 的取值分为以下情况：

当 OriginType = IPDomain 时，该参数请填写 IPv4、IPv6 地址或域名；
当 OriginType = COS 时，该参数请填写 COS 桶的访问域名；
当 OriginType = AWSS3，该参数请填写 S3 桶的访问域名；
当 OriginType = OriginGroup 时，该参数请填写源站组 ID；当为出参的时候，如果引用了其它站点的源站组，格式为{源站组 ID}@{ZoneID}。例如：og-testorigin@zone-38moq1z10wwwy；
当 OriginType = LoadBalance 时，该参数请填写负载均衡实例 ID，该功能当前仅白名单开放；当为出参的时候，如果引用了其它站点的负载均衡，格式为{负载均衡 ID}@{ZoneID}。例如：lb-2rxpamcyqfzg@zone-38moq1z10wwwy。
OriginProtocol
String
否
回源协议配置。当 OriginType 取值为 IPDomain、OriginGroup、LoadBalance 时该参数必填。取值有：
http：使用 HTTP 协议；
https：使用 HTTPS 协议；
follow：协议跟随。
HTTPOriginPort
Integer
否
HTTP 回源端口，取值范围 1～65535。当回源协议 OriginProtocol 为 http 或者 follow 时该参数必填。
HTTPSOriginPort
Integer
否
HTTPS 回源端口，取值范围 1～65535。当回源协议 OriginProtocol 为 https 或者 follow 时该参数必填。
PrivateAccess
String
否
指定是否允许访问私有对象存储源站，当源站类型 OriginType = COS 或 AWSS3 时该参数必填，取值有：

on：使用私有鉴权；
off：不使用私有鉴权。
PrivateParameters
否
私有鉴权使用参数，该参数仅当 OriginType = AWSS3 且 PrivateAccess = on 时会生效。
注意：此字段可能返回 null，表示取不到有效值。

ModifyRequestHeaderParameters

修改 HTTP 回源请求头配置参数。
名称
类型
必选
描述
HeaderActions
Array of HeaderAction
否
HTTP 头部设置规则列表。
注意：此字段可能返回 null，表示取不到有效值。

ModifyResponseHeaderParameters

修改 HTTP 节点响应头配置参数。
名称
类型
必选
描述
HeaderActions
Array of HeaderAction
否
HTTP 回源头部规则列表。
注意：此字段可能返回 null，表示取不到有效值。

NetworkErrorLoggingParameters

网络错误日志记录配置项。
名称
类型
必选
描述
Switch
String
否
网络错误日志记录配置开关，取值有
on：开启；
off：关闭。

NoCache

不缓存配置
名称
类型
必选
描述
Switch
String
是
不缓存配置开关，取值如下：
on：开启。
off：关闭。

OCSPStaplingParameters

OCSP 装订配置参数。
名称
类型
必选
描述
Switch
String
否
OCSP 装订配置开关，取值如下：
on：开启；
off：关闭。

OfflineCacheParameters

离线缓存是否开启。
名称
类型
必选
描述
Switch
String
否
离线缓存开关，取值如下：
on：开启；
off：关闭。

OriginAuthenticationParameters

回源鉴权参数。
名称
类型
必选
描述
RequestProperties
是
回源鉴权请求属性。

OriginAuthenticationRequestProperties

回源鉴权请求属性。
名称
类型
必选
描述
Type
String
是
设置回源鉴权参数类型，取值有：
QueryString：表示设置回源鉴权参数类型为查询字符串；
Header：表示设置回源鉴权参数类型为请求头。
Name
String
是
设置回源鉴权类型对应的参数名称。
Value
String
是
设置回源鉴权类型对应的参数值。

OriginPrivateParameters

对象存储源站私有鉴权参数。
名称
类型
必选
描述
AccessKeyId
String
是
鉴权参数 Access Key ID。
SecretAccessKey
String
是
鉴权参数 Secret Access Key。
SignatureVersion
String
是
鉴权版本。取值有：
v2：v2版本；
v4：v4版本。
Region
String
否
存储桶地域。

OriginPullProtocolParameters

回源 HTTPS 配置参数。
名称
类型
必选
描述
Protocol
String
否
回源协议配置，取值如下：
http：使用 HTTP 协议回源；
https：使用 HTTPS 协议回源；
follow：协议跟随。

PostMaxSizeParameters

POST 请求上传文件流式传输最大限制。
名称
类型
必选
描述
Switch
String
否
是否开启 POST 请求上传文件限制，单位为 Byte，平台默认限制为 32 * 220 Byte，取值如下：
on：开启限制；
off：关闭限制。
MaxSize
Integer
否
POST 请求上传文件流式传输最大限制，该字段仅在 Switch 为 on 时生效，取值在 1MB 和 800MB 之间，单位字节。

QUICParameters

QUIC 配置项。
名称
类型
必选
描述
Switch
String
否
QUIC 配置开关，取值如下：
on：开启；
off：关闭。

RangeOriginPullParameters

分片回源配置参数。
名称
类型
必选
描述
Switch
String
否
分片回源开关，取值如下：
on：开启；
off：关闭。

RateLimitingRule

速率限制的具体配置。
名称
类型
必选
描述
Id
String
否
精准速率限制的 ID。
通过规则 ID 可支持不同的规则配置操作：
增加新规则：ID 为空或不指定 ID 参数；
修改已有规则：指定需要更新/修改的规则 ID；
删除已有规则：RateLimitingRules 参数中，Rules 列表中未包含的已有规则将被删除。
Name
String
否
精准速率限制的名称。
Condition
String
否
精准速率限制的具体内容，需符合表达式语法，详细规范参见 产品文档。
Mode
String
否
限速方式。在统计时间窗口 CountingPeriod 内，对满足特征 CountBy 的请求，支持配置以下限速方式：
Block: 阻断访问源。当统计次数超过阈值 MaxRequestThreshold 时，在 ActionDuration 时长内，对满足特征的所有后续请求执行 Action 处置；
Throttle: 仅处置超额请求。当统计次数超过阈值 MaxRequestThreshold 时，仅对超过阈值的请求执行 Action 处置，窗口结束后停止处置。此时，ActionDuration 参数将被忽略。

默认值为 Block。
CountBy
Array of String
否
速率阈值请求特征的匹配方式， 当 Enabled 为 on 时，此字段必填。
当条件有多个时，将组合多个条件共同进行统计计算，条件最多不可超过5条。取值有：
http.request.ip：客户端 IP；
http.request.xff_header_ip：客户端 IP（优先匹配 XFF 头部）；
http.request.uri.path：请求的访问路径；
http.request.cookies['session']：名称为 session 的 Cookie，其中 session 可替换为自己指定的参数；
http.request.headers['user-agent']：名称为 user-agent 的 HTTP 头部，其中 user-agent 可替换为自己指定的参数；
http.request.ja3：请求的 JA3指纹；
http.request.uri.query['test']：名称为 test 的 URL 查询参数，其中 test 可替换为自己指定的参数。
MaxRequestThreshold
Integer
否
精准速率限制在时间范围内的累计拦截次数，取值范围 1 ~ 100000。
CountingPeriod
String
否
统计的时间窗口，取值有：
1s：1秒；
5s：5秒；
10s：10秒；
20s：20秒；
30s：30秒；
40s：40秒；
50s：50秒；
1m：1分钟；
2m：2分钟；
5m：5分钟；
10m：10分钟；
1h：1小时。
ActionDuration
String
否
Action 动作的持续时长，单位仅支持：
s：秒，取值 1 ~ 120；
m：分钟，取值 1 ~ 120；
h：小时，取值 1 ~ 48；
d：天，取值 1 ~ 30。
当 Mode 为 Throttle 时，此参数将被忽略，不会生效。
Action
否
精准速率限制的处置方式。取值有：
Monitor：观察；
Deny：拦截，其中 DenyActionParameters.Name 支持 Deny 和 ReturnCustomPage；
Challenge：挑战，其中 ChallengeActionParameters.Name 支持 JSChallenge 和ManagedChallenge；
Redirect：重定向至 URL。
Priority
Integer
否
精准速率限制的优先级，范围是 0 ~ 100，默认为 0。
Enabled
String
否
精准速率限制规则是否开启。取值有：
on：开启。
off：关闭。

RateLimitingRules

精准速率限制的配置
名称
类型
必选
描述
Rules
Array of RateLimitingRule
否
精准速率限制的定义列表。使用 ModifySecurityPolicy 修改 Web 防护配置时：
若未指定 Rules 参数，或 Rules 参数长度为零：清空所有精准速率限制配置。
若 SecurityPolicy 参数中，未指定 RateLimitingRules 参数值：保持已有自定义规则配置，不做修改。

RedirectActionParameters

Web 安全重定向的附加参数
名称
类型
必选
描述
URL
String
是
重定向的 URL。

RequestBodyTransferTimeout

正文传输超时时长的具体配置。
名称
类型
必选
描述
IdleTimeout
String
是
正文传输超时时长，取值 5 ~ 120，单位仅支持秒（s）。
Enabled
String
是
正文传输超时时长是否开启。取值有：
on：开启；
off：关闭。

RequestFieldsForException

例外规则中的跳过字段配置
名称
类型
必选
描述
Scope
String
是
跳过的具体字段。取值支持：
body.json：JSON 请求内容；此时 Condition 支持 key、value, TargetField 支持 key、value，例如 { "Scope": "body.json", "Condition": "", "TargetField": "key" }，表示 JSON 请求内容所有参数跳过 WAF 扫描；
cookie：Cookie；此时 Condition 支持 key、value, TargetField 支持 key、value，例如 { "Scope": "cookie", "Condition": "${key} in ['account-id'] and ${value} like ['prefix-']", "TargetField": "value" }，表示 Cookie 参数名称等于 account-id 并且参数值通配符匹配 prefix- 跳过 WAF 扫描；
header：HTTP 头部参数；此时 Condition 支持 key、value, TargetField 支持 key、value，例如 { "Scope": "header", "Condition": "${key} like ['x-auth-']", "TargetField": "value" }，表示 header 参数名称通配符匹配 x-auth- 跳过 WAF 扫描；
uri.query：URL 编码内容/查询参数；此时 Condition 支持 key、value, TargetField 支持 key、value，例如 { "Scope": "uri.query", "Condition": "${key} in ['action'] and ${value} in ['upload', 'delete']", "TargetField": "value" }，表示 URL 编码内容/查询参数的参数名称等于 action 并且参数值等于 upload 或 delete 跳过 WAF 扫描；
uri：请求路径 URI；此时 Condition 必须为空， TargetField 支持 query、path、fullpath，例如 { "Scope": "uri", "Condition": "", "TargetField": "query" }，表示请求路径 URI 仅查询参数跳过 WAF 扫描；
body：请求正文内容。此时 Condition 必须为空， TargetField 支持 fullbody、multipart，例如 { "Scope": "body", "Condition": "", "TargetField": "fullbody" }，表示请求正文内容为完整请求正文跳过 WAF 扫描。
Condition
String
是
跳过的具体字段的表达式，需要符合表达式语法。
Condition 支持表达式配置语法：
按规则的匹配条件表达式语法编写，支持引用 key、value。
支持 in、like 操作符，以及 and 逻辑组合。
例如：
${key} in ['x-trace-id']：参数名称等于 x-trace-id。
${key} in ['x-trace-id'] and ${value} like ['Bearer *']：参数名称等于 x-trace-id 并且参数值通配符匹配 Bearer *。
TargetField
String
是
Scope 参数使用不同取值时，TargetField 表达式中支持的值如下：
body.json：支持 key、value
cookie：支持 key、value
header：支持 key、value
uri.query：支持 key、value
uri：支持 path、query、fullpath
body：支持 fullbody、multipart

ResponseSpeedLimitParameters

单连接下载限速配置参数。
名称
类型
必选
描述
Mode
String
是
下载限速模式，取值有：

LimitUponDownload：全过程下载限速；
LimitAfterSpecificBytesDownloaded：全速下载特定字节后开始限速；
LimitAfterSpecificSecondsDownloaded：全速下载特定时间后开始限速。
MaxSpeed
String
是
限速值，指定限速大小，填写含单位的数值或变量。当前支持单位有：KB/s。
StartAt
String
否
限速开始值，可以为下载大小或指定时长，填写含单位的数值或变量，指定下载大小或指定时长。
当 Mode 取值为 LimitAfterSpecificBytesDownloaded 时，单位取值有：KB。
当 Mode 取值为 LimitAfterSpecificSecondsDownloaded 时，单位取值有：s。

ReturnCustomPageActionParameters

Web 安全自定义页面的附加参数
名称
类型
必选
描述
ResponseCode
String
是
响应状态码。
ErrorPageId
String
是
响应的自定义页面 ID。

RuleBranch

子规则分支。
名称
类型
必选
描述
Condition
String
否
Actions
Array of RuleEngineAction
否
操作。
注意：Actions 和 SubRules 不可同时为空。
注意：此字段可能返回 null，表示取不到有效值。
SubRules
Array of RuleEngineSubRule
否
子规则列表。此列表中时存在多条规则，按照从上往下的顺序依次执行。
注意：SubRules 和 Actions 不可同时为空。且当前只支持填写一层 SubRules。
注意：此字段可能返回 null，表示取不到有效值。

RuleEngineAction

规则引擎操作。
名称
类型
必选
描述
Name
String
是
操作名称。名称需要与参数结构体对应，例如 Name=Cache，则 CacheParameters 必填。

Cache：节点缓存 TTL；
CacheKey：自定义 Cache Key；
CachePrefresh：缓存预刷新；
AccessURLRedirect：访问 URL 重定向；
UpstreamURLRewrite：回源 URL 重写；
QUIC：QUIC；
WebSocket：WebSocket；
Authentication：Token 鉴权；
MaxAge：浏览器缓存 TTL；
StatusCodeCache：状态码缓存 TTL；
OfflineCache：离线缓存；
SmartRouting：智能加速；
RangeOriginPull：分片回源 ；
UpstreamHTTP2：HTTP2 回源；
HostHeader：Host Header 重写；
ForceRedirectHTTPS：访问协议强制 HTTPS 跳转配置；
OriginPullProtocol：回源 HTTPS；
Compression：智能压缩配置；
HSTS：HSTS；
ClientIPHeader：存储客户端请求 IP 的头部信息配置；
OCSPStapling：OCSP 装订；
HTTP2：HTTP2 接入；
PostMaxSize：POST 请求上传文件流式传输最大限制配置；
ClientIPCountry：回源时携带客户端 IP 所属地域信息；
UpstreamFollowRedirect：回源跟随重定向参数配置；
UpstreamRequest：回源请求参数；
Shield：源站卸载配置；
TLSConfig：SSL/TLS 安全；
ModifyOrigin：修改源站；
SiteFailover：源站故障转移；
HTTPUpstreamTimeout：七层回源超时配置；
HttpResponse：HTTP 应答；
ErrorPage：自定义错误页面；
ModifyResponseHeader：修改 HTTP 节点响应头；
ModifyRequestHeader：修改 HTTP 节点请求头；
ResponseSpeedLimit：单连接下载限速；
SetContentIdentifier：设置内容标识符；
Vary：Vary 特性配置。
ContentCompression：内容压缩配置；
OriginAuthentication：回源鉴权配置。
CacheParameters
否
节点缓存 TTL 配置参数，当 Name 取值为 Cache 时，该参数必填。
注意：此字段可能返回 null，表示取不到有效值。
CacheKeyParameters
否
自定义 Cache Key 配置参数，当 Name 取值为 CacheKey 时，该参数必填。
注意：此字段可能返回 null，表示取不到有效值。
CachePrefreshParameters
否
缓存预刷新配置参数，当 Name 取值为 CachePrefresh 时，该参数必填。
注意：此字段可能返回 null，表示取不到有效值。
AccessURLRedirectParameters
否
访问 URL 重定向配置参数，当 Name 取值为 AccessURLRedirect 时，该参数必填。
注意：此字段可能返回 null，表示取不到有效值。
UpstreamURLRewriteParameters
否
回源 URL 重写配置参数，当 Name 取值为 UpstreamURLRewrite 时，该参数必填。
注意：此字段可能返回 null，表示取不到有效值。
QUICParameters
否
QUIC 配置参数，当 Name 取值为 QUIC 时，该参数必填。
注意：此字段可能返回 null，表示取不到有效值。
WebSocketParameters
否
WebSocket 配置参数，当 Name 取值为 WebSocket 时，该参数必填。
注意：此字段可能返回 null，表示取不到有效值。
AuthenticationParameters
否
Token 鉴权配置参数，当 Name 取值为 Authentication 时，该参数必填。
注意：此字段可能返回 null，表示取不到有效值。
MaxAgeParameters
否
浏览器缓存 TTL 配置参数，当 Name 取值为 MaxAge 时，该参数必填。
注意：此字段可能返回 null，表示取不到有效值。
StatusCodeCacheParameters
否
状态码缓存 TTL 配置参数，当 Name 取值为 StatusCodeCache 时，该参数必填。
注意：此字段可能返回 null，表示取不到有效值。
OfflineCacheParameters
否
离线缓存配置参数，当 Name 取值为 OfflineCache 时，该参数必填。
注意：此字段可能返回 null，表示取不到有效值。
SmartRoutingParameters
否
智能加速配置参数，当 Name 取值为 SmartRouting 时，该参数必填。
注意：此字段可能返回 null，表示取不到有效值。
RangeOriginPullParameters
否
分片回源配置参数，当 Name 取值为 RangeOriginPull 时，该参数必填。
注意：此字段可能返回 null，表示取不到有效值。
UpstreamHTTP2Parameters
否
HTTP2 回源配置参数，当 Name 取值为 UpstreamHTTP2 时，该参数必填。
注意：此字段可能返回 null，表示取不到有效值。
HostHeaderParameters
否
Host Header 重写配置参数，当 Name 取值为 HostHeader 时，该参数必填。
注意：此字段可能返回 null，表示取不到有效值。
ForceRedirectHTTPSParameters
否
访问协议强制 HTTPS 跳转配置，当 Name 取值为 ForceRedirectHTTPS 时，该参数必填。
注意：此字段可能返回 null，表示取不到有效值。
OriginPullProtocolParameters
否
回源 HTTPS 配置参数，当 Name 取值为 OriginPullProtocol 时，该参数必填。
注意：此字段可能返回 null，表示取不到有效值。
CompressionParameters
否
智能压缩配置，当 Name 取值为 Compression 时，该参数必填。
注意：此字段可能返回 null，表示取不到有效值。
HSTSParameters
否
HSTS 配置参数，当 Name 取值为 HSTS 时，该参数必填。
注意：此字段可能返回 null，表示取不到有效值。
ClientIPHeaderParameters
否
存储客户端请求 IP 的头部信息配置，当 Name 取值为 ClientIPHeader 时，该参数必填。
注意：此字段可能返回 null，表示取不到有效值。
OCSPStaplingParameters
否
OCSP 装订配置参数，当 Name 取值为 OCSPStapling 时，该参数必填。
注意：此字段可能返回 null，表示取不到有效值。
HTTP2Parameters
否
HTTP2 接入配置参数，当 Name 取值为 HTTP2 时，该参数必填。
注意：此字段可能返回 null，表示取不到有效值。
PostMaxSizeParameters
否
POST 请求上传文件流式传输最大限制配置，当 Name 取值为 PostMaxSize 时，该参数必填。
注意：此字段可能返回 null，表示取不到有效值。
ClientIPCountryParameters
否
回源时携带客户端 IP 所属地域信息配置参数，当 Name 取值为 ClientIPCountry 时，该参数必填。
注意：此字段可能返回 null，表示取不到有效值。
UpstreamFollowRedirectParameters
否
回源跟随重定向参数配置，当 Name 取值为 UpstreamFollowRedirect 时，该参数必填。
注意：此字段可能返回 null，表示取不到有效值。
UpstreamRequestParameters
否
回源请求参数配置参数，当 Name 取值为 UpstreamRequest 时，该参数必填。
注意：此字段可能返回 null，表示取不到有效值。
ShieldParameters
否
源站卸载配置参数，当 Name 取值为 Shield 时，该参数必填。
注意：此字段可能返回 null，表示取不到有效值。
TLSConfigParameters
否
SSL/TLS 安全配置参数，当 Name 取值为 TLSConfig 时，该参数必填。
注意：此字段可能返回 null，表示取不到有效值。
ModifyOriginParameters
否
修改源站配置参数，当 Name 取值为 ModifyOrigin 时，该参数必填。
注意：此字段可能返回 null，表示取不到有效值。
SiteFailoverParameters
否
源站故障转移配置参数，当 Name 取值为 SiteFailover 时，该参数必填。
注意：此字段可能返回 null，表示取不到有效值。
HTTPUpstreamTimeoutParameters
否
七层回源超时配置，当 Name 取值为 HTTPUpstreamTimeout 时，该参数必填。
注意：此字段可能返回 null，表示取不到有效值。
HttpResponseParameters
否
HTTP 应答配置参数，当 Name 取值为 HttpResponse 时，该参数必填。
注意：此字段可能返回 null，表示取不到有效值。
ErrorPageParameters
否
自定义错误页面配置参数，当 Name 取值为 ErrorPage 时，该参数必填。
注意：此字段可能返回 null，表示取不到有效值。
ModifyResponseHeaderParameters
否
修改 HTTP 节点响应头配置参数，当 Name 取值为 ModifyResponseHeader 时，该参数必填。
注意：此字段可能返回 null，表示取不到有效值。
ModifyRequestHeaderParameters
否
修改 HTTP 节点请求头配置参数，当 Name 取值为 ModifyRequestHeader 时，该参数必填。
注意：此字段可能返回 null，表示取不到有效值。
ResponseSpeedLimitParameters
否
单连接下载限速配置参数，当 Name 取值为 ResponseSpeedLimit 时，该参数必填。
注意：此字段可能返回 null，表示取不到有效值。
SetContentIdentifierParameters
否
内容标识配置参数，当 Name 取值为 SetContentIdentifier 时，该参数必填。
注意：此字段可能返回 null，表示取不到有效值。
VaryParameters
否
Vary 特性配置参数，当 Name 取值为 Vary 时，该参数必填。
ContentCompressionParameters
否
内容压缩配置参数，当 Name 取值为 ContentCompression 时，该参数必填。该参数为白名单功能，如有需要，请联系腾讯云工程师处理。
OriginAuthenticationParameters
否
回源鉴权配置参数，当 Name 取值为 OriginAuthentication 时，该参数必填。该参数为白名单功能，如有需要，请联系腾讯云工程师处理。

RuleEngineSubRule

子规则。
名称
类型
必选
描述
Branches
Array of RuleBranch
否
子规则分支
注意：此字段可能返回 null，表示取不到有效值。
Description
Array of String
否
规则注释。

Rules

规则按从上往下的顺序匹配执行，​​匹配到一个最小单元则停止匹配，下方的规则可覆盖上方规则中对相同配置项的设置​​。规则引擎配置在导入后默认为开启状态。
RuleName
String
否
规则名称。名称长度限制不超过 255 个字符。
Description
Array of String
否
规则注释。可以填写多个注释。
Branches
Array of RuleBranch
否
子规则分支。此列表当前只支持填写一项规则，多填无效。
注意：此字段可能返回 null，表示取不到有效值。

SearchEngineBots

搜索引擎规则配置。
名称
类型
必选
描述
BaseAction
否
来自搜索引擎爬虫的请求的执行动作。 SecurityAction 的 Name 取值支持：
Deny：拦截；
Monitor：观察；
Disabled：未启用，不启用指定规则；
Challenge：挑战，其中 ChallengeActionParameters 中的 ChallengeOption 支持 JSChallenge 和 ManagedChallenge；
Allow：放行（待废弃）。
BotManagementActionOverrides
否
指定搜索引擎爬虫请求的处置方式。

SecurityAction

安全的执行动作
名称
类型
必选
描述
Name
String
是
安全执行的具体动作。取值有：

Deny：拦截，阻止请求访问站点资源；
Monitor：观察，仅记录日志；
Redirect：重定向至 URL；
Disabled：未启用，不启用指定规则；
Allow：允许访问，但延迟处理请求；
Challenge：挑战，响应挑战内容；
BlockIP：待废弃，IP 封禁；
ReturnCustomPage：待废弃，使用指定页面拦截；
JSChallenge：待废弃，JavaScript 挑战；
ManagedChallenge：待废弃，托管挑战。
DenyActionParameters
否
当 Name 为 Deny 时的附加参数。
RedirectActionParameters
否
当 Name 为 Redirect 时的附加参数。
AllowActionParameters
否
当 Name 为 Allow 时的附加参数。
ChallengeActionParameters
否
当 Name 为 Challenge 时的附加参数。
BlockIPActionParameters
否
待废弃，当 Name 为 BlockIP 时的附加参数。
ReturnCustomPageActionParameters
否
待废弃，当 Name 为 ReturnCustomPage 时的附加参数。

SecurityPolicy

安全策略配置
名称
类型
必选
描述
CustomRules
否
自定义规则配置。
ManagedRules
否
托管规则配置。
HttpDDoSProtection
否
HTTP DDoS 防护配置。
RateLimitingRules
否
速率限制规则配置。
ExceptionRules
否
例外规则配置。
BotManagement
否
Bot 管理配置。
BotManagementLite
否
基础 Bot 管理配置。
DefaultDenySecurityActionParameters
否
默认拦截动作配置。

SecurityWeightedAction

按权重分配的 SecurityAction。
名称
类型
必选
描述
SecurityAction
否
Bot 自定义规则的处置方式。取值有：
Allow：放行，其中 AllowActionParameters 支持 MinDelayTime 和 MaxDelayTime 配置；
Deny：拦截，其中 DenyActionParameters 中支持 BlockIP、ReturnCustomPage 和 Stall 配置；
Monitor：观察；
Challenge：挑战，其中 ChallengeActionParameters.ChallengeOption 支持 JSChallenge 和 ManagedChallenge；
Redirect：重定向至 URL。
Weight
Integer
否
当前 SecurityAction 的权重，仅支持 10 ~ 100 且必须为 10 的倍数，其中 Weight 参数全部相加须等于 100。

SessionRateControl

会话速率和周期特征校验配置。
名称
类型
必选
描述
Enabled
String
否
会话速率和周期特征校验配置是否开启。取值有：
on：启用
off：关闭
HighRateSessionAction
否
会话速率和周期特征校验高风险的执行动作。 SecurityAction 的 Name 取值支持：
Deny：拦截，其中 DenyActionParameters 中支持 Stall 配置；
Monitor：观察；
Allow：等待后响应，其中 AllowActionParameters 需要 MinDelayTime 和 MaxDelayTime 配置。
MidRateSessionAction
否
会话速率和周期特征校验中风险的执行动作。 SecurityAction 的 Name 取值支持：
Deny：拦截，其中 DenyActionParameters 中支持 Stall 配置；
Monitor：观察；
Allow：等待后响应，其中 AllowActionParameters 需要 MinDelayTime 和 MaxDelayTime 配置。
LowRateSessionAction
否
会话速率和周期特征校验低风险的执行动作。 SecurityAction 的 Name 取值支持：
Deny：拦截，其中 DenyActionParameters 中支持 Stall 配置；
Monitor：观察；
Allow：等待后响应，其中 AllowActionParameters 需要 MinDelayTime 和 MaxDelayTime 配置。

SetContentIdentifierParameters

内容标识配置参数。
名称
类型
必选
描述
ContentIdentifier
String
否
内容标识 id

ShieldParameters

源站卸载配置参数。
名称
类型
必选
描述
ShieldSpaceId
String
是
源站卸载空间 ID。

SiteFailover

源站故障转移 配置参数内部结构。
名称
类型
必选
描述
Mode
String
是
源站故障转移类型。取值有：

FailoverToHost:回源到指定 IP/域名；
FailoverToCOS:回源到腾讯云 COS；
FailoverToS3CompatibleObjectStorage:回源到 S3 兼容；
FailoverRedirectToURL :重定向至指定 URL；
FailoverCustomResponsePage:使用自定义响应页面。
Origin
String
否
源站地址，根据 Mode 的取值分为以下情况：

当 Mode = FailoverToHost 时，该参数请填写 IPv4、IPv6 地址或域名；
当 Mode = FailoverToCOS 时，该参数请填写 COS 桶的访问域名；
当 Mode = FailoverToS3CompatibleObjectStorage，该参数请填写 S3 桶的访问域名。
OriginProtocol
String
否
回源协议配置。当 Mode 取值为 FailoverToHost 时该参数必填。取值有：

http：使用 HTTP 协议；
https：使用 HTTPS 协议；
follow：协议跟随。
HTTPOriginPort
Integer
否
HTTP 回源端口，取值范围 1～65535。当回源协议 OriginProtocol 为 http 或者 follow 时该参数必填。
HTTPSOriginPort
Integer
否
HTTPS 回源端口，取值范围 1～65535。当回源协议 OriginProtocol 为 https 或者 follow 时该参数必填。
UpstreamHostHeader
否
回源 Host Header 重写配置，
UpstreamURLRewrite
否
回源 URL 重写配置。
UpstreamRequestParameters
否
回源请求参数配置。
UpstreamHTTP2Parameters
否
HTTP2 回源配置参数。
PrivateAccess
String
否
指定是否允许访问私有对象存储源站，当源站类型 Mode = FailoverToCOS 或 FailoverToS3CompatibleObjectStorage 时该参数必填，取值有：

on：使用私有鉴权；
off：不使用私有鉴权。
PrivateParameters
否
私有鉴权使用参数，该参数仅当 Mode = FailoverToS3CompatibleObjectStorage 且 PrivateAccess = on 时会生效。
RedirectURL
String
否
重定向目标 URL。当 Mode 取值为 FailoverRedirectToURL 时该参数必填。
ResponsePageId
String
否
响应页面 ID。当 Mode 取值为 FailoverCustomResponsePage 时该参数必填。
StatusCode
Integer
否
响应状态码。当 Mode 取值为 FailoverRedirectToURL 或 FailoverCustomResponsePage 时该参数必填。取值有：

当 Mode = FailoverRedirectToURL 时，该参数取值为 301、302、303、307、308 之一；
当 Mode = FailoverCustomResponsePage 时，该参数取值为 400、403、404、405、414、416、451、500、501、502、503、504 之一。

SiteFailoverParameters

源站故障转移配置参数。
名称
类型
必选
描述
SiteFailoverStatusCodes
Array of Integer
是
源站故障转移条件状态码。当源站返回的响应状态码命中本字段返回时，才会按照 SiteFailoverParams 执行源站转移。该参数取值为 4xx、5xx 之一。
SiteFailoverParams
Array of SiteFailover
是
源站故障转移配置参数列表。最小长度为1，最大长度为2。

SlowAttackDefense

慢速攻击防护的具体配置。
名称
类型
必选
描述
Enabled
String
是
慢速攻击防护是否开启。取值有：
on：开启；
off：关闭。
Id
String
否
慢速攻击防护的规则 ID，仅作为出参返回。
Action
否
慢速攻击防护的处置方式，当 Enabled 为 on 时，此字段必填。SecurityAction 的 Name 取值支持：
Monitor：观察；
Deny：拦截；
MinimalRequestBodyTransferRate
否
正文传输最小速率阈值的具体配置，当 Enabled 为 on 时，此字段必填。
RequestBodyTransferTimeout
否
正文传输超时时长的具体配置，当 Enabled 为 on 时，此字段必填。

SmartRoutingParameters

智能加速配置。
名称
类型
必选
描述
Switch
String
否
智能加速配置开关，取值有：

on：开启；
off：关闭。

SourceIDC

IDC 规则配置的具体内容。
名称
类型
必选
描述
BaseAction
否
来自指定 IDC 请求的处置方式。 SecurityAction 的 Name 取值支持：
Deny：拦截；
Monitor：观察；
Disabled：未启用，不启用指定规则；
Challenge：挑战，其中 ChallengeActionParameters 中的 ChallengeOption 支持 JSChallenge 和 ManagedChallenge；
Allow：放行（待废弃）。
BotManagementActionOverrides
否
指定 IDC 请求的处置方式。

StandardDebugParameters

Debug 调试结构体。
名称
类型
必选
描述
Switch
String
否
Debug 功能开关，取值有：

on：开启；
off：关闭。
AllowClientIPList
Array of String
否
允许的客户端来源。支持填写 IPv4 以及 IPv6 的 IP 网段。0.0.0.0/0 表示允许所有 IPv4 客户端进行调试；::/0 表示允许所有 IPv6 客户端进行调试；不能填写 127.0.0.1。
注意：当 Switch 字段为 on 时，此字段必填，且填写个数为 1～100；当 Switch 为 off 时，无需填写此字段，若填写则不生效。
Expires
否
Debug 功能到期时间。超出设置的时间，则功能失效。
注意：当 Switch 为 on 时，此字段必填；当 Switch 为 off 时，无需填写此字段，若填写则不生效。

StatusCodeCacheParam

状态码缓存 TTL 配置参数内部结构。
名称
类型
必选
描述
StatusCode
Integer
否
状态码，取值为 400、 401、403、 404、 405、 407、 414、 500、 501、 502、 503、 504、 509、 514 之一。
CacheTime
Integer
否
缓存时间数值，单位为秒，取值：0～31536000。

StatusCodeCacheParameters

状态码缓存 TTL 配置参数。
名称
类型
必选
描述
StatusCodeCacheParams
否
状态码缓存 TTL 。
注意：此字段可能返回 null，表示取不到有效值。

Templates

策略模板配置，定义可被多个域名复用的安全策略。通过 HostPolicy 中指定 PolicyType 为 Template 并引用 TemplateId，可实现多个域名共享同一份策略配置。
配置字段
类型
必选
描述
Id
String
是
策略模板的唯一标识 ID。该 ID 在 HostPolicy 中被 TemplateId 字段引用，用于将域名绑定到该策略模板。
Policy
是
策略模板的策略配置。该配置对所有通过 HostPolicy 绑定此模板的域名生效，修改模板策略配置将同步影响所有关联域名。

TLSConfigParameters

SSL/TLS 安全配置参数。
名称
类型
必选
描述
Version
Array of String
否
TLS 版本。至少填写一个，如果是多个时，需要为连续版本号，例如：开启 TLS1、1.1、1.2 和 1.3，不可仅开启 1 和 1.2 而关闭 1.1。取值有：
TLSv1：TLSv1 版本；
TLSv1.1：TLSv1.1 版本；
TLSv1.2：TLSv1.2 版本；
TLSv1.3：TLSv1.3 版本。
CipherSuite
String
否
密码套件。详细介绍请参考TLS 版本及密码套件说明
。取值有：
loose-v2023：loose-v2023 密码套件；
general-v2023：general-v2023 密码套件；
strict-v2023：strict-v2023 密码套件。

UpstreamFollowRedirectParameters

回源跟随重定向参数配置。
名称
类型
必选
描述
Switch
String
否
回源跟随重定向配置开关，取值如下：
on：开启；
off：关闭。
MaxTimes
Integer
否
最大重定向次数。取值为 1-5。
注意：当 Switch 为 on 时，此字段必填；当 Switch 为 off 时，无需填写此字段，若填写则不生效。

UpstreamHTTP2Parameters

HTTP2 回源配置。
名称
类型
必选
描述
Switch
String
否
HTTP2 回源配置开关，取值如下：
on：开启；
off：关闭。

UpstreamRequestCookie

回源请求参数 Cookie 配置。
名称
类型
必选
描述
Switch
String
否
回源请求参数 Cookie 配置开关，取值如下：
on：开启；
off：关闭。
Action
String
否
回源请求参数 Cookie 模式。当 Switch 为 on 时，该参数必填。取值如下：
full：表示全部保留；
ignore：表示全部忽略；
includeCustom：表示保留部分参数；
excludeCustom：表示忽略部分参数。
Values
Array of String
否
指定参数值。仅当查询字符串模式 Action 为 includeCustom 或者 excludeCustom 时该参数生效，用于指定需要保留或者忽略的参数。最大支持 10 个参数。

UpstreamRequestParameters

回源请求参数配置参数。
名称
类型
必选
描述
QueryString
否
查询字符串配置。可选配置项，不填表示不配置。
注意：此字段可能返回 null，表示取不到有效值。
Cookie
否
Cookie 配置。可选配置项，不填表示不配置。
注意：此字段可能返回 null，表示取不到有效值。

UpstreamRequestQueryString

回源请求参数查询字符串配置。
名称
类型
必选
描述
Switch
String
否
回源请求参数查询字符串配置开关，取值如下：
on：开启；
off：关闭。
Action
String
否
查询字符串模式。当 Switch 为 on 时，该参数必填。取值如下：
full：全部保留；
ignore：全部忽略；
includeCustom：保留部分参数；
excludeCustom：忽略部分参数。
Values
Array of String
否
指定参数值。仅当查询字符串模式 Action 为 includeCustom 或者 excludeCustom 时该参数生效，用于指定需要保留或者忽略的参数。最大支持 10 个参数。

UpstreamURLRewriteParameters

回源 URL 重写 配置参数。
名称
类型
必选
描述
Type
String
否
回源 URL 重写类型。仅支持填写 Path。
Action
String
否
回源 URL 重写动作。取值如下：

replace：指替换完整路径。用于将完整的请求 URL Path 替换为指定路径。
addPrefix：指增加路径前缀。用于增加指定路径前缀至请求 URL Path。
rmvPrefix：指移除路径前缀。用于移除请求 URL Path 的指定路径前缀。
regexReplace：指正则替换完整路径。用于通过 Google RE2 正则表达式匹配和替换完整路径。
Value
String
否
回源 URL 重写值。需要满足 URL Path 规范，且保证重写后的 Path 以 / 开头，以防止回源 URL 的 Host 被修改，长度范围为 1～1024。当 Action 为 addPrefix 时，不能以 / 结尾；当 Action 为 rmvPrefix 时，不能存在 *；当 Action 为 regexReplace 时，支持用 $NUM 引用正则捕获组，其中 NUM 代表组编号，如 $1，最多支持 $9。
Regex
String
否
回源 URL 重写用于正则替换匹配完整路径的正则表达式。需要满足 Google RE2 规范，长度范围为 1～1024。当 Action 为 regexReplace 时，此字段必填，否则无需填写此字段。

URLPath

访问 URL 重定向路径配置参数。
名称
类型
必选
描述
Action
String
否
执行动作，取值如下：
follow：跟随请求；
custom：自定义；
regex：正则匹配。
Regex
String
否
正则匹配的表达式，长度范围为 1～1024。
注意：当 Action 为 regex 时，此字段必填；当 Action 为 follow 或 custom 时，无需填写此字段，若填写则不生效。
Value
String
否
重定向的目标 URL，长度范围为 1～1024。
注意：当 Action 为 regex 或 custom 时，此字段必填；当 Action 为 follow 时，无需填写此字段，若填写则不生效。

VaryParameters

Vary 特性 配置参数。
名称
类型
必选
描述
Switch
String
是
Vary 特性配置开关，取值如下：
on：开启。
off：关闭。

WebSecurity

Web 安全防护配置组，定义站点级默认策略、各域名策略绑定关系及策略模板。
配置字段
类型
必选
描述
ZoneDefaultPolicy
是
站点级默认安全策略配置。该策略作为当前站点的缺省策略，对所有未在 HostPolicy 中显式指定策略类型的域名生效。
HostPolicy
Array of HostPolicy
是
域名策略绑定列表。定义当前站点下各域名所使用的安全策略类型（站点级策略、域名级自定义策略或策略模板）。未在本列表中出现的域名，将自动使用 ZoneDefaultPolicy 中的站点级默认策略。
Templates
Array of Templates
是
策略模板列表。定义当前站点下所有可复用的安全策略模板，模板可被多个域名通过 HostPolicy 中的 TemplateId 引用。

WebSocketParameters

WebSocket 配置。
名称
类型
必选
描述
Switch
String
否
WebSocket 超时时间配置开关，取值如下：

on：使用 Timeout 作为 WebSocket 超时时间；
off：平台仍支持 WebSocket 连接，此时使用系统默认的 15 秒为超时时间。
Timeout
Integer
否
超时时间，单位为秒，最大超时时间 120 秒。
注意：当 Switch 为 on 时，此字段必填，否则此字段不生效。

ZoneConfig

站点加速配置。
名称
类型
必选
描述
SmartRouting
否
智能加速配置。
注意：此字段可能返回 null，表示取不到有效值。
Cache
否
缓存过期时间配置。
注意：此字段可能返回 null，表示取不到有效值。
MaxAge
否
浏览器缓存配置。
注意：此字段可能返回 null，表示取不到有效值。
CacheKey
否
节点缓存键配置。
注意：此字段可能返回 null，表示取不到有效值。
CachePrefresh
否
缓存预刷新配置。
注意：此字段可能返回 null，表示取不到有效值。
OfflineCache
否
离线缓存配置。
注意：此字段可能返回 null，表示取不到有效值。
Compression
否
智能压缩配置。
注意：此字段可能返回 null，表示取不到有效值。
ForceRedirectHTTPS
否
访问协议强制 HTTPS 跳转配置。
注意：此字段可能返回 null，表示取不到有效值。
HSTS
否
HSTS 相关配置。
注意：此字段可能返回 null，表示取不到有效值。
TLSConfig
否
TLS 相关配置。
注意：此字段可能返回 null，表示取不到有效值。
OCSPStapling
否
OCSP 装订配置。
注意：此字段可能返回 null，表示取不到有效值。
HTTP2
否
HTTP2 相关配置。
注意：此字段可能返回 null，表示取不到有效值。
QUIC
否
QUIC 访问配置。
注意：此字段可能返回 null，表示取不到有效值。
UpstreamHTTP2
否
HTTP2 回源配置。
注意：此字段可能返回 null，表示取不到有效值。
IPv6
否
IPv6 访问配置。
注意：此字段可能返回 null，表示取不到有效值。
WebSocket
否
WebSocket 配置。
注意：此字段可能返回 null，表示取不到有效值。
PostMaxSize
否
POST 请求传输配置。
注意：此字段可能返回 null，表示取不到有效值。
ClientIPHeader
否
客户端 IP 回源请求头配置。
注意：此字段可能返回 null，表示取不到有效值。
ClientIPCountry
否
回源时是否携带客户端 IP 所属地域信息的配置。
注意：此字段可能返回 null，表示取不到有效值。
Grpc
否
gRPC 协议支持配置。
注意：此字段可能返回 null，表示取不到有效值。
NetworkErrorLogging
否
网络错误日志记录配置。
注意：此字段可能返回 null，表示取不到有效值。
AccelerateMainland
否
中国大陆加速优化配置。
注意：此字段可能返回 null，表示取不到有效值。
StandardDebug
否
标准 Debug 配置。
注意：此字段可能返回 null，表示取不到有效值。

中国站