az network front-door rules-engine rule

Note

This reference is part of the front-door extension for the Azure CLI (version 2.0.68 or higher). The extension will automatically install the first time you run an az network front-door rules-engine rule command. Learn more about extensions.

Manage Rules Engine rules.

Commands

Name Description Type Status
az network front-door rules-engine rule action

Manage Rules Engine actions for Front Door.

Extension GA
az network front-door rules-engine rule action add

Add an action to a Rules Engine rule.

Extension GA
az network front-door rules-engine rule action list

Show all actions that apply for a Rules Engine rule.

Extension GA
az network front-door rules-engine rule action remove

Remove an action from a Rules Engine rule.

Extension GA
az network front-door rules-engine rule condition

Manage Rules Engine match conditions for Front Door.

Extension GA
az network front-door rules-engine rule condition add

Add a match condition to a Rules Engine rule.

Extension GA
az network front-door rules-engine rule condition list

Show all match conditions associated with a Rules Engine rule.

Extension GA
az network front-door rules-engine rule condition remove

Remove a match condition from a Rules Engine rule.

Extension GA
az network front-door rules-engine rule create

Create a Rules Engine rule for a Front Door.

Extension GA
az network front-door rules-engine rule delete

Delete a Rules Engine rule.

Extension GA
az network front-door rules-engine rule list

List rules of a Rules Engine configuration.

Extension GA
az network front-door rules-engine rule show

Get the details of a Rules Engine rule.

Extension GA
az network front-door rules-engine rule update

Update Rules Engine configuration of a rule.

Extension GA

az network front-door rules-engine rule create

Create a Rules Engine rule for a Front Door.

This command allows creating Rules Engine configuration with Header action type. To add additional actions like Route overrides, use the az network front-door rules-engine rule action add command.

az network front-door rules-engine rule create --action-type {RequestHeader, ResponseHeader}
                                               --front-door-name
                                               --name
                                               --priority
                                               --resource-group
                                               --rules-engine-name
                                               [--header-action {Append, Delete, Overwrite}]
                                               [--header-name]
                                               [--header-value]
                                               [--match-processing-behavior {Continue, Stop}]
                                               [--match-values]
                                               [--match-variable {IsMobile, PostArgs, QueryString, RemoteAddr, RequestBody, RequestFilename, RequestFilenameExtension, RequestHeader, RequestMethod, RequestPath, RequestScheme, RequestUri}]
                                               [--negate-condition {false, true}]
                                               [--operator {Any, BeginsWith, Contains, EndsWith, Equal, GeoMatch, GreaterThan, GreaterThanOrEqual, IPMatch, LessThan, LessThanOrEqual}]
                                               [--selector]
                                               [--transforms {Lowercase, RemoveNulls, Trim, Uppercase, UrlDecode, UrlEncode}]

Required Parameters

--action-type

Action type to apply for a rule.

accepted values: RequestHeader, ResponseHeader
--front-door-name -f

Name of the Front Door.

--name -n

Name of the rule.

--priority

The priority number must start from 0 and consecutive. Rule with greater priority value will be applied later.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--rules-engine-name -r

Name of the Rules Engine.

Optional Parameters

--header-action

Header action type for the requests.

accepted values: Append, Delete, Overwrite
--header-name

Name of the header to modify.

--header-value

Value of the header.

--match-processing-behavior

Whether to stop processing rules after conditions in a rule is satisfied.

accepted values: Continue, Stop
--match-values

Space-separated list of values to match against.

--match-variable

Name of the match condition.

accepted values: IsMobile, PostArgs, QueryString, RemoteAddr, RequestBody, RequestFilename, RequestFilenameExtension, RequestHeader, RequestMethod, RequestPath, RequestScheme, RequestUri
--negate-condition

Applies "Not" to the operator.

accepted values: false, true
--operator

Operator of the match condition.

accepted values: Any, BeginsWith, Contains, EndsWith, Equal, GeoMatch, GreaterThan, GreaterThanOrEqual, IPMatch, LessThan, LessThanOrEqual
--selector

Optional selector for the match condition variable.

--transforms

Space-separated list of transforms to apply.

accepted values: Lowercase, RemoveNulls, Trim, Uppercase, UrlDecode, UrlEncode
Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

accepted values: json, jsonc, none, table, tsv, yaml, yamlc
default value: json
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az network front-door rules-engine rule delete

Delete a Rules Engine rule.

az network front-door rules-engine rule delete --front-door-name
                                               --name
                                               --resource-group
                                               --rules-engine-name

Required Parameters

--front-door-name -f

Name of the Front Door.

--name -n

Name of the rule.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--rules-engine-name -r

Name of the Rules Engine.

Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

accepted values: json, jsonc, none, table, tsv, yaml, yamlc
default value: json
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az network front-door rules-engine rule list

List rules of a Rules Engine configuration.

az network front-door rules-engine rule list --front-door-name
                                             --name
                                             --resource-group

Required Parameters

--front-door-name -f

Name of the Front Door.

--name -n

Name of the Rules Engine.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

accepted values: json, jsonc, none, table, tsv, yaml, yamlc
default value: json
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az network front-door rules-engine rule show

Get the details of a Rules Engine rule.

az network front-door rules-engine rule show --front-door-name
                                             --name
                                             --resource-group
                                             --rules-engine-name

Required Parameters

--front-door-name -f

Name of the Front Door.

--name -n

Name of the rule.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--rules-engine-name -r

Name of the Rules Engine.

Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

accepted values: json, jsonc, none, table, tsv, yaml, yamlc
default value: json
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az network front-door rules-engine rule update

Update Rules Engine configuration of a rule.

az network front-door rules-engine rule update --front-door-name
                                               --name
                                               --resource-group
                                               --rules-engine-name
                                               [--match-processing-behavior {Continue, Stop}]
                                               [--priority]

Required Parameters

--front-door-name -f

Name of the Front Door.

--name -n

Name of the rule.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--rules-engine-name -r

Name of the Rules Engine.

Optional Parameters

--match-processing-behavior

Whether to stop processing rules after conditions in a rule is satisfied.

accepted values: Continue, Stop
--priority

The priority number must start from 0 and consecutive. Rule with greater priority value will be applied later.

Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

accepted values: json, jsonc, none, table, tsv, yaml, yamlc
default value: json
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.