Azioni del set di regole

Un set di regole di Frontdoor di Azure è costituito da regole con una combinazione di condizioni e azioni di corrispondenza. Questo articolo fornisce una descrizione dettagliata delle azioni che è possibile usare in un set di regole. Un'azione definisce il comportamento applicato a un tipo di richiesta identificato da una o più condizioni di corrispondenza. In un set di regole una regola può avere fino a cinque azioni. Frontdoor supporta anche la variabile server in un'azione del set di regole.

In un set di regole sono disponibili le azioni seguenti:

Override della configurazione della route

L'azione di override della configurazione della route viene usata per eseguire l'override del gruppo di origine o della configurazione di memorizzazione nella cache per la richiesta. È possibile scegliere di eseguire l'override o rispettare le configurazioni del gruppo di origine specificate nella route. Tuttavia, quando si esegue l'override della configurazione della route, è necessario configurare la memorizzazione nella cache. In caso contrario, la memorizzazione nella cache viene disabilitata per la richiesta.

È anche possibile eseguire l'override del modo in cui i file vengono memorizzati nella cache per richieste specifiche, tra cui:

• Eseguire l'override del comportamento di memorizzazione nella cache specificato dall'origine.
• Modalità di utilizzo dei parametri della stringa di query per generare la chiave della cache della richiesta.
• Valore TTL (Time to Live) per controllare per quanto tempo il contenuto rimane nella cache.

Proprietà

Proprietà	Valori supportati
Eseguire l'override del gruppo di origine	Sì: eseguire l'override del gruppo di origine usato per la richiesta. No: usare il gruppo di origine specificato nella route.
Memorizzazione nella cache	Abilitato: forzare l'abilitazione della memorizzazione nella cache per la richiesta. Disabilitato: forzare la disattivazione della memorizzazione nella cache per la richiesta.

Quando override del gruppo di origine è impostato su Sì, impostare le proprietà seguenti:

Proprietà	Valori supportati
Gruppo di origine	Gruppo di origine a cui deve essere instradata la richiesta. Questa impostazione esegue l'override della configurazione specificata nella route dell'endpoint frontdoor.
Protocollo di inoltro	Protocollo da usare per Frontdoor per l'inoltro della richiesta all'origine. I valori supportati sono solo HTTP, solo HTTPS, Corrispondenza richiesta in ingresso. Questa impostazione esegue l'override della configurazione specificata nella route dell'endpoint frontdoor.

Quando la memorizzazione nella cache è impostata su Abilitato, impostare le proprietà seguenti:

Proprietà	Valori supportati
Comportamento di memorizzazione nella cache della stringa di query	Ignora stringa di query: le stringhe di query non vengono considerate quando viene generata la chiave della cache. Nei modelli di Resource Manager impostare la queryStringCachingBehavior proprietà su IgnoreQueryString. Usare la stringa di query: ogni URL univoco ha una propria chiave della cache. Nei modelli di Resource Manager usare di queryStringCachingBehaviorUseQueryString. Ignora stringa di query specificata: le stringhe di query specificate nei parametri vengono escluse quando viene generata la chiave della cache. Nei modelli di Resource Manager impostare la queryStringCachingBehavior proprietà su IgnoreSpecifiedQueryStrings. Includere la stringa di query specificata: le stringhe di query specificate nei parametri vengono incluse quando viene generata la chiave della cache. Nei modelli di Resource Manager impostare la queryStringCachingBehavior proprietà su IncludeSpecifiedQueryStrings.
Parametri di query	Elenco dei nomi dei parametri della stringa di query, separati da virgole. Questa proprietà viene impostata solo quando il comportamento di memorizzazione nella cache della stringa di query di query è impostato su Ignora stringhe di query specificate o Includi stringhe di query specificate.
Compressione	Abilitata: Frontdoor comprime dinamicamente il contenuto sul bordo, ottenendo una risposta più piccola e veloce. Per altre informazioni, vedere Compressione dei file. Nei modelli di Resource Manager impostare la isCompressionEnabled proprietà su Enabled. Disabled. Frontdoor non esegue la compressione. Nei modelli di Resource Manager impostare la isCompressionEnabled proprietà su Disabled.
Comportamento cache	Rispetta l'origine: Frontdoor rispetta sempre la direttiva di intestazione della risposta di origine. Se manca la direttiva di origine, frontdoor memorizza nella cache il contenuto da 1 a 3 giorni. Nei modelli di Resource Manager impostare la cacheBehavior proprietà su HonorOrigin. Eseguire l'override sempre: il valore TTL restituito dall'origine viene sovrascritto con il valore specificato nell'azione. Questo comportamento viene applicato solo se la risposta è memorizzabile nella cache. Nei modelli di Resource Manager impostare la cacheBehavior proprietà su OverrideAlways. Eseguire l'override se l'origine manca: se non viene restituito alcun valore TTL dall'origine, la regola imposta il valore TTL sul valore specificato nell'azione. Questo comportamento viene applicato solo se la risposta è memorizzabile nella cache. Nei modelli di Resource Manager impostare la cacheBehavior proprietà su OverrideIfOriginMissing.
Durata cache	Quando il comportamento della cache è impostato su Override always o Override if origin missing, questi campi devono specificare la durata della cache da usare. La durata massima è di 366 giorni. Per un valore di 0 secondi, la rete CDN memorizza nella cache il contenuto, ma deve ripetere la convalida di ogni richiesta con il server di origine. Questa proprietà viene impostata solo quando il comportamento della cache è impostato su Override sempre o Override se l'origine manca. Nella portale di Azure: specificare i giorni, le ore, i minuti e i secondi. Nei modelli di Resource Manager usare per cacheDuration specificare la durata nel formato d.hh:mm:ss.

Esempi

In questo esempio vengono indirizzate tutte le richieste corrispondenti a un gruppo di origine denominato MyOriginGroup, indipendentemente dalla configurazione nella route dell'endpoint frontdoor.

Portale

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'
  }
}

In questo esempio viene impostata la chiave della cache in modo da includere un parametro della stringa di query denominato customerId. La compressione è abilitata e i criteri di memorizzazione nella cache dell'origine vengono rispettati.

Portale

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'
  }
}

In questo esempio si esegue l'override della scadenza della cache a 6 ore per le richieste corrispondenti che non specificano già una durata della cache. Frontdoor ignora la stringa di query quando determina la chiave della cache e la compressione è abilitata.

Portale

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'
  }
}

Modifica intestazione richiesta

Usare l'azione modifica intestazione richiesta per modificare le intestazioni nella richiesta quando viene inviata all'origine.

Proprietà

Proprietà	Valori supportati
Operatore	Append: l'intestazione specificata viene aggiunta alla richiesta con il valore specificato. Se l'intestazione è già presente, il valore viene aggiunto al valore dell'intestazione esistente usando la concatenazione di stringhe. Non vengono aggiunti delimitatori. Nei modelli di Resource Manager usare di headerActionAppend. Sovrascrittura: l'intestazione specificata viene aggiunta alla richiesta con il valore specificato. Se l'intestazione è già presente, il valore specificato sovrascrive quello esistente. Nei modelli di Resource Manager usare di headerActionOverwrite. Delete: se l'intestazione specificata nella regola è presente, l'intestazione viene eliminata dalla richiesta. Nei modelli di Resource Manager usare di headerActionDelete.
Nome intestazione	Nome dell'intestazione da modificare.
Valore intestazione	Valore da aggiungere o sovrascrivere.

Esempio

In questo esempio il valore AdditionalValue viene aggiunto all'intestazione della MyRequestHeader richiesta. Se l'origine imposta l'intestazione della risposta su un valore di ValueSetByClient, dopo l'applicazione di questa azione, l'intestazione della richiesta avrà il valore ValueSetByClientAdditionalValue.

Portale

JSON

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

Bicep

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

Modifica intestazione risposta

Usare l'azione modifica intestazione della risposta per modificare le intestazioni presenti nelle risposte prima che vengano restituite ai client.

Proprietà

Proprietà	Valori supportati
Operatore	Append: l'intestazione specificata viene aggiunta alla risposta con il valore specificato. Se l'intestazione è già presente, il valore viene aggiunto al valore dell'intestazione esistente usando la concatenazione di stringhe. Non vengono aggiunti delimitatori. Nei modelli di Resource Manager usare di headerActionAppend. Sovrascrittura: l'intestazione specificata viene aggiunta alla risposta con il valore specificato. Se l'intestazione è già presente, il valore specificato sovrascrive quello esistente. Nei modelli di Resource Manager usare di headerActionOverwrite. Delete: se l'intestazione specificata nella regola è presente, l'intestazione viene eliminata dalla risposta. Nei modelli di Resource Manager usare di headerActionDelete.
Nome intestazione	Nome dell'intestazione da modificare.
Valore intestazione	Valore da aggiungere o sovrascrivere.

Esempio

In questo esempio si elimina l'intestazione con il nome X-Powered-By dalle risposte prima che vengano restituite al client.

Portale

JSON

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

Bicep

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

Reindirizzamento URL

Usare l'azione di reindirizzamento URL per reindirizzare i client a un nuovo URL. I client vengono inviati una risposta di reindirizzamento da Frontdoor.

Proprietà

Proprietà	Valori supportati
Tipo di reindirizzamento	Tipo di risposta da restituire al richiedente. Nella portale di Azure: Trovato (302), Spostato (301), Reindirizzamento temporaneo (307), Reindirizzamento permanente (308). Nei modelli di Resource Manager: Found, Moved, TemporaryRedirect, PermanentRedirect
Protocollo di reindirizzamento	Nel portale di Azure: Match Request, HTTP,HTTPS Nei modelli di Resource Manager: MatchRequest, Http, Https
Host di destinazione	Nome host a cui si vuole reindirizzare la richiesta. Lasciare vuoto questo campo per mantenere l'host in ingresso.
Percorso di destinazione	Percorso da usare nel reindirizzamento. Includere l'oggetto iniziale /. Lasciare vuoto questo campo per mantenere il percorso in ingresso.
Stringa di query	Stringa di query utilizzata nel reindirizzamento. Non includere l'elemento iniziale ?. Lasciare vuoto questo campo per mantenere la stringa di query in ingresso.
Frammento di destinazione	Frammento da usare nel reindirizzamento. Lasciare vuoto questo campo per mantenere il frammento in ingresso.

Esempio

In questo esempio la richiesta viene reindirizzata a https://contoso.com/exampleredirection?clientIp={client_ip}, mantenendo il frammento. Viene usato un reindirizzamento temporaneo HTTP (307). L'indirizzo IP del client viene usato al posto del token all'interno dell'URL {client_ip} usando la client_ipvariabile server.

Portale

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'
  }
}

Riscrittura URL

Usare l'azione di riscrittura URL per riscrivere il percorso di una richiesta instradata all'origine.

Proprietà

Proprietà	Valori supportati
Modello di origine	Definire il modello di origine nel percorso URL da sostituire. Attualmente, il modello di origine usa una corrispondenza basata su prefisso. Per trovare la corrispondenza con tutti i percorsi URL, usare una barra (/) come valore del modello di origine.
Destinazione	Definire il percorso di destinazione da usare nella riscrittura. Il percorso di destinazione sovrascrive il modello di origine.
Mantenere un percorso non corrispondente	Se impostato su Sì, il percorso rimanente dopo che il modello di origine viene aggiunto al nuovo percorso di destinazione.

Esempio

In questo esempio vengono riscritti tutte le richieste al percorso /redirectione non vengono mantenute il resto del percorso.

Portale

JSON

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

Bicep

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

Importante

Frontdoor di Azure (versione classica) verrà ritirato il 31 marzo 2027. Per evitare interruzioni del servizio, è importante eseguire la migrazione dei profili frontdoor di Azure (versione classica) al livello Frontdoor di Azure Standard o Premium entro marzo 2027. Per altre informazioni, vedere Ritiro di Frontdoor di Azure (versione classica).

In Frontdoor di Azure (versione classica) un motore regole può contenere fino a 25 regole contenenti condizioni di corrispondenza e azioni associate. Questo articolo fornisce una descrizione dettagliata di ogni azione che è possibile definire in una regola.

Un'azione definisce il comportamento applicato al tipo di richiesta che corrisponde alla condizione o al set di condizioni di corrispondenza. Nella configurazione del motore regole una regola può avere fino a 10 condizioni di corrispondenza e 5 azioni. È possibile avere una sola azione Override routing Configuration in una singola regola.

Le azioni seguenti sono disponibili per l'uso nella configurazione del motore regole.

Modifica intestazione richiesta

Usare queste azioni per modificare le intestazioni presenti nelle richieste inviate al back-end.

Campi obbligatori

Azione	Nome intestazione HTTP	Valore
Aggiunta	Se questa opzione viene selezionata e la regola corrisponde, l'intestazione specificata in Nome intestazione viene aggiunta alla richiesta con il valore specificato. Se l'intestazione è già presente, il valore viene aggiunto a quello esistente.	String
Sovrascrivi	Se questa opzione viene selezionata e la regola corrisponde, l'intestazione specificata in Nome intestazione viene aggiunta alla richiesta con il valore specificato. Se l'intestazione è già presente, il valore specificato sovrascrive quello esistente.	String
Elimina	Se questa opzione viene selezionata con regole corrispondenti e l'intestazione specificata nella regola è presente, l'intestazione viene eliminata dalla richiesta.	String

Modifica intestazione risposta

Usare queste azioni per modificare le intestazioni presenti nelle risposte restituite ai client.

Campi obbligatori

Azione	Nome intestazione HTTP	Valore
Aggiunta	Se questa opzione viene selezionata e la regola corrisponde, l'intestazione specificata in Nome intestazione viene aggiunta alla risposta con il valore specificato. Se l'intestazione è già presente, il valore viene aggiunto a quello esistente.	String
Sovrascrivi	Se questa opzione è selezionata e la regola corrisponde, l'intestazione specificata in Nome intestazione viene aggiunta alla risposta con il valore specificato. Se l'intestazione è già presente, il valore sovrascrive quello esistente.	String
Elimina	Quando questa opzione viene selezionata con regole corrispondenti e l'intestazione specificata nella regola è presente, l'intestazione viene eliminata dalla risposta.	String

Sostituzione delle configurazioni della route

Tipo di route: reindirizzamento

Usare queste azioni per reindirizzare i client a un nuovo URL.

Campi obbligatori

Campo	Descrizione
Tipo di reindirizzamento	Il reindirizzamento è un modo per inviare utenti/client da un URL a un altro. Un tipo di reindirizzamento imposta il codice di stato usato dai client per comprendere lo scopo del reindirizzamento. È possibile selezionare i codici di stato di reindirizzamento seguenti: Trovato (302), Spostato (301), Reindirizzamento temporaneo (307) e Reindirizzamento permanente (308).
Protocollo di reindirizzamento	Mantenere il protocollo in base alla richiesta in ingresso o definire un nuovo protocollo per il reindirizzamento. Ad esempio, selezionare "HTTPS" per il reindirizzamento DA HTTP a HTTPS.
Host di destinazione	Impostare questo valore per modificare il nome host nell'URL per il reindirizzamento o mantenere il nome host dalla richiesta in ingresso.
Percorso di destinazione	Mantenere il percorso in base alla richiesta in ingresso o aggiornare il percorso nell'URL per il reindirizzamento.
Stringa di query	Impostare questo valore per sostituire qualsiasi stringa di query esistente dall'URL della richiesta in ingresso o mantenere il set originale di stringhe di query.
Frammento di destinazione	Il frammento di destinazione è la parte dell'URL dopo '#', usato in genere dai browser per atterrare su una sezione specifica di una pagina. Impostare questo valore per aggiungere un frammento all'URL di reindirizzamento.

Tipo di route: Inoltra

Usare queste azioni per inoltrare i client a un nuovo URL. Queste azioni contengono anche azioni secondarie per la riscrittura e la memorizzazione nella cache degli URL.

Campo	Descrizione
Pool back-end	Selezionare il pool back-end per eseguire l'override e gestire le richieste. Nel profilo frontdoor vengono visualizzati tutti i pool back-end preconfigurati.
Protocollo di inoltro	Protocollo da usare per inoltrare la richiesta al back-end o corrispondere al protocollo dalla richiesta in ingresso.
Riscrittura URL	Percorso da usare quando si costruisce la richiesta di riscrittura URL da inoltrare al back-end.
Memorizzazione nella cache	Abilitare la memorizzazione nella cache per questa regola di routing. Se abilitata, Frontdoor di Azure memorizza nella cache il contenuto statico.

Riscrittura URL

Usare questa impostazione per configurare un Percorso di inoltro personalizzato facoltativo da usare per la creazione della richiesta da inoltrare al back-end.

Campo	Descrizione
Percorso di inoltro personalizzato	Definire un percorso a cui le richieste vengono inoltrate.

Memorizzazione nella cache

Usare queste impostazioni per controllare il modo in cui i file vengono memorizzati nella cache per le richieste che contengono stringhe di query. Indica se memorizzare nella cache il contenuto basato su tutti i parametri o su parametri selezionati. È possibile usare queste impostazioni per sovrascrivere il valore TTL (Time To Live) per controllare per quanto tempo il contenuto rimane nella cache. Per forzare la memorizzazione nella cache come azione, impostare il campo di memorizzazione nella cache su "Abilitato". Quando si forza la memorizzazione nella cache, vengono visualizzate le opzioni seguenti:

Comportamento cache	Descrizione
Ignora stringa di query	Una volta memorizzati gli asset nella cache, tutte le richieste che seguono ignorano le stringhe di query fino alla scadenza degli asset.
Usare la stringa di query	Ogni richiesta con un URL univoco, inclusa la stringa di query, viene trattata come asset univoco con la propria cache.
Ignora stringhe di query specificate	Le stringhe di query dell'URL della richiesta elencate nell'impostazione "Parametri query" vengono ignorate per la memorizzazione nella cache.
Includi stringhe di query specificate	Le stringhe di query dell'URL della richiesta elencate nell'impostazione "Parametri query" vengono usate per la memorizzazione nella cache.

Altri campi	Descrizione
Compressione dinamica	Frontdoor può comprimere dinamicamente il contenuto nel perimetro, generando una risposta più piccola e veloce.
Parametri di query	Elenco delimitato da virgole di parametri consentiti o non consentiti da usare come base per la memorizzazione nella cache.
Usa durata cache predefinita	Impostare per usare la durata predefinita della memorizzazione nella cache di Frontdoor di Azure o definire una durata di memorizzazione nella cache che ignora la direttiva di risposta all'origine.

Passaggi successivi

• Informazioni su come configurare il primo set di regole.
• Altre informazioni sulle condizioni di corrispondenza dei set di regole.
• Altre informazioni sui set di regole di Frontdoor di Azure.