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

No mecanismo de regras padrão da Rede de Entrega de Conteúdo do Azure, uma regra consiste em uma ou mais condições de correspondência e uma ação. This article provides detailed descriptions of the match conditions you can use in the Standard rules engine for Azure Content Delivery Network.

The first part of a rule is a match condition or set of match conditions. In the Standard rules engine for Azure Content Delivery Network, each rule can have up to four match conditions. Uma condição de correspondência identifica tipos específicos de solicitações para as quais 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 usando a lógica AND.

For example, you can use a match condition to:

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

Match conditions

The following match conditions are available to use in the Standard rules engine for Azure Content Delivery Network.

Tipo de dispositivo

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

Campos obrigatórios

Versão HTTP

Identifica solicitações com base na versão HTTP da solicitação.

Campos obrigatórios

Solicitar cookies

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

Campos obrigatórios

Informações essenciais

• Não é possível usar valores curinga (incluindo asteriscos (*)) quando você especifica um nome de cookie; Você deve usar um nome de cookie exato.
• Você pode especificar apenas um único nome de cookie por instância dessa condição de correspondência.
• Cookie name comparisons are case-insensitive.
• Para especificar vários valores de cookie, use um único espaço entre cada valor de cookie.
• Cookie values can take advantage of wildcard values.
• If a wildcard value hasn't been specified, only an exact match satisfies this match condition. Por exemplo, "Value" corresponde a "Value", mas não a "Value1".

Pós-argumento

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

Campos obrigatórios

Query string

Identifica solicitações que contêm um parâmetro de cadeia de caracteres de consulta específico. Este parâmetro é definido como um valor que corresponde a um padrão específico. Os parâmetros da cadeia de caracteres de consulta (por exemplo, parameter=value) na URL da 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

Endereço remoto

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

Campos obrigatórios

Informações essenciais

• Use a notação CIDR (roteamento entre domínios sem classe).
• Para especificar vários endereços IP e blocos de endereços IP, use um único espaço entre os valores:
  • Exemplo de IPv4:1.2.3.4 10.20.30.40 corresponde a todas as solicitações que chegam de qualquer 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 todas as solicitações que chegam de qualquer endereço 1:2:3:4:5:6:7:8 ou 10:20:30:40:50:60:70:80.
• 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:ffff.
• Remote Address represents the original client IP that is either from the network connection or typically the X-Forwarded-For request header if the user is behind a proxy.

Request body

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

Campos obrigatórios

Request header

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

Campos obrigatórios

Método de solicitação

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

Campos obrigatórios

Informações essenciais

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

Protocolo de solicitação

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

Campos obrigatórios

Request URL

Identifica solicitações que correspondem à URL especificada.

Campos obrigatórios

Informações essenciais

• Ao usar essa condição de regra, certifique-se de incluir informações de protocolo. Por exemplo: https://www.<seudomínio>.com.

Extensão do arquivo URL

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

Campos obrigatórios

Informações essenciais

• For extension, don't include a leading period; for example, use html instead of .html.

Nome do arquivo URL

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

Campos obrigatórios

Informações essenciais

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

URL path

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

Campos obrigatórios

Informações essenciais

• A file name value can take advantage of wildcard values. 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.

Reference for rules engine match conditions

Lista de operadores padrão

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

• Any
• Equals
• Contains
• Começa com
• Ends with
• Less than
• Menor ou igual
• Greater than
• Maior que ou igual
• Not any
• Não contém
• Not begins with
• Not ends with
• Not less than
• Não inferior ou igual
• Não superior a
• Não superior ou igual

Para operadores numéricos como Menor que e Maior que ou igual, 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óximos passos

• Visão geral da Rede de Entrega de Conteúdo do Azure
• Standard rules engine reference
• Ações no mecanismo de regras padrão
• Impor HTTPS usando o mecanismo de regras padrão