Akce sady pravidel

Sada pravidel služby Azure Front Door se skládá z pravidel s kombinací podmínek shody a akcí. Tento článek obsahuje podrobný popis akcí, které můžete použít v sadě pravidel. Akce definuje chování, které se použije u typu požadavku, který identifikuje podmínka shody. V sadě pravidel může mít pravidlo až pět akcí. Front Door také podporuje proměnnou serveru v rámci akcí v sadě pravidel.

Pro použití v sadě pravidel jsou k dispozici následující akce:

Přepsání konfigurace trasy

Akce přepsání konfigurace trasy se používá k přepsání skupiny původu nebo konfigurace ukládání do mezipaměti pro požadavek. Můžete se rozhodnout přepsat nebo respektovat konfigurace původní skupiny zadané v trase. Pokud přepíšete konfiguraci trasy, je nutné nastavit cache. Jinak se ukládání do mezipaměti pro požadavek zakáže.

Můžete také přepsat způsob ukládání souborů do mezipaměti pro konkrétní požadavky, včetně:

  • Změňte chování ukládání do mezipaměti definované původem.
  • Jak se používají parametry řetězce dotazu k vytvoření klíče pro mezipaměť požadavku.
  • Hodnota TTL (Time to Live) určuje, jak dlouho zůstane obsah v mezipaměti.

Vlastnosti

Vlastnictví Podporované hodnoty
Přepsat skupinu původu
  • Ano: Změňte skupinu zdroje použitou pro požadavek.
  • Ne: Použijte skupinu původu zadanou v trase.
Cacheování
  • Povoleno: Vynutit ukládání do mezipaměti pro požadavek.
  • Zakázáno: vynutit, aby byla mezipaměť zakázána pro daný požadavek.

Pokud je nastaveno přepsání skupiny původu na Ano, nastavte následující vlastnosti:

Vlastnictví Podporované hodnoty
Skupina původu Skupina původu, do které má být požadavek směrován. Toto nastavení přepíše konfiguraci zadanou v trase koncového bodu služby Front Door.
Protokol předávání Protokol, který má služba Front Door použít při předávání požadavku na cílový server. Podporované hodnoty jsou pouze HTTP, pouze HTTPS, shoda s příchozím požadavkem. Toto nastavení přepíše konfiguraci zadanou v trase koncového bodu služby Front Door.

Pokud je ukládání do mezipamětinastaveno na Povoleno, nastavte následující vlastnosti:

Vlastnictví Podporované hodnoty
Chování při ukládání řetězců dotazů do mezipaměti
  • Ignorovat řetězec dotazu: Řetězce dotazů se při vygenerování klíče mezipaměti nezohledňují. V šablonách ARM nastavte vlastnost queryStringCachingBehavior na IgnoreQueryString.
  • Použijte řetězec dotazu: Každá jedinečná adresa URL má svůj vlastní klíč mezipaměti. V šablonách ARM použijte queryStringCachingBehaviorUseQueryString.
  • Ignorovat zadaný řetězec dotazu: Řetězce dotazu zadané v parametrech se při vygenerování klíče mezipaměti vyloučí. V šablonách ARM nastavte vlastnost queryStringCachingBehavior na IgnoreSpecifiedQueryStrings.
  • Zahrňte zadaný řetězec dotazu: Řetězce dotazů zadané v parametrech se zahrnou při vygenerování klíče mezipaměti. V šablonách ARM nastavte vlastnost queryStringCachingBehavior na IncludeSpecifiedQueryStrings.
Parametry dotazu Seznam názvů parametrů řetězce dotazu oddělený čárkami. Tato vlastnost je nastavena pouze v případě , že chování při ukládání řetězce dotazu do mezipaměti je nastaveno na Ignorovat zadané řetězce dotazu nebo zahrnout zadané řetězce dotazu.
Komprese
  • Zpřístupněný: Front Door dynamicky komprimuje obsah na okraji, což vede k menší a rychlejší odezvě. Další informace naleznete v tématu Komprese souborů. V šablonách ARM nastavte vlastnost isCompressionEnabled na Enabled.
  • Invalidní. Front Door neprovádí kompresi. V šablonách ARM nastavte vlastnost isCompressionEnabled na Disabled.
Chování mezipaměti
  • Čest původu: Front Door vždy respektuje direktivu hlavičky odpovědi původu. Pokud direktiva původu chybí, služba Front Door ukládá obsah do mezipaměti od 1 do 3 dnů. V šablonách ARM nastavte vlastnost cacheBehavior na HonorOrigin.
  • Vždy přepsat: Hodnota TTL vrácená z vašeho zdroje se přepíše hodnotou zadanou v této akci. Toto chování se použije pouze v případě, že je odpověď uložená v mezipaměti. V šablonách ARM nastavte vlastnost cacheBehavior na OverrideAlways.
  • Přepsání v případě chybějícího zdroje: Pokud se z vašeho zdroje nevrátí žádná hodnota TTL, pravidlo nastaví hodnotu TTL podle nastavení akce. Toto chování se použije pouze v případě, že je odpověď uložená v mezipaměti. V šablonách ARM nastavte vlastnost cacheBehavior na OverrideIfOriginMissing.
Doba trvání mezipaměti Pokud je chování mezipaměti nastaveno na Override always hodnotu nebo Override if origin missing, musí tato pole určovat dobu trvání mezipaměti, která se má použít. Maximální doba trvání je 366 dní. Tato vlastnost je nastavena pouze v případě, že chování mezipaměti je nastaveno na Přepsání vždy nebo Přepsání, pokud zdroj chybí.
  • Na webu Azure Portal zadejte dny, hodiny, minuty a sekundy.
  • V šablonách ARM: použijte cacheDuration k určení doby trvání ve formátu d.hh:mm:ss.

Příklady

V tomto příkladu směrujeme všechny spárované požadavky na skupinu původu s názvem MyOriginGroupbez ohledu na konfiguraci v trase koncového bodu služby Front Door.

Snímek obrazovky portálu znázorňující akci změny skupiny původu

V tomto příkladu nastavíme klíč mezipaměti tak, aby zahrnoval parametr řetězce dotazu s názvem customerId. Komprese je aktivovaná a zásady ukládání do mezipaměti původního serveru jsou dodrženy.

Snímek obrazovky portálu zobrazující akci řetězce dotazu klíče mezipaměti

V tomto příkladu přepíšeme vypršení platnosti mezipaměti na 6 hodin u odpovídajících požadavků, které ještě nezadávají dobu trvání mezipaměti. Front Door ignoruje řetězec dotazu, když určuje klíč mezipaměti a je povolená komprese.

Snímek obrazovky portálu znázorňující akci vypršení platnosti mezipaměti

Úprava hlavičky požadavku

Pomocí akce upravit hlavičku požadavku můžete modifikovat hlavičky v požadavku při jeho odeslání ke svému původu.

Vlastnosti

Vlastnictví Podporované hodnoty
Operátor
  • Připojit: Zadaná hlavička se přidá do požadavku se zadanou hodnotou. Pokud už záhlaví existuje, připojí se hodnota k existující hodnotě záhlaví pomocí zřetězení řetězců. Nejsou přidány žádné oddělovače. V šablonách ARM použijte headerActionAppend.
  • Přepsat: Zadaná hlavička se přidá do požadavku se zadanou hodnotou. Pokud záhlaví již existuje, zadaná hodnota přepíše existující hodnotu. V šablonách ARM použijte headerActionOverwrite.
  • Vymazat: Pokud je hlavička zadaná v pravidle přítomna, záhlaví se z požadavku odstraní. V šablonách ARM použijte headerActionDelete.
Název záhlaví Název hlavičky, která se má upravit.
Hodnota záhlaví Hodnota, která se má připojit nebo přepsat.

Příklad

V tomto příkladu připojíme hodnotu AdditionalValue k hlavičce požadavku MyRequestHeader. Pokud zdroj nastavil hlavičku odpovědi na hodnotu ValueSetByClient, pak po použití této akce by hlavička požadavku měla hodnotu ValueSetByClientAdditionalValue.

Snímek obrazovky portálu zobrazující akci úpravy hlavičky žádosti

Poznámka:

Některé rezervované hlavičky služby Azure Front Door není možné upravovat pomocí akcí stroje pravidel, včetně akcí pro úpravu hlaviček požadavků a hlaviček odpovědí. Následující seznam vyhrazených hlaviček nelze upravit spolu s žádnými záhlavími s předponou x-ec a 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

Úprava hlavičky odpovědi

Pomocí akce upravit hlavičku odpovědi můžete upravit hlavičky, které jsou přítomné v odpovědích předtím, než se vrátí klientům.

Vlastnosti

Vlastnictví Podporované hodnoty
Operátor
  • Připojit: Zadaná hlavička se přidá do odpovědi se zadanou hodnotou. Pokud už záhlaví existuje, připojí se hodnota k existující hodnotě záhlaví pomocí zřetězení řetězců. Nejsou přidány žádné oddělovače. V šablonách ARM použijte headerActionAppend.
  • Přepsat: Zadaná hlavička se přidá do odpovědi se zadanou hodnotou. Pokud záhlaví již existuje, zadaná hodnota přepíše existující hodnotu. V šablonách ARM použijte headerActionOverwrite.
  • Vymazat: Pokud je hlavička zadaná v pravidle přítomna, záhlaví se z odpovědi odstraní. V šablonách ARM použijte headerActionDelete.
Název záhlaví Název hlavičky, která se má upravit.
Hodnota záhlaví Hodnota, která se má připojit nebo přepsat.

Příklad

V tomto příkladu odstraníme hlavičku s názvem X-Powered-By z odpovědí, než se vrátí klientovi.

Snímek obrazovky portálu znázorňující akci upravit hlavičku odpovědi

Poznámka:

Některé rezervované hlavičky služby Azure Front Door není možné upravovat pomocí akcí stroje pravidel, včetně akcí pro úpravu hlaviček požadavků a hlaviček odpovědí. Následující seznam vyhrazených hlaviček nelze upravit spolu s žádnými záhlavími s předponou x-ec a 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

Přesměrování adresy URL

Pomocí akce přesměrování adresy URL můžete přesměrovat klienty na novou adresu URL. Klientům je odeslána odpověď přesměrování ze služby Front Door. Azure Front Door podporuje dynamické zachytávání cest URL s {url_path:seg#} proměnnou serveru a převádí cestu URL na malá nebo velká písmena s {url_path.tolower} nebo {url_path.toupper}. Další informace naleznete v tématu Proměnné serveru.

Vlastnosti

Vlastnictví Podporované hodnoty
Typ přesměrování Typ odpovědi, který se má vrátit žadateli.
  • Na webu Azure Portal: Nalezeno (302), Přesunuto (301), Dočasné přesměrování (307), Trvalé přesměrování (308).
  • V šablonách ARM: Found, Moved, TemporaryRedirect, PermanentRedirect
Přesměrový protokol
  • Na webu Azure Portal: Match Request, HTTPHTTPS
  • V šablonách ARM: MatchRequest, Http, Https
Cílový hostitel Název hostitele, na který chcete požadavek přesměrovat. Pokud chcete zachovat příchozího hostitele, ponechte prázdné.
Cílová cesta Cesta, která se má použít v přesměrování. Přidejte úvodní /. Pokud chcete zachovat příchozí cestu, ponechte prázdné.
Řetězec dotazu Řetězec dotazu použitý v přesměrování. Nezahrnujte úvodní ?. Pokud chcete zachovat řetězec příchozího dotazu, ponechte prázdné.
Cílový fragment Fragment, který se má použít v přesměrování. Pokud chcete zachovat příchozí fragment, ponechte prázdné.

Příklad

V tomto příkladu přesměrujeme požadavek na https://contoso.com/exampleredirection?clientIp={client_ip}a přitom zachováme fragment. Používá se dočasné přesměrování HTTP (307). IP adresa klienta se používá místo tokenu {client_ip} v adrese URL pomocí client_ipproměnné serveru.

Snímek obrazovky portálu znázorňující akci přesměrování adresy URL

přepis adresy URL

Pomocí akce přepsání adresy URL přepište cestu požadavku, který je na cestě k cílovému serveru. Azure Front Door podporuje dynamické zachytávání cest URL s {url_path:seg#} proměnnou serveru a převádí cestu URL na malá nebo velká písmena s {url_path.tolower} nebo {url_path.toupper}. Další informace naleznete v tématu Proměnné serveru.

Vlastnosti

Vlastnictví Podporované hodnoty
Vzor zdroje Definujte zdrojový vzor v cestě URL, kterou chcete nahradit. Zdrojový vzor v současné době používá shodu založenou na předponě. Aby všechny cesty URL odpovídaly, použijte jako hodnotu zdrojového vzoru lomítko (/). Všimněte si, že pro zdrojový vzor se bere v úvahu pouze ta část cesty, která se nachází za vzory, které odpovídají v konfiguraci trasy. Další informace najdete ve zdrojovém vzoru.
Cíl Definujte cílovou cestu, kterou chcete použít v přepsání. Cílová cesta přepíše zdrojový vzor.
Zachovat nespárovanou cestu Pokud je nastavena hodnota Ano, zbývající část cesty po vzoru zdroje se připojí k nové cílové cestě.

Příklad

V tomto příkladu přepíšeme všechny požadavky na cestu /redirectiona nezachováme zbytek cesty.

Snímek obrazovky portálu znázorňující akci přepsání adresy URL

Důležité

Azure Front Door (Classic) bude 31. března 2027 vyřazena z provozu. Protože služba končí, již nepodporuje vytváření profilů, nové doménové onboardingy ani spravované certifikáty. Pokud se chcete vyhnout přerušení služeb, migrovat na Azure Front Door Standard nebo Premium. Další informace najdete v tématu Azure Front Door (klasické) vyřazení.

Ve službě Azure Front Door (Classic) může modul pravidel obsahovat až 25 pravidel obsahujících odpovídající podmínky a přidružené akce. Tento článek obsahuje podrobný popis jednotlivých akcí, které můžete definovat v pravidle.

Akce definuje chování použité u typu požadavku, které odpovídá podmínce nebo sadě podmínek shody. V konfiguraci stroje pravidel může mít pravidlo až 10 odpovídajících podmínek a 5 akcí. V jednom pravidlu můžete mít pouze jednu akci přepsání konfigurace směrování.

V konfiguraci pravidlového modulu jsou k dispozici následující akce.

Úprava hlavičky požadavku

Pomocí těchto akcí můžete upravit hlavičky, které jsou přítomné v požadavcích odesílaných do vašeho back-endu.

Povinná pole

Činnost Název hlavičky HTTP Hodnota
Připojit Když se tato možnost vybere a pravidlo se shoduje, přidá se hlavička zadaná v názvu hlavičky do požadavku se zadanou hodnotou. Pokud už záhlaví existuje, připojí se tato hodnota k existující hodnotě. Řetězec
Přepsat Pokud je tato možnost vybrána a pravidlo odpovídá, záhlaví zadané v názvu záhlaví se přidá do požadavku se zadanou hodnotou. Pokud záhlaví již existuje, zadaná hodnota přepíše existující hodnotu. Řetězec
Vymazat Když se tato možnost vybere s odpovídajícími pravidly a zobrazí se hlavička zadaná v pravidle, záhlaví se z požadavku odstraní. Řetězec

Úprava hlavičky odpovědi

Pomocí těchto akcí můžete upravit hlavičky, které jsou přítomné v odpovědích vrácených klientům.

Povinná pole

Činnost Název hlavičky HTTP Hodnota
Připojit Když se tato možnost vybere a pravidlo se shoduje, záhlaví zadané v názvu záhlaví se přidá do odpovědi pomocí zadané hodnoty. Pokud už záhlaví existuje, připojí se hodnota k existující hodnotě. Řetězec
Přepsat Pokud je tato možnost vybrána a pravidlo odpovídá, záhlaví zadané v názvu záhlaví se přidá do odpovědi pomocí zadané hodnoty. Pokud už záhlaví existuje, hodnota přepíše existující hodnotu. Řetězec
Vymazat Když vyberete tuto možnost s odpovídajícími pravidly a zobrazí se hlavička zadaná v pravidle, záhlaví se z odpovědi odstraní. Řetězec

Přepsání konfigurace trasy

Typ trasy: Přesměrování

Pomocí těchto akcí můžete přesměrovat klienty na novou adresu URL.

Povinná pole

Pole Popis
Typ přesměrování Přesměrování je způsob, jak odesílat uživatele nebo klienty z jedné adresy URL do jiné. Typ přesměrování nastaví stavový kód používaný klienty k pochopení účelu přesměrování.

Můžete vybrat následující stavové kódy přesměrování: Nalezeno (302), Přesunuto (301), Dočasné přesměrování (307) a Trvalé přesměrování (308).
Přesměrový protokol Zachovejte protokol podle příchozího požadavku nebo definujte nový protokol pro přesměrování. Například vyberte HTTPS pro přesměrování HTTP na HTTPS.
Cílový hostitel Nastavte tuto hodnotu na změnu názvu hostitele v adrese URL pro přesměrování nebo jinak zachovat název hostitele z příchozího požadavku.
Cílová cesta Buď si cestu zachovejte podle příchozího požadavku, nebo aktualizujte cestu v adrese URL pro přesměrování.
Řetězec dotazu Nastavte tuto hodnotu tak, aby nahradil jakýkoli existující řetězec dotazu z adresy URL příchozího požadavku nebo jinak zachoval původní sadu řetězců dotazu.
Cílový fragment Cílový fragment je část adresy URL za "#", která se obvykle používá v prohlížečích k přesměrování na konkrétní oddíly na stránce. Nastavte tuto hodnotu tak, aby se k adrese URL pro přesměrování přidal fragment.

Typ trasy: Vpřední

Použijte tyto kroky k přesměrování klientů na novou adresu URL. Tyto akce také obsahují dílčí akce pro přepsání adres URL a ukládání do mezipaměti.

Pole Popis
Skupina back-end serverů Vyberte back-endový fond, který chcete přepsat a obsloužit požadavky, zobrazí se všechny předem nakonfigurované back-endové fondy, které jsou aktuálně v profilu služby Front Door.
Protokol předávání Protokol, který se má použít k předávání požadavků na back-end nebo odpovídá protokolu z příchozího požadavku.
přepis adresy URL Cesta, která se má použít při vytváření požadavku na přepsání adresy URL pro přeposílání do back-endu.
Cacheování Povolte ukládání do mezipaměti pro toto pravidlo směrování. Když je tato možnost povolená, Azure Front Door ukládá statický obsah do mezipaměti.

přepis adresy URL

Pomocí tohoto nastavení můžete nakonfigurovat volitelnou vlastní cestu předávání , která se má použít při vytváření požadavku pro přeposílání do back-endu.

Pole Popis
Vlastní cesta přesměrování Určete cestu, na kterou se požadavky přesměrovávají.

Cacheování

Pomocí těchto nastavení můžete řídit, jak se soubory ukládají do mezipaměti pro požadavky obsahující řetězce dotazů. Určuje, jestli chcete obsah ukládat do mezipaměti na základě všech parametrů nebo vybraných parametrů. Pomocí těchto nastavení můžete přepsat hodnotu TTL (Time to Live) a řídit, jak dlouho zůstane obsah v mezipaměti. Pokud chcete vynutit ukládání do mezipaměti jako akci, nastavte pole ukládání do mezipaměti na Povoleno. Při vynucení ukládání do mezipaměti se zobrazí následující možnosti:

Chování mezipaměti Popis
Ignorovat řetězec dotazu Jakmile je prostředek uložen do mezipaměti, všechny následné požadavky ignorují řetězce dotazu, dokud nevyprší platnost prostředku v mezipaměti.
Použít řetězec dotazu Každý požadavek s jedinečnou adresou URL, včetně řetězce dotazu, se považuje za jedinečný prostředek s vlastní mezipamětí.
Ignorovat zadané řetězce dotazů Řetězce dotazu adresy URL požadavku uvedené v nastavení "Parametry dotazu" se při ukládání do mezipaměti ignorují.
Zahrnout určené řetězce dotazu Dotazovací řetězce URL uvedené v nastavení Parametry dotazu se používají ke cachování.
Další pole Popis
Dynamická komprese Front Door dokáže dynamicky komprimovat obsah na okraji, což vede k menší a rychlejší odezvě.
Parametry dotazu Čárkami oddělený seznam povolených nebo nepovolených parametrů, které se mají použít jako základ pro ukládání do mezipaměti.
Použít výchozí dobu trvání mezipaměti Nastavte použití výchozí doby ukládání do mezipaměti služby Azure Front Door nebo definujte dobu ukládání do mezipaměti, která ignoruje direktivu odpovědi původu.

Další kroky

  • Last updated on