Условия соответствия в стандартном обработчике правил для Azure CDN

В стандартом обработчике правил для сети доставки содержимого Azure (Azure CDN) правило состоит из одного или нескольких условий соответствия и действия. В этой статье содержатся подробные описания условий соответствия, которые можно использовать в стандартном обработчике правил для Azure CDN.

Первая часть правила — это одно или несколько условий соответствия. В стандартном обработчике правил для Azure CDN у каждого правила может быть не более четырех условий соответствия. Условие соответствия определяет определенные типы запросов, для которых выполняются определенные действия. При использовании нескольких условий соответствия они группируются с помощью логического компонента AND.

Например, с помощью условия соответствия вы сможете:

  • Отфильтровать запросы на основе определенного IP-адреса, страны или региона.
  • Отфильтровать запросы по информации из заголовка.
  • Отфильтровать запросы с мобильных или классических устройств.

Условие соответствия

Для использования в стандартном обработчике правил для Azure CDN доступны перечисленные ниже условия соответствия.

Тип устройства

Определяет запросы, выполненные с мобильного или с классического устройства.

Обязательные поля

Оператор Поддерживаемые значения
Equals, Not equals Классические и мобильные устройства

параметр "Версия HTTP"

Определяет запросы на основе версии HTTP в запросе.

Обязательные поля

Оператор Поддерживаемые значения
Equals, Not equals 2.0, 1.1, 1.0, 0.9, All (все)

Файлы cookies запроса

Определяет запросы на основе данных файла cookie во входящем запросе.

Обязательные поля

Имя файла cookie Оператор Значение файла cookie Преобразование регистра
Строка Список стандартных операторов String, Int Без преобразования, в прописные буквы, в нижний регистр

Основные сведения

  • При указании имени файла cookie нельзя использовать подстановочные знаки, в том числе звездочки (*). Необходимо указать точное имя файла cookie.
  • Для каждого экземпляра этого условия соответствия можно указать только одно имя файла cookie.
  • Сравнение имен файлов cookie выполняется без учета регистра.
  • Чтобы указать несколько имен файлов cookie в качестве значений, перечислите их через пробел.
  • Для значений файлов cookie можно использовать подстановочные знаки.
  • Если подстановочный знак не указан, условие соответствия будет выполнено только при точном совпадении. Например, "Значение" будет соответствовать варианту "Значение", но не "Значение1".

Аргумент POST

Определяет запросы на основе аргументов, определенных для метода запроса POST, который используется в запросе.

Обязательные поля

Имя аргумента Оператор Значение аргумента Преобразование регистра
Строка Список стандартных операторов String, Int Без преобразования, в прописные буквы, в нижний регистр

Строка запроса

Определяет запросы, содержащие указанный параметр строки запроса. Для этого параметра задается значение, соответствующее указанному шаблону. Параметры строки запроса (например, параметр=значение) в URL-адресе запроса определяют, выполнено ли это условие. Это условие соответствия определяет параметр строки запроса по имени и принимает одно или несколько значений для значения параметра.

Обязательные поля

Оператор Строка запроса Преобразование регистра
Список стандартных операторов String, Int Без преобразования, в прописные буквы, в нижний регистр

Удаленный адрес

Определяет запросы на основе расположения или IP-адреса инициатора запроса.

Обязательные поля

Оператор Поддерживаемые значения
Любой Н/Д
Географическое сопоставление Код страны
Сопоставление IP-адресов IP-адрес (с разделителями-пробелами)
Not Any (Не любой) Н/Д
Географическое соответствие отсутствует Код страны
Соответствие 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, который является либо из сетевого подключения, либо, как правило, заголовком запроса с перенаправлением X, если пользователь находится за прокси-сервером.

Тело запроса

Определяет запросы на основе конкретного текста, отображаемого в тексте запроса.

Обязательные поля

Оператор Тело запроса Преобразование регистра
Список стандартных операторов String, Int Без преобразования, в прописные буквы, в нижний регистр

Заголовок запроса

Определяет запросы, которые используют конкретный заголовок в запросе.

Обязательные поля

Имя заголовка Оператор Значение заголовка Преобразование регистра
Строка Список стандартных операторов String, Int Без преобразования, в прописные буквы, в нижний регистр

Метод запроса

Определяет запросы, использующие указанный метод запроса.

Обязательные поля

Оператор Поддерживаемые значения
Equals, Not equals GET, POST, PUT, DELETE, HEAD, OPTIONS, TRACE

Основные сведения

  • Только метод запроса GET может создавать кэшированное содержимое в Azure CDN. Все остальные методы запроса передаются через сеть.

Протокол запроса

Определяет запросы, использующие указанный протокол.

Обязательные поля

Оператор Поддерживаемые значения
Equals, Not equals HTTP, HTTPS

Request URL (URL-адрес запроса)

Определяет запросы, соответствующие указанному URL-адресу.

Обязательные поля

Оператор Request URL (URL-адрес запроса) Преобразование регистра
Список стандартных операторов String, Int Без преобразования, в прописные буквы, в нижний регистр

Основные сведения

  • При использовании этого условия правила не забудьте включить сведения о протоколе. Пример: https://www.<yourdomain>.com.

Расширение файла URL

Определяет запросы, включающие указанное расширение в имени файла в запросе URL-адреса.

Обязательные поля

Оператор Расширение Преобразование регистра
Список стандартных операторов String, Int Без преобразования, в прописные буквы, в нижний регистр

Основные сведения

  • Не используйте точку в начале расширений. Например, используйте HTML вместо .HTML.

Имя файла URL

Определяет запросы, содержащие указанное имя файла в URL-адресе запроса.

Обязательные поля

Оператор Имя файла Преобразование регистра
Список стандартных операторов String, Int Без преобразования, в прописные буквы, в нижний регистр

Основные сведения

  • Чтобы указать несколько имен файлов, перечислите их через пробел.

URL-адрес

Определяет запросы, которые включают указанный путь в URL-адресе запроса.

Обязательные поля

Оператор Значение Преобразование регистра
Список стандартных операторов String, Int Без преобразования, в прописные буквы, в нижний регистр

Основные сведения

  • Для значения имени файла можно использовать подстановочные знаки. Например, каждый шаблон имени файла может содержать одну или несколько звездочек (*), где каждая звездочка соответствует последовательности одного или нескольких знаков.

Справка по условиям соответствия обработчика правил

Список стандартных операторов

Для правил, которые принимают значения из списка стандартных операторов, допустимы следующие операторы:

  • Любой
  • Равно
  • Содержит
  • Начинается с
  • Заканчивается на
  • Меньше чем
  • Меньше или равно
  • Больше
  • Больше или равно
  • Не любое
  • Не содержит
  • Не начинается с
  • Не заканчивается на
  • Не меньше
  • Не меньше или равно
  • Не больше чем
  • Не больше или равно

Для числовых операторов, таких как меньше чем и больше или равно, используется сравнение, основанное на длине. В этом случае значение в условии соответствия должно быть целым числом, равным длине, с которой требуется проводить сравнение.

Дальнейшие действия