Share via


Condições de correspondência no mecanismo de regras Standard para a Rede de Distribuição de Conteúdo do Azure

No mecanismo de regras Standard para a Rede de Distribuição de Conteúdo do Azure, a regra consiste em uma ou mais condições de correspondência e uma ação. Esse artigo fornece descrições detalhadas das condições de correspondência que você pode usar no mecanismo de regras Standard para a Rede de Distribuição de Conteúdo do Azure.

A primeira parte de uma regra é uma condição de correspondência ou um conjunto de condições de correspondência. No mecanismo de regras Standard para a Rede de Distribuição de Conteúdo do Azure, cada regra pode ter até quatro 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.

Por exemplo, você pode usar uma condição de correspondência para:

  • 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.

Condições de correspondência

As condições de correspondência a seguir estão disponíveis para uso no mecanismo de regras Standard da Rede de Distribuição de Conteúdo do Azure.

Tipo de dispositivo

Identifica solicitações feitas de um dispositivo móvel ou dispositivo de desktop.

Campos obrigatórios

Operador Valores com suporte
Igual, não igual Dispositivo móvel, desktop

Versão HTTP

Identifica solicitações com base em sua versão HTTP.

Campos obrigatórios

Operador Valores com suporte
Igual, não igual 2.0, 1.1, 1.0, 0.9, Todas

Solicitar cookies

Identifica solicitações com base em informações de cookie na solicitação recebida.

Campos obrigatórios

Nome do cookie Operador Valor do cookie Transformação de maiúsculas e minúsculas
String Lista de operadores padrão Cadeia de Caracteres, Int Nenhuma transformação em letras maiúsculas ou minúsculas

Principais informações

  • Você não pode usar valores curinga, (incluindo asteriscos (*)) ao especificar um nome de cookie; você precisa usar um nome de cookie exato.
  • Somente um nome de cookie único pode ser especificado por instância dessa condição de correspondência.
  • Comparações de nome de cookie diferenciam maiusculas de minúsculas.
  • Para especificar diversos valores de cookie, use um único espaço entre cada valor de cookie.
  • Os valores de cookie podem aproveitar os valores curinga.
  • Se um valor curinga não tiver sido especificado, apenas uma correspondência exata atenderá a essa condição de correspondência. Por exemplo, "Value" corresponde a "Value", mas não a "Value1".

Argumento post

Identifica solicitações com base em argumentos definidos para o método de solicitação POST usado na solicitação.

Campos obrigatórios

Nome do argumento Operador Valor do argumento Transformação de maiúsculas e minúsculas
String Lista de operadores padrão Cadeia de Caracteres, Int Nenhuma transformação em letras maiúsculas ou minúsculas

Cadeia de consulta

Identifica as solicitações que contêm um parâmetro de cadeia de caracteres de consulta específico. Esse parâmetro é definido como um valor que corresponde a um padrão específico. Parâmetros de cadeia de caracteres de consulta (por exemplo, parameter=value) na URL de solicitação determinam se essa condição é atendida. Essa condição de correspondência identifica um parâmetro de cadeia de caracteres de consulta por seu nome e aceita um ou mais valores para o valor do parâmetro.

Campos obrigatórios

Operador Cadeia de consulta Transformação de maiúsculas e minúsculas
Lista de operadores padrão Cadeia de Caracteres, Int Nenhuma transformação em letras maiúsculas ou minúsculas

Endereço remoto

Identifica solicitações com base na localização ou no endereço IP do solicitante.

Campos obrigatórios

Operador Valores com suporte
Qualquer N/D
Correspondência Geográfica Código do país
Correspondência de IP Endereço IP (separado por espaços)
Não qualquer N/D
Sem correspondência geográfica Código do país
Não Correspondência de IP Endereço IP (separado por espaços)

Principais informações

  • Use a notação CIDR (Roteamento entre Domínios sem Classificação).
  • Para especificar vários endereços IP e blocos de endereço IP, use um só espaço entre os valores:
    • Exemplo de IPv4:1.2.3.4 10.20.30.40 corresponde a qualquer solicitação que chegue do endereço 1.2.3.4 ou 10.20.30.40.
    • Exemplo de IPv6:1:2:3:4:5:6:7:8 10:20:30:40:50:60:70:80 corresponde a qualquer solicitação que chegue do endereço 1:2:3:4:5:6:7:8 ou 10:20:30:40:50:60:70:80.
  • 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 chegue do endereço 5.5.5.64 ou 5.5.5.127.
    • Exemplo de IPv6:1:2:3:/48 corresponde a qualquer solicitação que chegue dos endereços 1:2:3:0:0:0:0:0 até 1:2:3:ffff:ffff:ffff:ffff:ffff.
  • O Endereço Remoto representará o IP do cliente original, que pode ser da conexão de rede ou normalmente o cabeçalho da solicitação X-Forwardd-For, se o usuário estiver protegido por um proxy.

Corpo da solicitação

Identifica solicitações com base em um texto específico que aparece no corpo da solicitação.

Campos obrigatórios

Operador Corpo da solicitação Transformação de maiúsculas e minúsculas
Lista de operadores padrão Cadeia de Caracteres, Int Nenhuma transformação em letras maiúsculas ou minúsculas

Cabeçalho da solicitação

Identifica as solicitações que usam um cabeçalho específico na solicitação.

Campos obrigatórios

Nome do cabeçalho Operador Valor do cabeçalho Transformação de maiúsculas e minúsculas
String Lista de operadores padrão Cadeia de Caracteres, Int Nenhuma transformação em letras maiúsculas ou minúsculas

Método de solicitação

Identifica as solicitações que usam o método de solicitação especificado.

Campos obrigatórios

Operador Valores com suporte
Igual, não igual GET, POST, PUT, DELETE, HEAD, OPTIONS, TRACE

Principais informações

  • Somente o método de solicitação GET pode gerar conteúdo armazenado em cache na Rede de Distribuição de Conteúdo do Azure. Todos os outros métodos de solicitação são solicitados por proxy através da rede.

Protocolo de solicitação

Identifica as solicitações que usam o protocolo especificado usado.

Campos obrigatórios

Operador Valores com suporte
Igual, não igual HTTP, HTTPS

URL de Solicitação

Identifica as solicitações que correspondem à URL especificada.

Campos obrigatórios

Operador URL de Solicitação Transformação de maiúsculas e minúsculas
Lista de operadores padrão Cadeia de Caracteres, Int Nenhuma transformação em letras maiúsculas ou minúsculas

Principais informações

  • Ao usar essa condição de regra, inclua informações de protocolo. Por exemplo: https://www.<seudominio>.com.

Extensão do arquivo de URL

Identifica solicitações que incluem a extensão de arquivo especificada no nome do arquivo na URL solicitante.

Campos obrigatórios

Operador Extensão Transformação de maiúsculas e minúsculas
Lista de operadores padrão Cadeia de Caracteres, Int Nenhuma transformação em letras maiúsculas ou minúsculas

Principais informações

  • Para extensão, não inclua um ponto à esquerda; por exemplo, use html, em vez de .html.

Nome do arquivo de URL

Identifica solicitações que incluem o nome de arquivo especificado na URL solicitante.

Campos obrigatórios

Operador Nome do arquivo Transformação de maiúsculas e minúsculas
Lista de operadores padrão Cadeia de Caracteres, Int Nenhuma transformação em letras maiúsculas ou minúsculas

Principais informações

  • Para especificar diversos nomes de arquivo, separe cada nome de arquivo com um único espaço.

Caminho da URL

Identifica solicitações que incluem o caminho especificado na URL solicitante.

Campos obrigatórios

Operador Valor Transformação de maiúsculas e minúsculas
Lista de operadores padrão Cadeia de Caracteres, Int Nenhuma transformação em letras maiúsculas ou minúsculas

Principais informações

  • Um valor de nome de arquivo pode aproveitar os valores curinga. Por exemplo, cada padrão de nome de arquivo pode consistir em um ou mais asteriscos (*), onde cada asterisco corresponde a uma sequência de um ou mais caracteres.

Referência para condições de correspondência do mecanismo de regras

Lista de operadores padrão

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

  • Qualquer
  • É igual a
  • Contém
  • Começa com
  • Termina com
  • Menor que
  • Menor ou igual a
  • Maior que
  • Maior ou igual a
  • Não qualquer
  • Não contém
  • Não começa com
  • Não termina com
  • Não é menor que
  • Não é menor nem igual a
  • Não é maior que
  • Não é maior nem igual a

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

Próximas etapas