az network application-gateway rule

プローブ情報を評価し、HTTP/HTTPS ルーティング規則を定義します。

詳細については、https://learn.microsoft.com/en-us/azure/web-application-firewall/ag/application-gateway-customize-waf-rules-cli を参照してください。

コマンド

名前	説明	型	状態
az network application-gateway rule create	規則を作成します。	Core	GA
az network application-gateway rule delete	規則を削除します。	Core	GA
az network application-gateway rule list	ルールを一覧表示します。	Core	GA
az network application-gateway rule show	ルールの詳細を取得します。	Core	GA
az network application-gateway rule update	ルールを更新します。	Core	GA
az network application-gateway rule wait	条件が満たされるまで CLI を待機状態にします。	Core	GA

az network application-gateway rule create

規則を作成します。

ルールは、作成された順序で実行されます。

az network application-gateway rule create --gateway-name
                                           --name
                                           --resource-group
                                           [--address-pool]
                                           [--http-listener]
                                           [--http-settings]
                                           [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                           [--priority]
                                           [--redirect-config]
                                           [--rewrite-rule-set]
                                           [--rule-type {Basic, PathBasedRouting}]
                                           [--url-path-map]

例

基本的なルールを作成します。

az network application-gateway rule create -g MyResourceGroup --gateway-name MyAppGateway -n MyRule --http-listener MyBackendListener --rule-type Basic --address-pool MyAddressPool --http-settings MyHttpSettings

必須のパラメーター

--gateway-name

アプリケーション ゲートウェイの名前。

--name -n

要求ルーティング規則の名前。

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name>を使用して既定のグループを構成できます。

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--address-pool

バックエンド アドレス プールの名前または ID。 1 つだけ存在する場合は、既定値として使用する場合は省略します。

プロパティ	値
パラメーター グループ:	Properties Arguments

--http-listener

HTTP リスナーの名前または ID。 1 つだけ存在する場合は、既定値として使用する場合は省略します。

プロパティ	値
パラメーター グループ:	Properties Arguments

--http-settings

HTTP 設定の名前または ID。 1 つだけ存在する場合は、既定値として使用する場合は省略します。

プロパティ	値
パラメーター グループ:	Properties Arguments

--no-wait

実行時間の長い操作が完了するまで待つ必要はありません。

プロパティ	値
指定可能な値:	0, 1, f, false, n, no, t, true, y, yes

--priority

要求ルーティング規則の優先順位。 サポートされている SKU レベルは、WAF_v2 Standard_v2。

--redirect-config

作成されたルールで使用するリダイレクト構成の名前または ID。

プロパティ	値
パラメーター グループ:	Properties Arguments

--rewrite-rule-set

書き換え規則セットの名前または ID。

プロパティ	値
パラメーター グループ:	Properties Arguments

--rule-type

要求ルーティング規則の種類。

プロパティ	値
規定値:	Basic
指定可能な値:	Basic, PathBasedRouting

--url-path-map

URL パス マップの名前または ID。

プロパティ	値
パラメーター グループ:	Properties Arguments

グローバル パラメーター

--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ	値
規定値:	False

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告を抑制します。

プロパティ	値
規定値:	False

--output -o

出力フォーマット。

プロパティ	値
規定値:	json
指定可能な値:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_IDを使用して既定のサブスクリプションを構成できます。

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ	値
規定値:	False

az network application-gateway rule delete

規則を削除します。

az network application-gateway rule delete --gateway-name
                                           --name
                                           --resource-group
                                           [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]

例

規則を削除します。

az network application-gateway rule delete -g MyResourceGroup --gateway-name MyAppGateway -n MyRule

必須のパラメーター

--gateway-name

アプリケーション ゲートウェイの名前。

--name -n

要求ルーティング規則の名前。

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name>を使用して既定のグループを構成できます。

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--no-wait

実行時間の長い操作が完了するまで待つ必要はありません。

プロパティ	値
指定可能な値:	0, 1, f, false, n, no, t, true, y, yes

グローバル パラメーター

--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ	値
規定値:	False

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告を抑制します。

プロパティ	値
規定値:	False

--output -o

出力フォーマット。

プロパティ	値
規定値:	json
指定可能な値:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_IDを使用して既定のサブスクリプションを構成できます。

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ	値
規定値:	False

az network application-gateway rule list

ルールを一覧表示します。

az network application-gateway rule list --gateway-name
                                         --resource-group

例

ルールを一覧表示します。

az network application-gateway rule list -g MyResourceGroup --gateway-name MyAppGateway

必須のパラメーター

--gateway-name

アプリケーション ゲートウェイの名前。

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name>を使用して既定のグループを構成できます。

グローバル パラメーター

--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ	値
規定値:	False

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告を抑制します。

プロパティ	値
規定値:	False

--output -o

出力フォーマット。

プロパティ	値
規定値:	json
指定可能な値:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_IDを使用して既定のサブスクリプションを構成できます。

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ	値
規定値:	False

az network application-gateway rule show

ルールの詳細を取得します。

az network application-gateway rule show --gateway-name
                                         --name
                                         --resource-group

例

ルールの詳細を取得します。

az network application-gateway rule show -g MyResourceGroup --gateway-name MyAppGateway -n MyRule

必須のパラメーター

--gateway-name

アプリケーション ゲートウェイの名前。

--name -n

要求ルーティング規則の名前。

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name>を使用して既定のグループを構成できます。

グローバル パラメーター

--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ	値
規定値:	False

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告を抑制します。

プロパティ	値
規定値:	False

--output -o

出力フォーマット。

プロパティ	値
規定値:	json
指定可能な値:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_IDを使用して既定のサブスクリプションを構成できます。

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ	値
規定値:	False

az network application-gateway rule update

ルールを更新します。

az network application-gateway rule update --gateway-name
                                           --name
                                           --resource-group
                                           [--add]
                                           [--address-pool]
                                           [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                                           [--http-listener]
                                           [--http-settings]
                                           [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                           [--priority]
                                           [--redirect-config]
                                           [--remove]
                                           [--rewrite-rule-set]
                                           [--rule-type {Basic, PathBasedRouting}]
                                           [--set]
                                           [--url-path-map]

例

ルールを更新する場合は、新しい HTTP リスナーを使用します。

az network application-gateway rule update -g MyResourceGroup --gateway-name MyAppGateway -n MyRule --http-listener MyNewBackendListener

必須のパラメーター

--gateway-name

アプリケーション ゲートウェイの名前。

--name -n

要求ルーティング規則の名前。

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name>を使用して既定のグループを構成できます。

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--add

パスとキー値のペアを指定して、オブジェクトの一覧にオブジェクトを追加します。 例: --add property.listProperty <key=value, string or JSON string>。

プロパティ	値
パラメーター グループ:	Generic Update Arguments

--address-pool

バックエンド アドレス プールの名前または ID。 1 つだけ存在する場合は、既定値として使用する場合は省略します。

プロパティ	値
パラメーター グループ:	Properties Arguments

--force-string

'set' または 'add' を使用する場合は、JSON に変換するのではなく、文字列リテラルを保持します。

プロパティ	値
パラメーター グループ:	Generic Update Arguments
指定可能な値:	0, 1, f, false, n, no, t, true, y, yes

--http-listener

HTTP リスナーの名前または ID。 1 つだけ存在する場合は、既定値として使用する場合は省略します。

プロパティ	値
パラメーター グループ:	Properties Arguments

--http-settings

HTTP 設定の名前または ID。 1 つだけ存在する場合は、既定値として使用する場合は省略します。

プロパティ	値
パラメーター グループ:	Properties Arguments

--no-wait

実行時間の長い操作が完了するまで待つ必要はありません。

プロパティ	値
指定可能な値:	0, 1, f, false, n, no, t, true, y, yes

--priority

要求ルーティング規則の優先順位。 サポートされている SKU レベルは、WAF_v2 Standard_v2。

--redirect-config

作成されたルールで使用するリダイレクト構成の名前または ID。

プロパティ	値
パラメーター グループ:	Properties Arguments

--remove

リストからプロパティまたは要素を削除します。 例: --remove property.list <indexToRemove> OR --remove propertyToRemove。

プロパティ	値
パラメーター グループ:	Generic Update Arguments

--rewrite-rule-set

書き換え規則セットの名前または ID。

プロパティ	値
パラメーター グループ:	Properties Arguments

--rule-type

要求ルーティング規則の種類。

プロパティ	値
指定可能な値:	Basic, PathBasedRouting

--set

設定するプロパティ パスと値を指定して、オブジェクトを更新します。 例: --set property1.property2=<value>。

プロパティ	値
パラメーター グループ:	Generic Update Arguments

--url-path-map

URL パス マップの名前または ID。

プロパティ	値
パラメーター グループ:	Properties Arguments

グローバル パラメーター

--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ	値
規定値:	False

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告を抑制します。

プロパティ	値
規定値:	False

--output -o

出力フォーマット。

プロパティ	値
規定値:	json
指定可能な値:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_IDを使用して既定のサブスクリプションを構成できます。

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ	値
規定値:	False

az network application-gateway rule wait

条件が満たされるまで CLI を待機状態にします。

az network application-gateway rule wait [--created]
                                         [--custom]
                                         [--deleted]
                                         [--exists]
                                         [--gateway-name]
                                         [--ids]
                                         [--interval]
                                         [--resource-group]
                                         [--subscription]
                                         [--timeout]
                                         [--updated]

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--created

'provisioningState' が 'Succeeded' で作成されるまで待ちます。

プロパティ	値
パラメーター グループ:	Wait Condition Arguments
規定値:	False

--custom

条件がカスタム JMESPath クエリを満たすまで待ちます。 例: provisioningState!='InProgress'、instanceView.statuses[?code=='PowerState/running']。

プロパティ	値
パラメーター グループ:	Wait Condition Arguments

--deleted

削除されるまで待ちます。

プロパティ	値
パラメーター グループ:	Wait Condition Arguments
規定値:	False

--exists

リソースが存在するまで待ちます。

プロパティ	値
パラメーター グループ:	Wait Condition Arguments
規定値:	False

--gateway-name

アプリケーション ゲートウェイの名前。

プロパティ	値
パラメーター グループ:	Resource Id Arguments

--ids

1 つ以上のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。

プロパティ	値
パラメーター グループ:	Resource Id Arguments

--interval

ポーリング間隔 (秒単位)。

プロパティ	値
パラメーター グループ:	Wait Condition Arguments
規定値:	30

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name>を使用して既定のグループを構成できます。

プロパティ	値
パラメーター グループ:	Resource Id Arguments

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_IDを使用して既定のサブスクリプションを構成できます。

プロパティ	値
パラメーター グループ:	Resource Id Arguments

--timeout

最大待機時間 (秒単位)。

プロパティ	値
パラメーター グループ:	Wait Condition Arguments
規定値:	3600

--updated

provisioningState が 'Succeeded' で更新されるまで待ちます。

プロパティ	値
パラメーター グループ:	Wait Condition Arguments
規定値:	False

グローバル パラメーター

--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ	値
規定値:	False

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告を抑制します。

プロパティ	値
規定値:	False

--output -o

出力フォーマット。

プロパティ	値
規定値:	json
指定可能な値:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ	値
規定値:	False