Azioni del set di regole

Un set di regole di Frontdoor di Azure è costituito da regole con una combinazione di condizioni di corrispondenza e azioni. 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 override configurazione route viene usata per eseguire l'override del gruppo di origini o della configurazione di memorizzazione nella cache per la richiesta. È possibile scegliere di sovrascrivere o rispettare le configurazioni del gruppo di origine specificate nel percorso. 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 per controllare per quanto tempo il contenuto rimane nella cache.

Proprietà

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

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

Esempi

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

{
  "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"
  }
}

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

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

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

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

{
  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à

Esempio

In questo esempio, il valore AdditionalValue viene aggiunto all'intestazione della richiesta MyRequestHeader. 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.

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

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

Modifica l'intestazione della risposta

Usare l'azione modifica intestazione risposta per modificare le intestazioni presenti nelle risposte prima di restituirle ai client.

Proprietà

Esempio

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

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

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

Reindirizzamento URL

Usare l'azione Reindirizzamento URL per reindirizzare i client a un nuovo URL. Ai client viene inviata una risposta di reindirizzamento da Frontdoor. Frontdoor di Azure supporta l'acquisizione dinamica del percorso URL con variabile del server {url_path:seg#} e converte il percorso URL in lettere minuscole o maiuscole con {url_path.tolower} o {url_path.toupper}. Per altre informazioni, vedere Variabili del server.

Proprietà

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 utilizzato al posto del token {client_ip} all'interno dell'URL utilizzando la variabile client_ipserver.

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

{
  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 indirizzata all'origine. Frontdoor di Azure supporta l'acquisizione dinamica del percorso URL con variabile del server {url_path:seg#} e converte il percorso URL in lettere minuscole o maiuscole con {url_path.tolower} o {url_path.toupper}. Per altre informazioni, vedere Variabili del server.

Proprietà

Esempio

In questo esempio vengono riscritte tutte le richieste al percorso /redirectione non viene mantenuto il resto del percorso.

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

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

In Frontdoor di Azure (versione classica) un Motore regole può contenere fino a 25 regole contenenti condizioni di corrispondenza e le 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 a una o più condizioni di corrispondenza. Nella configurazione del motore di regole, una regola può avere fino a 10 condizioni di corrispondenza e 5 azioni. È possibile avere una sola azione Sostituisci configurazione routing in una singola regola.

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

Modifica intestazione richiesta

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

Campi obbligatori

Modifica l'intestazione della risposta

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

Campi obbligatori

Sostituzione delle configurazioni della route

Tipo di route: reindirizzamento

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

Campi obbligatori

Tipo di route: Inoltra

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

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.

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) in modo da controllare per quanto tempo il contenuto deve rimanere nella cache. Per forzare la memorizzazione nella cache come azione, impostare il campo Memorizzazione nella cache su "Abilitata". Quando si impone la memorizzazione nella cache, vengono visualizzate le opzioni seguenti: