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 |
|
Cache |
|
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 |
|
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 |
|
Comportamento do cache |
|
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.
|
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.
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.
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.
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 |
|
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
.
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 |
|
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.
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.
|
Protocolo de redirecionamento |
|
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.
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.
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
- Saiba como configurar seu primeiro conjunto de Regras.
- Saiba mais sobre as condições de correspondência do conjunto de Regras.
- Saiba mais sobre conjuntos de regras do Azure Front Door.