Regel uppsättnings åtgärder för Azure front dörr standard/Premium (för hands version)Azure Front Door Standard/Premium (Preview) Rule Set actions

Anteckning

Den här dokumentationen gäller för Azure frontend-standard/Premium (för hands version).This documentation is for Azure Front Door Standard/Premium (Preview). Letar du efter information om Azures frontend-dörr?Looking for information on Azure Front Door? Visa här.View here.

En regel uppsättning för standard/Premium i Azure-dörren består av regler med en kombination av matchnings villkor och åtgärder.An Azure Front Door Standard/Premium Rule Set consist of rules with a combination of match conditions and actions. Den här artikeln innehåller en detaljerad beskrivning av de åtgärder som du kan använda i Azures standard-/Premium regel uppsättning.This article provides a detailed description of the actions you can use in Azure Front Door Standard/Premium Rule Set. Åtgärden definierar det beteende som tillämpas på en typ av begäran som ett matchnings villkor identifierar.The action defines the behavior that gets applied to a request type that a match condition(s) identifies. I en regel uppsättning för Azure frontend-dörren (standard/Premium) kan en regel innehålla upp till fem åtgärder.In an Azure Front Door (Standard/Premium) Rule Set, a rule can contain up to five actions.

Viktigt

Azure front dörr standard/Premium (för hands version) är för närvarande en offentlig för hands version.Azure Front Door Standard/Premium (Preview) is currently in public preview. Den här förhandsversionen tillhandahålls utan serviceavtal och rekommenderas inte för produktionsarbetsbelastningar.This preview version is provided without a service level agreement, and it's not recommended for production workloads. Vissa funktioner kanske inte stöds eller kan vara begränsade.Certain features might not be supported or might have constrained capabilities. Mer information finns i Kompletterande villkor för användning av Microsoft Azure-förhandsversioner.For more information, see Supplemental Terms of Use for Microsoft Azure Previews.

Följande åtgärder är tillgängliga för användning i Azures front dörrs regel uppsättning.The following actions are available to use in Azure Front Door rule set.

Förfallo tid för cacheCache expiration

Använd timeout-åtgärden för cache för att skriva över TTL-värdet (Time to Live) för slut punkten för begär Anden som regler matchar villkoren anger.Use the cache expiration action to overwrite the time to live (TTL) value of the endpoint for requests that the rules match conditions specify.

Anteckning

Ursprung kan ange att de inte cachelagrar vissa svar med hjälp av Cache-Control rubriken med värdet no-cache , private , eller no-store .Origins may specify not to cache specific responses using the Cache-Control header with a value of no-cache, private, or no-store. I dessa fall kommer front dörren aldrig att cachelagra innehållet och åtgärden kommer inte att ha någon verkan.In these circumstances, Front Door will never cache the content and this action will have no effect.

EgenskaperProperties

EgenskapProperty Värden som stödsSupported values
Cache-beteendeCache behavior
  • Kringgå cacheminne: Innehållet ska inte cachelagras.Bypass cache: The content should not be cached. I ARM-mallar anger du cacheBehavior egenskapen till BypassCache .In ARM templates, set the cacheBehavior property to BypassCache.
  • Åsidosätt: Det TTL-värde som returneras från ditt ursprung skrivs över med det värde som anges i åtgärden.Override: The TTL value returned from your origin is overwritten with the value specified in the action. Detta beteende gäller endast om svaret är cacheable.This behavior will only be applied if the response is cacheable. I ARM-mallar anger du cacheBehavior egenskapen till Override .In ARM templates, set the cacheBehavior property to Override.
  • Ange om det saknas: Om inget TTL-värde returneras från ditt ursprung anger regeln TTL-värdet till det värde som anges i åtgärden.Set if missing: If no TTL value gets returned from your origin, the rule sets the TTL to the value specified in the action. Detta beteende gäller endast om svaret är cacheable.This behavior will only be applied if the response is cacheable. I ARM-mallar anger du cacheBehavior egenskapen till SetIfMissing .In ARM templates, set the cacheBehavior property to SetIfMissing.
Varaktighet för cacheCache duration När cache-beteendet är inställt på Override eller Set if missing , måste dessa fält ange den cache-tid som ska användas.When Cache behavior is set to Override or Set if missing, these fields must specify the cache duration to use. Maximal varaktighet är 366 dagar.The maximum duration is 366 days.
  • I Azure Portal: Ange dagar, timmar, minuter och sekunder.In the Azure portal: specify the days, hours, minutes, and seconds.
  • I ARM-mallar: ange varaktigheten i formatet d.hh:mm:ss .In ARM templates: specify the duration in the format d.hh:mm:ss.

ExempelExample

I det här exemplet åsidosätter vi cachens förfallo datum till 6 timmar, för matchade begär Anden som inte anger varaktighet för cachen.In this example, we override the cache expiration to 6 hours, for matched requests that don't specify a cache duration already.

Portal skärm bild som visar förfallo åtgärd för cache.

Frågesträng för cache-nyckelCache key query string

Använd åtgärden för frågesträngen cache Key för att ändra cache-nyckeln baserat på frågesträngar.Use the cache key query string action to modify the cache key based on query strings. Cache-nyckeln är det sätt som front dörren identifierar unika begär Anden som ska cachelagras.The cache key is the way that Front Door identifies unique requests to cache.

EgenskaperProperties

EgenskapProperty Värden som stödsSupported values
BeteendeBehavior
  • Inkludera: Frågesträngar som anges i parametrarna kommer att tas med när cache-nyckeln genereras.Include: Query strings specified in the parameters get included when the cache key gets generated. I ARM-mallar anger du queryStringBehavior egenskapen till Include .In ARM templates, set the queryStringBehavior property to Include.
  • Cachelagra varje unik URL: Varje unik URL har sin egen cache-nyckel.Cache every unique URL: Each unique URL has its own cache key. I ARM-mallar använder du queryStringBehavior IncludeAll .In ARM templates, use the queryStringBehavior of IncludeAll.
  • Undanta: Frågesträngarna som anges i parametrarna undantas när cache-nyckeln genereras.Exclude: Query strings specified in the parameters get excluded when the cache key gets generated. I ARM-mallar anger du queryStringBehavior egenskapen till Exclude .In ARM templates, set the queryStringBehavior property to Exclude.
  • Ignorera frågesträngar: Frågesträngar beaktas inte när cache-nyckeln genereras.Ignore query strings: Query strings aren't considered when the cache key gets generated. I ARM-mallar anger du queryStringBehavior egenskapen till ExcludeAll .In ARM templates, set the queryStringBehavior property to ExcludeAll.
ParametrarParameters Listan över parameter namn för frågesträng, avgränsade med kommatecken.The list of query string parameter names, separated by commas.

ExempelExample

I det här exemplet ändrar vi cache-nyckeln för att inkludera en frågesträngparametern med namnet customerId .In this example, we modify the cache key to include a query string parameter named customerId.

Portal skärm bild som visar åtgärd för frågesträng för cache-nyckel.

Ändra rubrik för begäranModify request header

Använd åtgärden ändra begär ande huvud för att ändra rubrikerna i begäran när den skickas till ditt ursprung.Use the modify request header action to modify the headers in the request when it is sent to your origin.

EgenskaperProperties

EgenskapProperty Värden som stödsSupported values
OperatorOperator
  • Lägg till: Det angivna sidhuvudet läggs till i begäran med det angivna värdet.Append: The specified header gets added to the request with the specified value. Om rubriken redan finns läggs värdet till i det befintliga huvudet med hjälp av sträng sammanfogning.If the header is already present, the value is appended to the existing header value using string concatenation. Inga avgränsare har lagts till.No delimiters are added. I ARM-mallar använder du headerAction Append .In ARM templates, use the headerAction of Append.
  • Skriv över: Det angivna sidhuvudet läggs till i begäran med det angivna värdet.Overwrite: The specified header gets added to the request with the specified value. Om rubriken redan finns skriver det angivna värdet över det befintliga värdet.If the header is already present, the specified value overwrites the existing value. I ARM-mallar använder du headerAction Overwrite .In ARM templates, use the headerAction of Overwrite.
  • Ta bort: Om rubriken som anges i regeln finns, tas rubriken bort från begäran.Delete: If the header specified in the rule is present, the header gets deleted from the request. I ARM-mallar använder du headerAction Delete .In ARM templates, use the headerAction of Delete.
HuvudnamnHeader name Namnet på rubriken som ska ändras.The name of the header to modify.
HuvudvärdeHeader value Värdet som ska läggas till eller skrivas över.The value to append or overwrite.

ExempelExample

I det här exemplet lägger vi till värdet AdditionalValue i MyRequestHeader begär ande huvudet.In this example, we append the value AdditionalValue to the MyRequestHeader request header. Om det ursprungliga värdet för svars huvudet har angetts till ett värde på ValueSetByClient , skulle rubriken för begäran ha värdet ValueSetByClientAdditionalValue .If the origin set the response header to a value of ValueSetByClient, then after this action is applied, the request header would have a value of ValueSetByClientAdditionalValue.

Portal skärm bild som visar åtgärden ändra begär ande huvud.

Ändra svars huvudModify response header

Använd åtgärden ändra svars huvud för att ändra huvuden som finns i svar innan de returneras till dina klienter.Use the modify response header action to modify headers that are present in responses before they are returned to your clients.

EgenskaperProperties

EgenskapProperty Värden som stödsSupported values
OperatorOperator
  • Lägg till: Det angivna sidhuvudet läggs till i svaret med det angivna värdet.Append: The specified header gets added to the response with the specified value. Om rubriken redan finns läggs värdet till i det befintliga huvudet med hjälp av sträng sammanfogning.If the header is already present, the value is appended to the existing header value using string concatenation. Inga avgränsare har lagts till.No delimiters are added. I ARM-mallar använder du headerAction Append .In ARM templates, use the headerAction of Append.
  • Skriv över: Det angivna sidhuvudet läggs till i svaret med det angivna värdet.Overwrite: The specified header gets added to the response with the specified value. Om rubriken redan finns skriver det angivna värdet över det befintliga värdet.If the header is already present, the specified value overwrites the existing value. I ARM-mallar använder du headerAction Overwrite .In ARM templates, use the headerAction of Overwrite.
  • Ta bort: Om rubriken som anges i regeln finns, tas rubriken bort från svaret.Delete: If the header specified in the rule is present, the header gets deleted from the response. I ARM-mallar använder du headerAction Delete .In ARM templates, use the headerAction of Delete.
HuvudnamnHeader name Namnet på rubriken som ska ändras.The name of the header to modify.
HuvudvärdeHeader value Värdet som ska läggas till eller skrivas över.The value to append or overwrite.

ExempelExample

I det här exemplet tar vi bort rubriken med namnet X-Powered-By från svaren innan de returneras till klienten.In this example, we delete the header with the name X-Powered-By from the responses before they are returned to the client.

Portal skärm bild som visar åtgärd för att ändra svars huvud.

URL-omdirigeringURL redirect

Använd åtgärden URL-omdirigering för att omdirigera klienter till en ny URL.Use the URL redirect action to redirect clients to a new URL. Klienterna skickar ett omdirigerings svar från Front dörren.Clients are sent a redirection response from Front Door.

EgenskaperProperties

EgenskapProperty Värden som stödsSupported values
Omdirigera typRedirect type Svars typen som ska returneras till begär Anden.The response type to return to the requestor.
  • I Azure Portal: påträffades (302), flyttades (301), tillfällig omdirigering (307), permanent omdirigering (308).In the Azure portal: Found (302), Moved (301), Temporary Redirect (307), Permanent Redirect (308).
  • I ARM-mallar: Found ,, Moved TemporaryRedirect , PermanentRedirectIn ARM templates: Found, Moved, TemporaryRedirect, PermanentRedirect
Omdirigera protokollRedirect protocol
  • I Azure Portal: Match Request , HTTP , HTTPSIn the Azure portal: Match Request, HTTP, HTTPS
  • I ARM-mallar: MatchRequest , Http , HttpsIn ARM templates: MatchRequest, Http, Https
MålvärdDestination host Värd namnet som du vill att begäran ska omdirigeras till.The host name you want the request to be redirected to. Lämna tomt om du vill bevara den inkommande värden.Leave blank to preserve the incoming host.
MålsökvägDestination path Sökvägen som ska användas i omdirigeringen.The path to use in the redirect. Ta med rad avståndet / .Include the leading /. Lämna tomt om du vill behålla den inkommande sökvägen.Leave blank to preserve the incoming path.
FrågesträngQuery string Frågesträngen som används i omdirigeringen.The query string used in the redirect. Ta inte med rad avståndet ? .Don't include the leading ?. Lämna tomt om du vill behålla inkommande frågesträng.Leave blank to preserve the incoming query string.
MålcachenDestination fragment Fragment som ska användas i omdirigeringen.The fragment to use in the redirect. Lämna tomt om du vill behålla det inkommande fragmentet.Leave blank to preserve the incoming fragment.

ExempelExample

I det här exemplet omdirigerar vi begäran till https://contoso.com/exampleredirection?clientIp={client_ip} , samtidigt som du behåller fragmentet.In this example, we redirect the request to https://contoso.com/exampleredirection?clientIp={client_ip}, while preserving the fragment. En tillfällig HTTP-omdirigering (307) används.An HTTP Temporary Redirect (307) is used. Klientens IP-adress används i stället för {client_ip} token i URL: en med hjälp av client_ip Server variabeln.The IP address of the client is used in place of the {client_ip} token within the URL by using the client_ip server variable.

Portal skärm bild som visar Omdirigerad URL-åtgärd.

URL-omskrivningURL rewrite

Använd åtgärden för URL-omskrivning för att skriva om sökvägen för en begäran som är en väg till ditt ursprung.Use the URL rewrite action to rewrite the path of a request that's en route to your origin.

EgenskaperProperties

EgenskapProperty Värden som stödsSupported values
Käll mönsterSource pattern Definiera käll mönstret i URL-sökvägen som ska ersättas.Define the source pattern in the URL path to replace. För närvarande använder käll mönstret en prefix-baserad matchning.Currently, source pattern uses a prefix-based match. Använd ett snedstreck ( / ) som käll mönster värde för att matcha alla URL-sökvägar.To match all URL paths, use a forward slash (/) as the source pattern value.
MålDestination Definiera den mål Sök väg som ska användas vid omskrivning.Define the destination path to use in the rewrite. Mål Sök vägen skriver över käll mönstret.The destination path overwrites the source pattern.
Bevara omatchad sökvägPreserve unmatched path Om värdet är Ja, läggs den återstående sökvägen efter käll mönstret till i den nya mål Sök vägen.If set to Yes, the remaining path after the source pattern is appended to the new destination path.

ExempelExample

I det här exemplet skriver vi om alla begär anden till sökvägen /redirection och bevarar inte resten av sökvägen.In this example, we rewrite all requests to the path /redirection, and don't preserve the remainder of the path.

Portal skärm bild som visar åtgärden för URL-omskrivning.

ServervariablerServer variables

Regel uppsättningens servervariabler ger till gång till strukturerad information om begäran.Rule Set server variables provide access to structured information about the request. Du kan använda servervariabler för att dynamiskt ändra begär ande-/svarshuvuden eller URL-omskrivna sökvägar/frågesträngar, till exempel när en ny sid inläsning eller när ett formulär publiceras.You can use server variables to dynamically change the request/response headers or URL rewrite paths/query strings, for example, when a new page load or when a form is posted.

Variabler som stödsSupported variables

VariabelnamnVariable name BeskrivningDescription
socket_ip IP-adressen för den direkta anslutningen till Azures främre dörr kant.The IP address of the direct connection to Azure Front Door edge. Om klienten använder en HTTP-proxy eller en belastningsutjämnare för att skicka begäran, är värdet för socket_ip proxyserverns IP-adress eller belastningsutjämnare.If the client used an HTTP proxy or a load balancer to send the request, the value of socket_ip is the IP address of the proxy or load balancer.
client_ip IP-adressen för klienten som gjorde den ursprungliga begäran.The IP address of the client that made the original request. Om det fanns en X-Forwarded-For rubrik i begäran plockas klientens IP-adress från rubriken.If there was an X-Forwarded-For header in the request, then the client IP address is picked from the header.
client_port IP-porten för den klient som gjorde begäran.The IP port of the client that made the request.
hostname Värd namnet i begäran från klienten.The host name in the request from the client.
geo_country Anger förfrågans land/region med hjälp av lands-/region koden.Indicates the requester's country/region of origin through its country/region code.
http_method Den metod som används för att göra URL-begäran, till exempel GET eller POST .The method used to make the URL request, such as GET or POST.
http_version Protokollet för begäran.The request protocol. Vanligt vis HTTP/1.0 , HTTP/1.1 eller HTTP/2.0 .Usually HTTP/1.0, HTTP/1.1, or HTTP/2.0.
query_string Listan över variabel/värde-par som följer "?" i den begärda URL: en.The list of variable/value pairs that follows the "?" in the requested URL.
I begäran är till exempel http://contoso.com:8080/article.aspx?id=123&title=fabrikam query_string värdet id=123&title=fabrikam .For example, in the request http://contoso.com:8080/article.aspx?id=123&title=fabrikam, the query_string value will be id=123&title=fabrikam.
request_scheme Schemat för begäran: http eller https .The request scheme: http or https.
request_uri Fullständig URI för ursprunglig begäran (med argument).The full original request URI (with arguments).
I begäran är till exempel http://contoso.com:8080/article.aspx?id=123&title=fabrikam request_uri värdet /article.aspx?id=123&title=fabrikam .For example, in the request http://contoso.com:8080/article.aspx?id=123&title=fabrikam, the request_uri value will be /article.aspx?id=123&title=fabrikam.
ssl_protocol Protokollet för en etablerad TLS-anslutning.The protocol of an established TLS connection.
server_port Porten för den server som godkände en begäran.The port of the server that accepted a request.
url_path Identifierar den angivna resursen i värden som webb klienten vill ha åtkomst till.Identifies the specific resource in the host that the web client wants to access. Detta är en del av URI: n för begäran utan argumenten.This is the part of the request URI without the arguments.
I begäran är till exempel http://contoso.com:8080/article.aspx?id=123&title=fabrikam uri_path värdet /article.aspx .For example, in the request http://contoso.com:8080/article.aspx?id=123&title=fabrikam, the uri_path value will be /article.aspx.

Server variabel formatServer variable format

Servervariabler kan anges med följande format:Server variables can be specified using the following formats:

  • {variable}: Ta med hela Server variabeln.{variable}: Include the entire server variable. Om klientens IP-adress till exempel är, 111.222.333.444 {client_ip} skulle token utvärderas till 111.222.333.444 .For example, if the client IP address is 111.222.333.444 then the {client_ip} token would evaluate to 111.222.333.444.
  • {variable:offset}: Inkludera Server variabeln efter en bestämd förskjutning, fram till slutet av variabeln.{variable:offset}: Include the server variable after a specific offset, until the end of the variable. Förskjutningen är noll-baserad.The offset is zero-based. Om klientens IP-adress till exempel är, 111.222.333.444 {client_ip:3} skulle token utvärderas till .222.333.444 .For example, if the client IP address is 111.222.333.444 then the {client_ip:3} token would evaluate to .222.333.444.
  • {variable:offset:length}: Inkludera Server variabeln efter en viss förskjutning, upp till den angivna längden.{variable:offset:length}: Include the server variable after a specific offset, up to the specified length. Förskjutningen är noll-baserad.The offset is zero-based. Om klientens IP-adress till exempel är, 111.222.333.444 {client_ip:4:3} skulle token utvärderas till 222 .For example, if the client IP address is 111.222.333.444 then the {client_ip:4:3} token would evaluate to 222.

Åtgärder som stödsSupported actions

Servervariabler stöds för följande åtgärder:Server variables are supported on the following actions:

  • Frågesträng för cache-nyckelCache key query string
  • Ändra rubrik för begäranModify request header
  • Ändra svars huvudModify response header
  • URL-omdirigeringURL redirect
  • URL-omskrivningURL rewrite

Nästa stegNext steps