az afd rule

管理指定規則集中的傳遞規則。

命令

名稱	Description	類型	狀態
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 Premium 配置檔的名稱，此配置檔在資源群組中是唯一的。

--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。如果啟用壓縮，如果使用者要求壓縮版本，內容將會做為壓縮。要求的內容不會壓縮在 AzureFrontDoorhen 要求的內容小於 1 位元組或大於 1 MB。

接受的值: 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 名稱或識別碼。

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

訂用帳戶的名稱或識別碼。 您可以使用 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]

範例

拿掉名稱規則 1 的規則。

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

選擇性參數

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼，其中包含「資源標識碼」引數的所有資訊。 您應該提供 --ids 或其他「資源識別碼」引數。

--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 Premium 配置檔的名稱，此配置檔在資源群組中是唯一的。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

--rule-set-name

配置檔底下的規則集名稱。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 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

訂用帳戶的名稱或識別碼。 您可以使用 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 Premium 配置檔的名稱，此配置檔在資源群組中是唯一的。

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

訂用帳戶的名稱或識別碼。 您可以使用 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]

範例

顯示名稱規則 1 的傳遞規則詳細數據。

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

選擇性參數

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼，其中包含「資源標識碼」引數的所有資訊。 您應該提供 --ids 或其他「資源識別碼」引數。

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

配置檔底下的規則集名稱。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 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

訂用帳戶的名稱或識別碼。 您可以使用 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-file 和 yaml-file。 請嘗試 “？？” 以顯示更多。

--force-string

使用 'set' 或 'add' 時，請保留字串常值，而不是嘗試轉換成 JSON。

接受的值: 0, 1, f, false, n, no, t, true, y, yes

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼，其中包含「資源標識碼」引數的所有資訊。 您應該提供 --ids 或其他「資源識別碼」引數。

--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 Premium 配置檔的名稱，此配置檔在資源群組中是唯一的。

--remove

從清單中移除屬性或專案。 範例：--remove property.list OR --remove 屬性ToRemove。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

--rule-set-name

配置檔底下的規則集名稱。

--set

指定要設定的屬性路徑和值，以更新物件。 範例：--set property1.property2=。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 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

訂用帳戶的名稱或識別碼。 您可以使用 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

請等候在 'Succeeded' 使用 'provisioningState' 建立。

預設值: False

--custom

等到條件符合自定義 JMESPath 查詢為止。 例如 provisioningState！='InProgress'， instanceView.statuses[？code=='PowerState/running']。

--deleted

等到刪除為止。

預設值: False

--exists

等候資源存在。

預設值: False

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼，其中包含「資源標識碼」引數的所有資訊。 您應該提供 --ids 或其他「資源識別碼」引數。

--interval

輪詢間隔以秒為單位。

預設值: 30

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

配置檔底下的規則集名稱。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 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

訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。