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.

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

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

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.