Acties voor het instellen van regels voor Azure front-deur Standard/Premium (preview)Azure Front Door Standard/Premium (Preview) Rule Set actions

Notitie

Deze documentatie is voor Azure front deur Standard/Premium (preview).This documentation is for Azure Front Door Standard/Premium (Preview). Zoekt u informatie over de voor deur van Azure?Looking for information on Azure Front Door? Hierweer geven.View here.

Een Azure front deur Standard/Premium- regel reeks bestaat uit regels met een combi natie van match voorwaarden en acties.An Azure Front Door Standard/Premium Rule Set consist of rules with a combination of match conditions and actions. Dit artikel bevat een gedetailleerde beschrijving van de acties die u kunt gebruiken in de Azure front deur Standard/Premium-regelset.This article provides a detailed description of the actions you can use in Azure Front Door Standard/Premium Rule Set. De actie definieert het gedrag dat wordt toegepast op een aanvraag type dat overeenkomt met een of meer voor waarden.The action defines the behavior that gets applied to a request type that a match condition(s) identifies. In een regelset voor een Azure front-deur (Standard/Premium) kan een regel Maxi maal vijf acties bevatten.In an Azure Front Door (Standard/Premium) Rule Set, a rule can contain up to five actions.

Belangrijk

Azure front deur Standard/Premium (preview) is momenteel beschikbaar als open bare preview.Azure Front Door Standard/Premium (Preview) is currently in public preview. Deze preview-versie wordt aangeboden zonder service level agreement en wordt niet aanbevolen voor productieworkloads.This preview version is provided without a service level agreement, and it's not recommended for production workloads. Misschien worden bepaalde functies niet ondersteund of zijn de mogelijkheden ervan beperkt.Certain features might not be supported or might have constrained capabilities. Zie Supplemental Terms of Use for Microsoft Azure Previews (Aanvullende gebruiksvoorwaarden voor Microsoft Azure-previews) voor meer informatie.For more information, see Supplemental Terms of Use for Microsoft Azure Previews.

De volgende acties zijn beschikbaar voor gebruik in de Azure front-deur regel reeks.The following actions are available to use in Azure Front Door rule set.

Verval datum van cacheCache expiration

Gebruik de actie verloop tijd cache om de TTL-waarde (time to Live) van het eind punt te overschrijven voor aanvragen die voldoen aan de regels voor waarden.Use the cache expiration action to overwrite the time to live (TTL) value of the endpoint for requests that the rules match conditions specify.

Notitie

Oorsprongen kunnen opgeven dat geen specifieke antwoorden in de cache moeten worden opgeslagen met de Cache-Control header met de waarde no-cache , private of 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. In deze omstandigheden wordt de inhoud nooit in de cache opgeslagen en deze actie heeft geen effect.In these circumstances, Front Door will never cache the content and this action will have no effect.

EigenschappenProperties

EigenschapProperty Ondersteunde waardenSupported values
CachegedragCache behavior
  • Cache overs Laan: De inhoud mag niet in de cache worden opgeslagen.Bypass cache: The content should not be cached. Stel in ARM-sjablonen de cacheBehavior eigenschap in op BypassCache .In ARM templates, set the cacheBehavior property to BypassCache.
  • Overschrijven: De TTL-waarde die wordt geretourneerd door uw oorsprong, wordt overschreven door de waarde die is opgegeven in de actie.Override: The TTL value returned from your origin is overwritten with the value specified in the action. Dit gedrag wordt alleen toegepast als het antwoord in de cache kan worden opgeslagen.This behavior will only be applied if the response is cacheable. Stel in ARM-sjablonen de cacheBehavior eigenschap in op Override .In ARM templates, set the cacheBehavior property to Override.
  • Instellen indien ontbrekend: Als er geen TTL-waarde van uw oorsprong wordt geretourneerd, stelt de regel de TTL in op de waarde die is opgegeven in de actie.Set if missing: If no TTL value gets returned from your origin, the rule sets the TTL to the value specified in the action. Dit gedrag wordt alleen toegepast als het antwoord in de cache kan worden opgeslagen.This behavior will only be applied if the response is cacheable. Stel in ARM-sjablonen de cacheBehavior eigenschap in op SetIfMissing .In ARM templates, set the cacheBehavior property to SetIfMissing.
CacheduurCache duration Wanneer het cache gedrag is ingesteld op Override of Set if missing , moeten in deze velden de cache duur worden opgegeven die moet worden gebruikt.When Cache behavior is set to Override or Set if missing, these fields must specify the cache duration to use. De maximale duur is 366 dagen.The maximum duration is 366 days.
  • In de Azure Portal: Geef de dagen, uren, minuten en seconden op.In the Azure portal: specify the days, hours, minutes, and seconds.
  • In ARM-sjablonen: Geef de duur op in de notatie d.hh:mm:ss .In ARM templates: specify the duration in the format d.hh:mm:ss.

VoorbeeldExample

In dit voor beeld overschrijven we de verval datum van de cache tot 6 uur, voor overeenkomende aanvragen waarbij geen cache duur al is opgegeven.In this example, we override the cache expiration to 6 hours, for matched requests that don't specify a cache duration already.

Scherm opname van de portal toont de verval actie van de cache.

Query reeks voor de cache sleutelCache key query string

Gebruik de query teken reeks actie cache sleutel om de cache sleutel te wijzigen op basis van query teken reeksen.Use the cache key query string action to modify the cache key based on query strings. De cache sleutel is de manier waarop met de voor deur unieke aanvragen worden geïdentificeerd voor de cache.The cache key is the way that Front Door identifies unique requests to cache.

EigenschappenProperties

EigenschapProperty Ondersteunde waardenSupported values
GedragBehavior
  • Omvatten: Query reeksen die zijn opgegeven in de para meters, worden opgenomen als de cache sleutel wordt gegenereerd.Include: Query strings specified in the parameters get included when the cache key gets generated. Stel in ARM-sjablonen de queryStringBehavior eigenschap in op Include .In ARM templates, set the queryStringBehavior property to Include.
  • Elke unieke URL in de cache opslaan: Elke unieke URL heeft een eigen cache sleutel.Cache every unique URL: Each unique URL has its own cache key. In ARM-sjablonen gebruikt u de queryStringBehavior van IncludeAll .In ARM templates, use the queryStringBehavior of IncludeAll.
  • Uitsluiten: Query reeksen die zijn opgegeven in de para meters, worden uitgesloten wanneer de cache sleutel wordt gegenereerd.Exclude: Query strings specified in the parameters get excluded when the cache key gets generated. Stel in ARM-sjablonen de queryStringBehavior eigenschap in op Exclude .In ARM templates, set the queryStringBehavior property to Exclude.
  • Query reeksen negeren: Query reeksen worden niet meegenomen wanneer de cache sleutel wordt gegenereerd.Ignore query strings: Query strings aren't considered when the cache key gets generated. Stel in ARM-sjablonen de queryStringBehavior eigenschap in op ExcludeAll .In ARM templates, set the queryStringBehavior property to ExcludeAll.
ParametersParameters De lijst met parameter namen voor de query reeks, gescheiden door komma's.The list of query string parameter names, separated by commas.

VoorbeeldExample

In dit voor beeld wijzigen we de cache sleutel zodat deze een query teken reeks parameter bevat met de naam customerId .In this example, we modify the cache key to include a query string parameter named customerId.

Scherm opname van de portal met de query teken reeks actie cache sleutel.

Aanvraag header wijzigenModify request header

Gebruik de actie aanvraag header wijzigen om de kopteksten in de aanvraag te wijzigen wanneer deze naar uw oorsprong wordt verzonden.Use the modify request header action to modify the headers in the request when it is sent to your origin.

EigenschappenProperties

EigenschapProperty Ondersteunde waardenSupported values
OperatorOperator
  • Toevoegen: De opgegeven header wordt toegevoegd aan de aanvraag met de opgegeven waarde.Append: The specified header gets added to the request with the specified value. Als de header al aanwezig is, wordt de waarde toegevoegd aan de bestaande header waarde met behulp van teken reeksen samen voegen.If the header is already present, the value is appended to the existing header value using string concatenation. Er worden geen scheidings tekens toegevoegd.No delimiters are added. In ARM-sjablonen gebruikt u de headerAction van Append .In ARM templates, use the headerAction of Append.
  • Overschrijven: De opgegeven header wordt toegevoegd aan de aanvraag met de opgegeven waarde.Overwrite: The specified header gets added to the request with the specified value. Als er al een header aanwezig is, overschrijft de opgegeven waarde de bestaande waarde.If the header is already present, the specified value overwrites the existing value. In ARM-sjablonen gebruikt u de headerAction van Overwrite .In ARM templates, use the headerAction of Overwrite.
  • Verwijderen: Als de in de regel opgegeven header aanwezig is, wordt de header uit de aanvraag verwijderd.Delete: If the header specified in the rule is present, the header gets deleted from the request. In ARM-sjablonen gebruikt u de headerAction van Delete .In ARM templates, use the headerAction of Delete.
HeadernaamHeader name De naam van de koptekst die moet worden gewijzigd.The name of the header to modify.
HeaderwaardeHeader value De waarde die moet worden toegevoegd of overschreven.The value to append or overwrite.

VoorbeeldExample

In dit voor beeld voegen we de waarde AdditionalValue toe aan de MyRequestHeader aanvraag header.In this example, we append the value AdditionalValue to the MyRequestHeader request header. Als de oorsprong de antwoord header instelt op een waarde van ValueSetByClient , wordt nadat deze actie is toegepast, de aanvraag header de waarde 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.

Scherm opname van de portal met de actie aanvraag header wijzigen.

Antwoord header wijzigenModify response header

Gebruik de actie antwoord header wijzigen om kopteksten te wijzigen die aanwezig zijn in antwoorden voordat ze worden geretourneerd naar uw clients.Use the modify response header action to modify headers that are present in responses before they are returned to your clients.

EigenschappenProperties

EigenschapProperty Ondersteunde waardenSupported values
OperatorOperator
  • Toevoegen: De opgegeven header wordt toegevoegd aan het antwoord met de opgegeven waarde.Append: The specified header gets added to the response with the specified value. Als de header al aanwezig is, wordt de waarde toegevoegd aan de bestaande header waarde met behulp van teken reeksen samen voegen.If the header is already present, the value is appended to the existing header value using string concatenation. Er worden geen scheidings tekens toegevoegd.No delimiters are added. In ARM-sjablonen gebruikt u de headerAction van Append .In ARM templates, use the headerAction of Append.
  • Overschrijven: De opgegeven header wordt toegevoegd aan het antwoord met de opgegeven waarde.Overwrite: The specified header gets added to the response with the specified value. Als er al een header aanwezig is, overschrijft de opgegeven waarde de bestaande waarde.If the header is already present, the specified value overwrites the existing value. In ARM-sjablonen gebruikt u de headerAction van Overwrite .In ARM templates, use the headerAction of Overwrite.
  • Verwijderen: Als de in de regel opgegeven header aanwezig is, wordt de koptekst uit het antwoord verwijderd.Delete: If the header specified in the rule is present, the header gets deleted from the response. In ARM-sjablonen gebruikt u de headerAction van Delete .In ARM templates, use the headerAction of Delete.
HeadernaamHeader name De naam van de koptekst die moet worden gewijzigd.The name of the header to modify.
HeaderwaardeHeader value De waarde die moet worden toegevoegd of overschreven.The value to append or overwrite.

VoorbeeldExample

In dit voor beeld wordt de header met de naam X-Powered-By van de antwoorden verwijderd voordat ze worden geretourneerd naar de client.In this example, we delete the header with the name X-Powered-By from the responses before they are returned to the client.

Scherm opname van de portal met actie voor het wijzigen van de reactie header.

URL-omleidingURL redirect

Gebruik de actie URL-omleiding om clients om te leiden naar een nieuwe URL.Use the URL redirect action to redirect clients to a new URL. Clients ontvangen een omleidings reactie van de voor deur.Clients are sent a redirection response from Front Door.

EigenschappenProperties

EigenschapProperty Ondersteunde waardenSupported values
Type omleidingRedirect type Het antwoord type dat moet worden geretourneerd naar de aanvrager.The response type to return to the requestor.
  • In de Azure Portal: gevonden (302), verplaatst (301), tijdelijke omleiding (307), permanente omleiding (308).In the Azure portal: Found (302), Moved (301), Temporary Redirect (307), Permanent Redirect (308).
  • In ARM-sjablonen: Found , Moved , TemporaryRedirect , PermanentRedirectIn ARM templates: Found, Moved, TemporaryRedirect, PermanentRedirect
OmleidingsprotocolRedirect protocol
  • In de Azure Portal: Match Request , HTTP , HTTPSIn the Azure portal: Match Request, HTTP, HTTPS
  • In ARM-sjablonen: MatchRequest , Http , HttpsIn ARM templates: MatchRequest, Http, Https
DoelhostDestination host De naam van de host waarnaar u de aanvraag wilt omleiden.The host name you want the request to be redirected to. Laat het veld leeg om de binnenkomende host te behouden.Leave blank to preserve the incoming host.
DoelpadDestination path Het pad dat in de omleiding moet worden gebruikt.The path to use in the redirect. Neem de regel op / .Include the leading /. Laat het veld leeg als u het binnenkomende pad wilt behouden.Leave blank to preserve the incoming path.
QueryreeksenQuery string De query teken reeks die in de omleiding wordt gebruikt.The query string used in the redirect. Neem de regel niet op ? .Don't include the leading ?. Laat het veld leeg om de binnenkomende queryreeks te behouden.Leave blank to preserve the incoming query string.
DoelfragmentDestination fragment Het fragment dat in de omleiding moet worden gebruikt.The fragment to use in the redirect. Laat het veld leeg om het binnenkomende fragment te behouden.Leave blank to preserve the incoming fragment.

VoorbeeldExample

In dit voor beeld wordt de aanvraag omgeleid naar https://contoso.com/exampleredirection?clientIp={client_ip} , terwijl het fragment behouden blijft.In this example, we redirect the request to https://contoso.com/exampleredirection?clientIp={client_ip}, while preserving the fragment. Er wordt een HTTP-tijdelijke omleiding (307) gebruikt.An HTTP Temporary Redirect (307) is used. Het IP-adres van de client wordt gebruikt in plaats van het {client_ip} token in de URL met behulp van de client_ip server variabele.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.

Scherm opname van de portal met de URL-omleidings actie.

URL opnieuw schrijvenURL rewrite

Gebruik de actie voor het opnieuw schrijven van url's om het pad van een aanvraag die naar uw oorsprong is doorgestuurd, opnieuw te schrijven.Use the URL rewrite action to rewrite the path of a request that's en route to your origin.

EigenschappenProperties

EigenschapProperty Ondersteunde waardenSupported values
Bron patroonSource pattern Definieer het bron patroon in het URL-pad dat moet worden vervangen.Define the source pattern in the URL path to replace. Op dit moment gebruikt het bron patroon een overeenkomst op basis van voor voegsels.Currently, source pattern uses a prefix-based match. Als u wilt dat alle URL-paden overeenkomen, gebruikt u een slash ( / ) als bron patroon waarde.To match all URL paths, use a forward slash (/) as the source pattern value.
DoelDestination Definieer het doelpad dat moet worden gebruikt in de herschrijf bewerking.Define the destination path to use in the rewrite. Het doelpad overschrijft het bron patroon.The destination path overwrites the source pattern.
Niet-overeenkomend pad behoudenPreserve unmatched path Als deze instelling is ingesteld op Ja, wordt het resterende pad na het bron patroon toegevoegd aan het nieuwe doelpad.If set to Yes, the remaining path after the source pattern is appended to the new destination path.

VoorbeeldExample

In dit voor beeld worden alle aanvragen opnieuw naar het pad geschreven /redirection en blijft de rest van het pad onbewaard.In this example, we rewrite all requests to the path /redirection, and don't preserve the remainder of the path.

Scherm opname van de portal met de actie voor het opnieuw schrijven van URL'S.

Server variabelenServer variables

Server variabelen voor regel sets bieden toegang tot gestructureerde informatie over de aanvraag.Rule Set server variables provide access to structured information about the request. U kunt Server variabelen gebruiken voor het dynamisch wijzigen van de aanvraag/antwoord headers of het herschrijven van URL'S/query reeksen, bijvoorbeeld wanneer een nieuwe pagina wordt geladen of wanneer een formulier wordt gepost.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.

Ondersteunde variabelenSupported variables

Naam van de variabeleVariable name BeschrijvingDescription
socket_ip Het IP-adres van de directe verbinding met de breedte van de Azure front-deur.The IP address of the direct connection to Azure Front Door edge. Als de client een HTTP-proxy of een load balancer gebruikt voor het verzenden van de aanvraag, is de waarde van het socket_ip IP-adres van de proxy of Load Balancer.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 Het IP-adres van de client die de oorspronkelijke aanvraag heeft ingediend.The IP address of the client that made the original request. Als X-Forwarded-For de aanvraag een header bevat, wordt het IP-adres van de client uit de header opgehaald.If there was an X-Forwarded-For header in the request, then the client IP address is picked from the header.
client_port De IP-poort van de client die de aanvraag heeft ingediend.The IP port of the client that made the request.
hostname De hostnaam in de aanvraag van de client.The host name in the request from the client.
geo_country Geeft het land of de regio van oorsprong van de aanvrager aan via het land-of regio nummer.Indicates the requester's country/region of origin through its country/region code.
http_method De methode die wordt gebruikt voor het maken van de URL-aanvraag, zoals GET of POST .The method used to make the URL request, such as GET or POST.
http_version Het aanvraag protocol.The request protocol. Gewoonlijk HTTP/1.0 , HTTP/1.1 of HTTP/2.0 .Usually HTTP/1.0, HTTP/1.1, or HTTP/2.0.
query_string De lijst met variabele/waarde-paren die volgt op '? ' in de aangevraagde URL.The list of variable/value pairs that follows the "?" in the requested URL.
Zo is de waarde in de aanvraag http://contoso.com:8080/article.aspx?id=123&title=fabrikam query_string 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 Het aanvraag schema: http of https .The request scheme: http or https.
request_uri De volledige oorspronkelijke aanvraag-URI (met argumenten).The full original request URI (with arguments).
Zo is de waarde in de aanvraag http://contoso.com:8080/article.aspx?id=123&title=fabrikam request_uri /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 Het Protocol van een tot stand gebrachte TLS-verbinding.The protocol of an established TLS connection.
server_port De poort van de server die een aanvraag heeft geaccepteerd.The port of the server that accepted a request.
url_path Identificeert de specifieke resource in de host waartoe de webclient toegang wil.Identifies the specific resource in the host that the web client wants to access. Dit is het deel van de aanvraag-URI zonder de argumenten.This is the part of the request URI without the arguments.
Zo is de waarde in de aanvraag http://contoso.com:8080/article.aspx?id=123&title=fabrikam uri_path /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.

Indeling server variabeleServer variable format

Server variabelen kunnen worden opgegeven met de volgende indelingen:Server variables can be specified using the following formats:

  • {variable}: De volledige server variabele toevoegen.{variable}: Include the entire server variable. Als het IP-adres van de client bijvoorbeeld is, wordt 111.222.333.444 het {client_ip} token door berekend 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}: Voeg de server variabele toe na een specifieke offset, tot aan het einde van de variabele.{variable:offset}: Include the server variable after a specific offset, until the end of the variable. De offset is gebaseerd op nul.The offset is zero-based. Als het IP-adres van de client bijvoorbeeld is, wordt 111.222.333.444 het {client_ip:3} token door berekend .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}: Voeg de server variabele toe na een bepaalde offset, tot aan de opgegeven lengte.{variable:offset:length}: Include the server variable after a specific offset, up to the specified length. De offset is gebaseerd op nul.The offset is zero-based. Als het IP-adres van de client bijvoorbeeld is, wordt 111.222.333.444 het {client_ip:4:3} token door berekend 222 .For example, if the client IP address is 111.222.333.444 then the {client_ip:4:3} token would evaluate to 222.

Ondersteunde actiesSupported actions

Server variabelen worden ondersteund voor de volgende acties:Server variables are supported on the following actions:

  • Query reeks voor de cache sleutelCache key query string
  • Aanvraagheader wijzigenModify request header
  • Antwoordheader wijzigenModify response header
  • URL-omleidingURL redirect
  • URL opnieuw genererenURL rewrite

Volgende stappenNext steps