az cdn endpoint rule

預覽
參考

此命令群組處於預覽狀態，且正在開發中。參考和支持層級：https://aka.ms/CLI_refstatus

管理端點的傳遞規則。

命令

名稱	Description	類型	狀態
az cdn endpoint rule action	管理端點的傳遞規則動作。	核心	預覽
az cdn endpoint rule action add	將動作新增至傳遞規則。	核心	預覽
az cdn endpoint rule action remove	從傳遞規則移除動作。	核心	預覽
az cdn endpoint rule action show	使用端點顯示傳遞規則。	核心	預覽
az cdn endpoint rule add	將傳遞規則新增至CDN端點。	核心	預覽
az cdn endpoint rule condition	管理端點的傳遞規則條件。	核心	預覽
az cdn endpoint rule condition add	將條件新增至傳遞規則。	核心	預覽
az cdn endpoint rule condition remove	從傳遞規則中移除條件。	核心	預覽
az cdn endpoint rule condition show	顯示與端點相關聯的傳遞規則。	核心	預覽
az cdn endpoint rule remove	從端點移除傳遞規則。	核心	預覽
az cdn endpoint rule show	顯示與端點相關聯的傳遞規則。	核心	預覽

az cdn endpoint rule add

編輯

預覽

命令群組「cdn 端點規則」處於預覽狀態，且正在開發中。參考和支持層級：https://aka.ms/CLI_refstatus

將傳遞規則新增至CDN端點。

az cdn endpoint rule add --action-name {CacheExpiration, CacheKeyQueryString, ModifyRequestHeader, ModifyResponseHeader, OriginGroupOverride, UrlRedirect, UrlRewrite}
                         --order
                         [--cache-behavior {BypassCache, Override, SetIfMissing}]
                         [--cache-duration]
                         [--custom-fragment]
                         [--custom-hostname]
                         [--custom-path]
                         [--custom-querystring]
                         [--destination]
                         [--header-action {Append, Delete, Overwrite}]
                         [--header-name]
                         [--header-value]
                         [--ids]
                         [--match-values]
                         [--match-variable {ClientPort, Cookies, HostName, HttpVersion, IsDevice, PostArgs, QueryString, RemoteAddress, RequestBody, RequestHeader, RequestMethod, RequestScheme, RequestUri, ServerPort, SocketAddr, SslProtocol, UrlFileExtension, UrlFileName, UrlPath}]
                         [--name]
                         [--negate-condition {false, true}]
                         [--operator]
                         [--origin-group]
                         [--preserve-unmatched-path {false, true}]
                         [--profile-name]
                         [--query-parameters]
                         [--query-string-behavior {Exclude, ExcludeAll, Include, IncludeAll}]
                         [--redirect-protocol {Http, Https, MatchRequest}]
                         [--redirect-type {Found, Moved, PermanentRedirect, TemporaryRedirect}]
                         [--resource-group]
                         [--rule-name]
                         [--selector]
                         [--source-pattern]
                         [--subscription]
                         [--transform {Lowercase, Uppercase}]

範例

建立全域規則以停用快取。

az cdn endpoint rule add -g group -n endpoint --profile-name profile --order 0 --rule-name global --action-name CacheExpiration --cache-behavior BypassCache

建立 HTTP 至 HTTPs 重新導向的規則。

az cdn endpoint rule add -g group -n endpoint --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

建立規則，將URL路徑中具有「/test1」的要求散發至名稱為「origingroup1」的來源群組。

az cdn endpoint rule add -g group -n endpoint --profile-name profile --order 1 --rule-name "origin-group-override" --match-variable UrlPath --operator Contains --match-values /test1 --action-name "OriginGroupOverride" --origin-group origingroup1

必要參數

--action-name

傳遞規則的動作名稱：https://learn.microsoft.com/en-us/azure/cdn/cdn-standard-rules-engine-actions。

接受的值: CacheExpiration, CacheKeyQueryString, ModifyRequestHeader, ModifyResponseHeader, OriginGroupOverride, UrlRedirect, UrlRewrite

--order

為端點套用規則的順序。可能的值 {0,1,2,3,.........}。具有較低順序的規則將會套用至較高順序的規則。具有順序 0 的規則是特殊規則。它不需要任何條件，而且一律會套用其中所列的動作。

選擇性參數

--cache-behavior

要求的快取行為。

接受的值: BypassCache, Override, SetIfMissing

--cache-duration

需要快取內容的持續時間。允許的格式為 hh：mm：ss.xxxxxx。

--custom-fragment

要新增至重新導向 URL 的片段。

--custom-hostname

要重新導向的主機。保留空白，以使用傳入主機作為目的地主機。

--custom-path

要重新導向的完整路徑。路徑不可以是空的，而且必須以 /開頭。保留空白，以使用傳入路徑作為目的地路徑。

--custom-querystring

要放在重新導向 URL 中的查詢字串集。保留空白以保留傳入查詢字串。

--destination

要用於重寫的目的地路徑。

--header-action

要求的標頭動作。

接受的值: Append, Delete, Overwrite

--header-name

要修改的標頭名稱。

--header-value

標頭的值。

--ids

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

--match-values

比對條件的值。例如，空格分隔值「GET」 “HTTP”。

--match-variable

比對條件的名稱：https://learn.microsoft.com/en-us/azure/cdn/cdn-standard-rules-engine-match-conditions。

接受的值: ClientPort, Cookies, HostName, HttpVersion, IsDevice, PostArgs, QueryString, RemoteAddress, RequestBody, RequestHeader, RequestMethod, RequestScheme, RequestUri, ServerPort, SocketAddr, SslProtocol, UrlFileExtension, UrlFileName, UrlPath

--name -n

CDN 端點的名稱。

--negate-condition

如果為 true，則否定條件。

接受的值: false, true

--operator

比對條件的運算符。

--origin-group

會覆寫預設 OriginGroup 的 OriginGroup 名稱或識別碼。

--preserve-unmatched-path

如果為 True，來源模式之後的剩餘路徑將會附加至新的目的地路徑。

接受的值: false, true

--profile-name

資源群組內唯一的CDN配置檔名稱。

--query-parameters

查詢要包含或排除的參數（以逗號分隔）。

--query-string-behavior

要求的查詢字串行為。

接受的值: Exclude, ExcludeAll, Include, IncludeAll

--redirect-protocol

要用於重新導向的通訊協定。

接受的值: Http, Https, MatchRequest

--redirect-type

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

接受的值: Found, Moved, PermanentRedirect, TemporaryRedirect

--resource-group -g

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

--rule-name

規則的名稱，僅適用於Microsoft SKU。

--selector

比對條件的選取器。

--source-pattern

識別可能重寫之要求類型的要求 URI 模式。

--subscription

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

--transform

在比對之前要套用的轉換。

接受的值: Lowercase, Uppercase

全域參數

--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 cdn endpoint rule remove

編輯

預覽

命令群組「cdn 端點規則」處於預覽狀態，且正在開發中。參考和支持層級：https://aka.ms/CLI_refstatus

從端點移除傳遞規則。

az cdn endpoint rule remove [--ids]
                            [--name]
                            [--order]
                            [--profile-name]
                            [--resource-group]
                            [--rule-name]
                            [--subscription]

範例

拿掉全域規則。

az cdn endpoint rule remove -g group -n endpoint --profile-name profile --rule-name Global

使用順序 4 移除規則。

az cdn endpoint rule remove -g group -n endpoint --profile-name profile --order 4

選擇性參數

--ids

--name -n

CDN 端點的名稱。

--order

--profile-name

資源群組內唯一的CDN配置檔名稱。

--resource-group -g

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

--rule-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 cdn endpoint rule show

編輯

預覽

命令群組「cdn 端點規則」處於預覽狀態，且正在開發中。參考和支持層級：https://aka.ms/CLI_refstatus

顯示與端點相關聯的傳遞規則。

az cdn endpoint rule show [--ids]
                          [--name]
                          [--profile-name]
                          [--resource-group]
                          [--subscription]

範例

顯示與端點相關聯的傳遞規則。

az cdn endpoint rule show -g group -n endpoint --profile-name profile

選擇性參數

--ids

--name -n

CDN 端點的名稱。

--profile-name

資源群組內唯一的CDN配置檔名稱。

--resource-group -g

資源組名。您可以使用 az configure --defaults group=<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 cdn endpoint rule

命令

az cdn endpoint rule add

範例

必要參數

選擇性參數

az cdn endpoint rule remove

範例

選擇性參數

az cdn endpoint rule show

範例

選擇性參數

其他資源