Show Menu
TOPICS×

rule

Request rule element. One or more rules are optional in the <ruleset> element.

Attributes

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 will 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.

Data

<expression>
Optional
<substitution>
Optional
<addressfilter>
Optional
<header>
Optional

Notes

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.