az network application-gateway advanced-routing-set condition

Manage routing conditions of an advanced routing condition set.

Commands

Name	Description	Type	Status
az network application-gateway advanced-routing-set condition create	Create a routing condition.	Core	GA
az network application-gateway advanced-routing-set condition delete	Delete a routing condition.	Core	GA
az network application-gateway advanced-routing-set condition list	List routing conditions.	Core	GA
az network application-gateway advanced-routing-set condition show	Get the details of a routing condition.	Core	GA
az network application-gateway advanced-routing-set condition update	Update a routing condition.	Core	GA
az network application-gateway advanced-routing-set condition wait	Place the CLI in a waiting state until a condition is met.	Core	GA

az network application-gateway advanced-routing-set condition create

Edit

Create a routing condition.

az network application-gateway advanced-routing-set condition create --condition-set-name
                                                                     --condition-type {ClientIP, Header, Method, Path, QueryString}
                                                                     --gateway-name
                                                                     --resource-group
                                                                     [--acquire-policy-token]
                                                                     [--change-reference]
                                                                     [--index]
                                                                     [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                                                     [--property-name]
                                                                     [--property-value-matcher]
                                                                     [--property-values]

Examples

Add a query string condition to an advanced routing condition set.

az network application-gateway advanced-routing-set condition create -g MyResourceGroup --gateway-name MyAppGateway --condition-set-name MyConditionSet --condition-type QueryString --property-name version --property-values v2

Required Parameters

--condition-set-name

Name of the advanced routing condition set.

--condition-type

The type of request property the condition is evaluated against.

Property	Value
Accepted values:	ClientIP, Header, Method, Path, QueryString

--gateway-name

Name of the application gateway.

--resource-group -g

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

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--acquire-policy-token

Acquiring an Azure Policy token automatically for this resource operation.

Property	Value
Parameter group:	Global Policy Arguments

--change-reference

The related change reference ID for this resource operation.

Property	Value
Parameter group:	Global Policy Arguments

--index

Index of the routing condition. Omit on create to append.

--no-wait

Do not wait for the long-running operation to finish.

Property	Value
Accepted values:	0, 1, f, false, n, no, t, true, y, yes

--property-name

Name of the request property the condition is evaluated against. Required when conditionType is Header or QueryString, and not applicable when conditionType is Path, ClientIP or Method.

--property-value-matcher

Pattern the request property is matched against. Exactly one of propertyValues or propertyValueMatcher must be specified. Not applicable when conditionType is ClientIP or Method. Support shorthand-syntax, json-file and yaml-file. Try "??" to show more.

--property-values

Values the request property is matched against. Exactly one of propertyValues or propertyValueMatcher must be specified. Support shorthand-syntax, json-file and yaml-file. Try "??" to show more.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

Property	Value
Default value:	False

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property	Value
Default value:	False

--output -o

Output format.

Property	Value
Default value:	json
Accepted values:	json, jsonc, none, table, tsv, yaml, yamlc

--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.

Property	Value
Default value:	False

az network application-gateway advanced-routing-set condition delete

Edit

Delete a routing condition.

az network application-gateway advanced-routing-set condition delete --condition-set-name
                                                                     --gateway-name
                                                                     --index
                                                                     --resource-group
                                                                     [--acquire-policy-token]
                                                                     [--change-reference]
                                                                     [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]

Examples

Delete the second routing condition of an advanced routing condition set.

az network application-gateway advanced-routing-set condition delete -g MyResourceGroup --gateway-name MyAppGateway --condition-set-name MyConditionSet --index 1

Required Parameters

--condition-set-name

Name of the advanced routing condition set.

--gateway-name

Name of the application gateway.

--index

Index of the routing condition.

--resource-group -g

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

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--acquire-policy-token

Acquiring an Azure Policy token automatically for this resource operation.

Property	Value
Parameter group:	Global Policy Arguments

--change-reference

The related change reference ID for this resource operation.

Property	Value
Parameter group:	Global Policy Arguments

--no-wait

Do not wait for the long-running operation to finish.

Property	Value
Accepted values:	0, 1, f, false, n, no, t, true, y, yes

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

Property	Value
Default value:	False

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property	Value
Default value:	False

--output -o

Output format.

Property	Value
Default value:	json
Accepted values:	json, jsonc, none, table, tsv, yaml, yamlc

--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.

Property	Value
Default value:	False

az network application-gateway advanced-routing-set condition list

Edit

List routing conditions.

az network application-gateway advanced-routing-set condition list --condition-set-name
                                                                   --gateway-name
                                                                   --resource-group

Examples

List the routing conditions of an advanced routing condition set.

az network application-gateway advanced-routing-set condition list -g MyResourceGroup --gateway-name MyAppGateway --condition-set-name MyConditionSet

Required Parameters

--condition-set-name

Name of the advanced routing condition set.

--gateway-name

Name of the application gateway.

--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.

Property	Value
Default value:	False

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property	Value
Default value:	False

--output -o

Output format.

Property	Value
Default value:	json
Accepted values:	json, jsonc, none, table, tsv, yaml, yamlc

--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.

Property	Value
Default value:	False

az network application-gateway advanced-routing-set condition show

Edit

Get the details of a routing condition.

az network application-gateway advanced-routing-set condition show --condition-set-name
                                                                   --gateway-name
                                                                   --index
                                                                   --resource-group

Examples

Get the details of the first routing condition of an advanced routing condition set.

az network application-gateway advanced-routing-set condition show -g MyResourceGroup --gateway-name MyAppGateway --condition-set-name MyConditionSet --index 0

Required Parameters

--condition-set-name

Name of the advanced routing condition set.

--gateway-name

Name of the application gateway.

--index

Index of the routing condition.

--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.

Property	Value
Default value:	False

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property	Value
Default value:	False

--output -o

Output format.

Property	Value
Default value:	json
Accepted values:	json, jsonc, none, table, tsv, yaml, yamlc

--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.

Property	Value
Default value:	False

az network application-gateway advanced-routing-set condition update

Edit

Update a routing condition.

az network application-gateway advanced-routing-set condition update --condition-set-name
                                                                     --gateway-name
                                                                     --index
                                                                     --resource-group
                                                                     [--acquire-policy-token]
                                                                     [--add]
                                                                     [--change-reference]
                                                                     [--condition-type {ClientIP, Header, Method, Path, QueryString}]
                                                                     [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                                                                     [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                                                     [--property-name]
                                                                     [--property-value-matcher]
                                                                     [--property-values]
                                                                     [--remove]
                                                                     [--set]

Examples

Update the values of the second routing condition of an advanced routing condition set.

az network application-gateway advanced-routing-set condition update -g MyResourceGroup --gateway-name MyAppGateway --condition-set-name MyConditionSet --index 1 --property-values v2 v3

Required Parameters

--condition-set-name

Name of the advanced routing condition set.

--gateway-name

Name of the application gateway.

--index

Index of the routing condition.

--resource-group -g

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

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--acquire-policy-token

Acquiring an Azure Policy token automatically for this resource operation.

Property	Value
Parameter group:	Global Policy Arguments

--add

Add an object to a list of objects by specifying a path and key value pairs. Example: --add property.listProperty <key=value, string or JSON string>.

Property	Value
Parameter group:	Generic Update Arguments

--change-reference

The related change reference ID for this resource operation.

Property	Value
Parameter group:	Global Policy Arguments

--condition-type

The type of request property the condition is evaluated against.

Property	Value
Accepted values:	ClientIP, Header, Method, Path, QueryString

--force-string

When using 'set' or 'add', preserve string literals instead of attempting to convert to JSON.

Property	Value
Parameter group:	Generic Update Arguments
Accepted values:	0, 1, f, false, n, no, t, true, y, yes

--no-wait

Do not wait for the long-running operation to finish.

Property	Value
Accepted values:	0, 1, f, false, n, no, t, true, y, yes

--property-name

Name of the request property the condition is evaluated against. Required when conditionType is Header or QueryString, and not applicable when conditionType is Path, ClientIP or Method.

--property-value-matcher

--property-values

Values the request property is matched against. Exactly one of propertyValues or propertyValueMatcher must be specified. Support shorthand-syntax, json-file and yaml-file. Try "??" to show more.

--remove

Remove a property or an element from a list. Example: --remove property.list <indexToRemove> OR --remove propertyToRemove.

Property	Value
Parameter group:	Generic Update Arguments

--set

Update an object by specifying a property path and value to set. Example: --set property1.property2=<value>.

Property	Value
Parameter group:	Generic Update Arguments

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

Property	Value
Default value:	False

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property	Value
Default value:	False

--output -o

Output format.

Property	Value
Default value:	json
Accepted values:	json, jsonc, none, table, tsv, yaml, yamlc

--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.

Property	Value
Default value:	False

az network application-gateway advanced-routing-set condition wait

Edit

Place the CLI in a waiting state until a condition is met.

az network application-gateway advanced-routing-set condition wait [--acquire-policy-token]
                                                                   [--change-reference]
                                                                   [--created]
                                                                   [--custom]
                                                                   [--deleted]
                                                                   [--exists]
                                                                   [--gateway-name]
                                                                   [--ids]
                                                                   [--interval]
                                                                   [--resource-group]
                                                                   [--subscription]
                                                                   [--timeout]
                                                                   [--updated]

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--acquire-policy-token

Acquiring an Azure Policy token automatically for this resource operation.

Property	Value
Parameter group:	Global Policy Arguments

--change-reference

The related change reference ID for this resource operation.

Property	Value
Parameter group:	Global Policy Arguments

--created

Wait until created with 'provisioningState' at 'Succeeded'.

Property	Value
Parameter group:	Wait Condition Arguments
Default value:	False

--custom

Wait until the condition satisfies a custom JMESPath query. E.g. provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

Property	Value
Parameter group:	Wait Condition Arguments

--deleted

Wait until deleted.

Property	Value
Parameter group:	Wait Condition Arguments
Default value:	False

--exists

Wait until the resource exists.

Property	Value
Parameter group:	Wait Condition Arguments
Default value:	False

--gateway-name

Name of the application gateway.

Property	Value
Parameter group:	Resource Id Arguments

--ids

One or more resource IDs (space-delimited). It should be a complete resource ID containing all information of 'Resource Id' arguments. You should provide either --ids or other 'Resource Id' arguments.

Property	Value
Parameter group:	Resource Id Arguments

--interval

Polling interval in seconds.

Property	Value
Parameter group:	Wait Condition Arguments
Default value:	30

--resource-group -g

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

Property	Value
Parameter group:	Resource Id Arguments

--subscription

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

Property	Value
Parameter group:	Resource Id Arguments

--timeout

Maximum wait in seconds.

Property	Value
Parameter group:	Wait Condition Arguments
Default value:	3600

--updated

Wait until updated with provisioningState at 'Succeeded'.

Property	Value
Parameter group:	Wait Condition Arguments
Default value:	False

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

Property	Value
Default value:	False

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property	Value
Default value:	False

--output -o

Output format.

Property	Value
Default value:	json
Accepted values:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

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

Property	Value
Default value:	False

Feedback

Was this page helpful?