Condições de correspondência de regras

Nos Conjuntos de regras do Azure Front Door, uma regra consiste em uma ou mais condições de correspondência e em uma ação. Este artigo fornece descrições detalhadas das condições de correspondência que podem ser usadas em conjuntos de regras do Azure Front Door.

Importante

O Azure Front Door (clássico) será desativado em 31 de março de 2027. Para evitar qualquer interrupção do serviço, é importante que você migre seus perfis do Azure Front Door (clássico) para a camada Azure Front Door Standard ou Premium até março de 2027. Para obter mais informações, consulte Desativação do Azure Front Door (clássico).

Nos Mecanismos de regras do Azure Front Door (clássico), uma regra consiste em uma ou mais condições de correspondência e em uma ação. Este artigo fornece descrições detalhadas das condições de correspondência que podem ser usadas em Mecanismos de regras do Azure Front Door (clássico).

Uma regra começa com uma condição de correspondência ou com um conjunto de condições de correspondência. Uma regra pode ter até 10 condições de correspondência. Uma condição de correspondência identifica tipos específicos de solicitações para as quais as ações definidas são executadas. Se você usar várias condições de correspondência, elas serão agrupadas usando a lógica AND. Para as condições de correspondência que dão suporte a vários valores, a lógica OR é usada.

Você pode usar uma condição de correspondência para:

• Filtrar solicitações com base em um endereço IP, uma porta ou uma região ou um país específico.
• Filtrar solicitações por informações de cabeçalho.
• Filtrar solicitações de dispositivos móveis ou dispositivos de desktop.
• Filtrar solicitações por nome do arquivo de solicitação e extensão de arquivo.
• Filtrar solicitações por nome do host, protocolo SSL, URL de solicitação, protocolo, caminho, cadeia de caracteres de consulta, argumentos de postagem e outros valores.

• Filtrar solicitações com base em um endereço IP específico ou país/região.
• Filtrar solicitações por informações de cabeçalho.
• Filtrar solicitações de dispositivos móveis ou dispositivos de desktop.
• Filtrar solicitações por nome do arquivo de solicitação e extensão de arquivo.
• Filtrar solicitações por URL de solicitação, protocolo, caminho, cadeia de caracteres de consulta, argumentos de postagem e outros valores.

Tipo de dispositivo

Use a condição de correspondência tipo de dispositivo para identificar solicitações provenientes de um dispositivo móvel ou desktop.

Propriedades

Propriedade	Valores com suporte
Operador	No portal do Azure: EqualNot Equal Em modelos do ARM: Equal; use a propriedade negateCondition para especificar Não igual
Valor	Mobile, Desktop

Exemplo

Nesse exemplo, correspondemos todas as solicitações detectadas como provenientes de um dispositivo móvel.

Portal

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'
  }
}

Versão HTTP

Use a condição de correspondência Versão HTTP para identificar solicitações feitas usando uma versão específica do protocolo HTTP.

Observação

A condição de correspondência de versão HTTP só está disponível no Azure Front Door Standard/Premium.

Propriedades

Propriedade	Valores com suporte
Operador	No portal do Azure: EqualNot Equal Em modelos do ARM: Equal; use a propriedade negateCondition para especificar Não igual
Valor	2.0, 1.1, 1.0, 0.9

Exemplo

Nesse exemplo, correspondemos todas as solicitações enviadas usando o protocolo HTTP 2.0.

Portal

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'
  }
}

Solicitar cookies

Use a condição de correspondência solicitar cookies para identificar solicitações que incluam um cookie específico.

Observação

A condição de correspondência de cookies de solicitação só está disponível no Azure Front Door Standard/Premium.

Propriedades

Propriedade	Valores com suporte
Nome do cookie	Um valor de cadeia de caracteres que representa o nome do cookie.
Operador	Qualquer operador da lista de operadores padrão.
Valor	Um ou mais valores de cadeia de caracteres ou inteiros que representam o valor do cabeçalho da solicitação para correspondência. Se vários valores forem especificados, eles serão avaliados por meio de lógica OR.
Transformação de maiúsculas e minúsculas	Qualquer transformação da lista de transformações de cadeia de caracteres padrão.

Exemplo

Nesse exemplo, combinamos todas as solicitações que possuem um cookie chamado deploymentStampId com um valor de 1.

Portal

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'
  }
}

Argumentos post

Use a condição de correspondência argumentos post para identificar solicitações com base nos argumentos fornecidos no corpo de uma solicitação POST. Uma única condição de correspondência corresponde a um único argumento do corpo da solicitação POST. Você pode especificar vários valores para correspondência, que podem ser combinados usando a lógica OR.

Observação

A condição de correspondência argumentos post funciona com o tipo de conteúdo application/x-www-form-urlencoded.

Propriedades

Propriedade	Valores com suporte
Argumentos post	Um valor de cadeia de caracteres que representa o nome do argumento POST.
Operador	Qualquer operador da lista de operadores padrão.
Valor	Um ou mais valores de cadeia de caracteres ou inteiros que representam o valor do argumento POST para correspondência. Se vários valores forem especificados, eles serão avaliados por meio de lógica OR.
Transformação de maiúsculas e minúsculas	Qualquer transformação da lista de transformações de cadeia de caracteres padrão.

Exemplo

Neste exemplo, fizemos a correspondência de todas as solicitações POST em que um argumento customerName é fornecido no corpo da solicitação e onde o valor de customerName começa com a letra J ou K. Usamos uma transformação de caso para converter os valores de entrada em letras maiúsculas para que os valores que começam com J, j, K e k sejam todos correspondidos.

Portal

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'
  }
}

Cadeia de consulta

Use a condição de correspondência de cadeia de caracteres de consulta para identificar solicitações que contêm uma cadeia de caracteres de consulta específica. Você pode especificar vários valores para correspondência, que podem ser combinados usando a lógica OR.

Observação

Toda a cadeia de caracteres de consulta é correspondida como uma única cadeia de caracteres, sem o ? inicial.

Propriedades

Propriedade	Valores com suporte
Operador	Há suporte para todos os operadores da lista de operadores padrão. No entanto, a condição de correspondência Any corresponde a todas as solicitações e a condição de correspondência Not Any não corresponde a nenhuma solicitação, quando usada com a condição de correspondência de cadeia de caracteres de consulta.
Cadeia de consulta	Um ou mais valores de cadeia de caracteres ou inteiros que representam o valor da cadeia de caracteres de consulta para correspondência. Não inclua o ? no início da cadeia de caracteres de consulta. Se vários valores forem especificados, eles serão avaliados por meio de lógica OR.
Transformação de maiúsculas e minúsculas	Qualquer transformação da lista de transformações de cadeia de caracteres padrão.

Exemplo

Neste exemplo, fizemos a correspondência de todas as solicitações em que a cadeia de caracteres de consulta contém a cadeia de caracteres language=en-US. Queremos que a condição de correspondência diferencie maiúsculas de minúsculas, ou seja, não transformamos maiúsculas e minúsculas.

Portal

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'
  }
}

Endereço remoto

A condição de correspondência de endereço remoto identifica solicitações com base no local ou endereço IP do solicitante. Você pode especificar vários valores para correspondência, que podem ser combinados usando a lógica OR.

• Use a notação CIDR ao especificar blocos de endereço IP. A sintaxe para um bloco de endereços IP é o endereço IP básico seguido por uma barra invertida e o tamanho do prefixo. Por exemplo:
  • Exemplo de IPv4: 5.5.5.64/26 corresponde a qualquer solicitação que chega dos endereços 5.5.5.64 a 5.5.5.127.
  • Exemplo de IPv6: 1:2:3:/48 corresponde a solicitações que chegam dos endereços 1:2:3:0:0:0:0:0 por meio de 1:2:3: ffff:ffff:ffff:ffff:ffff.
• Quando você especifica vários endereços IP e blocos de endereço IP, a lógica “OR” é aplicada.
  • Exemplo de IPv4: se você adicionar dois endereços IP 1.2.3.4 e 10.20.30.40, a condição será correspondida em todas as solicitações que chegarem dos endereços 1.2.3.4 ou 10.20.30.40.
  • Exemplo de IPv6: se você adicionar dois endereços IP 1:2:3:4:5:6:7:8 e 10:20:30:40:50:60:70:80, a condição será correspondida em todas as solicitações que chegarem do endereço 1:2:3:4:5:6:7:8 ou 10:20:30:40:50:60:70:80.
• O endereço remoto representa o IP do cliente original que é da conexão de rede ou normalmente o cabeçalho de solicitação X-Forwarded-For se o usuário estiver protegido por um proxy. Use a condição de correspondência de endereço de soquete (disponível em Standard/Premium), se você precisar de correspondência com base no endereço IP da solicitação TCP.

Propriedades

Propriedade	Valores com suporte
Operador	No portal do Azure: Geo Match, Geo Not Match, IP Match ou IP Not Match Em modelos do ARM: GeoMatch, IPMatch; use a propriedade negateCondition para especificar Geo Not Match ou IP Not Match
Valor	Para os operadores IP Match ou IP Not Match: especifique um ou mais intervalos de endereços IP. Se vários intervalos de endereços IP forem especificados, eles serão avaliados usando lógica OR. Para os operadores Geo Match ou Geo Not Match: especifique um ou mais locais usando seu código de país.

Exemplo

Nesse exemplo, fizemos a correspondência de todas as solicitações em que a solicitação não foi originada dos Estados Unidos.

Portal

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'
  }
}

Corpo da solicitação

A condição de correspondência de corpo da solicitação identifica solicitações com base em um texto específico que aparece no corpo da solicitação. Você pode especificar vários valores para correspondência, que podem ser combinados usando a lógica OR.

Observação

Se um corpo de solicitação exceder 64 KB, somente os primeiros 64 KB serão considerados para a condição de correspondência de corpo da solicitação.

Propriedades

Propriedade	Valores com suporte
Operador	Há suporte para todos os operadores da lista de operadores padrão. No entanto, a condição de correspondência Any corresponde a todas as solicitações e a condição de correspondência Not Any não corresponde a nenhuma solicitação, quando usada com a condição de correspondência de corpo da solicitação.
Valor	Um ou mais valores de cadeia de caracteres ou inteiros que representam o valor do texto do corpo da solicitação para correspondência. Se vários valores forem especificados, eles serão avaliados por meio de lógica OR.
Transformação de maiúsculas e minúsculas	Qualquer transformação da lista de transformações de cadeia de caracteres padrão.

Exemplo

Neste exemplo, fizemos a correspondência de todas as solicitações em que o corpo da solicitação contém a cadeia de caracteres ERROR. Transformamos o corpo da solicitação em letras maiúsculas antes de avaliar a correspondência, para que error e outras variações de maiúsculas e minúsculas também acionem essa condição de correspondência.

Portal

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'
  }
}

Nome do arquivo de solicitação

A condição de correspondência de nome do arquivo de solicitação identifica solicitações que incluem o nome de arquivo especificado na URL da solicitação. Você pode especificar vários valores para correspondência, que podem ser combinados usando a lógica OR.

Propriedades

Propriedade	Valores com suporte
Operador	Há suporte para todos os operadores da lista de operadores padrão. No entanto, a condição de correspondência Any corresponde a todas as solicitações e a condição de correspondência Not Any não corresponde a nenhuma solicitação, quando usada com a condição de correspondência de nome do arquivo da solicitação.
Valor	Um ou mais valores de cadeia de caracteres ou inteiros que representam o valor do nome de arquivo de solicitação para correspondência. Se vários valores forem especificados, eles serão avaliados por meio de lógica OR.
Transformação de maiúsculas e minúsculas	Qualquer transformação da lista de transformações de cadeia de caracteres padrão.

Exemplo

Neste exemplo, fizemos a correspondência de todas as solicitações em que o nome do arquivo de solicitação é media.mp4. Transformamos o nome do arquivo em letras minúsculas antes de avaliar a correspondência, para que MEDIA.MP4 e outras variações de maiúsculas e minúsculas também acionem essa condição de correspondência.

Portal

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'
  }
}

Extensão de arquivo de solicitação

A condição de correspondência de extensão do arquivo de solicitação identifica solicitações que incluem a extensão de arquivo especificada no nome do arquivo na URL da solicitação. Você pode especificar vários valores para correspondência, que podem ser combinados usando a lógica OR.

Observação

Não inclua um ponto à esquerda. Por exemplo, use html ao invés de .html.

Propriedades

Propriedade	Valores com suporte
Operador	Há suporte para todos os operadores da lista de operadores padrão. No entanto, a condição de correspondência Any corresponde a todas as solicitações e a condição de correspondência Not Any não corresponde a nenhuma solicitação, quando usada com a condição de correspondência de extensão de arquivo da solicitação.
Valor	Um ou mais valores de cadeia de caracteres ou inteiros que representam o valor da extensão de arquivo de solicitação para correspondência. Não inclua um ponto à esquerda. Se vários valores forem especificados, eles serão avaliados por meio de lógica OR.
Transformação de maiúsculas e minúsculas	Qualquer transformação da lista de transformações de cadeia de caracteres padrão.

Exemplo

Neste exemplo, fizemos a correspondência de todas as solicitações em que a extensão do arquivo de correspondência é pdf ou docx. Transformamos a extensão do arquivo de solicitação em minúsculas antes de avaliar a correspondência, portanto PDF, DocX, e outras variações de maiúsculas e minúsculas também acionam essa condição de correspondência.

Portal

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'
  }
}

Cabeçalho da solicitação

A condição de correspondência de cabeçalho de solicitação identifica solicitações que incluem um cabeçalho específico na solicitação. Você pode usar essa condição de correspondência para verificar se existe um cabeçalho ou se o cabeçalho corresponde a um valor especificado. Você pode especificar vários valores para correspondência, que podem ser combinados usando a lógica OR.

Propriedades

Propriedade	Valores com suporte
Nome do cabeçalho	Um valor de cadeia de caracteres que representa o nome do argumento POST.
Operador	Qualquer operador da lista de operadores padrão.
Valor	Um ou mais valores de cadeia de caracteres ou inteiros que representam o valor do cabeçalho da solicitação para correspondência. Se vários valores forem especificados, eles serão avaliados por meio de lógica OR.
Transformação de maiúsculas e minúsculas	Qualquer transformação da lista de transformações de cadeia de caracteres padrão.

Exemplo

Neste exemplo, fizemos a correspondência de todas as solicitações em que a solicitação contém um cabeçalho chamado MyCustomHeader, independentemente de seu valor.

Portal

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'
  }
}

Método de solicitação

A condição de correspondência de método de solicitação identifica solicitações que usam o método de solicitação HTTP especificado. Você pode especificar vários valores para correspondência, que podem ser combinados usando a lógica OR.

Propriedades

Propriedade	Valores com suporte
Operador	No portal do Azure: EqualNot Equal Em modelos do ARM: Equal; use a propriedade negateCondition para especificar Não igual
Método de solicitação	Um ou mais métodos HTTP de: GET, POST, PUT, DELETE, HEAD, OPTIONS, TRACE. Se vários valores forem especificados, eles serão avaliados por meio de lógica OR.

Exemplo

Neste exemplo, fizemos a correspondência de todas as solicitações em que a solicitação usa o método DELETE.

Portal

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'
  }
}

Caminho da solicitação

A condição de correspondência de caminho de solicitação identifica solicitações que incluem o caminho especificado na URL da solicitação. Você pode especificar vários valores para correspondência, que podem ser combinados usando a lógica OR.

Observação

O caminho é a parte da URL após o nome do host e uma barra. Por exemplo, na URL https://www.contoso.com/files/secure/file1.pdf, o caminho é files/secure/file1.pdf.

Propriedades

Propriedade	Valores com suporte
Operador	Há suporte para todos os operadores da lista de operadores padrão. No entanto, a condição de correspondência Any corresponde a todas as solicitações e a condição de correspondência Not Any não corresponde a nenhuma solicitação, quando usada com a condição de correspondência de caminho da solicitação. Curinga: corresponde quando o caminho da solicitação corresponde a uma expressão curinga. Uma expressão curinga pode incluir o caractere * para corresponder a zero ou mais caracteres dentro do caminho. Por exemplo, a expressão curinga files/customer*/file.pdf corresponde aos caminhos files/customer1/file.pdf, files/customer109/file.pdf e files/customer/file.pdf, mas não corresponde files/customer2/anotherfile.pdf. No portal do Azure: WildcardsNot Wildcards Em modelos do ARM: Wildcard; use a propriedade negateCondition para especificar Sem curingas
Valor	Um ou mais valores de cadeia de caracteres ou inteiros que representam o valor do caminho de solicitação para correspondência. Se você especificar uma barra inicial, ela será ignorada. Se vários valores forem especificados, eles serão avaliados por meio de lógica OR.
Transformação de maiúsculas e minúsculas	Qualquer transformação da lista de transformações de cadeia de caracteres padrão.

Propriedade	Valores com suporte
Operador	Há suporte para todos os operadores da lista de operadores padrão. No entanto, a condição de correspondência Any corresponde a todas as solicitações e a condição de correspondência Not Any não corresponde a nenhuma solicitação, quando usada com a condição de correspondência de caminho da solicitação.
Valor	Um ou mais valores de cadeia de caracteres ou inteiros que representam o valor do caminho de solicitação para correspondência. Se você especificar uma barra inicial, ela será ignorada. Se vários valores forem especificados, eles serão avaliados por meio de lógica OR.
Transformação de maiúsculas e minúsculas	Qualquer transformação da lista de transformações de cadeia de caracteres padrão.

Exemplo

Neste exemplo, fizemos a correspondência de todas as solicitações em que o caminho do arquivo de solicitação começa com files/secure/. Transformamos a extensão do arquivo de solicitação em minúsculas antes de avaliar a correspondência, portanto, solicitações para files/SECURE/ e outras variações de maiúsculas e minúsculas também acionam essa condição de correspondência.

Portal

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'
  }
}

Protocolo de solicitação

A condição de correspondência de protocolo de solicitação identifica solicitações que usam o protocolo especificado (HTTP ou HTTPS).

Observação

Protocolo às vezes é chamado também de esquema.

Propriedades

Propriedade	Valores com suporte
Operador	No portal do Azure: EqualNot Equal Em modelos do ARM: Equal; use a propriedade negateCondition para especificar Não igual
Método de solicitação	HTTP, HTTPS

Exemplo

Neste exemplo, fizemos a correspondência de todas as solicitações em que a solicitação usa o protocolo HTTP.

Portal

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 de Solicitação

Identifica as solicitações que correspondem à URL especificada. A URL inteira é avaliada, incluindo o protocolo e a cadeia de caracteres de consulta, mas não o fragmento. Você pode especificar vários valores para correspondência, que podem ser combinados usando a lógica OR.

Dica

Ao usar essa condição de regra, inclua o protocolo e uma barra /à direita. Por exemplo, use https://www.contoso.com/ em vez de www.contoso.com.

Propriedades

Propriedade	Valores com suporte
Operador	Há suporte para todos os operadores da lista de operadores padrão. No entanto, a condição de correspondência Any corresponde a todas as solicitações e a condição de correspondência Not Any não corresponde a nenhuma solicitação, quando usada com a condição de correspondência de URL da solicitação.
Valor	Um ou mais valores de cadeia de caracteres ou inteiros que representam o valor da URL de solicitação para correspondência. Se vários valores forem especificados, eles serão avaliados por meio de lógica OR.
Transformação de maiúsculas e minúsculas	Qualquer transformação da lista de transformações de cadeia de caracteres padrão.

Exemplo

Neste exemplo, fizemos a correspondência de todas as solicitações em que a URL de solicitação começa com https://api.contoso.com/customers/123. Podemos colocar a extensão do arquivo de solicitação em minúsculas antes de avaliar a correspondência, ou seja, as solicitações para https://api.contoso.com/Customers/123 e outras variações de maiúsculas e minúsculas também dispararão essa condição de correspondência.

Portal

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'
  }
}

Nome do host

A condição de correspondência de nome do host identifica solicitações com base no nome do host especificado na solicitação do cliente. A condição de correspondência usa o valor do cabeçalho Host para avaliar o nome do host. Você pode especificar vários valores para correspondência, que podem ser combinados usando a lógica OR.

Propriedades

Propriedade	Valores com suporte
Operador	Há suporte para todos os operadores da lista de operadores padrão. No entanto, a condição de correspondência Any corresponde a todas as solicitações e a condição de correspondência Not Any não corresponde a nenhuma solicitação, quando usada com a condição de correspondência de nome do host.
Valor	Um ou mais valores da cadeia de caracteres que representam o valor do nome do host da solicitação para correspondência. Se vários valores forem especificados, eles serão avaliados por meio de lógica OR.
Transformação de maiúsculas e minúsculas	Qualquer transformação de maiúsculas e minúsculas da lista de transformações de cadeia de caracteres padrão.

Exemplo

Neste exemplo, correspondemos a todas as solicitações com um cabeçalho Host que termina com contoso.com.

Portal

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'
  }
}

Protocolo SSL

A condição de correspondência do protocolo SSL identifica solicitações com base no protocolo SSL de uma conexão TLS estabelecida. Você pode especificar vários valores para correspondência, que podem ser combinados usando a lógica OR.

Propriedades

Propriedade	Valores com suporte
Operador	No portal do Azure: EqualNot Equal Em modelos do ARM: Equal; use a propriedade negateCondition para especificar Não igual
Protocolo SSL	No portal do Azure: 1.0, 1.1, 1.2 Nos modelos do ARM: TLSv1, TLSv1.1, TLSv1.2

Exemplo

Neste exemplo, correspondemos a todas as solicitações que usam o protocolo TLS 1.2.

Portal

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'
  }
}

Endereço de soquete

A condição de correspondência de endereço de soquete identifica solicitações com base no endereço IP da conexão direta com a borda do Azure Front Door. Você pode especificar vários valores para correspondência, que podem ser combinados usando a lógica OR.

Observação

Se o cliente usou um proxy HTTP ou um balanceador de carga para enviar a solicitação, o endereço de soquete será o endereço IP do balanceador de carga ou proxy.

Use a condição de correspondência de endereço remoto, se precisar de correspondência com base no endereço IP original do cliente.

• Use a notação CIDR ao especificar blocos de endereço IP. Isso significa que a sintaxe para um bloco de endereços IP é o endereço IP básico seguido por uma barra invertida e o tamanho do prefixo. Por exemplo:
  • Exemplo de IPv4: 5.5.5.64/26 corresponde a qualquer solicitação que chega dos endereços 5.5.5.64 a 5.5.5.127.
  • Exemplo de IPv6: 1:2:3:/48 corresponde a solicitações que chegam dos endereços 1:2:3:0:0:0:0:0 por meio de 1:2:3: ffff:ffff:ffff:ffff:ffff.
• Quando você especifica vários endereços IP e blocos de endereço IP, a lógica “OR” é aplicada.
  • Exemplo de IPv4: se você adicionar dois endereços IP 1.2.3.4 e 10.20.30.40, a condição será correspondida em todas as solicitações que chegarem dos endereços 1.2.3.4 ou 10.20.30.40.
  • Exemplo de IPv6: se você adicionar dois endereços IP 1:2:3:4:5:6:7:8 e 10:20:30:40:50:60:70:80, a condição será correspondida em todas as solicitações que chegarem do endereço 1:2:3:4:5:6:7:8 ou 10:20:30:40:50:60:70:80.

Propriedades

Propriedade	Valores com suporte
Operador	No portal do Azure: IP MatchNot IP Match Em modelos do ARM: IPMatch; use a propriedade negateCondition para especificar Sem correspondência de IP
Valor	Especifique um ou mais intervalos de endereços IP. Se vários intervalos de endereços IP forem especificados, eles serão avaliados usando lógica OR.

Exemplo

Neste exemplo, correspondemos a todas as solicitações de endereços IP no intervalo 5.5.5.64/26.

Portal

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'
  }
}

Porta do cliente

A condição de correspondência de porta do cliente identifica solicitações com base na porta TCP do cliente que fez a solicitação. Você pode especificar vários valores para correspondência, que podem ser combinados usando a lógica OR.

Propriedades

Propriedade	Valores com suporte
Operador	Há suporte para todos os operadores da lista de operadores padrão. No entanto, a condição de correspondência Any corresponde a todas as solicitações e a condição de correspondência Not Any não corresponde a nenhuma solicitação, quando usada com a condição de correspondência de porta do cliente.
Valor	Um ou mais números de porta, expressos como inteiros. Se vários valores forem especificados, eles serão avaliados por meio de lógica OR.

Exemplo

Neste exemplo, correspondemos a todas as solicitações com a porta do cliente 1234.

Portal

JSON

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

Bicep

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

Porta do servidor

A condição de correspondência de porta do servidor identifica solicitações com base na porta TCP do servidor do Azure Front Door que aceitou a solicitação. A porta deve ser 80 ou 443. Você pode especificar vários valores para correspondência, que podem ser combinados usando a lógica OR.

Propriedades

Propriedade	Valores com suporte
Operador	Há suporte para todos os operadores da lista de operadores padrão. No entanto, a condição de correspondência Any corresponde a todas as solicitações e a condição de correspondência Not Any não corresponde a nenhuma solicitação, quando usada com a condição de correspondência de porta do servidor.
Valor	Um número de porta que deve ser 80 ou 443. Se vários valores forem especificados, eles serão avaliados por meio de lógica OR.

Exemplo

Neste exemplo, correspondemos a todas as solicitações com a porta do servidor 443.

Portal

JSON

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

Bicep

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

Lista de operadores

Para regras que aceitam valores da lista de operadores padrão, os seguintes operadores são válidos:

Operador	Descrição	Suporte ao modelo ARM
Qualquer	Corresponde quando há algum valor, independentemente do que for.	operator: Any
Igual	Corresponde quando o valor corresponde exatamente à cadeia de caracteres especificada.	operator: Equal
Contém	Corresponde quando o valor contém a cadeia de caracteres especificada.	operator: Contains
Menor que	Corresponde quando o tamanho do valor é menor que o inteiro especificado.	operator: LessThan
Maior que	Corresponde quando o tamanho do valor é maior que o inteiro especificado.	operator: GreaterThan
Menor que ou igual a	Corresponde quando o tamanho do valor é menor ou igual ao inteiro especificado.	operator: LessThanOrEqual
Maior que ou igual a	Corresponde quando o tamanho do valor é maior ou igual ao inteiro especificado.	operator: GreaterThanOrEqual
Começa Com	Corresponde quando o valor começa com a cadeia de caracteres especificada.	operator: BeginsWith
Termina com	Corresponde quando o valor termina com a cadeia de caracteres especificada.	operator: EndsWith
Não qualquer	Corresponde quando não há valor.	operator: Any e negateCondition: true
Diferente	Corresponde quando o valor não corresponde à cadeia de caracteres especificada.	operator: Equal e negateCondition: true
Não contém	Corresponde quando o valor não contém a cadeia de caracteres especificada.	operator: Contains e negateCondition: true
Não é menor que	Corresponde quando o tamanho do valor é menor que o inteiro especificado.	operator: LessThan e negateCondition: true
Não é maior que	Corresponde quando o tamanho do valor é maior que o inteiro especificado.	operator: GreaterThan e negateCondition: true
Não inferior ou Igual a	Corresponde quando o tamanho do valor é menor ou igual ao inteiro especificado.	operator: LessThanOrEqual e negateCondition: true
Não é maior nem igual a	Corresponde quando o tamanho do valor é maior ou igual ao inteiro especificado.	operator: GreaterThanOrEqual e negateCondition: true
Não começa com	Corresponde quando o valor não começa com a cadeia de caracteres especificada.	operator: BeginsWith e negateCondition: true
Não termina com	Corresponde quando o valor não termina com a cadeia de caracteres especificada.	operator: EndsWith e negateCondition: true

Operador	Descrição	Suporte ao modelo ARM
Qualquer	Corresponde quando há algum valor, independentemente do que for.	operator: Any
Igual	Corresponde quando o valor corresponde exatamente à cadeia de caracteres especificada.	operator: Equal
Contém	Corresponde quando o valor contém a cadeia de caracteres especificada.	operator: Contains
Menor que	Corresponde quando o tamanho do valor é menor que o inteiro especificado.	operator: LessThan
Maior que	Corresponde quando o tamanho do valor é maior que o inteiro especificado.	operator: GreaterThan
Menor que ou igual a	Corresponde quando o tamanho do valor é menor ou igual ao inteiro especificado.	operator: LessThanOrEqual
Maior que ou igual a	Corresponde quando o tamanho do valor é maior ou igual ao inteiro especificado.	operator: GreaterThanOrEqual
Começa Com	Corresponde quando o valor começa com a cadeia de caracteres especificada.	operator: BeginsWith
Termina com	Corresponde quando o valor termina com a cadeia de caracteres especificada.	operator: EndsWith
RegEx	Corresponde quando o valor corresponde à expressão regular especificada. Confira mais detalhes abaixo.	operator: RegEx
Não qualquer	Corresponde quando não há valor.	operator: Any e negateCondition: true
Diferente	Corresponde quando o valor não corresponde à cadeia de caracteres especificada.	operator: Equal e negateCondition: true
Não contém	Corresponde quando o valor não contém a cadeia de caracteres especificada.	operator: Contains e negateCondition: true
Não é menor que	Corresponde quando o tamanho do valor é menor que o inteiro especificado.	operator: LessThan e negateCondition: true
Não é maior que	Corresponde quando o tamanho do valor é maior que o inteiro especificado.	operator: GreaterThan e negateCondition: true
Não inferior ou Igual a	Corresponde quando o tamanho do valor é menor ou igual ao inteiro especificado.	operator: LessThanOrEqual e negateCondition: true
Não é maior nem igual a	Corresponde quando o tamanho do valor é maior ou igual ao inteiro especificado.	operator: GreaterThanOrEqual e negateCondition: true
Não começa com	Corresponde quando o valor não começa com a cadeia de caracteres especificada.	operator: BeginsWith e negateCondition: true
Não termina com	Corresponde quando o valor não termina com a cadeia de caracteres especificada.	operator: EndsWith e negateCondition: true
Não RegEx	Corresponde quando o valor não corresponde à expressão regular especificada. Confira mais detalhes abaixo.	operator: RegEx e negateCondition: true

Dica

Para operadores numéricos como Menor que e Maior ou igual a, a comparação usada é baseada no comprimento. O valor na condição de correspondência deve ser um inteiro que especifique o comprimento que você deseja comparar.

Expressões regulares

As expressões regulares não dão suporte às seguintes operações:

• Referências inversas e subexpressões de captura.
• Instruções assert arbitrárias de largura zero.
• Referências e padrões recursivos de sub-rotinas.
• Padrões condicionais.
• Verbos de controle de rastreamento inverso.
• A diretiva \C de byte único.
• A diretiva \R de correspondência de nova linha.
• A diretiva \K de início de redefinição de correspondência.
• Textos explicativos e códigos de inserção.
• Agrupamento atômico e quantificadores possessivos.

Lista de transformações de cadeia de caracteres

Para regras que podem transformar cadeias de caracteres, as seguintes transformações são válidas:

Transformação	Descrição	Suporte ao modelo ARM
Para letras minúsculas	Converte a cadeia de caracteres na representação em minúsculas.	Lowercase
Para letras maiúsculas	Converte a cadeia de caracteres na representação em maiúsculas.	Uppercase
Trim	Corta os espaços em branco à esquerda e à direita da cadeia de caracteres.	Trim
Remover nulos	Remove os valores nulos da cadeia de caracteres.	RemoveNulls
Codificação de URL	Codifica a cadeia de caracteres em URL.	UrlEncode
Decodificação de URL	Decodifica a cadeia de caracteres em URL.	UrlDecode

Próximas etapas

• Saiba mais sobre o Mecanismo de Regras do Azure Front Door (clássico)
• Saiba como configurar seu primeiro Mecanismo de Regras.
• Saiba mais sobre as Ações de regras

• Saiba mais sobre o Conjunto de Regras do Azure Front Door.
• Saiba como configurar seu primeiro Conjunto de Regras.
• Saiba mais sobre as Ações de regras.