az network front-door rules-engine rule action

注意

此參考是 Azure CLI 前端延伸模組的一部分(2.0.68 版或更高版本)。 擴充功能會在您第一次執行 az network front-door rules-engine rule action 命令時自動安裝。 深入了解擴充功能。

管理 Front Door 的規則引擎動作。

命令

名稱 Description 類型 狀態
az network front-door rules-engine rule action add

將動作新增至規則引擎規則。

副檔名 GA
az network front-door rules-engine rule action list

顯示適用於規則引擎規則的所有動作。

副檔名 GA
az network front-door rules-engine rule action remove

從規則引擎規則中移除動作。

副檔名 GA

az network front-door rules-engine rule action add

將動作新增至規則引擎規則。

az network front-door rules-engine rule action add --action-type {ForwardRouteOverride, RedirectRouteOverride, RequestHeader, ResponseHeader}
                                                   --front-door-name
                                                   --name
                                                   --resource-group
                                                   --rules-engine-name
                                                   [--backend-pool]
                                                   [--cache-duration]
                                                   [--caching {Disabled, Enabled}]
                                                   [--custom-forwarding-path]
                                                   [--custom-fragment]
                                                   [--custom-host]
                                                   [--custom-path]
                                                   [--custom-query-string]
                                                   [--dynamic-compression {Disabled, Enabled}]
                                                   [--forwarding-protocol {HttpOnly, HttpsOnly, MatchRequest}]
                                                   [--header-action {Append, Delete, Overwrite}]
                                                   [--header-name]
                                                   [--header-value]
                                                   [--query-parameter-strip-directive {StripAll, StripAllExcept, StripNone, StripOnly}]
                                                   [--query-parameters]
                                                   [--redirect-protocol {HttpOnly, HttpsOnly, MatchRequest}]
                                                   [--redirect-type {Found, Moved, PermanentRedirect, TemporaryRedirect}]

必要參數

--action-type

要套用規則的動作類型。

接受的值: ForwardRouteOverride, RedirectRouteOverride, RequestHeader, ResponseHeader
--front-door-name -f

Front Door 的名稱。

--name -n

規則的名稱。

--resource-group -g

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

--rules-engine-name -r

規則引擎的名稱。

選擇性參數

--backend-pool

後端集區的名稱或識別碼。

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

用於轉送流量的通訊協定。

接受的值: HttpOnly, HttpsOnly, MatchRequest
--header-action

要求的標頭動作類型。

接受的值: Append, Delete, Overwrite
--header-name

要修改的標頭名稱。

--header-value

標頭的值。

--query-parameter-strip-directive

在形成快取索引鍵時處理 URL 查詢字詞。

接受的值: StripAll, StripAllExcept, StripNone, StripOnly
--query-parameters

分別使用 query-parameter-strip-指示詞類型 StripAllExcept 或 StripOn 時,要包含或排除的查詢參數(逗號分隔)。

--redirect-protocol

將流量重新導向目的地的通訊協定。

接受的值: HttpOnly, HttpsOnly, MatchRequest
預設值: MatchRequest
--redirect-type

重新導向類型,規則會在重新導向流量時使用。

接受的值: Found, Moved, PermanentRedirect, TemporaryRedirect
預設值: Moved
全域參數
--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 network front-door rules-engine rule action list

顯示適用於規則引擎規則的所有動作。

az network front-door rules-engine rule action list --front-door-name
                                                    --name
                                                    --resource-group
                                                    --rules-engine-name

必要參數

--front-door-name -f

Front Door 的名稱。

--name -n

規則的名稱。

--resource-group -g

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

--rules-engine-name -r

規則引擎的名稱。

全域參數
--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 network front-door rules-engine rule action remove

從規則引擎規則中移除動作。

az network front-door rules-engine rule action remove --action-type {ForwardRouteOverride, RedirectRouteOverride, RequestHeader, ResponseHeader}
                                                      --front-door-name
                                                      --name
                                                      --resource-group
                                                      --rules-engine-name
                                                      [--index]

必要參數

--action-type

要套用規則的動作類型。

接受的值: ForwardRouteOverride, RedirectRouteOverride, RequestHeader, ResponseHeader
--front-door-name -f

Front Door 的名稱。

--name -n

規則的名稱。

--resource-group -g

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

--rules-engine-name -r

規則引擎的名稱。

選擇性參數

--index

要移除之要求或響應標頭動作的 0 型索引。 “ForwardRouteOverride” 或 “RedirectRouteOverride” 動作移除不需要 Index 參數。

全域參數
--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 來取得完整偵錯記錄。