az afd rule

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

コマンド

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

az afd rule create

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

az afd rule create --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 プレミアム プロファイルの名前。

--resource-group -g

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

--rule-set-name

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

省略可能のパラメーター

--action-name

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

--cache-behavior

要求のキャッシュ動作。

--cache-duration

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

--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 です。圧縮が有効になっている場合、ユーザーが圧縮バージョンを要求した場合、コンテンツは圧縮として処理されます。要求されたコンテンツが 1 バイトより小さいか、1 MB (メガバイト)より大きい場合、コンテンツは AzureFrontDoorwhen で圧縮されません。

承認された値: 0, 1, f, false, n, no, t, true, y, yes

--forwarding-protocol

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

--header-action

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

--header-name

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

--header-value

ヘッダーの値。

--match-processing-behavior

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

承認された値: Continue, Stop

既定値: Continue

--match-values

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

--match-variable

一致条件の名前: https://docs.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 のルールは特別なルールです。 条件は不要で、リストに記載されているアクションは常に適用されます。

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

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

--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 afd rule delete

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

az afd rule delete [--ids]
                   [--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

省略可能のパラメーター

--ids

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

--name --rule-name -n

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

--no-wait

実行時間の長い操作の終了を待機しません。

承認された値: 0, 1, f, false, n, no, t, true, y, yes

--profile-name

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

--resource-group -g

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

--rule-set-name

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

--subscription

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

--yes -y

確認のダイアログを表示しません。

既定値: False

グローバル パラメーター

--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 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 プレミアム プロファイルの名前。

--resource-group -g

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

--rule-set-name

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

省略可能のパラメーター

--max-items

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

--next-token

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

グローバル パラメーター

--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 afd rule show

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

az afd rule show [--ids]
                 [--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

省略可能のパラメーター

--ids

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

--name --rule-name -n

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

--profile-name

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

--resource-group -g

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

--rule-set-name

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

--subscription

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

グローバル パラメーター

--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 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]
                   [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                   [--order]
                   [--profile-name]
                   [--remove]
                   [--resource-group]
                   [--rule-set-name]
                   [--set]
                   [--subscription]

省略可能のパラメーター

--actions

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

--add

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

--conditions

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

--force-string

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

承認された値: 0, 1, f, false, n, no, t, true, y, yes

--ids

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

--match-processing-behavior

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

承認された値: Continue, Stop

--name --rule-name -n

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

--no-wait

実行時間の長い操作の終了を待機しません。

承認された値: 0, 1, f, false, n, no, t, true, y, yes

--order

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

--profile-name

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

--remove

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

--resource-group -g

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

--rule-set-name

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

--set

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

--subscription

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

グローバル パラメーター

--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 afd rule wait

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

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

省略可能のパラメーター

--created

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

既定値: False

--custom

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

--deleted

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

既定値: False

--exists

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

既定値: False

--ids

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

--interval

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

既定値: 30

--name --rule-name -n

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

--profile-name

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

--resource-group -g

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

--rule-set-name

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

--subscription

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

--timeout

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

既定値: 3600

--updated

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

既定値: False

グローバル パラメーター

--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 を使います。