Chapter 3: Condition Reference
125
server_url=Tests if a portion of the URL used in server connections matches the specified criteria. The basic
server_url= test attempts to match the complete possibly-rewritten request URL against a specified
pattern. The pattern may include the scheme, host, port, path and query components of the URL. If
any of these is not included in the pattern, then the corresponding component of the URL is not tested
and can have any value.
Specific portions of the URL can be tested by applying URL component modifiers to the trigger. In
addition to component modifiers, optional test type modifiers can be used to change the way the
pattern is matched.
Note: This set of tests match against the requested URL, taking into account the effect of any
rewrite( ) actions. Because any rewrites of the URL intended for servers or other upstream
devices must be respected by <Forward> layer policy, the url= triggers are not allowed in
<Forward> layers. Instead, the equivalent set of server_url= tests are provided for use in the
<Forward> layer. Those tests always take into account the effect of any rewrite( ) actions on
the URL.
Syntax
server_url[.case_sensitive][.no_lookup]=prefix_pattern
server_url.domain[.case_sensitive][.no_lookup]=domain_suffix_pattern
server_url.regex[.case_sensitive]=regular_expression
server_url.address=ip_address|subnet|subnet_label
server_url.extension[.case_sensitive]=[.]filename_extension
server_url.host[.exact][.no_lookup]=host
server_url.host.[prefix|substring|suffix][.no_lookup]=string
server_url.host.regex[.no_lookup]=regular_expression
server_url.host.is_numeric=yes|no
server_url.host.no_name=yes|no
server_url.path[.case_sensitive]=/string
server_url.path[.substring|.suffix][.case_sensitive]=string
server_url.path.regex[.case_sensitive]=regular_expression
server_url.port={[low_port_number]..[high_port_number]|exact_port_number}
server_url.query.regex[.case_sensitive]=regular_expression
server_url.scheme=url_scheme
where all options are identical to url=, except for the URL being tested. For more information, see
"url=" on page 137.
Discussion
The server_url= condition is identical to url=, except for the lack of a define server_url condition
and [server_url] section. Most optimization in forwarding is done with server_url.domain
conditions and sections.
Layer and Transaction Notes
•Use in <Proxy>, <Cache>, and <Exception> layers.