Compartilhar via


Ações de conjunto de regras

Um conjunto de regras do Azure Front Door consiste em regras com uma combinação de ações e condições de correspondência. Este artigo fornece uma descrição detalhada das ações que você pode usar em um conjunto de regras. Uma ação define o comportamento que é aplicado a um tipo de solicitação que uma condição de correspondência identifica. Em um conjunto de regras, uma regra pode ter até cinco ações. O Front Door também dá suporte à variável de servidor em uma ação de conjunto de regras.

As ações a seguir estão disponíveis para uso em um conjunto de regras:

Substituição de configuração de rota

Use a ação de substituição de configuração de rota para substituir o grupo de origem ou a configuração de cache a ser usada para a solicitação. Você pode optar por substituir ou manter as configurações do grupo de origem especificadas na rota. No entanto, quando você substitui a configuração de rota, é necessário configurar o cache. Caso contrário, o cache é desabilitado para a solicitação.

Você também pode substituir como os arquivos são armazenados em cache para solicitações específicas, incluindo:

  • Substitua o comportamento de cache especificado pela origem.
  • Como os parâmetros de cadeia de caracteres de consulta são usados para gerar a chave de cache da solicitação.
  • O valor de TTL (vida útil) para controlar por quanto tempo o conteúdo permanecerá no cache.

Propriedades

Propriedade Valores com suporte
Substituição do grupo de origem
  • Sim: substitua o grupo de origem usado para a solicitação.
  • Não: use o grupo de origem especificado na rota.
Cache
  • Habilitado: force o cache a ser habilitado para a solicitação.
  • Desabilitado: force o cache a ser desabilitado para a solicitação.

Quando a opção Substituir grupo de origem estiver definida como Sim, defina as seguintes propriedades:

Propriedade Valores com suporte
Grupo de origem O grupo de origem para o qual a solicitação deve ser roteada. Esta configuração substitui a configuração especificada na rota do ponto de extremidade do Front Door.
Protocolo de encaminhamento O protocolo para que o Front Door seja usado ao encaminhar a solicitação para a origem. Os valores com suporte são somente HTTP, somente HTTPS, Corresponder à solicitação de entrada. Esta configuração substitui a configuração especificada na rota do ponto de extremidade do Front Door.

Quando o Cache estiver definido como Habilitado, defina as seguintes propriedades:

Propriedade Valores com suporte
Comportamento de cache da cadeia de caracteres de consulta
  • Ignorar Cadeia de Caracteres de Consulta: as cadeias de caracteres de consulta não são consideradas quando a chave de cache é gerada. Em modelos do ARM, defina a propriedade queryStringCachingBehavior como IgnoreQueryString.
  • Usar cadeia de caracteres de consulta: cada URL exclusiva tem sua própria chave de cache. Em modelos do ARM, use queryStringCachingBehavior de UseQueryString.
  • Ignorar cadeia de caracteres de consulta especificada: as cadeias de caracteres de consulta especificadas nos parâmetros são excluídas quando a chave de cache é gerada. Em modelos do ARM, defina a propriedade queryStringCachingBehavior como IgnoreSpecifiedQueryStrings.
  • Incluir cadeia de caracteres de consulta especificada: as cadeias de caracteres de consulta especificadas nos parâmetros são incluídas quando a chave de cache é gerada. Em modelos do ARM, defina a propriedade queryStringCachingBehavior como IncludeSpecifiedQueryStrings.
Parâmetros de consulta A lista de nomes de parâmetros de cadeia de caracteres de consulta, separados por vírgulas. Essa propriedade é definida somente quando o Comportamento do cache da cadeia de caracteres de consulta for definido como Ignorar Cadeias de Caracteres de Consulta Especificadas ou Incluir Cadeias de Caracteres de Consulta Especificadas.
Compactação
  • Habilitado: o Front Door compacta dinamicamente o conteúdo na borda, resultando em uma resposta menor e mais rápida. Para obter mais informações, confira Compactação de arquivo. Em modelos do ARM, defina a propriedade isCompressionEnabled como Enabled.
  • Desabilitado. O Front Door não executa compactação. Em modelos do ARM, defina a propriedade isCompressionEnabled como Disabled.
Comportamento do cache
  • Obedecer à origem: o Front Door sempre obedece à diretiva do cabeçalho de resposta de origem. Se a diretiva de origem estiver ausente, o Azure Front Door armazenará em cache o conteúdo durante um a três dias. Em modelos do ARM, defina a propriedade cacheBehavior como HonorOrigin.
  • Sempre substituir: o valor de TTL retornado de sua origem é substituído pelo valor especificado na ação. Esse comportamento só é aplicado se a resposta for armazenável em cache. Em modelos do ARM, defina a propriedade cacheBehavior como OverrideAlways.
  • Substituir se a origem estiver ausente: se a origem não retornar um valor de TTL, a regra definirá o TTL como o valor especificado na ação. Esse comportamento só é aplicado se a resposta for armazenável em cache. Em modelos do ARM, defina a propriedade cacheBehavior como OverrideIfOriginMissing.
Duração do cache Quando o Comportamento do cache é definido como Override always ou Override if origin missing, esses campos devem especificar a duração do cache a ser usada. A duração máxima é de 366 dias. Essa propriedade é definida somente quando o Comportamento do cache for definido como Sempre substituir ou Substituir se a origem estiver ausente.
  • No portal do Azure: especifique os dias, as horas, os minutos e os segundos.
  • Nos modelos do ARM: use o cacheDuration para especificar a duração no formato d.hh:mm:ss.

Exemplos

Neste exemplo, rotearemos todas as solicitações corresponderes para um grupo de origem chamado MyOriginGroup, independentemente da configuração na rota do ponto de extremidade do Front Door.

Captura de tela do portal mostrando a ação de substituição do grupo de origem.

Neste exemplo, configuramos a chave de cache para incluir um parâmetro de cadeia de caracteres de consulta chamado customerId. A compactação está habilitada e as políticas de cache da origem são seguidas.

Captura de tela do portal mostrando a ação da cadeia de caracteres de consulta da chave de cache.

Neste exemplo, substituímos a expiração do cache por 6 horas, para solicitações correspondentes que ainda não especificam uma duração de cache. O Front Door ignora a cadeia de caracteres de consulta, quando determina a chave de cache e a compactação está habilitada.

Captura de tela do portal mostrando a ação de expiração do cache.

Modificar o cabeçalho de solicitação

Use a ação modificar cabeçalho da solicitação para modificar os cabeçalhos na solicitação quando ela for enviada para sua origem.

Propriedades

Propriedade Valores com suporte
Operador
  • Acrescentar: o cabeçalho especificado é adicionado à solicitação com o valor especificado. Se o cabeçalho já estiver presente, o valor será anexado ao valor de cabeçalho usando a concatenação da cadeia de caracteres. Nenhum delimitador foi adicionado. Em modelos do ARM, use headerAction de Append.
  • Substituir: o cabeçalho especificado é adicionado à solicitação com o valor especificado. Se o cabeçalho já estiver presente, o valor especificado substituirá o valor existente. Em modelos do ARM, use headerAction de Overwrite.
  • Excluir: se o cabeçalho especificado na regra estiver presente, o cabeçalho será excluído da solicitação. Em modelos do ARM, use headerAction de Delete.
Nome do cabeçalho O nome do cabeçalho a ser modificado.
Valor do cabeçalho O valor a ser acrescentado ou substituído.

Exemplo

Neste exemplo, acrescentamos o valor AdditionalValue ao cabeçalho da solicitação MyRequestHeader. Se a origem definir o cabeçalho de resposta como um valor de ValueSetByClient, depois que essa ação for aplicada, o cabeçalho da solicitação terá um valor de ValueSetByClientAdditionalValue.

Captura de tela do portal mostrando a ação modificar cabeçalho da solicitação.

Observação

Determinados cabeçalhos reservados do Azure Front Door não podem ser modificados usando ações do mecanismo de regras, incluindo as ações para modificar cabeçalhos de solicitação e cabeçalhos de resposta. A lista a seguir de cabeçalhos reservados não pode ser modificada, juntamente com quaisquer cabeçalhos prefixados com x-ec e x-fd.

  • Accept-Ranges
  • Host
  • Connection
  • Content-Length
  • Transfer-Encoding
  • TE
  • Last-Modified
  • Keep-Alive
  • Expect
  • Upgrade
  • If-Modified-Since
  • If-Unmodified-Since
  • If-None-Match
  • If-Match
  • Range
  • If-Range
  • X-Ms-Via
  • X-Ms-Force-Refresh
  • X-MSEdge-Ref
  • Warning
  • Forwarded
  • Via
  • X-Forwarded-For
  • X-Forwarded-Proto
  • X-Forwarded-Host
  • X-Azure-RequestChain
  • X-Azure-FDID
  • X-Azure-RequestChainv2
  • X-Azure-Ref

Modificar o cabeçalho de resposta

Use a ação modificar cabeçalho da resposta para modificar os cabeçalhos que estão presentes nas respostas antes de serem retornadas aos clientes.

Propriedades

Propriedade Valores com suporte
Operador
  • Acrescentar: o cabeçalho especificado é adicionado à resposta com o valor especificado. Se o cabeçalho já estiver presente, o valor será anexado ao valor de cabeçalho usando a concatenação da cadeia de caracteres. Nenhum delimitador foi adicionado. Em modelos do ARM, use headerAction de Append.
  • Substituir: o cabeçalho especificado é adicionado à resposta com o valor especificado. Se o cabeçalho já estiver presente, o valor especificado substituirá o valor existente. Em modelos do ARM, use headerAction de Overwrite.
  • Excluir: se o cabeçalho especificado na regra estiver presente, o cabeçalho será excluído da resposta. Em modelos do ARM, use headerAction de Delete.
Nome do cabeçalho O nome do cabeçalho a ser modificado.
Valor do cabeçalho O valor a ser acrescentado ou substituído.

Exemplo

Neste exemplo, excluímos o cabeçalho com o nome X-Powered-By das respostas antes que elas sejam retornadas ao cliente.

Captura de tela do portal mostrando a ação modificar cabeçalho da resposta.

Observação

Determinados cabeçalhos reservados do Azure Front Door não podem ser modificados usando ações do mecanismo de regras, incluindo as ações para modificar cabeçalhos de solicitação e cabeçalhos de resposta. A lista a seguir de cabeçalhos reservados não pode ser modificada, juntamente com quaisquer cabeçalhos prefixados com x-ec e x-fd.

  • Accept-Ranges
  • Host
  • Connection
  • Content-Length
  • Transfer-Encoding
  • TE
  • Last-Modified
  • Keep-Alive
  • Expect
  • Upgrade
  • If-Modified-Since
  • If-Unmodified-Since
  • If-None-Match
  • If-Match
  • Range
  • If-Range
  • X-Ms-Via
  • X-Ms-Force-Refresh
  • X-MSEdge-Ref
  • Warning
  • Forwarded
  • Via
  • X-Forwarded-For
  • X-Forwarded-Proto
  • X-Forwarded-Host
  • X-Azure-RequestChain
  • X-Azure-FDID
  • X-Azure-RequestChainv2
  • X-Azure-Ref

Redirecionamento de URL

Use a ação redirecionamento de URL para redirecionar clientes para uma nova URL. Os clientes recebem uma resposta de redirecionamento do Front Door. O Azure Front Door dá suporte à captura dinâmica do caminho da URL com a variável de servidor {url_path:seg#} e converte o caminho da URL em minúsculas ou maiúsculas com {url_path.tolower} ou {url_path.toupper}. Para obter mais informações, confira Variáveis de servidor.

Propriedades

Propriedade Valores com suporte
Tipo de redirecionamento O tipo de resposta para retornar ao solicitante.
  • No portal do Azure: Encontrado (302), Movido (301), Redirecionamento Temporário (307), Redirecionamento Permanente (308).
  • Nos modelos do ARM: Found, Moved, TemporaryRedirect, PermanentRedirect
Protocolo de redirecionamento
  • No portal do Azure: Match Request, HTTP, HTTPS
  • Nos modelos do ARM: MatchRequest, Http, Https
Host de destino O nome do host para o qual você deseja que a solicitação seja redirecionada. Deixe em branco para preservar o host de entrada.
Caminho de destino O caminho a ser usado no redirecionamento. Inclua o entrelinhamento/. Deixe em branco para preservar o caminho de entrada.
Cadeia de consulta A cadeia de consulta usada no redirecionamento. Não inclua o entrelinhamento?. Deixe em branco para preservar a cadeia de consulta de entrada.
Fragmento de destino O fragmento a ser usado no redirecionamento. Deixe em branco para preservar o fragmento de entrada.

Exemplo

Neste exemplo, redirecionamos a solicitação para https://contoso.com/exampleredirection?clientIp={client_ip}, enquanto preservamos o fragmento. Um Redirecionamento Temporário HTTP (307) é usado. O endereço IP do cliente é usado no lugar do {client_ip} token dentro da URL usando a client_ip variável de servidor.

Captura de tela do portal mostrando ação de redirecionamento de URL.

Reconfiguração de URL

Use a ação reescrita de URL para reescrever o caminho de uma solicitação que é roteada para sua origem. O Azure Front Door dá suporte à captura dinâmica do caminho da URL com a variável de servidor {url_path:seg#} e converte o caminho da URL em minúsculas ou maiúsculas com {url_path.tolower} ou {url_path.toupper}. Para obter mais informações, confira Variáveis de servidor.

Propriedades

Propriedade Valores com suporte
Padrão de origem Defina o padrão de origem no caminho da URL a ser substituído. Atualmente, o padrão de origem usa uma correspondência baseada em prefixo. Para corresponder a todos os caminhos de URL, use uma barra (/) como o valor de padrão de origem.
Destino Defina o caminho de destino para usar na reescrita. O caminho de destino substitui o padrão de origem.
Preservar caminho sem correspondência Se definido como Sim, o caminho restante após o padrão de origem será acrescentado ao novo caminho de destino.

Exemplo

Neste exemplo, reescrevemos todas as solicitações no caminho /redirection e não preservamos o restante do caminho.

Captura de tela do portal mostrando ação de reescrita de URL.

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 a camada Azure Front Door Standard ou Premium até março de 2027. Para obter mais informações, consulte Desativação do Azure Front Door (clássico).

No Azure Front Door (clássico), um mecanismo de Regras pode consistir em até 25 regras que contêm condições de correspondência e ações associadas. Este artigo apresenta uma descrição detalhada de cada ação que você pode definir em uma regra.

Uma ação define o comportamento que é aplicado ao tipo de solicitação que corresponde à condição ou ao conjunto de condições correspondente. Na configuração do mecanismo de regras, uma regra pode ter até 10 condições de correspondência e 5 ações. Você só pode ter uma ação Substituir configuração de roteamento em uma regra.

As ações a seguir estão disponíveis para uso no mecanismo de regras do Azure Front Door.

Modificar o cabeçalho de solicitação

Use essas ações para modificar os cabeçalhos que estão presentes nas solicitações enviadas para seu back-end.

Campos obrigatórios

Ação Nome do cabeçalho HTTP Valor
Acrescentar Quando essa opção for selecionada e houver uma correspondência de regra, o cabeçalho especificado em Nome do cabeçalho será adicionado à solicitação com o valor especificado. Se o cabeçalho já estiver presente, o valor será anexado ao valor existente. String
Overwrite Quando essa opção for selecionada e houver uma correspondência de regra, o cabeçalho especificado em Nome do cabeçalho será adicionado à solicitação com o valor especificado. Se o cabeçalho já estiver presente, o valor especificado substituirá o valor existente. String
Excluir Quando essa opção for selecionada com regras de correspondência e o cabeçalho especificado na regra estiver presente, o cabeçalho será excluído da solicitação. String

Modificar o cabeçalho de resposta

Use essas ações para modificar os cabeçalhos que estão presentes nas respostas retornadas aos clientes.

Campos obrigatórios

Ação Nome do cabeçalho HTTP Valor
Acrescentar Quando essa opção for selecionada e houver uma correspondência de regra, o cabeçalho especificado em Nome do cabeçalho será adicionado à resposta usando o Valor especificado. Se o cabeçalho já estiver presente, Valor será anexado ao valor existente. String
Overwrite Quando essa opção é selecionada e a regra corresponde, o cabeçalho especificado em Nome do cabeçalho é adicionado à resposta usando o Valor especificado. Se o cabeçalho já estiver presente, Valor substituirá o valor existente. String
Excluir Quando essa opção for selecionada com regras de correspondência e o cabeçalho especificado na regra estiver presente, o cabeçalho será excluído da resposta. String

Substituições de configuração de rota

Tipo de Rota: Redirecionar

Use essas ações para redirecionar clientes para uma nova URL.

Campos obrigatórios

Campo Descrição
Tipo de redirecionamento O redirecionamento é uma maneira de enviar usuários/clientes de uma URL para outra. Um tipo de redirecionamento define o código de status usado pelos clientes para entender a finalidade do redirecionamento.

Você pode selecionar os seguintes códigos de status de redirecionamento: Encontrado (302), Movido (301), Redirecionamento temporário (307) e Redirecionamento permanente (308).
Protocolo de redirecionamento Mantenha o protocolo de acordo com a solicitação de entrada ou defina um novo protocolo para o redirecionamento. Por exemplo, selecione "HTTPS" para redirecionamento HTTP para HTTPS.
Host de destino Defina este valor para alterar o nome do host na URL do redirecionamento ou para reter o nome do host da solicitação de entrada.
Caminho de destino Reter o caminho de acordo com a solicitação de entrada ou atualizar o caminho na URL do redirecionamento.
Cadeia de consulta Defina este valor para substituir todas as cadeias de consulta existentes na URL de solicitação de entrada ou para reter o conjunto original de cadeias de consulta.
Fragmento de destino O fragmento de destino é a parte da URL após “#” normalmente usada por navegadores para se colocar em uma seção específica de uma página. Defina este valor para adicionar um fragmento à URL de redirecionamento.

Tipo de Rota: Avançar

Use essas ações para encaminhar clientes para uma nova URL. Essa ação também contém subações para reescritas de URL e cache.

Campo Descrição
Pool de back-end Selecione um pool de back-end para substituir as solicitações e atendê-las, você vê todos os pools de back-end pré-configurados atualmente em seu perfil do Front Door.
Protocolo de encaminhamento Protocolo a ser usado para encaminhar a solicitação ao back-end ou corresponder ao protocolo da solicitação de entrada.
Reconfiguração de URL Caminho a ser usado ao construir a solicitação de regravação de URL a ser encaminhada para o back-end.
Cache Habilita o cache para essa regra de roteamento. Quando habilitado, o Azure Front Door armazena em cache o conteúdo estático.

Reconfiguração de URL

Use essa configuração para configurar um Caminho de Encaminhamento Personalizado opcional para usar ao construir a solicitação para encaminhar para o back-end.

Campo Descrição
Caminho de encaminhamento personalizado Defina um caminho para o qual as solicitações são encaminhadas.

Cache

Use estas configurações para controlar como os arquivos serão armazenados em cache para obter solicitações que contêm cadeias de caracteres de consulta. Além de saber se o conteúdo deve ser armazenado em cache com base em todos os parâmetros ou nos parâmetros selecionados. Será possível usar estas configurações para substituir o valor de TTL (vida útil) para controlar por quanto tempo o conteúdo permanecerá no cache. Para forçar o armazenamento em cache como uma ação, defina o campo de cache como "Habilitado". Quando você força o armazenamento em cache, as seguintes opções são exibidas:

Comportamento do cache Descrição
Ignorar a Cadeia de Caracteres de Consulta Depois que o ativo for armazenado em cache, todas as solicitações subsequentes ignorarão as cadeias de caracteres de consulta até que o ativo em cache expire.
Usar a Cadeia de Caracteres de Consulta Cada solicitação com um URL exclusiva, incluindo a cadeia de caracteres de consulta, é tratada como um ativo exclusivo com um cache próprio.
Ignorar as Cadeias de Caracteres de Consulta especificadas As cadeias de consulta da URL de solicitação listadas na configuração "parâmetros de consulta" são ignoradas para cache.
Incluir as Cadeias de Caracteres de Consulta especificadas As cadeias de consulta da URL de solicitação listadas na configuração "parâmetros de consulta" são usadas para cache.
Outros campos Descrição
Compactação dinâmica O Front Door pode compactar dinamicamente conteúdo na borda, resultando em uma resposta menor e mais rápida.
Parâmetros de consulta Uma lista separada por vírgula de parâmetros permitidos (ou não permitidos) a serem usados como base para o armazenamento em cache.
Usar a duração de cache padrão Defina para usar a duração de cache padrão do Azure Front Door ou defina uma duração de cache que ignore a diretiva de resposta de origem.

Próximas etapas