Property Manager Name: Redirect
Respond to the client’s request with a redirect without contacting the origin. Specify the redirect as a path expression starting with a / character relative to the current root, or as a fully qualified URL. This behavior relies primarily on destinationHostname and destinationPath to manipulate the hostname and path independently.
See also the redirectplus behavior, which allows you to use variables more flexibly to express the redirect’s destination.
Options
- mobileDefaultChoice (enum string): When set to MOBILE, allows only a 302 response code. When set to DEFAULT, allows all other responseCode values.
- destinationProtocol (enum string): Choose the protocol for the redirect URL, either HTTP, HTTPS, or SAME_AS_REQUEST to pass through the original protocol.
- destinationHostname (enum string): Specify how to change the requested hostname, independently from the pathname:
- SUBDOMAIN prepends a subdomain from the destinationHostnameSubdomain field.
- SIBLING replaces the leftmost subdomain with the destinationHostnameSibling field.
- OTHER specifies a static domain in the destinationHostnameOther field.
- SAME_AS_REQUEST preserves the hostname unchanged.
- destinationHostnameSubdomain (string; allows variables): If destinationHostname is set to SUBDOMAIN, this specifies a subdomain to prepend to the current hostname. For example, a value of m changes www.example.com to m.www.example.com.
- destinationHostnameSibling (string; allows variables): If destinationHostname is set to SIBLING, this specifies the subdomain with which to replace to the current hostname’s leftmost subdomain. For example, a value of m changes www.example.com to m.example.com.
- destinationHostnameOther (string; allows variables): If destinationHostname is set to OTHER, this specifies the full hostname with which to replace the current hostname.
- destinationPath (enum string): Specify how to change the requested pathname, independently from the hostname:
- PREFIX_REQUEST prepends a path with the destinationPathPrefix field. You also have the option to specify a suffix using destinationPathSuffix and destinationPathSuffixStatus.
- OTHER replaces the current path with the destinationPathOther field.
- SAME_AS_REQUEST preserves the current path unchanged.
- destinationPathPrefix (string; allows variables): When destinationPath is set to PREFIX_REQUEST, this prepends the current path. For example, a value of /prefix/path changes /example/index.html to /prefix/path/example/index.html.
- destinationPathSuffixStatus (enum string): When destinationPath is set to PREFIX_REQUEST, this gives you the option of adding a suffix. Specify NO_SUFFIX if you want to preserve the end of the path unchanged. If you specify SUFFIX, the destinationPathSuffix provides the value.
- destinationPathSuffix (string; allows variables): When destinationPath is set to PREFIX_REQUEST and destinationPathSuffixStatus is set to SUFFIX, this specifies the suffix to append to the path.
- destinationPathOther (string; allows variables): When destinationPath is set to PREFIX_REQUEST, this replaces the current path.
- queryString (enum string): When set to APPEND, passes incoming query string parameters as part of the redirect URL. Otherwise set this to IGNORE.
- responseCode (numeric enum): Specify the redirect’s response code: 301 (Moved Permanently), 302 (Found), 303 (See Other), or 307 (Temporary Redirect).