az network front-door routing-rule

Note

このリファレンスは、Azure CLI (バージョン 2.57.0 以降) のフロント ドア拡張機能の一部です。 拡張機能は、az network front-door routing-rule コマンドを初めて実行するときに自動的にインストールされます。 拡張機能の詳細をご覧ください。

Front Door ルーティング規則を管理します。

コマンド

名前	説明	型	状態
az network front-door routing-rule create	Front Door ルーティング規則を作成します。	拡張子	GA
az network front-door routing-rule delete	Front Door ルーティング規則を削除します。	拡張子	GA
az network front-door routing-rule list	Front Door ルーティング規則を一覧表示します。	拡張子	GA
az network front-door routing-rule show	Front Door ルーティング規則の詳細を取得します。	拡張子	GA
az network front-door routing-rule update	Front Door ルーティング規則を更新します。	拡張子	GA

az network front-door routing-rule create

Front Door ルーティング規則を作成します。

Front Door ルーティング規則を作成して、要求をバックエンドに転送するか、ユーザーを別の URL にリダイレクトします。

例 1: az network front-door routing-rule create -f frontdoor1 -g rg1 --frontend-endpoints DefaultFrontendEndpoint --route-type Forward --backend-pool DefaultBackendPool -n forwardRoutingrule1 --patterns /forward1

例 2: az network front-door routing-rule create -f frontdoor1 -g rg1 --frontend-endpoints DefaultFrontendEndpoint --route-type Redirect --custom-host redirecthost.com -n redirectRouteRule1 --patterns /redirect1 --custom-query-string querystring.

az network front-door routing-rule create --front-door-name
                                          --frontend-endpoints
                                          --name
                                          --resource-group
                                          --route-type {Forward, Redirect}
                                          [--accepted-protocols]
                                          [--backend-pool]
                                          [--cache-duration]
                                          [--caching {Disabled, Enabled}]
                                          [--custom-forwarding-path]
                                          [--custom-fragment]
                                          [--custom-host]
                                          [--custom-path]
                                          [--custom-query-string]
                                          [--disabled {false, true}]
                                          [--dynamic-compression {Disabled, Enabled}]
                                          [--forwarding-protocol {HttpOnly, HttpsOnly, MatchRequest}]
                                          [--patterns]
                                          [--query-parameter-strip-directive {StripAll, StripAllExcept, StripNone, StripOnly}]
                                          [--query-parameters]
                                          [--redirect-protocol {HttpOnly, HttpsOnly, MatchRequest}]
                                          [--redirect-type {Found, Moved, PermanentRedirect, TemporaryRedirect}]
                                          [--rules-engine]

必須のパラメーター

--front-door-name -f

Front Door の名前。

--frontend-endpoints

フロントエンド エンドポイント名または ID のスペース区切りの一覧。

--name -n

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

--resource-group -g

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

--route-type

このルートの要求を Front Door が処理する方法を定義するルートの種類。つまり、要求をバックエンドに転送するか、ユーザーを別の URL にリダイレクトします。

指定可能な値: Forward, Redirect

省略可能のパラメーター

--accepted-protocols

受け入れるプロトコルのスペース区切りの一覧。 既定値: Http。

--backend-pool

バックエンド プールの名前または ID。 転送ルーティング規則を作成する必要があります。

--cache-duration

コンテンツをキャッシュする必要がある期間。 使用できる形式は ISO 8601 期間です。

--caching

このルートに対してキャッシュを有効にするかどうか。

指定可能な値: Disabled, Enabled

--custom-forwarding-path

この規則に一致するリソース パスを書き換えるために使用されるカスタム パス。 受信パスを使用するには空のままにします。

--custom-fragment

リダイレクト URL に追加するフラグメント。 フラグメントは、#の後に来る URL の一部です。 #を含めないでください。

--custom-host

リダイレクトするホスト。 受信ホストを宛先ホストとして使用するには、空のままにします。

--custom-path

リダイレクトする完全なパス。 パスを空にすることはできず、/で始まる必要があります。 受信パスを宛先パスとして使用するには、空のままにします。

--custom-query-string

リダイレクト URL に配置するクエリ文字列のセット。 この値を設定すると、既存のクエリ文字列が置き換えられます。受信クエリ文字列を保持するには、空のままにします。 クエリ文字列は = 形式である必要があります。 最初の ? と &は自動的に追加されるため、先頭に含めず、> で複数のクエリ文字列を区切ります。

--disabled

無効な状態で作成します。

指定可能な値: false, true

--dynamic-compression

キャッシュされたコンテンツには動的圧縮を使用します。

指定可能な値: Disabled, Enabled

--forwarding-protocol

トラフィックの転送に使用するプロトコル。

指定可能な値: HttpOnly, HttpsOnly, MatchRequest

--patterns

一致するパターンのスペース区切りのリスト。 既定値: '/*'。

--query-parameter-strip-directive

キャッシュ キーを形成するときの URL クエリ用語の処理。

指定可能な値: StripAll, StripAllExcept, StripNone, StripOnly

--query-parameters

query-parameter-strip-directive 型 StripAllExcept または StripOnly をそれぞれ使用する場合に、含めるか除外するクエリ パラメーター (コンマ区切り)。

--redirect-protocol

トラフィックがリダイレクトされる宛先のプロトコル。

指定可能な値: HttpOnly, HttpsOnly, MatchRequest

規定値: MatchRequest

--redirect-type

トラフィックをリダイレクトするときにルールが使用するリダイレクトの種類。

指定可能な値: Found, Moved, PermanentRedirect, TemporaryRedirect

規定値: Moved

--rules-engine

ルール エンジン構成の名前または ID。 プロパティのリンクを解除するには、"--remove rulesEngine" を使用します。

グローバル パラメーター

--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

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

--only-show-errors

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

--output -o

出力形式。

指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc

規定値: json

--query

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

--subscription

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

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az network front-door routing-rule delete

Front Door ルーティング規則を削除します。

az network front-door routing-rule delete --front-door-name
                                          --name
                                          --resource-group

必須のパラメーター

--front-door-name -f

Front Door の名前。

--name -n

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

--resource-group -g

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

グローバル パラメーター

--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

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

--only-show-errors

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

--output -o

出力形式。

指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc

規定値: json

--query

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

--subscription

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

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az network front-door routing-rule list

Front Door ルーティング規則を一覧表示します。

az network front-door routing-rule list --front-door-name
                                        --resource-group

必須のパラメーター

--front-door-name -f

Front Door の名前。

--resource-group -g

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

グローバル パラメーター

--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

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

--only-show-errors

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

--output -o

出力形式。

指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc

規定値: json

--query

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

--subscription

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

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az network front-door routing-rule show

Front Door ルーティング規則の詳細を取得します。

az network front-door routing-rule show --front-door-name
                                        --name
                                        --resource-group

必須のパラメーター

--front-door-name -f

Front Door の名前。

--name -n

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

--resource-group -g

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

グローバル パラメーター

--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

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

--only-show-errors

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

--output -o

出力形式。

指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc

規定値: json

--query

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

--subscription

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

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az network front-door routing-rule update

Front Door ルーティング規則を更新します。

az network front-door routing-rule update --front-door-name
                                          --name
                                          --resource-group
                                          [--accepted-protocols]
                                          [--add]
                                          [--backend-pool]
                                          [--cache-duration]
                                          [--caching {Disabled, Enabled}]
                                          [--custom-forwarding-path]
                                          [--custom-fragment]
                                          [--custom-host]
                                          [--custom-path]
                                          [--custom-query-string]
                                          [--dynamic-compression {Disabled, Enabled}]
                                          [--enabled {Disabled, Enabled}]
                                          [--force-string]
                                          [--forwarding-protocol {HttpOnly, HttpsOnly, MatchRequest}]
                                          [--frontend-endpoints]
                                          [--patterns]
                                          [--query-parameter-strip-directive {StripAll, StripAllExcept, StripNone, StripOnly}]
                                          [--query-parameters]
                                          [--redirect-protocol {HttpOnly, HttpsOnly, MatchRequest}]
                                          [--redirect-type {Found, Moved, PermanentRedirect, TemporaryRedirect}]
                                          [--remove]
                                          [--rules-engine]
                                          [--set]

必須のパラメーター

--front-door-name -f

Front Door の名前。

--name -n

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

--resource-group -g

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

省略可能のパラメーター

--accepted-protocols

受け入れるプロトコルのスペース区切りの一覧。 既定値: Http。

--add

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

規定値: []

--backend-pool

バックエンド プールの名前または ID。 転送ルーティング規則を作成する必要があります。

--cache-duration

コンテンツをキャッシュする必要がある期間。 使用できる形式は ISO 8601 期間です。

--caching

このルートに対してキャッシュを有効にするかどうか。

指定可能な値: Disabled, Enabled

--custom-forwarding-path

この規則に一致するリソース パスを書き換えるために使用されるカスタム パス。 受信パスを使用するには空のままにします。

--custom-fragment

リダイレクト URL に追加するフラグメント。 フラグメントは、#の後に来る URL の一部です。 #を含めないでください。

--custom-host

リダイレクトするホスト。 受信ホストを宛先ホストとして使用するには、空のままにします。

--custom-path

リダイレクトする完全なパス。 パスを空にすることはできず、/で始まる必要があります。 受信パスを宛先パスとして使用するには、空のままにします。

--custom-query-string

リダイレクト URL に配置するクエリ文字列のセット。 この値を設定すると、既存のクエリ文字列が置き換えられます。受信クエリ文字列を保持するには、空のままにします。 クエリ文字列は = 形式である必要があります。 最初の ? と &は自動的に追加されるため、先頭に含めず、> で複数のクエリ文字列を区切ります。

--dynamic-compression

キャッシュされたコンテンツには動的圧縮を使用します。

指定可能な値: Disabled, Enabled

--enabled

有効な状態。

指定可能な値: Disabled, Enabled

--force-string

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

規定値: False

--forwarding-protocol

トラフィックの転送に使用するプロトコル。

指定可能な値: HttpOnly, HttpsOnly, MatchRequest

--frontend-endpoints

フロントエンド エンドポイント名または ID のスペース区切りの一覧。

--patterns

一致するパターンのスペース区切りのリスト。 既定値: '/*'。

--query-parameter-strip-directive

キャッシュ キーを形成するときの URL クエリ用語の処理。

指定可能な値: StripAll, StripAllExcept, StripNone, StripOnly

--query-parameters

query-parameter-strip-directive 型 StripAllExcept または StripOnly をそれぞれ使用する場合に、含めるか除外するクエリ パラメーター (コンマ区切り)。

--redirect-protocol

トラフィックがリダイレクトされる宛先のプロトコル。

指定可能な値: HttpOnly, HttpsOnly, MatchRequest

--redirect-type

トラフィックをリダイレクトするときにルールが使用するリダイレクトの種類。

指定可能な値: Found, Moved, PermanentRedirect, TemporaryRedirect

--remove

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

規定値: []

--rules-engine

ルール エンジン構成の名前または ID。 プロパティのリンクを解除するには、"--remove rulesEngine" を使用します。

--set

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

規定値: []

グローバル パラメーター

--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

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

--only-show-errors

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

--output -o

出力形式。

指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc

規定値: json

--query

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

--subscription

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

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。