Delen via


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:

Overschrijving 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 oorsprong.
  • 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

Eigenschappen Ondersteunde waarden
Oorspronkelijke groep overschrijven
  • Ja: Overschrijf de oorspronkelijke groep die voor de aanvraag wordt gebruikt.
  • Nee: Gebruik de oorspronkelijke groep die is opgegeven in de route.
Caching
  • Ingeschakeld: Caching geforceerd inschakelen voor de aanvraag.
  • Uitgeschakeld: caching geforceerd uitschakelen voor de aanvraag.

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

Eigenschappen Ondersteunde waarden
Origineel groep De oorspronkelijke groep waarnaar de aanvraag moet worden doorgestuurd. Met deze instelling wordt de configuratie die is opgegeven in de Front Door-eindpuntroute overschreven.
Doorstuurprotocol Het protocol voor Front Door dat moet worden gebruikt bij het doorsturen van de aanvraag naar de oorsprong. Ondersteunde waarden zijn alleen HTTP, alleen HTTPS, inkomende aanvragen vergelijken. Met deze instelling wordt de configuratie die is opgegeven in de Front Door-eindpuntroute overschreven.

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

Eigenschappen Ondersteunde waarden
Cachegedrag van queryreeks
  • Queryreeks negeren: queryreeksen worden niet meegenomen wanneer de cachesleutel wordt gegenereerd. Stel in ARM-sjablonen de queryStringCachingBehavior eigenschap in op IgnoreQueryString.
  • Queryreeks gebruiken: elke unieke URL heeft een eigen cachesleutel. Gebruik in ARM-sjablonen de queryStringCachingBehavior van UseQueryString.
  • Opgegeven queryreeks negeren: queryreeksen die zijn opgegeven in de parameters worden uitgesloten wanneer de cachesleutel wordt gegenereerd. Stel in ARM-sjablonen de queryStringCachingBehavior eigenschap in op IgnoreSpecifiedQueryStrings.
  • Opgegeven queryreeks opnemen: queryreeksen die zijn opgegeven in de parameters worden opgenomen wanneer de cachesleutel wordt gegenereerd. Stel in ARM-sjablonen de queryStringCachingBehavior eigenschap in op IncludeSpecifiedQueryStrings.
Queryparameters De lijst met namen van queryreeksparameters, gescheiden door komma's. Deze eigenschap wordt alleen ingesteld wanneer het cachegedrag van queryreeksen is ingesteld op Opgegeven queryreeksen negeren of opgegeven queryreeksen opnemen.
Compressie
  • Ingeschakeld: Front Door comprimeert inhoud dynamisch aan de rand, wat resulteert in een kleiner en sneller antwoord. Zie Bestandscompressie voor meer informatie. Stel in ARM-sjablonen de isCompressionEnabled eigenschap in op Enabled.
  • Disabled. Front Door voert geen compressie uit. Stel in ARM-sjablonen de isCompressionEnabled eigenschap in op Disabled.
Cachegedrag
  • Eer de oorsprong: Front Door respecteert altijd de richtlijn voor de header van het antwoord van oorsprong. Als de oorsprongsrichtlijn ontbreekt, slaat Front Door inhoud tussen 1 en 3 dagen in de cache op. Stel in ARM-sjablonen de cacheBehavior eigenschap in op HonorOrigin.
  • Altijd overschrijven: de TTL-waarde die wordt geretourneerd van uw oorsprong, wordt overschreven met de waarde die is opgegeven in de actie. Dit gedrag wordt alleen toegepast als het antwoord in de cache kan worden opgeslagen. Stel in ARM-sjablonen de cacheBehavior eigenschap in op OverrideAlways.
  • Overschrijven als de oorsprong ontbreekt: Als er geen TTL-waarde wordt geretourneerd van uw oorsprong, wordt de TTL ingesteld op de waarde die in de actie is opgegeven. Dit gedrag wordt alleen toegepast als het antwoord in de cache kan worden opgeslagen. Stel in ARM-sjablonen de cacheBehavior eigenschap in op OverrideIfOriginMissing.
Cacheduur Wanneer het cachegedrag is ingesteld op Override always of Override if origin missing, moeten deze velden de cacheduur opgeven die moet worden gebruikt. De maximale duur is 366 dagen. Deze eigenschap wordt alleen ingesteld wanneer cachegedrag is ingesteld op Altijd overschrijven of Overschrijven als de oorsprong ontbreekt.
  • Geef in Azure Portal de dagen, uren, minuten en seconden op.
  • In ARM-sjablonen: gebruik de cacheDuration sjabloon om de duur in de notatie d.hh:mm:ssop te geven.

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.

Schermafbeelding van de schermafbeelding van de onderdrukkingsactie van de oorspronkelijke groep.

In dit voorbeeld stellen we de cachesleutel in op een queryreeksparameter met de naam customerId. Compressie is ingeschakeld en het cachebeleid van de origin wordt gehonoreerd.

Schermopname van de queryreeksactie cachesleutel.

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.

Schermopname van de cacheverloopactie.

Aanvraagheader wijzigen

Gebruik de actie aanvraagheader wijzigen om de headers in de aanvraag te wijzigen wanneer deze naar uw oorsprong wordt verzonden.

Eigenschappen

Eigenschappen Ondersteunde waarden
Operator
  • Toevoegen: De opgegeven header wordt toegevoegd aan de aanvraag met de opgegeven waarde. Als de header al aanwezig is, wordt de waarde toegevoegd aan de bestaande headerwaarde met behulp van tekenreekssamenvoeging. Er worden geen scheidingstekens toegevoegd. Gebruik in ARM-sjablonen de headerAction van Append.
  • Overschrijven: de opgegeven header wordt toegevoegd aan de aanvraag met de opgegeven waarde. Als er al een header aanwezig is, overschrijft de opgegeven waarde de bestaande waarde. Gebruik in ARM-sjablonen de headerAction van Overwrite.
  • Verwijderen: Als de koptekst die is opgegeven in de regel aanwezig is, wordt de header uit de aanvraag verwijderd. Gebruik in ARM-sjablonen de headerAction van Delete.
Headernaam De naam van de koptekst die u wilt wijzigen.
Headerwaarde De waarde die moet worden toegevoegd of overschreven.

Opmerking

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.

Schermopname van de actie Aanvraagheader wijzigen.

Notitie

Bepaalde gereserveerde Azure Front Door-headers kunnen niet worden gewijzigd met behulp van regelengineacties, inclusief de acties voor het wijzigen van aanvraagheaders en antwoordheaders. De volgende lijst met gereserveerde headers kan niet worden gewijzigd, samen met eventuele headers met voorvoegsel x-ec en x-fd.

  • Accept-Ranges
  • Host
  • Connection
  • Content-Length
  • Transfer-Encoding
  • TE
  • Last-Modified
  • Keep-Alive
  • Expect
  • Upgrade
  • If-Modified-Since
  • If-Unmodified-Since
  • If-None-Match
  • If-Match
  • Range
  • If-Range
  • X-Ms-Via
  • X-Ms-Force-Refresh
  • X-MSEdge-Ref
  • Warning
  • Forwarded
  • Via
  • X-Forwarded-For
  • X-Forwarded-Proto
  • X-Forwarded-Host
  • X-Azure-RequestChain
  • X-Azure-FDID
  • X-Azure-RequestChainv2
  • X-Azure-Ref

Antwoordheader wijzigen

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

Eigenschappen

Eigenschappen Ondersteunde waarden
Operator
  • Toevoegen: De opgegeven header wordt toegevoegd aan het antwoord met de opgegeven waarde. Als de header al aanwezig is, wordt de waarde toegevoegd aan de bestaande headerwaarde met behulp van tekenreekssamenvoeging. Er worden geen scheidingstekens toegevoegd. Gebruik in ARM-sjablonen de headerAction van Append.
  • Overschrijven: de opgegeven header wordt toegevoegd aan het antwoord met de opgegeven waarde. Als er al een header aanwezig is, overschrijft de opgegeven waarde de bestaande waarde. Gebruik in ARM-sjablonen de headerAction van Overwrite.
  • Verwijderen: Als de koptekst die is opgegeven in de regel aanwezig is, wordt de header uit het antwoord verwijderd. Gebruik in ARM-sjablonen de headerAction van Delete.
Headernaam De naam van de koptekst die u wilt wijzigen.
Headerwaarde De waarde die moet worden toegevoegd of overschreven.

Opmerking

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

Schermopname van de actie antwoordheader wijzigen.

Notitie

Bepaalde gereserveerde Azure Front Door-headers kunnen niet worden gewijzigd met behulp van regelengineacties, inclusief de acties voor het wijzigen van aanvraagheaders en antwoordheaders. De volgende lijst met gereserveerde headers kan niet worden gewijzigd, samen met eventuele headers met voorvoegsel x-ec en x-fd.

  • Accept-Ranges
  • Host
  • Connection
  • Content-Length
  • Transfer-Encoding
  • TE
  • Last-Modified
  • Keep-Alive
  • Expect
  • Upgrade
  • If-Modified-Since
  • If-Unmodified-Since
  • If-None-Match
  • If-Match
  • Range
  • If-Range
  • X-Ms-Via
  • X-Ms-Force-Refresh
  • X-MSEdge-Ref
  • Warning
  • Forwarded
  • Via
  • X-Forwarded-For
  • X-Forwarded-Proto
  • X-Forwarded-Host
  • X-Azure-RequestChain
  • X-Azure-FDID
  • X-Azure-RequestChainv2
  • X-Azure-Ref

URL-omleiding

Gebruik de url-omleidingsactie om clients om te leiden naar een nieuwe URL. Clients worden een omleidingsreactie van Front Door verzonden. 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

Eigenschappen Ondersteunde waarden
Omleidingstype Het antwoordtype dat moet worden geretourneerd aan de aanvrager.
  • In Azure Portal: Gevonden (302), Verplaatst (301), Tijdelijke omleiding (307), Permanente omleiding (308).
  • In ARM-sjablonen: Found, Moved, TemporaryRedirectPermanentRedirect
Omleidingsprotocol
  • In Azure Portal: Match Request, HTTPHTTPS
  • In ARM-sjablonen: MatchRequest, HttpHttps
Doelhost De hostnaam waarnaar u de aanvraag wilt omleiden. Laat het veld leeg om de binnenkomende host te behouden.
Doelpad Het pad dat moet worden gebruikt in de omleiding. Neem de voorloop op /. Laat het veld leeg als u het binnenkomende pad wilt behouden.
Queryreeks De queryreeks die in de omleiding wordt gebruikt. Neem de voorloop ?niet op. Laat het veld leeg om de binnenkomende queryreeks te behouden.
Doelfragment Het fragment dat in de omleiding moet worden gebruikt. Laat het veld leeg om het binnenkomende fragment te behouden.

Opmerking

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

Schermopname van de url-omleidingsactie.

URL opnieuw genereren

Gebruik de url-herschrijfactie om het pad te herschrijven van een aanvraag die wordt gerouteerd naar uw oorsprong. 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

Eigenschappen Ondersteunde waarden
Bronpatroon Definieer het bronpatroon in het URL-pad dat u wilt vervangen. Op dit moment maakt het bronpatroon gebruik van een overeenkomst op basis van voorvoegsels. Als u alle URL-paden wilt vergelijken, gebruikt u een slash (/) als de bronpatroonwaarde.
Bestemming Definieer het doelpad dat moet worden gebruikt in het herschrijven. Het doelpad overschrijft het bronpatroon.
Niet-overeenkomend pad behouden Als dit is ingesteld op Ja, wordt het resterende pad na het bronpatroon toegevoegd aan het nieuwe doelpad.

Opmerking

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

Schermopname van url-herschrijfactie.

Belangrijk

Azure Front Door (klassiek) wordt op 31 maart 2027 buiten gebruik gesteld. Om serviceonderbrekingen te voorkomen, is het belangrijk dat u uw Azure Front Door-profielen (klassiek) tegen maart 2027 migreert naar de Azure Front Door Standard- of Premium-laag. Zie De buitengebruikstelling van Azure Front Door (klassiek) voor meer informatie.

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 actie routeringsconfiguratie overschrijven in één regel.

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

Actie HTTP-headernaam Weergegeven als
Toevoegen Als deze optie wordt geselecteerd en de regel overeenkomt, wordt de header die wordt opgegeven in headernaam aan de aanvraag toegevoegd met de opgegeven waarde. Als er al een header aanwezig is, wordt de waarde toegevoegd aan de bestaande waarde. String
Overschrijven Als deze optie is geselecteerd en de regel overeenkomt, wordt de header die wordt opgegeven in headernaam aan de aanvraag toegevoegd met de opgegeven waarde. Als er al een header aanwezig is, overschrijft de opgegeven waarde de bestaande waarde. String
Delete Als deze optie wordt geselecteerd, de regel overeenkomt en de opgegeven header aanwezig is, wordt de header uit de aanvraag verwijderd. String

Antwoordheader wijzigen

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

Vereiste velden

Actie HTTP-headernaam Weergegeven als
Toevoegen Als deze optie wordt geselecteerd en de regel overeenkomt, wordt de header die wordt opgegeven in headernaam aan het antwoord toegevoegd met de opgegeven waarde. Als de header al aanwezig is, wordt de waarde toegevoegd aan de bestaande waarde. String
Overschrijven Als deze optie is geselecteerd en de regel overeenkomt, wordt de header die is opgegeven in headernaam aan het antwoord toegevoegd met de opgegeven waarde. Als de header al aanwezig is, overschrijft de waarde de bestaande waarde overschrijft. String
Delete Wanneer deze optie wordt geselecteerd met overeenkomende regels en de header die is opgegeven in de regel aanwezig is, wordt de header verwijderd uit het antwoord. String

Routeconfiguratie-onderdrukkingen

Routetype: omleiden

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

Vereiste velden

Veld Beschrijving
Omleidingstype Omleiding is een manier om gebruikers/clients van de ene URL naar de andere te verzenden. Met een omleidingstype wordt de statuscode ingesteld die door clients wordt gebruikt om het doel van de omleiding te begrijpen.

U kunt de volgende omleidingsstatuscodes selecteren: Gevonden (302), Verplaatst (301), Tijdelijke omleiding (307) en Permanente omleiding (308).
Omleidingsprotocol Behoud het protocol op basis van de binnenkomende aanvraag of definieer een nieuw protocol voor de omleiding. Selecteer bijvoorbeeld HTTPS voor omleiding van HTTP naar HTTPS.
Doelhost Stel deze waarde in om de hostnaam in de URL voor de omleiding te wijzigen of de hostnaam op een andere manier te behouden van de binnenkomende aanvraag.
Doelpad Behoud het pad op basis van de binnenkomende aanvraag of werk het pad bij in de URL voor de omleiding.
Queryreeks Stel deze waarde in om een bestaande queryreeks te vervangen door de URL van de binnenkomende aanvraag of om de oorspronkelijke set queryreeksen op een andere manier te behouden.
Doelfragment Het doelfragment is het gedeelte van de URL na '#', normaal gesproken gebruikt door browsers om op een specifieke sectie op een pagina te terechtkomen. Stel deze waarde in om een fragment toe te voegen aan de omleidings-URL.

Routetype: Doorsturen

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.

Veld Beschrijving
Back-endpool Selecteer de back-endpool om de aanvragen te overschrijven en te verwerken. U ziet al uw vooraf geconfigureerde back-endpools die zich momenteel in uw Front Door-profiel bevinden.
Doorstuurprotocol Protocol dat moet worden gebruikt voor het doorsturen van aanvragen naar back-end of overeenkomen met het protocol van binnenkomende aanvragen.
URL opnieuw genereren Pad dat moet worden gebruikt bij het samenstellen van de aanvraag voor het herschrijven van url's om door te sturen naar de back-end.
Caching Schakel caching in voor deze routeringsregel. Wanneer deze functie is ingeschakeld, slaat Azure Front Door uw statische inhoud in de cache op.

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.

Veld Beschrijving
Aangepast doorstuurpad Definieer een pad waarnaar aanvragen worden doorgestuurd.

Caching

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:

Cachegedrag Beschrijving
Queryreeks negeren Zodra de asset in de cache is opgeslagen, negeren alle volgende aanvragen de queryreeksen totdat de in de cache opgeslagen asset verloopt.
Queryreeks gebruiken Elke aanvraag met een unieke URL, inclusief de queryreeks, wordt behandeld als een unieke asset met een eigen cache.
Opgegeven queryreeksen negeren De queryreeksen van de aanvraag-URL die worden vermeld in de instelling Queryparameters worden genegeerd voor caching.
Opgegeven queryreeksen opnemen De queryreeksen van de aanvraag-URL die worden vermeld in de instelling Queryparameters worden gebruikt voor caching.
Andere velden Beschrijving
Dynamische compressie Front Door kan inhoud op de rand dynamisch comprimeren, wat leidt tot een kleiner en sneller antwoord.
Queryparameters Een door komma's gescheiden lijst met toegestane of niet-toegestane parameters die moeten worden gebruikt als basis voor caching.
Standaardcacheduur gebruiken Ingesteld op het gebruik van de standaardcacheduur van Azure Front Door of definieer een cacheduur die de oorspronkelijke antwoordrichtlijn negeert.

Volgende stappen