Product Documentation

transform action

Sep 12, 2016

The following operations can be performed on "transform action":

add | rm | set | unset | show

add transform action

Creates a URL Transformation action, which defines how a specific element in URLs in the request or response is to be modified. NOTE: In the URL Transformation feature (unlike all other NetScaler features), ?profile? and ?action? are not synonymous but refer to distinct entities. You must create the profile first, and then the actions.

Synopsys

add transform action <name> <profileName> <priority> [-state ( ENABLED | DISABLED )]

Arguments

name

Name for the URL transformation action.

Must begin with a letter, number, or the underscore character (_), and must contain only letters, numbers, and the hyphen (-), period (.) pound (#), space ( ), at (@), equals (=), colon (:), and underscore characters. Cannot be changed after the URL Transformation action is added.

The following requirement applies only to the NetScaler CLI:

If the name includes one or more spaces, enclose the name in double or single quotation marks (for example, ?my transform action? or ?my transform action).

profileName

Name of the URL Transformation profile with which to associate this action.

priority

Positive integer specifying the priority of the action within the profile. A lower number specifies a higher priority. Must be unique within the list of actions bound to the profile. Policies are evaluated in the order of their priority numbers, and the first policy that matches is applied.

Minimum value: 1

Maximum value: 2147483647

state

Enable or disable this action.

Possible values: ENABLED, DISABLED

Default value: ENABLED

rm transform action

Removes a URL Transformation action.

Synopsys

rm transform action <name>

Arguments

name

Name of the action.

set transform action

Modifies the settings of the specified URL Transformation action.

Synopsys

set transform action <name> [-priority <positive_integer>] [-reqUrlFrom <expression>] [-reqUrlInto <expression>] [-resUrlFrom <expression>] [-resUrlInto <expression>] [-cookieDomainFrom <expression>] [-cookieDomainInto <expression>] [-state ( ENABLED | DISABLED )] [-comment <string>]

Arguments

name

Name of the URL Transformation action to modify.

priority

Positive integer specifying the priority of the action within the profile. A lower number specifies a higher priority. Must be unique within the list of actions bound to the profile. Policies are evaluated in the order of their priority numbers, and the first policy that matches is applied.

Minimum value: 1

Maximum value: 2147483647

reqUrlFrom

PCRE-format regular expression that describes the request URL pattern to be transformed.

reqUrlInto

PCRE-format regular expression that describes the transformation to be performed on URLs that match the reqUrlFrom pattern.

resUrlFrom

PCRE-format regular expression that describes the response URL pattern to be transformed.

resUrlInto

PCRE-format regular expression that describes the transformation to be performed on URLs that match the resUrlFrom pattern.

cookieDomainFrom

Pattern that matches the domain to be transformed in Set-Cookie headers.

cookieDomainInto

PCRE-format regular expression that describes the transformation to be performed on cookie domains that match the cookieDomainFrom pattern.

NOTE: The cookie domain to be transformed is extracted from the request.

state

Enable or disable this action.

Possible values: ENABLED, DISABLED

Default value: ENABLED

comment

Any comments to preserve information about this URL Transformation action.

unset transform action

Use this command to remove transform action settings.Refer to the set transform action command for meanings of the arguments.

Synopsys

unset transform action <name> [-reqUrlFrom] [-reqUrlInto] [-resUrlFrom] [-resUrlInto] [-cookieDomainFrom] [-cookieDomainInto] [-state] [-comment]

show transform action

Displays a list of all URL Transformation actions currently assigned to the specified profile.

Synopsys

show transform action [<name>]

Arguments

name

Name of the profile.

Outputs

stateflag

profileName

Name of the URL Transformation profile with which to associate this action.

priority

Positive integer specifying the priority of the action within the profile. A lower number specifies a higher priority. Must be unique within the list of actions bound to the profile. Policies are evaluated in the order of their priority numbers, and the first policy that matches is applied.

reqUrlFrom

PCRE-format regular expression that describes the request URL pattern to be transformed.

reqUrlInto

PCRE-format regular expression that describes the transformation to be performed on URLs that match the reqUrlFrom pattern.

resUrlFrom

PCRE-format regular expression that describes the response URL pattern to be transformed.

resUrlInto

PCRE-format regular expression that describes the transformation to be performed on URLs that match the resUrlFrom pattern.

cookieDomainFrom

Pattern that matches the domain to be transformed in Set-Cookie headers.

cookieDomainInto

PCRE-format regular expression that describes the transformation to be performed on cookie domains that match the cookieDomainFrom pattern.

NOTE: The cookie domain to be transformed is extracted from the request.

continueMatching

Continue transforming using the next rule in the list.

state

Enable or disable this action.

comment

Any comments to preserve information about this URL Transformation action.

devno

count