Sdílet prostřednictvím

Akce sady pravidel

  • Článek

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 akci sady 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. Při přepsání konfigurace trasy však musíte nakonfigurovat ukládání do mezipaměti. 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ě:

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

Vlastnosti

Vlastnost Podporované hodnoty
Přepsání skupiny původu
  • Ano: Přepište skupinu původu použitou pro požadavek.
  • Ne: Použijte skupinu původu zadanou v trase.
Ukládání do mezipaměti
  • Povoleno: Vynucení povolení ukládání do mezipaměti pro požadavek
  • Zakázáno: Vynucení zakázání ukládání do mezipaměti pro požadavek

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

Vlastnost 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řesměrování Protokol pro službu Front Door, který se má použít při předávání požadavku na původ. 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ěti nastaveno na Povoleno, nastavte následující vlastnosti:

Vlastnost 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 generování klíče mezipaměti nepovažují. V šablonách ARM nastavte queryStringCachingBehavior vlastnost na IgnoreQueryStringhodnotu .
  • Použijte řetězec dotazu: Každá jedinečná adresa URL má svůj vlastní klíč mezipaměti. V šablonách ARM použijte queryStringCachingBehavior příkaz UseQueryString.
  • 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 queryStringCachingBehavior vlastnost na IgnoreSpecifiedQueryStringshodnotu .
  • Zahrňte zadaný řetězec dotazu: Řetězce dotazu zadané v parametrech se zahrnou při vygenerování klíče mezipaměti. V šablonách ARM nastavte queryStringCachingBehavior vlastnost na IncludeSpecifiedQueryStringshodnotu .
Parametry dotazů 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
  • Povoleno: Služba 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 isCompressionEnabled vlastnost na Enabledhodnotu .
  • Deaktivováno. Front Door neprovádí kompresi. V šablonách ARM nastavte isCompressionEnabled vlastnost na Disabledhodnotu .
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 cacheBehavior vlastnost na HonorOriginhodnotu .
  • Přepsat vždy: Hodnota TTL vrácená z vašeho původu se přepíše hodnotou zadanou v akci. Toto chování se použije pouze v případě, že je odpověď uložená v mezipaměti. V šablonách ARM nastavte cacheBehavior vlastnost na OverrideAlwayshodnotu .
  • Přepsání, pokud chybí zdroj: Pokud se z vašeho původu nevrátí žádná hodnota TTL, nastaví pravidlo hodnotu TTL na hodnotu zadanou v akci. Toto chování se použije pouze v případě, že je odpověď uložená v mezipaměti. V šablonách ARM nastavte cacheBehavior vlastnost na OverrideIfOriginMissinghodnotu .
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 chybí původ.
  • 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 přepsání 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 povolená a zásady ukládání do mezipaměti původu 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 upravit hlavičky v požadavku při odeslání do vašeho původu.

Vlastnosti

Vlastnost Podporované hodnoty
Operátor
  • Připojení: 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 headerAction příkaz Append.
  • Přepsání: 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 headerAction příkaz Overwrite.
  • Odstranění: Pokud se nachází hlavička zadaná v pravidle, záhlaví se z požadavku odstraní. V šablonách ARM použijte headerAction příkaz Delete.
Název hlavičky Název hlavičky, která se má upravit.
Hodnota hlavičky Hodnota, která se má připojit nebo přepsat.

Příklad

V tomto příkladu MyRequestHeader připojíme hodnotu AdditionalValue k hlavičce požadavku. 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 znázorňující akci hlavičky žádosti upravit

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

Vlastnost Podporované hodnoty
Operátor
  • Připojení: 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 headerAction příkaz Append.
  • Přepsání: 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 headerAction příkaz Overwrite.
  • Odstranění: Pokud je hlavička zadaná v pravidle přítomna, záhlaví se z odpovědi odstraní. V šablonách ARM použijte headerAction příkaz Delete.
Název hlavičky Název hlavičky, která se má upravit.
Hodnota hlavičky 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. Klienti se odesílají 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

Vlastnost 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, TemporaryRedirectPermanentRedirect
Přesměrový protokol
  • Na webu Azure Portal: Match Request, HTTPHTTPS
  • V šablonách ARM: MatchRequest, HttpHttps
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í. Zahrňte ú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_ip proměnné serveru.

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

Přepsání adresy URL

Pomocí akce přepsání adresy URL přepište cestu požadavku, který je na cestě k vašemu původu. 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

Vlastnost 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ě. Chcete-li se shodovat se všemi cestami URL, použijte jako hodnotu zdrojového vzoru lomítko (/).
Cíl Definujte cílovou cestu, kterou chcete použít v přepsání. Cílová cesta přepíše zdrojový vzor.
Zachování chybějící cesty Pokud je nastavena hodnota Ano, zbývající cesta po připojení zdrojového vzoru 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é

Služba Azure Front Door (Classic) bude vyřazena 31. března 2027. Abyste se vyhnuli přerušení služeb, je důležité do března 2027 migrovat profily služby Azure Front Door (Classic) na úroveň Azure Front Door Standard nebo Premium. Další informace najdete v části Vyřazení služby Azure Front Door (Classic).

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 konfigurace směrování přepsání.

V konfiguraci stroje pravidel 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

Akce 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ě. String
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. String
Odstranění 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í. String

Ú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

Akce 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ě. String
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. String
Odstranění 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í. String

Přepisování konfigurace směrování

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 zadání konkrétního oddílu na stránce. Nastavte tuto hodnotu tak, aby se k adrese URL pro přesměrování přidal fragment.

Typ trasy: Předat dál

Pomocí těchto akcí přeposílá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
Back-endový fond 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řesměrová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řepsání 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.
Ukládání do mezipaměti 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řepsání 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í Definujte cestu, do které se požadavky přeposílaly.

Ukládání do mezipaměti

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žití řetězce 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í.
Zahrnutí zadaných řetězců dotazu Řetězce dotazu požadavku uvedené v nastavení Parametry dotazu se používají k ukládání do mezipaměti.
Další pole Popis
Dynamická komprese Front Door dokáže dynamicky komprimovat obsah na okraji, což vede k menší a rychlejší odezvě.
Parametry dotazů Čá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

  • Zjistěte, jak nakonfigurovat první sadu pravidel.
  • Přečtěte si další informace o podmínkách shody sady pravidel.
  • Přečtěte si další informace o sadách pravidel služby Azure Front Door.