共用方式為


Azure 內容傳遞網路的標準規則引擎中的比對條件

重要

Azure CDN Standard from Microsoft (classic) 將於 2027 年 9 月 30 日淘汰。 為了避免任何服務中斷,請務必在 2027 年 9 月 30 日之前,移轉您的 Azure CDN Standard from Microsoft (classic) 設定檔至 Azure Front Door Standard 或 Premium 層。 如需詳細資訊,請參閱 Azure CDN Standard from Microsoft (classic) 淘汰

在 Azure 內容傳遞網路的標準規則引擎中,規則由一或多個比對條件和一個動作組成。 本文提供您可以在 Azure 內容傳遞網路的標準規則引擎中使用的比對條件詳細描述。

規則的第一個部分是一個比對條件或一組比對條件。 在 Azure 內容傳遞網路的標準規則引擎中,每個規則最多可以有四個比對條件。 比對條件會識別特定類型的要求,以便針對這類要求執行已定義的動作。 如果您使用多個比對條件,則會使用 AND 邏輯將比對條件群組在一起。

例如,您可以使用比對條件:

  • 根據特定 IP 位址或國家/地區來篩選要求。
  • 依標頭資訊篩選要求。
  • 從行動裝置或桌面電腦裝置篩選要求。

比對條件

下列比對條件可用於 Azure 內容傳遞網路中的標準規則引擎。

裝置類型:

識別從行動裝置或傳統型裝置提出的要求。

必填欄位

運算子 支援值
Equals、Not equals 行動、傳統型

HTTP 版本

根據要求的 HTTP 版本識別要求。

必填欄位

運算子 支援值
Equals、Not equals 2.0、1.1、1.0、0.9、All

要求 Cookie

根據傳入要求中的 Cookie 資訊來識別要求。

必填欄位

Cookie 名稱 運算子 Cookie 值 大小寫轉換
String 標準運算子清單 String、Int 不轉換、轉換為大寫、轉換為小寫

重要資訊

  • 指定 Cookie 名稱時不能使用萬用字元值 (包括星號 (*));您必須使用確切的 Cookie 名稱。
  • 只能針對此比對條件的每個執行個體指定一個 Cookie 名稱。
  • Cookie 名稱比較不區分大小寫。
  • 若要指定多個 Cookie 值,請在每個 Cookie 值之間使用單一空格。
  • Cookie 值可以利用萬用字元值。
  • 如果未指定萬用字元值,則只有完全相符才會符合此比對條件。 例如,"Value" 會比對 "Value",但不會比對 "Value1"。

Post 引數

根據針對要求中使用的 POST 要求方法所定義的引數來識別要求。

必填欄位

引數名稱 運算子 引數值 大小寫轉換
String 標準運算子清單 String、Int 不轉換、轉換為大寫、轉換為小寫

查詢字串

識別包含特定查詢字串參數的要求。 這個參數會設定為符合特定模式的值。 要求 URL 中的查詢字串參數 (例如,parameter=value) 會決定是否符合此條件。 此比對條件會依查詢字串參數的名稱來識別查詢字串參數,並接受一個或多個參數值的值。

必填欄位

運算子 查詢字串 大小寫轉換
標準運算子清單 String、Int 不轉換、轉換為大寫、轉換為小寫

遠端位址

根據要求者的位置或 IP 位址來識別要求。

必填欄位

運算子 支援值
任意 N/A
地理位置比對 國碼 (地區碼)
IP 比對 IP 位址 (以空格分隔)
Not Any N/A
非地理位置比對 國碼 (地區碼)
非 IP 比對 IP 位址 (以空格分隔)

重要資訊

  • 使用無類別網域間路由選擇 (CIDR) 標記法。
  • 若要指定多個 IP 位址和 IP 位址區塊,請在值之間使用一個空格:
    • IPv4 範例1.2.3.4 10.20.30.40 會比對來自位址 1.2.3.4 或 10.20.30.40 的任何要求。
    • IPv6 範例1:2:3:4:5:6:7:8 10:20:30:40:50:60:70:80 會比對來自位址 1:2:3:4:5:6:7:8 或 10:20:30:40:50:60:70:80 的任何要求。
  • IP 位址區塊的語法是基底 IP 位址,後面接著正斜線和首碼大小。 例如:
    • IPv4 範例5.5.5.64/26 會比對來自 5.5.5.64 到 5.5.5.127 的任何要求。
    • IPv6 範例1:2:3:/48 會比對來自位址 1:2:3:0:0:0:0:0 到 1:2:3:ffff:ffff:ffff:ffff:ffff 的任何要求。
  • 遠端位址代表的來源用戶端 IP 可能來自網路連線或如果使用者位於 Proxy 後方,則通常是 X-Forwarded-For 要求標頭。

要求本文

根據要求主體中出現的特定文字來識別要求。

必填欄位

運算子 要求本文 大小寫轉換
標準運算子清單 String、Int 不轉換、轉換為大寫、轉換為小寫

要求標頭

識別在要求中使用特定標頭的要求。

必填欄位

標頭名稱 運算子 標頭值 大小寫轉換
String 標準運算子清單 String、Int 不轉換、轉換為大寫、轉換為小寫

Request 方法

識別使用指定要求方法的要求。

必填欄位

運算子 支援值
Equals、Not equals GET、POST、PUT、DELETE、HEAD、OPTIONS、TRACE

重要資訊

  • 只有 GET 要求方法可以在 Azure 內容傳遞網路中產生快取的內容。 所有其他要求方法則是透過網路進行 Proxy 處理。

要求通訊協定

識別使用指定通訊協定的要求。

必填欄位

運算子 支援值
Equals、Not equals HTTP、HTTPS

要求 URL

識別符合指定 URL 的要求。

必填欄位

運算子 要求 URL 大小寫轉換
標準運算子清單 String、Int 不轉換、轉換為大寫、轉換為小寫

重要資訊

  • 當您使用此規則條件時,請務必包含通訊協定資訊。 例如:https://www.<yourdomain>.com

URL 副檔名

識別在要求的 URL 中的檔案名稱中包含指定副檔名的要求。

必填欄位

運算子 副檔名 大小寫轉換
標準運算子清單 String、Int 不轉換、轉換為大寫、轉換為小寫

重要資訊

  • 例如,請勿包含前置句號;例如,使用 htm 而非 .htm

URL 檔案名稱

識別在要求的 URL 中包含指定檔案名稱的要求。

必填欄位

運算子 File name 大小寫轉換
標準運算子清單 String、Int 不轉換、轉換為大寫、轉換為小寫

重要資訊

  • 若要指定多個檔案名稱,請使用單一空格來分隔每個檔案名稱。

URL 路徑

識別在要求的 URL 中包含指定路徑的要求。

必填欄位

運算子 大小寫轉換
標準運算子清單 String、Int 不轉換、轉換為大寫、轉換為小寫

重要資訊

  • 檔案名稱值可以使用萬用字元值。 例如,每個檔案名稱模式可包含一個或多個星號 (*),其中每個星號都符合一個或多個字元序列。

規則引擎比對條件的參考

標準運算子清單

如果規則可接受標準運算子清單中的值,則有效的運算子如下:

  • 任意
  • Equals
  • 包含
  • 開頭為
  • 結尾是
  • 小於
  • Less than or equals
  • 大於
  • Greater than or equals
  • Not any
  • 不包含
  • Not begins with
  • Not ends with
  • Not less than
  • Not less than or equals
  • Not greater than
  • Not greater than or equals

對於 Less thanGreater than or equals 之類的數值運算子,所使用的比較會以長度為基礎。 在此情況下,比對條件中的值應為等於所要比較長度的整數。

下一步