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. Por um valor de 0 segundos, o CDN armazena em cache o conteúdo, mas deve revalidar cada solicitação com o servidor de origem. 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.

Portal

JSON

{
  "name": "RouteConfigurationOverride",
  "parameters": {
    "originGroupOverride": {
      "originGroup": {
        "id": "/subscriptions/<subscription-id>/resourcegroups/<resource-group-name>/providers/Microsoft.Cdn/profiles/<profile-name>/originGroups/MyOriginGroup"
      },
      "forwardingProtocol": "MatchRequest"
    },
    "cacheConfiguration": null,
    "typeName": "DeliveryRuleRouteConfigurationOverrideActionParameters"
  }
}

Bicep

{
  name: 'RouteConfigurationOverride'
  parameters: {
    originGroupOverride: {
      originGroup: {
        id: '/subscriptions/<subscription-id>/resourcegroups/<resource-group-name>/providers/Microsoft.Cdn/profiles/<profile-name>/originGroups/MyOriginGroup'
      }
      forwardingProtocol: 'MatchRequest'
    }
    cacheConfiguration: null
    typeName: 'DeliveryRuleRouteConfigurationOverrideActionParameters'
  }
}

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.

Portal

JSON

{
  "name": "RouteConfigurationOverride",
  "parameters": {
    "cacheConfiguration": {
      "queryStringCachingBehavior": "IncludeSpecifiedQueryStrings",
      "queryParameters": "customerId",
      "isCompressionEnabled": "Enabled",
      "cacheBehavior": "HonorOrigin",
      "cacheDuration": null
    },
    "originGroupOverride": null,
    "typeName": "DeliveryRuleRouteConfigurationOverrideActionParameters"
  }
}

Bicep

{
  name: 'RouteConfigurationOverride'
  parameters: {
    cacheConfiguration: {
      queryStringCachingBehavior: 'IncludeSpecifiedQueryStrings'
      queryParameters: 'customerId'
      isCompressionEnabled: 'Enabled'
      cacheBehavior: 'HonorOrigin'
      cacheDuration: null
    }
    originGroupOverride: null
    typeName: 'DeliveryRuleRouteConfigurationOverrideActionParameters'
  }
}

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.

Portal

JSON

{
  "name": "RouteConfigurationOverride",
  "parameters": {
    "cacheConfiguration": {
      "queryStringCachingBehavior": "IgnoreQueryString",
      "cacheBehavior": "OverrideIfOriginMissing",
      "cacheDuration": "0.06:00:00",
    },
    "originGroupOverride": null,
    "typeName": "DeliveryRuleRouteConfigurationOverrideActionParameters"
  }
}

Bicep

{
  name: 'RouteConfigurationOverride'
  parameters: {
    cacheConfiguration: {
      queryStringCachingBehavior: 'IgnoreQueryString'
      cacheBehavior: 'OverrideIfOriginMissing'
      cacheDuration: '0.06:00:00'
    }
    originGroupOverride: null
    typeName: 'DeliveryRuleRouteConfigurationOverrideActionParameters'
  }
}

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.

Portal

JSON

{
  "name": "ModifyRequestHeader",
  "parameters": {
    "headerAction": "Append",
    "headerName": "MyRequestHeader",
    "value": "AdditionalValue",
    "typeName": "DeliveryRuleHeaderActionParameters"
  }
}

Bicep

{
  name: 'ModifyRequestHeader'
  parameters: {
    headerAction: 'Append'
    headerName: 'MyRequestHeader'
    value: 'AdditionalValue'
    typeName: 'DeliveryRuleHeaderActionParameters'
  }
}

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.

Portal

JSON

{
  "name": "ModifyResponseHeader",
  "parameters": {
    "headerAction": "Delete",
    "headerName": "X-Powered-By",
    "typeName": "DeliveryRuleHeaderActionParameters"
  }
}

Bicep

{
  name: 'ModifyResponseHeader'
  parameters: {
    headerAction: 'Delete'
    headerName: 'X-Powered-By'
    typeName: 'DeliveryRuleHeaderActionParameters'
  }
}

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.

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_ipvariável de servidor.

Portal

JSON

{
  "name": "UrlRedirect",
  "parameters": {
    "redirectType": "TemporaryRedirect",
    "destinationProtocol": "Https",
    "customHostname": "contoso.com",
    "customPath": "/exampleredirection",
    "customQueryString": "clientIp={client_ip}",
    "typeName": "DeliveryRuleUrlRedirectActionParameters"
  }
}

Bicep

{
  name: 'UrlRedirect'
  parameters: {
    redirectType: 'TemporaryRedirect'
    destinationProtocol: 'Https'
    customHostname: 'contoso.com'
    customPath: '/exampleredirection'
    customQueryString: 'clientIp={client_ip}'
    typeName: 'DeliveryRuleUrlRedirectActionParameters'
  }
}

Reconfiguração de URL

Use a ação reescrita de URL para reescrever o caminho de uma solicitação que é roteada para sua origem.

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.

Portal

JSON

{
  "name": "UrlRewrite",
  "parameters": {
    "sourcePattern": "/",
    "destination": "/redirection",
    "preserveUnmatchedPath": false,
    "typeName": "DeliveryRuleUrlRewriteActionParameters"
  }
}

Bicep

{
  name: 'UrlRewrite'
  parameters: {
    sourcePattern: '/'
    destination: '/redirection'
    preserveUnmatchedPath: false
    typeName: 'DeliveryRuleUrlRewriteActionParameters'
  }
}

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 Standard ou Premium do Azure Front Door 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.