Acties voor regelset

Een Azure Front Door-regelset bestaat uit regels met een combinatie van overeenkomstvoorwaarden en acties. Dit artikel bevat een gedetailleerde beschrijving van acties die u in een regelset kunt gebruiken. Een actie definieert het gedrag dat wordt toegepast op een aanvraagtype dat een overeenkomstvoorwaarde(n) identificeert. In een regelset kan een regel maximaal vijf acties hebben. Front Door ondersteunt ook servervariabele in een regelsetactie.

De volgende acties zijn beschikbaar voor gebruik in een regelset:

Overschrijven van routeconfiguratie

De actie voor het overschrijven van de routeconfiguratie wordt gebruikt om de oorspronkelijke groep of de cacheconfiguratie voor de aanvraag te overschrijven. U kunt ervoor kiezen om de configuraties van de oorspronkelijke groep te overschrijven of te respecteren die zijn opgegeven in de route. Wanneer u echter de routeconfiguratie overschrijft, moet u caching configureren. Anders wordt caching uitgeschakeld voor de aanvraag.

U kunt ook overschrijven hoe bestanden in de cache worden opgeslagen voor specifieke aanvragen, waaronder:

• Overschrijf het cachegedrag dat is opgegeven door de origin-server.
• Hoe queryreeksparameters worden gebruikt om de cachesleutel van de aanvraag te genereren.
• De TTL-waarde (Time to Live) om te bepalen hoe lang de inhoud in de cache blijft.

Eigenschappen

Wanneer de oorspronkelijke groep overschrijven is ingesteld op Ja, stelt u de volgende eigenschappen in:

Wanneer caching is ingesteld op Ingeschakeld, stelt u de volgende eigenschappen in:

Voorbeelden

In dit voorbeeld routeren we alle overeenkomende aanvragen naar een oorspronkelijke groep met de naam MyOriginGroup, ongeacht de configuratie in de Front Door-eindpuntroute.

{
  "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 dit voorbeeld stellen we de cachesleutel zo in dat deze een querystring-parameter met de naam customerId bevat. Compressie is ingeschakeld en het cachebeleid van de origin wordt gehonoreerd.

{
  "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 dit voorbeeld overschrijven we de verlooptijd van de cache tot 6 uur voor overeenkomende aanvragen die nog geen cacheduur opgeven. Front Door negeert de querytekenreeks wanneer deze de cachesleutel bepaalt en compressie is ingeschakeld.

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

Aanvraagheader wijzigen

Gebruik de actie om aanvraagheaders te wijzigen wanneer deze naar uw herkomstserver worden verzonden.

Eigenschappen

Voorbeeld

In dit voorbeeld voegen we de waarde AdditionalValue toe aan de MyRequestHeader aanvraagheader. Als de oorsprong de antwoordheader instelt op een waarde van ValueSetByClient, heeft de aanvraagheader na de toepassing een waarde van ValueSetByClientAdditionalValue.

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

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

Antwoordheader wijzigen

Gebruik de actie om antwoordheaders te wijzigen om headers te wijzigen die aanwezig zijn in antwoorden voordat ze worden geretourneerd naar uw klanten.

Eigenschappen

Voorbeeld

In dit voorbeeld verwijderen we de header met de naam X-Powered-By uit de antwoorden voordat ze worden geretourneerd naar de client.

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

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

URL-doorverwijzing

Gebruik de url-omleidingsactie om clients om te leiden naar een nieuwe URL. Front Door stuurt klanten een omleidingsantwoord. Azure Front Door ondersteunt dynamische opname van URL-pad met {url_path:seg#} servervariabele en converteert HET URL-pad naar kleine letters of hoofdletters met {url_path.tolower} of {url_path.toupper}. Zie Servervariabelen voor meer informatie.

Eigenschappen

Voorbeeld

In dit voorbeeld wordt de aanvraag omgeleid naar https://contoso.com/exampleredirection?clientIp={client_ip}, terwijl het fragment behouden blijft. Er wordt een TIJDELIJKE HTTP-omleiding (307) gebruikt. Het IP-adres van de client wordt gebruikt in plaats van het {client_ip} token in de URL met behulp van de client_ipservervariabele.

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

URL opnieuw genereren

Gebruik de URL-herwrite-actie om het pad te herschrijven van een verzoek dat wordt gerouteerd naar uw origine. Azure Front Door ondersteunt dynamische opname van URL-pad met {url_path:seg#} servervariabele en converteert HET URL-pad naar kleine letters of hoofdletters met {url_path.tolower} of {url_path.toupper}. Zie Servervariabelen voor meer informatie.

Eigenschappen

Voorbeeld

In dit voorbeeld herschrijven we alle aanvragen naar het pad /redirectionen behouden we de rest van het pad niet.

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

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

In Azure Front Door (klassiek) kan een regelengine maximaal 25 regels bevatten die overeenkomende voorwaarden en bijbehorende acties bevatten. Dit artikel bevat een gedetailleerde beschrijving van elke actie die u in een regel kunt definiëren.

Een actie definieert het gedrag dat wordt toegepast op het aanvraagtype dat overeenkomt met de voorwaarde of set overeenkomstvoorwaarden. In de configuratie van de regelengine kan een regel maximaal 10 overeenkomende voorwaarden en vijf acties hebben. U kunt slechts één Override Routing Configuration-actie in een regel hebben.

De volgende acties zijn beschikbaar voor gebruik in de configuratie van de regelengine.

Aanvraagheader wijzigen

Gebruik deze acties om headers te wijzigen die aanwezig zijn in aanvragen die naar uw back-end worden verzonden.

Vereiste velden

Antwoordheader wijzigen

Gebruik deze acties om headers te wijzigen die aanwezig zijn in antwoorden die worden geretourneerd aan uw clients.

Vereiste velden

Routeconfiguratie-overschrijvingen

Routetype: omleiden

Gebruik deze acties om clients om te leiden naar een nieuwe URL.

Vereiste velden

Routetype: Voorwaarts

Gebruik deze acties om clients door te sturen naar een nieuwe URL. Deze acties bevatten ook subacties voor het herschrijven en opslaan van URL's in cache.

URL opnieuw genereren

Gebruik deze instelling om een ​​optioneel Aangepast doorstuurpad te configureren om te gebruiken bij het samenstellen van de aanvraag om door te sturen naar het back-end.

Cachebeheer

Gebruik deze instellingen om te bepalen hoe bestanden in de cache worden opgeslagen voor aanvragen die queryreeksen bevatten. Hiermee wordt aangegeven of de inhoud in de cache moet worden opgeslagen op basis van alle parameters of alleen geselecteerde parameters. U kunt deze instellingen gebruiken om de TTL-waarde (Time to Live) te overschrijven om te bepalen hoe lang de inhoud in de cache blijft. Als u caching wilt afdwingen als een actie, stelt u het cacheveld in op Ingeschakeld. Wanneer u caching afdwingen, worden de volgende opties weergegeven: