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 |
|
Caching |
|
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 |
|
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 |
|
Cachegedrag |
|
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.
|
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.
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.
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.
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 |
|
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
.
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 |
|
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.
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.
|
Omleidingsprotocol |
|
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.
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 /redirection
en behouden we de rest van het pad niet.
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
- Meer informatie over het configureren van uw eerste regelset.
- Meer informatie over voorwaarden voor overeenkomst in regelset.
- Meer informatie over Azure Front Door Rule Sets.