Podmínky shody pravidel

V sadách pravidel služby Azure Front Door se pravidlo skládá z žádných nebo některých podmínek shody a akce. Tento článek obsahuje podrobný popis podmínek shody, které můžete použít v sadách pravidel služby Azure Front Door.

V modulu pravidel služby Azure Front Door (Classic) se pravidlo skládá z podmínek shody nebo některých podmínek shody a akce. Tento článek obsahuje podrobný popis podmínek shody, které můžete použít v modulu pravidel služby Azure Front Door (Classic).

První část pravidla je podmínka shody nebo sada podmínek shody. Pravidlo může obsahovat až 10 podmínek shody. Podmínka shody identifikuje konkrétní typy požadavků, pro které se provádějí definované akce. Pokud použijete více podmínek shody, podmínky shody se seskupí pomocí logiky AND. Pro všechny podmínky shody, které podporují více hodnot, se používá logika OR.

Podmínku shody můžete použít k:

  • Filtrování požadavků na základě konkrétní IP adresy, portu nebo země/oblasti
  • Filtrujte požadavky podle informací v hlavičce.
  • Filtrování požadavků z mobilních zařízení nebo stolních zařízení
  • Vyfiltrujte požadavky z názvu souboru požadavku a přípony souboru.
  • Filtrovat požadavky podle názvu hostitele, protokolu SSL, adresy URL požadavku, protokolu, cesty, řetězce dotazu, post args a dalších hodnot.
  • Filtrování požadavků na základě konkrétní IP adresy nebo země/oblasti
  • Filtrujte požadavky podle informací v hlavičce.
  • Filtrování požadavků z mobilních zařízení nebo stolních zařízení
  • Vyfiltrujte požadavky z názvu souboru požadavku a přípony souboru.
  • Filtrujte požadavky podle adresy URL požadavku, protokolu, cesty, řetězce dotazu, argumentů post a dalších hodnot.

Typ zařízení

Pomocí podmínky shody typu zařízení identifikujte požadavky z mobilního zařízení nebo stolního zařízení.

Vlastnosti

Vlastnost Podporované hodnoty
Operátor
  • Na webu Azure Portal: EqualNot Equal
  • V šablonách ARM: Equalpoužijte negateCondition vlastnost k určení nerovná se
Hodnota Mobile, Desktop

Příklad

V tomto příkladu odpovídáme všem požadavkům, které byly zjištěny jako přicházející z mobilního zařízení.

Portal screenshot showing device type match condition.

Verze protokolu HTTP

Pomocí podmínky shody verze HTTP identifikujte požadavky, které jsou provedeny pomocí konkrétní verze protokolu HTTP.

Poznámka:

Podmínka shody verze HTTP je k dispozici pouze ve službě Azure Front Door Standard/Premium.

Vlastnosti

Vlastnost Podporované hodnoty
Operátor
  • Na webu Azure Portal: EqualNot Equal
  • V šablonách ARM: Equalpoužijte negateCondition vlastnost k určení nerovná se
Hodnota 2.0, 1.1, , 1.00.9

Příklad

V tomto příkladu odpovídáme všem požadavkům, které byly odeslány pomocí protokolu HTTP 2.0.

Portal screenshot showing HTTP version match condition.

Vyžádání souborů cookie

Pomocí podmínky shody souborů cookie požadavku identifikujte žádosti, které obsahují určitý soubor cookie.

Poznámka:

Podmínka shody souborů cookie požadavku je k dispozici pouze ve službě Azure Front Door Standard/Premium.

Vlastnosti

Vlastnost Podporované hodnoty
Název souboru cookie Řetězcová hodnota představující název souboru cookie.
Operátor Libovolný operátor ze seznamu standardních operátorů.
Hodnota Jedna nebo více řetězcových nebo celých hodnot představujících hodnotu hlavičky požadavku, která se má shodovat. Pokud je zadáno více hodnot, vyhodnotí se pomocí logiky OR.
Transformace velkých a velkých písmen Jakákoli transformace ze seznamu standardních řetězců transformuje.

Příklad

V tomto příkladu odpovídáme všem požadavkům, které mají soubor cookie s názvem deploymentStampId hodnota 1.

Portal screenshot showing request cookies match condition.

Post args

Pomocí podmínky shody post args identifikujte požadavky na základě argumentů zadaných v textu požadavku POST. Jedna podmínka shody odpovídá jednomu argumentu z textu požadavku POST. Můžete zadat více hodnot, které se mají shodovat, což se dá kombinovat pomocí logiky OR.

Poznámka:

Podmínka shody post args funguje s typem application/x-www-form-urlencoded obsahu.

Vlastnosti

Vlastnost Podporované hodnoty
Post args Řetězcová hodnota představující název argumentu POST.
Operátor Libovolný operátor ze seznamu standardních operátorů.
Hodnota Jedna nebo více řetězcových nebo celých hodnot představujících hodnotu argumentu POST, která se má shodovat. Pokud je zadáno více hodnot, vyhodnotí se pomocí logiky OR.
Transformace velkých a velkých písmen Jakákoli transformace ze seznamu standardních řetězců transformuje.

Příklad

V tomto příkladu odpovídáme všem požadavkům POST, kde customerName je v textu požadavku zadaný argument a kde hodnota customerName začíná písmenem J nebo K. K převodu vstupních hodnot na velká písmena používáme transformaci písmen tak, aby hodnoty začínající Jna , jKa k všechny byly shodné.

Portal screenshot showing post args match condition.

Řetězec dotazu

Pomocí podmínky shody řetězce dotazu identifikujte požadavky, které obsahují konkrétní řetězec dotazu. Můžete zadat více hodnot, které se mají shodovat, což se dá kombinovat pomocí logiky OR.

Poznámka:

Celý řetězec dotazu se shoduje s jedním řetězcem bez počátečního ?řetězce .

Vlastnosti

Vlastnost Podporované hodnoty
Operátor Podporují se všechny operátory ze seznamu standardních operátorů. Podmínka Libovolná shoda však odpovídá každému požadavku a podmínka Shody neodpovídá žádnému požadavku, pokud se použije s podmínkou shody řetězce dotazu.
Řetězec dotazu Jedna nebo více řetězcových nebo celých hodnot představujících hodnotu řetězce dotazu, která se má shodovat. Nezahrnujte na ? začátku řetězce dotazu. Pokud je zadáno více hodnot, vyhodnotí se pomocí logiky OR.
Transformace velkých a velkých písmen Jakákoli transformace ze seznamu standardních řetězců transformuje.

Příklad

V tomto příkladu odpovídáme všem požadavkům, ve kterých řetězec dotazu obsahuje řetězec language=en-US. Chceme, aby byla podmínka shody citlivá na malá a velká písmena, takže případ neměňujeme.

Portal screenshot showing query string match condition.

Vzdálená adresa

Podmínka shody vzdálené adresy identifikuje požadavky na základě umístění nebo IP adresy žadatele. Můžete zadat více hodnot, které se mají shodovat, což se dá kombinovat pomocí logiky OR.

  • Zápis CIDR použijte při zadávání bloků IP adres. Syntaxe bloku IP adres je základní IP adresa následovaná lomítkem a velikostí předpony. Příklad:
    • Příklad IPv4: 5.5.5.64/26 Odpovídá všem požadavkům přicházejícím z adres 5.5.5.64 až 5.5.5.127.
    • Příklad protokolu IPv6: 1:2:3:/48 odpovídá všem žádostem přicházejícím z adres 1:2:3:0:0:0:0 až 1:2:3: ffff:ffff:ffff:ffff:ffff:ffff.
  • Když zadáte více IP adres a bloků IP adres, použije se logika OR.
    • Příklad IPv4: Pokud přidáte dvě IP adresy 1.2.3.4 a 10.20.30.40podmínka se shoduje s požadavky přicházejícími z adresy 1.2.3.4 nebo 10.20.30.40.
    • Příklad protokolu IPv6: Pokud přidáte dvě IP adresy 1:2:3:4:5:6:7:8 a 10:20:30:40:50:60:70:80podmínka se shoduje s požadavky přicházejícími z adresy 1:2:3:4:5:6:7:8 nebo 10:20:30:40:50:60:70:80.
  • Vzdálená adresa představuje původní IP adresu klienta, která je buď ze síťového připojení, nebo obvykle hlavičku požadavku X-Forwarded-For, pokud je uživatel za proxy serverem. Podmínku shody adresy soketu (k dispozici ve standardu nebo premium) použijte, pokud potřebujete odpovídat na základě IP adresy požadavku TCP.

Vlastnosti

Vlastnost Podporované hodnoty
Operátor
  • Na webu Azure Portal: Geo Match, Geo Not Match, IP Matchnebo IP Not Match
  • V šablonách ARM: GeoMatch, ; použijte negateCondition vlastnost k určení geografické neshody nebo IP IPMatchnení shoda
Hodnota
  • Pro operátory IP Match nebo IP Not Match operátory zadejte jeden nebo více rozsahů IP adres. Pokud je zadáno více rozsahů IP adres, vyhodnocují se pomocí logiky OR.
  • Pro operátory nebo Geo Not Match operátoryGeo Match: zadejte jedno nebo více míst pomocí kódu země.

Příklad

V tomto příkladu odpovídáme všem požadavkům, u kterých požadavek nepochází z USA.

Portal screenshot showing remote address match condition.

Text požadavku

Podmínka shody textu požadavku identifikuje požadavky na základě konkrétního textu, který se zobrazí v textu požadavku. Můžete zadat více hodnot, které se mají shodovat, což se dá kombinovat pomocí logiky OR.

Poznámka:

Pokud text požadavku překročí velikost 64 kB, bude považováno za podmínku shody textu požadavku pouze prvních 64 kB.

Vlastnosti

Vlastnost Podporované hodnoty
Operátor Podporují se všechny operátory ze seznamu standardních operátorů. Podmínka Libovolná shoda ale odpovídá každému požadavku a podmínka Shody neodpovídá žádné žádosti, pokud se použije s podmínkou shody textu požadavku.
Hodnota Jedna nebo více řetězcových nebo celočíselných hodnot představujících hodnotu základního textu požadavku, která se má shodovat. Pokud je zadáno více hodnot, vyhodnotí se pomocí logiky OR.
Transformace velkých a velkých písmen Jakákoli transformace ze seznamu standardních řetězců transformuje.

Příklad

V tomto příkladu odpovídáme všem požadavkům, ve kterých text požadavku obsahuje řetězec ERROR. Před vyhodnocením shody transformujeme text požadavku na velká písmena, takže error a další varianty případů také aktivují tuto podmínku shody.

Portal screenshot showing request body match condition.

Název souboru požadavku

Podmínka shody názvu souboru požadavku identifikuje požadavky, které obsahují zadaný název souboru v adrese URL požadavku. Můžete zadat více hodnot, které se mají shodovat, což se dá kombinovat pomocí logiky OR.

Vlastnosti

Vlastnost Podporované hodnoty
Operátor Podporují se všechny operátory ze seznamu standardních operátorů. Podmínka Libovolná shoda ale odpovídá každému požadavku a podmínka Shody neodpovídá žádné žádosti, pokud se použije s podmínkou shody názvu souboru požadavku.
Hodnota Jedna nebo více řetězcových nebo celých hodnot představujících hodnotu názvu souboru požadavku, která se má shodovat. Pokud je zadáno více hodnot, vyhodnotí se pomocí logiky OR.
Transformace velkých a velkých písmen Jakákoli transformace ze seznamu standardních řetězců transformuje.

Příklad

V tomto příkladu odpovídáme všem požadavkům, ve kterých je media.mp4název souboru požadavku . Před vyhodnocením shody transformujeme název souboru na malá písmena, takže MEDIA.MP4 a další varianty případů také aktivují tuto podmínku shody.

Portal screenshot showing request file name match condition.

Žádost o příponu souboru

Podmínka shody přípony souboru požadavku identifikuje požadavky, které obsahují zadanou příponu souboru v názvu souboru v adrese URL požadavku. Můžete zadat více hodnot, které se mají shodovat, což se dá kombinovat pomocí logiky OR.

Poznámka:

Nezahrnujte úvodní tečku. Například místo html ..html

Vlastnosti

Vlastnost Podporované hodnoty
Operátor Podporují se všechny operátory ze seznamu standardních operátorů. Podmínka Libovolná shoda ale odpovídá každému požadavku apodmínka Shody neodpovídá žádné žádosti, pokud se používá s podmínkou shody přípony souboru požadavku.
Hodnota Nejméně jeden řetězec nebo celočíselná hodnota představující hodnotu přípony souboru požadavku, která se má shodovat. Nezahrnujte úvodní tečku. Pokud je zadáno více hodnot, vyhodnotí se pomocí logiky OR.
Transformace velkých a velkých písmen Jakákoli transformace ze seznamu standardních řetězců transformuje.

Příklad

V tomto příkladu odpovídáme všem požadavkům, ve kterých je pdf přípona souboru požadavku nebo docx. Před vyhodnocením shody transformujeme příponu souboru požadavku na malá písmena, takže PDFDocXa další varianty případů také aktivují tuto podmínku shody.

Portal screenshot showing request file extension match condition.

Hlavička požadavku

Podmínka shody hlavičky požadavku identifikuje požadavky, které do požadavku obsahují konkrétní hlavičku. Tuto podmínku shody můžete použít ke kontrole, jestli záhlaví existuje, nebo můžete zkontrolovat, jestli záhlaví odpovídá zadané hodnotě. Můžete zadat více hodnot, které se mají shodovat, což se dá kombinovat pomocí logiky OR.

Vlastnosti

Vlastnost Podporované hodnoty
Název hlavičky Řetězcová hodnota představující název argumentu POST.
Operátor Libovolný operátor ze seznamu standardních operátorů.
Hodnota Jedna nebo více řetězcových nebo celých hodnot představujících hodnotu hlavičky požadavku, která se má shodovat. Pokud je zadáno více hodnot, vyhodnotí se pomocí logiky OR.
Transformace velkých a velkých písmen Jakákoli transformace ze seznamu standardních řetězců transformuje.

Příklad

V tomto příkladu odpovídáme všem požadavkům, ve kterých požadavek obsahuje hlavičku s názvem MyCustomHeaderbez ohledu na její hodnotu.

Portal screenshot showing request header match condition.

Metoda požadavku

Podmínka shody metody požadavku identifikuje požadavky, které používají zadanou metodu požadavku HTTP. Můžete zadat více hodnot, které se mají shodovat, což se dá kombinovat pomocí logiky OR.

Vlastnosti

Vlastnost Podporované hodnoty
Operátor
  • Na webu Azure Portal: EqualNot Equal
  • V šablonách ARM: Equalpoužijte negateCondition vlastnost k určení nerovná se
Metoda požadavku Jedna nebo více metod HTTP z: GET, , PUTPOST, DELETE, HEAD, OPTIONS. TRACE Pokud je zadáno více hodnot, vyhodnotí se pomocí logiky OR.

Příklad

V tomto příkladu odpovídáme všem požadavkům, ve kterých požadavek používá metodu DELETE .

Portal screenshot showing request method match condition.

Cesta požadavku

Podmínka shody cesty požadavku identifikuje požadavky, které zahrnují zadanou cestu do adresy URL požadavku. Můžete zadat více hodnot, které se mají shodovat, což se dá kombinovat pomocí logiky OR.

Poznámka:

Cesta je součástí adresy URL za názvem hostitele a lomítkem. Například v adrese URL https://www.contoso.com/files/secure/file1.pdfje files/secure/file1.pdfcesta .

Vlastnosti

Vlastnost Podporované hodnoty
Operátor
  • Podporují se všechny operátory ze seznamu standardních operátorů. Podmínka Libovolná shoda ale odpovídá každému požadavku a podmínka Shody neodpovídá žádnému požadavku, pokud se použije s podmínkou shody cesty požadavku.
  • Zástupný znak: Odpovídá, když cesta požadavku odpovídá výrazu se zástupným znakem. Výraz se zástupnými znaky může obsahovat * znak, který odpovídá nule nebo více znaků v cestě. Například výraz files/customer*/file.pdf se zástupným znakem odpovídá cestám files/customer1/file.pdf, files/customer109/file.pdfa files/customer/file.pdf, ale neodpovídá files/customer2/anotherfile.pdf.
    • Na webu Azure Portal: WildcardsNot Wildcards
    • V šablonách ARM: použijte negateCondition vlastnost k určení nezadávejte zástupné cardy. Wildcard
Hodnota Jedna nebo více řetězcových nebo celých hodnot představujících hodnotu cesty požadavku, která se má shodovat. Pokud zadáte počáteční lomítko, bude ignorováno. Pokud je zadáno více hodnot, vyhodnotí se pomocí logiky OR.
Transformace velkých a velkých písmen Jakákoli transformace ze seznamu standardních řetězců transformuje.
Vlastnost Podporované hodnoty
Operátor Podporují se všechny operátory ze seznamu standardních operátorů. Podmínka Libovolná shoda ale odpovídá každému požadavku a podmínka Shody neodpovídá žádnému požadavku, pokud se použije s podmínkou shody cesty požadavku.
Hodnota Jedna nebo více řetězcových nebo celých hodnot představujících hodnotu cesty požadavku, která se má shodovat. Pokud zadáte počáteční lomítko, bude ignorováno. Pokud je zadáno více hodnot, vyhodnotí se pomocí logiky OR.
Transformace velkých a velkých písmen Jakákoli transformace ze seznamu standardních řetězců transformuje.

Příklad

V tomto příkladu odpovídáme všem požadavkům, kde cesta k souboru požadavku začíná files/secure/. Před vyhodnocením shody transformujeme příponu souboru požadavku na malá písmena, takže požadavky na files/SECURE/ a další varianty případů také aktivují tuto podmínku shody.

Portal screenshot showing request path match condition.

Protokol požadavku

Podmínka shody protokolu požadavku identifikuje požadavky, které používají zadaný protokol (HTTP nebo HTTPS).

Poznámka:

Protokol se někdy označuje také jako schéma.

Vlastnosti

Vlastnost Podporované hodnoty
Operátor
  • Na webu Azure Portal: EqualNot Equal
  • V šablonách ARM: Equalpoužijte negateCondition vlastnost k určení nerovná se
Metoda požadavku HTTP, HTTPS

Příklad

V tomto příkladu odpovídáme všem požadavkům, ve kterých požadavek používá HTTP protokol.

Portal screenshot showing request protocol match condition.

Adresa URL požadavku

Identifikuje požadavky, které odpovídají zadané adrese URL. Celá adresa URL se vyhodnotí, včetně protokolu a řetězce dotazu, ale ne fragmentu. Můžete zadat více hodnot, které se mají shodovat, což se dá kombinovat pomocí logiky OR.

Tip

Při použití této podmínky pravidla nezapomeňte zahrnout protokol a koncové lomítko /. Například použijte https://www.contoso.com/ místo jen www.contoso.com.

Vlastnosti

Vlastnost Podporované hodnoty
Operátor Podporují se všechny operátory ze seznamu standardních operátorů. Podmínka Libovolná shoda ale odpovídá každému požadavku a podmínka Shody neodpovídá žádné žádosti, pokud se používá s podmínkou shody adresy URL požadavku.
Hodnota Jedna nebo více řetězcových nebo celých hodnot představujících hodnotu adresy URL požadavku, která se má shodovat. Pokud je zadáno více hodnot, vyhodnotí se pomocí logiky OR.
Transformace velkých a velkých písmen Jakákoli transformace ze seznamu standardních řetězců transformuje.

Příklad

V tomto příkladu odpovídáme všem požadavkům, na kterých adresa URL požadavku začíná https://api.contoso.com/customers/123. Před vyhodnocením shody transformujeme příponu souboru požadavku na malá písmena, takže požadavky na https://api.contoso.com/Customers/123 a další varianty případů také aktivují tuto podmínku shody.

Portal screenshot showing request URL match condition.

Název hostitele

Podmínka shody názvu hostitele identifikuje požadavky na základě zadaného názvu hostitele v požadavku od klienta. Podmínka shody používá hodnotu hlavičky Host k vyhodnocení názvu hostitele. Můžete zadat více hodnot, které se mají shodovat, což se dá kombinovat pomocí logiky OR.

Vlastnosti

Vlastnost Podporované hodnoty
Operátor Podporují se všechny operátory ze seznamu standardních operátorů. Podmínka Libovolná shoda však odpovídá každému požadavku a podmínka Shody neodpovídá žádné žádosti, pokud se používá s podmínkou shody názvu hostitele.
Hodnota Jedna nebo více řetězcových hodnot představujících hodnotu názvu hostitele požadavku, která se má shodovat. Pokud je zadáno více hodnot, vyhodnotí se pomocí logiky OR.
Transformace velkých a velkých písmen Jakákoli transformace případu ze seznamu standardních řetězců transformuje.

Příklad

V tomto příkladu odpovídáme všem požadavkům hlavičkou Host , která končí contoso.comna .

Portal screenshot showing host name match condition.

Protokol SSL

Podmínka shody protokolu SSL identifikuje požadavky na základě protokolu SSL vytvořeného připojení TLS. Můžete zadat více hodnot, které se mají shodovat, což se dá kombinovat pomocí logiky OR.

Vlastnosti

Vlastnost Podporované hodnoty
Operátor
  • Na webu Azure Portal: EqualNot Equal
  • V šablonách ARM: Equalpoužijte negateCondition vlastnost k určení nerovná se
Protokol SSL
  • Na webu Azure Portal: 1.0, 1.11.2
  • V šablonách ARM: TLSv1, TLSv1.1TLSv1.2

Příklad

V tomto příkladu odpovídáme všem požadavkům, které používají protokol TLS 1.2.

Portal screenshot showing SSL protocol match condition.

Adresa soketu

Podmínka shody adresy soketu identifikuje požadavky na základě IP adresy přímého připojení ke službě Azure Front Door Edge. Můžete zadat více hodnot, které se mají shodovat, což se dá kombinovat pomocí logiky OR.

Poznámka:

Pokud klient k odeslání požadavku použil proxy server HTTP nebo nástroj pro vyrovnávání zatížení, adresa soketu je IP adresa proxy serveru nebo nástroje pro vyrovnávání zatížení.

Podmínku shody vzdálené adresy použijte, pokud potřebujete shodu na základě původní IP adresy klienta.

  • Zápis CIDR použijte při zadávání bloků IP adres. To znamená, že syntaxe bloku IP adres je základní IP adresa následovaná lomítkem a velikostí předpony. Příklad:
    • Příklad IPv4: 5.5.5.64/26 Odpovídá všem požadavkům přicházejícím z adres 5.5.5.64 až 5.5.5.127.
    • Příklad protokolu IPv6: 1:2:3:/48 odpovídá všem žádostem přicházejícím z adres 1:2:3:0:0:0:0 až 1:2:3: ffff:ffff:ffff:ffff:ffff:ffff.
  • Když zadáte více IP adres a bloků IP adres, použije se logika OR.
    • Příklad IPv4: Pokud přidáte dvě IP adresy 1.2.3.4 a 10.20.30.40podmínka se shoduje s požadavky přicházejícími z adresy 1.2.3.4 nebo 10.20.30.40.
    • Příklad protokolu IPv6: Pokud přidáte dvě IP adresy 1:2:3:4:5:6:7:8 a 10:20:30:40:50:60:70:80podmínka se shoduje s požadavky přicházejícími z adresy 1:2:3:4:5:6:7:8 nebo 10:20:30:40:50:60:70:80.

Vlastnosti

Vlastnost Podporované hodnoty
Operátor
  • Na webu Azure Portal: IP MatchNot IP Match
  • V šablonách ARM: IPMatchpoužijte negateCondition vlastnost k určení shody not IP
Hodnota Zadejte jeden nebo více rozsahů IP adres. Pokud je zadáno více rozsahů IP adres, vyhodnocují se pomocí logiky OR.

Příklad

V tomto příkladu odpovídáme všem požadavkům z IP adres v rozsahu 5.5.5.64/26.

Portal screenshot showing socket address match condition.

Port klienta

Podmínka shody portu klienta identifikuje požadavky na základě portu TCP klienta, který požadavek provedl. Můžete zadat více hodnot, které se mají shodovat, což se dá kombinovat pomocí logiky OR.

Vlastnosti

Vlastnost Podporované hodnoty
Operátor Podporují se všechny operátory ze seznamu standardních operátorů. Podmínka Libovolná shoda ale odpovídá každému požadavku a podmínka Shody není v souladu s žádnou žádostí, pokud se používá s podmínkou shody portu klienta.
Hodnota Jedno nebo více čísel portů vyjádřených jako celá čísla. Pokud je zadáno více hodnot, vyhodnotí se pomocí logiky OR.

Příklad

V tomto příkladu odpovídáme všem požadavkům s portem klienta 1234.

Portal screenshot showing client port match condition.

Port serveru

Podmínka shody portu serveru identifikuje požadavky na základě portu TCP serveru Azure Front Door, který požadavek přijal. Port musí být 80 nebo 443. Můžete zadat více hodnot, které se mají shodovat, což se dá kombinovat pomocí logiky OR.

Vlastnosti

Vlastnost Podporované hodnoty
Operátor Podporují se všechny operátory ze seznamu standardních operátorů. Podmínka Libovolná shoda ale odpovídá každému požadavku a podmínka Shody není v souladu s žádnou žádostí, pokud se používá s podmínkou shody portu serveru.
Hodnota Číslo portu, které musí být buď 80, nebo 443. Pokud je zadáno více hodnot, vyhodnotí se pomocí logiky OR.

Příklad

V tomto příkladu odpovídáme všem požadavkům s portem serveru 443.

Portal screenshot showing server port match condition.

Seznam operátorů

Pro pravidla, která přijímají hodnoty ze seznamu standardních operátorů, jsou platné následující operátory:

Operátor Popis Podpora šablon ARM
Všechny Najde shodu, pokud existuje jakákoli hodnota (bez ohledu na to, o jakou hodnotu jde). operator: Any
Je rovno Najde shodu, pokud hodnota přesně odpovídá zadanému řetězci. operator: Equal
Contains Najde shodu, pokud hodnota obsahuje zadaný řetězec. operator: Contains
Menší než Najde shodu, pokud je délka hodnoty menší než zadané celé číslo. operator: LessThan
Větší než Najde shodu, pokud je délka hodnoty větší než zadané celé číslo. operator: GreaterThan
Menší než nebo rovno Najde shodu, pokud je délka hodnoty menší než zadané celé číslo nebo se mu rovná. operator: LessThanOrEqual
Větší než nebo rovno Najde shodu, pokud je délka hodnoty větší než zadané celé číslo nebo se mu rovná. operator: GreaterThanOrEqual
Začíná na Najde shodu, pokud hodnota začíná zadaným řetězcem. operator: BeginsWith
Končí na Najde shodu, pokud hodnota končí zadaným řetězcem. operator: EndsWith
Není žádné Najde shodu, pokud neexistuje žádná hodnota. operator: Any a negateCondition : true
Nerovná se Najde shodu, pokud hodnota neodpovídá zadanému řetězci. operator: Equal a negateCondition : true
Neobsahuje Najde shodu, pokud hodnota neobsahuje zadaný řetězec. operator: Contains a negateCondition : true
Není menší než Najde shodu, pokud délka hodnoty není menší než zadané celé číslo. operator: LessThan a negateCondition : true
Není větší než Najde shodu, pokud délka hodnoty není větší než zadané celé číslo. operator: GreaterThan a negateCondition : true
Není menší než nebo rovno Najde shodu, pokud délka hodnoty není menší než zadané celé číslo nebo se mu rovná. operator: LessThanOrEqual a negateCondition : true
Není větší než nebo rovno Odpovídá, pokud délka hodnoty není větší nebo rovna zadanému celočíselnému číslu. operator: GreaterThanOrEqual a negateCondition : true
Nezačíná na Odpovídá, když hodnota nezačíná zadaným řetězcem. operator: BeginsWith a negateCondition : true
Nekončí na Odpovídá, pokud hodnota nekončí zadaným řetězcem. operator: EndsWith a negateCondition : true
Operátor Popis Podpora šablon ARM
Všechny Najde shodu, pokud existuje jakákoli hodnota (bez ohledu na to, o jakou hodnotu jde). operator: Any
Je rovno Najde shodu, pokud hodnota přesně odpovídá zadanému řetězci. operator: Equal
Contains Najde shodu, pokud hodnota obsahuje zadaný řetězec. operator: Contains
Menší než Najde shodu, pokud je délka hodnoty menší než zadané celé číslo. operator: LessThan
Větší než Najde shodu, pokud je délka hodnoty větší než zadané celé číslo. operator: GreaterThan
Menší než nebo rovno Najde shodu, pokud je délka hodnoty menší než zadané celé číslo nebo se mu rovná. operator: LessThanOrEqual
Větší než nebo rovno Najde shodu, pokud je délka hodnoty větší než zadané celé číslo nebo se mu rovná. operator: GreaterThanOrEqual
Začíná na Najde shodu, pokud hodnota začíná zadaným řetězcem. operator: BeginsWith
Končí na Najde shodu, pokud hodnota končí zadaným řetězcem. operator: EndsWith
RegEx Najde shodu, pokud hodnota odpovídá zadanému regulárnímu výrazu. Další podrobnosti najdete níže. operator: RegEx
Není žádné Najde shodu, pokud neexistuje žádná hodnota. operator: Any a negateCondition : true
Nerovná se Najde shodu, pokud hodnota neodpovídá zadanému řetězci. operator: Equal a negateCondition : true
Neobsahuje Najde shodu, pokud hodnota neobsahuje zadaný řetězec. operator: Contains a negateCondition : true
Není menší než Najde shodu, pokud délka hodnoty není menší než zadané celé číslo. operator: LessThan a negateCondition : true
Není větší než Najde shodu, pokud délka hodnoty není větší než zadané celé číslo. operator: GreaterThan a negateCondition : true
Není menší než nebo rovno Najde shodu, pokud délka hodnoty není menší než zadané celé číslo nebo se mu rovná. operator: LessThanOrEqual a negateCondition : true
Není větší než nebo rovno Odpovídá, pokud délka hodnoty není větší nebo rovna zadanému celočíselnému číslu. operator: GreaterThanOrEqual a negateCondition : true
Nezačíná na Odpovídá, když hodnota nezačíná zadaným řetězcem. operator: BeginsWith a negateCondition : true
Nekončí na Odpovídá, pokud hodnota nekončí zadaným řetězcem. operator: EndsWith a negateCondition : true
Not RegEx Odpovídá, když hodnota neodpovídá zadanému regulárnímu výrazu. Další podrobnosti najdete níže. operator: RegEx a negateCondition : true

Tip

Pro číselné operátory, jako je Menší než a Větší než nebo rovno, je porovnání založeno na délce. Hodnota v podmínce shody by měla být celé číslo, které určuje délku, kterou chcete porovnat.

Regulární výrazy

Regulární výrazy nepodporují následující operace:

  • Zpětné odvozování a zachycení dílčích výrazů
  • Libovolné kontrolní výrazy s nulovou šířkou
  • Podprogramované odkazy a rekurzivní vzory.
  • Podmíněné vzory.
  • Zpětná řízení příkazů.
  • Direktiva \C s jedním bajtem.
  • Direktiva \R shody newline.
  • Začátek \K direktivy resetování shody.
  • Bublinové popisky a vložený kód
  • Atomové seskupení a přivlastňovací kvantifikátory.

Seznam transformací řetězců

Pro pravidla, která mohou transformovat řetězce, jsou platné následující transformace:

Transformace Popis Podpora šablon ARM
Malá písmena Převede řetězec na reprezentaci malými písmeny. Lowercase
Na velká písmena Převede řetězec na reprezentaci velkými písmeny. Uppercase
Trim Oříznou počáteční a koncové prázdné znaky z řetězce. Trim
Odebrání hodnot null Odebere z řetězce hodnoty null. RemoveNulls
Kódování adresy URL Adresa URL řetězec zakóduje. UrlEncode
Dekódování adresy URL Adresa URL dekóduje řetězec. UrlDecode

Další kroky