Routes

Routes map incoming Host and path conditions to backend pools.

Syntax

RULE <route_name>
IF HOST equals <hostname>
IF PATH_PREFIX prefix <path>
BACKEND=<logical_backend_name>
POOL=<pool_name>
ACTION=<allow|block>
END

Example

RULE website_root
IF HOST equals www.example.com
IF PATH_PREFIX prefix /
BACKEND=website
POOL=web_pool
ACTION=allow
END

RULE api_root
IF HOST equals api.example.com
IF PATH_PREFIX prefix /v1/
BACKEND=api
POOL=api_pool
ACTION=allow
END

Allowed match operators

Field	Operator	Example
HOST	equals	IF HOST equals www.example.com
PATH_PREFIX	prefix	IF PATH_PREFIX prefix /api/

Best practices

• Use explicit hostnames.
• Keep admin paths separate from public paths.
• Put more specific paths before generic / routes.
• Use generic examples in documentation and replace with approved customer hostnames during deployment.