Request rule element. One or more rules are optional in the <ruleset>
element.
OnMatch = "break" | "continue" | "error"
: Optional. Default is “break”.
Replace = "first" | "all"
: Optional. Default is “first”.
RequestType
= “types
”: Optional. Specifies which input context the rule applies to. types
is a comma-separated list, which may include one or more of the tokens listed in the following table. If RequestType
is not specified, the rule applies to requests received on all supported contexts.
token |
Context |
Description |
---|---|---|
is |
/is/image/ |
Applied to Image Serving requests |
ir |
/ir/render/ |
Applied to Image Rendering requests |
static |
/is/content/ |
Applied to static content requests |
Name = "text"
: Optional. Used to identify the <rule>
element in debug logs and error messages.
*
Attribute* ="value"
: Optional. <rule>
elements may define any of the following attributes in any combination. If specified, and the rule is successfully matched, they override the corresponding catalog attributes for this request. Default is RequestType="is"
.
Attribute | Corresponding image catalog attribute |
---|---|
DefaultImageMode |
|
ErrorImage |
|
Expiration |
|
MaxPix |
|
RequestLock |
|
RequestObfuscation |
|
RootUrl |
|
SavePath |
|
WaterMark |
Refer to the description of the corresponding image catalog attribute for details.
The Expiration attributes only override the default attribute values. The override is ignored if a specific catalog::Expiration
value applies to the request.
<expression> |
Optional |
<substitution> |
Optional |
<addressfilter> |
Optional |
<header> |
Optional |
If both <expression>
and <substitution>
are specified, and captured substrings are not used, the first matched substring is replaced with <substitution>
.
If <expression>
is not specified, any path matches and <substitution>
is appended to the end of the path.
If <substitution>
is not specified, no path or query transformation occurs, but any specified catalog attributes are overridden. If <substitution>
is empty, the matched substring is removed.
The <addressfilter>
is applied only when a match occurs, and before query rules are applied.