Condições de correspondência de regras

Nos conjuntos de Regras do Azure Front Door, uma regra consiste em nenhuma ou em algumas 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 o nível Azure Front Door Standard ou Premium até março de 2027. Para obter mais informações, veja Aposentadoria do Azure Front Door (clássico).

Nos mecanismos de Regras do Azure Front Door (clássico), uma regra consiste em nenhuma ou em algumas 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).

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 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, as condições de correspondência serão agrupadas em conjunto usando a lógica AND. Para todas 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 de 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 de 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.

Captura de tela do portal mostrando a condição de correspondência do tipo de dispositivo.

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.

Captura de tela do portal mostrando a condição de correspondência da versão HTTP.

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.

Captura de tela do portal mostrando a condição de correspondência de cookies de solicitação.

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.

Captura de tela do portal mostrando a condição de correspondência argumentos post.

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.

Captura de tela do portal mostrando uma condição de correspondência de cadeia de caracteres de consulta.

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.

Captura de tela do portal mostrando a condição de correspondência de endereço remoto.

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.

Captura de tela do portal mostrando a condição de correspondência de corpo da solicitação.

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.

Captura de tela do portal mostrando a condição de correspondência de nome de arquivo de solicitação.

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.

Captura de tela do portal mostrando a condição de correspondência de extensão de arquivo de solicitação.

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.

Captura de tela do portal mostrando a condição de correspondência do cabeçalho da solicitação.

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.

Captura de tela do portal mostrando a condição de correspondência do método de solicitação.

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.

Captura de tela do portal mostrando a condição de correspondência do caminho de solicitação.

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.

Captura de tela do portal mostrando a condição de correspondência do protocolo de solicitação.

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.

Captura de tela do portal mostrando a condição de correspondência da URL da solicitação.

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.

Captura de tela do portal mostrando a condição de correspondência do nome do host.

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.

Captura de tela do portal mostrando a condição de correspondência do protocolo SSL.

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.

Captura de tela do portal mostrando a condição de correspondência de endereço de soquete.

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.

Captura de tela do portal mostrando a condição de correspondência da porta de cliente.

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.

Captura de tela do portal mostrando a condição de correspondência da porta de servidor.

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