规则 rule

请求规则元素。 中的一个或多个规则是可选的 <ruleset> 元素。

属性 section-d4a3b0496c0c4aa5bd7da87203b9379b

OnMatch = "break" | "continue" | "error": 可选. 默认值为“break”。

Replace = "first" | "all": 可选. 默认值为“first”。

RequestType = "types":可选。 指定规则应用于的输入上下文。 types 是以逗号分隔的列表,其中可能包含下表中列出的一个或多个令牌。 如果 RequestType 未指定,则规则适用于在所有支持的上下文中收到的请求。

令牌
上下文
说明
/is/image/
应用于图像服务请求
ir
/ir/render/
应用于图像渲染请求
静态
/is/content/
应用于静态内容请求

Name = "text": 可选. 用于识别 <rule> 调试日志和错误消息中的元素。

*属性* ="value":可选。 <rule> 元素可以任意组合定义以下任何属性。 如果指定并且规则匹配成功,则它们将覆盖此请求对应的目录属性。 默认值为 RequestType="is".

属性
对应的图像目录属性
默认图像模式
attribute::DefaultImageMode
错误图像
attribute::ErrorImage
过期时间
attribute::Expiration
MaxPix
attribute::MaxPix
RequestLock
attribute::RequestLock
请求模糊处理
attribute::RequestObfuscation
RootUrl
attribute::RootUrl
保存路径
属性::SavePath
水印
attribute::Watermark

有关详细信息,请参阅相应图像目录属性的描述。

过期属性仅覆盖默认属性值。 如果特定的 catalog::Expiration 值适用于请求。

数据 section-8fce013a4c724da58af3fee4e7a90e72

<expression>
可选
<substitution>
可选
<addressfilter>
可选
<header>
可选

说明 section-0c5fbc363070419d8c9800b0c02dc9f9

如果两者 <expression><substitution> 指定而不使用捕获的子字符串,则将第一个匹配的子字符串替换为 <substitution>.

如果 <expression> 未指定,任何路径都匹配和 <substitution> 会附加到路径的末尾。

如果 <substitution> 未指定,不会发生路径或查询转换,但会覆盖任何指定的目录属性。 如果 <substitution> 为空,则会删除匹配的子字符串。

<addressfilter> 仅在发生匹配时以及应用查询规则之前应用。

recommendation-more-help
a26166cd-f2f4-45ce-996d-96a0f0d6cf49