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

Important

CDN do Azure Standard da Microsoft (Classic) não suporta criação de perfil, integração de novos domínios ou certificados geridos e será retirado a 30 de setembro de 2027. Para evitar interrupções no serviço, migre para Azure Front Door Standard ou Premium. Para mais informações, consulte CDN do Azure Standard from Microsoft (classic) descontinuação.

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. Este artigo fornece descrições detalhadas das condições de correspondência que pode usar no motor de regras Standard para o Rede de Entrega de Conteúdos do Azure.

A primeira parte de uma regra é uma condição de correspondência ou um conjunto de condições de correspondência. No motor de regras padrão 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 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.

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

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

Condições de jogo

As seguintes condições de correspondência estão disponíveis para utilização no motor de regras padrão do Rede de Entrega de Conteúdos do Azure.

Tipo de dispositivo

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

Campos obrigatórios

Operator Valores suportados
É igual, não é igual Dispositivos móveis, Desktop

Versão HTTP

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

Campos obrigatórios

Operator Valores suportados
É igual, não é igual 2.0, 1.1, 1.0, 0.9, Todos

Solicitar cookies

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

Campos obrigatórios

Nome do cookie Operator Valor do cookie Transformação de caso
String Lista de operadores padrão String, Int Sem transformação, para maiúsculas, para minúsculas

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.
  • As comparações de nomes de cookies são indiferentes a maiúsculas e minúsculas.
  • Para especificar vários valores de cookie, use um único espaço entre cada valor de cookie.
  • Os valores dos cookies podem tirar partido dos valores dos coringas.
  • Se um valor de coringa não tiver sido especificado, apenas uma correspondência exata satisfaz esta condição de correspondência. 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

Nome do argumento Operator Valor do argumento Transformação de caso
String Lista de operadores padrão String, Int Sem transformação, para maiúsculas, para minúsculas

String de consulta

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

Operator String de consulta Transformação de Caso
Lista de operadores padrão String, Int Sem transformação, para maiúsculas, para minúsculas

Endereço remoto

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

Campos obrigatórios

Operator Valores suportados
Any N/A
Geo Match Código do país
IP Match Endereço IP (separado por espaço)
Nenhum N/A
Não corresponde geograficamente. Código do país
IP Não Correspondente Endereço IP (separado por espaço)

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.
  • O Endereço Remoto representa o IP original do cliente que provém da ligação de rede ou tipicamente do cabeçalho de pedido X-Forwarded-For se o utilizador estiver atrás de um proxy.

Órgão solicitante

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

Campos obrigatórios

Operator Órgão solicitante Transformação de caso
Lista de operadores padrão String, Int Sem transformação, para maiúsculas, para minúsculas

Cabeçalho da requisição

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

Campos obrigatórios

Nome do cabeçalho Operator Valor do cabeçalho Transformação de caso
String Lista de operadores padrão String (cadeia de caracteres), Int (número inteiro) Sem transformação, para maiúsculas, para minúsculas

Método de solicitação

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

Campos obrigatórios

Operator Valores suportados
É igual, não é igual OBTER, PUBLICAR, COLOCAR, APAGAR, CABEÇA, OPÇÕES, RASTREAR

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

Operator Valores suportados
É igual, não é igual HTTP, HTTPS

URL da solicitação

Identifica solicitações que correspondem à URL especificada.

Campos obrigatórios

Operator URL da solicitação Transformação de caso
Lista de operadores padrão Cadeia de caracteres, Inteiro Sem transformação, para maiúsculas, para minúsculas

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

Operator Extensão Transformação de caso
Lista de operadores padrão String, Int Sem transformação, para maiúsculas, para minúsculas

Informações essenciais

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

Nome do arquivo URL

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

Campos obrigatórios

Operator Nome de ficheiro Transformação de caso
Lista de operadores padrão String, Int Sem transformação, para maiúsculas, para minúsculas

Informações essenciais

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

Caminho do URL

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

Campos obrigatórios

Operator Value Transformada de Caso
Lista de operadores padrão Cadeia de caracteres, Inteiro Sem transformação, para maiúsculas, para minúsculas

Informações essenciais

  • Um valor de nome de ficheiro pode tirar partido dos 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 regras de condições de jogo do motor

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
  • Termina com
  • Menos de
  • Menor ou igual
  • Maior que
  • Maior que ou igual
  • Nenhum
  • Não contém
  • Não se inicia com
  • Não termina com
  • Não menos que
  • 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