rule

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

Attributes

OnMatch="break"|"continue"|"error" Optional. Default is “break”.

Name=" *text*" Optional. Used to identify the <rule> element in debug logs and error messages.

In addition, <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.

<rule> attribute

Corresponding Image Catalog attribute

DefaultPix

attribute::DefautPix

ErrorImage

attribute::ErrorImage

Expiration

attribute::Expiration

MaxPix

attribute::MaxPix

RootUrl

attribute::RootUrl

Refer to the description of the corresponding image catalog attribute for details.

The Expiration attribute only overrides the default attribute value; it is ignored if a specific catalog::Expiration value applies to the request.

Data

<expression>

Optional.

<substitution>

Optional.

<addressfilter>

Optional.

Notes

If both <expression> and <substitution> are specified, and captured substrings are not used, the first matched sub-string is replaced with <substitution>.

If <expression> is not specified, any path will match and <substitution> is appended to the end of the path.

If <substitution> is not specified, the matched substring is removed.

The <addressfilter> is applied only when a match occurs, and before query rules are applied.

On this page