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

В наборах правил Azure Front Door правило состоит некоторых условий соответствия (могут отсутствовать) и действия. В этой статье подробно описаны условия соответствия, которые можно использовать в наборах правил 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

Пример

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

Портал

JSON

{
  "name": "IsDevice",
  "parameters": {
    "operator": "Equal",
    "negateCondition": false,
    "matchValues": [
      "Mobile"
    ],
    "typeName": "DeliveryRuleIsDeviceConditionParameters"
  }
}

{
  "name": "IsDevice",
  "parameters": {
    "operator": "Equal",
    "negateCondition": false,
    "matchValues": [
      "Mobile"
    ],
    "@odata.type": "#Microsoft.Azure.Cdn.Models.DeliveryRuleIsDeviceConditionParameters"
  }
}

Bicep

{
  name: 'IsDevice'
  parameters: {
    operator: 'Equal'
    negateCondition: false
    matchValues: [
      'Mobile'
    ]
    typeName: 'DeliveryRuleIsDeviceConditionParameters'
  }
}

{
  name: 'IsDevice'
  parameters: {
    operator: 'Equal'
    negateCondition: false
    matchValues: [
      'Mobile'
    ]
    '@odata.type': '#Microsoft.Azure.Cdn.Models.DeliveryRuleIsDeviceConditionParameters'
  }
}

Версия HTTP

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

Примечание.

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

Свойства

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

Пример

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

Портал

JSON

{
  "name": "HttpVersion",
  "parameters": {
    "operator": "Equal",
    "negateCondition": false,
    "matchValues": [
      "2.0"
    ],
    "typeName": "DeliveryRuleHttpVersionConditionParameters"
  }
}

Bicep

{
  name: 'HttpVersion'
  parameters: {
    operator: 'Equal'
    negateCondition: false
    matchValues: [
      '2.0'
    ]
    typeName: 'DeliveryRuleHttpVersionConditionParameters'
  }
}

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

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

Примечание.

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

Свойства

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

Пример

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

Портал

JSON

{
  "name": "Cookies",
  "parameters": {
    "selector": "deploymentStampId",
    "operator": "Equal",
    "negateCondition": false,
    "matchValues": [
      "1"
    ],
    "transforms": [],
    "typeName": "DeliveryRuleCookiesConditionParameters"
  }
}

Bicep

{
  name: 'Cookies'
  parameters: {
    selector: 'deploymentStampId'
    operator: 'Equal'
    negateCondition: false
    matchValues: [
      '1'
    ]
    typeName: 'DeliveryRuleCookiesConditionParameters'
  }
}

Аргументы POST

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

Примечание.

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

Свойства

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

Пример

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

Портал

JSON

{
  "name": "PostArgs",
  "parameters": {
    "selector": "customerName",
    "operator": "BeginsWith",
    "negateCondition": false,
    "matchValues": [
        "J",
        "K"
    ],
    "transforms": [
        "Uppercase"
    ],
    "typeName": "DeliveryRulePostArgsConditionParameters"
}

{
  "name": "PostArgs",
  "parameters": {
    "selector": "customerName",
    "operator": "BeginsWith",
    "negateCondition": false,
    "matchValues": [
        "J",
        "K"
    ],
    "transforms": [
        "Uppercase"
    ],
    "@odata.type": "#Microsoft.Azure.Cdn.Models.DeliveryRulePostArgsConditionParameters"
}

Bicep

{
  name: 'PostArgs'
  parameters: {
    selector: 'customerName'
    operator: 'BeginsWith'
    negateCondition: false
    matchValues: [
      'J'
      'K'
    ]
    transforms: [
      'Uppercase'
    ]
    typeName: 'DeliveryRulePostArgsConditionParameters'
  }
}

{
  name: 'PostArgs'
  parameters: {
    selector: 'customerName'
    operator: 'BeginsWith'
    negateCondition: false
    matchValues: [
      'J'
      'K'
    ]
    transforms: [
      'Uppercase'
    ]
    '@odata.type': '#Microsoft.Azure.Cdn.Models.DeliveryRulePostArgsConditionParameters'
  }
}

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

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

Примечание.

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

Свойства

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

Пример

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

Портал

JSON

{
  "name": "QueryString",
  "parameters": {
    "operator": "Contains",
    "negateCondition": false,
    "matchValues": [
      "language=en-US"
    ],
    "typeName": "DeliveryRuleQueryStringConditionParameters"
  }
}

{
  "name": "QueryString",
  "parameters": {
    "operator": "Contains",
    "negateCondition": false,
    "matchValues": [
      "language=en-US"
    ],
    "@odata.type": "#Microsoft.Azure.Cdn.Models.DeliveryRuleQueryStringConditionParameters"
  }
}

Bicep

{
  name: 'QueryString'
  parameters: {
    operator: 'Contains'
    negateCondition: false
    matchValues: [
      'language=en-US'
    ]
    typeName: 'DeliveryRuleQueryStringConditionParameters'
  }
}

{
  name: 'QueryString'
  parameters: {
    operator: 'Contains'
    negateCondition: false
    matchValues: [
      'language=en-US'
    ]
    '@odata.type': '#Microsoft.Azure.Cdn.Models.DeliveryRuleQueryStringConditionParameters'
  }
}

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

Условие сопоставления удаленных адресов определяет запросы на основе расположения или 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.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: задайте одно или несколько расположений, используя код страны.

Пример

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

Портал

JSON

{
  "name": "RemoteAddress",
  "parameters": {
    "operator": "GeoMatch",
    "negateCondition": true,
    "matchValues": [
      "US"
    ],
    "typeName": "DeliveryRuleRemoteAddressConditionParameters"
  }
}

{
  "name": "RemoteAddress",
  "parameters": {
    "operator": "GeoMatch",
    "negateCondition": true,
    "matchValues": [
      "US"
    ],
    "@odata.type": "#Microsoft.Azure.Cdn.Models.DeliveryRuleRemoteAddressConditionParameters"
  }
}

Bicep

{
  name: 'RemoteAddress'
  parameters: {
    operator: 'GeoMatch'
    negateCondition: true
    matchValues: [
      'US'
    ]
    typeName: 'DeliveryRuleRemoteAddressConditionParameters'
  }
}

{
  name: 'RemoteAddress'
  parameters: {
    operator: 'GeoMatch'
    negateCondition: true
    matchValues: [
      'US'
    ]
    '@odata.type': '#Microsoft.Azure.Cdn.Models.DeliveryRuleRemoteAddressConditionParameters'
  }
}

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

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

Примечание.

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

Свойства

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

Пример

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

Портал

JSON

{
  "name": "RequestBody",
  "parameters": {
    "operator": "Contains",
    "negateCondition": false,
    "matchValues": [
      "ERROR"
    ],
    "transforms": [
      "Uppercase"
    ],
    "typeName": "DeliveryRuleRequestBodyConditionParameters"
  }
}

{
  "name": "RequestBody",
  "parameters": {
    "operator": "Contains",
    "negateCondition": false,
    "matchValues": [
      "ERROR"
    ],
    "transforms": [
      "Uppercase"
    ],
    "@odata.type": "#Microsoft.Azure.Cdn.Models.DeliveryRuleRequestBodyConditionParameters"
  }
}

Bicep

{
  name: 'RequestBody'
  parameters: {
    operator: 'Contains'
    negateCondition: false
    matchValues: [
      'ERROR'
    ]
    transforms: [
      'Uppercase'
    ]
    typeName: 'DeliveryRuleRequestBodyConditionParameters'
  }
}

{
  name: 'RequestBody'
  parameters: {
    operator: 'Contains'
    negateCondition: false
    matchValues: [
      'ERROR'
    ]
    transforms: [
      'Uppercase'
    ]
    '@odata.type': '#Microsoft.Azure.Cdn.Models.DeliveryRuleRequestBodyConditionParameters'
  }
}

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

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

Свойства

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

Пример

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

Портал

JSON

{
  "name": "UrlFileName",
  "parameters": {
    "operator": "Equal",
    "negateCondition": false,
    "matchValues": [
      "media.mp4"
    ],
    "transforms": [
      "Lowercase"
    ],
    "typeName": "DeliveryRuleUrlFilenameConditionParameters"
  }
}

{
  "name": "UrlFileName",
  "parameters": {
    "operator": "Equal",
    "negateCondition": false,
    "matchValues": [
      "media.mp4"
    ],
    "transforms": [
      "Lowercase"
    ],
    "@odata.type": "#Microsoft.Azure.Cdn.Models.DeliveryRuleUrlFilenameConditionParameters"
  }
}

Bicep

{
  name: 'UrlFileName'
  parameters: {
    operator: 'Equal'
    negateCondition: false
    matchValues: [
      'media.mp4'
    ]
    transforms: [
      'Lowercase'
    ]
    typeName: 'DeliveryRuleUrlFilenameConditionParameters'
  }
}

{
  name: 'UrlFileName'
  parameters: {
    operator: 'Equal'
    negateCondition: false
    matchValues: [
      'media.mp4'
    ]
    transforms: [
      'Lowercase'
    ]
    '@odata.type': '#Microsoft.Azure.Cdn.Models.DeliveryRuleUrlFilenameConditionParameters'
  }
}

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

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

Примечание.

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

Свойства

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

Пример

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

Портал

JSON

{
  "name": "UrlFileExtension",
  "parameters": {
    "operator": "Equal",
    "negateCondition": false,
    "matchValues": [
      "pdf",
      "docx"
    ],
    "transforms": [
      "Lowercase"
    ],
    "typeName": "DeliveryRuleUrlFileExtensionMatchConditionParameters"
  }

{
  "name": "UrlFileExtension",
  "parameters": {
    "operator": "Equal",
    "negateCondition": false,
    "matchValues": [
      "pdf",
      "docx"
    ],
    "transforms": [
      "Lowercase"
    ],
    "@odata.type": "#Microsoft.Azure.Cdn.Models.DeliveryRuleUrlFileExtensionMatchConditionParameters"
  }

Bicep

{
  name: 'UrlFileExtension'
  parameters: {
    operator: 'Equal'
    negateCondition: false
    matchValues: [
      'pdf'
      'docx'
    ]
    transforms: [
      'Lowercase'
    ]
    typeName: 'DeliveryRuleUrlFileExtensionMatchConditionParameters'
  }
}

{
  name: 'UrlFileExtension'
  parameters: {
    operator: 'Equal'
    negateCondition: false
    matchValues: [
      'pdf'
      'docx'
    ]
    transforms: [
      'Lowercase'
    ]
    '@odata.type': '#Microsoft.Azure.Cdn.Models.DeliveryRuleUrlFileExtensionMatchConditionParameters'
  }
}

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

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

Свойства

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

Пример

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

Портал

JSON

{
  "name": "RequestHeader",
  "parameters": {
    "selector": "MyCustomHeader",
    "operator": "Any",
    "negateCondition": false,
    "typeName": "DeliveryRuleRequestHeaderConditionParameters"
  }
}

{
  "name": "RequestHeader",
  "parameters": {
    "selector": "MyCustomHeader",
    "operator": "Any",
    "negateCondition": false,
    "@odata.type": "#Microsoft.Azure.Cdn.Models.DeliveryRuleRequestHeaderConditionParameters"
  }
}

Bicep

{
  name: 'RequestHeader'
  parameters: {
    selector: 'MyCustomHeader',
    operator: 'Any'
    negateCondition: false
    typeName: 'DeliveryRuleRequestHeaderConditionParameters'
  }
}

{
  name: 'RequestHeader'
  parameters: {
    selector: 'MyCustomHeader',
    operator: 'Any'
    negateCondition: false
    '@odata.type': '#Microsoft.Azure.Cdn.Models.DeliveryRuleRequestHeaderConditionParameters'
  }
}

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

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

Свойства

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

Пример

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

Портал

JSON

{
  "name": "RequestMethod",
  "parameters": {
    "operator": "Equal",
    "negateCondition": false,
    "matchValues": [
      "DELETE"
    ],
    "typeName": "DeliveryRuleRequestMethodConditionParameters"
  }
}

{
  "name": "RequestMethod",
  "parameters": {
    "operator": "Equal",
    "negateCondition": false,
    "matchValues": [
      "DELETE"
    ],
    "@odata.type": "#Microsoft.Azure.Cdn.Models.DeliveryRuleRequestMethodConditionParameters"
  }
}

Bicep

{
  name: 'RequestMethod'
  parameters: {
    operator: 'Equal'
    negateCondition: false
    matchValues: [
      'DELETE'
    ]
    typeName: 'DeliveryRuleRequestMethodConditionParameters'
  }
}

{
  name: 'RequestMethod'
  parameters: {
    operator: 'Equal'
    negateCondition: false
    matchValues: [
      'DELETE'
    ]
    '@odata.type': '#Microsoft.Azure.Cdn.Models.DeliveryRuleRequestMethodConditionParameters'
  }
}

Путь запроса

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

Примечание.

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

Свойства

Свойство	Поддерживаемые значения
Оператор	Поддерживаются все операторы из списка стандартных операторов. Однако условие "Любой совпадений" соответствует каждому запросу, и условие не соответствует ни одному запросу при использовании с условием сопоставления пути запроса. Подстановочный знак: соответствует, если путь запроса соответствует выражению подстановочного знака. Выражение с подстановочным знаком может содержать символ *, чтобы было возможно соответствие нулю или нескольким символам в пути. Например, выражение files/customer*/file.pdf wild карта соответствует путям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/ другие варианты регистра также активируют это условие соответствия.

Портал

JSON

{
  "name": "UrlPath",
  "parameters": {
    "operator": "BeginsWith",
    "negateCondition": false,
    "matchValues": [
      "files/secure/"
    ],
    "transforms": [
      "Lowercase"
    ],
    "typeName": "DeliveryRuleUrlPathMatchConditionParameters"
  }
}

{
  "name": "UrlPath",
  "parameters": {
    "operator": "BeginsWith",
    "negateCondition": false,
    "matchValues": [
      "files/secure/"
    ],
    "transforms": [
      "Lowercase"
    ],
    "@odata.type": "#Microsoft.Azure.Cdn.Models.DeliveryRuleUrlPathMatchConditionParameters"
  }
}

Bicep

{
  name: 'UrlPath'
  parameters: {
    operator: 'BeginsWith'
    negateCondition: false
    matchValues: [
      'files/secure/'
    ]
    transforms: [
      'Lowercase'
    ]
    typeName: 'DeliveryRuleUrlPathMatchConditionParameters'
  }
}

{
  name: 'UrlPath'
  parameters: {
    operator: 'BeginsWith'
    negateCondition: false
    matchValues: [
      'files/secure/'
    ]
    transforms: [
      'Lowercase'
    ]
    '@odata.type': '#Microsoft.Azure.Cdn.Models.DeliveryRuleUrlPathMatchConditionParameters'
  }
}

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

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

Примечание.

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

Свойства

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

Пример

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

Портал

JSON

{
  "name": "RequestScheme",
  "parameters": {
    "operator": "Equal",
    "negateCondition": false,
    "matchValues": [
      "HTTP"
    ],
    "typeName": "DeliveryRuleRequestSchemeConditionParameters"
  }
}

{
  "name": "RequestScheme",
  "parameters": {
    "operator": "Equal",
    "negateCondition": false,
    "matchValues": [
      "HTTP"
    ],
    "@odata.type": "#Microsoft.Azure.Cdn.Models.DeliveryRuleRequestSchemeConditionParameters"
  }
}

Bicep

{
  name: 'RequestScheme'
  parameters: {
    operator: 'Equal'
    negateCondition: false
    matchValues: [
      'HTTP'
    ]
    typeName: 'DeliveryRuleRequestSchemeConditionParameters'
  }
}

{
  name: 'RequestScheme'
  parameters: {
    operator: 'Equal'
    negateCondition: false
    matchValues: [
      'HTTP'
    ]
    '@odata.type': '#Microsoft.Azure.Cdn.Models.DeliveryRuleRequestSchemeConditionParameters'
  }
}

Запросить 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 и другие варианты регистра также приводили к срабатыванию этого условия соответствия.

Портал

JSON

{
  "name": "RequestUri",
  "parameters": {
    "operator": "BeginsWith",
    "negateCondition": false,
    "matchValues": [
      "https://api.contoso.com/customers/123"
    ],
    "transforms": [
      "Lowercase"
    ],
    "typeName": "DeliveryRuleRequestUriConditionParameters"
  }
}

{
  "name": "RequestUri",
  "parameters": {
    "operator": "BeginsWith",
    "negateCondition": false,
    "matchValues": [
      "https://api.contoso.com/customers/123"
    ],
    "transforms": [
      "Lowercase"
    ],
    "@odata.type": "#Microsoft.Azure.Cdn.Models.DeliveryRuleRequestUriConditionParameters"
  }
}

Bicep

{
  name: 'RequestUri'
  parameters: {
    operator: 'BeginsWith'
    negateCondition: false
    matchValues: [
      'https://api.contoso.com/customers/123'
    ]
    transforms: [
      'Lowercase'
    ]
    typeName: 'DeliveryRuleRequestUriConditionParameters'
  }
}

{
  name: 'RequestUri'
  parameters: {
    operator: 'BeginsWith'
    negateCondition: false
    matchValues: [
      'https://api.contoso.com/customers/123'
    ]
    transforms: [
      'Lowercase'
    ]
    '@odata.type': '#Microsoft.Azure.Cdn.Models.DeliveryRuleRequestUriConditionParameters'
  }
}

Host name

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

Свойства

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

Пример

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

Портал

JSON

{
  "name": "HostName",
  "parameters": {
    "operator": "EndsWith",
    "negateCondition": false,
    "matchValues": [
      "contoso.com"
    ],
    "transforms": [],
    "typeName": "DeliveryRuleHostNameConditionParameters"
  }
}

Bicep

{
  name: 'HostName'
  parameters: {
    operator: 'EndsWith'
    negateCondition: false
    matchValues: [
      'contoso.com'
    ]
    transforms: []
    typeName: 'DeliveryRuleHostNameConditionParameters'
  }
}

Протокол 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.

Портал

JSON

{
  "name": "SslProtocol",
  "parameters": {
    "operator": "Equal",
    "negateCondition": false,
    "matchValues": [
      "TLSv1.2"
    ],
    "typeName": "DeliveryRuleSslProtocolConditionParameters"
  }
},

Bicep

{
  name: 'SslProtocol'
  parameters: {
    operator: 'Equal'
    negateCondition: false
    matchValues: [
      'TLSv1.2'
    ]
    typeName: 'DeliveryRuleSslProtocolConditionParameters'
  }
}

Адрес сокета

Условие соответствия адреса сокета определяет запросы на основе 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.

Портал

JSON

{
  "name": "SocketAddr",
  "parameters": {
    "operator": "IPMatch",
    "negateCondition": false,
    "matchValues": [
      "5.5.5.64/26"
    ],
    "typeName": "DeliveryRuleSocketAddrConditionParameters"
  }
}

Bicep

{
  name: 'SocketAddr'
  parameters: {
    operator: 'IPMatch'
    negateCondition: false
    matchValues: [
      '5.5.5.64/26'
    ]
    typeName: 'DeliveryRuleSocketAddrConditionParameters'
  }
}

Порт клиента

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

Свойства

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

Пример

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

Портал

JSON

{
  "name": "ClientPort",
  "parameters": {
    "operator": "Equal",
    "negateCondition": false,
    "matchValues": [
      "1111"
    ],
    "typeName": "DeliveryRuleClientPortConditionParameters"
  }
}

Bicep

{
  name: 'ClientPort'
  parameters: {
    operator: 'Equal'
    negateCondition: false
    matchValues: [
      '1111'
    ]
    typeName: 'DeliveryRuleClientPortConditionParameters'
  }
}

Порт сервера

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

Свойства

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

Пример

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

Портал

JSON

{
  "name": "ServerPort",
  "parameters": {
    "operator": "Equal",
    "negateCondition": false,
    "matchValues": [
      "443"
    ],
    "typeName": "DeliveryRuleServerPortConditionParameters"
  }
}

Bicep

{
  name: 'ServerPort'
  parameters: {
    operator: 'Equal'
    negateCondition: false
    matchValues: [
      '443'
    ]
    typeName: 'DeliveryRuleServerPortConditionParameters'
  }
}

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

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

Operator	Описание	Поддержка шаблона 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

Operator	Описание	Поддержка шаблона 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.
• Выноски и встроенный код.
• Атомарное группирование и обладающие квантификаторы.

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

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

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

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

• См. дополнительные сведения об обработчике правил Azure Front Door (классическая модель).
• Узнайте, как настроить свой первый обработчик правил.
• См. дополнительные сведения о действиях правил.

• Узнайте о наборе правил Azure Front Door.
• Узнайте, как настроить свой первый набор правил.
• См. дополнительные сведения о действиях правил.