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.

Critérios de correspondência

As seguintes condições de correspondência 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

Versão HTTP

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

Campos obrigatórios

Solicitar cookies

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

Campos obrigatórios

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 nomes de cookies não diferenciam maiúsculas 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 esse critério de correspondência. Por exemplo, "Value" corresponde a "Value", mas não a "Value1".

Argumento de POST

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

Campos obrigatórios

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

Endereço remoto

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

Campos obrigatórios

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 chega dos endereços 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 chega dos endereços 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 chega dos endereços 5.5.5.64 a 5.5.5.127.
  • Exemplo de IPv6: 1:2:3:/48 corresponde a qualquer solicitação que chegue dos endereços entre 1:2:3:0:0:0:0:0 até 1:2:3:ffff:ffff:ffff:ffff:ffff.
• O Endereço Remoto representa o IP do cliente original, que pode ser da conexão de rede ou normalmente do cabeçalho da solicitação X-Forwarded-For, se o usuário estiver atrás de 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

Cabeçalho da solicitação

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

Campos obrigatórios

Método de solicitação

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

Campos obrigatórios

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

URL de Solicitação

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

Campos obrigatórios

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

Principais informações

• Para extensão, não inclua um ponto no começo; 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

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

Principais informações

• Um valor de nome de arquivo pode utilizar 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
• Nenhum
• 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

• Visão geral da Rede de Distribuição de Conteúdo do Azure
• Referência do mecanismo de regras padrão
• Ações no mecanismo de regras Standard
• Impor HTTPS usando o mecanismo de regras Standard