Поделиться через


Условия соответствия правилам

В наборах правил Azure Front Door одно правило включает одно или несколько условий соответствия и действие. В этой статье приводятся подробные описания условий фильтрации (match conditions), которые можно использовать в наборах правил Azure Front Door.

Внимание

Azure Front Door (классическая версия) будет прекращена 31 марта 2027 г. Чтобы избежать нарушений работы служб, важно перенести профили Azure Front Door (классический) на уровень Azure Front Door standard или Premium к марту 2027 года. Дополнительные сведения см. в статье Azure Front Door (классическая версия) снятие с эксплуатации.

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

Правило начинается с условия соответствия или набора условий соответствия. Правило может содержать до 10 условий соответствия. Условие соответствия определяет определенные типы запросов, для которых выполняются определенные действия. Если вы используете несколько условий соответствия, они группируются вместе с помощью логики AND. Для условий соответствия, поддерживающих несколько значений, используется логика OR.

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

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

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

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

Свойства

Свойство Поддерживаемые значения
Оператор
  • На портале Azure: Equal, Not Equal
  • В шаблонах ARM: Equal; используйте свойство negateCondition, чтобы указать Не равно
Значение Mobile, Desktop

Пример

В этом примере мы сопоставляем все запросы, обнаруженные как поступающие с мобильного устройства.

Снимок экрана портала с условием соответствия типу устройства.

Версия HTTP

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

Примечание.

Условие соответствия версии HTTP доступно только в Azure Front Door уровня "Стандартный" и выше.

Свойства

Свойство Поддерживаемые значения
Оператор
  • На портале Azure: Equal, Not Equal
  • В шаблонах ARM: Equal; используйте свойство negateCondition, чтобы указать Не равно
Значение 2.0, 1.1, 1.0, 0.9

Пример

В этом примере мы сопоставляем все запросы, отправленные с помощью протокола HTTP 2.0.

Снимок экрана портала с условием соответствия версии HTTP.

Запрос файлов cookie

Используйте условие сопоставления файлов cookie для идентификации запросов, включающих определенный файл cookie.

Примечание.

Условие совпадения для файлов cookie запроса доступно только в Azure Front Door стандартного или премиум уровня.

Свойства

Свойство Поддерживаемые значения
Имя файла cookie Строковое значение, представляющее имя файла cookie.
Оператор Любой оператор из списка стандартных операторов.
Значение Одно или несколько строковых или целочисленных значений, представляющих собой значение заголовка запроса для сопоставления. Если указано несколько значений, они оцениваются с помощью логики OR.
Преобразование регистра Любое преобразование из стандартного списка преобразований строк.

Пример

В этом примере мы сопоставляем все запросы с именем cookie deploymentStampId с значением 1.

Снимок экрана портала с условием соответствия файлов cookie запроса.

Аргументы POST

Используйте условие совпадения аргументов POST для распознавания запросов на основе аргументов, указанных в тексте запроса POST. Одно условие соответствия сопоставляется с одним аргументом из текста запроса POST. Можно указать несколько значений для сопоставления, которые можно объединить с помощью логики OR.

Примечание.

Условие соответствия аргументы POST работает с типом содержимого application/x-www-form-urlencoded.

Свойства

Свойство Поддерживаемые значения
Параметры POST Строковое значение, представляющее имя аргумента POST.
Оператор Любой оператор из списка стандартных операторов.
Значение Одно или несколько строковых или целочисленных значений, представляющих значение аргумента POST для сопоставления. Если указано несколько значений, они оцениваются с помощью логики OR.
Преобразование регистра Любое преобразование из стандартного списка преобразований строк.

Пример

В этом примере сопоставляются все запросы POST, где аргумент customerName указан в тексте запроса и где значение customerName начинается с буквы J или K. Используем преобразование регистра для перевода входных значений в верхний регистр, чтобы значения, начинающиеся с J, j, K и k, соответствовали условию.

Снимок экрана портала, где аргументы POST соответствуют условию.

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

Используйте соответствие условия строке запроса для обнаружения запросов, содержащих конкретную строку запроса. Можно указать несколько значений для сопоставления, которые можно объединить с помощью логики OR.

Примечание.

Вся строка запроса сопоставляется как одна строка без начального символа ?.

Свойства

Свойство Поддерживаемые значения
Оператор Поддерживаются все операторы из списка стандартных операторов. Однако условие Любое соответствует каждому запросу, в то время как условие Не любое не соответствует ни одному запросу, когда используется с условием сопоставления по строке запроса.
Строка запроса Одно или несколько строковых или целочисленных значений, представляющих значение строки запроса для сопоставления. Не включайте знак ? в начале строки запроса. Если указано несколько значений, они оцениваются с помощью логики OR.
Преобразование регистра Любое преобразование из стандартного списка преобразований строк.

Пример

В этом примере будут сопоставляться все запросы, в которых строка запроса содержит строку language=en-US. Мы хотим, чтобы условие соответствия учитывало регистр, поэтому регистр не преобразуется.

Снимок экрана портала со строкой запроса, соответствующей условию.

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

Условие сопоставления удаленных адресов определяет запросы на основе расположения или IP-адреса запрашивающей стороны. Можно указать несколько значений для сопоставления, которые можно объединить с помощью логики OR.

  • Используйте нотацию CIDR при указании блоков IP-адресов. Синтаксис блока 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-адресов и блоков IP-адресов применяется логика "OR".
    • Пример IPv4. Если добавить два IP-адреса 1.2.3.4 и 10.20.30.40, условие будет сопоставляться для любых запросов, поступивших либо с адреса 1.2.3.4, либо 10.20.30.40.
    • Пример IPv6. Если вы добавите два IP-адреса 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-адрес клиента, полученный из сетевого подключения или, как правило, из заголовка запроса X-Forwarded-For, если пользователь находится за прокси-сервером. Используйте условие соответствия адреса сокета (функция доступна для ценовых уровней "Стандартный" и "Премиум"), если вам нужно сопоставить IP-адрес TCP-запроса.

Свойства

Свойство Поддерживаемые значения
Оператор
  • На портале Azure: Geo Match, Geo Not Match, IP Match или IP Not Match
  • В шаблонах ARM: GeoMatch , IPMatch; используйте свойство negateCondition, чтобы указать несоответствие георасположению или несоответствие IP-адресу.
Значение
  • Для операторов IP Match или IP Not Match: задайте один или несколько диапазонов IP-адресов. Если указано несколько диапазонов IP-адресов, они оцениваются с использованием логики OR.
  • Для операторов Geo Match или Geo Not Match: задайте одно или несколько расположений, используя код страны.

Пример

В этом примере мы сопоставляем все запросы, в которых запрос не был получен из США.

Снимок экрана портала, где удаленный адрес соответствует условию.

Текст запроса

Условие соответствия тексту запроса определяет запросы на основе конкретного текста, отображаемого в тексте запроса. Можно указать несколько значений для сопоставления, которые можно объединить с помощью логики OR.

Примечание.

Если текст запроса превышает 64 КБ, для соответствия условию в тексте запроса будет учитываться только первые 64 КБ.

Свойства

Свойство Поддерживаемые значения
Оператор Поддерживаются все операторы из списка стандартных операторов. Однако условие Любое соответствует каждому запросу, а условие Не любое не соответствует ни одному запросу, если они используются с условием соответствия телу запроса.
Значение Одно или несколько строковых или целочисленных значений, представляющих собой значение текста запроса для сопоставления. Если указано несколько значений, они оцениваются с помощью логики OR.
Преобразование регистра Любое преобразование из стандартного списка преобразований строк.

Пример

В этом примере будут сопоставляться все запросы, в которых текст запроса содержит строку ERROR. Перед оценкой соответствия мы преобразуем текст запроса в верхний регистр, поэтому error и другие варианты регистра также активируют это условие соответствия.

Снимок экрана портала, где текст запроса соответствует условию.

Имя файла запроса

Условие соответствия запросу имени файла определяет запросы, включающие в себя указанное имя файла в URL-адресе запроса. Можно указать несколько значений для сопоставления, которые можно объединить с помощью логики OR.

Свойства

Свойство Поддерживаемые значения
Оператор Поддерживаются все операторы из списка стандартных операторов. Однако условие Любое соответствует каждому запросу, а условие Не Любое не соответствует ни одному запросу при использовании с условием соответствия имени файла запроса.
Значение Одно или несколько строковых или целочисленных значений представляют собой значение имени файла в запросе для сопоставления. Если указано несколько значений, они оцениваются с помощью логики OR.
Преобразование регистра Любое преобразование из стандартного списка преобразований строк.

Пример

В этом примере сопоставляются все запросы, в которых имя файла в запросе является media.mp4. Перед оценкой соответствия мы преобразуем имя файла в нижний регистр, поэтому MEDIA.MP4 и другие варианты регистра также активируют это условие соответствия.

Снимок экрана портала, где имя файла в запросе соответствует условию.

Расширение файла запроса

Условие соответствия запросу расширения файла определяет запросы, включающие в себя указанное расширение файла в URL-адресе запроса. Можно указать несколько значений для сопоставления, которые можно объединить с помощью логики OR.

Примечание.

Не включайте стоящую в начале точку. Например, используйте функцию html вместо .html.

Свойства

Свойство Поддерживаемые значения
Оператор Поддерживаются все операторы из списка стандартных операторов. Однако Любое условие совпадения соответствует каждому запросу, а Не Любое условие совпадения не соответствует ни одному запросу, если оно используется с условием совпадения расширения файла запроса.
Значение Одно или несколько строковых или целочисленных значений, представляющих собой значение расширения файла в запросе для сопоставления. Не включайте точку в начале. Если указано несколько значений, они оцениваются с помощью логики OR.
Преобразование регистра Любое преобразование из стандартного списка преобразований строк.

Пример

В этом примере сопоставляются все запросы, в которых расширение файла в запросе является pdf или docx. Мы преобразуем расширение файла запроса в нижний регистр перед оценкой соответствия, поэтому PDFDocXи другие варианты регистра также активируют это условие соответствия.

Снимок экрана портала, где расширение файла в запросе соответствует условию.

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

Условие соответствия заголовку запроса определяет запросы, включающие в себя конкретный заголовок в запросе. Вы можете использовать это условие соответствия, чтобы проверить, существует ли заголовок, или проверить, соответствует ли заголовок указанному значению. Можно указать несколько значений для сопоставления, которые можно объединить с помощью логики OR.

Свойства

Свойство Поддерживаемые значения
Имя заголовка Строковое значение, представляющее имя аргумента POST.
Оператор Любой оператор из списка стандартных операторов.
Значение Одно или несколько строковых или целочисленных значений, представляющих собой значение заголовка запроса для сопоставления. Если указано несколько значений, они оцениваются с помощью логики OR.
Преобразование регистра Любое преобразование из стандартного списка преобразований строк.

Пример

В этом примере сопоставлены все запросы, в которых запрос содержит заголовок с именем MyCustomHeader, независимо от его значения.

Снимок экрана портала, где заголовок запроса соответствует условию.

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

Условие соответствия методу запроса определяет запросы, использующие указанный метод HTTP-запроса. Можно указать несколько значений для сопоставления, которые можно объединить с помощью логики OR.

Свойства

Свойство Поддерживаемые значения
Оператор
  • На портале Azure: Equal, Not Equal
  • В шаблонах ARM: Equal; используйте свойство negateCondition, чтобы указать Не равно
Метод запроса Один или несколько методов HTTP из: GET , POST, PUT, DELETE, HEAD, OPTIONS, TRACE. Если указано несколько значений, они оцениваются с помощью логики OR.

Пример

В этом примере сопоставляются все запросы, где в запросе используется метод DELETE.

Снимок экрана портала, где метод запроса соответствует условию.

Путь запроса

Условие соответствия пути запроса определяет запросы, содержащие указанный путь в URL-адресе запроса. Можно указать несколько значений для сопоставления, которые можно объединить с помощью логики OR.

Примечание.

Путь является частью URL-адреса после имени узла и слэша. Например, в URL-адресе https://www.contoso.com/files/secure/file1.pdf, путь — это files/secure/file1.pdf.

Свойства

Свойство Поддерживаемые значения
Оператор
  • Поддерживаются все операторы из списка стандартных операторов. Однако условие 'Любой' соответствует каждому запросу, а условие 'Не любой' не соответствует ни одному запросу при использовании с условием сопоставления пути запроса.
  • Подстановочный знак: соответствует, если путь запроса соответствует выражению подстановочного знака. Выражение с подстановочным знаком может содержать символ *, для соответствия нулю или более символам в пути. Например, выражение files/customer*/file.pdf подстановочного знака соответствует путям files/customer1/file.pdf, files/customer109/file.pdf, и files/customer/file.pdf, но не соответствует files/customer2/anotherfile.pdf.
    • На портале Azure Wildcards, Not Wildcards
    • В шаблонах ARM: Wildcard; используйте свойство negateCondition, чтобы указать Не подстановочные знаки.
Значение Одно или несколько строковых или целочисленных значений, представляющих значение пути запроса для сопоставления. При указании начальной косой черты он игнорируется. Если указано несколько значений, они оцениваются с помощью логики OR.
Преобразование регистра Любое преобразование из стандартного списка преобразований строк.
Свойство Поддерживаемые значения
Оператор Поддерживаются все операторы из списка стандартных операторов. Однако условие Любое соответствует каждому запросу, а условие Не Любое не соответствует ни одному запросу, когда используется с условием соответствия пути запроса.
Значение Одно или несколько строковых или целочисленных значений, представляющих собой значения пути запроса для сопоставления. При указании начальной косой черты он игнорируется. Если указано несколько значений, они оцениваются с помощью логики OR.
Преобразование регистра Любое преобразование из стандартного списка преобразований строк.

Пример

В этом примере сопоставляются все запросы, где путь к файлу в запросе начинается с files/secure/. Перед оценкой соответствия мы преобразуем расширение файла запроса в нижний регистр, поэтому запросы к files/SECURE/ и другим вариантам регистра также активируют это условие соответствия.

Снимок экрана портала, где путь запроса соответствует условию.

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

Условие соответствия протоколу запроса определяет запросы, использующие указанный протокол (HTTP или HTTPS).

Примечание.

Протокол иногда также называется схемой.

Свойства

Свойство Поддерживаемые значения
Оператор
  • На портале Azure Equal, Not Equal
  • В шаблонах ARM: Equal; используйте свойство negateCondition, чтобы указать Не равно
Метод запроса HTTP, HTTPS

Пример

В этом примере сопоставляются все запросы, где в запросе используется протокол HTTP.

Снимок экрана портала, где протокол запроса соответствует условию.

Запросить URL-адрес

Определяет запросы, соответствующие указанному URL-адресу. Вычисляется весь URL-адрес, включая протокол и строку запроса, а не его фрагмент. Можно указать несколько значений для сопоставления, которые можно объединить с помощью логики OR.

Совет

При использовании этого условия правила обязательно укажите протокол и прямую косую черту /. Например, используйте https://www.contoso.com/, а не только www.contoso.com.

Свойства

Свойство Поддерживаемые значения
Оператор Поддерживаются все операторы из списка стандартных операторов. Однако условие "Любое" соответствует каждому запросу, а условие "Не любое" не соответствует ни одному запросу при использовании с условием соответствия URL-адреса запроса.
Значение Одно или несколько строковых или целочисленных значений, представляющие значение URL запроса для сопоставления. Если указано несколько значений, они оцениваются с помощью логики OR.
Преобразование регистра Любое преобразование из стандартного списка преобразований строк.

Пример

В этом примере сопоставляются все запросы, где URL-адрес запроса начинается с https://api.contoso.com/customers/123. Перед вычислением совпадения расширение файла в запросе преобразуется в нижний регистр, чтобы запросы https://api.contoso.com/Customers/123 и другие варианты регистра также приводили к срабатыванию этого условия соответствия.

Снимок экрана портала, где URL-адрес запроса соответствует условию.

Имя хоста

Условие соответствия имени узла определяет запросы на основе указанного имени узла в запросе от клиента. Условие соответствия использует значение заголовка Host для оценки имени узла. Можно указать несколько значений для сопоставления, которые можно объединить с помощью логики OR.

Свойства

Свойство Поддерживаемые значения
Оператор Поддерживаются все операторы из списка стандартных операторов. Однако условие "Любое" соответствует каждому запросу, а условие "Не любое" не соответствует ни одному запросу при использовании с условием соответствия имени узла.
Значение Одно или несколько строковых значений, представляющих значение имени узла запроса для сопоставления. Если указано несколько значений, они оцениваются с помощью логики OR.
Преобразование регистра Любое преобразование регистра из стандартного списка преобразований строк.

Пример

В этом примере мы сопоставляем все запросы с заголовком Host, который заканчивается на contoso.com.

Снимок экрана портала, показывающий условие соответствия имени хоста.

Протокол SSL

Условие совпадения протокола SSL определяет запросы на основе протокола SSL установленного TLS-подключения. Можно указать несколько значений для сопоставления, которые можно объединить с помощью логики OR.

Свойства

Свойство Поддерживаемые значения
Оператор
  • На портале Azure: Equal, Not Equal
  • В шаблонах ARM: Equal; используйте свойство negateCondition, чтобы указать Не равно
Протокол SSL
  • На портале Azure: 1.0, 1.1, 1.2
  • В шаблонах ARM: TLSv1, TLSv1.1, TLSv1.2

Пример

В этом примере мы сопоставляем все запросы, использующие протокол TLS 1.2.

Снимок экрана портала, показывающий условие соответствия протокола SSL.

Адрес сокета

Условие соответствия адреса сокета определяет запросы на основе IP-адреса прямого подключения к периферии Azure Front Door. Можно указать несколько значений для сопоставления, которые можно объединить с помощью логики OR.

Примечание.

Если клиент использовал прокси-сервер HTTP или подсистему балансировки нагрузки для отправки запроса, адрес сокета — это IP-адрес прокси-сервера или подсистемы балансировки нагрузки.

Используйте условие соответствия удаленного адреса, если вам нужно сопоставить на основе исходного IP-адреса клиента.

  • Используйте нотацию CIDR при указании блоков IP-адресов. Это означает, что синтаксис блока 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.ffff.
  • При указании нескольких IP-адресов и блоков IP-адресов применяется логика "OR".
    • Пример IPv4. Если добавить два IP-адреса 1.2.3.4 и 10.20.30.40, условие будет сопоставляться для любых запросов, поступивших либо с адреса 1.2.3.4, либо 10.20.30.40.
    • Пример IPv6. Если вы добавите два IP-адреса 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.

Свойства

Свойство Поддерживаемые значения
Оператор
  • На портале Azure: IP Match, Not IP Match
  • В шаблонах ARM: IPMatch. Используйте свойство negateCondition, чтобы указать Соответствие IP-адреса отсутствует
Значение Укажите один или несколько диапазонов IP-адресов. Если указано несколько диапазонов IP-адресов, они оцениваются с использованием логики OR.

Пример

В этом примере мы сопоставляем все запросы IP-адресов в диапазоне 5.5.5.64/26.

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

Порт клиента

Условие соответствия порта клиента определяет запросы на основе TCP-порта клиента, который выполнил запрос. Можно указать несколько значений для сопоставления, которые можно объединить с помощью логики OR.

Свойства

Свойство Поддерживаемые значения
Оператор Поддерживаются все операторы из списка стандартных операторов. Однако Любое условие соответствия соответствует каждому запросу, а Не любое условие соответствия не соответствует ни одному запросу при использовании с условием соответствия клиентского порта.
Значение Один или несколько номеров портов, выраженные как целые числа. Если указано несколько значений, они оцениваются с помощью логики OR.

Пример

В этом примере мы сопоставляем все запросы с портом 1234 клиента.

Снимок экрана портала с условием соответствия клиентского порта.

Порт сервера

Условие соответствия порта сервера определяет запросы на основе TCP-порта сервера Azure Front Door, который принял запрос. Номер порта должен быть 80 или 443. Можно указать несколько значений для сопоставления, которые можно объединить с помощью логики OR.

Свойства

Свойство Поддерживаемые значения
Оператор Поддерживаются все операторы из списка стандартных операторов. Однако условие Любое соответствует каждому запросу, а условие Не Любое не соответствует ни одному запросу, если используется с условием соответствия порта сервера.
Значение Номер порта, который должен иметь значение 80 или 443. Если указано несколько значений, они оцениваются с помощью логики OR.

Пример

В этом примере мы сопоставляем все запросы с портом 443 сервера.

Снимок экрана портала с условием соответствия порта сервера.

Список операторов

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

Оператор Описание Поддержка шаблона ARM
Любой Соответствует при наличии какого-либо значения, независимо от того, что это. operator: Any
Равно Соответствует, если значение точно соответствует заданной строке. operator: Equal
Содержит Соответствует, если значение содержит заданную строку. operator: Contains
Меньше Соответствует, если длина значения меньше заданного целого числа. operator: LessThan
Больше чем Соответствует, если длина значения больше заданного целого числа. operator: GreaterThan
Меньше или равно Соответствует, если длина значения меньше или равна заданному целому числу. operator: LessThanOrEqual
Больше или равно Соответствует, если длина значения больше или равна заданному целому числу. operator: GreaterThanOrEqual
Начинается с Соответствует, когда значение начинается с заданной строки. operator: BeginsWith
Заканчивается на Соответствует тогда, когда значение заканчивается на указанную строку. operator: EndsWith
Ни одно Соответствует, если значение отсутствует. operator: Any и negateCondition : true
Не равно Соответствует, если значение не совпадает с заданной строкой. operator: Equal и negateCondition : true
Не содержит Соответствует, если значение не содержит заданную строку. operator: Contains и negateCondition : true
Не меньше Соответствует, если длина значения не меньше заданного целого числа. operator: LessThan и negateCondition : true
Не больше Соответствует, если длина значения не превышает заданного целого числа. operator: GreaterThan и negateCondition : true
Не меньше или равно Соответствует, если длина значения не меньше или не равна заданному целому числу. operator: LessThanOrEqual и negateCondition : true
Не больше и не равно Соответствует, если длина значения не больше заданного целого числа или не равна ему. operator: GreaterThanOrEqual и negateCondition : true
Не начинается с Соответствует, если значение не начинается с заданной строки. operator: BeginsWith и negateCondition : true
Не оканчивается на Соответствует, если значение не оканчивается на заданную строку. operator: EndsWith и negateCondition : true
Оператор Описание Поддержка шаблона ARM
Любой Соответствует, если имеется какое-либо значение, независимо от того, что это за значение. operator: Any
Равно Соответствует, если значение точно соответствует заданной строке. operator: Equal
Содержит Соответствует, если значение содержит заданную строку. operator: Contains
Меньше Соответствует, если длина значения меньше заданного целого числа. operator: LessThan
Больше чем Соответствует, если длина значения больше заданного целого числа. operator: GreaterThan
Меньше или равно Соответствует, если длина значения меньше или равна заданному целому числу. operator: LessThanOrEqual
Больше или равно Соответствует, если длина значения больше или равна заданному целому числу. operator: GreaterThanOrEqual
Начинается с Соответствует, когда значение начинается с заданной строки. operator: BeginsWith
Заканчивается на Соответствует, если значение заканчивается на указанную строку. operator: EndsWith
Регулярное выражение Соответствует, когда значение соответствует заданному регулярному выражению. Дополнительные сведения см. в разделе ниже. operator: RegEx
Ни одно Совпадает при отсутствии значения. operator: Any и negateCondition : true
Не равно Соответствует, если значение не совпадает с заданной строкой. operator: Equal и negateCondition : true
Не содержит Соответствует, если значение не содержит заданную строку. operator: Contains и negateCondition : true
Не меньше Соответствует, когда длина значения не меньше заданного целого числа. operator: LessThan и negateCondition : true
Не больше Соответствует, если длина значения не больше заданного целого числа. operator: GreaterThan и negateCondition : true
Не меньше или равно Соответствует, если длина значения не меньше заданного целого числа и не равна ему. operator: LessThanOrEqual и negateCondition : true
Не больше и не равно Соответствует, если длина значения не больше заданного целого числа или равна ему. operator: GreaterThanOrEqual и negateCondition : true
Не начинается с Соответствует, если значение не начинается с заданной строки. operator: BeginsWith и negateCondition : true
Не оканчивается на Совпадает, когда значение не заканчивается на заданную строку. operator: EndsWith и negateCondition : true
Нерегулярное выражение Соответствует, если значение не совпадает с заданным регулярным выражением. Дополнительные сведения см. в разделе ниже. operator: RegEx и negateCondition : true

Совет

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

Регулярные выражения

Регулярные выражения не поддерживают следующие операции:

  • Обратные ссылки и запись частей выражений.
  • Произвольные утверждения нулевой ширины.
  • Ссылки на подпрограммы и рекурсивные шаблоны.
  • Условные шаблоны.
  • Команды управления обратным отслеживанием.
  • Однобайтовая директива \C.
  • Директива соответствия новой строке \R.
  • Начало сопоставления с директивой сброса \K.
  • Выноски и встроенный код.
  • Атомарное группирование и поглощающие квантификаторы.

Список преобразования строк

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

Преобразуйте Описание Поддержка шаблона ARM
Нижний регистр Преобразует строку в представление в нижнем регистре. Lowercase
Верхний регистр Преобразует строку в представление в верхнем регистре. Uppercase
Подрезать Усекает пробелы в начале и конце строки. Trim
Удаление значений NULL Удаляет значения NULL из строки. RemoveNulls
Кодирование URL-адреса URL-кодирует строку. UrlEncode
Декодирование URL-адреса Декодирует URL-строку. UrlDecode

Следующие шаги