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	Sim: Substitua o grupo de origem usado para a solicitação. Não: use o grupo de origem especificado na rota.
Colocação em cache	Habilitado: Força o cache a ser habilitado para a solicitação. Desabilitado: força o cache a ser desabilitado para a solicitação.

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	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 ARM, defina a queryStringCachingBehavior propriedade como IgnoreQueryString. Usar cadeia de caracteres de consulta: cada URL exclusivo tem sua própria chave de cache. Em modelos ARM, use o 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 ARM, defina a queryStringCachingBehavior propriedade 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 ARM, defina a queryStringCachingBehavior propriedade como IncludeSpecifiedQueryStrings.
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	Ativado: a porta frontal comprime dinamicamente o conteúdo na borda, resultando em uma resposta menor e mais rápida. Para obter mais informações, consulte Compactação de arquivos. Em modelos ARM, defina a isCompressionEnabled propriedade como Enabled. Desativado. O Front Door não realiza compressão. Em modelos ARM, defina a isCompressionEnabled propriedade como Disabled.
Comportamento do cache	Origem da honra: A porta da frente sempre honra a diretiva do cabeçalho de resposta de origem. Se a diretiva de origem estiver faltando, o Front Door armazenará em cache o conteúdo em qualquer lugar de 1 a 3 dias. Em modelos ARM, defina a cacheBehavior propriedade como HonorOrigin. Substituir sempre: o valor TTL retornado da sua origem é substituído pelo valor especificado na ação. Esse comportamento só é aplicado se a resposta for armazenável em cache. Em modelos ARM, defina a cacheBehavior propriedade como OverrideAlways. Substituir se a origem estiver ausente: se nenhum valor TTL for retornado da sua origem, 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 ARM, defina a cacheBehavior propriedade 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, a CDN armazena em cache o conteúdo, mas deve revalidar cada solicitação com o servidor de origem. Essa propriedade só é definida quando o comportamento de cache é definido como Substituir sempre ou Substituir se a origem estiver ausente. No portal do Azure: especifique os dias, horas, minutos e segundos. Em modelos ARM: use o cacheDuration para especificar a duração no formato d.hh:mm:ss.

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.

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

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

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 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	Acrescentar: O cabeçalho especificado é adicionado à solicitação com o valor especificado. Se o cabeçalho já estiver presente, o valor será acrescentado ao valor do cabeçalho existente usando concatenação de cadeia de caracteres. Nenhum delimitador é adicionado. Em modelos ARM, use o headerAction de Append. Substituição: 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 ARM, use o headerAction de Overwrite. Excluir: Se o cabeçalho especificado na regra estiver presente, o cabeçalho será excluído da solicitação. Em modelos ARM, use o 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 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.

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 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	Acrescentar: O cabeçalho especificado é adicionado à resposta com o valor especificado. Se o cabeçalho já estiver presente, o valor será acrescentado ao valor do cabeçalho existente usando concatenação de cadeia de caracteres. Nenhum delimitador é adicionado. Em modelos ARM, use o 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 ARM, use o headerAction de Overwrite. Excluir: se o cabeçalho especificado na regra estiver presente, o cabeçalho será excluído da resposta. Em modelos ARM, use o 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 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. No portal do Azure: Encontrado (302), Movido (301), Redirecionamento Temporário (307), Redirecionamento Permanente (308). Em modelos ARM: Found, Moved, TemporaryRedirect, , PermanentRedirect
Protocolo de redirecionamento	No portal do Azure: Match Request, HTTP, HTTPS Em modelos ARM: MatchRequest, Http, Https
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_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'
  }
}

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 /redirectione 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 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.