Dela via

Regeluppsättningsåtgärder

  • Artikel

En Azure Front Door-regeluppsättning består av regler med en kombination av matchningsvillkor och åtgärder. Den här artikeln innehåller en detaljerad beskrivning av åtgärder som du kan använda i en regeluppsättning. En åtgärd definierar det beteende som tillämpas på en begärandetyp som ett matchningsvillkor identifierar. I en regeluppsättning kan en regel ha upp till fem åtgärder. Front Door stöder även servervariabel i en regeluppsättningsåtgärd.

Följande åtgärder är tillgängliga för användning i en regeluppsättning:

Åsidosättning av routningskonfiguration

Åsidosättningsåtgärden för routningskonfiguration används för att åsidosätta ursprungsgruppen eller cachelagringskonfigurationen för begäran. Du kan välja att åsidosätta eller respektera de ursprungsgruppskonfigurationer som anges i vägen. Men när du åsidosätter routningskonfigurationen måste du konfigurera cachelagring. Annars inaktiveras cachelagring för begäran.

Du kan också åsidosätta hur filer cachelagras för specifika begäranden, inklusive:

  • Åsidosätt cachelagringsbeteendet som anges av ursprunget.
  • Hur frågesträngsparametrar används för att generera begärans cachenyckel.
  • TTL-värdet (Time To Live) för att styra hur länge innehållet ska finnas kvar i cacheminnet.

Egenskaper

Property Värden som stöds
Åsidosätt ursprungsgrupp
  • Ja: Åsidosätt den ursprungsgrupp som används för begäran.
  • Nej: Använd den ursprungsgrupp som anges i vägen.
Cachelagring
  • Aktiverad: Tvinga cachelagring att aktiveras för begäran.
  • Inaktiverad: Framtvinga att cachelagring inaktiveras för begäran.

När Åsidosätt ursprungsgruppen är inställd på Ja anger du följande egenskaper:

Property Värden som stöds
Ursprungsgrupp Den ursprungsgrupp som begäran ska dirigeras till. Den här inställningen åsidosätter konfigurationen som anges i Front Door-slutpunktsvägen.
Protokollet för vidarebefordran Det protokoll som Front Door ska använda när begäran vidarebefordras till ursprunget. Värden som stöds är endast HTTP, ENDAST HTTPS, Matcha inkommande begäran. Den här inställningen åsidosätter konfigurationen som anges i Front Door-slutpunktsvägen.

När Cachelagring har angetts till Aktiverad anger du följande egenskaper:

Property Värden som stöds
Funktionssätt för cachelagring av frågesträng
  • Ignorera frågesträng: Frågesträngar beaktas inte när cachenyckeln genereras. I ARM-mallar anger du queryStringCachingBehavior egenskapen till IgnoreQueryString.
  • Använd frågesträng: Varje unik URL har en egen cachenyckel. I ARM-mallar använder du queryStringCachingBehavior .UseQueryString
  • Ignorera angiven frågesträng: Frågesträngar som anges i parametrarna undantas när cachenyckeln genereras. I ARM-mallar anger du queryStringCachingBehavior egenskapen till IgnoreSpecifiedQueryStrings.
  • Inkludera angiven frågesträng: Frågesträngar som anges i parametrarna inkluderas när cachenyckeln genereras. I ARM-mallar anger du queryStringCachingBehavior egenskapen till IncludeSpecifiedQueryStrings.
Frågeparametrar Listan över frågesträngsparameternamn, avgränsade med kommatecken. Den här egenskapen anges endast när cachelagringsbeteendet för frågesträngar är inställt på Ignorera angivna frågesträngar eller Inkludera angivna frågesträngar.
Komprimering
  • Aktiverad: Front Door komprimerar innehållet dynamiskt vid gränsen, vilket resulterar i ett mindre och snabbare svar. Mer information finns i Filkomprimering. I ARM-mallar anger du isCompressionEnabled egenskapen till Enabled.
  • Inaktiverat. Front Door utför inte komprimering. I ARM-mallar anger du isCompressionEnabled egenskapen till Disabled.
Cachebeteende
  • Heders ursprung: Front Door respekterar alltid ursprungsdirektivet för svarshuvud. Om ursprungsdirektivet saknas cachelagrar Front Door innehållet var som helst från 1 till 3 dagar. I ARM-mallar anger du cacheBehavior egenskapen till HonorOrigin.
  • Åsidosätt alltid: TTL-värdet som returneras från ditt ursprung skrivs över med det värde som anges i åtgärden. Det här beteendet tillämpas bara om svaret kan cachelagras. I ARM-mallar anger du cacheBehavior egenskapen till OverrideAlways.
  • Åsidosätt om ursprung saknas: Om inget TTL-värde returneras från ditt ursprung anger regeln TTL till det värde som anges i åtgärden. Det här beteendet tillämpas bara om svaret kan cachelagras. I ARM-mallar anger du cacheBehavior egenskapen till OverrideIfOriginMissing.
Cachevaraktighet När cachebeteendet är inställt på Override always eller Override if origin missingmåste dessa fält ange cachevaraktigheten som ska användas. Den maximala varaktigheten är 366 dagar. Den här egenskapen anges bara när cachebeteendet är inställt på Åsidosätt alltid eller Åsidosätt om ursprung saknas.
  • I Azure Portal: ange dagar, timmar, minuter och sekunder.
  • I ARM-mallar: använd cacheDuration för att ange varaktigheten i formatet d.hh:mm:ss.

Exempel

I det här exemplet dirigerar vi alla matchade begäranden till en ursprungsgrupp med namnet MyOriginGroup, oavsett konfigurationen i Front Door-slutpunktsvägen.

Skärmbild av portalen som visar åtgärden åsidosättning av ursprungsgrupp.

I det här exemplet anger vi cachenyckeln så att den innehåller en frågesträngsparameter med namnet customerId. Komprimering är aktiverat och ursprungets cachelagringsprinciper respekteras.

Skärmbild av portalen som visar åtgärden för frågesträng för cachenyckel.

I det här exemplet åsidosätter vi cacheförfallotiden till 6 timmar för matchade begäranden som inte redan anger en cachevaraktighet. Front Door ignorerar frågesträngen när den fastställer cachenyckeln och komprimering är aktiverad.

Skärmbild av portalen som visar åtgärden för förfallodatum för cacheminnet.

Ändra begärandehuvud

Använd åtgärden ändra rubrik för begäran om du vill ändra rubrikerna i begäran när den skickas till ditt ursprung.

Egenskaper

Property Värden som stöds
Operator
  • Tillägg: Det angivna huvudet läggs till i begäran med det angivna värdet. Om huvudet redan finns läggs värdet till i det befintliga rubrikvärdet med hjälp av strängsammanfogning. Inga avgränsare läggs till. I ARM-mallar använder du headerAction .Append
  • Skriv över: Den angivna rubriken läggs till i begäran med det angivna värdet. Om rubriken redan finns skriver det angivna värdet över det befintliga värdet. I ARM-mallar använder du headerAction .Overwrite
  • Ta bort: Om huvudet som anges i regeln finns, tas huvudet bort från begäran. I ARM-mallar använder du headerAction .Delete
Huvudnamn Namnet på rubriken som ska ändras.
Huvudvärde Värdet som ska läggas till eller skrivas över.

Exempel

I det här exemplet lägger vi till värdet AdditionalValue i begärandehuvudet MyRequestHeader . Om ursprunget anger svarshuvudet till ett värde av ValueSetByClient, kommer begärandehuvudet att ha värdet ValueSetByClientAdditionalValue.

Skärmbild av portalen som visar åtgärden ändra begärandehuvud.

Kommentar

Vissa reserverade Azure Front Door-huvuden kan inte ändras med hjälp av regelmotoråtgärder, inklusive åtgärder för att ändra begärandehuvuden och svarshuvuden. Följande lista över reserverade rubriker kan inte ändras, tillsammans med alla rubriker som är prefix med x-ec och 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

Ändra svarsrubrik

Använd åtgärden ändra svarshuvud för att ändra rubriker som finns i svar innan de returneras till dina klienter.

Egenskaper

Property Värden som stöds
Operator
  • Tillägg: Den angivna rubriken läggs till i svaret med det angivna värdet. Om huvudet redan finns läggs värdet till i det befintliga rubrikvärdet med hjälp av strängsammanfogning. Inga avgränsare läggs till. I ARM-mallar använder du headerAction .Append
  • Skriv över: Den angivna rubriken läggs till i svaret med det angivna värdet. Om rubriken redan finns skriver det angivna värdet över det befintliga värdet. I ARM-mallar använder du headerAction .Overwrite
  • Ta bort: Om rubriken som anges i regeln finns, tas huvudet bort från svaret. I ARM-mallar använder du headerAction .Delete
Huvudnamn Namnet på rubriken som ska ändras.
Huvudvärde Värdet som ska läggas till eller skrivas över.

Exempel

I det här exemplet tar vi bort huvudet med namnet X-Powered-By från svaren innan de returneras till klienten.

Skärmbild av portalen som visar åtgärden ändra svarshuvud.

Kommentar

Vissa reserverade Azure Front Door-huvuden kan inte ändras med hjälp av regelmotoråtgärder, inklusive åtgärder för att ändra begärandehuvuden och svarshuvuden. Följande lista över reserverade rubriker kan inte ändras, tillsammans med alla rubriker som är prefix med x-ec och 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-omdirigering

Använd url-omdirigeringsåtgärden för att omdirigera klienter till en ny URL. Klienterna får ett omdirigeringssvar från Front Door. Azure Front Door stöder dynamisk insamling av URL-sökväg med {url_path:seg#} servervariabel och konverterar URL-sökvägen till gemener eller versaler med {url_path.tolower} eller {url_path.toupper}. Mer information finns i Servervariabler.

Egenskaper

Property Värden som stöds
Omdirigeringstyp Svarstypen som ska returneras till beställaren.
  • I Azure Portal: Found (302), Moved (301), Temporary Redirect (307), Permanent Redirect (308).
  • I ARM-mallar: Found, Moved, TemporaryRedirect, PermanentRedirect
Omdirigeringsprotokoll
  • I Azure Portal: Match Request, HTTP,HTTPS
  • I ARM-mallar: MatchRequest, Http, Https
Målvärd Det värdnamn som du vill att begäran ska omdirigeras till. Lämna tomt för att bevara den inkommande värden.
Målsökväg Sökvägen som ska användas i omdirigeringen. Inkludera den inledande /. Lämna tomt för att bevara den inkommande sökvägen.
Frågesträng Frågesträngen som används i omdirigeringen. Ta inte med inledande ?. Lämna tomt för att bevara den inkommande frågesträngen.
Målfragment Fragmentet som ska användas i omdirigeringen. Lämna tomt för att bevara det inkommande fragmentet.

Exempel

I det här exemplet omdirigerar vi begäran till https://contoso.com/exampleredirection?clientIp={client_ip}, samtidigt som fragmentet bevaras. En tillfällig HTTP-omdirigering (307) används. IP-adressen för klienten används i stället för {client_ip} token i URL:en med hjälp client_ip av servervariabeln.

Skärmbild av portalen som visar url-omdirigeringsåtgärden.

URL-omskrivning

Använd url-omskrivningsåtgärden för att skriva om sökvägen till en begäran som är på väg till ditt ursprung. Azure Front Door stöder dynamisk insamling av URL-sökväg med {url_path:seg#} servervariabel och konverterar URL-sökvägen till gemener eller versaler med {url_path.tolower} eller {url_path.toupper}. Mer information finns i Servervariabler.

Egenskaper

Property Värden som stöds
Källmönster Definiera källmönstret i URL-sökvägen som ska ersättas. För närvarande använder källmönstret en prefixbaserad matchning. Om du vill matcha alla URL-sökvägar använder du ett snedstreck (/) som källmönstervärde.
Mål Definiera målsökvägen som ska användas i omskrivningen. Målsökvägen skriver över källmönstret.
Bevara omatchad sökväg Om värdet är Ja läggs den återstående sökvägen efter källmönstret till i den nya målsökvägen.

Exempel

I det här exemplet skriver vi om alla begäranden till sökvägen /redirectionoch bevarar inte resten av sökvägen.

Skärmbild av portalen som visar url-omskrivningsåtgärden.

Viktigt!

Azure Front Door (klassisk) dras tillbaka den 31 mars 2027. För att undvika avbrott i tjänsten är det viktigt att du migrerar dina Azure Front Door-profiler (klassiska) till Azure Front Door Standard- eller Premium-nivån senast i mars 2027. Mer information finns i Azure Front Door (klassisk) tillbakadragning.

I Azure Front Door (klassisk) kan en regelmotor bestå av upp till 25 regler som innehåller matchande villkor och associerade åtgärder. Den här artikeln innehåller en detaljerad beskrivning av varje åtgärd som du kan definiera i en regel.

En åtgärd definierar det beteende som tillämpas på den begärandetyp som matchar villkoret eller uppsättningen matchningsvillkor. I regelmotorkonfigurationen kan en regel ha upp till 10 matchande villkor och 5 åtgärder. Du kan bara ha en åsidosättningskonfigurationsåtgärd i en enda regel.

Följande åtgärder är tillgängliga att använda i Regelmotorkonfiguration.

Ändra begärandehuvud

Använd dessa åtgärder för att ändra rubriker som finns i begäranden som skickas till serverdelen.

Obligatoriska fält

Åtgärd HTTP-huvudnamn Värde
Lägga till När det här alternativet väljs och regeln matchar läggs huvudet som anges i Rubriknamn till i begäran med det angivna värdet. Om huvudet redan finns läggs värdet till i det befintliga värdet. String
Skriv över När det här alternativet är markerat och regeln matchar läggs huvudet som anges i Rubriknamn till i begäran med det angivna värdet. Om rubriken redan finns skriver det angivna värdet över det befintliga värdet. String
Delete När det här alternativet väljs med matchande regler och huvudet som anges i regeln finns, tas huvudet bort från begäran. String

Ändra svarsrubrik

Använd dessa åtgärder för att ändra rubriker som finns i svar som returneras till dina klienter.

Obligatoriska fält

Åtgärd HTTP-huvudnamn Värde
Lägga till När det här alternativet väljs och regeln matchar läggs huvudet som anges i Rubriknamn till i svaret med hjälp av det angivna värdet. Om huvudet redan finns läggs Värdet till i det befintliga värdet. String
Skriv över När det här alternativet är markerat och regeln matchar läggs huvudet som anges i Rubriknamn till i svaret med hjälp av det angivna värdet. Om rubriken redan finns skriver Value över det befintliga värdet. String
Delete När det här alternativet väljs med matchande regler och huvudet som anges i regeln finns, tas huvudet bort från svaret. String

Åsidosättningar för routningskonfiguration

Vägtyp: Omdirigering

Använd dessa åtgärder för att omdirigera klienter till en ny URL.

Obligatoriska fält

Fält beskrivning
Omdirigeringstyp Omdirigering är ett sätt att skicka användare/klienter från en URL till en annan. En omdirigeringstyp anger statuskoden som används av klienter för att förstå syftet med omdirigeringen.

Du kan välja följande omdirigeringsstatuskoder: Hittad (302), Flyttad (301), Tillfällig omdirigering (307) och Permanent omdirigering (308).
Omdirigeringsprotokoll Behåll protokollet enligt den inkommande begäran eller definiera ett nytt protokoll för omdirigeringen. Välj till exempel HTTPS för HTTP till HTTPS-omdirigering.
Målvärd Ange det här värdet om du vill ändra värdnamnet i URL:en för omdirigeringen eller på annat sätt behålla värdnamnet från den inkommande begäran.
Målsökväg Behåll sökvägen enligt den inkommande begäran eller uppdatera sökvägen i URL:en för omdirigeringen.
Frågesträng Ange det här värdet för att ersätta en befintlig frågesträng från den inkommande begärande-URL:en eller på annat sätt behålla den ursprungliga uppsättningen frågesträngar.
Målfragment Målfragmentet är den del av URL:en efter "#", som normalt används av webbläsare för att landa på ett specifikt avsnitt på en sida. Ange det här värdet för att lägga till ett fragment i omdirigerings-URL:en.

Vägtyp: Framåt

Använd dessa åtgärder för att vidarebefordra klienter till en ny URL. Dessa åtgärder innehåller även underåtgärder för URL-omskrivningar och cachelagring.

Fält beskrivning
Serverdelspool Välj serverdelspoolen för att åsidosätta och hantera begäranden. Du ser för närvarande alla dina förkonfigurerade serverdelspooler i Din Front Door-profil.
Protokollet för vidarebefordran Protokoll som ska användas för vidarebefordran av begäran till serverdelen eller matcha protokollet från inkommande begäran.
URL-omskrivning Sökväg som ska användas när du skapar begäran om URL-omskrivning för att vidarebefordra till serverdelen.
Cachelagring Aktivera cachelagring för den här routningsregeln. När det är aktiverat cachelagrar Azure Front Door ditt statiska innehåll.

URL-omskrivning

Använd den här inställningen om du vill konfigurera en valfri anpassad vidarebefordranväg som ska användas när du skapar begäran om att vidarebefordra till serverdelen.

Fält beskrivning
Anpassad vidarebefordringssökväg Definiera en sökväg som begäranden vidarebefordras till.

Cachelagring

Använd de här inställningarna för att styra hur filer cachelagras för begäranden som innehåller frågesträngar. Om innehållet ska cachelagrats baserat på alla parametrar eller på valda parametrar. Du kan använda de här inställningarna för att skriva över TTL-värdet (time to live) för att styra hur länge innehållet ska finnas kvar i cacheminnet. Om du vill framtvinga cachelagring som en åtgärd anger du cachelagringsfältet till "Aktiverat". När du tvingar fram cachelagring visas följande alternativ:

Cachebeteende beskrivning
Ignorera frågesträng När tillgången har cachelagrats ignorerar alla efterföljande begäranden frågesträngarna tills den cachelagrade tillgången upphör att gälla.
Använda frågesträng Varje begäran med en unik URL, inklusive frågesträngen, behandlas som en unik tillgång med sin egen cache.
Ignorera angivna frågesträngar Frågesträngar för begärande-URL som anges i inställningen "Frågeparametrar" ignoreras för cachelagring.
Inkludera angivna frågesträngar Frågesträngar för begärande-URL som anges i inställningen "Frågeparametrar" används för cachelagring.
Andra fält beskrivning
Dynamisk komprimering Front Door kan dynamiskt komprimera innehåll på kanten, vilket resulterar i ett mindre och snabbare svar.
Frågeparametrar En kommaavgränsad lista över tillåtna eller otillåtna parametrar som ska användas som grund för cachelagring.
Använd standardvaraktighet för cache Ange att använda Azure Front Door standardlängd för cachelagring eller definiera en cachelagringstid som ignorerar ursprungssvarsdirektivet.

Nästa steg