az network front-door routing-rule

注意

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

管理 Front Door 路由規則。

命令

az network front-door routing-rule create

建立 Front Door 路由規則。

az network front-door routing-rule delete

刪除 Front Door 路由規則。

az network front-door routing-rule list

列出 Front Door 路由規則。

az network front-door routing-rule show

取得 Front Door 路由規則的詳細資料。

az network front-door routing-rule update

更新 Front Door 路由規則。

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

以空格分隔的前端端點名稱或識別碼清單。

--name -n

路由規則的名稱。

--resource-group -g

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

--route-type

路由類型,以定義 Front Door 如何處理此路由的要求,也就是將它們轉送到後端,或將使用者重新導向至不同的 URL。

接受的值: Forward, Redirect

選擇性參數

--accepted-protocols

要接受的通訊協定空間分隔清單。 預設值:Http。

--backend-pool

後端集區的名稱或識別碼。 建立轉送路由規則是必要的。

--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-指示詞類型 StripAllExcept 或 StripOnly 時,要包含或排除 (逗號分隔) 的查詢參數。

--redirect-protocol

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

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

重新導向流量時,規則將使用的重新導向類型。

接受的值: Found, Moved, PermanentRedirect, TemporaryRedirect
預設值: Moved
--rules-engine

規則引擎組態的名稱或識別碼。 若要取消連結屬性「--remove rulesEngine」。

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> 來設定預設群組。

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> 來設定預設群組。

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> 來設定預設群組。

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 或 JSON 字串 > 。

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

已啟用狀態。

接受的值: Disabled, Enabled
--force-string

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

--forwarding-protocol

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

接受的值: HttpOnly, HttpsOnly, MatchRequest
--frontend-endpoints

以空格分隔的前端端點名稱或識別碼清單。

--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 OR --remove propertyToRemove。

--rules-engine

規則引擎組態的名稱或識別碼。 若要取消連結屬性 「--remove rulesEngine」。

--set

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