az afd rule

指定したルール セット内で配信ルールを管理します。

コマンド

名前	説明	型	状態
az afd rule action	指定したルール セット内で配信ルールを管理します。	Core	GA
az afd rule action add	指定したルール セット内の新しい配信ルールを更新します。	Core	GA
az afd rule action list	ルール セット内の既存の配信ルールを取得します。	Core	GA
az afd rule action remove	指定したルール セット内の新しい配信ルールを更新します。	Core	GA
az afd rule condition	指定したルール セット内で配信ルールを管理します。	Core	GA
az afd rule condition add	指定したルール セット内の新しい配信ルールを更新します。	Core	GA
az afd rule condition list	ルール セット内の既存の配信ルールを取得します。	Core	GA
az afd rule condition remove	指定したルール セット内の新しい配信ルールを更新します。	Core	GA
az afd rule create	指定したルール セット内に新しい配信ルールを作成します。	Core	GA
az afd rule delete	ルール セット内の既存の配信ルールを削除します。	Core	GA
az afd rule list	ルール セット内の既存の配信ルールをすべて一覧表示します。	Core	GA
az afd rule show	ルール セット内の既存の配信ルールを取得します。	Core	GA
az afd rule update	指定したルール セット内の新しい配信ルールを更新します。	Core	GA
az afd rule wait	条件が満たされるまで CLI を待機状態にします。	Core	GA

az afd rule create

指定したルール セット内に新しい配信ルールを作成します。

az afd rule create --name --rule-name
                   --profile-name
                   --resource-group
                   --rule-set-name
                   [--action-name]
                   [--cache-behavior]
                   [--cache-duration]
                   [--custom-fragment]
                   [--custom-hostname]
                   [--custom-path]
                   [--custom-querystring]
                   [--destination]
                   [--enable-caching {0, 1, f, false, n, no, t, true, y, yes}]
                   [--enable-compression {0, 1, f, false, n, no, t, true, y, yes}]
                   [--forwarding-protocol]
                   [--header-action]
                   [--header-name]
                   [--header-value]
                   [--match-processing-behavior {Continue, Stop}]
                   [--match-values]
                   [--match-variable]
                   [--negate-condition {0, 1, f, false, n, no, t, true, y, yes}]
                   [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                   [--operator]
                   [--order]
                   [--origin-group]
                   [--preserve-unmatched-path {0, 1, f, false, n, no, t, true, y, yes}]
                   [--query-parameters]
                   [--query-string-caching-behavior]
                   [--redirect-protocol]
                   [--redirect-type]
                   [--selector]
                   [--source-pattern]
                   [--transforms]

例

タイからの要求の応答ヘッダーを追加するルールを作成します。

az afd rule create -g group --rule-set-name ruleset1 --profile-name profile --order 2 --match-variable RemoteAddress --operator GeoMatch --match-values TH --rule-name disablecaching --action-name ModifyResponseHeader --header-action Append --header-name X-CDN --header-value AFDX

http から https へのリダイレクトの規則を作成する

az afd rule create -g group --rule-set-name ruleset1 --profile-name profile --order 1 --rule-name "redirect" --match-variable RequestScheme --operator Equal --match-values HTTP --action-name "UrlRedirect" --redirect-protocol Https --redirect-type Moved

必須のパラメーター

--name --rule-name -n

エンドポイント内で一意である配信ルールの名前。

--profile-name

リソース グループ内で一意である Azure Front Door Standard または Azure Front Door Premium プロファイルの名前。

--resource-group -g

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

--rule-set-name

プロファイルの下にあるルール セットの名前。

省略可能のパラメーター

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

--action-name

配信ルールのアクションの名前: https://learn.microsoft.com/en-us/azure/frontdoor/front-door-rules-engine-actions。

--cache-behavior

要求のキャッシュ動作。

--cache-duration

コンテンツをキャッシュする必要がある期間。 使用できる形式は hh:mm:ss.xxxxxx です。

--custom-fragment

リダイレクト URL に追加するフラグメント。

--custom-hostname

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

--custom-path

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

--custom-querystring

受信したクエリ文字列を保持するために、リダイレクト URL に配置するクエリ文字列のセットを空のままにします。

--destination

書き換えに使用する宛先パス。

--enable-caching

ルートでキャッシュを有効にするかどうかを示します。

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

--enable-compression

AzureFrontDoor でコンテンツ圧縮が有効かどうかを示します。 既定値は false です。圧縮が有効になっている場合、ユーザーが圧縮バージョンを要求した場合、コンテンツは圧縮として処理されます。要求されたコンテンツが 8 MB より小さいか、1 KB より大きい場合、AzureFrontDoorwhen でコンテンツは圧縮されません。

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

--forwarding-protocol

この規則は、トラフィックをバックエンドに転送するときに使用するプロトコルです。

--header-action

要求のヘッダー アクション。

--header-name

変更するヘッダーの名前。

--header-value

ヘッダーの値。

--match-processing-behavior

このルールが一致する場合、ルール エンジンは残りのルールを実行し続けるか停止する必要があります。 存在しない場合は、既定で [続行] が選択されます。

プロパティ	値
Parameter group:	Properties Arguments
規定値:	Continue
指定可能な値:	Continue, Stop

--match-values

一致条件の値と一致します。 たとえば、スペース区切り値 'GET' 'HTTP' などです。 短縮構文、json-file、yaml-file をサポートします。 詳細を表示するには、"??" を試してください。

--match-variable

一致条件の名前: https://learn.microsoft.com/en-us/azure/frontdoor/rules-match-conditions。

--negate-condition

true の場合、条件を否定します。

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

--no-wait

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

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

--operator

一致条件の演算子。

--order

エンドポイントにルールが適用される順序。 指定できる値 {0,1,2,3,Â'¬ÂڂÊ¢â'¬ÂڂÂ'¬Â'¬ÂپÂڂÂڂ} 順序が小さいルールは、順序の大きいルールの前に適用されます。 順序 0 のルールは特別なルールです。 条件は不要で、リストに記載されているアクションは常に適用されます。

プロパティ	値
Parameter group:	Properties Arguments

--origin-group

既定の OriginGroup をオーバーライドする OriginGroup の名前または ID。

--preserve-unmatched-path

True の場合、ソース パターンの後の残りのパスが新しい宛先パスに追加されます。

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

--query-parameters

含めるか除外するクエリ パラメーター。 短縮構文、json-file、yaml-file をサポートします。 詳細を表示するには、"??" を試してください。

--query-string-caching-behavior

クエリ文字列を含む要求を CDN がキャッシュする方法を定義します。キャッシュ時にクエリ文字列を無視したり、キャッシュをバイパスしてクエリ文字列を含む要求がキャッシュされないようにしたり、一意の URL ですべての要求をキャッシュしたりできます。

--redirect-protocol

リダイレクトに使用するプロトコル。

--redirect-type

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

--selector

一致条件のセレクター。

--source-pattern

書き換えられる可能性がある要求の種類を識別する要求 URI パターン。

--transforms

一致する前に適用する変換。 短縮構文、json-file、yaml-file をサポートします。 詳細を表示するには、"??" を試してください。

グローバル パラメーター

--debug

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

プロパティ	値
規定値:	False

--help -h

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

--only-show-errors

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

プロパティ	値
規定値:	False

--output -o

Output format.

プロパティ	値
規定値:	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 afd rule delete

ルール セット内の既存の配信ルールを削除します。

az afd rule delete [--ids]
                   [--name --rule-name]
                   [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                   [--profile-name]
                   [--resource-group]
                   [--rule-set-name]
                   [--subscription]
                   [--yes]

例

名前 rule1 のルールを削除します。

az afd rule delete -g group --rule-set-name ruleSetName --profile-name profile --rule-name rule1

省略可能のパラメーター

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

--ids

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

プロパティ	値
Parameter group:	Resource Id Arguments

--name --rule-name -n

エンドポイント内で一意である配信ルールの名前。

プロパティ	値
Parameter group:	Resource Id Arguments

--no-wait

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

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

--profile-name

リソース グループ内で一意である Azure Front Door Standard または Azure Front Door Premium プロファイルの名前。

プロパティ	値
Parameter group:	Resource Id Arguments

--resource-group -g

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

プロパティ	値
Parameter group:	Resource Id Arguments

--rule-set-name

プロファイルの下にあるルール セットの名前。

プロパティ	値
Parameter group:	Resource Id Arguments

--subscription

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

プロパティ	値
Parameter group:	Resource Id Arguments

--yes -y

確認を求めないでください。

プロパティ	値
規定値:	False

グローバル パラメーター

--debug

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

プロパティ	値
規定値:	False

--help -h

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

--only-show-errors

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

プロパティ	値
規定値:	False

--output -o

Output format.

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

--query

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

--verbose

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

プロパティ	値
規定値:	False

az afd rule list

ルール セット内の既存の配信ルールをすべて一覧表示します。

az afd rule list --profile-name
                 --resource-group
                 --rule-set-name
                 [--max-items]
                 [--next-token]

例

指定したエンドポイント内のすべてのルートを一覧表示します。

az afd route list -g group --profile-name profile --endpoint-name endpoint1

必須のパラメーター

--profile-name

リソース グループ内で一意である Azure Front Door Standard または Azure Front Door Premium プロファイルの名前。

--resource-group -g

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

--rule-set-name

プロファイルの下にあるルール セットの名前。

省略可能のパラメーター

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

--max-items

コマンドの出力で返される項目の合計数。 使用可能な項目の合計数が指定された値を超える場合は、コマンドの出力にトークンが提供されます。 改ページ位置の変更を再開するには、後続のコマンドの引数 --next-token トークン値を指定します。

プロパティ	値
Parameter group:	Pagination Arguments

--next-token

ページ分割を開始する場所を指定するトークン。 これは、以前に切り捨てられた応答からのトークン値です。

プロパティ	値
Parameter group:	Pagination Arguments

グローバル パラメーター

--debug

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

プロパティ	値
規定値:	False

--help -h

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

--only-show-errors

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

プロパティ	値
規定値:	False

--output -o

Output format.

プロパティ	値
規定値:	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 afd rule show

ルール セット内の既存の配信ルールを取得します。

az afd rule show [--ids]
                 [--name --rule-name]
                 [--profile-name]
                 [--resource-group]
                 [--rule-set-name]
                 [--subscription]

例

名前 rule1 を使用して配信ルールの詳細を表示します。

az afd rule show -g group --rule-set-name ruleSetName --profile-name profile --rule-name rule1

省略可能のパラメーター

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

--ids

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

プロパティ	値
Parameter group:	Resource Id Arguments

--name --rule-name -n

エンドポイント内で一意である配信ルールの名前。

プロパティ	値
Parameter group:	Resource Id Arguments

--profile-name

リソース グループ内で一意である Azure Front Door Standard または Azure Front Door Premium プロファイルの名前。

プロパティ	値
Parameter group:	Resource Id Arguments

--resource-group -g

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

プロパティ	値
Parameter group:	Resource Id Arguments

--rule-set-name

プロファイルの下にあるルール セットの名前。

プロパティ	値
Parameter group:	Resource Id Arguments

--subscription

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

プロパティ	値
Parameter group:	Resource Id Arguments

グローバル パラメーター

--debug

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

プロパティ	値
規定値:	False

--help -h

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

--only-show-errors

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

プロパティ	値
規定値:	False

--output -o

Output format.

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

--query

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

--verbose

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

プロパティ	値
規定値:	False

az afd rule update

指定したルール セット内の新しい配信ルールを更新します。

az afd rule update [--actions]
                   [--add]
                   [--conditions]
                   [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                   [--ids]
                   [--match-processing-behavior {Continue, Stop}]
                   [--name --rule-name]
                   [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                   [--order]
                   [--profile-name]
                   [--remove]
                   [--resource-group]
                   [--rule-set-name]
                   [--set]
                   [--subscription]

省略可能のパラメーター

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

--actions

ルールのすべての条件が満たされたときに実行されるアクションの一覧。 短縮構文、json-file、yaml-file をサポートします。 詳細を表示するには、"??" を試してください。

プロパティ	値
Parameter group:	Properties Arguments

--add

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

プロパティ	値
Parameter group:	Generic Update Arguments

--conditions

実行するアクションに一致する必要がある条件の一覧。短縮構文、json ファイル、yaml-file をサポートします。 詳細を表示するには、"??" を試してください。

プロパティ	値
Parameter group:	Properties Arguments

--force-string

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

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

--ids

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

プロパティ	値
Parameter group:	Resource Id Arguments

--match-processing-behavior

このルールが一致する場合、ルール エンジンは残りのルールを実行し続けるか停止する必要があります。 存在しない場合は、既定で [続行] が選択されます。

プロパティ	値
Parameter group:	Properties Arguments
指定可能な値:	Continue, Stop

--name --rule-name -n

エンドポイント内で一意である配信ルールの名前。

プロパティ	値
Parameter group:	Resource Id Arguments

--no-wait

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

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

--order

エンドポイントにルールが適用される順序。 使用可能な値 {0,1,2,3,ƒÆ'ʆ’ƒ‚Ê'¢ʃÆ'Ê'¢ʃ¢¢€šÂ¬Â...—ƒ‚Â'¬ƒÆ'Â'¬Å○ ƒ‚Â'¦ƒÆ'Å'†â€Âƒâ ™€šÂ'¢ƒÆ'Â'Â'¢ƒ¢€šÂ¬Ê...—ƒ‚Â'¬ƒÆ'Â'¬Å○ ƒ‚Â'¦ƒÆ'Å'†â€Âƒâ ™€šÂ'¢ƒÆ'Â'Â'¢ƒ¢€šÂ¬Ê...  ƒ‚Â'¬ƒÆ'Ê¢â'¬Å○ ƒ‚Â'Âڂ}. 順序が小さいルールは、順序の大きいルールの前に適用されます。 順序 0 のルールは特別なルールです。 条件は不要で、リストに記載されているアクションは常に適用されます。

プロパティ	値
Parameter group:	Properties Arguments

--profile-name

リソース グループ内で一意である Azure Front Door Standard または Azure Front Door Premium プロファイルの名前。

プロパティ	値
Parameter group:	Resource Id Arguments

--remove

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

プロパティ	値
Parameter group:	Generic Update Arguments

--resource-group -g

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

プロパティ	値
Parameter group:	Resource Id Arguments

--rule-set-name

プロファイルの下にあるルール セットの名前。

プロパティ	値
Parameter group:	Resource Id Arguments

--set

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

プロパティ	値
Parameter group:	Generic Update Arguments

--subscription

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

プロパティ	値
Parameter group:	Resource Id Arguments

グローバル パラメーター

--debug

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

プロパティ	値
規定値:	False

--help -h

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

--only-show-errors

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

プロパティ	値
規定値:	False

--output -o

Output format.

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

--query

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

--verbose

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

プロパティ	値
規定値:	False

az afd rule wait

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

az afd rule wait [--created]
                 [--custom]
                 [--deleted]
                 [--exists]
                 [--ids]
                 [--interval]
                 [--name --rule-name]
                 [--profile-name]
                 [--resource-group]
                 [--rule-set-name]
                 [--subscription]
                 [--timeout]
                 [--updated]

省略可能のパラメーター

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

--created

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

プロパティ	値
Parameter group:	Wait Condition Arguments
規定値:	False

--custom

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

プロパティ	値
Parameter group:	Wait Condition Arguments

--deleted

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

プロパティ	値
Parameter group:	Wait Condition Arguments
規定値:	False

--exists

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

プロパティ	値
Parameter group:	Wait Condition Arguments
規定値:	False

--ids

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

プロパティ	値
Parameter group:	Resource Id Arguments

--interval

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

プロパティ	値
Parameter group:	Wait Condition Arguments
規定値:	30

--name --rule-name -n

エンドポイント内で一意である配信ルールの名前。

プロパティ	値
Parameter group:	Resource Id Arguments

--profile-name

リソース グループ内で一意である Azure Front Door Standard または Azure Front Door Premium プロファイルの名前。

プロパティ	値
Parameter group:	Resource Id Arguments

--resource-group -g

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

プロパティ	値
Parameter group:	Resource Id Arguments

--rule-set-name

プロファイルの下にあるルール セットの名前。

プロパティ	値
Parameter group:	Resource Id Arguments

--subscription

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

プロパティ	値
Parameter group:	Resource Id Arguments

--timeout

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

プロパティ	値
Parameter group:	Wait Condition Arguments
規定値:	3600

--updated

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

プロパティ	値
Parameter group:	Wait Condition Arguments
規定値:	False

グローバル パラメーター

--debug

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

プロパティ	値
規定値:	False

--help -h

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

--only-show-errors

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

プロパティ	値
規定値:	False

--output -o

Output format.

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

--query

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

--verbose

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

プロパティ	値
規定値:	False