边缘安全加速平台 EO 配置组语法说明

本文档是对版本管理中各功能模块配置组结构的详细语法解释。其中 Condition 结构和变量定义的细节可在对应文档章节中进一步查阅，链接如下：
条件表达式的嵌套规则及语法细节：Condition﻿
请求数据的动态提取规则：变量﻿
通用单位规范
所有表示​​时间​​的数值单位必须为​​秒(s)​​，所有表示​​文件大小​​的数值单位必须为​​字节(B)​​，且​​值仅为纯数字​​。
单位类型
配置示例与说明
​​时间（秒）​​
设置30分钟缓存：30 * 60 = 1800
​​大小（字节）​​
设置10MB大小限制：10 * 1024 * 1024 = 10485760
配置组概述
每个站点的版本文件包含以下字段，各字段的说明如下：
配置字段
类型
必选
对应配置组
描述
FormatVersion
String
是
全局配置
语法版本，当前默认为 1.0，输入其他值将会报错。
ZoneConfig
﻿ZoneConfig﻿
否
站点加速配置组
站点级配置，包含「站点加速」中所有配置项，且所有项均为必选，否则配置无效。
Rules
Array of Rules﻿
否
站点加速配置组
规则级配置，包含「规则引擎」中所有规则，且数组可为空，表示不启用任何规则。
WebSecurity
﻿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
﻿AccessURLRedirectQueryString﻿
否
携带查询参数。
注意：此字段可能返回 null，表示取不到有效值。
AccessURLRedirectQueryString
访问 URL 重定向 配置参数。
名称
类型
必选
描述
Action
String
否
执行动作，取值如下：
full：全部保留。
ignore：全部忽略。
AdaptiveFrequencyControl
自适应频控
名称
类型
必选
描述
Enabled
String
是
自适应频控是否开启。取值如下：
on：开启。
off：关闭。
Sensitivity
String
否
自适应频控的限制等级，当 Enabled 为 on 时，此字段必填。取值如下：
Loose：宽松。
Moderate：适中。
Strict：严格。
Action
﻿SecurityAction﻿
否
自适应频控的处置方式，当 Enabled 为 on 时，此字段必填。SecurityAction 的 Name 取值支持：
Monitor：观察。
Deny：拦截。
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：关闭。
Action
﻿SecurityAction﻿
否
流量防盗刷（仅适用中国大陆地区）的处置方式，当 Enabled 为 on 时，此字段必填。SecurityAction 的 Name 取值支持：
Monitor：观察；
Deny：拦截；
Challenge：挑战，其中ChallengeActionParameters.Name仅支持JSChallenge。
BlockIPActionParameters
Web安全IP封禁的附加参数
名称
类型
必选
描述
Duration
String
是
封禁 IP 的惩罚时长。支持的单位如下：
s：秒，取值范围1～120；
m：分，取值范围1～120；
h：小时，取值范围1～48。
BotManagement
Web 安全的 BOT 规则结构。
名称
类型
必选
描述
ClientAttestationRules
﻿ClientAttestationRules﻿
否
客户端认证规则的定义列表。该功能内测中，如需使用，请 提交工单。
CacheConfigCustomTime
节点缓存 TTL 自定义缓存时间配置参数。
名称
类型
必选
描述
Switch
String
否
自定义缓存时间开关，取值有：
on：开启；
off：关闭。
CacheTime
Integer
否
自定义缓存时间数值，单位为秒，取值：0-315360000。
注意：当 Switch 为 on 时，此字段必填；当 Switch 为 off 时，无需填写此字段，若填写则不生效。
CacheConfigParameters
节点缓存 TTL 配置参数。
名称
类型
必选
描述
FollowOrigin
﻿FollowOrigin﻿
否
遵循源站缓存配置。FollowOrigin、NoCache、CustomTime 最多只能配置一个 Switch 为 on。
注意：此字段可能返回 null，表示取不到有效值。
NoCache
﻿NoCache﻿
否
不缓存配置。FollowOrigin、NoCache、CustomTime 最多只能配置一个 Switch 为 on。
注意：此字段可能返回 null，表示取不到有效值。
CustomTime
﻿CacheConfigCustomTime﻿
否
自定义缓存时间配置。FollowOrigin、NoCache、CustomTime 最多只能配置一个 Switch 为 on。
注意：此字段可能返回 null，表示取不到有效值。
CacheKeyConfigParameters
缓存键配置。
名称
类型
必选
描述
FullURLCache
String
否
是否开启全路径缓存，取值如下：
on：开启全路径缓存（即关闭参数忽略）；
off：关闭全路径缓存（即开启参数忽略）。
IgnoreCase
String
否
是否忽略大小写缓存，取值如下：
on：忽略；
off：不忽略。
QueryString
﻿CacheKeyQueryString﻿
否
查询字符串保留配置参数。此字段和 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 和 QueryString 采用组合表达，具体示例可以参考：
查询字符串全部保留。开启忽略大小写。
﻿
{
  "CacheKey": {
    "FullURLCache": "on",
    "QueryString": {
      "Switch": "off"
    },
    "IgnoreCase": "on"
  }
}
查询字符串全部忽略。开启忽略大小写。
﻿
{
  "CacheKey": {
    "FullURLCache": "off",
    "QueryString": {
      "Switch": "off"
    },
    "IgnoreCase": "on"
  }
}
查询字符串保留指定参数。关闭忽略大小写。
﻿
{
  "CacheKey": {
    "FullURLCache": "off",
    "QueryString": {
        "Switch": "on",
        "Action": "includeCustom",
        "Values": ["name1","name2","name3"]
    },
    "IgnoreCase": "off"
  }
}
查询字符串忽略指定参数。关闭忽略大小写。
﻿
{
  "CacheKey": {
    "FullURLCache": "off",
    "QueryString": {
        "Switch": "on",
        "Action": "excludeCustom",
        "Values": ["name1","name2","name3"]
    },
    "IgnoreCase": "off"
  }
}
名称
类型
必选
描述
FullURLCache
String
否
查询字符串全部保留开关，取值如下：
on：开启。
off：关闭。
注意：FullURLCache、IgnoreCase、Header、Scheme、Cookie 至少设置一个配置。此字段和 QueryString.Switch 必须同时设置，但不能同为 on。
QueryString
﻿CacheKeyQueryString﻿
否
查询字符串保留配置参数。此字段和 FullURLCache 必须同时设置，但不能同为 on。
注意：此字段可能返回 null，表示取不到有效值。
IgnoreCase
String
否
忽略大小写开关，取值如下：
on：开启。
off：关闭。
注意：FullURLCache、IgnoreCase、Header、Scheme、Cookie 至少设置一个配置。
Header
﻿CacheKeyHeader﻿
否
HTTP 请求头配置参数。FullURLCache、IgnoreCase、Header、Scheme、Cookie 至少设置一个配置。
注意：此字段可能返回 null，表示取不到有效值。
Scheme
String
否
请求协议开关，取值如下：
on：开启。
off：关闭。
注意：FullURLCache、IgnoreCase、Header、Scheme、Cookie 至少设置一个配置。
Cookie
﻿CacheKeyCookie﻿
否
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﻿
否
缓存遵循源站。不填表示不设置该配置，FollowOrigin、NoCache、CustomTime 最多只能配置一个 Switch 为 on。
注意：此字段可能返回 null，表示取不到有效值。
NoCache
﻿NoCache﻿
否
不缓存。不填表示不设置该配置，FollowOrigin、NoCache、CustomTime 最多只能配置一个 Switch 为 on。
注意：此字段可能返回 null，表示取不到有效值。
CustomTime
﻿CustomTime﻿
否
自定义缓存时间。不填表示不设置该配置，FollowOrigin、NoCache、CustomTime 最多只能配置一个 Switch 为 on。
注意：此字段可能返回 null，表示取不到有效值。
CachePrefreshParameters
缓存预刷新 配置参数。
名称
类型
必选
描述
Switch
String
否
缓存预刷新开关，取值如下：
on：开启。
off：关闭。
CacheTimePercent
Integer
否
预刷新时间设置为节点缓存时间的百分比数值，取值：1～99。
注意：当 Switch 为 on 时，此字段必填；当 Switch 为 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﻿
否
客户端认证未通过的处置方式。SecurityAction 的 Name 取值支持：
Deny：拦截；
Monitor：观察；
Redirect：重定向；
Challenge：挑战。
默认值为 Monitor。
ClientAttestationRules
客户端认证的配置。
名称
类型
必选
描述
Rules
Array of ClientAttestationRule﻿
否
客户端认证的列表。使用 ModifySecurityPolicy 修改 Web 防护配置时：
若未指定 SecurityPolicy.BotManagement.ClientAttestationRules 中的 Rules 参数，或 Rules 参数长度为零：清空所有客户端认证规则配置。
若 SecurityPolicy.BotManagement 参数中，未指定 ClientAttestationRules 参数值：保持已有客户端认证规则配置，不做修改。
ClientFiltering
智能客户端过滤
名称
类型
必选
描述
Enabled
String
是
智能客户端过滤是否开启。取值如下：
on：开启。
off：关闭。
Action
﻿SecurityAction﻿
否
智能客户端过滤的处置方式，当 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﻿
是
自定义规则的执行动作。 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：专家定制规则，仅出参。
默认为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 时，无需填写此字段，若填写则不生效。
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
HighRiskMinScore
Integer
否
判定请求为高风险的最低值，取值范围为 1～99。数值越大请求风险越高越接近 Bot 客户端发起的请求。默认值为 50，对应含义 51～100 为高风险。
HighRiskRequestAction
﻿SecurityAction﻿
否
高风险请求的处置方式。SecurityAction 的 Name 取值支持：
Deny：拦截；
Monitor：观察；
Redirect：重定向；
Challenge：挑战。
默认值为 Monitor。
MediumRiskMinScore
Integer
否
判定请求为中风险的最低值，取值范围为 1～99。数值越大请求风险越高越接近 Bot 客户端发起的请求。默认值为 15，对应含义 16～50 为中风险。
MediumRiskRequestAction
﻿SecurityAction﻿
否
中风险请求的处置方式。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
Array of 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：关闭，高频扫描防护规则不生效。
Action
﻿SecurityAction﻿
否
高频扫描防护的处置动作。 当 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
以下为对站点安全配置组中HostPolicy 对象的字段说明。
配置字段
类型
必选
描述
Host
String
是
站点级策略，针对站点下所有域名生效的策略，详情见 站点级策略。
PolicyType
String
是
当前域名使用的策略类型：
ZoneDefault：使用站点级策略，即 ZoneDefaultPolicy 中定义的策略配置。
Custom：使用域名级策略。使用该选项时，必须同时配置 Policy 字段，指定详细策略配置。
Template：使用策略模板。使用该选项时，必须同时配置 TemplateId 字段，指定当前域名使用的策略模板。
Policy
Object
否
当 PolicyType 为 Custom 时，该字段为当前域名的详细策略配置，对当前域名生效。
详情见 SecurityPolicy。
TemplateId
String
否
当 PolicyType 为 Template 时，该字段用于指定当前域名所使用的策略模板的 Id。如需跨站点绑定策略模板，需要在策略模板 Id 后额外通过 “@” 标识符指定策略模板所在的站点 Id。
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
﻿AdaptiveFrequencyControl﻿
否
自适应频控的具体配置。
ClientFiltering
﻿ClientFiltering﻿
否
智能客户端过滤的具体配置。
BandwidthAbuseDefense
﻿BandwidthAbuseDefense﻿
否
流量防盗刷的具体配置。
SlowAttackDefense
﻿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。
IPv6Parameters
IPv6 访问配置。
名称
类型
必选
描述
Switch
String
否
IPv6 访问功能配置，取值如下：
on：开启 IPv6 访问功能；
off：关闭 IPv6 访问功能。
ManagedRuleAction
托管规则的项配置
名称
类型
必选
描述
RuleId
String
是
托管规则组下的具体项，用于改写此单条规则项配置的内容，具体参考产品文档。
Action
﻿SecurityAction﻿
是
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﻿
是
托管规则组的处置动作。SecurityAction 的 Name 取值支持：
Deny：拦截，响应拦截页面；
Monitor：观察，不处理请求记录安全事件到日志中；
Disabled：未启用，不扫描请求跳过该规则。
RuleActions
Array of ManagedRuleAction﻿
否
托管规则组下规则项的具体配置，仅在 SensitivityLevel 为 custom 时配置生效。
MetaData
﻿ManagedRuleGroupMeta﻿
否
托管规则组信息，仅出参SecurityAction
ManagedRuleGroupMeta
托管规则组信息
名称
类型
必选
描述
GroupDetail
String
否
托管规则组描述，仅出参。
GroupName
String
否
托管规则组名称，仅出参。
RuleDetails
Array of ManagedRuleDetail﻿
否
当前托管规则组下的所有子规则信息，仅出参。
ManagedRules
名称
类型
必选
描述
Enabled
String
是
托管规则是否开启。取值如下：
on：开启，所有托管规则按配置生效；
off：关闭，所有托管规则不生效。
DetectionOnly
String
是
评估模式是否开启，仅在 Enabled 参数为 on 时有效。取值如下：
on：开启，表示所有托管规则以观察模式生效；
off：关闭，表示所有托管规则以实际配置生效。
SemanticAnalysis
String
否
托管规则语义分析选项是否开启，仅在 Enabled 参数为 on 时有效。取值如下：
on：开启，对请求进行语义分析后进行处理；
off：关闭，对请求不进行语义分析，直接进行处理。
﻿
默认为 off。
AutoUpdate
﻿ManagedRuleAutoUpdate﻿
否
托管规则自动更新选项。
ManagedRuleGroups
Array of ManagedRuleGroup﻿
否
托管规则组的配置。如果此结构传空数组或 GroupId 未包含在列表内将按照默认方式处理。
FrequentScanningProtection
﻿FrequentScanningProtection﻿
否
高频扫描防护配置选项，当某一访客的请求频繁命中「配置为拦截」的托管规则时，在一段时间内封禁该访客所有请求。
MaxAgeParameters
浏览器缓存 TTL 配置参数。
名称
类型
必选
描述
FollowOrigin
String
否
遵循源站 Cache-Control 开关，取值如下：
on：遵循源站，忽略 CacheTime 时间设置。
off：不遵循源站，使用 CacheTime 时间设置。
CacheTime
Integer
否
自定义缓存时间数值，单位为秒，取值：0～315360000。
注意：当 FollowOrigin 为 off 时，表示不遵循源站，使用 CacheTime 设置缓存时间，否则此字段不生效。
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；
当 OriginType = LoadBalance 时，该参数请填写负载均衡实例 ID，该功能当前仅白名单开放。
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
﻿OriginPrivateParameters﻿
否
私有鉴权使用参数，该参数仅当 OriginType = AWSS3 且 PrivateAccess = on 时会生效。
注意：此字段可能返回 null，表示取不到有效值。
ModifyRequestHeaderParameters
修改 HTTP 回源请求头配置参数。
名称
类型
必选
描述
HeaderActions
Array of HeaderAction﻿
否
HTTP 头部设置规则列表。
注意：此字段可能返回 null，表示取不到有效值。
ModifyResponseHeaderParameters
修改 HTTP 节点响应头配置参数。
名称
类型
必选
描述
HeaderActions
Array of HeaderAction﻿
否
HTTP 回源头部规则列表。
注意：此字段可能返回 null，表示取不到有效值。
NoCache
不缓存配置
名称
类型
必选
描述
Switch
String
是
不缓存配置开关，取值如下：
on：开启。
off：关闭。
OCSPStaplingParameters
OCSP 装订配置参数。
名称
类型
必选
描述
Switch
String
否
OCSP 装订配置开关，取值如下：
on：开启；
off：关闭。
OfflineCacheParameters
离线缓存是否开启。
名称
类型
必选
描述
Switch
String
否
离线缓存开关，取值如下：
on：开启；
off：关闭。
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
否
精准速率限制的具体内容，需符合表达式语法，详细规范参见产品文档。
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。
Action
﻿SecurityAction﻿
否
精准速率限制的处置方式。取值有：
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：回源请求参数；
TLSConfig：SSL/TLS 安全；
ModifyOrigin：修改源站；
HTTPUpstreamTimeout：七层回源超时配置；
HttpResponse：HTTP 应答；
ErrorPage：自定义错误页面；
ModifyResponseHeader：修改 HTTP 节点响应头；
ModifyRequestHeader：修改 HTTP 节点请求头；
ResponseSpeedLimit：单连接下载限速；
SetContentIdentifier：设置内容标识符；
Vary：Vary 特性配置。
CacheParameters
﻿CacheParameters﻿
否
节点缓存 TTL 配置参数，当 Name 取值为 Cache 时，该参数必填。
注意：此字段可能返回 null，表示取不到有效值。
CacheKeyParameters
﻿CacheKeyParameters﻿
否
自定义 Cache Key 配置参数，当 Name 取值为 CacheKey 时，该参数必填。
注意：此字段可能返回 null，表示取不到有效值。
CachePrefreshParameters
﻿CachePrefreshParameters﻿
否
缓存预刷新配置参数，当 Name 取值为 CachePrefresh 时，该参数必填。
注意：此字段可能返回 null，表示取不到有效值。
AccessURLRedirectParameters
﻿AccessURLRedirectParameters﻿
否
访问 URL 重定向配置参数，当 Name 取值为 AccessURLRedirect 时，该参数必填。
注意：此字段可能返回 null，表示取不到有效值。
UpstreamURLRewriteParameters
﻿UpstreamURLRewriteParameters﻿
否
回源 URL 重写配置参数，当 Name 取值为 UpstreamURLRewrite 时，该参数必填。
注意：此字段可能返回 null，表示取不到有效值。
QUICParameters
﻿QUICParameters﻿
否
QUIC 配置参数，当 Name 取值为 QUIC 时，该参数必填。
注意：此字段可能返回 null，表示取不到有效值。
WebSocketParameters
﻿WebSocketParameters﻿
否
WebSocket 配置参数，当 Name 取值为 WebSocket 时，该参数必填。
注意：此字段可能返回 null，表示取不到有效值。
AuthenticationParameters
﻿AuthenticationParameters﻿
否
Token 鉴权配置参数，当 Name 取值为 Authentication 时，该参数必填。
注意：此字段可能返回 null，表示取不到有效值。
MaxAgeParameters
﻿MaxAgeParameters﻿
否
浏览器缓存 TTL 配置参数，当 Name 取值为 MaxAge 时，该参数必填。
注意：此字段可能返回 null，表示取不到有效值。
StatusCodeCacheParameters
﻿StatusCodeCacheParameters﻿
否
状态码缓存 TTL 配置参数，当 Name 取值为 StatusCodeCache 时，该参数必填。
注意：此字段可能返回 null，表示取不到有效值。
OfflineCacheParameters
﻿OfflineCacheParameters﻿
否
离线缓存配置参数，当 Name 取值为 OfflineCache 时，该参数必填。
注意：此字段可能返回 null，表示取不到有效值。
SmartRoutingParameters
﻿SmartRoutingParameters﻿
否
智能加速配置参数，当 Name 取值为 SmartRouting 时，该参数必填。
注意：此字段可能返回 null，表示取不到有效值。
RangeOriginPullParameters
﻿RangeOriginPullParameters﻿
否
分片回源配置参数，当 Name 取值为 RangeOriginPull 时，该参数必填。
注意：此字段可能返回 null，表示取不到有效值。
UpstreamHTTP2Parameters
﻿UpstreamHTTP2Parameters﻿
否
HTTP2 回源配置参数，当 Name 取值为 UpstreamHTTP2 时，该参数必填。
注意：此字段可能返回 null，表示取不到有效值。
HostHeaderParameters
﻿HostHeaderParameters﻿
否
Host Header 重写配置参数，当 Name 取值为 HostHeader 时，该参数必填。
注意：此字段可能返回 null，表示取不到有效值。
ForceRedirectHTTPSParameters
﻿ForceRedirectHTTPSParameters﻿
否
访问协议强制 HTTPS 跳转配置，当 Name 取值为 ForceRedirectHTTPS 时，该参数必填。
注意：此字段可能返回 null，表示取不到有效值。
OriginPullProtocolParameters
﻿OriginPullProtocolParameters﻿
否
回源 HTTPS 配置参数，当 Name 取值为 OriginPullProtocol 时，该参数必填。
注意：此字段可能返回 null，表示取不到有效值。
CompressionParameters
﻿CompressionParameters﻿
否
智能压缩配置，当 Name 取值为 Compression 时，该参数必填。
注意：此字段可能返回 null，表示取不到有效值。
HSTSParameters
﻿HSTSParameters﻿
否
HSTS 配置参数，当 Name 取值为 HSTS 时，该参数必填。
注意：此字段可能返回 null，表示取不到有效值。
ClientIPHeaderParameters
﻿ClientIPHeaderParameters﻿
否
存储客户端请求 IP 的头部信息配置，当 Name 取值为 ClientIPHeader 时，该参数必填。
注意：此字段可能返回 null，表示取不到有效值。
OCSPStaplingParameters
﻿OCSPStaplingParameters﻿
否
OCSP 装订配置参数，当 Name 取值为 OCSPStapling 时，该参数必填。
注意：此字段可能返回 null，表示取不到有效值。
HTTP2Parameters
﻿HTTP2Parameters﻿
否
HTTP2 接入配置参数，当 Name 取值为 HTTP2 时，该参数必填。
注意：此字段可能返回 null，表示取不到有效值。
PostMaxSizeParameters
﻿PostMaxSizeParameters﻿
否
POST 请求上传文件流式传输最大限制配置，当 Name 取值为 PostMaxSize 时，该参数必填。
注意：此字段可能返回 null，表示取不到有效值。
ClientIPCountryParameters
﻿ClientIPCountryParameters﻿
否
回源时携带客户端 IP 所属地域信息配置参数，当 Name 取值为 ClientIPCountry 时，该参数必填。
注意：此字段可能返回 null，表示取不到有效值。
UpstreamFollowRedirectParameters
﻿UpstreamFollowRedirectParameters﻿
否
回源跟随重定向参数配置，当 Name 取值为 UpstreamFollowRedirect 时，该参数必填。
注意：此字段可能返回 null，表示取不到有效值。
UpstreamRequestParameters
﻿UpstreamRequestParameters﻿
否
回源请求参数配置参数，当 Name 取值为 UpstreamRequest 时，该参数必填。
注意：此字段可能返回 null，表示取不到有效值。
TLSConfigParameters
﻿TLSConfigParameters﻿
否
SSL/TLS 安全配置参数，当 Name 取值为 TLSConfig 时，该参数必填。
注意：此字段可能返回 null，表示取不到有效值。
ModifyOriginParameters
﻿ModifyOriginParameters﻿
否
修改源站配置参数，当 Name 取值为 ModifyOrigin 时，该参数必填。
注意：此字段可能返回 null，表示取不到有效值。
HTTPUpstreamTimeoutParameters
﻿HTTPUpstreamTimeoutParameters﻿
否
七层回源超时配置，当 Name 取值为 HTTPUpstreamTimeout 时，该参数必填。
注意：此字段可能返回 null，表示取不到有效值。
HttpResponseParameters
﻿HTTPResponseParameters﻿
否
HTTP 应答配置参数，当 Name 取值为 HttpResponse 时，该参数必填。
注意：此字段可能返回 null，表示取不到有效值。
ErrorPageParameters
﻿ErrorPageParameters﻿
否
自定义错误页面配置参数，当 Name 取值为 ErrorPage 时，该参数必填。
注意：此字段可能返回 null，表示取不到有效值。
ModifyResponseHeaderParameters
﻿ModifyResponseHeaderParameters﻿
否
修改 HTTP 节点响应头配置参数，当 Name 取值为 ModifyResponseHeader 时，该参数必填。
注意：此字段可能返回 null，表示取不到有效值。
ModifyRequestHeaderParameters
﻿ModifyRequestHeaderParameters﻿
否
修改 HTTP 节点请求头配置参数，当 Name 取值为 ModifyRequestHeader 时，该参数必填。
注意：此字段可能返回 null，表示取不到有效值。
ResponseSpeedLimitParameters
﻿ResponseSpeedLimitParameters﻿
否
单连接下载限速配置参数，当 Name 取值为 ResponseSpeedLimit 时，该参数必填。
注意：此字段可能返回 null，表示取不到有效值。
SetContentIdentifierParameters
﻿SetContentIdentifierParameters﻿
否
内容标识配置参数，当 Name 取值为 SetContentIdentifier 时，该参数必填。
注意：此字段可能返回 null，表示取不到有效值。
VaryParameters
﻿VaryParameters﻿
否
Vary 特性配置参数，当 Name 取值为 Vary 时，该参数必填。
ContentCompressionParameters
﻿ContentCompressionParameters﻿
否
内容压缩配置参数，当 Name 取值为 ContentCompression 时，该参数必填。该参数为白名单功能，如有需要，请联系腾讯云工程师处理。
RuleEngineSubRule
子规则。
名称
类型
必选
描述
Branches
Array of RuleBranch﻿
否
子规则分支
注意：此字段可能返回 null，表示取不到有效值。
Description
Array of String
否
规则注释。
Rules
规则按从上往下的顺序匹配执行，​​匹配到一个最小单元则停止匹配，下方的规则可覆盖上方规则中对相同配置项的设置​​。规则引擎配置在导入后默认为开启状态。
RuleName
String
否
规则名称。名称长度限制不超过 255 个字符。
Description
Array of String
否
规则注释。可以填写多个注释。
Branches
Array of RuleBranch﻿
否
子规则分支。此列表当前只支持填写一项规则，多填无效。
注意：此字段可能返回 null，表示取不到有效值。
SecurityAction
安全的执行动作。
名称
类型
必选
描述
Name
String
是
安全执行的具体动作。取值有：
﻿
Deny：拦截，阻止请求访问站点资源；
Monitor：观察，仅记录日志；
Redirect：重定向至 URL；
Disabled：未启用，不启用指定规则；
Allow：允许访问，但延迟处理请求；
Challenge：挑战，响应挑战内容；
BlockIP：待废弃，IP 封禁；
ReturnCustomPage：待废弃，使用指定页面拦截；
JSChallenge：待废弃，JavaScript 挑战；
ManagedChallenge：待废弃，托管挑战。
DenyActionParameters
﻿DenyActionParameters﻿
否
当 Name 为 Deny 时的附加参数。
RedirectActionParameters
﻿RedirectActionParameters﻿
否
当 Name 为 Redirect 时的附加参数。
AllowActionParameters
﻿AllowActionParameters﻿
否
当 Name 为 Allow 时的附加参数。
ChallengeActionParameters
﻿ChallengeActionParameters﻿
否
当 Name 为 Challenge 时的附加参数。
BlockIPActionParameters
﻿BlockIPActionParameters﻿
否
待废弃，当 Name 为 BlockIP 时的附加参数。
ReturnCustomPageActionParameters
﻿ReturnCustomPageActionParameters﻿
否
待废弃，当 Name 为 ReturnCustomPage 时的附加参数。
SecurityPolicy
安全策略配置
名称
类型
必选
描述
CustomRules
﻿CustomRules﻿
否
自定义规则配置。
ManagedRules
﻿ManagedRules﻿
否
托管规则配置。
HttpDDoSProtection
﻿HttpDDoSProtection﻿
否
HTTP DDoS 防护配置。
RateLimitingRules
﻿RateLimitingRules﻿
否
速率限制规则配置。
ExceptionRules
﻿ExceptionRules﻿
否
例外规则配置。
BotManagement
﻿BotManagement﻿
否
Bot 管理配置。
SetContentIdentifierParameters
内容标识配置参数。
名称
类型
必选
描述
ContentIdentifier
String
否
内容标识id
SlowAttackDefense
慢速攻击防护的具体配置。
名称
类型
必选
描述
Enabled
String
是
慢速攻击防护是否开启。取值有：
on：开启；
off：关闭。
Action
﻿SecurityAction﻿
否
慢速攻击防护的处置方式，当 Enabled 为 on 时，此字段必填。SecurityAction 的 Name 取值支持：
Monitor：观察；
Deny：拦截；
MinimalRequestBodyTransferRate
﻿MinimalRequestBodyTransferRate﻿
否
正文传输最小速率阈值的具体配置，当 Enabled 为 on 时，此字段必填。
RequestBodyTransferTimeout
﻿RequestBodyTransferTimeout﻿
否
正文传输超时时长的具体配置，当 Enabled 为 on 时，此字段必填。
SmartRoutingParameters
智能加速配置。
名称
类型
必选
描述
Switch
String
否
智能加速配置开关，取值有：
﻿
on：开启；
off：关闭。
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
﻿Timestamp ISO8601﻿
否
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
Array of StatusCodeCacheParam﻿
否
状态码缓存 TTL 。
注意：此字段可能返回 null，表示取不到有效值。
Templates
以下为对站点安全配置组中Templates对象的字段说明。
配置字段
类型
必选
描述
Id
String
是
策略模板的 ID
Policy
Object
是
策略模板的策略配置，配置对所有关联了该策略模板的域名生效。详情见SecurityPolicy
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
﻿UpstreamRequestQueryString﻿
否
查询字符串配置。可选配置项，不填表示不配置。
注意：此字段可能返回 null，表示取不到有效值。
Cookie
﻿UpstreamRequestCookie﻿
否
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
以下为对站点安全配置组中WebSecurity 对象的字段说明。
配置字段
类型
必选
描述
ZoneDefaultPolicy
Object
是
站点级策略的配置详情。详情参见 SecurityPolicy。
HostPolicy
Array of HostPolicy﻿
是
当前站点下每个域名使用的策略，包括使用策略模板、站点级策略、域名级策略 的域名。详情参见 域名级策略 HostPolicy。
未在列表中出现的域名，将默认使用站点级策略（ZoneDefaultPolicy）。
Templates
Array of RuleBranch﻿
是
当前站点下所有策略模板的详细配置。详情参见 Templates。
WebSocketParameters
WebSocket 配置。
名称
类型
必选
描述
Switch
String
否
WebSocket 超时时间配置开关，取值如下：
﻿
on：使用 Timeout 作为 WebSocket 超时时间；
off：平台仍支持 WebSocket 连接，此时使用系统默认的 15 秒为超时时间。
Timeout
Integer
否
超时时间，单位为秒，最大超时时间 120 秒。
注意：当 Switch 为 on 时，此字段必填，否则此字段不生效。
ZoneConfig
站点加速配置。
名称
类型
必选
描述
SmartRouting
﻿SmartRoutingParameters﻿
否
智能加速配置。
注意：此字段可能返回 null，表示取不到有效值。
Cache
﻿CacheConfigParameters﻿
否
缓存过期时间配置。
注意：此字段可能返回 null，表示取不到有效值。
MaxAge
﻿MaxAgeParameters﻿
否
浏览器缓存配置。
注意：此字段可能返回 null，表示取不到有效值。
CacheKey
﻿CacheKeyConfigParameters﻿
否
节点缓存键配置。
注意：此字段可能返回 null，表示取不到有效值。
CachePrefresh
﻿CachePrefreshParameters﻿
否
缓存预刷新配置。
注意：此字段可能返回 null，表示取不到有效值。
OfflineCache
﻿OfflineCacheParameters﻿
否
离线缓存配置。
注意：此字段可能返回 null，表示取不到有效值。
Compression
﻿CompressionParameters﻿
否
智能压缩配置。
注意：此字段可能返回 null，表示取不到有效值。
ForceRedirectHTTPS
﻿ForceRedirectHTTPSParameters﻿
否
访问协议强制 HTTPS 跳转配置。
注意：此字段可能返回 null，表示取不到有效值。
HSTS
﻿HSTSParameters﻿
否
HSTS 相关配置。
注意：此字段可能返回 null，表示取不到有效值。
TLSConfig
﻿TLSConfigParameters﻿
否
TLS 相关配置。
注意：此字段可能返回 null，表示取不到有效值。
OCSPStapling
﻿OCSPStaplingParameters﻿
否
OCSP 装订配置。
注意：此字段可能返回 null，表示取不到有效值。
HTTP2
﻿HTTP2Parameters﻿
否
HTTP2 相关配置。
注意：此字段可能返回 null，表示取不到有效值。
QUIC
﻿QUICParameters﻿
否
QUIC 访问配置。
注意：此字段可能返回 null，表示取不到有效值。
UpstreamHTTP2
﻿UpstreamHTTP2Parameters﻿
否
HTTP2 回源配置。
注意：此字段可能返回 null，表示取不到有效值。
IPv6
﻿IPv6Parameters﻿
否
IPv6 访问配置。
注意：此字段可能返回 null，表示取不到有效值。
WebSocket
﻿WebSocketParameters﻿
否
WebSocket 配置。
注意：此字段可能返回 null，表示取不到有效值。
PostMaxSize
﻿PostMaxSizeParameters﻿
否
POST 请求传输配置。
注意：此字段可能返回 null，表示取不到有效值。
ClientIPHeader
﻿ClientIPHeaderParameters﻿
否
客户端 IP 回源请求头配置。
注意：此字段可能返回 null，表示取不到有效值。
ClientIPCountry
﻿ClientIPCountryParameters﻿
否
回源时是否携带客户端 IP 所属地域信息的配置。
注意：此字段可能返回 null，表示取不到有效值。
Grpc
﻿GrpcParameters﻿
否
gRPC 协议支持配置。
注意：此字段可能返回 null，表示取不到有效值。
AccelerateMainland
﻿AccelerateMainlandParameters﻿
否
中国大陆加速优化配置。
注意：此字段可能返回 null，表示取不到有效值。
StandardDebug
﻿StandardDebugParameters﻿
否
标准 Debug 配置。
注意：此字段可能返回 null，表示取不到有效值。
﻿
单位类型	配置示例与说明
时间（秒）	设置30分钟缓存：30 * 60 = 1800
大小（字节）	设置10MB大小限制：10 * 1024 * 1024 = 10485760
配置字段	类型	必选	对应配置组	描述
FormatVersion	String	是	全局配置	语法版本，当前默认为 1.0，输入其他值将会报错。
ZoneConfig	ZoneConfig	否	站点加速配置组	站点级配置，包含「站点加速」中所有配置项，且所有项均为必选，否则配置无效。
Rules	Array of Rules	否	站点加速配置组	规则级配置，包含「规则引擎」中所有规则，且数组可为空，表示不启用任何规则。
WebSecurity	WebSecurity	否	Web 防护配置组	Web 安全防护配置，对应控制台中「安全防护 - Web 防护」里支持的功能。详见 WebSecurity。
名称	类型	必选	描述
Switch	String	否	中国大陆加速优化配置开关，取值如下： on：开启。 off：关闭。
RuleName	String	否	规则名称。名称长度限制不超过 255 个字符。
Description	Array of String	否	规则注释。可以填写多个注释。
Branches	Array of RuleBranch	否	子规则分支。此列表当前只支持填写一项规则，多填无效。注意：此字段可能返回 null，表示取不到有效值。
配置组语法说明

本页目录：

通用单位规范

配置组概述

数据结构

AccelerateMainlandParameters

AccessURLRedirectParameters

AccessURLRedirectQueryString

AdaptiveFrequencyControl

AllowActionParameters

AuthenticationParameters

BandwidthAbuseDefense

BlockIPActionParameters

BotManagement

CacheConfigCustomTime

CacheConfigParameters

CacheKeyConfigParameters

CacheKeyCookie

CacheKeyHeader

CacheKeyParameters

CacheKeyQueryString

CacheParameters

CachePrefreshParameters

ChallengeActionParameters

ClientAttestationRule

ClientAttestationRules

ClientFiltering

ClientIPCountryParameters

ClientIPHeaderParameters

CompressionParameters

ContentCompressionParameters

CustomRule

CustomRules

CustomTime

DenyActionParameters

DeviceProfile

ErrorPage

ErrorPageParameters

ExceptionRule

ExceptionRules

FollowOrigin

ForceRedirectHTTPSParameters

FrequentScanningProtection

GrpcParameters

HeaderAction

HostHeaderParameters

HostName

HostPolicy

HSTSParameters

HTTP2Parameters

HttpDDoSProtection

HTTPResponseParameters

HTTPUpstreamTimeoutParameters

IPv6Parameters

ManagedRuleAction

ManagedRuleAutoUpdate

ManagedRuleDetail

ManagedRuleGroup

ManagedRuleGroupMeta

ManagedRules

MaxAgeParameters

MinimalRequestBodyTransferRate

ModifyOriginParameters

ModifyRequestHeaderParameters

ModifyResponseHeaderParameters

NoCache

OCSPStaplingParameters

OfflineCacheParameters

OriginPrivateParameters

OriginPullProtocolParameters

PostMaxSizeParameters

QUICParameters

RangeOriginPullParameters

RateLimitingRule

RateLimitingRules

RedirectActionParameters

RequestBodyTransferTimeout

RequestFieldsForException

ResponseSpeedLimitParameters

ReturnCustomPageActionParameters
