Ações do conjunto de regras
Um conjunto de regras do Azure Front Door consiste em regras com uma combinação de condições e açõ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. Front Door também suporta variável de servidor em uma ação de conjunto de regras.
As seguintes ações estão disponíveis para uso em um conjunto de regras:
Substituição da configuração de rota
A ação de substituição de configuração de rota é usada para substituir o grupo de origem ou a configuração de cache para a solicitação. Você pode optar por substituir ou honrar as configurações do grupo de origem especificadas na rota. No entanto, quando você substitui a configuração de rota, você deve configurar o cache. Caso contrário, o cache será desativado 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 da cadeia de caracteres de consulta são usados para gerar a chave de cache da solicitação.
- O valor TTL (time to live) para controlar quanto tempo o conteúdo permanece em cache.
_Propriedades
Property | Valores suportados |
---|---|
Substituir grupo de origem |
|
Colocação em cache |
|
Quando Substituir grupo de origem estiver definido como Sim, defina as seguintes propriedades:
Property | Valores suportados |
---|---|
Grupo de origem | O grupo de origem para o qual a solicitação deve ser encaminhada. Essa configuração substitui a configuração especificada na rota do ponto de extremidade Front Door. |
Protocolo de reencaminhamento | O protocolo para o Front Door usar ao encaminhar o pedido para a origem. Os valores suportados são somente HTTP, somente HTTPS, Corresponder solicitação de entrada. Essa configuração substitui a configuração especificada na rota do ponto de extremidade Front Door. |
Quando Caching estiver definido como Enabled, defina as seguintes propriedades:
Property | Valores suportados |
---|---|
Comportamento da colocação em cache de cadeias de consulta |
|
Parâmetros de consultas | A lista de nomes de parâmetros de cadeia de caracteres de consulta, separados por vírgulas. Essa propriedade só é definida quando o comportamento de cache de cadeia de caracteres de consulta é definido como Ignorar cadeias de caracteres de consulta especificadas ou Incluir cadeias de caracteres de consulta especificadas. |
Compressã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 só é definida quando o comportamento de cache é definido como Substituir sempre ou Substituir se a origem estiver ausente.
|
Exemplos
Neste exemplo, encaminhamos todas as solicitações correspondentes para um grupo de origem chamado MyOriginGroup
, independentemente da configuração na rota do ponto de extremidade Front Door.
Neste exemplo, definimos 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 respeitadas.
Neste exemplo, substituímos a expiração do cache para 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 cabeçalho de solicitação
Use a ação de modificar cabeçalho de solicitação para modificar os cabeçalhos na solicitação quando ela for enviada para sua origem.
_Propriedades
Property | Valores suportados |
---|---|
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 MyRequestHeader
solicitação. Se a origem definir o cabeçalho de resposta para um valor de ValueSetByClient
, depois que essa ação for aplicada, o cabeçalho da solicitação terá um valor de ValueSetByClientAdditionalValue
.
Nota
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 seguinte lista 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 cabeçalho de resposta
Use a ação modificar cabeçalho de resposta para modificar cabeçalhos que estão presentes nas respostas antes que eles sejam retornados aos seus clientes.
_Propriedades
Property | Valores suportados |
---|---|
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.
Nota
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 seguinte lista 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 de redirecionamento de URL para redirecionar os clientes para uma nova URL. Os clientes recebem uma resposta de redirecionamento da Front Door. O Azure Front Door dá suporte à captura dinâmica do caminho da URL com {url_path:seg#}
a variável de servidor 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, consulte Variáveis de servidor.
_Propriedades
Property | Valores suportados |
---|---|
Tipo de redirecionamento | O tipo de resposta a ser retornado ao solicitante.
|
Protocolo de redirecionamento |
|
Anfitrião 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 líder / . Deixe em branco para preservar o caminho de entrada. |
Cadeias de consulta | A cadeia de caracteres de consulta usada no redirecionamento. Não inclua o lead ? . Deixe em branco para preservar a cadeia de caracteres de consulta de entrada. |
Fragmento de destino | O fragmento a ser usado no redirecionamento. Deixe em branco para preservar o fragmento recebido. |
Exemplo
Neste exemplo, redirecionamos a solicitação para https://contoso.com/exampleredirection?clientIp={client_ip}
, preservando 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.
Reescrever URL
Use a ação de reconfiguração de URL para reescrever o caminho de uma solicitação que está a caminho da sua origem. O Azure Front Door dá suporte à captura dinâmica do caminho da URL com {url_path:seg#}
a variável de servidor 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, consulte Variáveis de servidor.
_Propriedades
Property | Valores suportados |
---|---|
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 do padrão de origem. |
Destino | Defina o caminho de destino a ser usado na regravação. O caminho de destino substitui o padrão de origem. |
Preservar caminho incomparável | Se definido como Sim, o caminho restante após o padrão de origem é anexado ao novo caminho de destino. |
Exemplo
Neste exemplo, reescrevemos todas as solicitações para o 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 migrar 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 Aposentadoria (clássica) do Azure Front Door.
No Azure Front Door (clássico), um mecanismo de regras pode consistir em até 25 regras contendo condições correspondentes e ações associadas. Este artigo fornece 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 de correspondência. Na configuração do mecanismo de regras, uma regra pode ter até 10 condições correspondentes e 5 ações. Você só pode ter uma ação Substituir Configuração de Roteamento em uma única regra.
As ações a seguir estão disponíveis para uso na configuração do mecanismo de regras.
Modificar cabeçalho de solicitação
Use essas ações para modificar cabeçalhos que estão presentes em solicitações enviadas ao seu back-end.
Campos obrigatórios
Ação | Nome do cabeçalho HTTP | Value |
---|---|---|
Acrescentar | Quando essa opção é selecionada e a regra corresponde, o cabeçalho especificado em Nome do cabeçalho é adicionado à solicitação com o valor especificado. Se o cabeçalho já estiver presente, o valor será acrescentado ao valor existente. | String |
Substituir | Quando essa opção é selecionada e a regra corresponde, o cabeçalho especificado em Nome do cabeçalho é adicionado à solicitação com o valor especificado. Se o cabeçalho já estiver presente, o valor especificado substituirá o valor existente. | String |
Delete | Quando essa opção é selecionada com regras correspondentes e o cabeçalho especificado na regra está presente, o cabeçalho é excluído da solicitação. | String |
Modificar cabeçalho de resposta
Use essas ações para modificar cabeçalhos que estão presentes nas respostas retornadas aos seus clientes.
Campos obrigatórios
Ação | Nome do cabeçalho HTTP | Value |
---|---|---|
Acrescentar | 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, Value será acrescentado ao valor existente. | String |
Substituir | 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, Value substituirá o valor existente. | String |
Delete | Quando essa opção é selecionada com regras correspondentes e o cabeçalho especificado na regra está presente, o cabeçalho é excluído da resposta. | String |
Substituições da configuração de rotas
Tipo de rota: Redirecionamento
Use essas ações para redirecionar os clientes para uma nova URL.
Campos obrigatórios
Campo | Descrição |
---|---|
Tipo de redirecionamento | O redirecionamento é uma forma de enviar utilizadores/clientes de um URL para outro. 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 de HTTP para HTTPS. |
Anfitrião de destino | Defina esse valor para alterar o nome do host na URL do redirecionamento ou reter o nome do host da solicitação de entrada. |
Caminho de destino | Retenha o caminho de acordo com a solicitação de entrada ou atualize o caminho na URL para o redirecionamento. |
Cadeias de consulta | Defina esse valor para substituir qualquer cadeia de caracteres de consulta existente da URL de solicitação de entrada ou manter o conjunto original de cadeias de caracteres de consulta. |
Fragmento de destino | O fragmento de destino é a parte do URL após '#', normalmente usado por navegadores para pousar em uma seção específica em uma página. Defina esse valor para adicionar um fragmento à URL de redirecionamento. |
Tipo de rota: Avançar
Use essas ações para encaminhar clientes para uma nova URL. Essas ações também contêm subações para regravações de URL e armazenamento em cache.
Campo | Descrição |
---|---|
Conjunto de back-end | Selecione o pool de back-end para substituir e atender às solicitações, você verá todos os seus pools de back-end pré-configurados atualmente em seu perfil Front Door. |
Protocolo de reencaminhamento | Protocolo a ser usado para encaminhar a solicitação para back-end ou corresponder ao protocolo da solicitação de entrada. |
Reescrever URL | Caminho a ser usado ao construir a solicitação de regravação de URL para encaminhar para o back-end. |
Colocação em cache | Habilite o cache para essa regra de roteamento. Quando habilitado, o Azure Front Door armazena em cache seu conteúdo estático. |
Reescrever URL
Use essa configuração para configurar um caminho de encaminhamento personalizado opcional a ser usado 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. |
Colocação em cache
Use essas configurações para controlar como os arquivos são armazenados em cache para solicitações que contêm cadeias de caracteres de consulta. Se deseja armazenar em cache seu conteúdo com base em todos os parâmetros ou em parâmetros selecionados. Você pode usar essas configurações para substituir o valor TTL (tempo de vida) para controlar por quanto tempo o conteúdo permanece em cache. Para forçar o cache como uma ação, defina o campo de cache como "Habilitado". Quando você força o cache, as seguintes opções aparecem:
Comportamento do cache | Description |
---|---|
Ignorar cadeia de caracteres de consulta | Depois que o ativo é armazenado em cache, todas as solicitações subsequentes ignoram as cadeias de caracteres de consulta até que o ativo armazenado em cache expire. |
Usar cadeia de caracteres de consulta | Cada solicitação com uma URL exclusiva, incluindo a cadeia de caracteres de consulta, é tratada como um ativo exclusivo com seu próprio cache. |
Ignorar cadeias de caracteres de consulta especificadas | As cadeias de caracteres de consulta de URL de solicitação listadas na configuração "Parâmetros de consulta" são ignoradas para cache. |
Incluir cadeias de caracteres de consulta especificadas | As cadeias de caracteres de consulta de URL de solicitação listadas na configuração "Parâmetros de consulta" são usadas para cache. |
Outros domínios | Description |
---|---|
Compressão dinâmica | O Front Door pode comprimir dinamicamente o conteúdo na borda, resultando em uma resposta menor e mais rápida. |
Parâmetros de consultas | Uma lista separada por vírgulas de parâmetros permitidos ou não permitidos para usar como base para armazenamento em cache. |
Usar a duração padrão do cache | Defina para usar a duração do cache padrão do Azure Front Door ou defina uma duração de cache que ignore a diretiva de resposta de origem. |
Próximos passos
- Saiba como configurar seu primeiro conjunto de regras.
- Saiba mais sobre as condições de correspondência do conjunto de regras.
- Saiba mais sobre os conjuntos de Regras da Porta da Frente do Azure.