Condições de correspondência das regras

Nos conjuntos de Regras da Porta da Frente do Azure, uma regra consiste em nenhuma ou algumas condições de correspondência e uma ação. Este artigo fornece descrições detalhadas das condições de correspondência que você pode usar nos 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 migrar 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 Aposentadoria (clássica) do Azure Front Door.

Nos mecanismos de regras do Azure Front Door (clássico ), uma regra consiste em nenhuma ou algumas condições de correspondência e uma ação. Este artigo fornece descrições detalhadas das condições de correspondência que você pode usar nos mecanismos de regras do Azure Front Door (clássico).

A primeira parte de uma regra é uma condição de correspondência ou um conjunto de condições de correspondência. Uma regra pode consistir em até 10 condições de jogo. Uma condição de correspondência identifica tipos específicos de solicitações para as quais ações definidas são feitas. Se você usar várias condições de correspondência, as condições de correspondência serão agrupadas usando a lógica AND. Para todas as condições de correspondência que suportam vários valores, a lógica OR é usada.

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

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

• Filtre solicitações com base em um endereço IP específico ou país/região.
• Filtre solicitações por informações de cabeçalho.
• Filtre solicitações de dispositivos móveis ou desktop.
• Filtre solicitações de nome de arquivo de solicitação e extensão de arquivo.
• Filtre 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 de tipo de dispositivo para identificar solicitações que são de um dispositivo móvel ou dispositivo desktop.

Propriedades

Property	Valores suportados
Operador	No portal do Azure: Equal, Not Equal Em modelos ARM: Equal; use a negateCondition propriedade para especificar Not Equal
Value	Mobile, Desktop

Exemplo

Neste exemplo, correspondemos a todas as solicitações que foram detetadas 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 de versão HTTP para identificar solicitações feitas usando uma versão específica do protocolo HTTP.

Nota

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

Propriedades

Property	Valores suportados
Operador	No portal do Azure: Equal, Not Equal Em modelos ARM: Equal; use a negateCondition propriedade para especificar Not Equal
Value	2.0, 1.1, 1.0, 0.9

Exemplo

Neste exemplo, correspondemos a todas as solicitações que foram 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

Utilize a condição de correspondência dos cookies de pedido para identificar pedidos que incluam um cookie específico.

Nota

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

Propriedades

Property	Valores suportados
Nome do cookie	Um valor de cadeia de caracteres que representa o nome do cookie.
Operador	Qualquer operador da lista de operadores padrão.
Value	Um ou mais valores de cadeia de caracteres ou inteiros que representam o valor do cabeçalho da solicitação a ser correspondido. Se vários valores forem especificados, eles serão avaliados usando a lógica OR.
Transformação de caso	Qualquer transformação da lista de transformações de cadeia de caracteres padrão.

Exemplo

Neste exemplo, correspondemos a todas as solicitações que têm um cookie nomeado 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'
  }
}

Post args

Use a condição de correspondência de args 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 a serem correspondidos, que podem ser combinados usando a lógica OR.

Nota

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

Propriedades

Property	Valores suportados
Post args	Um valor de cadeia de caracteres que representa o nome do argumento POST.
Operador	Qualquer operador da lista de operadores padrão.
Value	Um ou mais valores de cadeia de caracteres ou inteiros que representam o valor do argumento POST a ser correspondido. Se vários valores forem especificados, eles serão avaliados usando a lógica OR.
Transformação de caso	Qualquer transformação da lista de transformações de cadeia de caracteres padrão.

Exemplo

Neste exemplo, correspondemos a todas as solicitações POST em que um customerName argumento é 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 maiúsculas e minúsculas para converter os valores de entrada em maiúsculas para que os valores que começam com J, j, Ke 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'
  }
}

Cadeias de consulta

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

Nota

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

Propriedades

Property	Valores suportados
Operador	Todos os operadores da lista de operadores padrão são suportados. No entanto, a condição Qualquer correspondência corresponde a todas as solicitações e a condição Não corresponde a nenhuma solicitação, quando usada com a condição de correspondência da cadeia de caracteres de consulta.
Cadeias de consulta	Um ou mais valores de cadeia de caracteres ou inteiros que representam o valor da cadeia de caracteres de consulta a ser correspondida. Não inclua o ? no início da cadeia de caracteres de consulta. Se vários valores forem especificados, eles serão avaliados usando a lógica OR.
Transformação de caso	Qualquer transformação da lista de transformações de cadeia de caracteres padrão.

Exemplo

Neste exemplo, correspondemos a 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, por isso não transformamos o caso.

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 na localização ou no endereço IP do solicitante. Você pode especificar vários valores a serem correspondidos, que podem ser combinados usando a lógica OR.

• Use a notação CIDR ao especificar blocos de endereço IP. A sintaxe de um bloco de endereço IP é o endereço IP base seguido por uma barra e o tamanho do prefixo. Por exemplo:
  • Exemplo de IPv4: 5.5.5.64/26 corresponde a todas as solicitações que chegam dos endereços 5.5.5.64 a 5.5.5.127.
  • Exemplo de IPv6: 1:2:3:/48 corresponde a quaisquer solicitações que chegam de endereços 1:2:3:0:0:0:0:0 até 1:2:3: ffff:ffff:ffff:ffff:ffff.
• Quando você especifica vários endereços IP e blocos de endereços IP, a lógica 'OR' é aplicada.
  • Exemplo de IPv4: se você adicionar dois endereços 1.2.3.4 IP e 10.20.30.40, a condição será correspondida para todas as solicitações que chegarem de qualquer endereço 1.2.3.4 ou 10.20.30.40.
  • Exemplo de IPv6: se você adicionar dois endereços 1:2:3:4:5:6:7:8 IP e 10:20:30:40:50:60:70:80, a condição será correspondida para todas as solicitações que chegarem de qualquer 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 da solicitação X-Forwarded-For se o usuário estiver atrás de um proxy. Use a condição de correspondência de endereço de soquete (disponível em Standard/Premium), se precisar corresponder com base no endereço IP da solicitação TCP.

Propriedades

Property	Valores suportados
Operador	No portal do Azure: Geo Match, Geo Not Match, IP Match, ou IP Not Match Em modelos ARM: GeoMatch, IPMatch; use a negateCondition propriedade para especificar Geo Not Match ou IP Not Match
Value	Para os IP Match operadores 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 a lógica OR. Para os operadores ouGeo Not Match: especifique um ou mais locais usando o código do Geo Match país.

Exemplo

Neste exemplo, correspondemos a todas as solicitações em que a solicitação não teve origem nos 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 do pedido

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

Nota

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

Propriedades

Property	Valores suportados
Operador	Todos os operadores da lista de operadores padrão são suportados. No entanto, a condição Qualquer correspondência corresponde a todas as solicitações, e a condição Nenhuma correspondência não corresponde a nenhuma solicitação, quando usada com a condição de correspondência do corpo da solicitação.
Value	Um ou mais valores de cadeia de caracteres ou inteiros que representam o valor do texto do corpo da solicitação a ser correspondido. Se vários valores forem especificados, eles serão avaliados usando a lógica OR.
Transformação de caso	Qualquer transformação da lista de transformações de cadeia de caracteres padrão.

Exemplo

Neste exemplo, correspondemos a 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 maiúsculas antes de avaliar a correspondência, assim error e outras variações de maiúsculas e minúsculas também acionam 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'
  }
}

Solicitar nome do arquivo

A condição de correspondência de nome de 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 a serem correspondidos, que podem ser combinados usando a lógica OR.

Propriedades

Property	Valores suportados
Operador	Todos os operadores da lista de operadores padrão são suportados. No entanto, a condição Qualquer correspondência corresponde a todas as solicitações, e a condição Nenhuma correspondência não corresponde a nenhuma solicitação, quando usada com a condição de correspondência do nome do arquivo de solicitação.
Value	Um ou mais valores de cadeia de caracteres ou inteiros que representam o valor do nome do arquivo de solicitação a ser correspondido. Se vários valores forem especificados, eles serão avaliados usando a lógica OR.
Transformação de caso	Qualquer transformação da lista de transformações de cadeia de caracteres padrão.

Exemplo

Neste exemplo, correspondemos a todas as solicitações em que o nome do arquivo de solicitação é media.mp4. Transformamos o nome do arquivo em minúsculas antes de avaliar a correspondência, portanto MEDIA.MP4 , e outras variações de maiúsculas e minúsculas também acionam 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'
  }
}

Solicitar extensão de arquivo

A condição de correspondência de extensão de 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 a serem correspondidos, que podem ser combinados usando a lógica OR.

Nota

Não inclua um período principal. Por exemplo, use html em vez de .html.

Propriedades

Property	Valores suportados
Operador	Todos os operadores da lista de operadores padrão são suportados. No entanto, a condição Qualquer correspondência corresponde a todas as solicitações, e a condição Nenhuma correspondência não corresponde a nenhuma solicitação, quando usada com a condição de correspondência de extensão de arquivo de solicitação .
Value	Um ou mais valores de cadeia de caracteres ou inteiros que representam o valor da extensão de arquivo de solicitação a ser correspondida. Não inclua um período principal. Se vários valores forem especificados, eles serão avaliados usando a lógica OR.
Transformação de caso	Qualquer transformação da lista de transformações de cadeia de caracteres padrão.

Exemplo

Neste exemplo, correspondemos a todas as solicitações em que a extensão de arquivo de solicitação é pdf ou docx. Transformamos a extensão do arquivo de solicitação em minúsculas antes de avaliar a correspondência, portanto PDF, , DocXe 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 do pedido

A condição de correspondência do cabeçalho da solicitação identifica as 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 para verificar se o cabeçalho corresponde a um valor especificado. Você pode especificar vários valores a serem correspondidos, que podem ser combinados usando a lógica OR.

Propriedades

Property	Valores suportados
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.
Value	Um ou mais valores de cadeia de caracteres ou inteiros que representam o valor do cabeçalho da solicitação a ser correspondido. Se vários valores forem especificados, eles serão avaliados usando a lógica OR.
Transformação de caso	Qualquer transformação da lista de transformações de cadeia de caracteres padrão.

Exemplo

Neste exemplo, correspondemos a 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 do método de solicitação identifica as solicitações que usam o método de solicitação HTTP especificado. Você pode especificar vários valores a serem correspondidos, que podem ser combinados usando a lógica OR.

Propriedades

Property	Valores suportados
Operador	No portal do Azure: Equal, Not Equal Em modelos ARM: Equal; use a negateCondition propriedade para especificar Not Equal
Método de solicitação	Um ou mais métodos HTTP de: GET, POST, PUT, , HEADDELETE, OPTIONS, TRACE. Se vários valores forem especificados, eles serão avaliados usando a lógica OR.

Exemplo

Neste exemplo, correspondemos a todas as solicitações em que a solicitação usa o DELETE método.

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 do pedido

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

Nota

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

Property	Valores suportados
Operador	Todos os operadores da lista de operadores padrão são suportados. No entanto, a condição Qualquer correspondência corresponde a todas as solicitações, e a condição Não corresponde a nenhuma solicitação, quando usada com a condição de correspondência do 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 files/customer*/file.pdf curinga corresponde aos caminhos files/customer1/file.pdf, files/customer109/file.pdfe files/customer/file.pdf, mas não corresponde a files/customer2/anotherfile.pdf. No portal do Azure: Wildcards, Not Wildcards Em modelos ARM: Wildcard; use a negateCondition propriedade para especificar Not Wildcards
Value	Um ou mais valores de cadeia de caracteres ou inteiros que representam o valor do caminho da solicitação a ser correspondido. Se você especificar uma barra à esquerda, ela será ignorada. Se vários valores forem especificados, eles serão avaliados usando a lógica OR.
Transformação de caso	Qualquer transformação da lista de transformações de cadeia de caracteres padrão.

Property	Valores suportados
Operador	Todos os operadores da lista de operadores padrão são suportados. No entanto, a condição Qualquer correspondência corresponde a todas as solicitações, e a condição Não corresponde a nenhuma solicitação, quando usada com a condição de correspondência do caminho da solicitação.
Value	Um ou mais valores de cadeia de caracteres ou inteiros que representam o valor do caminho da solicitação a ser correspondido. Se você especificar uma barra à esquerda, ela será ignorada. Se vários valores forem especificados, eles serão avaliados usando a lógica OR.
Transformação de caso	Qualquer transformação da lista de transformações de cadeia de caracteres padrão.

Exemplo

Neste exemplo, correspondemos a 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 do protocolo de solicitação identifica solicitações que usam o protocolo especificado (HTTP ou HTTPS).

Nota

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

Propriedades

Property	Valores suportados
Operador	No portal do Azure: Equal, Not Equal Em modelos ARM: Equal; use a negateCondition propriedade para especificar Not Equal
Método de solicitação	HTTP, HTTPS

Exemplo

Neste exemplo, correspondemos a todas as solicitações em que a solicitação usa o HTTP protocolo.

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 do Pedido

Identifica 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 a serem correspondidos, que podem ser combinados usando a lógica OR.

Gorjeta

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

Propriedades

Property	Valores suportados
Operador	Todos os operadores da lista de operadores padrão são suportados. No entanto, a condição Qualquer correspondência corresponde a todas as solicitações, e a condição Não corresponde a nenhuma solicitação, quando usada com a condição de correspondência de URL da solicitação.
Value	Um ou mais valores de cadeia de caracteres ou inteiros que representam o valor da URL da solicitação a ser correspondida. Se vários valores forem especificados, eles serão avaliados usando a lógica OR.
Transformação de caso	Qualquer transformação da lista de transformações de cadeia de caracteres padrão.

Exemplo

Neste exemplo, correspondemos a todas as solicitações em que o URL da solicitação começa com https://api.contoso.com/customers/123. Transformamos a extensão do arquivo de solicitação em minúsculas antes de avaliar a correspondência, portanto, solicitações para https://api.contoso.com/Customers/123 e outras variações de maiúsculas e minúsculas também acionarã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 anfitrião

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

Propriedades

Property	Valores suportados
Operador	Todos os operadores da lista de operadores padrão são suportados. No entanto, a condição Qualquer correspondência corresponde a todas as solicitações, e a condição Nenhuma correspondência não corresponde a nenhuma solicitação, quando usada com a condição de correspondência do nome do host.
Value	Um ou mais valores de cadeia de caracteres que representam o valor de request hostname a ser correspondido. Se vários valores forem especificados, eles serão avaliados usando a lógica OR.
Transformação de caso	Qualquer transformação de maiúsculas e minúsculas da lista de transformações de cadeia de caracteres padrão.

Exemplo

Neste exemplo, correspondemos todas as solicitações com um Host cabeçalho 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 a serem correspondidos, que podem ser combinados usando a lógica OR.

Propriedades

Property	Valores suportados
Operador	No portal do Azure: Equal, Not Equal Em modelos ARM: Equal; use a negateCondition propriedade para especificar Not Equal
Protocolo SSL	No portal do Azure: 1.0, 1.1, 1.2 Em modelos 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 do 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 da Porta da Frente do Azure. Você pode especificar vários valores a serem correspondidos, que podem ser combinados usando a lógica OR.

Nota

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

Use a condição de correspondência de endereço remoto se precisar corresponder 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 de um bloco de endereço IP é o endereço IP base seguido por uma barra e o tamanho do prefixo. Por exemplo:
  • Exemplo de IPv4: 5.5.5.64/26 corresponde a todas as solicitações que chegam dos endereços 5.5.5.64 a 5.5.5.127.
  • Exemplo de IPv6: 1:2:3:/48 corresponde a quaisquer solicitações que chegam de endereços 1:2:3:0:0:0:0:0 até 1:2:3: ffff:ffff:ffff:ffff:ffff.
• Quando você especifica vários endereços IP e blocos de endereços IP, a lógica 'OR' é aplicada.
  • Exemplo de IPv4: se você adicionar dois endereços 1.2.3.4 IP e 10.20.30.40, a condição será correspondida para todas as solicitações que chegarem de qualquer endereço 1.2.3.4 ou 10.20.30.40.
  • Exemplo de IPv6: se você adicionar dois endereços 1:2:3:4:5:6:7:8 IP e 10:20:30:40:50:60:70:80, a condição será correspondida para todas as solicitações que chegarem de qualquer endereço 1:2:3:4:5:6:7:8 ou 10:20:30:40:50:60:70:80.

Propriedades

Property	Valores suportados
Operador	No portal do Azure: IP Match, Not IP Match Em modelos ARM: IPMatch; use a negateCondition propriedade para especificar Not IP Match
Value	Especifique um ou mais intervalos de endereços IP. Se vários intervalos de endereços IP forem especificados, eles serão avaliados usando a 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 a serem correspondidos, que podem ser combinados usando a lógica OR.

Propriedades

Property	Valores suportados
Operador	Todos os operadores da lista de operadores padrão são suportados. No entanto, a condição Qualquer correspondência corresponde a todas as solicitações, e a condição Nenhuma correspondência não corresponde a nenhuma solicitação, quando usada com a condição de correspondência da porta do cliente.
Value	Um ou mais números de porta, expressos como inteiros. Se vários valores forem especificados, eles serão avaliados usando a lógica OR.

Exemplo

Neste exemplo, correspondemos todas as solicitações com uma porta de cliente de 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 da porta do servidor identifica solicitações com base na porta TCP do servidor Azure Front Door que aceitou a solicitação. A porta deve ser 80 ou 443. Você pode especificar vários valores a serem correspondidos, que podem ser combinados usando a lógica OR.

Propriedades

Property	Valores suportados
Operador	Todos os operadores da lista de operadores padrão são suportados. No entanto, a condição Qualquer correspondência corresponde a todas as solicitações, e a condição Não corresponde a nenhuma solicitação, quando usada com a condição de correspondência da porta do servidor.
Value	Um número de porta, que deve ser 80 ou 443. Se vários valores forem especificados, eles serão avaliados usando a lógica OR.

Exemplo

Neste exemplo, correspondemos todas as solicitações com uma porta de servidor de 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:

Operator	Descrição	Suporte para modelos do ARM
Qualquer	Corresponde quando existe algum valor, independentemente do que for.	operator: Any
Igual	Corresponde quando o valor corresponde exatamente à cadeia especificada.	operator: Equal
Contains	Corresponde quando o valor contém a cadeia especificada.	operator: Contains
Menor do Que	Corresponde quando o comprimento do valor é menor do que o número inteiro especificado.	operator: LessThan
Maior Que	Corresponde quando o comprimento do valor é maior do que o número inteiro especificado.	operator: GreaterThan
Menor ou Igual a	Corresponde quando o comprimento do valor é menor ou igual ao número inteiro especificado.	operator: LessThanOrEqual
Maior Ou Igual A	Corresponde quando o comprimento do valor é maior ou igual ao número inteiro especificado.	operator: GreaterThanOrEqual
Começa Por	Corresponde quando o valor começa com a cadeia especificada.	operator: BeginsWith
Termina Com	Corresponde quando o valor termina com a cadeia especificada.	operator: EndsWith
Nenhum	Corresponde quando não há nenhum valor.	operator: Any e negateCondition : true
Não É Igual A	Corresponde quando o valor não corresponde à cadeia especificada.	operator: Equal e negateCondition : true
Não Contém	Corresponde quando o valor não contém a cadeia especificada.	operator: Contains e negateCondition : true
Não É Menor do Que	Corresponde quando o comprimento do valor não é menor do que o número inteiro especificado.	operator: LessThan e negateCondition : true
Não É Maior do Que	Corresponde quando o comprimento do valor não é maior do que o número inteiro especificado.	operator: GreaterThan e negateCondition : true
Não É Menor do Que ou Igual A	Corresponde quando o comprimento do valor não é menor ou igual ao número inteiro especificado.	operator: LessThanOrEqual e negateCondition : true
Não maior que ou igual	Corresponde quando o comprimento do valor não é 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

Operator	Descrição	Suporte para modelos do ARM
Qualquer	Corresponde quando existe algum valor, independentemente do que for.	operator: Any
Igual	Corresponde quando o valor corresponde exatamente à cadeia especificada.	operator: Equal
Contains	Corresponde quando o valor contém a cadeia especificada.	operator: Contains
Menor do Que	Corresponde quando o comprimento do valor é menor do que o número inteiro especificado.	operator: LessThan
Maior Que	Corresponde quando o comprimento do valor é maior do que o número inteiro especificado.	operator: GreaterThan
Menor ou Igual a	Corresponde quando o comprimento do valor é menor ou igual ao número inteiro especificado.	operator: LessThanOrEqual
Maior Ou Igual A	Corresponde quando o comprimento do valor é maior ou igual ao número inteiro especificado.	operator: GreaterThanOrEqual
Começa Por	Corresponde quando o valor começa com a cadeia especificada.	operator: BeginsWith
Termina Com	Corresponde quando o valor termina com a cadeia especificada.	operator: EndsWith
RegEx	Corresponde quando o valor corresponde à expressão regular especificada. Veja abaixo mais detalhes.	operator: RegEx
Nenhum	Corresponde quando não há nenhum valor.	operator: Any e negateCondition : true
Não É Igual A	Corresponde quando o valor não corresponde à cadeia especificada.	operator: Equal e negateCondition : true
Não Contém	Corresponde quando o valor não contém a cadeia especificada.	operator: Contains e negateCondition : true
Não É Menor do Que	Corresponde quando o comprimento do valor não é menor do que o número inteiro especificado.	operator: LessThan e negateCondition : true
Não É Maior do Que	Corresponde quando o comprimento do valor não é maior do que o número inteiro especificado.	operator: GreaterThan e negateCondition : true
Não É Menor do Que ou Igual A	Corresponde quando o comprimento do valor não é menor ou igual ao número inteiro especificado.	operator: LessThanOrEqual e negateCondition : true
Não maior que ou igual	Corresponde quando o comprimento do valor não é 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. Veja abaixo mais detalhes.	operator: RegEx e negateCondition : true

Gorjeta

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

Expressões regulares

As expressões regulares não suportam as seguintes operações:

• Backreferences e captura de subexpressões.
• Asserções arbitrárias de largura zero.
• Referências subrotineiras e padrões recursivos.
• Padrões condicionais.
• Retroceder verbos de controle.
• A \C diretiva de byte único.
• A diretiva relativa à \R correspondência da nova linha.
• O \K início da diretiva de redefinição de correspondência.
• Textos explicativos e código incorporado.
• Agrupamento atómico e quantificadores possessivos.

Lista de transformação de cadeia de caracteres

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

Transformação	Description	Suporte para modelos do ARM
Para minúsculas	Converte a cadeia de caracteres para a representação minúscula.	Lowercase
Para maiúsculas	Converte a cadeia de caracteres para a representação em maiúsculas.	Uppercase
Trim	Corta espaços em branco à esquerda e à direita da cadeia de caracteres.	Trim
Remover nulos	Remove valores nulos da cadeia de caracteres.	RemoveNulls
Codificação de URL	URL-codifica a cadeia de caracteres.	UrlEncode
Decodificação de URL	URL-decodifica a cadeia de caracteres.	UrlDecode

Próximos passos

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

• Saiba mais sobre o Conjunto de Regras da Porta da Frente do Azure.
• Saiba como configurar seu primeiro Conjunto de Regras.
• Saiba mais sobre as ações de regra.