Available settings
The following sections describe the settings of redirect rules to configure static and dynamic URL redirects.
Static URL redirect
Performs a static URL redirect with a given HTTP status code and optionally preserves the query string.
A static URL redirect has the following configuration parameters:
URL: A literal string that will be used in the
Location
HTTP header returned in the redirect response.Status code: The HTTP status code of the redirect response (301 by default). Must be one of the following: 301 (Moved permanently), 302 (Found, also known as Moved temporarily), 307 (Temporary redirect), or 308 (Permanent redirect).
Preserve query string: Whether to preserve the query string when redirecting (disabled by default).
API information
The full syntax of the "action_parameters"
field for a redirect rule performing a static URL redirect is the following:
"action_parameters": { "from_value": { "target_url": { "value": "<STATIC_URL_VALUE>" }, "status_code": <STATUS_CODE>, "preserve_query_string": <BOOLEAN_VALUE> }
}
The only required parameter is <STATIC_URL_VALUE>
.
The optional parameters can have the following values:
"status_code"
(integer):301
(Moved permanently),302
(Found, also known as Moved temporarily),307
(Temporary redirect), or308
(Permanent redirect)."preserve_query_string"
(boolean):true
orfalse
.
Dynamic URL redirect
Performs a dynamic URL redirect, where the target URL is determined by an expression. You can configure the redirect HTTP status code and whether to preserve the query string when redirecting.
A dynamic URL redirect has the following configuration parameters:
Expression: An expression that defines the target URL of the redirect. The result of evaluating this expression will be used in the
Location
HTTP header returned in the redirect response. Refer to the fields and functions you can use in expressions.Status code: The HTTP status code of the redirect response (301 by default). Must be one of the following: 301 (Moved permanently), 302 (Found, also known as Moved temporarily), 307 (Temporary redirect), or 308 (Permanent redirect).
Preserve query string: Whether to preserve the query string when redirecting (disabled by default).
API information
The full syntax of the "action_parameters"
field for a redirect rule performing a dynamic URL redirect is the following:
"action_parameters": { "from_value": { "target_url": { "expression": "<DYNAMIC_URL_EXPRESSION>" }, "status_code": <STATUS_CODE>, "preserve_query_string": <BOOLEAN_VALUE> }
}
The only required parameter is <DYNAMIC_URL_EXPRESSION>
.
The optional parameters can have the following values:
"status_code"
(integer):301
(Moved permanently),302
(Found, also known as Moved temporarily),307
(Temporary redirect), or308
(Permanent redirect)."preserve_query_string"
(boolean):true
orfalse
.